@quilla-be-kit/persistence-init-test 0.1.0

package/dist/query/sql-query-builder.interface.d.ts

@@ -0,0 +1,99 @@
+import type { PaginationOptions, SortOption } from './list-query.type.js';
+import type { QueryProduct } from './query-product.type.js';
+export type OrderByOptions = {
+    readonly defaults?: readonly SortOption[];
+    readonly enforced?: readonly SortOption[];
+};
+export type PaginateOptions = PaginationOptions & {
+    readonly distinctOn?: readonly string[];
+};
+/**
+ * Fluent SQL builder for read-side queries. Implementations are immutable:
+ * every chained call returns a new builder instance, so a base builder
+ * can be forked without accidental state sharing.
+ *
+ * Column names passed to `select` / `groupBy` / `orderBy` / `filters` are
+ * resolved through the builder's configured `ColumnResolver` (domain key
+ * → DB column). Raw strings passed to `from`, `join`, and `where` are
+ * emitted verbatim — the builder validates identifiers in the structured
+ * seams (select/filters/etc.) but trusts raw clauses.
+ *
+ * Identifiers passed to `from`, `join`, `groupBy`, and inside `select`
+ * column lists are validated against a strict identifier regex
+ * (`[a-zA-Z_][a-zA-Z0-9_]*`, with `.` permitted for `table.column` and
+ * optional `AS alias` suffixes). This is defense-in-depth: user input
+ * must never reach these seams — it flows through `.where(sql, ...params)`
+ * or `.filters({...})`, both of which parameterise.
+ */
+export interface SqlQueryBuilder<TRow = unknown> {
+    /**
+     * Project columns. Column names are domain-keyed (camelCase); the
+     * builder emits `db_col AS "domainKey"` when the resolved column
+     * differs from the domain key, so read models receive the domain
+     * vocabulary. Accepts already-qualified expressions (`table.col`) too.
+     */
+    select(columns: readonly string[]): SqlQueryBuilder<TRow>;
+    /**
+     * Target table. Validated as an identifier; accepts `schema.table`.
+     */
+    from(table: string): SqlQueryBuilder<TRow>;
+    /**
+     * Raw JOIN clause, emitted verbatim. Use parameterised `where` for
+     * conditions that depend on runtime values.
+     */
+    join(clause: string): SqlQueryBuilder<TRow>;
+    /**
+     * GROUP BY — domain-keyed column list, resolved the same way as
+     * `select`.
+     */
+    groupBy(columns: readonly string[]): SqlQueryBuilder<TRow>;
+    /**
+     * Add a raw WHERE fragment with positional `?` placeholders. Each
+     * call is ANDed with previous conditions.
+     *
+     * @example
+     * .where('deleted_at IS NULL')
+     * .where('tags @> ?::jsonb', JSON.stringify(['urgent']))
+     */
+    where(condition: string, ...params: readonly unknown[]): SqlQueryBuilder<TRow>;
+    /**
+     * Structured filters using the suffix-operator DSL. The delimiter is
+     * double-underscore (`__`):
+     *
+     * - `field` → equality (`=`, or `IS NULL` if value is `null`)
+     * - `field__contains` → `ILIKE '%value%'` (string fields)
+     * - `field__in` / `field__notIn` → `= ANY($n)` / `<> ALL($n)`
+     * - `field__gt` / `__gte` / `__lt` / `__lte` → comparators
+     * - `field__isNull` / `field__isNotNull` → boolean-valued
+     *
+     * Field keys are domain-vocabulary (camelCase); the resolver
+     * translates to DB columns at build time.
+     *
+     * Each key in the map contributes one ANDed predicate. Calling
+     * `.filters()` multiple times merges (later keys override earlier
+     * ones for the same key).
+     *
+     * Undefined values are skipped — a filter key with `undefined`
+     * contributes nothing (so `filters({ foo: opts.foo })` works when
+     * `opts.foo` is optional).
+     */
+    filters(filters: Readonly<Record<string, unknown>>): SqlQueryBuilder<TRow>;
+    /**
+     * ORDER BY. Accepts the `[{ field: 'asc' }, { other: 'desc' }]` form.
+     * `enforced` options are always applied (e.g. tenant-first secondary
+     * sort); `defaults` apply only when user sort is empty.
+     */
+    orderBy(sort: readonly SortOption[] | undefined, options?: OrderByOptions): SqlQueryBuilder<TRow>;
+    /**
+     * LIMIT / OFFSET pagination. When present, `.build()` emits a
+     * `countSql` alongside `sql` so `findPaginated` can resolve total
+     * rows with the same parameters.
+     */
+    paginate(options: PaginateOptions): SqlQueryBuilder<TRow>;
+    /**
+     * Emit the final SQL + params. Result is a `QueryProduct` ready to
+     * hand to `BaseReadDao.findOne` / `findMany` / `findPaginated`.
+     */
+    build(): QueryProduct;
+}
+//# sourceMappingURL=sql-query-builder.interface.d.ts.map

