pipework 0.7.12 → 0.7.13

package/dist/data/domain/project-schema.js

@@ -0,0 +1,123 @@
+import { z } from 'zod/v4';
+export function projectInsertShape(fields) {
+    const shape = {};
+    for (const [key, descriptor] of Object.entries(fields)) {
+        const meta = descriptor._meta;
+        if (meta.primaryKey && (meta.defaultRandom || meta.kind === 'serial'))
+            continue;
+        if (meta.autoManaged)
+            continue;
+        let validator = buildValidator(meta);
+        if (meta.nullable || meta.hasDefault) {
+            validator = validator.optional();
+        }
+        shape[key] = validator;
+    }
+    return z.object(shape);
+}
+export function projectSelectShape(fields) {
+    const shape = {};
+    for (const [key, descriptor] of Object.entries(fields)) {
+        const meta = descriptor._meta;
+        let validator = buildValidator(meta);
+        if (meta.nullable) {
+            validator = validator.nullable();
+        }
+        shape[key] = validator;
+    }
+    return z.object(shape);
+}
+export function projectUpdateShape(fields) {
+    const shape = {};
+    for (const [key, descriptor] of Object.entries(fields)) {
+        const meta = descriptor._meta;
+        if (meta.primaryKey)
+            continue;
+        if (meta.readOnly)
+            continue;
+        if (meta.autoManaged)
+            continue;
+        let validator = buildValidator(meta);
+        if (meta.nullable) {
+            validator = validator.nullable();
+        }
+        shape[key] = validator.optional();
+    }
+    return z.object(shape);
+}
+function buildValidator(meta) {
+    switch (meta.kind) {
+        case 'uuid': {
+            let v = z.string().uuid();
+            if (meta.brand !== undefined) {
+                v = v.brand(meta.brand);
+            }
+            return v;
+        }
+        case 'text': {
+            let v = z.string();
+            if (meta.min !== undefined)
+                v = v.min(meta.min);
+            if (meta.max !== undefined)
+                v = v.max(meta.max);
+            if (meta.email)
+                v = v.email();
+            if (meta.url)
+                v = v.url();
+            if (meta.regex !== undefined)
+                v = v.regex(meta.regex);
+            if (meta.brand !== undefined)
+                v = v.brand(meta.brand);
+            return v;
+        }
+        case 'integer':
+        case 'serial': {
+            let v = z.number().int();
+            if (meta.min !== undefined)
+                v = v.min(meta.min);
+            if (meta.max !== undefined)
+                v = v.max(meta.max);
+            if (meta.brand !== undefined)
+                v = v.brand(meta.brand);
+            return v;
+        }
+        case 'bigint': {
+            if (meta.serializedAs === 'string') {
+                let v = z.string();
+                if (meta.brand !== undefined)
+                    v = v.brand(meta.brand);
+                return v;
+            }
+            let v = z.bigint();
+            if (meta.min !== undefined)
+                v = v.min(BigInt(meta.min));
+            if (meta.max !== undefined)
+                v = v.max(BigInt(meta.max));
+            if (meta.brand !== undefined)
+                v = v.brand(meta.brand);
+            return v;
+        }
+        case 'boolean':
+            return z.boolean();
+        case 'timestamp':
+            return z.union([z.string().datetime(), z.date()]);
+        case 'enum':
+            if (!meta.enumValues || meta.enumValues.length === 0) {
+                throw new Error('[pipework] enum field requires at least one value');
+            }
+            return z.enum(meta.enumValues);
+        case 'jsonb':
+            return meta.jsonbShape ?? z.unknown();
+        case 'decimal': {
+            let v = z.string();
+            if (meta.brand !== undefined)
+                v = v.brand(meta.brand);
+            return v;
+        }
+        case 'custom':
+            return meta.customValidator ?? z.unknown();
+        default:
+            throw new Error(`[pipework] Unknown field kind: ${meta.kind}`);
+    }
+}
+//# sourceMappingURL=project-schema.js.map

