fastify-auto-sqlapi 0.0.4 → 0.1.1

package/dist/types/db.d.ts

@@ -0,0 +1,22 @@
+import type { Expression } from 'node-condition-builder';
+export interface SqlResult<T = Record<string, unknown>> {
+    rows: T[];
+    affectedRows: number;
+    insertId?: number;
+}
+export interface Queryable {
+    query<T = Record<string, unknown>>(text: string, values?: unknown[]): Promise<SqlResult<T>>;
+}
+export type DbRecordValue = string | number | boolean | null | Expression;
+export type DbRecord = Record<string, DbRecordValue>;
+export interface SelectOptions {
+    tableName: string;
+    columns?: string;
+    where: string;
+    values: unknown[];
+    limit?: string | null;
+    orderBy?: string;
+    joins?: string[];
+    distinct?: boolean;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/types/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/types/db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,CAAC;AAEf,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/db.js

@@ -0,0 +1 @@
+export {};

package/dist/types/dml.d.ts

@@ -0,0 +1,64 @@
+import type { FastifyRequest } from 'fastify';
+import type { QueryClient } from '../lib/db.js';
+import type { ITable, DbTables } from './table.js';
+import type { TenantContext } from './tenant.js';
+interface DmlBaseParams {
+    db: QueryClient;
+    tableConf: ITable;
+    tenant?: TenantContext;
+}
+interface DmlWriteBaseParams extends DmlBaseParams {
+    dbTables: DbTables;
+    request: FastifyRequest;
+}
+export interface InsertParams extends DmlWriteBaseParams {
+    record: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+}
+export interface InsertResult {
+    main: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+}
+export interface UpdateParams extends DmlWriteBaseParams {
+    record: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+    deletions?: Record<string, Record<string, unknown>[]>;
+}
+export interface UpdateResult {
+    main: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+    deletions?: Record<string, Record<string, unknown>[]>;
+}
+export interface GetParams extends DmlBaseParams {
+    id: string | number;
+}
+export interface GetResult {
+    main: Record<string, unknown>;
+}
+export interface DeleteParams extends DmlBaseParams {
+    id: string | number;
+}
+export interface DeleteResult {
+    main: Record<string, unknown>;
+}
+export interface BulkUpsertItem {
+    main: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+    deletions?: Record<string, Record<string, unknown>[]>;
+}
+export interface BulkUpsertParams extends DmlWriteBaseParams {
+    items: BulkUpsertItem[];
+}
+export interface BulkUpsertResult {
+    main: Record<string, unknown>;
+    secondaries?: Record<string, Record<string, unknown>[]>;
+    deletions?: Record<string, Record<string, unknown>[]>;
+}
+export interface BulkDeleteParams extends DmlBaseParams {
+    ids: (string | number)[];
+}
+export interface BulkDeleteResult {
+    main: Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=dml.d.ts.map

package/dist/types/dml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dml.d.ts","sourceRoot":"","sources":["../../src/types/dml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,UAAU,aAAa;IACrB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,UAAU,kBAAmB,SAAQ,aAAa;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAID,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACzD;AAID,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACvD;AAID,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAID,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACvD;AAID,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,GAAG,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}

package/dist/types/dml.js

@@ -0,0 +1 @@
+export {};

package/dist/types/join.d.ts

@@ -0,0 +1,44 @@
+import type { SchemaDefinition } from './schema.js';
+import type { FilterRecord } from './table.js';
+import type { SearchCondition } from './conditions.js';
+export interface JoinDefinition {
+    joinSchema: SchemaDefinition;
+    joinField: string;
+    mainField: string | string[];
+    alias: string;
+    selection: string;
+    unique: boolean;
+}
+export interface AggregationRequest {
+    /**
+     * GROUP BY field. Either a schema field name on the join table or a
+     * computed-field name declared on the join table's `computedFields`.
+     */
+    by?: string;
+    distinctCount?: string[];
+    min?: string[];
+    max?: string[];
+    sum?: string[];
+    avg?: string[];
+    count?: string[];
+}
+export interface JoinGroupRequest {
+    aggregations: AggregationRequest;
+    filters?: FilterRecord;
+    conditions?: SearchCondition[];
+}
+/**
+ * Reference filter for join-based existential filtering (joinMustExist),
+ * virtual joins data fetching (joinMultiple), and parent inline (joinLeft).
+ * Combines equality-based filters with rich ConditionBuilder-powered conditions,
+ * both applied to the join schema.
+ */
+export interface JoinRefFilter {
+    filters?: FilterRecord;
+    conditions?: SearchCondition[];
+}
+/** Per-request override of the per-relation default selection. */
+export interface JoinFetchRequest extends JoinRefFilter {
+    selection?: string;
+}
+//# sourceMappingURL=join.d.ts.map

package/dist/types/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/types/join.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/join.js

@@ -0,0 +1 @@
+export {};

package/dist/types/plugin.d.ts

@@ -0,0 +1,20 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { DialectName } from '../lib/dialect.js';
+import type { DbTables } from './table.js';
+import type { TenantId } from './tenant.js';
+export interface SwaggerOptions {
+    title?: string;
+    description?: string;
+    version?: string;
+    routePrefix?: string;
+}
+export interface SqlApiPluginOptions {
+    DbTables: DbTables;
+    onRequests?: ((request: FastifyRequest, reply: FastifyReply) => Promise<void | FastifyReply>)[];
+    prefix?: string;
+    swagger?: boolean | SwaggerOptions;
+    dialect?: DialectName;
+    getTenantId?: (request: FastifyRequest) => TenantId | TenantId[] | null | undefined | Promise<TenantId | TenantId[] | null | undefined>;
+    debug?: boolean;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACnC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,GAC/E,OAAO,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/plugin.js

@@ -0,0 +1 @@
+export {};

package/dist/types/schema.d.ts

@@ -0,0 +1,10 @@
+import type { TSchema, TObject } from '@sinclair/typebox';
+export interface SchemaDefinition<T = Record<string, TSchema>> {
+    col(field: string): string;
+    colMap?: Record<string, string>;
+    fields: T;
+    validation: TObject;
+    tableName: string;
+    partialValidation: TObject;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B"}

package/dist/types/schema.js

@@ -0,0 +1 @@
+export {};

package/dist/types/search.d.ts

@@ -0,0 +1,45 @@
+import type { QueryClient } from '../lib/db.js';
+import type { ITable, FilterRecord } from './table.js';
+import type { TenantContext } from './tenant.js';
+import type { JoinFetchRequest, JoinGroupRequest, JoinRefFilter } from './join.js';
+import type { SearchCondition } from './conditions.js';
+export interface Paginator {
+    page: number;
+    itemsPerPage: number;
+}
+export interface SearchParams {
+    db: QueryClient;
+    tableConf: ITable;
+    filters?: FilterRecord;
+    conditions?: SearchCondition[];
+    joinMustExist?: Record<string, JoinRefFilter>;
+    joinMultiple?: Record<string, JoinFetchRequest>;
+    joinGroup?: Record<string, JoinGroupRequest>;
+    joinLeft?: Record<string, JoinFetchRequest>;
+    orderBy?: string;
+    paginator?: Paginator;
+    computeMin?: string;
+    computeMax?: string;
+    computeSum?: string;
+    computeAvg?: string;
+    /**
+     * Names of computed fields (declared on `tableConf.computedFields`) to project
+     * into the main response. Each becomes an extra column on each `main[i]` row.
+     */
+    selectComputed?: string[];
+    tenant?: TenantContext;
+}
+export interface PaginationResult {
+    total: number;
+    pages: number;
+    computed?: Record<string, Record<string, unknown>>;
+    paginator: Paginator;
+}
+export interface SearchResult {
+    main: Record<string, unknown>[];
+    joinMultiple?: Record<string, Record<string, unknown>[]>;
+    joinLeft?: Record<string, Record<string, unknown>[]>;
+    joinGroup?: Record<string, Record<string, unknown>>;
+    pagination?: PaginationResult;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/types/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/types/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B"}

package/dist/types/search.js

@@ -0,0 +1 @@
+export {};

package/dist/types/table.d.ts

@@ -0,0 +1,52 @@
+import type { Expression, ConditionBuilder, ConditionValueOrUndefined } from 'node-condition-builder';
+import type { TSchema, Static } from '@sinclair/typebox';
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import type { QueryClient } from '../lib/db.js';
+import type { SchemaDefinition } from './schema.js';
+import type { ComputedFieldFn } from './computed.js';
+import type { JoinDefinition } from './join.js';
+import type { TenantScope } from './tenant.js';
+import type { ValidatorFn, BulkValidatorFn } from './validation.js';
+export type FilterRecord = Record<string, ConditionValueOrUndefined>;
+export type ExtendedConditionFn = (condition: ConditionBuilder, filters: FilterRecord) => void;
+export type TableFilterFn = (filters: FilterRecord) => ConditionBuilder;
+export interface ITable<F extends Record<string, TSchema> = Record<string, TSchema>> {
+    primary: (string & keyof F) | (string & keyof F)[];
+    Schema: SchemaDefinition<F>;
+    filters: TableFilterFn;
+    extraFilters: Record<string, TSchema>;
+    /**
+     * Virtual fields produced by a SQL expression. Usable like schema fields in
+     * `filters`, `conditions` (non-dotted), `orderBy` (1-parte),
+     * `computeMin/Max/Sum/Avg`, and (opt-in) in `selectComputed` for the main
+     * response. Each entry MUST declare `type` for Swagger and validation.
+     *
+     * Naming clashes with `Schema.fields` or `extraFilters` keys throw at
+     * `defineTable` time.
+     */
+    computedFields?: Record<string, ComputedFieldFn>;
+    allowedReadJoins?: JoinDefinition[];
+    allowedWriteJoins?: JoinDefinition[];
+    upsertMap?: Map<SchemaDefinition, string[]>;
+    schemaOverrides?: Partial<Record<string & keyof F, TSchema>>;
+    validate?: ValidatorFn<F>;
+    validateBulk?: BulkValidatorFn<F>;
+    beforeInsert?: (db: QueryClient, req: FastifyRequest, record: {
+        [K in keyof F]?: Static<F[K]> | Expression | null;
+    }) => Promise<void>;
+    beforeUpdate?: (db: QueryClient, req: FastifyRequest, fields: {
+        [K in keyof F]?: Static<F[K]> | Expression | null;
+    }, secondaryFieldsFetcher?: unknown) => void | Promise<void>;
+    afterInsert?: (db: QueryClient, req: FastifyRequest, record: {
+        [K in keyof F]?: Static<F[K]>;
+    }, secondaryRecords?: unknown) => Promise<void>;
+    defaultOrder?: string;
+    excludeFromCreation?: (string & keyof F)[];
+    distinctResults?: boolean;
+    onRequests?: ((request: FastifyRequest, reply: FastifyReply) => Promise<void | FastifyReply>)[];
+    tenantScope?: TenantScope;
+}
+export type DbTables = Record<string, ITable<any>>;
+export declare function primaryAsString(pk: string | string[]): string;
+export declare function primaryAsCols(pk: string | string[], colFn: (f: string) => string): string | string[];
+//# sourceMappingURL=table.d.ts.map

package/dist/types/table.d.ts.map

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

package/dist/types/table.js

@@ -0,0 +1,7 @@
+// Primary key helpers
+export function primaryAsString(pk) {
+    return Array.isArray(pk) ? pk[0] : pk;
+}
+export function primaryAsCols(pk, colFn) {
+    return Array.isArray(pk) ? pk.map(colFn) : colFn(pk);
+}

package/dist/types/tenant.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaDefinition } from './schema.js';
+export type TenantId = string | number;
+export interface TenantScopeDirect {
+    column: string;
+}
+export interface TenantScopeIndirect {
+    column: string;
+    through: {
+        schema: SchemaDefinition;
+        localField: string;
+        foreignField: string;
+    };
+}
+export type TenantScope = TenantScopeDirect | TenantScopeIndirect;
+export interface TenantContext {
+    ids: TenantId[];
+    scope: TenantScope;
+}
+//# sourceMappingURL=tenant.d.ts.map

package/dist/types/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../../src/types/tenant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QACP,MAAM,EAAE,gBAAgB,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/types/tenant.js

@@ -0,0 +1 @@
+export {};

package/dist/types/validation.d.ts

@@ -0,0 +1,21 @@
+import type { TSchema, Static } from '@sinclair/typebox';
+import type { FastifyRequest } from 'fastify';
+import type { QueryClient } from '../lib/db.js';
+/**
+ * Validation error tuple: [field, code] or [field, code, message].
+ * - field: the field path (e.g. 'name', 'session_period[1].startDate')
+ * - code: machine-readable error code (e.g. 'required', 'overlap', 'unique')
+ * - message: human-readable description (defaults to code if omitted)
+ */
+export type ValidationError = [field: string, code: string] | [field: string, code: string, message: string];
+export type ValidatorFn<F extends Record<string, TSchema> = Record<string, TSchema>> = (db: QueryClient, req: FastifyRequest, main: {
+    [K in keyof F]?: Static<F[K]>;
+}, secondaries?: Record<string, Record<string, unknown>[]>) => Promise<ValidationError[]> | ValidationError[];
+export interface BulkValidatorItem<F extends Record<string, TSchema> = Record<string, TSchema>> {
+    main: {
+        [K in keyof F]?: Static<F[K]>;
+    };
+    secondaries?: Record<string, Record<string, unknown>[]>;
+}
+export type BulkValidatorFn<F extends Record<string, TSchema> = Record<string, TSchema>> = (db: QueryClient, req: FastifyRequest, items: BulkValidatorItem<F>[]) => Promise<ValidationError[]> | ValidationError[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAC7B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAEnD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACrF,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,EACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KACpD,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC;AAEpD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5F,IAAI,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACzF,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,KAC1B,OAAO,CAAC,eAAe,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC"}

package/dist/types/validation.js

@@ -0,0 +1 @@
+export {};