boltstore 0.5.1 → 0.6.0

package/dist/records/distinct.js

@@ -0,0 +1,22 @@
+import { validateIdentifier } from "@boltstore/utils";
+import { toBindings } from "../db/cast";
+import { applyRLS, toRLSContext } from "../rls";
+import { getColumnNames } from "./schema-cache";
+function distinctValues(pool, collection, field, auth) {
+    validateIdentifier(field, "field name");
+    getColumnNames(pool, collection);
+    const db = pool.read();
+    const rlsCtx = auth ? toRLSContext(auth) : null;
+    const rls = rlsCtx ? applyRLS(pool, collection, "read", rlsCtx) : null;
+    let sql = `SELECT DISTINCT "${field}" FROM "${collection}"`;
+    const params = [];
+    if (rls?.whereClause) {
+        sql += ` WHERE ${rls.whereClause}`;
+        params.push(...rls.params);
+    }
+    sql += ` ORDER BY "${field}"`;
+    const rows = db.query(sql).all(...toBindings(params));
+    return rows.map((r) => r[field]);
+}
+export { distinctValues };
+//# sourceMappingURL=distinct.js.map

package/dist/records/distinct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distinct.js","sourceRoot":"","sources":["../../src/records/distinct.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAmB,MAAM,QAAQ,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,SAAS,cAAc,CACrB,IAAkB,EAClB,UAAkB,EAClB,KAAa,EACb,IAAkB;IAElB,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACxC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvE,IAAI,GAAG,GAAG,oBAAoB,KAAK,WAAW,UAAU,GAAG,CAAC;IAC5D,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;QACrB,GAAG,IAAI,UAAU,GAAG,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,GAAG,IAAI,cAAc,KAAK,GAAG,CAAC;IAE9B,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAA8B,CAAC;IAEnF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/records/helpers.d.ts

@@ -0,0 +1,4 @@
+declare function generateId(): string;
+declare function now(): string;
+export { generateId, now };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/records/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/records/helpers.ts"],"names":[],"mappings":"AAEA,iBAAS,UAAU,IAAI,MAAM,CAE5B;AAED,iBAAS,GAAG,IAAI,MAAM,CAErB;AAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC"}

package/dist/records/helpers.js

@@ -0,0 +1,9 @@
+import { generateSecureId } from "@boltstore/utils";
+function generateId() {
+    return generateSecureId("rec");
+}
+function now() {
+    return new Date().toISOString();
+}
+export { generateId, now };
+//# sourceMappingURL=helpers.js.map

package/dist/records/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/records/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,SAAS,UAAU;IACjB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,GAAG;IACV,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC"}

package/dist/records/list.d.ts

@@ -0,0 +1,44 @@
+import { DatabasePool } from "../db/pool";
+import type { AuthContext } from "../middleware/auth";
+interface ListRecordsResult {
+    records: Record<string, unknown>[];
+    meta: {
+        total?: number;
+        page?: number;
+        per_page?: number;
+        total_pages?: number;
+        next_cursor?: string | null;
+    };
+}
+interface PaginationMetaOptions {
+    page: number;
+    perPage: number;
+    filter?: Record<string, unknown>;
+    sort?: string;
+}
+declare function listRecords(pool: DatabasePool, collection: string, options?: {
+    filter?: Record<string, unknown>;
+    sort?: string;
+    direction?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+    page?: number;
+    perPage?: number;
+    cursor?: string;
+    fields?: string[];
+}, auth?: AuthContext): Record<string, unknown>[];
+declare function buildListSql(collection: string, options?: {
+    filter?: Record<string, unknown>;
+    sort?: string;
+    direction?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    fields?: string[];
+}): {
+    sql: string;
+    params: unknown[];
+};
+declare function buildPaginationMeta(pool: DatabasePool, collection: string, options: PaginationMetaOptions, auth?: AuthContext, lastRecord?: Record<string, unknown>): ListRecordsResult["meta"];
+export { listRecords, buildListSql, buildPaginationMeta, ListRecordsResult, PaginationMetaOptions };
+//# sourceMappingURL=list.d.ts.map

package/dist/records/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/records/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;CACH;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iBAAS,WAAW,CAClB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,EACD,IAAI,CAAC,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA2E3B;AAED,iBAAS,YAAY,CACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GACA;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAkDpC;AAED,iBAAS,mBAAmB,CAC1B,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,iBAAiB,CAAC,MAAM,CAAC,CAa3B;AAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/records/list.js

