@space-arch/util-drizzle 1.7.0

package/README.md

@@ -0,0 +1,61 @@
+# @space-arch/util-drizzle
+
+Utility functions for Drizzle ORM.
+
+## Installation
+
+```bash
+npm install @space-arch/util-drizzle
+# or
+pnpm add @space-arch/util-drizzle
+```
+
+## Features
+
+- 🐻 **Lazy Initialization**: Create Drizzle instances only when needed
+- 🆔 **UUIDv7 Support**: Built-in column types for UUIDv7 with automatic generation
+
+## Usage
+
+### Lazy Drizzle
+
+Create a lazily initialized Drizzle instance. Useful for serverless environments where you need to resolve connection details at runtime.
+
+```typescript
+import { drizzle } from 'drizzle-orm/postgres-js';
+import postgres from 'postgres';
+
+import { lazyDrizzle } from '@space-arch/util-drizzle';
+
+const db = lazyDrizzle(
+  (url) => drizzle(postgres(url)),
+  () => process.env.DATABASE_URL
+);
+
+// Before using the db:
+process.env['DATABASE_URL'] = await resolveConnectionString();
+
+// Connection is established only when first query is executed
+const users = await db.select().from(usersTable);
+```
+
+### UUIDv7 Column Types
+
+Drizzle column types for UUIDv7 with automatic generation.
+
+```typescript
+import { pgTable } from 'drizzle-orm/pg-core';
+import { uuidV7, uuidV7Nullable } from '@space-arch/util-drizzle';
+
+const users = pgTable('users', {
+  id: uuidV7('id').primaryKey(),
+  parentId: uuidV7Nullable('parent_id')
+});
+```
+
+- `uuidV7()` - Not null with automatic default value generation
+- `uuidV7Nullable()` - Nullable without default value
+
+## Contributing
+
+This package is part of the [Space Architects monorepo](../../README.md).

package/dist/index.cjs

@@ -0,0 +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;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { lazyDrizzle } from './lib/lazy-drizzle.js';
+export { uuidV7, uuidV7Nullable } from './lib/uuidv7.js';
+//# 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,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

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

package/dist/lib/lazy-drizzle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Create lazily initialized drizzle proxy
+ *
+ * Allows for configuring the connection before creating the instance.
+ * For example, in Lambda, you might want to resolve the connection url secret and set
+ * it to the env before accessing the db.
+ *
+ * @example
+ * ```ts
+ * // drizzle is not initialized here
+ * const db = lazyDrizzle(drizzle, () => process.env.DATABASE_URL);
+ *
+ * process.env['DATABASE_URL'] = await getConnectionUrl();
+ *
+ * // drizzle will be initialized only here:
+ * const [user] = await db.select().from(users).where(eq(users.id, 1));
+ * ```
+ *
+ * @param drizzleFactory - A function that creates a drizzle instance
+ * @param connectionUrl - A function that returns the connection url
+ */
+export declare const lazyDrizzle: <T extends object>(drizzleFactory: (connectionUrl: string) => T, connectionUrl: () => string) => T;
+//# sourceMappingURL=lazy-drizzle.d.ts.map

package/dist/lib/lazy-drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-drizzle.d.ts","sourceRoot":"","sources":["../../src/lib/lazy-drizzle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAC1C,gBAAgB,CAAC,aAAa,EAAE,MAAM,KAAK,CAAC,EAC5C,eAAe,MAAM,MAAM,MAuC5B,CAAC"}

package/dist/lib/uuidv7.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A custom type for UUIDv7 columns. Not null
+ */
+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<{
+    name: string;
+    dataType: "custom";
+    columnType: "PgCustomColumn";
+    data: string;
+    driverParam: unknown;
+    enumValues: undefined;
+}>;
+//# sourceMappingURL=uuidv7.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@space-arch/util-drizzle",
+  "version": "1.7.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@space-arch/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "name": "util-drizzle",
+    "tags": [
+      "npm:public"
+    ]
+  },
+  "peerDependencies": {
+    "uuid": "^11.1.0",
+    "drizzle-orm": "^0.44.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/alexandr2110pro/space-arch#readme",
+  "bugs": {
+    "url": "https://github.com/alexandr2110pro/space-arch/issues"
+  },
+  "author": "Space Architects",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alexandr2110pro/space-arch.git",
+    "directory": "packages/util/drizzle"
+  },
+  "keywords": [
+    "drizzle",
+    "drizzle-orm",
+    "space-arch",
+    "util",
+    "uuidv7",
+    "lazy"
+  ]
+}