data-array-group-by Edge Function — Data

data-array-group-by

Groups an array of objects into a map keyed by the value of a specified property. Zero external dependencies.

Install

aerostack function add data-array-group-by

Usage

import { groupBy } from './functions/data-array-group-by';

const users = [
    { name: 'Alice', role: 'admin' },
    { name: 'Bob', role: 'user' },
    { name: 'Charlie', role: 'admin' },
];

groupBy(users, 'role');
// {
//   groups: {
//     admin: [{ name: 'Alice', role: 'admin' }, { name: 'Charlie', role: 'admin' }],
//     user:  [{ name: 'Bob', role: 'user' }]
//   }
// }

API

POST /api/data-array-group-by

{
    "array": [
        { "name": "Alice", "role": "admin" },
        { "name": "Bob", "role": "user" },
        { "name": "Charlie", "role": "admin" }
    ],
    "key": "role"
}

{
    "success": true,
    "data": {
        "groups": {
            "admin": [
                { "name": "Alice", "role": "admin" },
                { "name": "Charlie", "role": "admin" }
            ],
            "user": [
                { "name": "Bob", "role": "user" }
            ]
        }
    }
}

Edge Cases

• Missing key in some objects: grouped under "undefined"
• null values: grouped under "undefined"
• Number/boolean values: converted to string keys (5 becomes "5", true becomes "true")
• Empty array: returns error EMPTY_ARRAY
• Empty key string: returns error MISSING_KEY