@@ -0,0 +1,133 @@
+import { validateIdentifier } from "@boltstore/utils";
+import { toBindings } from "../db/cast";
+import { applyRLS, toRLSContext } from "../rls";
+import { getColumnNames, MAX_LIMIT, MAX_OFFSET } from "./schema-cache";
+import { countRecords } from "./count";
+function listRecords(pool, collection, options, auth) {
+    getColumnNames(pool, collection);
+    const db = pool.read();
+    let limit = options?.limit;
+    let offset = options?.offset;
+    let page;
+    let perPage;
+    if (options?.page !== undefined && options?.perPage !== undefined) {
+        page = options.page;
+        perPage = options.perPage;
+        limit = perPage;
+        offset = (page - 1) * perPage;
+    }
+    if (limit !== undefined) {
+        limit = Math.max(1, Math.min(limit, MAX_LIMIT));
+    }
+    if (offset !== undefined) {
+        offset = Math.max(0, Math.min(offset, MAX_OFFSET));
+    }
+    const selectCols = options?.fields?.length
+        ? options.fields.map((f) => `"${f}"`).join(", ")
+        : "*";
+    let sql = `SELECT ${selectCols} FROM "${collection}"`;
+    const params = [];
+    const conditions = [];
+    const rlsCtx = auth ? toRLSContext(auth) : null;
+    const rls = rlsCtx ? applyRLS(pool, collection, "read", rlsCtx) : null;
+    if (rls?.whereClause) {
+        conditions.push(rls.whereClause);
+        params.push(...rls.params);
+    }
+    if (options?.filter) {
+        for (const [key, value] of Object.entries(options.filter)) {
+            if (value === null || value === undefined)
+                continue;
+            if (typeof value === "object" && !Array.isArray(value)) {
+                throw Object.assign(new Error(`Filter value for "${key}" must be a scalar or array.`), { status: 400 });
+            }
+            validateIdentifier(key, "filter field");
+            conditions.push(`"${key}" = ?`);
+            params.push(value);
+        }
+    }
+    const sortField = options?.sort || "created_at";
+    validateIdentifier(sortField, "sort field");
+    if (options?.cursor) {
+        const op = options.direction === "asc" ? ">" : "<";
+        conditions.push(`"${sortField}" ${op} ?`);
+        params.push(options.cursor);
+    }
+    if (conditions.length > 0) {
+        sql += " WHERE " + conditions.join(" AND ");
+    }
+    const direction = options?.direction === "asc" ? "ASC" : "DESC";
+    sql += ` ORDER BY "${sortField}" ${direction}`;
+    if (limit !== undefined) {
+        sql += ` LIMIT ?`;
+        params.push(limit);
+    }
+    if (offset !== undefined) {
+        sql += ` OFFSET ?`;
+        params.push(offset);
+    }
+    const records = db.query(sql).all(...toBindings(params));
+    return records;
+}
+function buildListSql(collection, options) {
+    validateIdentifier(collection, "collection name");
+    const selectCols = options?.fields?.length
+        ? options.fields.map((f) => `"${f}"`).join(", ")
+        : "*";
+    let sql = `SELECT ${selectCols} FROM "${collection}"`;
+    const params = [];
+    const conditions = [];
+    if (options?.filter) {
+        for (const [key, value] of Object.entries(options.filter)) {
+            if (value === null || value === undefined)
+                continue;
+            if (typeof value === "object" && !Array.isArray(value)) {
+                throw Object.assign(new Error(`Filter value for "${key}" must be a scalar or array.`), { status: 400 });
+            }
+            validateIdentifier(key, "filter field");
+            conditions.push(`"${key}" = ?`);
+            params.push(value);
+        }
+    }
+    const sortField = options?.sort || "created_at";
+    validateIdentifier(sortField, "sort field");
+    if (options?.cursor) {
+        const op = options.direction === "asc" ? ">" : "<";
+        conditions.push(`"${sortField}" ${op} ?`);
+        params.push(options.cursor);
+    }
+    if (conditions.length > 0) {
+        sql += " WHERE " + conditions.join(" AND ");
+    }
+    const direction = options?.direction === "asc" ? "ASC" : "DESC";
+    sql += ` ORDER BY "${sortField}" ${direction}`;
+    let limit = options?.limit;
+    let offset = options?.offset;
+    if (limit !== undefined) {
+        limit = Math.max(1, Math.min(limit, MAX_LIMIT));
+        sql += ` LIMIT ?`;
+        params.push(limit);
+    }
+    if (offset !== undefined) {
+        offset = Math.max(0, Math.min(offset, MAX_OFFSET));
+        sql += ` OFFSET ?`;
+        params.push(offset);
+    }
+    return { sql, params };
+}
+function buildPaginationMeta(pool, collection, options, auth, lastRecord) {
+    const total = countRecords(pool, collection, options.filter, auth);
+    const meta = {
+        total,
+        page: options.page,
+        per_page: options.perPage,
+        total_pages: Math.ceil(total / options.perPage),
+    };
+    if (lastRecord) {
+        const key = options.sort || "created_at";
+        meta.next_cursor = lastRecord[key];
+    }
+    return meta;
+}
+export { listRecords, buildListSql, buildPaginationMeta };
+//# sourceMappingURL=list.js.map