package/dist/query/sql-query-builder.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-query-builder.interface.d.ts","sourceRoot":"","sources":["../../src/query/sql-query-builder.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe,CAAC,IAAI,GAAG,OAAO;IAC7C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE1D;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3C;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE5C;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE3E;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAElG;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE1D;;;OAGG;IACH,KAAK,IAAI,YAAY,CAAC;CACvB"}

package/dist/query/sql-query-builder.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sql-query-builder.interface.js.map

package/dist/query/sql-query-builder.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-query-builder.interface.js","sourceRoot":"","sources":["../../src/query/sql-query-builder.interface.ts"],"names":[],"mappings":""}

package/dist/query/sql-statement.type.d.ts

@@ -0,0 +1,5 @@
+export type SqlStatement = {
+    readonly text: string;
+    readonly params: readonly unknown[];
+};
+//# sourceMappingURL=sql-statement.type.d.ts.map

package/dist/query/sql-statement.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-statement.type.d.ts","sourceRoot":"","sources":["../../src/query/sql-statement.type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC,CAAC"}

package/dist/query/sql-statement.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sql-statement.type.js.map

package/dist/query/sql-statement.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-statement.type.js","sourceRoot":"","sources":["../../src/query/sql-statement.type.ts"],"names":[],"mappings":""}

package/dist/query/write-query-builder.interface.d.ts

@@ -0,0 +1,34 @@
+import type { FilterQuery } from './filter-query.type.js';
+import type { SqlStatement } from './sql-statement.type.js';
+export type OptimisticLock = {
+    readonly column: string;
+    readonly expected: unknown;
+};
+export type InsertOptions = {
+    readonly table: string;
+    readonly rows: readonly Record<string, unknown>[];
+    readonly returning?: readonly string[];
+};
+export type UpdateOptions<T> = {
+    readonly table: string;
+    readonly set: Record<string, unknown>;
+    readonly where: FilterQuery<T>;
+    readonly optimisticLock?: OptimisticLock;
+    readonly returning?: readonly string[];
+};
+export type DeleteOptions<T> = {
+    readonly table: string;
+    readonly where: FilterQuery<T>;
+};
+export type SelectForUpdateOptions<T> = {
+    readonly table: string;
+    readonly columns?: readonly string[];
+    readonly where: FilterQuery<T>;
+};
+export interface WriteQueryBuilder {
+    insert(opts: InsertOptions): SqlStatement;
+    update<T>(opts: UpdateOptions<T>): SqlStatement;
+    delete<T>(opts: DeleteOptions<T>): SqlStatement;
+    selectForUpdate<T>(opts: SelectForUpdateOptions<T>): SqlStatement;
+}
+//# sourceMappingURL=write-query-builder.interface.d.ts.map

package/dist/query/write-query-builder.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-query-builder.interface.d.ts","sourceRoot":"","sources":["../../src/query/write-query-builder.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IAC1C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;IAChD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;IAChD,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;CACnE"}

package/dist/query/write-query-builder.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=write-query-builder.interface.js.map

package/dist/query/write-query-builder.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-query-builder.interface.js","sourceRoot":"","sources":["../../src/query/write-query-builder.interface.ts"],"names":[],"mappings":""}

package/dist/query-schema/field-descriptor-from-zod.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { FieldDescriptorMap } from '../query/field-descriptor.type.js';
+export declare function fieldDescriptorsFromZod(schema: z.ZodObject<z.ZodRawShape>): FieldDescriptorMap;
+//# sourceMappingURL=field-descriptor-from-zod.d.ts.map

