@porulle/core 0.1.0

package/dist/kernel/database/schema.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Combined schema barrel for Drizzle.
+ *
+ * Single source of truth for all core table definitions. Both drizzle-kit
+ * (via drizzle.config.ts) and the TypeScript type system consume this file.
+ *
+ * Drizzle-kit resolves re-exports, so pointing the config schema option
+ * at this one file discovers every core table. Plugin schemas live in
+ * their own packages and are referenced via glob patterns.
+ */
+export * from "../../auth/auth-schema.js";
+export * from "../../modules/catalog/schema.js";
+export * from "../../modules/inventory/schema.js";
+export * from "../../modules/cart/schema.js";
+export * from "../../modules/orders/schema.js";
+export * from "../../modules/orders/sequences.js";
+export * from "../../modules/customers/schema.js";
+export * from "../../modules/pricing/schema.js";
+export * from "../../modules/promotions/schema.js";
+export * from "../../modules/media/schema.js";
+export * from "../../modules/webhooks/schema.js";
+export * from "../../modules/fulfillment/schema.js";
+export * from "../jobs/schema.js";
+export * from "../compensation/schema.js";
+export * from "../../modules/audit/schema.js";
+//# sourceMappingURL=schema.d.ts.map

package/dist/kernel/database/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,2BAA2B,CAAC;AAG1C,cAAc,iCAAiC,CAAC;AAGhD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAGlD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,iCAAiC,CAAC;AAGhD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,kCAAkC,CAAC;AAGjD,cAAc,qCAAqC,CAAC;AAGpD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,+BAA+B,CAAC"}

package/dist/kernel/database/schema.js

@@ -0,0 +1,39 @@
+/**
+ * Combined schema barrel for Drizzle.
+ *
+ * Single source of truth for all core table definitions. Both drizzle-kit
+ * (via drizzle.config.ts) and the TypeScript type system consume this file.
+ *
+ * Drizzle-kit resolves re-exports, so pointing the config schema option
+ * at this one file discovers every core table. Plugin schemas live in
+ * their own packages and are referenced via glob patterns.
+ */
+// Auth (Better Auth generated tables)
+export * from "../../auth/auth-schema.js";
+// Catalog module
+export * from "../../modules/catalog/schema.js";
+// Inventory module
+export * from "../../modules/inventory/schema.js";
+// Cart module
+export * from "../../modules/cart/schema.js";
+// Orders module
+export * from "../../modules/orders/schema.js";
+export * from "../../modules/orders/sequences.js";
+// Customers module
+export * from "../../modules/customers/schema.js";
+// Pricing module
+export * from "../../modules/pricing/schema.js";
+// Promotions module
+export * from "../../modules/promotions/schema.js";
+// Media module
+export * from "../../modules/media/schema.js";
+// Webhooks module
+export * from "../../modules/webhooks/schema.js";
+// Fulfillment module
+export * from "../../modules/fulfillment/schema.js";
+// Jobs (kernel)
+export * from "../jobs/schema.js";
+// Compensation failures (kernel)
+export * from "../compensation/schema.js";
+// Audit module
+export * from "../../modules/audit/schema.js";

package/dist/kernel/database/scoped-db.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Scoped DB Proxy
+ *
+ * Wraps a Drizzle PgDatabase instance so that INSERT operations on
+ * org-scoped tables automatically include the actor's organizationId,
+ * and SELECT ... FROM org-scoped tables constrain rows to that organization.
+ *
+ * Plugin route handlers receive this scoped db via PluginContext.database.db
+ * (organization resolved per operation from AsyncLocalStorage when used from
+ * plugin routes) or a fixed string / getter from router() / tests.
+ */
+export type ScopedOrganizationId = string | (() => string);
+export declare function createScopedDb<TDb>(rawDb: TDb, orgSource: ScopedOrganizationId): TDb;
+//# sourceMappingURL=scoped-db.d.ts.map

