fastify-auto-sqlapi 0.0.5 → 0.1.1

package/dist/lib/engine/write-helpers.d.ts

@@ -1,8 +1,45 @@
+import type { FastifyRequest } from 'fastify';
 import type { QueryClient } from '../db.js';
 import type { ITable, DbTables, JoinDefinition } from '../../types.js';
-export declare function findWriteJoin(tableConf: ITable, joinTableName: string): JoinDefinition | undefined;
+export declare function findWriteJoin(tableConf: ITable, alias: string): JoinDefinition | undefined;
 export declare function removeExcludedFields(record: Record<string, unknown>, tableConf: ITable): Record<string, unknown>;
 export declare function findSecondaryTableConf(dbTables: DbTables, joinTableName: string): ITable | undefined;
+interface PrepareCtx {
+    db: QueryClient;
+    tableConf: ITable;
+    request: FastifyRequest;
+}
+/**
+ * Prepare a single record for INSERT/UPSERT:
+ *   1. shallow camelCase copy of `input`
+ *   2. runValidation (camelCase)
+ *   3. beforeInsert hook (caller can mutate the camelCase copy)
+ *   4. snakecaseRecord → DB format
+ *   5. removeExcludedFields
+ *
+ * Returns both `camel` (input + hook mutations, used for FK auto-fill / afterInsert) and
+ * `snake` (DB-ready record). The original `input` is left intact.
+ *
+ * Pass `secondaries` so the validate hook receives them; pass undefined to skip
+ * secondaries-aware validation (e.g. when a bulk-level validator already ran).
+ */
+export declare function prepareInsertRecord(ctx: PrepareCtx, input: Record<string, unknown>, secondaries?: Record<string, Record<string, unknown>[]>, options?: {
+    skipValidate?: boolean;
+}): Promise<{
+    camel: Record<string, unknown>;
+    snake: Record<string, unknown>;
+}>;
 export declare function processSecondaries(db: QueryClient, tableConf: ITable, dbTables: DbTables, mainRecord: Record<string, unknown>, secondaries: Record<string, Record<string, unknown>[]>): Promise<Record<string, Record<string, unknown>[]>>;
-export declare function processDeletions(db: QueryClient, tableConf: ITable, deletions: Record<string, Record<string, unknown>[]>): Promise<Record<string, Record<string, unknown>[]>>;
+/**
+ * Process per-alias deletion requests for a write join.
+ *
+ * The FK from `mainRecord` (matching `joinDef.mainField` → `joinDef.joinField`) is
+ * auto-injected into every deletion record. This means the consumer can provide just
+ * the PK (e.g. `{ id: 5 }`) and the engine will run
+ * `DELETE FROM child WHERE id = 5 AND fk_to_main = <main.id>` — both ergonomic
+ * (no need to repeat the FK) and safer (cannot accidentally delete a row that
+ * doesn't belong to this main).
+ */
+export declare function processDeletions(db: QueryClient, tableConf: ITable, mainRecord: Record<string, unknown>, deletions: Record<string, Record<string, unknown>[]>): Promise<Record<string, Record<string, unknown>[]>>;
+export {};
 //# sourceMappingURL=write-helpers.d.ts.map

package/dist/lib/engine/write-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/write-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,cAAc,GAAG,SAAS,CAI5B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CA2DpD;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAwBpD"}
+{"version":3,"file":"write-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/write-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAE5B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAKpB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,EACvD,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAe7E;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACrD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CA2DpD;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CA+BpD"}

package/dist/lib/engine/write-helpers.js

@@ -1,6 +1,7 @@
 import { camelcaseObject, snakecaseRecord } from '../naming.js';
