@boltstore/client 0.5.0 → 0.5.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boltstore/client",
-  "version": "0.5.0",
-  "description": "TypeScript SDK for Boltstore \u2014 works in Bun, Node 18+, browsers, React Native",
+  "version": "0.5.1",
+  "description": "TypeScript SDK for Boltstore — works in Bun, Node 18+, browsers, React Native",
   "type": "module",
   "main": "./src/index.ts",
   "bin": {
@@ -41,5 +41,8 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/boltstore/client"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/src/index.ts

@@ -27,8 +27,10 @@ export {
   deleteRecord,
   getAllRecords,
   batch,
+  aggregateRecords,
+  bulkCreateRecords,
 } from "./records";
-export type { RecordQuery, RecordListResult } from "./records";
+export type { RecordQuery, RecordListResult, AggregateQuery, AggregateResult } from "./records";
 
 // ── Collections ──
 export {

package/src/records.ts

@@ -55,6 +55,91 @@ export async function batch(
   return result.data.results;
 }
 
+// ── Aggregate ──
+
+export interface AggregateQuery {
+  groupBy?: string | string[];
+  aggregate?: "count" | "sum" | "avg" | "min" | "max";
+  aggregateField?: string;
+  filter?: string;
+  sort?: string;
+  limit?: number;
+}
+
+export interface AggregateResult {
+  items: Record<string, unknown>[];
+  groupBy: string[];
+  aggregate?: string;
+  total?: number;
+}
+
+/**
+ * Aggregate records (GROUP BY / COUNT / SUM / AVG / MIN / MAX).
+ *
+ * @example
+ * const result = await aggregateRecords(client, "jobs", {
+ *   groupBy: "company",
+ *   aggregate: "count",
+ *   sort: "-total",
+ * });
+ */
+export async function aggregateRecords(
+  client: BoltstoreClient,
+  collection: string,
+  query?: AggregateQuery
+): Promise<AggregateResult> {
+  const params: Record<string, string> = {};
+
+  if (query?.groupBy) {
+    params.groupBy = Array.isArray(query.groupBy)
+      ? query.groupBy.join(",")
+      : query.groupBy;
+  }
+  if (query?.aggregate) params.aggregate = query.aggregate;
+  if (query?.aggregateField) params.aggregateField = query.aggregateField;
+  if (query?.filter) params.filter = query.filter;
+  if (query?.sort) params.sort = query.sort;
+  if (query?.limit) params.limit = String(query.limit);
+
+  const result = await client.get<AggregateResult>(
+    `/api/collections/${collection}/aggregate`,
+    params
+  );
+
+  if (!result.success || !result.data) {
+    throw new Error(result.error?.message ?? "Failed to aggregate records");
+  }
+
+  return result.data;
+}
+
+/**
+ * Bulk create multiple records in a single request.
+ * Uses the bulk array endpoint (more efficient than batch API).
+ *
+ * @example
+ * const created = await bulkCreateRecords(client, "todos", [
+ *   { title: "A" },
+ *   { title: "B" },
+ * ]);
+ */
+export async function bulkCreateRecords(
+  client: BoltstoreClient,
+  collection: string,
+  records: Record<string, unknown>[]
+): Promise<RecordData[]> {
+  const result = await client.post<RecordData[]>(
+    `/api/collections/${collection}/records`,
+    records
+  );
+
+  if (!result.success || !result.data) {
+    throw new Error(result.error?.message ?? "Failed to bulk create records");
+  }
+
+  return result.data;
+}
+
 // ── CRUD Operations ──
 
 /**