package/dist/records/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/records/list.ts"],"names":[],"mappings":"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"}

package/dist/records/schema-cache.d.ts

@@ -0,0 +1,8 @@
+import { DatabasePool } from "../db/pool";
+declare const MAX_LIMIT = 1000;
+declare const MAX_OFFSET = 100000;
+declare function getColumnNames(pool: DatabasePool, collection: string): string[];
+declare function invalidateSchemaCache(pool: DatabasePool, collection?: string): void;
+declare function collectionExists(pool: DatabasePool, collection: string): boolean;
+export { invalidateSchemaCache, getColumnNames, collectionExists, MAX_LIMIT, MAX_OFFSET };
+//# sourceMappingURL=schema-cache.d.ts.map

package/dist/records/schema-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cache.d.ts","sourceRoot":"","sources":["../../src/records/schema-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,QAAA,MAAM,SAAS,OAAO,CAAC;AACvB,QAAA,MAAM,UAAU,SAAS,CAAC;AAiC1B,iBAAS,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBxE;AAED,iBAAS,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ5E;AAED,iBAAS,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CASzE;AAED,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC"}

package/dist/records/schema-cache.js

@@ -0,0 +1,64 @@
+import { validateIdentifier } from "@boltstore/utils";
+const MAX_LIMIT = 1000;
+const MAX_OFFSET = 100000;
+const schemaCache = new WeakMap();
+const SCHEMA_CACHE_TTL_MS = 30000;
+function getPoolCache(pool) {
+    let cache = schemaCache.get(pool);
+    if (!cache) {
+        cache = new Map();
+        schemaCache.set(pool, cache);
+    }
+    return cache;
+}
+function fetchColumns(pool, collection) {
+    validateIdentifier(collection, "collection name");
+    const db = pool.read();
+    const existsRow = db
+        .query("SELECT 1 FROM sqlite_master WHERE type='table' AND name=? LIMIT 1")
+        .get(collection);
+    if (!existsRow) {
+        return { columns: [], exists: false, fetchedAt: Date.now() };
+    }
+    const rows = db.query(`PRAGMA table_info("${collection}")`).all();
+    return { columns: rows.map((r) => r.name), exists: true, fetchedAt: Date.now() };
+}
+function getColumnNames(pool, collection) {
+    const cache = getPoolCache(pool);
+    const entry = cache.get(collection);
+    if (entry && Date.now() - entry.fetchedAt < SCHEMA_CACHE_TTL_MS) {
+        if (!entry.exists) {
+            throw Object.assign(new Error(`Collection "${collection}" not found.`), { status: 404 });
+        }
+        return entry.columns;
+    }
+    const fresh = fetchColumns(pool, collection);
+    cache.set(collection, fresh);
+    if (!fresh.exists) {
+        throw Object.assign(new Error(`Collection "${collection}" not found.`), { status: 404 });
+    }
+    return fresh.columns;
+}
+function invalidateSchemaCache(pool, collection) {
+    const cache = schemaCache.get(pool);
+    if (!cache)
+        return;
+    if (collection) {
+        cache.delete(collection);
+    }
+    else {
+        cache.clear();
+    }
+}
+function collectionExists(pool, collection) {
+    const cache = getPoolCache(pool);
+    const entry = cache.get(collection);
+    if (entry && Date.now() - entry.fetchedAt < SCHEMA_CACHE_TTL_MS) {
+        return entry.exists;
+    }
+    const fresh = fetchColumns(pool, collection);
+    cache.set(collection, fresh);
+    return fresh.exists;
+}
+export { invalidateSchemaCache, getColumnNames, collectionExists, MAX_LIMIT, MAX_OFFSET };
+//# sourceMappingURL=schema-cache.js.map

package/dist/records/schema-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cache.js","sourceRoot":"","sources":["../../src/records/schema-cache.ts"],"names":[],"mappings":"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"}

package/dist/records.d.ts

@@ -0,0 +1,8 @@
+export * from "./records/schema-cache";
+export * from "./records/crud";
+export * from "./records/list";
+export * from "./records/count";
+export * from "./records/distinct";
+export * from "./records/batch";
+export * from "./records/helpers";
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/records.js