package/dist/data/domain/project-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-schema.js","sourceRoot":"","sources":["../../../src/data/domain/project-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAG1B,MAAM,UAAU,kBAAkB,CAAC,MAAuC;IACxE,MAAM,KAAK,GAA8B,EAAE,CAAA;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAA;QAE7B,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;YAAE,SAAQ;QAC/E,IAAI,IAAI,CAAC,WAAW;YAAE,SAAQ;QAE9B,IAAI,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrC,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;IACxB,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAuC;IACxE,MAAM,KAAK,GAA8B,EAAE,CAAA;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAA;QAC7B,IAAI,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;IACxB,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAuC;IACxE,MAAM,KAAK,GAA8B,EAAE,CAAA;IAE3C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAA;QAE7B,IAAI,IAAI,CAAC,UAAU;YAAE,SAAQ;QAC7B,IAAI,IAAI,CAAC,QAAQ;YAAE,SAAQ;QAC3B,IAAI,IAAI,CAAC,WAAW;YAAE,SAAQ;QAE9B,IAAI,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAEpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;QAClC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;IACnC,CAAC;IAED,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,cAAc,CAAC,IAAe;IACrC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAA;YACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,CAAC;YACD,OAAO,CAAC,CAAA;QACV,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAA;YAC7B,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChE,IAAI,IAAI,CAAC,KAAK;gBAAE,CAAC,GAAI,CAAiB,CAAC,KAAK,EAAE,CAAA;YAC9C,IAAI,IAAI,CAAC,GAAG;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,EAAE,CAAA;YAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrD,OAAO,CAAC,CAAA;QACV,CAAC;QAED,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAA;YACnC,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrD,OAAO,CAAC,CAAA;QACV,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAA;gBAC7B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;oBAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACrD,OAAO,CAAC,CAAA;YACV,CAAC;YACD,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAA;YAC7B,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YACxE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;gBAAE,CAAC,GAAI,CAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YACxE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrD,OAAO,CAAC,CAAA;QACV,CAAC;QAED,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;QAEpB,KAAK,WAAW;YACd,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAEnD,KAAK,MAAM;YACT,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;YACtE,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAA8C,CAAC,CAAA;QAEpE,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;QAEvC,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,GAAc,CAAC,CAAC,MAAM,EAAE,CAAA;YAC7B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrD,OAAO,CAAC,CAAA;QACV,CAAC;QAED,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;QAE5C;YACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,IAAc,EAAE,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC"}

package/dist/data/domain/project-table.d.ts