package/dist/kernel/database/scoped-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-db.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/scoped-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAgB3D,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,oBAAoB,GAAG,GAAG,CA+EpF"}

package/dist/kernel/database/scoped-db.js

@@ -0,0 +1,103 @@
+/**
+ * Scoped DB Proxy
+ *
+ * Wraps a Drizzle PgDatabase instance so that INSERT operations on
+ * org-scoped tables automatically include the actor's organizationId,
+ * and SELECT ... FROM org-scoped tables constrain rows to that organization.
+ *
+ * Plugin route handlers receive this scoped db via PluginContext.database.db
+ * (organization resolved per operation from AsyncLocalStorage when used from
+ * plugin routes) or a fixed string / getter from router() / tests.
+ */
+import { and, eq, getTableColumns } from "drizzle-orm";
+function resolveOrganizationId(source) {
+    return typeof source === "function" ? source() : source;
+}
+function tableHasOrganizationId(table) {
+    if (table == null || typeof table !== "object")
+        return false;
+    try {
+        const columns = getTableColumns(table);
+        return "organizationId" in columns;
+    }
+    catch {
+        return false;
+    }
+}
+export function createScopedDb(rawDb, orgSource) {
+    if (!rawDb || typeof rawDb !== "object")
+        return rawDb;
+    return new Proxy(rawDb, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (prop === "insert" && typeof value === "function") {
+                return (table) => {
+                    const builder = value.call(target, table);
+                    if (!tableHasOrganizationId(table))
+                        return builder;
+                    const originalValues = builder.values;
+                    if (typeof originalValues !== "function")
+                        return builder;
+                    return new Proxy(builder, {
+                        get(t, p, r) {
+                            if (p === "values") {
+                                return (data) => {
+                                    const oid = resolveOrganizationId(orgSource);
+                                    const stamp = (row) => ({
+                                        ...row,
+                                        organizationId: oid,
+                                    });
+                                    const stamped = Array.isArray(data)
+                                        ? data.map(stamp)
+                                        : stamp(data);
+                                    return originalValues.call(t, stamped);
+                                };
+                            }
+                            const v = Reflect.get(t, p, r);
+                            return typeof v === "function" ? v.bind(t) : v;
+                        },
+                    });
+                };
+            }
+            if (prop === "select" && typeof value === "function") {
+                return (...args) => {
+                    const selectBuilder = value.apply(target, args);
+                    return new Proxy(selectBuilder, {
+                        get(sbTarget, sbProp, sbReceiver) {
+                            const sbVal = Reflect.get(sbTarget, sbProp, sbReceiver);
+                            if (sbProp === "from" && typeof sbVal === "function") {
+                                return (fromArg, ...fromRest) => {
+                                    const chain = sbVal.call(sbTarget, fromArg, ...fromRest);
+                                    if (!tableHasOrganizationId(fromArg))
+                                        return chain;
+                                    const columns = getTableColumns(fromArg);
+                                    const orgCol = columns.organizationId;
+                                    if (!orgCol)
+                                        return chain;
+                                    const orgEq = eq(orgCol, resolveOrganizationId(orgSource));
+                                    const inner = chain;
+                                    const scoped = inner.where(orgEq);
+                                    return new Proxy(scoped, {
+                                        get(st, sp, sr) {
+                                            const sv = Reflect.get(st, sp, sr);
+                                            if (sp === "where" && typeof sv === "function") {
+                                                return (condition, ...wRest) => {
+                                                    const c = condition;
+                                                    const merged = c ? and(orgEq, c) : orgEq;
+                                                    return sv.call(st, merged, ...wRest);
+                                                };
+                                            }
+                                            return typeof sv === "function" ? sv.bind(st) : sv;
+                                        },
+                                    });
+                                };
+                            }
+                            return typeof sbVal === "function" ? sbVal.bind(sbTarget) : sbVal;
+                        },
+                    });
+                };
+            }
+            return typeof value === "function" ? value.bind(target) : value;
+        },
+    });
+}

