data-sort-objects Edge Function — Data

data-sort-objects — Multi-key object array sorting

Sorts an array of objects by one or more fields with configurable direction, null handling, and dot-notation for nested fields.

---

API

POST /api/data-sort-objects

Request body

Field	Type	Required	Description
items	object[]	✅	Array of objects to sort
sortBy	SortKey[]	✅	Ordered sort keys

SortKey object:

Field	Type	Required	Default	Description
field	string	✅	—	Field name (supports dot notation: "user.age")
direction	'asc' | 'desc'	✅	—	Sort direction
nulls	'first' | 'last'	❌	'last'	Where to place null/undefined values

Success response (200)

{
  "success": true,
  "data": {
    "items": [{ "name": "Alice", "age": 25 }, { "name": "Bob", "age": 30 }],
    "count": 2
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Invalid sortBy array or missing fields
INTERNAL_ERROR	500	Unexpected error

---

Usage

cURL

curl -X POST "$FUNCTION_URL" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"name":"Bob","age":30},{"name":"Alice","age":25}], "sortBy": [{"field":"name","direction":"asc"}]}'

TypeScript / JavaScript (HTTP)

const response = await fetch(FUNCTION_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    items: products,
    sortBy: [{ field: 'price', direction: 'asc' }, { field: 'name', direction: 'asc' }],
  }),
});
const { data } = await response.json();
console.log(data.items);

Direct import (Node / Bun / Deno)

import { sortObjects } from '@aerostack/functions/data-sort-objects';

const { items } = sortObjects({
  items: users,
  sortBy: [{ field: 'lastName', direction: 'asc' }, { field: 'firstName', direction: 'asc' }],
});

---

Use Cases

• Sorting a list of products by price ascending before displaying to a user
• Sorting user records by department then by name for a paginated admin table
• Ordering events by timestamp descending for a feed or timeline view

---

Notes

• Sorting is stable within equal values (preserves original order for ties at all sort keys)
• Nested field access via dot notation: "address.city", "user.profile.score"
• String fields are sorted using localeCompare for correct Unicode ordering