@@ -0,0 +1,8 @@
+export * from "./records/schema-cache";
+export * from "./records/crud";
+export * from "./records/list";
+export * from "./records/count";
+export * from "./records/distinct";
+export * from "./records/batch";
+export * from "./records/helpers";
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/relations.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Relations / References — lightweight foreign key relations for Boltstore.
+ *
+ * Adds support for:
+ * - `expand` parameter to fetch related records by foreign key
+ * - Reference field type in schema with optional cascade delete
+ *
+ * @module boltstore/relations
+ */
+import { DatabasePool } from "./db/pool";
+import type { AuthContext } from "./middleware/auth";
+/** Metadata for a single relation field. */
+export interface RelationDefinition {
+    /** The column in this collection that holds the foreign key. */
+    field: string;
+    /** The target collection (table) that records reference. */
+    foreignCollection: string;
+    /** Whether deleting a record in this collection cascades to children (Phase 1 feature). */
+    cascadeDelete?: boolean;
+}
+/** Load explicit relation definitions for a collection from metadata. */
+export declare function getRelations(pool: DatabasePool, collection: string): Record<string, RelationDefinition>;
+/** Persist explicit relation definitions for a collection. */
+export declare function setRelations(pool: DatabasePool, collection: string, relations: Record<string, RelationDefinition>): void;
+/**
+ * Expand related records for a list of parent records.
+ *
+ * For each record, if it has a field whose name is provided in `expandFields`,
+ * the function fetches the related record from the target collection and nests
+ * it under the key `{field}_expanded`.
+ *
+ * Example:
+ * ```
+ * GET /api/myapp/collections/posts/records?expand=author
+ * ```
+ * If `posts` has an `author` column storing user IDs, the returned records
+ * will include `author_expanded: { id, name, ... }`.
+ */
+export declare function expandRecords(pool: DatabasePool, parentCollection: string, records: Record<string, unknown>[], expandFields: string[], _depth?: number): Record<string, unknown>[];
+/**
+ * Cascade delete: when a parent record is deleted, also delete child records
+ * that reference it via a foreign key field.
+ *
+ * Checks all collections in the database for a field matching `{parentCollection}_id`
+ * and deletes records where that field equals the deleted `parentId`.
+ */
+export declare function cascadeDelete(pool: DatabasePool, parentCollection: string, parentId: string, _auth?: AuthContext): {
+    deleted: string[];
+};
+//# sourceMappingURL=relations.d.ts.map

package/dist/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../src/relations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAoCD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAavG;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC5C,IAAI,CAQN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,SAAI,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgE3B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,WAAW,GAClB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BvB"}

package/dist/relations.js