package/dist/query-schema/field-descriptor-from-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-descriptor-from-zod.d.ts","sourceRoot":"","sources":["../../src/query-schema/field-descriptor-from-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,mCAAmC,CAAC;AAE3C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,kBAAkB,CAQ9F"}

package/dist/query-schema/field-descriptor-from-zod.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export function fieldDescriptorsFromZod(schema) {
+    const shape = schema.shape;
+    const result = {};
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        const descriptor = descriptorFromZodField(fieldSchema);
+        if (descriptor)
+            result[key] = descriptor;
+    }
+    return result;
+}
+function descriptorFromZodField(schema) {
+    const optional = schema instanceof z.ZodOptional;
+    const inner = optional ? schema.unwrap() : schema;
+    const kind = kindOf(inner);
+    if (!kind)
+        return null;
+    return optional ? { kind, optional: true } : { kind };
+}
+function kindOf(schema) {
+    if (schema instanceof z.ZodString)
+        return 'string';
+    if (schema instanceof z.ZodNumber)
+        return 'number';
+    if (schema instanceof z.ZodBoolean)
+        return 'boolean';
+    if (schema instanceof z.ZodDate)
+        return 'date';
+    return null;
+}
+//# sourceMappingURL=field-descriptor-from-zod.js.map

package/dist/query-schema/field-descriptor-from-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-descriptor-from-zod.js","sourceRoot":"","sources":["../../src/query-schema/field-descriptor-from-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,UAAU,uBAAuB,CAAC,MAAkC;IACxE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,sBAAsB,CAAC,WAAwB,CAAC,CAAC;QACpE,IAAI,UAAU;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAiB;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,CAAC,WAAW,CAAC;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAE,MAAmC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAChF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,MAAM,CAAC,MAAiB;IAC/B,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,MAAM,YAAY,CAAC,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACrD,IAAI,MAAM,YAAY,CAAC,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/query-schema/index.d.ts

@@ -0,0 +1,3 @@
+export { createQueryParametersSchema, type CreateQueryParametersSchemaOptions, } from './zod.js';
+export { fieldDescriptorsFromZod } from './field-descriptor-from-zod.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/query-schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query-schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,GACxC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/query-schema/index.js

@@ -0,0 +1,3 @@
+export { createQueryParametersSchema, } from './zod.js';
+export { fieldDescriptorsFromZod } from './field-descriptor-from-zod.js';
+//# sourceMappingURL=index.js.map