@@ -0,0 +1,30 @@
+import type { FieldDescriptor, DefineOptions } from './types.js';
+export declare function projectTable(tableName: string, fields: Record<string, FieldDescriptor>, options: DefineOptions): import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: string;
+    schema: undefined;
+    columns: {
+        [x: string]: import("drizzle-orm/pg-core").PgColumn<{
+            name: any;
+            tableName: string;
+            dataType: any;
+            columnType: any;
+            data: any;
+            driverParam: any;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: any;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            [x: string]: any;
+            [x: number]: any;
+            [x: symbol]: any;
+        }>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=project-table.d.ts.map

package/dist/data/domain/project-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-table.d.ts","sourceRoot":"","sources":["../../../src/data/domain/project-table.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAa,aAAa,EAAE,MAAM,YAAY,CAAA;AAG3E,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEvB"}

package/dist/data/domain/project-table.js

@@ -0,0 +1,125 @@
+import { pgTable, text, uuid, integer, serial, bigint as pgBigint, boolean, timestamp, jsonb, numeric, check, } from 'drizzle-orm/pg-core';
+import { sql } from 'drizzle-orm';
+import { camelToSnake } from './naming.js';
+export function projectTable(tableName, fields, options) {
+    if (options.virtual === true) {
+        throw new Error(`[pipework] "${tableName}" is a virtual definition — no database table.\n\n` +
+            '  Virtual definitions have no .table() projection.\n' +
+            '  Remove { virtual: true } if this definition needs a database table.\n');
+    }
+    /* eslint-disable @typescript-eslint/no-explicit-any -- Drizzle pgTable callback requires untyped column builders */
+    const columns = {};
+    const extraConfig = [];
+    for (const [key, descriptor] of Object.entries(fields)) {
+        const meta = descriptor._meta;
+        const colName = camelToSnake(key);
+        let col = buildColumn(colName, meta);
+        if (!meta.nullable) {
+            col = col.notNull();
+        }
+        if (meta.primaryKey) {
+            col = col.primaryKey();
+        }
+        if (meta.unique) {
+            col = col.unique();
+        }
+        if (meta.defaultRandom && meta.kind === 'uuid') {
+            col = col.defaultRandom();
+        }
+        else if (meta.hasDefault && meta.defaultValue === 'now' && meta.kind === 'timestamp') {
+            col = col.defaultNow();
+        }
+        else if (meta.hasDefault && meta.defaultValue !== undefined) {
+            col = col.default(meta.defaultValue);
+        }
+        if (meta.reference !== undefined) {
+            const refTable = meta.reference.definition.table();
+            const refColName = camelToSnake(meta.reference.field);
+            col = col.references(() => refTable[refColName]);
+        }
+        columns[key] = col;
+        buildChecks(colName, meta, extraConfig);
+    }
+    if (options.indexes !== undefined) {
+        const indexFn = options.indexes;
+        return pgTable(tableName, columns, (table) => {
+            const all = [...extraConfig];
+            const indexes = indexFn(table);
+            for (const [, idx] of Object.entries(indexes)) {
+                all.push(idx);
+            }
+            return all;
+        });
+    }
+    if (extraConfig.length > 0) {
+        return pgTable(tableName, columns, () => extraConfig);
+    }
+    return pgTable(tableName, columns);
+    /* eslint-enable @typescript-eslint/no-explicit-any */
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle column builders have deeply generic types
+function buildColumn(colName, meta) {
+    switch (meta.kind) {
+        case 'uuid':
+            return uuid(colName);
+        case 'text':
+            return text(colName);
+        case 'integer':
+            return integer(colName);
+        case 'serial':
+            return serial(colName);
+        case 'bigint':
+            return pgBigint(colName, { mode: 'bigint' });
+        case 'boolean':
+            return boolean(colName);
+        case 'timestamp':
+            return timestamp(colName, { withTimezone: true });
+        case 'enum':
+            return text(colName);
+        case 'jsonb':
+            return jsonb(colName);
+        case 'decimal':
+            if (meta.precision !== undefined) {
+                return numeric(colName, { precision: meta.precision.p, scale: meta.precision.s });
+            }
+            return numeric(colName);
+        case 'custom':
+            return meta.customColumn;
+        default:
+            throw new Error(`[pipework] Unknown field kind: ${meta.kind}`);
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Drizzle check constraint types
+function buildChecks(colName, meta, checks) {
+    if (meta.kind === 'custom')
+        return;
+    const isNumeric = meta.kind === 'integer' || meta.kind === 'serial' || meta.kind === 'bigint' || meta.kind === 'decimal';
+    const isText = meta.kind === 'text';
+    if (isNumeric) {
+        if (meta.min !== undefined && meta.max !== undefined) {
+            checks.push(check(`${colName}_range`, sql `${sql.raw(colName)} >= ${sql.raw(String(meta.min))} AND ${sql.raw(colName)} <= ${sql.raw(String(meta.max))}`));
+        }
+        else if (meta.min !== undefined) {
+            checks.push(check(`${colName}_min`, sql `${sql.raw(colName)} >= ${sql.raw(String(meta.min))}`));
+        }
+        else if (meta.max !== undefined) {
+            checks.push(check(`${colName}_max`, sql `${sql.raw(colName)} <= ${sql.raw(String(meta.max))}`));
+        }
+    }
+    if (isText) {
+        if (meta.min !== undefined && meta.max !== undefined) {
+            checks.push(check(`${colName}_length`, sql `length(${sql.raw(colName)}) >= ${sql.raw(String(meta.min))} AND length(${sql.raw(colName)}) <= ${sql.raw(String(meta.max))}`));
+        }
+        else if (meta.min !== undefined) {
+            checks.push(check(`${colName}_min_length`, sql `length(${sql.raw(colName)}) >= ${sql.raw(String(meta.min))}`));
+        }
+        else if (meta.max !== undefined) {
+            checks.push(check(`${colName}_max_length`, sql `length(${sql.raw(colName)}) <= ${sql.raw(String(meta.max))}`));
+        }
+    }
+    if (meta.kind === 'enum' && meta.enumValues !== undefined && meta.enumValues.length > 0) {
+        const escaped = meta.enumValues.map(v => `'${v.replace(/'/g, "''")}'`);
+        checks.push(check(`${colName}_enum`, sql `${sql.raw(colName)} IN (${sql.raw(escaped.join(', '))})`));
+    }
+}
+//# sourceMappingURL=project-table.js.map

package/dist/data/domain/project-table.js.map

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

package/dist/data/domain/traits.d.ts

@@ -0,0 +1,9 @@
+import type { FieldDescriptor, TraitDefinition } from './types.js';
+export declare const effectiveDatedTrait: TraitDefinition;
+export declare const auditedTrait: TraitDefinition;
+export declare const softDeletedTrait: TraitDefinition;
+export declare function applyTrait(definitionName: string, existingFields: Record<string, FieldDescriptor>, existingTraits: string[], trait: TraitDefinition): {
+    fields: Record<string, FieldDescriptor>;
+    traits: string[];
+};
+//# sourceMappingURL=traits.d.ts.map

package/dist/data/domain/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/data/domain/traits.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAUlE,eAAO,MAAM,mBAAmB,EAAE,eAOjC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,eAQ1B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,eAM9B,CAAA;AAED,wBAAgB,UAAU,CACxB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC/C,cAAc,EAAE,MAAM,EAAE,EACxB,KAAK,EAAE,eAAe,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB/D"}

package/dist/data/domain/traits.js

@@ -0,0 +1,48 @@
+import { field } from './field.js';
+function autoManaged(f) {
+    return { _meta: { ...f._meta, autoManaged: true } };
+}
+function autoManagedReadOnly(f) {
+    return { _meta: { ...f._meta, autoManaged: true, readOnly: true } };
+}
+export const effectiveDatedTrait = {
+    name: 'effectiveDated',
+    fields: {
+        effectiveFrom: autoManaged(field.timestamp().default('now')),
+        effectiveTo: autoManaged(field.timestamp().nullable()),
+        version: autoManaged(field.integer().default(1)),
+    },
+};
+export const auditedTrait = {
+    name: 'audited',
+    fields: {
+        createdAt: autoManagedReadOnly(field.timestamp().default('now')),
+        updatedAt: autoManaged(field.timestamp().default('now')),
+        createdBy: autoManagedReadOnly(field.text().nullable()),
+        updatedBy: autoManaged(field.text().nullable()),
+    },
+};
+export const softDeletedTrait = {
+    name: 'softDeleted',
+    fields: {
+        deletedAt: autoManaged(field.timestamp().nullable()),
+        deletedBy: autoManaged(field.text().nullable()),
+    },
+};
+export function applyTrait(definitionName, existingFields, existingTraits, trait) {
+    if (existingTraits.includes(trait.name)) {
+        throw new Error(`[pipework] Trait "${trait.name}" is already applied to "${definitionName}".`);
+    }
+    for (const fieldName of Object.keys(trait.fields)) {
+        if (fieldName in existingFields) {
+            throw new Error(`[pipework] Trait "${trait.name}" adds field "${fieldName}" which already exists in "${definitionName}".\n\n` +
+                `  Remove the field from your definition or choose a different name.\n` +
+                `  Trait "${trait.name}" provides: ${Object.keys(trait.fields).join(', ')}`);
+        }
+    }
+    return {
+        fields: { ...existingFields, ...trait.fields },
+        traits: [...existingTraits, trait.name],
+    };
+}
+//# sourceMappingURL=traits.js.map

package/dist/data/domain/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../../../src/data/domain/traits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAGlC,SAAS,WAAW,CAAC,CAAkB;IACrC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAA;AACrD,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAkB;IAC7C,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAA;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE;QACN,aAAa,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5D,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC;QACtD,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KACjD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,SAAS;IACf,MAAM,EAAE;QACN,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChE,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxD,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;QACvD,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;KAChD;CACF,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC;QACpD,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;KAChD;CACF,CAAA;AAED,MAAM,UAAU,UAAU,CACxB,cAAsB,EACtB,cAA+C,EAC/C,cAAwB,EACxB,KAAsB;IAEtB,IAAI,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,IAAI,4BAA4B,cAAc,IAAI,CAC9E,CAAA;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,SAAS,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,CAAC,IAAI,iBAAiB,SAAS,8BAA8B,cAAc,QAAQ;gBAC7G,uEAAuE;gBACvE,YAAY,KAAK,CAAC,IAAI,eAAe,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE;QAC9C,MAAM,EAAE,CAAC,GAAG,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC;KACxC,CAAA;AACH,CAAC"}

package/dist/data/domain/types.d.ts

@@ -0,0 +1,130 @@
+import type { z } from 'zod/v4';
+import type { Table } from '../db/types.js';
+import type { InferSelect, InferFieldOutput } from './brand.js';
+import type { AnyPgColumn, PgTable } from 'drizzle-orm/pg-core';
+export type FieldKind = 'uuid' | 'text' | 'integer' | 'serial' | 'bigint' | 'boolean' | 'timestamp' | 'enum' | 'jsonb' | 'decimal' | 'custom';
+export interface FieldMeta {
+    readonly kind: FieldKind;
+    readonly nullable: boolean;
+    readonly hasDefault: boolean;
+    readonly defaultValue?: unknown;
+    readonly primaryKey: boolean;
+    readonly defaultRandom: boolean;
+    readonly unique: boolean;
+    readonly readOnly: boolean;
+    readonly tenant: boolean;
+    readonly brand?: string;
+    readonly reference?: {
+        readonly definition: DomainDefinition;
+        readonly field: string;
+    };
+    readonly min?: number;
+    readonly max?: number;
+    readonly autoManaged: boolean;
+    readonly email: boolean;
+    readonly url: boolean;
+    readonly regex?: RegExp;
+    readonly precision?: {
+        readonly p: number;
+        readonly s: number;
+    };
+    readonly enumValues?: readonly string[];
+    readonly jsonbShape?: z.ZodType;
+    readonly serializedAs?: 'string';
+    readonly customColumn?: unknown;
+    readonly customValidator?: z.ZodType;
+}
+/** A field in a domain definition — carries runtime metadata and a phantom output type. */
+export interface FieldDescriptor<TOutput = unknown> {
+    readonly _meta: FieldMeta;
+    readonly _output?: TOutput;
+}
+type AnyFieldDescriptor = FieldDescriptor<any>;
+/** Constraint alias for generic bounds — safe under exactOptionalPropertyTypes. */
+export type FieldRecord = Record<string, AnyFieldDescriptor>;
+/** Options for pipe.define() — database affinity, virtual mode, custom indexes. */
+export interface DefineOptions {
+    readonly database?: string;
+    readonly virtual?: boolean;
+    readonly indexes?: (columns: Record<string, any>) => Record<string, any>;
+}
+/** Column type projected from a FieldDescriptor — carries the right data type for Drizzle operators. */
+export type FieldColumn<F extends FieldDescriptor> = AnyPgColumn<{
+    data: NonNullable<InferFieldOutput<F>>;
+    notNull: null extends InferFieldOutput<F> ? false : true;
+}>;
+/** Maps field definitions to typed Drizzle column references. */
+export type ProjectedColumns<TFields extends FieldRecord> = {
+    readonly [K in keyof TFields & string]: FieldColumn<TFields[K]>;
+};
+/** Definition metadata and projection methods — the non-table surface of a DefinedTable. */
+export interface DefinitionMethods<TFields extends FieldRecord = FieldRecord> {
+    readonly $name: string;
+    readonly $fields: TFields;
+    readonly $options: DefineOptions;
+    readonly $traits: readonly string[];
+    table(): Table;
+    insertShape(): z.ZodType;
+    selectShape(): z.ZodType;
+    updateShape(): z.ZodType;
+    factory(): FactoryBuilder;
+    effectiveDated(): DefinedTable<TFields & EffectiveDatedFields>;
+    audited(): DefinedTable<TFields & AuditedFields>;
+    softDeleted(): DefinedTable<TFields & SoftDeletedFields>;
+    readonly Select: InferSelect<TFields>;
+    readonly Insert: unknown;
+    readonly Update: unknown;
+}
+/**
+ * A domain definition that IS a Drizzle PgTable — columns are direct properties,
+ * usable in from(), eq(), orderBy(), joins, and partial selects.
+ *
+ * Created by pipe.define(). Metadata uses $ prefix ($name, $fields, $options, $traits)
+ * to avoid collisions with column properties.
+ *
+ * The PgTable base is parameterized with ProjectedColumns so that Drizzle's
+ * _['columns'] carries named, branded column types. Without this, select()
+ * and returning() fall back to index-signature records.
+ */
+export type DefinedTable<TFields extends FieldRecord = FieldRecord> = PgTable<{
+    name: string;
+    schema: string | undefined;
+    columns: ProjectedColumns<TFields>;
+    dialect: 'pg';
+}> & ProjectedColumns<TFields> & DefinitionMethods<TFields>;
+/**
+ * @deprecated Use DefinedTable instead. DomainDefinition is kept for backward compatibility
+ * with code that hasn't migrated to the direct-column-access API.
+ */
+export type DomainDefinition<TFields extends FieldRecord = FieldRecord> = DefinedTable<TFields>;
+/** A named set of fields that can be applied to a domain definition via trait methods. */
+export interface TraitDefinition {
+    readonly name: string;
+    readonly fields: FieldRecord;
+}
+export interface EffectiveDatedFields {
+    readonly effectiveFrom: FieldDescriptor<Date>;
+    readonly effectiveTo: FieldDescriptor<Date | null>;
+    readonly version: FieldDescriptor<number>;
+}
+export interface AuditedFields {
+    readonly createdAt: FieldDescriptor<Date>;
+    readonly updatedAt: FieldDescriptor<Date>;
+    readonly createdBy: FieldDescriptor<string | null>;
+    readonly updatedBy: FieldDescriptor<string | null>;
+}
+export interface SoftDeletedFields {
+    readonly deletedAt: FieldDescriptor<Date | null>;
+    readonly deletedBy: FieldDescriptor<string | null>;
+}
+/** Test data factory — inserts rows and resolves FK dependencies automatically. */
+export interface FactoryBuilder {
+    create(overrides?: Partial<Record<string, unknown>>, options?: FactoryOptions): Promise<Record<string, unknown>>;
+    createMany(count: number, overrides?: Partial<Record<string, unknown>> | ((index: number) => Partial<Record<string, unknown>>), options?: FactoryOptions): Promise<Record<string, unknown>[]>;
+}
+export interface FactoryOptions {
+    readonly db?: unknown;
+    readonly tenantId?: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/data/domain/types.d.ts.map

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

package/dist/data/domain/types.js

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

package/dist/data/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/data/domain/types.ts"],"names":[],"mappings":""}

package/dist/data/jsonb/index.d.ts

@@ -0,0 +1,2 @@
+export { contains, containedBy, hasKey } from './query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/jsonb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/jsonb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA"}

package/dist/data/jsonb/index.js

@@ -0,0 +1,2 @@
+export { contains, containedBy, hasKey } from './query.js';
+//# sourceMappingURL=index.js.map

package/dist/data/jsonb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/data/jsonb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA"}

package/dist/data/jsonb/namespace.d.ts

@@ -0,0 +1,11 @@
+import { contains, containedBy, hasKey } from './query.js';
+/** JSONB query operators — typed helpers for PostgreSQL JSONB containment and key checks. */
+export declare const jsonb: {
+    /** The @> containment operator — tests whether a JSONB column contains the given value. */
+    contains: typeof contains;
+    /** The <@ contained-by operator — tests whether a JSONB column is contained by the given value. */
+    containedBy: typeof containedBy;
+    /** The ? key-existence operator — tests whether a JSONB column has the given top-level key. */
+    hasKey: typeof hasKey;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/data/jsonb/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/data/jsonb/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAE1D,6FAA6F;AAC7F,eAAO,MAAM,KAAK;IAChB,2FAA2F;;IAE3F,mGAAmG;;IAEnG,+FAA+F;;CAEhG,CAAA"}

package/dist/data/jsonb/namespace.js

@@ -0,0 +1,11 @@
+import { contains, containedBy, hasKey } from './query.js';
+/** JSONB query operators — typed helpers for PostgreSQL JSONB containment and key checks. */
+export const jsonb = {
+    /** The @> containment operator — tests whether a JSONB column contains the given value. */
+    contains,
+    /** The <@ contained-by operator — tests whether a JSONB column is contained by the given value. */
+    containedBy,
+    /** The ? key-existence operator — tests whether a JSONB column has the given top-level key. */
+    hasKey,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/data/jsonb/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../../src/data/jsonb/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAE1D,6FAA6F;AAC7F,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,2FAA2F;IAC3F,QAAQ;IACR,mGAAmG;IACnG,WAAW;IACX,+FAA+F;IAC/F,MAAM;CACP,CAAA"}

package/dist/data/jsonb/query.d.ts

@@ -0,0 +1,5 @@
+import type { SQL, Column } from '../db/types.js';
+export declare function contains(column: Column | SQL, value: unknown): SQL<boolean>;
+export declare function containedBy(column: Column | SQL, value: unknown): SQL<boolean>;
+export declare function hasKey(column: Column | SQL, key: string): SQL<boolean>;
+//# sourceMappingURL=query.d.ts.map

package/dist/data/jsonb/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/data/jsonb/query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEjD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAE3E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAE9E;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAEtE"}

package/dist/data/jsonb/query.js

@@ -0,0 +1,11 @@
+import { sql } from '../db/sql.js';
+export function contains(column, value) {
+    return sql `${column} @> ${JSON.stringify(value)}::jsonb`;
+}
+export function containedBy(column, value) {
+    return sql `${column} <@ ${JSON.stringify(value)}::jsonb`;
+}
+export function hasKey(column, key) {
+    return sql `${column} ? ${key}`;
+}
+//# sourceMappingURL=query.js.map

package/dist/data/jsonb/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/data/jsonb/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,KAAc;IAC3D,OAAO,GAAG,CAAS,GAAG,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB,EAAE,KAAc;IAC9D,OAAO,GAAG,CAAS,GAAG,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAoB,EAAE,GAAW;IACtD,OAAO,GAAG,CAAS,GAAG,MAAM,MAAM,GAAG,EAAE,CAAA;AACzC,CAAC"}

package/dist/data/migrate/check.d.ts

@@ -0,0 +1,14 @@
+import { type MigrationHazard, type Severity } from './safety.js';
+export interface MigrationCheckResult {
+    safe: boolean;
+    hasDestructive: boolean;
+    hasLocking: boolean;
+    fileHazards: {
+        file: string;
+        hazards: MigrationHazard[];
+    }[];
+}
+export declare function checkMigrations(migrationsFolder: string): MigrationCheckResult;
+export declare function formatCheckResult(result: MigrationCheckResult): string;
+export type { MigrationHazard, Severity };
+//# sourceMappingURL=check.d.ts.map

package/dist/data/migrate/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/data/migrate/check.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE5F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,cAAc,EAAE,OAAO,CAAA;IACvB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,eAAe,EAAE,CAAA;KAAE,EAAE,CAAA;CAC5D;AAYD,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,oBAAoB,CA+B9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAyBtE;AAED,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAA"}