ras-stack 0.11.0 → 0.12.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:

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.11.0",
+  "version": "0.12.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
     }