package/dist/query-schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query-schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,GAE5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/query-schema/zod.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import type { StandardListQuery } from '../query/list-query.type.js';
+export type CreateQueryParametersSchemaOptions<TExtra extends Record<string, unknown> = Record<string, never>> = {
+    readonly defaultPageSize?: number;
+    readonly maxPageSize?: number;
+    /**
+     * Strictness for client-supplied input that doesn't match the declared shape.
+     *
+     * - `false` (default) — tolerant. Unknown query keys are stripped; sort
+     *   entries pointing at unknown fields or bad directions are dropped;
+     *   non-positive / NaN page and pageSize values fall back to defaults.
+     *   Appropriate for HTTP boundaries where you'd rather serve a valid
+     *   response with sensible defaults than reject the request.
+     * - `true` — strict. Unknown query keys, unknown sort fields, bad sort
+     *   directions, and invalid page / pageSize values surface as Zod
+     *   validation errors (single `ZodError` with all issues). Appropriate
+     *   when the caller is trusted code (internal RPC, background jobs) or
+     *   when you want to surface client bugs loudly.
+     *
+     * `maxPageSize` is always enforced via clamping — strict mode does not
+     * reject oversized page requests (bounds enforcement ≠ validation; a
+     * client asking for more data than you're willing to serve isn't
+     * malformed input).
+     */
+    readonly strict?: boolean;
+    /**
+     * Extra top-level fields woven into the generated schema alongside
+     * `filters` / `sort` / `pagination`. Use this for fields that belong on
+     * the query envelope but aren't client-narrowable filters — typically
+     * auth-derived identifiers the server populates post-validation, like
+     * `scopeId` / `userId`. The keys:
+     *
+     * - Are declared at the top level of the generated schema (so strict
+     *   mode accepts them and doesn't reject as unknown).
+     * - Are **not** expanded by the suffix-operator DSL (no `scopeId__in`,
+     *   no `userId__contains` exposed to clients).
+     * - Pass through to the transform output at the top level — **not**
+     *   nested under `filters`.
+     *
+     * Declare them as optional: `z.object({ scopeId: z.string().optional() })`.
+     * The server (via `@ValidateRequest`'s auth-injection) populates them;
+     * the generator only reserves the names.
+     */
+    readonly extraFields?: z.ZodObject<z.ZodRawShape>;
+};
+/**
+ * Generates a Zod schema that parses and transforms HTTP query parameters
+ * into a `StandardListQuery<TFilters>`. The output filter object is the
+ * flat suffix-keyed dict expected by `SqlQueryBuilder.filters(...)`:
+ *
+ *   ?name__contains=foo&createdAt__gte=2026-01-01&sort=name:asc&page=2&pageSize=50
+ *
+ * becomes:
+ *
+ *   {
+ *     filters: { name__contains: 'foo', createdAt__gte: Date },
+ *     sort: [{ name: 'asc' }],
+ *     pagination: { page: 2, pageSize: 50 }
+ *   }
+ *
+ * Operators available per field kind:
+ * - string:  __contains, __in, __notIn, __isNull, __isNotNull
+ * - number:  __gt, __gte, __lt, __lte, __in, __notIn, __isNull, __isNotNull
+ * - date:    __gt, __gte, __lt, __lte, __in, __notIn, __isNull, __isNotNull
+ * - boolean: __isNull, __isNotNull
+ *
+ * Equality is the bare key (`name=Ada`). Invalid input is silently tolerated
+ * by default; opt into strict validation via `{ strict: true }`.
+ */
+export declare function createQueryParametersSchema<TFilters extends Record<string, unknown>, TExtra extends Record<string, unknown> = Record<string, never>>(filterShape: z.ZodObject<{
+    [K in keyof TFilters]: z.ZodType<TFilters[K]>;
+}>, options?: CreateQueryParametersSchemaOptions<TExtra>): z.ZodType<StandardListQuery<Partial<TFilters> & Record<string, unknown>> & Partial<TExtra>>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/query-schema/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/query-schema/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,MAAM,MAAM,kCAAkC,CAC5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC5D;IACF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE9D,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;KAAG,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,EAC3E,OAAO,GAAE,kCAAkC,CAAC,MAAM,CAAM,GACvD,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAgE7F"}