-export function findWriteJoin(tableConf, joinTableName) {
-    return tableConf.allowedWriteJoins?.find(([joinSchema]) => joinSchema.tableName === joinTableName);
+import { runValidation } from './validate.js';
+export function findWriteJoin(tableConf, alias) {
+    return tableConf.allowedWriteJoins?.find((j) => j.alias === alias);
 }
 export function removeExcludedFields(record, tableConf) {
     if (!tableConf.excludeFromCreation?.length)
@@ -19,17 +20,43 @@ export function findSecondaryTableConf(dbTables, joinTableName) {
     }
     return undefined;
 }
+/**
+ * Prepare a single record for INSERT/UPSERT:
+ *   1. shallow camelCase copy of `input`
+ *   2. runValidation (camelCase)
+ *   3. beforeInsert hook (caller can mutate the camelCase copy)
+ *   4. snakecaseRecord → DB format
+ *   5. removeExcludedFields
+ *
+ * Returns both `camel` (input + hook mutations, used for FK auto-fill / afterInsert) and
+ * `snake` (DB-ready record). The original `input` is left intact.
+ *
+ * Pass `secondaries` so the validate hook receives them; pass undefined to skip
+ * secondaries-aware validation (e.g. when a bulk-level validator already ran).
+ */
+export async function prepareInsertRecord(ctx, input, secondaries, options) {
+    const camel = { ...input };
+    if (!options?.skipValidate) {
+        await runValidation(ctx.db, ctx.request, ctx.tableConf, camel, secondaries);
+    }
+    if (ctx.tableConf.beforeInsert) {
+        await ctx.tableConf.beforeInsert(ctx.db, ctx.request, camel);
+    }
+    let snake = snakecaseRecord(camel, ctx.tableConf.Schema);
+    snake = removeExcludedFields(snake, ctx.tableConf);
+    return { camel, snake };
+}
 export async function processSecondaries(db, tableConf, dbTables, mainRecord, secondaries) {
     const results = {};
-    for (const [joinTableName, records] of Object.entries(secondaries)) {
+    for (const [alias, records] of Object.entries(secondaries)) {
         if (!records?.length)
             continue;
-        const joinDef = findWriteJoin(tableConf, joinTableName);
+        const joinDef = findWriteJoin(tableConf, alias);
         if (!joinDef)
             continue;
-        const [joinSchema, joinField, mainField] = joinDef;
+        const { joinSchema, joinField, mainField } = joinDef;
         const joinCol = joinSchema.col(joinField);
-        const secondaryTableConf = findSecondaryTableConf(dbTables, joinTableName);
+        const secondaryTableConf = findSecondaryTableConf(dbTables, joinSchema.tableName);
         const secondaryPk = secondaryTableConf?.primary || joinField;
         const secondaryPkCol = Array.isArray(secondaryPk)
             ? secondaryPk.map((f) => joinSchema.col(f))
@@ -56,28 +83,44 @@ export async function processSecondaries(db, tableConf, dbTables, mainRecord, se
         else {
             pkRows = await db.bulkInsert(joinSchema.tableName, preparedRecords, secondaryPkCol);
         }
-        results[joinTableName] = pkRows.map((r) => camelcaseObject(r, joinSchema));
+        results[alias] = pkRows.map((r) => camelcaseObject(r, joinSchema));
     }
     return results;
 }
-export async function processDeletions(db, tableConf, deletions) {
+/**
+ * Process per-alias deletion requests for a write join.
+ *
+ * The FK from `mainRecord` (matching `joinDef.mainField` → `joinDef.joinField`) is
+ * auto-injected into every deletion record. This means the consumer can provide just
+ * the PK (e.g. `{ id: 5 }`) and the engine will run
+ * `DELETE FROM child WHERE id = 5 AND fk_to_main = <main.id>` — both ergonomic
+ * (no need to repeat the FK) and safer (cannot accidentally delete a row that
+ * doesn't belong to this main).
+ */
+export async function processDeletions(db, tableConf, mainRecord, deletions) {
     const results = {};
-    for (const [joinTableName, records] of Object.entries(deletions)) {
+    for (const [alias, records] of Object.entries(deletions)) {
         if (!records?.length)
             continue;
-        const joinDef = findWriteJoin(tableConf, joinTableName);
+        const joinDef = findWriteJoin(tableConf, alias);
         if (!joinDef)
             continue;
-        const [joinSchema] = joinDef;
+        const { joinSchema, joinField, mainField } = joinDef;
+        const joinCol = joinSchema.col(joinField);
+        const mainValue = Array.isArray(mainField)
+            ? mainRecord[mainField[0]]
+            : mainRecord[mainField];
         const deletedRows = [];
         for (const rec of records) {
             const snaked = snakecaseRecord(rec, joinSchema);
+            // Auto-inject FK to main: scopes the DELETE to children owned by this main.
+            snaked[joinCol] = mainValue;
             const affectedRows = await db.delete(joinSchema.tableName, snaked);
             if (affectedRows > 0) {
                 deletedRows.push(camelcaseObject(snaked, joinSchema));
             }
         }
-        results[joinTableName] = deletedRows;
+        results[alias] = deletedRows;
     }
     return results;
 }

package/dist/lib/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build a plain Error decorated with `statusCode` (and optionally `validationErrors`),
+ * which Fastify reads to emit the corresponding HTTP response.
+ *
+ * Using a function instead of a custom class keeps the throw sites lightweight
+ * and matches the existing convention across the codebase.
+ */
+export declare function httpError(statusCode: number, message: string): Error & {
+    statusCode: number;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAI7F"}

package/dist/lib/errors.js

@@ -0,0 +1,12 @@
+/**
+ * Build a plain Error decorated with `statusCode` (and optionally `validationErrors`),
+ * which Fastify reads to emit the corresponding HTTP response.
+ *
+ * Using a function instead of a custom class keeps the throw sites lightweight
+ * and matches the existing convention across the codebase.
+ */
+export function httpError(statusCode, message) {
+    const err = new Error(message);
+    err.statusCode = statusCode;
+    return err;
+}

package/dist/lib/schema/bulk-upsert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-upsert.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/bulk-upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oGAiCxE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oGA8B5E"}
+{"version":3,"file":"bulk-upsert.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/bulk-upsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS/C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oGAgBxE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oGAa5E"}

package/dist/lib/schema/bulk-upsert.js

@@ -1,7 +1,6 @@
 import { Type } from '@sinclair/typebox';
 import { primaryAsString } from '../../types.js';
-import { findSecondaryTableConf } from '../engine/write-helpers.js';
-import { pkSchema, buildSecondaryFields, applySchemaOverrides } from './helpers.js';
+import { pkSchema, applySchemaOverrides, attachWriteJoinSections, writeJoinBodyFields, writeJoinResponseFields, } from './helpers.js';
 export function BulkUpsertTableBody(dbTables, tableName) {
     const tableConf = dbTables[tableName];
     const schema = tableConf.Schema;
@@ -9,18 +8,10 @@ export function BulkUpsertTableBody(dbTables, tableName) {
     const itemProperties = {
         main: mainSchema,
     };
-    if (tableConf.allowedWriteJoins?.length) {
-        const secondaryProperties = {};
-        const deletionProperties = {};
-        for (const [joinSchema, joinField] of tableConf.allowedWriteJoins) {
-            const secondaryTableConf = findSecondaryTableConf(dbTables, joinSchema.tableName);
-            const joinFields = buildSecondaryFields(joinSchema, joinField, secondaryTableConf);
-            secondaryProperties[joinSchema.tableName] = Type.Array(Type.Object(joinFields));
-            deletionProperties[joinSchema.tableName] = Type.Array(Type.Partial(Type.Object(joinSchema.fields)));
-        }
-        itemProperties.secondaries = Type.Optional(Type.Partial(Type.Object(secondaryProperties)));
-        itemProperties.deletions = Type.Optional(Type.Partial(Type.Object(deletionProperties)));
-    }
+    attachWriteJoinSections(itemProperties, tableConf, dbTables, {
+        withDeletions: true,
+        secondaryFields: writeJoinBodyFields,
+    });
     return Type.Array(Type.Object(itemProperties));
 }
 export function BulkUpsertTableResponse(dbTables, tableName) {
@@ -28,16 +19,9 @@ export function BulkUpsertTableResponse(dbTables, tableName) {
     const responseProperties = {
         main: Type.Object(pkSchema(tableConf, tableConf.Schema, primaryAsString(tableConf.primary))),
     };
-    if (tableConf.allowedWriteJoins?.length) {
-        const secondaryProperties = {};
-        const deletionProperties = {};
-        for (const [joinSchema, joinField] of tableConf.allowedWriteJoins) {
-            const secondaryTableConf = findSecondaryTableConf(dbTables, joinSchema.tableName);
-            secondaryProperties[joinSchema.tableName] = Type.Array(Type.Object(pkSchema(secondaryTableConf, joinSchema, joinField)));
-            deletionProperties[joinSchema.tableName] = Type.Array(Type.Partial(Type.Object(joinSchema.fields)));
-        }
-        responseProperties.secondaries = Type.Optional(Type.Partial(Type.Object(secondaryProperties)));
-        responseProperties.deletions = Type.Optional(Type.Partial(Type.Object(deletionProperties)));
-    }
+    attachWriteJoinSections(responseProperties, tableConf, dbTables, {
+        withDeletions: true,
+        secondaryFields: writeJoinResponseFields,
+    });
     return Type.Array(Type.Object(responseProperties));
 }

package/dist/lib/schema/helpers.d.ts

@@ -1,5 +1,5 @@
 import { type TSchema } from '@sinclair/typebox';
-import type { ITable, SchemaDefinition } from '../../types.js';
+import type { ITable, SchemaDefinition, DbTables, JoinDefinition } from '../../types.js';
 /**
  * Build a PK-only schema for response shapes (single or composite PK).
  * Falls back to `fallback` field if tableConf is undefined.
@@ -16,4 +16,31 @@ export declare function buildSecondaryFields(joinSchema: SchemaDefinition, joinF
  * Replaces matching field schemas with the override.
  */
 export declare function applySchemaOverrides(fields: Record<string, TSchema>, tableConf: ITable): Record<string, TSchema>;
+type JoinFieldsBuilder = (join: JoinDefinition, secondaryConf: ITable | undefined) => Record<string, TSchema>;
+/**
+ * Maps each writeJoin alias to a Type.Array(Type.Object(...)) using the provided fields builder.
+ * When `itemsPartial` is true, wraps each item with Type.Partial — used for deletion sub-schemas
+ * where every field is a matcher (the engine auto-injects the FK to main).
+ */
+export declare function buildJoinAliasMap(tableConf: ITable, dbTables: DbTables, build: JoinFieldsBuilder, options?: {
+    itemsPartial?: boolean;
+}): Record<string, TSchema>;
+/**
+ * Attach `secondaries` (and optionally `deletions`) sections to the given target object,
+ * iterating once over `tableConf.allowedWriteJoins`. Mutates `target` in-place.
+ * Used by body and response schema builders for insert/update/bulk-upsert.
+ *
+ * Deletions are emitted with every field Optional (Type.Partial) because the engine
+ * auto-injects the FK to main and the consumer typically just provides the PK (or a small
+ * subset of fields) to identify which child rows to delete.
+ */
+export declare function attachWriteJoinSections(target: Record<string, TSchema>, tableConf: ITable, dbTables: DbTables, options: {
+    withDeletions: boolean;
+    secondaryFields: JoinFieldsBuilder;
+}): void;
+/** JoinFieldsBuilder for body schemas: includes all join fields with FK + excluded made Optional. */
+export declare const writeJoinBodyFields: JoinFieldsBuilder;
+/** JoinFieldsBuilder for response schemas: PK only. */
+export declare const writeJoinResponseFields: JoinFieldsBuilder;
+export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/lib/schema/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAY,MAAM,gBAAgB,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ3H;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGzF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ3H;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,KAAK,iBAAiB,GAAG,CACvB,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,MAAM,GAAG,SAAS,KAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,iBAAiB,CAAA;CAAE,GACtE,IAAI,CAmBN;AAED,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,EAAE,iBACmB,CAAC;AAEtD,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,EAAE,iBACG,CAAC"}

package/dist/lib/schema/helpers.js

@@ -1,4 +1,5 @@
 import { Type } from '@sinclair/typebox';
+import { findSecondaryTableConf } from '../engine/write-helpers.js';
 /**
  * Build a PK-only schema for response shapes (single or composite PK).
  * Falls back to `fallback` field if tableConf is undefined.
@@ -46,3 +47,40 @@ export function applySchemaOverrides(fields, tableConf) {
     }
     return result;
 }
+/**
+ * Maps each writeJoin alias to a Type.Array(Type.Object(...)) using the provided fields builder.
+ * When `itemsPartial` is true, wraps each item with Type.Partial — used for deletion sub-schemas
+ * where every field is a matcher (the engine auto-injects the FK to main).
+ */
+export function buildJoinAliasMap(tableConf, dbTables, build, options = {}) {
+    const out = {};
+    if (!tableConf.allowedWriteJoins?.length)
+        return out;
+    for (const j of tableConf.allowedWriteJoins) {
+        const sc = findSecondaryTableConf(dbTables, j.joinSchema.tableName);
+        const item = Type.Object(build(j, sc));
+        out[j.alias] = Type.Array(options.itemsPartial ? Type.Partial(item) : item);
+    }
+    return out;
+}
+/**
+ * Attach `secondaries` (and optionally `deletions`) sections to the given target object,
+ * iterating once over `tableConf.allowedWriteJoins`. Mutates `target` in-place.
+ * Used by body and response schema builders for insert/update/bulk-upsert.
+ *
+ * Deletions are emitted with every field Optional (Type.Partial) because the engine
+ * auto-injects the FK to main and the consumer typically just provides the PK (or a small
+ * subset of fields) to identify which child rows to delete.
+ */
+export function attachWriteJoinSections(target, tableConf, dbTables, options) {
+    if (!tableConf.allowedWriteJoins?.length)
+        return;
+    target.secondaries = Type.Optional(Type.Partial(Type.Object(buildJoinAliasMap(tableConf, dbTables, options.secondaryFields))));
+    if (options.withDeletions) {
+        target.deletions = Type.Optional(Type.Partial(Type.Object(buildJoinAliasMap(tableConf, dbTables, ({ joinSchema }) => joinSchema.fields, { itemsPartial: true }))));
+    }
+}
+/** JoinFieldsBuilder for body schemas: includes all join fields with FK + excluded made Optional. */
+export const writeJoinBodyFields = (j, sc) => buildSecondaryFields(j.joinSchema, j.joinField, sc);
+/** JoinFieldsBuilder for response schemas: PK only. */
+export const writeJoinResponseFields = (j, sc) => pkSchema(sc, j.joinSchema, j.joinField);

package/dist/lib/schema/insert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/insert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA+B9E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAuBlF"}
+{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/insert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS/C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAsB9E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAalF"}

package/dist/lib/schema/insert.js

@@ -1,7 +1,6 @@
 import { Type } from '@sinclair/typebox';
 import { primaryAsString } from '../../types.js';
-import { findSecondaryTableConf } from '../engine/write-helpers.js';
-import { pkSchema, buildSecondaryFields, applySchemaOverrides } from './helpers.js';
+import { pkSchema, applySchemaOverrides, attachWriteJoinSections, writeJoinBodyFields, writeJoinResponseFields, } from './helpers.js';
 export function InsertTableBody(dbTables, tableName) {
     const tableConf = dbTables[tableName];
     const schema = tableConf.Schema;
@@ -15,15 +14,10 @@ export function InsertTableBody(dbTables, tableName) {
     const bodyProperties = {
         main: Type.Object(mainFields),
     };
-    if (tableConf.allowedWriteJoins?.length) {
-        const secondaryProperties = {};
-        for (const [joinSchema, joinField] of tableConf.allowedWriteJoins) {
-            const secondaryTableConf = findSecondaryTableConf(dbTables, joinSchema.tableName);
-            const joinFields = buildSecondaryFields(joinSchema, joinField, secondaryTableConf);
-            secondaryProperties[joinSchema.tableName] = Type.Array(Type.Object(joinFields));
-        }
-        bodyProperties.secondaries = Type.Optional(Type.Partial(Type.Object(secondaryProperties)));
-    }
+    attachWriteJoinSections(bodyProperties, tableConf, dbTables, {
+        withDeletions: false,
+        secondaryFields: writeJoinBodyFields,
+    });
     return Type.Object(bodyProperties);
 }
 export function InsertTableResponse(dbTables, tableName) {
@@ -31,13 +25,9 @@ export function InsertTableResponse(dbTables, tableName) {
     const responseProperties = {
         main: Type.Object(pkSchema(tableConf, tableConf.Schema, primaryAsString(tableConf.primary))),
     };
-    if (tableConf.allowedWriteJoins?.length) {
-        const secondaryProperties = {};
-        for (const [joinSchema, joinField] of tableConf.allowedWriteJoins) {
-            const secondaryTableConf = findSecondaryTableConf(dbTables, joinSchema.tableName);
-            secondaryProperties[joinSchema.tableName] = Type.Array(Type.Object(pkSchema(secondaryTableConf, joinSchema, joinField)));
-        }
-        responseProperties.secondaries = Type.Optional(Type.Partial(Type.Object(secondaryProperties)));
-    }
+    attachWriteJoinSections(responseProperties, tableConf, dbTables, {
+        withDeletions: false,
+        secondaryFields: writeJoinResponseFields,
+    });
     return Type.Object(responseProperties);
 }

package/dist/lib/schema/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU/C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAsElF;AAED,eAAO,MAAM,sBAAsB;;;;;;;;EAQjC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiClF"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAY/C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAuHlF;AAED,eAAO,MAAM,sBAAsB;;;;;;;;EASjC,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAmElF"}