package/dist/kernel/database/tx-context.d.ts

@@ -0,0 +1,15 @@
+import type { Actor } from "../../auth/types.js";
+import type { DatabaseAdapter } from "./adapter.js";
+export interface TxContext<TTx = unknown> {
+    tx: TTx;
+    actor: Actor | null;
+    requestId: string;
+}
+export interface WithTransactionOptions {
+    actor: Actor | null;
+    requestId?: string;
+}
+export declare function createTxContext<TTx>(tx: TTx, options: WithTransactionOptions): TxContext<TTx>;
+export declare function withTransaction<TDb, TTx, TResult>(database: DatabaseAdapter<TDb, TTx>, options: WithTransactionOptions, fn: (ctx: TxContext<TTx>) => Promise<TResult>): Promise<TResult>;
+export declare function reuseOrCreateTxContext<TTx>(tx: TTx, options: WithTransactionOptions, existing?: TxContext<TTx> | null): TxContext<TTx>;
+//# sourceMappingURL=tx-context.d.ts.map

package/dist/kernel/database/tx-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-context.d.ts","sourceRoot":"","sources":["../../../src/kernel/database/tx-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,SAAS,CAAC,GAAG,GAAG,OAAO;IACtC,EAAE,EAAE,GAAG,CAAC;IACR,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,GAAG,EACjC,EAAE,EAAE,GAAG,EACP,OAAO,EAAE,sBAAsB,GAC9B,SAAS,CAAC,GAAG,CAAC,CAMhB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EACrD,QAAQ,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,EACnC,OAAO,EAAE,sBAAsB,EAC/B,EAAE,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EACxC,EAAE,EAAE,GAAG,EACP,OAAO,EAAE,sBAAsB,EAC/B,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAC/B,SAAS,CAAC,GAAG,CAAC,CAKhB"}

package/dist/kernel/database/tx-context.js

@@ -0,0 +1,19 @@
+import { randomUUID } from "node:crypto";
+export function createTxContext(tx, options) {
+    return {
+        tx,
+        actor: options.actor,
+        requestId: options.requestId ?? randomUUID(),
+    };
+}
+export async function withTransaction(database, options, fn) {
+    return database.transaction(async (tx) => {
+        return fn(createTxContext(tx, options));
+    });
+}
+export function reuseOrCreateTxContext(tx, options, existing) {
+    if (existing) {
+        return existing;
+    }
+    return createTxContext(tx, options);
+}

package/dist/kernel/error-mapper.d.ts

@@ -0,0 +1,14 @@
+import type { ContentfulStatusCode } from "hono/utils/http-status";
+import type { Logger } from "../runtime/logger.js";
+export declare function mapErrorToStatus(error: unknown): ContentfulStatusCode;
+export interface ErrorMapping {
+    body: {
+        error: {
+            code: string;
+            message: string;
+        };
+    };
+    status: ContentfulStatusCode;
+}
+export declare function mapErrorToResponse(err: unknown, isProd: boolean, logger?: Logger): ErrorMapping;
+//# sourceMappingURL=error-mapper.d.ts.map

package/dist/kernel/error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.d.ts","sourceRoot":"","sources":["../../src/kernel/error-mapper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAWnD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAGrE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACnD,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAaD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CA8Ed"}

package/dist/kernel/error-mapper.js