package/dist/query-schema/zod.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+import { FILTER_DELIMITER, OPERATORS_BY_KIND } from '../query/field-descriptor.type.js';
+import { fieldDescriptorsFromZod } from './field-descriptor-from-zod.js';
+const DEFAULT_PAGE = 1;
+const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Generates a Zod schema that parses and transforms HTTP query parameters
+ * into a `StandardListQuery<TFilters>`. The output filter object is the
+ * flat suffix-keyed dict expected by `SqlQueryBuilder.filters(...)`:
+ *
+ *   ?name__contains=foo&createdAt__gte=2026-01-01&sort=name:asc&page=2&pageSize=50
+ *
+ * becomes:
+ *
+ *   {
+ *     filters: { name__contains: 'foo', createdAt__gte: Date },
+ *     sort: [{ name: 'asc' }],
+ *     pagination: { page: 2, pageSize: 50 }
+ *   }
+ *
+ * Operators available per field kind:
+ * - string:  __contains, __in, __notIn, __isNull, __isNotNull
+ * - number:  __gt, __gte, __lt, __lte, __in, __notIn, __isNull, __isNotNull
+ * - date:    __gt, __gte, __lt, __lte, __in, __notIn, __isNull, __isNotNull
+ * - boolean: __isNull, __isNotNull
+ *
+ * Equality is the bare key (`name=Ada`). Invalid input is silently tolerated
+ * by default; opt into strict validation via `{ strict: true }`.
+ */
+export function createQueryParametersSchema(filterShape, options = {}) {
+    const defaultPageSize = options.defaultPageSize ?? DEFAULT_PAGE_SIZE;
+    const maxPageSize = options.maxPageSize ?? 200;
+    const strict = options.strict ?? false;
+    const descriptors = fieldDescriptorsFromZod(filterShape);
+    const rawShape = {
+        page: z.string().optional(),
+        pageSize: z.string().optional(),
+        sort: z.union([z.string(), z.array(z.string())]).optional(),
+    };
+    const sortableKeys = [];
+    for (const [key, descriptor] of Object.entries(descriptors)) {
+        const base = filterShape.shape[key];
+        if (!base)
+            continue;
+        rawShape[key] = base instanceof z.ZodOptional ? base : base.optional();
+        sortableKeys.push(key);
+        for (const op of OPERATORS_BY_KIND[descriptor.kind]) {
+            const opKey = `${key}${FILTER_DELIMITER}${op}`;
+            rawShape[opKey] = schemaForOperator(descriptor.kind, op);
+        }
+    }
+    const extraShape = options.extraFields?.shape ?? {};
+    const extraKeys = new Set(Object.keys(extraShape));
+    for (const [key, schema] of Object.entries(extraShape)) {
+        if (key in rawShape) {
+            throw new Error(`createQueryParametersSchema: extraFields key "${key}" collides with a reserved name (page, pageSize, sort) or a filter field already declared in the filter shape.`);
+        }
+        rawShape[key] = schema instanceof z.ZodOptional ? schema : schema.optional();
+    }
+    const rawSchema = strict ? z.object(rawShape).strict() : z.object(rawShape).strip();
+    return rawSchema.transform((raw, ctx) => {
+        const filters = {};
+        const extras = {};
+        for (const [key, value] of Object.entries(raw)) {
+            if (value === undefined)
+                continue;
+            if (key === 'page' || key === 'pageSize' || key === 'sort')
+                continue;
+            if (extraKeys.has(key)) {
+                extras[key] = value;
+            }
+            else {
+                filters[key] = value;
+            }
+        }
+        const pagination = parsePagination(raw, defaultPageSize, maxPageSize, strict, ctx);
+        const sort = parseSort(raw.sort, sortableKeys, strict, ctx);
+        return {
+            ...extras,
+            filters,
+            ...(sort.length > 0 ? { sort } : {}),
+            ...(pagination ? { pagination } : {}),
+        };
+    });
+}
+function schemaForOperator(kind, operator) {
+    if (operator === 'isNull' || operator === 'isNotNull') {
+        return z
+            .preprocess((v) => (v === 'true' ? true : v === 'false' ? false : v), z.boolean())
+            .optional();
+    }
+    if (operator === 'in' || operator === 'notIn') {
+        const elementSchema = elementSchemaFor(kind);
+        return z.preprocess((v) => toStringArray(v), z.array(elementSchema)).optional();
+    }
+    if (operator === 'contains') {
+        return z.string().optional();
+    }
+    // gt / gte / lt / lte — scalar of the field's kind
+    return scalarSchemaFor(kind).optional();
+}
+function scalarSchemaFor(kind) {
+    switch (kind) {
+        case 'number':
+            return z.coerce.number();
+        case 'date':
+            return z.coerce.date();
+        case 'boolean':
+            return z.coerce.boolean();
+        default:
+            return z.string();
+    }
+}
+function elementSchemaFor(kind) {
+    return scalarSchemaFor(kind);
+}
+function toStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.flatMap((v) => (typeof v === 'string' ? v.split(',') : []));
+    }
+    if (typeof value === 'string') {
+        return value.split(',');
+    }
+    return [];
+}
+function parsePagination(raw, defaultPageSize, maxPageSize, strict, ctx) {
+    const hasPage = raw.page !== undefined;
+    const hasPageSize = raw.pageSize !== undefined;
+    if (!hasPage && !hasPageSize)
+        return null;
+    const parsedPage = hasPage ? Number.parseInt(String(raw.page), 10) : DEFAULT_PAGE;
+    const parsedSize = hasPageSize ? Number.parseInt(String(raw.pageSize), 10) : defaultPageSize;
+    const pageValid = Number.isFinite(parsedPage) && parsedPage > 0;
+    const sizeValid = Number.isFinite(parsedSize) && parsedSize > 0;
+    if (strict && hasPage && !pageValid) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `Invalid page "${String(raw.page)}"; expected a positive integer`,
+            path: ['page'],
+        });
+    }
+    if (strict && hasPageSize && !sizeValid) {
+        ctx.addIssue({
+            code: 'custom',
+            message: `Invalid pageSize "${String(raw.pageSize)}"; expected a positive integer`,
+            path: ['pageSize'],
+        });
+    }
+    const page = pageValid ? parsedPage : DEFAULT_PAGE;
+    const pageSize = sizeValid ? Math.min(parsedSize, maxPageSize) : defaultPageSize;
+    return { page, pageSize };
+}
+function parseSort(value, sortableKeys, strict, ctx) {
+    if (value === undefined)
+        return [];
+    const entries = Array.isArray(value)
+        ? value.filter((v) => typeof v === 'string')
+        : typeof value === 'string'
+            ? [value]
+            : [];
+    const allowed = new Set(sortableKeys);
+    const deduped = new Set(entries.map((e) => e.trim()));
+    const result = [];
+    for (const entry of deduped) {
+        const [field, direction] = entry.split(':');
+        if (!field || !allowed.has(field)) {
+            if (strict) {
+                ctx.addIssue({
+                    code: 'custom',
+                    message: `Unknown sort field "${field ?? ''}"; allowed: ${sortableKeys.join(', ')}`,
+                    path: ['sort'],
+                });
+            }
+            continue;
+        }
+        const dir = direction?.toLowerCase();
+        if (dir !== 'asc' && dir !== 'desc') {
+            if (strict) {
+                ctx.addIssue({
+                    code: 'custom',
+                    message: `Invalid sort direction "${direction ?? ''}" for field "${field}"; expected "asc" or "desc"`,
+                    path: ['sort'],
+                });
+            }
+            continue;
+        }
+        result.push({ [field]: dir });
+    }
+    return result;
+}
+//# sourceMappingURL=zod.js.map

