@porulle/db 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @porulle/db
+
+The database surface plugins use instead of importing Drizzle directly.
+
+```ts
+import { defineTable, column, eq, and, sql } from "@porulle/db";
+```
+
+## Why this exists
+
+If every plugin imported from `drizzle-orm` directly, the framework couldn't:
+- Inject `organizationId` and `id` columns automatically
+- Add the standard `createdAt` / `updatedAt` timestamps
+- Generate the per-org index + composite unique constraints
+- Hot-swap the underlying ORM if we ever needed to (today: Drizzle on PostgreSQL — tomorrow could be different)
+
+`@porulle/db` is the thin contract that decouples plugins from the ORM. Drizzle stays as an implementation detail.
+
+## API
+
+### `defineTable(name, columns)`
+
+Top-level table. Auto-injects: `id` (UUID PK), `organizationId` (text NOT NULL with org index), `createdAt` and `updatedAt` (timestamps).
+
+```ts
+import { defineTable, column } from "@porulle/db";
+
+export const giftCards = defineTable("gift_cards", {
+  code: column.text({ unique: true }),
+  balance: column.integer(),
+  status: column.text({ enum: ["active", "disabled"], default: "active" }),
+});
+```
+
+### `column.*` builders
+
+`column.text({ unique?, optional?, enum?, default? })`
+`column.integer({ optional?, default? })`
+`column.boolean({ default? })`
+`column.timestamp({ optional? })`
+`column.jsonb<T>({ optional?, default? })`
+`column.uuid({ optional?, default? })` — for FKs to other org-scoped tables (child tables skip the auto-org column)
+
+### Re-exported Drizzle operators
+
+For query construction without importing `drizzle-orm` directly:
+
+```ts
+eq, ne, gt, gte, lt, lte, and, or, not, like, ilike, notLike,
+inArray, notInArray, isNull, isNotNull, between, sql, desc, asc
+```
+
+## Conventions
+
+- Every top-level table is org-scoped via the auto-injected `organizationId`. Cross-tenant queries are a closed surface — see [`SECURITY.md`](../../SECURITY.md).
+- Child tables (FK to a parent that already carries `organizationId`) get `id` and `createdAt` only. The parent's org column protects the child rows.
+- Drizzle hash drift across workspace copies has bitten us before — `@porulle/db` re-exports the operators so plugins inherit a single drizzle version.
+
+## See also
+
+- [Plugin Contract](https://github.com/asyncdotengineering/porulle/blob/main/apps/docs/src/content/docs/extending/plugin-contract.mdx) — Drizzle-first rule + org-scoping requirement
+- `packages/core/src/kernel/database/` — how the kernel composes the schema

package/dist/column.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Column definition helpers for defineTable.
+ *
+ * These produce config objects that defineTable maps to Drizzle column builders.
+ * Plugin developers use these instead of importing from drizzle-orm/pg-core directly.
+ *
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *     status: column.text({ enum: ["active", "disabled"], default: "active" }),
+ *   });
+ */
+export interface TextColumnDef {
+    readonly _type: "text";
+    unique?: boolean;
+    optional?: boolean;
+    enum?: readonly string[];
+    default?: string;
+}
+export interface IntegerColumnDef {
+    readonly _type: "integer";
+    unique?: boolean;
+    optional?: boolean;
+    default?: number;
+}
+export interface BooleanColumnDef {
+    readonly _type: "boolean";
+    optional?: boolean;
+    default?: boolean;
+}
+export interface UuidColumnDef {
+    readonly _type: "uuid";
+    optional?: boolean;
+    references?: unknown;
+}
+export interface TimestampColumnDef {
+    readonly _type: "timestamp";
+    optional?: boolean;
+    default?: "now";
+}
+export interface JsonColumnDef {
+    readonly _type: "json";
+    optional?: boolean;
+    default?: unknown;
+}
+export type ColumnDef = TextColumnDef | IntegerColumnDef | BooleanColumnDef | UuidColumnDef | TimestampColumnDef | JsonColumnDef;
+export declare const column: {
+    text: (opts?: Omit<TextColumnDef, "_type">) => TextColumnDef;
+    integer: (opts?: Omit<IntegerColumnDef, "_type">) => IntegerColumnDef;
+    boolean: (opts?: Omit<BooleanColumnDef, "_type">) => BooleanColumnDef;
+    uuid: (opts?: Omit<UuidColumnDef, "_type">) => UuidColumnDef;
+    timestamp: (opts?: Omit<TimestampColumnDef, "_type">) => TimestampColumnDef;
+    json: (opts?: Omit<JsonColumnDef, "_type">) => JsonColumnDef;
+};
+//# sourceMappingURL=column.d.ts.map