@@ -0,0 +1,93 @@
+import { HTTPException } from "hono/http-exception";
+import { toCommerceError } from "./errors.js";
+const statusByCode = {
+    NOT_FOUND: 404,
+    VALIDATION_FAILED: 422,
+    FORBIDDEN: 403,
+    CONFLICT: 409,
+    INVALID_TRANSITION: 422,
+    ORG_RESOLUTION_FAILED: 503,
+};
+export function mapErrorToStatus(error) {
+    const normalized = toCommerceError(error);
+    return statusByCode[normalized.code] ?? 500;
+}
+const httpStatusCodeMap = {
+    401: "UNAUTHORIZED",
+    403: "FORBIDDEN",
+    413: "PAYLOAD_TOO_LARGE",
+    429: "RATE_LIMITED",
+};
+function httpExceptionCode(status) {
+    return httpStatusCodeMap[status] ?? "REQUEST_REJECTED";
+}
+export function mapErrorToResponse(err, isProd, logger) {
+    const message = err instanceof Error ? err.message : String(err);
+    // ZodError from @hono/zod-openapi validation (bypasses defaultHook)
+    if (err.constructor?.name === "ZodError" ||
+        "issues" in err) {
+        if (isProd) {
+            return {
+                body: { error: { code: "VALIDATION_FAILED", message: "Invalid input." } },
+                status: 422,
+            };
+        }
+        const issues = err.issues ?? [];
+        return {
+            body: {
+                error: {
+                    code: "VALIDATION_FAILED",
+                    message: issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; "),
+                },
+            },
+            status: 422,
+        };
+    }
+    // Hono HTTPException — CSRF, body-limit, rate-limit, route guards
+    if (err instanceof HTTPException) {
+        return {
+            body: {
+                error: {
+                    code: httpExceptionCode(err.status),
+                    message: isProd ? "Request rejected." : (err.message || "Request rejected."),
+                },
+            },
+            status: err.status,
+        };
+    }
+    // Malformed JSON body from c.req.json()
+    if (err instanceof SyntaxError || /malformed json|unexpected token/i.test(message)) {
+        return {
+            body: { error: { code: "BAD_REQUEST", message: "Malformed JSON in request body." } },
+            status: 400,
+        };
+    }
+    // CommerceError subclasses → mapped status (403 / 404 / 409 / 422 / 503)
+    if (err instanceof Error &&
+        "code" in err &&
+        typeof err.code === "string") {
+        const status = mapErrorToStatus(err);
+        if (status !== 500) {
+            const errorCode = err.code;
+            return {
+                body: {
+                    error: {
+                        code: errorCode,
+                        message: isProd && status >= 500 ? "An error occurred." : err.message,
+                    },
+                },
+                status,
+            };
+        }
+    }
+    logger?.error({ err }, "unhandled request error");
+    return {
+        body: {
+            error: {
+                code: "INTERNAL_ERROR",
+                message: isProd ? "An unexpected error occurred." : message,
+            },
+        },
+        status: 500,
+    };
+}

package/dist/kernel/errors.d.ts