package/dist/query-schema/zod.js.map

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

package/dist/repository/base-aggregate.repository.d.ts

@@ -0,0 +1,28 @@
+import type { AggregateRoot } from '@quilla-be-kit/ddd';
+import type { BaseWriteDao } from '../dao/base-write.dao.js';
+import type { UnitOfWorkContext } from '../unit-of-work/unit-of-work-context.type.js';
+import type { PersistenceMapper } from './mapper.interface.js';
+/**
+ * Base repository for aggregates. Handles persistence through a mapper and
+ * registers aggregates in the `UnitOfWorkContext` so the UoW can drain
+ * their domain events into the outbox at commit.
+ *
+ * Verb: `loadById` / `loadForUpdate...` — returns `TAggregate` (DDD
+ * language). Persistence I/O delegates to `BaseWriteDao`'s `find*` methods.
+ */
+export declare abstract class BaseAggregateRepository<TAggregate extends AggregateRoot<object> & {
+    id: string;
+}, TRow extends {
+    id: string;
+}> {
+    protected readonly mapper: PersistenceMapper<TAggregate, TRow>;
+    protected readonly writeDao: BaseWriteDao<TRow>;
+    constructor(mapper: PersistenceMapper<TAggregate, TRow>, writeDao: BaseWriteDao<TRow>);
+    create(aggregate: TAggregate, ctx: UnitOfWorkContext): Promise<void>;
+    createMany(aggregates: readonly TAggregate[], ctx: UnitOfWorkContext): Promise<void>;
+    update(aggregate: TAggregate, ctx: UnitOfWorkContext): Promise<void>;
+    updateMany(aggregates: readonly TAggregate[], ctx: UnitOfWorkContext): Promise<void>;
+    delete(aggregate: TAggregate, ctx: UnitOfWorkContext): Promise<void>;
+    deleteMany(aggregates: readonly TAggregate[], ctx: UnitOfWorkContext): Promise<void>;
+}
+//# sourceMappingURL=base-aggregate.repository.d.ts.map

package/dist/repository/base-aggregate.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-aggregate.repository.d.ts","sourceRoot":"","sources":["../../src/repository/base-aggregate.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;;;;;GAOG;AACH,8BAAsB,uBAAuB,CAC3C,UAAU,SAAS,aAAa,CAAC,MAAM,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACzD,IAAI,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAGzB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC;gBAD5B,MAAM,EAAE,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,EAC3C,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC;IAG3C,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,UAAU,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,UAAU,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE,UAAU,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ3F"}

package/dist/repository/base-aggregate.repository.js