@@ -0,0 +1,179 @@
+/**
+ * Relations / References — lightweight foreign key relations for Boltstore.
+ *
+ * Adds support for:
+ * - `expand` parameter to fetch related records by foreign key
+ * - Reference field type in schema with optional cascade delete
+ *
+ * @module boltstore/relations
+ */
+import { validateIdentifier } from "@boltstore/utils";
+/** Maximum recursion depth for nested expansion. */
+const MAX_EXPAND_DEPTH = 2;
+/** Resolve a target collection for an expand field using relation metadata first, then heuristic. */
+function resolveTargetCollection(pool, parentCollection, field) {
+    // 1. Try explicit relation metadata stored in _collections
+    try {
+        const db = pool.read();
+        const meta = db
+            .query("SELECT relations_json FROM _collections WHERE name = ?")
+            .get(parentCollection);
+        if (meta?.relations_json) {
+            const relations = JSON.parse(meta.relations_json);
+            if (relations[field]?.foreignCollection) {
+                return relations[field].foreignCollection;
+            }
+        }
+    }
+    catch {
+        // _collections may not exist yet; fall through to heuristic.
+    }
+    // 2. Heuristic pluralization
+    let targetCollection = `${field}s`;
+    if (field.endsWith("y")) {
+        targetCollection = field.slice(0, -1) + "ies";
+    }
+    else if (field.endsWith("s") || field.endsWith("x") || field.endsWith("ch") || field.endsWith("sh")) {
+        targetCollection = field + "es";
+    }
+    try {
+        validateIdentifier(targetCollection, "target collection");
+        return targetCollection;
+    }
+    catch {
+        return null;
+    }
+}
+/** Load explicit relation definitions for a collection from metadata. */
+export function getRelations(pool, collection) {
+    try {
+        const db = pool.read();
+        const meta = db
+            .query("SELECT relations_json FROM _collections WHERE name = ?")
+            .get(collection);
+        if (meta?.relations_json) {
+            return JSON.parse(meta.relations_json);
+        }
+    }
+    catch {
+        // ignore
+    }
+    return {};
+}
+/** Persist explicit relation definitions for a collection. */
+export function setRelations(pool, collection, relations) {
+    const db = pool.write();
+    try {
+        db.run("ALTER TABLE _collections ADD COLUMN relations_json TEXT");
+    }
+    catch {
+        // Column may already exist.
+    }
+    db.run("UPDATE _collections SET relations_json = ? WHERE name = ?", [JSON.stringify(relations), collection]);
+}
+/**
+ * Expand related records for a list of parent records.
+ *
+ * For each record, if it has a field whose name is provided in `expandFields`,
+ * the function fetches the related record from the target collection and nests
+ * it under the key `{field}_expanded`.
+ *
+ * Example:
+ * ```
+ * GET /api/myapp/collections/posts/records?expand=author
+ * ```
+ * If `posts` has an `author` column storing user IDs, the returned records
+ * will include `author_expanded: { id, name, ... }`.
+ */
+export function expandRecords(pool, parentCollection, records, expandFields, _depth = 0) {
+    if (!Array.isArray(records) || records.length === 0)
+        return records;
+    if (!Array.isArray(expandFields) || expandFields.length === 0)
+        return records;
+    if (_depth >= MAX_EXPAND_DEPTH)
+        return records;
+    const expanded = records.map((r) => ({ ...r }));
+    for (const field of expandFields) {
+        validateIdentifier(field, "field name");
+        const targetCollection = resolveTargetCollection(pool, parentCollection, field);
+        if (!targetCollection)
+            continue;
+        // Group parent IDs to fetch in batch
+        const foreignIds = new Set();
+        for (const record of records) {
+            const foreignId = record[field];
+            if (foreignId !== null && foreignId !== undefined && typeof foreignId === "string") {
+                foreignIds.add(foreignId);
+            }
+        }
+        if (foreignIds.size === 0)
+            continue;
+        // Fetch related records
+        const db = pool.read();
+        // Check if the target collection exists
+        const tableExists = db
+            .query("SELECT 1 FROM sqlite_master WHERE type='table' AND name=?")
+            .get(targetCollection);
+        if (!tableExists) {
+            // Still set explicit null for non-existent heuristic targets so callers see a deterministic key.
+            for (const record of expanded) {
+                record[`${field}_expanded`] = null;
+            }
+            continue;
+        }
+        // Build batch query
+        const placeholders = Array.from(foreignIds).map(() => "?").join(", ");
+        const relatedRows = db
+            .query(`SELECT * FROM "${targetCollection}" WHERE id IN (${placeholders})`)
+            .all(...Array.from(foreignIds));
+        // Build a map for O(1) lookup
+        const relatedMap = new Map();
+        for (const row of relatedRows) {
+            relatedMap.set(row.id, row);
+        }
+        // Attach expanded data
+        for (const record of expanded) {
+            const foreignId = record[field];
+            const expandKey = `${field}_expanded`;
+            if (foreignId && relatedMap.has(foreignId)) {
+                record[expandKey] = relatedMap.get(foreignId);
+            }
+            else {
+                record[expandKey] = null;
+            }
+        }
+    }
+    return expanded;
+}
+/**
+ * Cascade delete: when a parent record is deleted, also delete child records
+ * that reference it via a foreign key field.
+ *
+ * Checks all collections in the database for a field matching `{parentCollection}_id`
+ * and deletes records where that field equals the deleted `parentId`.
+ */
+export function cascadeDelete(pool, parentCollection, parentId, _auth) {
+    validateIdentifier(parentCollection, "collection name");
+    const deleted = [];
+    pool.writeTransaction(() => {
+        const db = pool.write();
+        // Find all tables that have a column named {parentCollection}_id
+        const allTables = db
+            .query("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
+            .all();
+        for (const table of allTables) {
+            const foreignKey = `${parentCollection}_id`;
+            // Check if this table has the foreign key column via PRAGMA
+            const columns = db
+                .query(`PRAGMA table_info("${table.name}")`)
+                .all();
+            const hasColumn = columns.some((c) => c.name === foreignKey);
+            if (hasColumn) {
+                db.run(`DELETE FROM "${table.name}" WHERE "${foreignKey}" = ?`, [parentId]);
+                deleted.push(table.name);
+            }
+        }
+    });
+    return { deleted };
+}
+//# sourceMappingURL=relations.js.map

package/dist/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../src/relations.ts"],"names":[],"mappings":"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"}