@space-arch/util-drizzle 1.7.0 → 2.0.0

package/README.md

@@ -41,20 +41,20 @@ const users = await db.select().from(usersTable);
 
 ### UUIDv7 Column Types
 
-Drizzle column types for UUIDv7 with automatic generation.
+PostgreSQL `uuid` columns auto-filled with UUIDv7 on insert. Nullable by default — chain `.notNull()` / `.primaryKey()` as you would with drizzle's built-in `uuid()`.
 
 ```typescript
 import { pgTable } from 'drizzle-orm/pg-core';
-import { uuidV7, uuidV7Nullable } from '@space-arch/util-drizzle';
+import { uuidV7 } from '@space-arch/util-drizzle';
 
 const users = pgTable('users', {
-  id: uuidV7('id').primaryKey(),
-  parentId: uuidV7Nullable('parent_id')
+  id:       uuidV7().primaryKey(),           // PK, auto-filled on insert
+  tenantId: uuidV7('tenant_id').notNull(),   // required FK
+  parentId: uuidV7('parent_id'),             // nullable FK
 });
 ```
 
-- `uuidV7()` - Not null with automatic default value generation
-- `uuidV7Nullable()` - Nullable without default value
+The default is applied at insert time by the drizzle runtime — it does NOT emit a SQL `DEFAULT` clause in migrations. For a raw nullable uuid with no auto-default, use drizzle's built-in `uuid()` directly.
 
 ## Contributing
 

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("drizzle-orm/pg-core"),i=require("uuid"),d=(r,s)=>{let o=null;const u=()=>(o||(o=r(s())),o);return new Proxy({},{get(t,n){const e=u(),c=e[n];return typeof c=="function"?c.bind(e):c},getPrototypeOf(){const t=u();return Object.getPrototypeOf(t)},has(t,n){const e=u();return n in e},ownKeys(){const t=u();return Reflect.ownKeys(t)},getOwnPropertyDescriptor(t,n){const e=u();return Reflect.getOwnPropertyDescriptor(e,n)}})},a=r=>l.customType({dataType:()=>"uuid"})(r).notNull().$defaultFn(()=>i.v7()),y=r=>l.customType({dataType:()=>"uuid"})(r);exports.lazyDrizzle=d;exports.uuidV7=a;exports.uuidV7Nullable=y;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("drizzle-orm/pg-core"),l=require("uuid"),y=(n,i)=>{let u=null;const r=()=>(u||(u=n(i())),u);return new Proxy({},{get(t,o){const e=r(),c=e[o];return typeof c=="function"?c.bind(e):c},getPrototypeOf(){const t=r();return Object.getPrototypeOf(t)},has(t,o){const e=r();return o in e},ownKeys(){const t=r();return Reflect.ownKeys(t)},getOwnPropertyDescriptor(t,o){const e=r();return Reflect.getOwnPropertyDescriptor(e,o)}})},s=d.customType({dataType:()=>"uuid"}),g=n=>(n===void 0?s():s(n)).$defaultFn(()=>l.v7());exports.lazyDrizzle=y;exports.uuidV7=g;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { lazyDrizzle } from './lib/lazy-drizzle.js';
-export { uuidV7, uuidV7Nullable } from './lib/uuidv7.js';
+export { uuidV7 } from './lib/uuidv7.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,37 +1,34 @@
-import { customType as s } from "drizzle-orm/pg-core";
-import { v7 as l } from "uuid";
-const a = (r, d) => {
+import { customType as i } from "drizzle-orm/pg-core";
+import { v7 as p } from "uuid";
+const l = (n, d) => {
   let u = null;
-  const o = () => (u || (u = r(d())), u);
+  const r = () => (u || (u = n(d())), u);
   return new Proxy({}, {
-    get(t, n) {
-      const e = o(), c = e[n];
+    get(t, o) {
+      const e = r(), c = e[o];
       return typeof c == "function" ? c.bind(e) : c;
     },
     getPrototypeOf() {
-      const t = o();
+      const t = r();
       return Object.getPrototypeOf(t);
     },
-    has(t, n) {
-      const e = o();
-      return n in e;
+    has(t, o) {
+      const e = r();
+      return o in e;
     },
     ownKeys() {
-      const t = o();
+      const t = r();
       return Reflect.ownKeys(t);
     },
-    getOwnPropertyDescriptor(t, n) {
-      const e = o();
-      return Reflect.getOwnPropertyDescriptor(e, n);
+    getOwnPropertyDescriptor(t, o) {
+      const e = r();
+      return Reflect.getOwnPropertyDescriptor(e, o);
     }
   });
-}, y = (r) => s({
+}, s = i({
   dataType: () => "uuid"
-})(r).notNull().$defaultFn(() => l()), b = (r) => s({
-  dataType: () => "uuid"
-})(r);
+}), b = (n) => (n === void 0 ? s() : s(n)).$defaultFn(() => p());
 export {
-  a as lazyDrizzle,
-  y as uuidV7,
-  b as uuidV7Nullable
+  l as lazyDrizzle,
+  b as uuidV7
 };

package/dist/lib/uuidv7.d.ts

@@ -1,20 +1,30 @@
 /**
- * A custom type for UUIDv7 columns. Not null
+ * Drizzle column builder for a PostgreSQL `uuid` column auto-filled with a
+ * UUIDv7 on insert (via `uuid.v7()` through `$defaultFn`).
+ *
+ * Nullable by default — chain `.notNull()`, `.primaryKey()`, etc. as with
+ * drizzle's built-in `uuid()`.
+ *
+ * The default is applied at insert time in the application layer; it does
+ * NOT emit a SQL `DEFAULT` clause in migrations.
+ *
+ * Nullable-FK caveat: omitting the field on insert triggers `$defaultFn` and
+ * produces a UUID pointing nowhere. For a truly raw nullable uuid, use
+ * drizzle's built-in `uuid()` from `drizzle-orm/pg-core`.
+ *
+ * @example
+ * const users = pgTable('users', {
+ *   id:       uuidV7().primaryKey(),            // PK, auto-filled
+ *   tenantId: uuidV7('tenant_id').notNull(),    // required FK
+ *   parentId: uuidV7('parent_id'),              // nullable FK
+ * });
  */
-export declare const uuidV7: (name: string) => import('drizzle-orm').HasRuntimeDefault<import('drizzle-orm').HasDefault<import('drizzle-orm').NotNull<import('drizzle-orm/pg-core').PgCustomColumnBuilder<import('drizzle-orm/pg-core').ConvertCustomConfig<string, {
-    data: string;
-    notNull: true;
-    default: true;
-}>>>>>;
-/**
- * A custom type for UUIDv7 columns. Nullable
- */
-export declare const uuidV7Nullable: (name: string) => import('drizzle-orm/pg-core').PgCustomColumnBuilder<{
+export declare const uuidV7: (name?: string) => import('drizzle-orm').HasRuntimeDefault<import('drizzle-orm').HasDefault<import('drizzle-orm/pg-core').PgCustomColumnBuilder<{
     name: string;
     dataType: "custom";
     columnType: "PgCustomColumn";
     data: string;
     driverParam: unknown;
     enumValues: undefined;
-}>;
+}>>>;
 //# sourceMappingURL=uuidv7.d.ts.map

package/dist/lib/uuidv7.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuidv7.d.ts","sourceRoot":"","sources":["../../src/lib/uuidv7.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM;UACd,MAAM;aAAW,IAAI;aAAW,IAAI;MAI9B,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM;;;;;;;EAGjC,CAAC"}
+{"version":3,"file":"uuidv7.d.ts","sourceRoot":"","sources":["../../src/lib/uuidv7.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM;;;;;;;IAC2C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space-arch/util-drizzle",
-  "version": "1.7.0",
+  "version": "2.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",