@@ -0,0 +1,43 @@
+export interface CommerceError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export interface FieldError {
+    field: string;
+    message: string;
+}
+export declare class CommerceNotFoundError extends Error implements CommerceError {
+    details?: unknown | undefined;
+    code: "NOT_FOUND";
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class CommerceValidationError extends Error implements CommerceError {
+    fieldErrors?: FieldError[] | undefined;
+    details?: unknown | undefined;
+    code: "VALIDATION_FAILED";
+    constructor(message: string, fieldErrors?: FieldError[] | undefined, details?: unknown | undefined);
+}
+export declare class CommerceForbiddenError extends Error implements CommerceError {
+    details?: unknown | undefined;
+    code: "FORBIDDEN";
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class CommerceConflictError extends Error implements CommerceError {
+    details?: unknown | undefined;
+    code: "CONFLICT";
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class CommerceInvalidTransitionError extends Error implements CommerceError {
+    details?: unknown | undefined;
+    code: "INVALID_TRANSITION";
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class OrgResolutionError extends Error implements CommerceError {
+    details?: unknown | undefined;
+    code: "ORG_RESOLUTION_FAILED";
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare function isCommerceError(value: unknown): value is CommerceError;
+export declare function toCommerceError(error: unknown): CommerceError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/kernel/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAsB,SAAQ,KAAM,YAAW,aAAa;IAI9D,OAAO,CAAC,EAAE,OAAO;IAH1B,IAAI,EAAG,WAAW,CAAU;gBAE1B,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,aAAa;IAIhE,WAAW,CAAC,EAAE,UAAU,EAAE;IAC1B,OAAO,CAAC,EAAE,OAAO;IAJ1B,IAAI,EAAG,mBAAmB,CAAU;gBAElC,OAAO,EAAE,MAAM,EACR,WAAW,CAAC,EAAE,UAAU,EAAE,YAAA,EAC1B,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,sBAAuB,SAAQ,KAAM,YAAW,aAAa;IAI/D,OAAO,CAAC,EAAE,OAAO;IAH1B,IAAI,EAAG,WAAW,CAAU;gBAE1B,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,qBAAsB,SAAQ,KAAM,YAAW,aAAa;IAI9D,OAAO,CAAC,EAAE,OAAO;IAH1B,IAAI,EAAG,UAAU,CAAU;gBAEzB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,8BAA+B,SAAQ,KAAM,YAAW,aAAa;IAIvE,OAAO,CAAC,EAAE,OAAO;IAH1B,IAAI,EAAG,oBAAoB,CAAU;gBAEnC,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,kBAAmB,SAAQ,KAAM,YAAW,aAAa;IAI3D,OAAO,CAAC,EAAE,OAAO;IAH1B,IAAI,EAAG,uBAAuB,CAAU;gBAEtC,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAGtE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAgB7D"}

package/dist/kernel/errors.js

@@ -0,0 +1,78 @@
+export class CommerceNotFoundError extends Error {
+    details;
+    code = "NOT_FOUND";
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CommerceNotFoundError";
+    }
+}
+export class CommerceValidationError extends Error {
+    fieldErrors;
+    details;
+    code = "VALIDATION_FAILED";
+    constructor(message, fieldErrors, details) {
+        super(message);
+        this.fieldErrors = fieldErrors;
+        this.details = details;
+        this.name = "CommerceValidationError";
+    }
+}
+export class CommerceForbiddenError extends Error {
+    details;
+    code = "FORBIDDEN";
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CommerceForbiddenError";
+    }
+}
+export class CommerceConflictError extends Error {
+    details;
+    code = "CONFLICT";
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CommerceConflictError";
+    }
+}
+export class CommerceInvalidTransitionError extends Error {
+    details;
+    code = "INVALID_TRANSITION";
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CommerceInvalidTransitionError";
+    }
+}
+export class OrgResolutionError extends Error {
+    details;
+    code = "ORG_RESOLUTION_FAILED";
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "OrgResolutionError";
+    }
+}
+export function isCommerceError(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    return "code" in value && "message" in value;
+}
+export function toCommerceError(error) {
+    if (isCommerceError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return {
+            code: "INTERNAL_ERROR",
+            message: error.message,
+            details: { name: error.name },
+        };
+    }
+    return {
+        code: "INTERNAL_ERROR",
+        message: "Unexpected server error",
+        details: error,
+    };
+}

package/dist/kernel/factory/repository-factory.d.ts

