ras-stack 0.11.0 → 0.13.0

package/README.md

@@ -121,6 +121,22 @@ const database = openDrizzleSqlite({
 
 Applications retain their schema, migrations, database path, repositories, transactions, and driver selection. Dual-database applications can use `openSqliteClient()` and `configureSqlite()` beneath their own wrapper without forcing PostgreSQL through a shared database interface.
 
+The PostgreSQL entrypoint applies the same boundary to Postgres.js and Drizzle while returning both native objects:
+
+```ts
+import { databaseTarget } from 'ras-stack/database'
+import { closeDrizzlePostgres, migrateDrizzlePostgres, openDrizzlePostgres } from 'ras-stack/database/postgres'
+
+const target = databaseTarget({ databaseUrl: process.env.DATABASE_URL, sqliteFile })
+if (target.provider === 'postgres') {
+  const connection = openDrizzlePostgres({ url: target.url, schema })
+  await migrateDrizzlePostgres(connection, postgresMigrationsFolder)
+  await closeDrizzlePostgres(connection)
+}
+```
+
+The package does not make SQLite and PostgreSQL queries look identical. Applications keep driver-specific transaction and compatibility behavior while sharing target validation, pool defaults, numeric parsing, migrations, credential-safe display URLs, and shutdown.
+
 ## Realtime updates
 
 Applications choose their channel names, authorize subscriptions, and define payloads. `ras-stack` handles Centrifugo's HTTP publication, signed tokens, and repeated browser lifecycle mechanics:
@@ -192,6 +208,17 @@ await startTusUpload(upload)
 
 Applications retain ownership of email templates, missing-email behavior, upload metadata, authorization, quotas, and completion processing.
 
+Stateful development servers can reuse one typed resource across HMR without application-specific `globalThis` casts:
+
+```ts
+import { clearGlobalSingleton, globalAsyncSingleton } from 'ras-stack/server'
+
+export const app = () => globalAsyncSingleton('my-app.instance', createApp)
+export const resetApp = () => clearGlobalSingleton('my-app.instance', (instance) => instance.close())
+```
+
+Rejected async initialization removes only its own pending value so a later request can retry. Clearing deletes the key before awaiting initialization or disposal, allowing replacement startup without reusing a closing resource.
+
 ## Shared project configuration
 
 Extend the supplied configuration and override anything specific to the application:

package/dist/database/index.d.ts

@@ -1,4 +1,4 @@
-import { type URL } from 'node:url';
+import { URL } from 'node:url';
 export type BundledDirectoryOptions = {
     developmentUrl: URL;
     production: boolean;
@@ -6,3 +6,14 @@ export type BundledDirectoryOptions = {
     name: string;
 };
 export declare function bundledDirectory(options: BundledDirectoryOptions): string;
+export type DatabaseTarget = {
+    provider: 'sqlite';
+    file: string;
+} | {
+    provider: 'postgres';
+    url: string;
+};
+export declare function databaseTarget(options: {
+    databaseUrl?: string;
+    sqliteFile: string;
+}): DatabaseTarget;

package/dist/database/index.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, URL } from 'node:url';
 export function bundledDirectory(options) {
     if (!options.production)
         return fileURLToPath(options.developmentUrl);
@@ -8,4 +8,14 @@ export function bundledDirectory(options) {
         throw new Error('production entrypoint is required to resolve a bundled directory');
     return path.join(path.dirname(entry), options.name);
 }
+export function databaseTarget(options) {
+    const configured = options.databaseUrl?.trim();
+    if (!configured)
+        return { provider: 'sqlite', file: options.sqliteFile };
+    const url = new URL(configured);
+    if (url.protocol !== 'postgres:' && url.protocol !== 'postgresql:') {
+        throw new Error('database URL must use a postgres:// or postgresql:// URL');
+    }
+    return { provider: 'postgres', url: configured };
+}
 //# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAY,MAAM,UAAU,CAAA;AASlD,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IAC/F,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;AACrD,CAAC","sourcesContent":["import path from 'node:path'\nimport { fileURLToPath, type URL } from 'node:url'\n\nexport type BundledDirectoryOptions = {\n  developmentUrl: URL\n  production: boolean\n  productionEntry?: string\n  name: string\n}\n\nexport function bundledDirectory(options: BundledDirectoryOptions) {\n  if (!options.production) return fileURLToPath(options.developmentUrl)\n  const entry = options.productionEntry ?? process.argv[1]\n  if (!entry) throw new Error('production entrypoint is required to resolve a bundled directory')\n  return path.join(path.dirname(entry), options.name)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAS7C,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IAC/F,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;AACrD,CAAC;AAID,MAAM,UAAU,cAAc,CAAC,OAAqD;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAA;IAC9C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,CAAA;IACxE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAA;IAC/B,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC7E,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,CAAA;AAClD,CAAC","sourcesContent":["import path from 'node:path'\nimport { fileURLToPath, URL } from 'node:url'\n\nexport type BundledDirectoryOptions = {\n  developmentUrl: URL\n  production: boolean\n  productionEntry?: string\n  name: string\n}\n\nexport function bundledDirectory(options: BundledDirectoryOptions) {\n  if (!options.production) return fileURLToPath(options.developmentUrl)\n  const entry = options.productionEntry ?? process.argv[1]\n  if (!entry) throw new Error('production entrypoint is required to resolve a bundled directory')\n  return path.join(path.dirname(entry), options.name)\n}\n\nexport type DatabaseTarget = { provider: 'sqlite'; file: string } | { provider: 'postgres'; url: string }\n\nexport function databaseTarget(options: { databaseUrl?: string; sqliteFile: string }): DatabaseTarget {\n  const configured = options.databaseUrl?.trim()\n  if (!configured) return { provider: 'sqlite', file: options.sqliteFile }\n  const url = new URL(configured)\n  if (url.protocol !== 'postgres:' && url.protocol !== 'postgresql:') {\n    throw new Error('database URL must use a postgres:// or postgresql:// URL')\n  }\n  return { provider: 'postgres', url: configured }\n}\n"]}

package/dist/database/postgres.d.ts

@@ -0,0 +1,16 @@
+import { type PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import postgres, { type Sql } from 'postgres';
+export type PostgresClientOptions = NonNullable<Parameters<typeof postgres>[1]>;
+export type OpenDrizzlePostgresOptions<TSchema extends Record<string, unknown>> = {
+    url: string;
+    schema: TSchema;
+    client?: PostgresClientOptions;
+};
+export type DrizzlePostgresConnection<TSchema extends Record<string, unknown>> = {
+    database: PostgresJsDatabase<TSchema>;
+    client: Sql;
+};
+export declare function openDrizzlePostgres<TSchema extends Record<string, unknown>>(options: OpenDrizzlePostgresOptions<TSchema>): DrizzlePostgresConnection<TSchema>;
+export declare function migrateDrizzlePostgres<TSchema extends Record<string, unknown>>(connection: DrizzlePostgresConnection<TSchema>, migrationsFolder: string): Promise<void>;
+export declare function closeDrizzlePostgres(connection: Pick<DrizzlePostgresConnection<Record<string, unknown>>, 'client'>, timeout?: number): Promise<void>;
+export declare function redactedPostgresUrl(source: string): string;

package/dist/database/postgres.js

@@ -0,0 +1,29 @@
+import { drizzle } from 'drizzle-orm/postgres-js';
+import { migrate } from 'drizzle-orm/postgres-js/migrator';
+import postgres, {} from 'postgres';
+export function openDrizzlePostgres(options) {
+    const client = postgres(options.url, {
+        max: 10,
+        onnotice: () => undefined,
+        types: {
+            bigint: { to: 20, from: [20], serialize: (value) => String(value), parse: Number },
+            numeric: { to: 1700, from: [1700], serialize: (value) => String(value), parse: Number },
+        },
+        ...options.client,
+    });
+    const database = drizzle(client, { schema: options.schema });
+    return { database, client };
+}
+export async function migrateDrizzlePostgres(connection, migrationsFolder) {
+    await migrate(connection.database, { migrationsFolder });
+}
+export async function closeDrizzlePostgres(connection, timeout = 5) {
+    await connection.client.end({ timeout });
+}
+export function redactedPostgresUrl(source) {
+    const url = new URL(source);
+    url.username = '';
+    url.password = '';
+    return url.toString();
+}
+//# sourceMappingURL=postgres.js.map

package/dist/database/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/database/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA2B,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAA;AAC1D,OAAO,QAAQ,EAAE,EAAY,MAAM,UAAU,CAAA;AAe7C,MAAM,UAAU,mBAAmB,CACjC,OAA4C;IAE5C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE;QACnC,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,KAAK,EAAE;YACL,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;YAC1F,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;SAChG;QACD,GAAG,OAAO,CAAC,MAAM;KAClB,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA8C,EAC9C,gBAAwB;IAExB,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAA8E,EAAE,OAAO,GAAG,CAAC;IACpI,MAAM,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IAC3B,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAA;IACjB,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAA;IACjB,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AACvB,CAAC","sourcesContent":["import { drizzle, type PostgresJsDatabase } from 'drizzle-orm/postgres-js'\nimport { migrate } from 'drizzle-orm/postgres-js/migrator'\nimport postgres, { type Sql } from 'postgres'\n\nexport type PostgresClientOptions = NonNullable<Parameters<typeof postgres>[1]>\n\nexport type OpenDrizzlePostgresOptions<TSchema extends Record<string, unknown>> = {\n  url: string\n  schema: TSchema\n  client?: PostgresClientOptions\n}\n\nexport type DrizzlePostgresConnection<TSchema extends Record<string, unknown>> = {\n  database: PostgresJsDatabase<TSchema>\n  client: Sql\n}\n\nexport function openDrizzlePostgres<TSchema extends Record<string, unknown>>(\n  options: OpenDrizzlePostgresOptions<TSchema>,\n): DrizzlePostgresConnection<TSchema> {\n  const client = postgres(options.url, {\n    max: 10,\n    onnotice: () => undefined,\n    types: {\n      bigint: { to: 20, from: [20], serialize: (value: number) => String(value), parse: Number },\n      numeric: { to: 1700, from: [1700], serialize: (value: number) => String(value), parse: Number },\n    },\n    ...options.client,\n  })\n  const database = drizzle(client, { schema: options.schema })\n  return { database, client }\n}\n\nexport async function migrateDrizzlePostgres<TSchema extends Record<string, unknown>>(\n  connection: DrizzlePostgresConnection<TSchema>,\n  migrationsFolder: string,\n) {\n  await migrate(connection.database, { migrationsFolder })\n}\n\nexport async function closeDrizzlePostgres(connection: Pick<DrizzlePostgresConnection<Record<string, unknown>>, 'client'>, timeout = 5) {\n  await connection.client.end({ timeout })\n}\n\nexport function redactedPostgresUrl(source: string) {\n  const url = new URL(source)\n  url.username = ''\n  url.password = ''\n  return url.toString()\n}\n"]}

package/dist/server/index.d.ts

@@ -1,3 +1,4 @@
 export * from './canonical-host.js';
 export * from './health.js';
 export * from './rpc.js';
+export * from './singleton.js';

package/dist/server/index.js

@@ -1,4 +1,5 @@
 export * from './canonical-host.js';
 export * from './health.js';
 export * from './rpc.js';
+export * from './singleton.js';
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA","sourcesContent":["export * from './canonical-host.js'\nexport * from './health.js'\nexport * from './rpc.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA","sourcesContent":["export * from './canonical-host.js'\nexport * from './health.js'\nexport * from './rpc.js'\nexport * from './singleton.js'\n"]}

package/dist/server/singleton.d.ts

@@ -0,0 +1,4 @@
+export declare function globalSingleton<T>(key: string, create: () => T): T;
+export declare function globalAsyncSingleton<T>(key: string, create: () => T | Promise<T>): Promise<T>;
+export declare function peekGlobalSingleton(key: string): unknown;
+export declare function clearGlobalSingleton<T>(key: string, dispose?: (value: Awaited<T>) => void | Promise<void>): Promise<boolean>;

package/dist/server/singleton.js

@@ -0,0 +1,48 @@
+const storeKey = Symbol.for('ras-stack.server.singletons');
+function store() {
+    const target = globalThis;
+    return (target[storeKey] ??= new Map());
+}
+export function globalSingleton(key, create) {
+    const singletons = store();
+    const existing = singletons.get(key);
+    if (existing) {
+        if (existing.kind !== 'sync')
+            throw new Error(`singleton ${key} is asynchronous`);
+        return existing.value;
+    }
+    const value = create();
+    singletons.set(key, { kind: 'sync', value });
+    return value;
+}
+export function globalAsyncSingleton(key, create) {
+    const singletons = store();
+    const existing = singletons.get(key);
+    if (existing) {
+        if (existing.kind !== 'async')
+            throw new Error(`singleton ${key} is synchronous`);
+        return existing.value;
+    }
+    const pending = Promise.resolve().then(create);
+    const guarded = pending.catch((error) => {
+        if (singletons.get(key)?.value === guarded)
+            singletons.delete(key);
+        throw error;
+    });
+    singletons.set(key, { kind: 'async', value: guarded });
+    return guarded;
+}
+export function peekGlobalSingleton(key) {
+    return store().get(key)?.value;
+}
+export async function clearGlobalSingleton(key, dispose) {
+    const singletons = store();
+    if (!singletons.has(key))
+        return false;
+    const value = singletons.get(key)?.value;
+    singletons.delete(key);
+    if (dispose)
+        await dispose(await value);
+    return true;
+}
+//# sourceMappingURL=singleton.js.map

package/dist/server/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/server/singleton.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;AAI1D,SAAS,KAAK;IACZ,MAAM,MAAM,GAAG,UAA6B,CAAA;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,GAAW,EAAE,MAAe;IAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAA;QACjF,OAAO,QAAQ,CAAC,KAAU,CAAA;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,GAAW,EAAE,MAA4B;IAC/E,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC,CAAA;QACjF,OAAO,QAAQ,CAAC,KAAmB,CAAA;IACrC,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC/C,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,OAAO;YAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAClE,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;IACF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACtD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAA;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,GAAW,EAAE,OAAqD;IAC9G,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAU,CAAA;IAC7C,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACtB,IAAI,OAAO;QAAE,MAAM,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA;IACvC,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["const storeKey = Symbol.for('ras-stack.server.singletons')\ntype SingletonEntry = { kind: 'sync' | 'async'; value: unknown }\ntype SingletonGlobal = typeof globalThis & { [storeKey]?: Map<string, SingletonEntry> }\n\nfunction store() {\n  const target = globalThis as SingletonGlobal\n  return (target[storeKey] ??= new Map())\n}\n\nexport function globalSingleton<T>(key: string, create: () => T): T {\n  const singletons = store()\n  const existing = singletons.get(key)\n  if (existing) {\n    if (existing.kind !== 'sync') throw new Error(`singleton ${key} is asynchronous`)\n    return existing.value as T\n  }\n  const value = create()\n  singletons.set(key, { kind: 'sync', value })\n  return value\n}\n\nexport function globalAsyncSingleton<T>(key: string, create: () => T | Promise<T>): Promise<T> {\n  const singletons = store()\n  const existing = singletons.get(key)\n  if (existing) {\n    if (existing.kind !== 'async') throw new Error(`singleton ${key} is synchronous`)\n    return existing.value as Promise<T>\n  }\n  const pending = Promise.resolve().then(create)\n  const guarded = pending.catch((error: unknown) => {\n    if (singletons.get(key)?.value === guarded) singletons.delete(key)\n    throw error\n  })\n  singletons.set(key, { kind: 'async', value: guarded })\n  return guarded\n}\n\nexport function peekGlobalSingleton(key: string): unknown {\n  return store().get(key)?.value\n}\n\nexport async function clearGlobalSingleton<T>(key: string, dispose?: (value: Awaited<T>) => void | Promise<void>) {\n  const singletons = store()\n  if (!singletons.has(key)) return false\n  const value = singletons.get(key)?.value as T\n  singletons.delete(key)\n  if (dispose) await dispose(await value)\n  return true\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",
@@ -42,6 +42,10 @@
       "types": "./dist/database/sqlite.d.ts",
       "default": "./dist/database/sqlite.js"
     },
+    "./database/postgres": {
+      "types": "./dist/database/postgres.d.ts",
+      "default": "./dist/database/postgres.js"
+    },
     "./policy": {
       "types": "./dist/policy/index.d.ts",
       "default": "./dist/policy/index.js"
@@ -112,6 +116,7 @@
     "oxfmt": "^0.61.0",
     "oxlint": "^1.74.0",
     "oxlint-tsgolint": "^7.0.2001",
+    "postgres": "3.4.9",
     "tus-js-client": "^4.3.1",
     "typescript": "^7.0.2",
     "vite": "8.2.1",
@@ -124,6 +129,7 @@
     "centrifuge": ">=5 <6",
     "drizzle-orm": ">=0.45 <1",
     "nodemailer": ">=9 <10",
+    "postgres": ">=3.4 <4",
     "tus-js-client": ">=4 <5"
   },
   "peerDependenciesMeta": {
@@ -145,6 +151,9 @@
     "nodemailer": {
       "optional": true
     },
+    "postgres": {
+      "optional": true
+    },
     "tus-js-client": {
       "optional": true
     }