package/dist/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../src/column.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,kBAAkB,GAClB,aAAa,CAAC;AAElB,eAAO,MAAM,MAAM;kBACH,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,KAAG,aAAa;qBAKzC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,KAAG,gBAAgB;qBAKlD,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,KAAG,gBAAgB;kBAKrD,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,KAAG,aAAa;uBAKvC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,KAAG,kBAAkB;kBAK3D,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,KAAG,aAAa;CAI3D,CAAC"}

package/dist/column.js

@@ -0,0 +1,41 @@
+/**
+ * Column definition helpers for defineTable.
+ *
+ * These produce config objects that defineTable maps to Drizzle column builders.
+ * Plugin developers use these instead of importing from drizzle-orm/pg-core directly.
+ *
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *     status: column.text({ enum: ["active", "disabled"], default: "active" }),
+ *   });
+ */
+export const column = {
+    text: (opts) => ({
+        _type: "text",
+        ...opts,
+    }),
+    integer: (opts) => ({
+        _type: "integer",
+        ...opts,
+    }),
+    boolean: (opts) => ({
+        _type: "boolean",
+        ...opts,
+    }),
+    uuid: (opts) => ({
+        _type: "uuid",
+        ...opts,
+    }),
+    timestamp: (opts) => ({
+        _type: "timestamp",
+        ...opts,
+    }),
+    json: (opts) => ({
+        _type: "json",
+        ...opts,
+    }),
+};
+//# sourceMappingURL=column.js.map

package/dist/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sourceRoot":"","sources":["../src/column.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiDH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,IAAmC,EAAiB,EAAE,CAAC,CAAC;QAC7D,KAAK,EAAE,MAAe;QACtB,GAAG,IAAI;KACR,CAAC;IAEF,OAAO,EAAE,CAAC,IAAsC,EAAoB,EAAE,CAAC,CAAC;QACtE,KAAK,EAAE,SAAkB;QACzB,GAAG,IAAI;KACR,CAAC;IAEF,OAAO,EAAE,CAAC,IAAsC,EAAoB,EAAE,CAAC,CAAC;QACtE,KAAK,EAAE,SAAkB;QACzB,GAAG,IAAI;KACR,CAAC;IAEF,IAAI,EAAE,CAAC,IAAmC,EAAiB,EAAE,CAAC,CAAC;QAC7D,KAAK,EAAE,MAAe;QACtB,GAAG,IAAI;KACR,CAAC;IAEF,SAAS,EAAE,CAAC,IAAwC,EAAsB,EAAE,CAAC,CAAC;QAC5E,KAAK,EAAE,WAAoB;QAC3B,GAAG,IAAI;KACR,CAAC;IAEF,IAAI,EAAE,CAAC,IAAmC,EAAiB,EAAE,CAAC,CAAC;QAC7D,KAAK,EAAE,MAAe;QACtB,GAAG,IAAI;KACR,CAAC;CACH,CAAC"}

package/dist/define-table.d.ts

@@ -0,0 +1,52 @@
+/**
+ * defineTable — table definition wrapper for UnifiedCommerce plugins.
+ *
+ * Wraps Drizzle's pgTable with auto-injected fields:
+ * - id (UUID primary key)
+ * - organizationId (text, NOT NULL) — on top-level tables only
+ * - createdAt, updatedAt (timestamps)
+ * - Org index + composite unique constraints
+ *
+ * Child tables (FK to org-scoped parent) get id + createdAt only.
+ *
+ * Usage:
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *   });
+ */
+import type { ColumnDef } from "./column.js";
+/**
+ * Define a database table with auto-injected UC fields.
+ */
+export declare function defineTable(name: string, columnDefs: Record<string, ColumnDef>, extraConfig?: (table: Record<string, any>) => Record<string, any>): 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=define-table.d.ts.map

package/dist/define-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-table.d.ts","sourceRoot":"","sources":["../src/define-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgE7C;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAErC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsElE"}

package/dist/define-table.js