@@ -0,0 +1,71 @@
+import { type InferSelectModel, type InferInsertModel } from "drizzle-orm";
+import type { PgTableWithColumns, TableConfig } from "drizzle-orm/pg-core";
+import type { TxContext } from "../database/tx-context.js";
+import type { DrizzleDatabase } from "../database/drizzle-db.js";
+/**
+ * Filter type — partial record of column values to match with eq().
+ * Only keys that exist on TRow and have non-undefined values are used.
+ */
+export type Filters<TRow> = Partial<TRow>;
+/**
+ * Options for findMany / findAndCount queries.
+ */
+export interface FindOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: Array<{
+        column: string;
+        direction: "asc" | "desc";
+    }>;
+    withDeleted?: boolean;
+}
+/**
+ * Standard CRUD operations derived from a Drizzle pgTable schema.
+ * All methods support optional TxContext for transaction participation.
+ */
+export interface BaseRepository<TRow, TInsert> {
+    findById(id: string, ctx?: TxContext): Promise<TRow | undefined>;
+    findMany(filters?: Filters<TRow>, options?: FindOptions, ctx?: TxContext): Promise<TRow[]>;
+    findAndCount(filters?: Filters<TRow>, options?: FindOptions, ctx?: TxContext): Promise<{
+        rows: TRow[];
+        total: number;
+    }>;
+    create(data: TInsert, ctx?: TxContext): Promise<TRow>;
+    createMany(data: TInsert[], ctx?: TxContext): Promise<TRow[]>;
+    update(id: string, data: Partial<TInsert>, ctx?: TxContext): Promise<TRow>;
+    delete(id: string, ctx?: TxContext): Promise<void>;
+}
+/**
+ * Extended repository for tables with a `deleted_at` column.
+ * Adds softDelete and restore operations.
+ */
+export interface SoftDeletableRepository<TRow, TInsert> extends BaseRepository<TRow, TInsert> {
+    softDelete(id: string, ctx?: TxContext): Promise<void>;
+    restore(id: string, ctx?: TxContext): Promise<TRow>;
+}
+/**
+ * Type-level check: does the table config have a `deletedAt` or `deleted_at` column?
+ */
+type HasDeletedAt<T extends PgTableWithColumns<TableConfig>> = "deletedAt" extends keyof T ? true : "deleted_at" extends keyof T ? true : false;
+/**
+ * Conditional repository type: if the table has a deleted_at column,
+ * return SoftDeletableRepository; otherwise BaseRepository.
+ */
+export type RepositoryFor<T extends PgTableWithColumns<TableConfig>> = HasDeletedAt<T> extends true ? SoftDeletableRepository<InferSelectModel<T>, InferInsertModel<T>> : BaseRepository<InferSelectModel<T>, InferInsertModel<T>>;
+/**
+ * Creates a typed repository with standard CRUD operations from a Drizzle table schema.
+ *
+ * Usage:
+ * ```typescript
+ * const repo = createRepository(schema.promotions, db)
+ * const row = await repo.findById("abc-123")
+ * const rows = await repo.findMany({ status: "active" }, { limit: 10 })
+ * ```
+ *
+ * Tables with a `deletedAt` column automatically get `softDelete()` and `restore()`.
+ * Domain-specific queries should remain in dedicated repository classes that
+ * delegate standard CRUD to the factory-created instance.
+ */
+export declare function createRepository<T extends PgTableWithColumns<TableConfig>>(table: T, db: DrizzleDatabase): RepositoryFor<T>;
+export {};
+//# sourceMappingURL=repository-factory.d.ts.map

package/dist/kernel/factory/repository-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-factory.d.ts","sourceRoot":"","sources":["../../../src/kernel/factory/repository-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,2BAA2B,CAAC;AAGzE;;;GAGG;AACH,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,IAAI,EAAE,OAAO;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACjE,QAAQ,CACN,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,EACrB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACnB,YAAY,CACV,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,CAAC,EAAE,WAAW,EACrB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,IAAI,EAAE,OAAO,CACpD,SAAQ,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,kBAAkB,CAAC,WAAW,CAAC,IACzD,WAAW,SAAS,MAAM,CAAC,GAAG,IAAI,GAAG,YAAY,SAAS,MAAM,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,kBAAkB,CAAC,WAAW,CAAC,IACjE,YAAY,CAAC,CAAC,CAAC,SAAS,IAAI,GACxB,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,GACjE,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,WAAW,CAAC,EACxE,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,eAAe,GAClB,aAAa,CAAC,CAAC,CAAC,CAkJlB"}