@@ -0,0 +1,49 @@
+/**
+ * Base repository for aggregates. Handles persistence through a mapper and
+ * registers aggregates in the `UnitOfWorkContext` so the UoW can drain
+ * their domain events into the outbox at commit.
+ *
+ * Verb: `loadById` / `loadForUpdate...` — returns `TAggregate` (DDD
+ * language). Persistence I/O delegates to `BaseWriteDao`'s `find*` methods.
+ */
+export class BaseAggregateRepository {
+    mapper;
+    writeDao;
+    constructor(mapper, writeDao) {
+        this.mapper = mapper;
+        this.writeDao = writeDao;
+    }
+    async create(aggregate, ctx) {
+        await this.writeDao.create(this.mapper.toPersistence(aggregate), ctx.trx);
+        ctx.registerAggregate(aggregate);
+    }
+    async createMany(aggregates, ctx) {
+        if (aggregates.length === 0)
+            return;
+        const rows = aggregates.map((a) => this.mapper.toPersistence(a));
+        await this.writeDao.createMany(rows, ctx.trx);
+        ctx.registerAggregate(...aggregates);
+    }
+    async update(aggregate, ctx) {
+        await this.writeDao.update(this.mapper.toPersistence(aggregate), ctx.trx);
+        // Aggregate already registered in ctx via loadForUpdate*.
+    }
+    async updateMany(aggregates, ctx) {
+        if (aggregates.length === 0)
+            return;
+        const rows = aggregates.map((a) => this.mapper.toPersistence(a));
+        await this.writeDao.updateMany(rows, ctx.trx);
+        // Aggregates already registered in ctx via loadForUpdate*.
+    }
+    async delete(aggregate, ctx) {
+        await this.writeDao.delete(aggregate.id, ctx.trx);
+        // Aggregate already registered in ctx via loadForUpdate*.
+    }
+    async deleteMany(aggregates, ctx) {
+        if (aggregates.length === 0)
+            return;
+        await this.writeDao.deleteMany(aggregates.map((a) => a.id), ctx.trx);
+        // Aggregates already registered in ctx via loadForUpdate*.
+    }
+}
+//# sourceMappingURL=base-aggregate.repository.js.map

package/dist/repository/base-aggregate.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-aggregate.repository.js","sourceRoot":"","sources":["../../src/repository/base-aggregate.repository.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,MAAM,OAAgB,uBAAuB;IAKtB;IACA;IAFrB,YACqB,MAA2C,EAC3C,QAA4B;QAD5B,WAAM,GAAN,MAAM,CAAqC;QAC3C,aAAQ,GAAR,QAAQ,CAAoB;IAC9C,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,SAAqB,EAAE,GAAsB;QACxD,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1E,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAiC,EAAE,GAAsB;QACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,GAAG,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAqB,EAAE,GAAsB;QACxD,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CACxB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAiC,EACpE,GAAG,CAAC,GAAG,CACR,CAAC;QACF,0DAA0D;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAiC,EAAE,GAAsB;QACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,2DAA2D;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAqB,EAAE,GAAsB;QACxD,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAClD,0DAA0D;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAiC,EAAE,GAAsB;QACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAC5B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC3B,GAAG,CAAC,GAAG,CACR,CAAC;QACF,2DAA2D;IAC7D,CAAC;CACF"}

package/dist/repository/base-basic.repository.d.ts

@@ -0,0 +1,22 @@
+import type { BaseWriteDao } from '../dao/base-write.dao.js';
+import type { DatabaseTransaction } from '../database/database-transaction.interface.js';
+/**
+ * Repository for non-aggregate entities (no domain events, no aggregate
+ * registration). Use for simple persistence shapes without DDD tactical
+ * pattern requirements.
+ */
+export declare abstract class BaseBasicRepository<TRow extends {
+    id: string;
+}> {
+    protected readonly writeDao: BaseWriteDao<TRow>;
+    constructor(writeDao: BaseWriteDao<TRow>);
+    create(row: TRow, trx?: DatabaseTransaction): Promise<void>;
+    createMany(rows: readonly TRow[], trx?: DatabaseTransaction): Promise<void>;
+    update(row: TRow & {
+        updated_at?: Date;
+    }, trx?: DatabaseTransaction): Promise<void>;
+    updateMany(rows: readonly TRow[], trx: DatabaseTransaction): Promise<void>;
+    delete(id: string, trx?: DatabaseTransaction): Promise<void>;
+    deleteMany(ids: readonly string[], trx?: DatabaseTransaction): Promise<void>;
+}
+//# sourceMappingURL=base-basic.repository.d.ts.map