@@ -0,0 +1,156 @@
+/**
+ * defineTable — table definition wrapper for UnifiedCommerce plugins.
+ *
+ * Wraps Drizzle's pgTable with auto-injected fields:
+ * - id (UUID primary key)
+ * - organizationId (text, NOT NULL) — on top-level tables only
+ * - createdAt, updatedAt (timestamps)
+ * - Org index + composite unique constraints
+ *
+ * Child tables (FK to org-scoped parent) get id + createdAt only.
+ *
+ * Usage:
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *   });
+ */
+import { pgTable, uuid, text, integer, boolean, timestamp, jsonb, index, uniqueIndex, } from "drizzle-orm/pg-core";
+import { getTableColumns } from "drizzle-orm";
+function hasOrgColumn(table) {
+    if (!table || typeof table !== "object")
+        return false;
+    try {
+        const cols = getTableColumns(table);
+        return "organizationId" in cols;
+    }
+    catch {
+        return false;
+    }
+}
+function toSnake(name) {
+    return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function mapColumn(name, def) {
+    const sn = toSnake(name);
+    switch (def._type) {
+        case "text": {
+            let c = def.enum ? text(sn, { enum: def.enum }) : text(sn);
+            if (def.default !== undefined)
+                c = c.default(def.default);
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+        case "integer": {
+            let c = integer(sn);
+            if (def.default !== undefined)
+                c = c.default(def.default);
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+        case "boolean": {
+            let c = boolean(sn);
+            if (def.default !== undefined)
+                c = c.default(def.default);
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+        case "uuid": {
+            let c = uuid(sn);
+            if (def.references) {
+                const refCols = getTableColumns(def.references);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                c = c.references(() => refCols.id, { onDelete: "cascade" });
+            }
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+        case "timestamp": {
+            let c = timestamp(sn, { withTimezone: true });
+            if (def.default === "now")
+                c = c.defaultNow();
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+        case "json": {
+            let c = jsonb(sn);
+            if (def.default !== undefined)
+                c = c.default(def.default);
+            if (!def.optional)
+                c = c.notNull();
+            return c;
+        }
+    }
+}
+/**
+ * Define a database table with auto-injected UC fields.
+ */
+export function defineTable(name, columnDefs, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+extraConfig) {
+    // Detect child table: any UUID column references an org-scoped parent?
+    let isChild = false;
+    for (const def of Object.values(columnDefs)) {
+        if (def._type === "uuid" && def.references && hasOrgColumn(def.references)) {
+            isChild = true;
+            break;
+        }
+    }
+    // Map user columns to Drizzle builders
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const cols = {};
+    const uniqueCols = [];
+    for (const [colName, def] of Object.entries(columnDefs)) {
+        cols[colName] = mapColumn(colName, def);
+        if ("unique" in def && def.unique) {
+            uniqueCols.push(colName);
+        }
+    }
+    // Build full column set with auto-injected fields
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const allColumns = {
+        id: uuid("id").defaultRandom().primaryKey(),
+    };
+    if (!isChild) {
+        allColumns.organizationId = text("organization_id").notNull();
+    }
+    Object.assign(allColumns, cols);
+    allColumns.createdAt = timestamp("created_at", { withTimezone: true })
+        .defaultNow()
+        .notNull();
+    if (!isChild) {
+        allColumns.updatedAt = timestamp("updated_at", { withTimezone: true })
+            .defaultNow()
+            .notNull();
+    }
+    // Create pgTable with indexes
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const table = pgTable(name, allColumns, (t) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const indexes = {};
+        if (!isChild) {
+            indexes.orgIdx = index(`idx_${name}_org`).on(t.organizationId);
+            for (const colName of uniqueCols) {
+                const sn = toSnake(colName);
+                indexes[`${colName}Unique`] = uniqueIndex(`${name}_org_${sn}_unique`)
+                    .on(t.organizationId, t[colName]);
+            }
+        }
+        if (extraConfig)
+            Object.assign(indexes, extraConfig(t));
+        return indexes;
+    });
+    // Mark for scoped DB proxy
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    table.__ucOrgScoped = !isChild;
+    return table;
+}
+//# sourceMappingURL=define-table.js.map

package/dist/define-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-table.js","sourceRoot":"","sources":["../src/define-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,KAAK,EACL,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,eAAe,CAAC,KAA8C,CAAC,CAAC;QAC7E,OAAO,gBAAgB,IAAI,IAAI,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,8DAA8D;AAC9D,SAAS,SAAS,CAAC,IAAY,EAAE,GAAc;IAC7C,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,QAAQ,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAA6B,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpF,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAa,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAa,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YACpB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAa,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,UAAmD,CAAC,CAAC;gBACzF,8DAA8D;gBAC9D,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAE,OAAe,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAa,CAAC;YACnF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK;gBAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAc,CAAC;YAC1D,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAa,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAc,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,UAAqC;AACrC,8DAA8D;AAC9D,WAAiE;IAEjE,uEAAuE;IACvE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3E,OAAO,GAAG,IAAI,CAAC;YACf,MAAM;QACR,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,8DAA8D;IAC9D,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,8DAA8D;IAC9D,MAAM,UAAU,GAAwB;QACtC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE;KAC5C,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEhC,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;SACnE,UAAU,EAAE;SACZ,OAAO,EAAE,CAAC;IAEb,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;aACnE,UAAU,EAAE;aACZ,OAAO,EAAE,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,8DAA8D;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,UAAiB,EAAE,CAAC,CAAM,EAAE,EAAE;QACxD,8DAA8D;QAC9D,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;YAE/D,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;gBACjC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,CAAC,GAAG,OAAO,QAAQ,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,QAAQ,EAAE,SAAS,CAAC;qBAClE,EAAE,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,WAAW;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,8DAA8D;IAC7D,KAAa,CAAC,aAAa,GAAG,CAAC,OAAO,CAAC;IAExC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @porulle/db — single import for all database work.
+ *
+ * Plugin developers import everything from here instead of drizzle-orm directly.
+ * Drizzle is an implementation detail — this package controls the surface.
+ *
+ *   import { defineTable, column, eq, and, desc, sql } from "@porulle/db";
+ */
+export { defineTable } from "./define-table.js";
+export { column } from "./column.js";
+export type { ColumnDef } from "./column.js";
+export { eq, ne, gt, gte, lt, lte, and, or, not, like, ilike, notLike, inArray, notInArray, between, notBetween, isNull, isNotNull, exists, notExists, sql, asc, desc, count, sum, avg, min, max, countDistinct, sumDistinct, avgDistinct, getTableColumns, } from "drizzle-orm";
+export { pgTable, index, uniqueIndex, check, } from "drizzle-orm/pg-core";
+export type { PgTable, PgDatabase, PgQueryResultHKT, } from "drizzle-orm/pg-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACL,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,UAAU,EACV,OAAO,EACP,UAAU,EACV,MAAM,EACN,SAAS,EACT,MAAM,EACN,SAAS,EACT,GAAG,EACH,GAAG,EACH,IAAI,EACJ,KAAK,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAK,GACN,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,OAAO,EACP,UAAU,EACV,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @porulle/db — single import for all database work.
+ *
+ * Plugin developers import everything from here instead of drizzle-orm directly.
+ * Drizzle is an implementation detail — this package controls the surface.
+ *
+ *   import { defineTable, column, eq, and, desc, sql } from "@porulle/db";
+ */
+// ─── UC Abstractions ──────────────────────────────────────────────────
+export { defineTable } from "./define-table.js";
+export { column } from "./column.js";
+// ─── Drizzle Query Operators (re-exported) ────────────────────────────
+export { eq, ne, gt, gte, lt, lte, and, or, not, like, ilike, notLike, inArray, notInArray, between, notBetween, isNull, isNotNull, exists, notExists, sql, asc, desc, count, sum, avg, min, max, countDistinct, sumDistinct, avgDistinct, getTableColumns, } from "drizzle-orm";
+// ─── Drizzle PG-Specific (re-exported) ───────────────────────────────
+export { pgTable, index, uniqueIndex, check, } from "drizzle-orm/pg-core";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,yEAAyE;AACzE,OAAO,EACL,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,GAAG,EACH,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,UAAU,EACV,OAAO,EACP,UAAU,EACV,MAAM,EACN,SAAS,EACT,MAAM,EACN,SAAS,EACT,GAAG,EACH,GAAG,EACH,IAAI,EACJ,KAAK,EACL,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,wEAAwE;AACxE,OAAO,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAK,GACN,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@porulle/db",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    }
+  },
+  "scripts": {
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "backfill-order-seq": "bun run ./scripts/backfill-order-seq.ts",
+    "backfill-inventory-org-id": "bun run ./scripts/backfill-inventory-org-id.ts",
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@porulle/core": "workspace:*",
+    "drizzle-orm": "^0.45.1",
+    "postgres": "^3.4.7"
+  },
+  "devDependencies": {
+    "@repo/typescript-config": "*",
+    "@types/node": "^24.5.2",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "description": "The database surface plugins use instead of importing Drizzle directly.",
+  "homepage": "https://porulle-docs.vercel.app",
+  "bugs": {
+    "url": "https://github.com/asyncdotengineering/porulle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyncdotengineering/porulle.git",
+    "directory": "packages/db"
+  },
+  "author": "Porulle contributors"
+}

package/src/column.ts

@@ -0,0 +1,93 @@
+/**
+ * Column definition helpers for defineTable.
+ *
+ * These produce config objects that defineTable maps to Drizzle column builders.
+ * Plugin developers use these instead of importing from drizzle-orm/pg-core directly.
+ *
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *     status: column.text({ enum: ["active", "disabled"], default: "active" }),
+ *   });
+ */
+
+export interface TextColumnDef {
+  readonly _type: "text";
+  unique?: boolean;
+  optional?: boolean;
+  enum?: readonly string[];
+  default?: string;
+}
+
+export interface IntegerColumnDef {
+  readonly _type: "integer";
+  unique?: boolean;
+  optional?: boolean;
+  default?: number;
+}
+
+export interface BooleanColumnDef {
+  readonly _type: "boolean";
+  optional?: boolean;
+  default?: boolean;
+}
+
+export interface UuidColumnDef {
+  readonly _type: "uuid";
+  optional?: boolean;
+  references?: unknown; // PgTable reference for FK detection
+}
+
+export interface TimestampColumnDef {
+  readonly _type: "timestamp";
+  optional?: boolean;
+  default?: "now";
+}
+
+export interface JsonColumnDef {
+  readonly _type: "json";
+  optional?: boolean;
+  default?: unknown;
+}
+
+export type ColumnDef =
+  | TextColumnDef
+  | IntegerColumnDef
+  | BooleanColumnDef
+  | UuidColumnDef
+  | TimestampColumnDef
+  | JsonColumnDef;
+
+export const column = {
+  text: (opts?: Omit<TextColumnDef, "_type">): TextColumnDef => ({
+    _type: "text" as const,
+    ...opts,
+  }),
+
+  integer: (opts?: Omit<IntegerColumnDef, "_type">): IntegerColumnDef => ({
+    _type: "integer" as const,
+    ...opts,
+  }),
+
+  boolean: (opts?: Omit<BooleanColumnDef, "_type">): BooleanColumnDef => ({
+    _type: "boolean" as const,
+    ...opts,
+  }),
+
+  uuid: (opts?: Omit<UuidColumnDef, "_type">): UuidColumnDef => ({
+    _type: "uuid" as const,
+    ...opts,
+  }),
+
+  timestamp: (opts?: Omit<TimestampColumnDef, "_type">): TimestampColumnDef => ({
+    _type: "timestamp" as const,
+    ...opts,
+  }),
+
+  json: (opts?: Omit<JsonColumnDef, "_type">): JsonColumnDef => ({
+    _type: "json" as const,
+    ...opts,
+  }),
+};

package/src/define-table.test.ts

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest";
+import { getTableColumns } from "drizzle-orm";
+import { defineTable } from "./define-table.js";
+import { column } from "./column.js";
+
+describe("defineTable", () => {
+  it("auto-injects id, organizationId, createdAt, updatedAt on top-level tables", () => {
+    const table = defineTable("test_products", {
+      name: column.text(),
+      price: column.integer(),
+    });
+
+    const cols = getTableColumns(table);
+    expect(cols).toHaveProperty("id");
+    expect(cols).toHaveProperty("organizationId");
+    expect(cols).toHaveProperty("createdAt");
+    expect(cols).toHaveProperty("updatedAt");
+    expect(cols).toHaveProperty("name");
+    expect(cols).toHaveProperty("price");
+  });
+
+  it("marks top-level tables as __ucOrgScoped", () => {
+    const table = defineTable("test_items", {
+      title: column.text(),
+    });
+    expect((table as Record<string, unknown>).__ucOrgScoped).toBe(true);
+  });
+
+  it("detects child tables (FK to org-scoped parent) and skips organizationId", () => {
+    const parent = defineTable("test_parent", {
+      slug: column.text({ unique: true }),
+    });
+
+    const child = defineTable("test_child", {
+      parentId: column.uuid({ references: parent }),
+      note: column.text({ optional: true }),
+    });
+
+    const parentCols = getTableColumns(parent);
+    const childCols = getTableColumns(child);
+
+    // Parent has organizationId
+    expect(parentCols).toHaveProperty("organizationId");
+    // Child does NOT
+    expect(childCols).not.toHaveProperty("organizationId");
+    // Child has id + createdAt but no updatedAt
+    expect(childCols).toHaveProperty("id");
+    expect(childCols).toHaveProperty("createdAt");
+    expect(childCols).not.toHaveProperty("updatedAt");
+    // Child is not org-scoped
+    expect((child as Record<string, unknown>).__ucOrgScoped).toBe(false);
+  });
+
+  it("supports all column types", () => {
+    const table = defineTable("test_all_types", {
+      name: column.text(),
+      count: column.integer({ default: 0 }),
+      active: column.boolean({ default: true }),
+      data: column.json({ default: {} }),
+      happenedAt: column.timestamp({ optional: true }),
+    });
+
+    const cols = getTableColumns(table);
+    expect(cols).toHaveProperty("name");
+    expect(cols).toHaveProperty("count");
+    expect(cols).toHaveProperty("active");
+    expect(cols).toHaveProperty("data");
+    expect(cols).toHaveProperty("happenedAt");
+  });
+
+  it("supports enum columns", () => {
+    const table = defineTable("test_enum", {
+      status: column.text({ enum: ["active", "disabled", "exhausted"], default: "active" }),
+    });
+
+    const cols = getTableColumns(table);
+    expect(cols).toHaveProperty("status");
+  });
+});

package/src/define-table.ts

@@ -0,0 +1,174 @@
+/**
+ * defineTable — table definition wrapper for UnifiedCommerce plugins.
+ *
+ * Wraps Drizzle's pgTable with auto-injected fields:
+ * - id (UUID primary key)
+ * - organizationId (text, NOT NULL) — on top-level tables only
+ * - createdAt, updatedAt (timestamps)
+ * - Org index + composite unique constraints
+ *
+ * Child tables (FK to org-scoped parent) get id + createdAt only.
+ *
+ * Usage:
+ *   import { defineTable, column } from "@porulle/db";
+ *
+ *   export const giftCards = defineTable("gift_cards", {
+ *     code: column.text({ unique: true }),
+ *     balance: column.integer(),
+ *   });
+ */
+
+import {
+  pgTable,
+  uuid,
+  text,
+  integer,
+  boolean,
+  timestamp,
+  jsonb,
+  index,
+  uniqueIndex,
+} from "drizzle-orm/pg-core";
+import { getTableColumns } from "drizzle-orm";
+import type { ColumnDef } from "./column.js";
+
+function hasOrgColumn(table: unknown): boolean {
+  if (!table || typeof table !== "object") return false;
+  try {
+    const cols = getTableColumns(table as Parameters<typeof getTableColumns>[0]);
+    return "organizationId" in cols;
+  } catch {
+    return false;
+  }
+}
+
+function toSnake(name: string): string {
+  return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function mapColumn(name: string, def: ColumnDef): any {
+  const sn = toSnake(name);
+
+  switch (def._type) {
+    case "text": {
+      let c = def.enum ? text(sn, { enum: def.enum as [string, ...string[]] }) : text(sn);
+      if (def.default !== undefined) c = c.default(def.default) as typeof c;
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+    case "integer": {
+      let c = integer(sn);
+      if (def.default !== undefined) c = c.default(def.default) as typeof c;
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+    case "boolean": {
+      let c = boolean(sn);
+      if (def.default !== undefined) c = c.default(def.default) as typeof c;
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+    case "uuid": {
+      let c = uuid(sn);
+      if (def.references) {
+        const refCols = getTableColumns(def.references as Parameters<typeof getTableColumns>[0]);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        c = c.references(() => (refCols as any).id, { onDelete: "cascade" }) as typeof c;
+      }
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+    case "timestamp": {
+      let c = timestamp(sn, { withTimezone: true });
+      if (def.default === "now") c = c.defaultNow() as typeof c;
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+    case "json": {
+      let c = jsonb(sn);
+      if (def.default !== undefined) c = c.default(def.default) as typeof c;
+      if (!def.optional) c = c.notNull() as typeof c;
+      return c;
+    }
+  }
+}
+
+/**
+ * Define a database table with auto-injected UC fields.
+ */
+export function defineTable(
+  name: string,
+  columnDefs: Record<string, ColumnDef>,
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  extraConfig?: (table: Record<string, any>) => Record<string, any>,
+) {
+  // Detect child table: any UUID column references an org-scoped parent?
+  let isChild = false;
+  for (const def of Object.values(columnDefs)) {
+    if (def._type === "uuid" && def.references && hasOrgColumn(def.references)) {
+      isChild = true;
+      break;
+    }
+  }
+
+  // Map user columns to Drizzle builders
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const cols: Record<string, any> = {};
+  const uniqueCols: string[] = [];
+
+  for (const [colName, def] of Object.entries(columnDefs)) {
+    cols[colName] = mapColumn(colName, def);
+    if ("unique" in def && def.unique) {
+      uniqueCols.push(colName);
+    }
+  }
+
+  // Build full column set with auto-injected fields
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const allColumns: Record<string, any> = {
+    id: uuid("id").defaultRandom().primaryKey(),
+  };
+
+  if (!isChild) {
+    allColumns.organizationId = text("organization_id").notNull();
+  }
+
+  Object.assign(allColumns, cols);
+
+  allColumns.createdAt = timestamp("created_at", { withTimezone: true })
+    .defaultNow()
+    .notNull();
+
+  if (!isChild) {
+    allColumns.updatedAt = timestamp("updated_at", { withTimezone: true })
+      .defaultNow()
+      .notNull();
+  }
+
+  // Create pgTable with indexes
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const table = pgTable(name, allColumns as any, (t: any) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const indexes: Record<string, any> = {};
+
+    if (!isChild) {
+      indexes.orgIdx = index(`idx_${name}_org`).on(t.organizationId);
+
+      for (const colName of uniqueCols) {
+        const sn = toSnake(colName);
+        indexes[`${colName}Unique`] = uniqueIndex(`${name}_org_${sn}_unique`)
+          .on(t.organizationId, t[colName]);
+      }
+    }
+
+    if (extraConfig) Object.assign(indexes, extraConfig(t));
+    return indexes;
+  });
+
+  // Mark for scoped DB proxy
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  (table as any).__ucOrgScoped = !isChild;
+
+  return table;
+}

package/src/index.ts

@@ -0,0 +1,64 @@
+/**
+ * @porulle/db — single import for all database work.
+ *
+ * Plugin developers import everything from here instead of drizzle-orm directly.
+ * Drizzle is an implementation detail — this package controls the surface.
+ *
+ *   import { defineTable, column, eq, and, desc, sql } from "@porulle/db";
+ */
+
+// ─── UC Abstractions ──────────────────────────────────────────────────
+export { defineTable } from "./define-table.js";
+export { column } from "./column.js";
+export type { ColumnDef } from "./column.js";
+
+// ─── Drizzle Query Operators (re-exported) ────────────────────────────
+export {
+  eq,
+  ne,
+  gt,
+  gte,
+  lt,
+  lte,
+  and,
+  or,
+  not,
+  like,
+  ilike,
+  notLike,
+  inArray,
+  notInArray,
+  between,
+  notBetween,
+  isNull,
+  isNotNull,
+  exists,
+  notExists,
+  sql,
+  asc,
+  desc,
+  count,
+  sum,
+  avg,
+  min,
+  max,
+  countDistinct,
+  sumDistinct,
+  avgDistinct,
+  getTableColumns,
+} from "drizzle-orm";
+
+// ─── Drizzle PG-Specific (re-exported) ───────────────────────────────
+export {
+  pgTable,
+  index,
+  uniqueIndex,
+  check,
+} from "drizzle-orm/pg-core";
+
+// ─── Drizzle Types (re-exported for advanced use) ─────────────────────
+export type {
+  PgTable,
+  PgDatabase,
+  PgQueryResultHKT,
+} from "drizzle-orm/pg-core";