@schemavaults/dbh 0.8.7 → 0.10.0

package/.claude/hooks/install-deps-in-fresh-environment.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+if [ ! -d "node_modules" ]; then
+  echo "No node_modules/ folder appears to exist so we're going to install dependencies..."
+  bun install
+fi

package/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/install-deps-in-fresh-environment.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/README.md

@@ -20,12 +20,12 @@ Ensure that you have both `postgres` and a `postgres-ws-proxy` containers runnin
 
 You'll likely want to replace the `build:` sections for the services in the e2e test example `.yml` file with `image:`. For example, use `image: postgres:17.7` for the `postgres` service. For the proxy, you can pull the docker image from `ghcr.io/schemavaults/dbh/postgres-ws-proxy`; use the version number equal to your `@schemavaults/dbh` npm package installation:
 ```md
-# NPM Package: @schemavaults/dbh@0.8.7 => ghcr.io/schemavaults/dbh/postgres-ws-proxy:0.8.7
+# NPM Package: @schemavaults/dbh@0.10.0 => ghcr.io/schemavaults/dbh/postgres-ws-proxy:0.10.0
 ```
 
 ### In your application server code
 
-Set up an adapter.
+Set up an adapter based on your requirements (whether you need serverless/edge access to the database or whether using a standard ).
 
 For an example, see the e2e test file: [./src/tests/e2e/ConnectToLocalDatabase.test.ts](./src/tests/e2e/ConnectToLocalDatabase.test.ts)
 
@@ -44,13 +44,13 @@ npx @schemavaults/dbh --help
 ```bash
 mkdir ./tests/tmp
 
-# compile TypeScript Kysely migrations to JavaScript
-npx @schemavaults/dbh build-db-migrations ./src/tests/example-migrations \
+# compile TypeScript Kysely migrations to JavaScript (Bun is used for building migrations)
+bunx @schemavaults/dbh build-db-migrations ./src/tests/example-migrations \
   --outdir ./tests/tmp/example-compiled-migrations \
   --sql-module ./src/sql.ts \
   --sql-outdir ./tests/tmp/
 
-# apply built migrations to database
+# apply built migrations to database (NodeJS is used for applying migrations)
 npx @schemavaults/dbh migrate ./tests/tmp/example-compiled-migrations --environment production --env-file ./.env.production
   
 rm -rf ./tests/tmp

package/dist/adapters/abstract-schemavaults-dbh-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { BaseInitializablePostgresDatabaseCredentials, PostgresDatabaseCredentials } from "../types/PostgresDatabaseCredentials";
+import { IDatabaseHandler } from "../types/IDatabaseHandler";
+import { type SchemaVaultsAppEnvironment } from "../types/SchemaVaultsAppEnvironment";
+import type { Dialect } from "kysely";
+import { Kysely } from "kysely";
+export interface IAbstractSchemaVaultsDbhAdapterConstructorOpts {
+    /**
+     * @description SchemaVaultsAppEnvironment.
+     * @example 'development' 'test' 'staging' 'production'
+     */
+    environment: SchemaVaultsAppEnvironment;
+    /**
+     * @description PostgresDatabaseCredentials.
+     * @default loaded from environment variables if not supplied
+     */
+    credentials?: BaseInitializablePostgresDatabaseCredentials;
+}
+export default abstract class AbstractSchemaVaultsDbhAdapter<KyselyTablesType extends object, TConstructorOpts extends IAbstractSchemaVaultsDbhAdapterConstructorOpts = IAbstractSchemaVaultsDbhAdapterConstructorOpts> implements IDatabaseHandler<KyselyTablesType> {
+    protected readonly credentials: PostgresDatabaseCredentials;
+    protected readonly kysely_db: Kysely<KyselyTablesType>;
+    protected readonly env: SchemaVaultsAppEnvironment;
+    protected readonly debug: boolean;
+    constructor(opts: TConstructorOpts);
+    protected abstract initializeDbDialect(opts: Omit<TConstructorOpts, "credentials" | "environment">): Dialect;
+    get db(): Kysely<KyselyTablesType>;
+    destroy(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/dist/adapters/abstract-schemavaults-dbh-adapter.js

@@ -0,0 +1,50 @@
+import { isValidAppEnvironment, } from "../types/SchemaVaultsAppEnvironment";
+import isDbhInDebugMode from "../utils/isDbhInDebugMode";
+import parseDatabaseCredentials from "../utils/parseDatabaseCredentials";
+import parseDatabaseCredentialsFromEnv from "../utils/parseDatabaseCredentialsFromEnv";
+import { Kysely } from "kysely";
+export default class AbstractSchemaVaultsDbhAdapter {
+    credentials;
+    kysely_db;
+    env;
+    debug;
+    constructor(opts) {
+        // parse SCHEMAVAULTS_APP_ENVIRONMENT
+        if (!isValidAppEnvironment(opts.environment)) {
+            throw new TypeError("Invalid SCHEMAVAULTS_APP_ENVIRONMENT!");
+        }
+        this.env = opts.environment;
+        // checks if 'SCHEMAVAULTS_DBH_DEBUG="true"' is set in env vars, or defaults to yes if in dev/test/staging environment
+        this.debug = isDbhInDebugMode(this.env);
+        let credentials = undefined;
+        if (opts.credentials) {
+            if (typeof opts.credentials !== "object") {
+                throw new TypeError("'credentials' is truthy but not an object!");
+            }
+            credentials = parseDatabaseCredentials(opts.credentials, this.debug);
+        }
+        else {
+            credentials = parseDatabaseCredentialsFromEnv(process.env, this.debug);
+        }
+        if (!credentials) {
+            throw new Error("Failed to parse database credentials from options or environment variables!");
+        }
+        this.credentials = credentials;
+        const dialect = this.initializeDbDialect(opts);
+        const kysely_configuration = {
+            dialect,
+            log: ["query", "error"],
+        };
+        this.kysely_db = new Kysely(kysely_configuration);
+    }
+    get db() {
+        return this.kysely_db;
+    }
+    async destroy() {
+        return await this.kysely_db.destroy();
+    }
+    async [Symbol.asyncDispose]() {
+        return await this.destroy();
+    }
+}
+//# sourceMappingURL=abstract-schemavaults-dbh-adapter.js.map

package/dist/adapters/abstract-schemavaults-dbh-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-schemavaults-dbh-adapter.js","sourceRoot":"","sources":["../../src/adapters/abstract-schemavaults-dbh-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,GAEtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,gBAAgB,MAAM,0BAA0B,CAAC;AACxD,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AACxE,OAAO,+BAA+B,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,MAAM,EAAqB,MAAM,QAAQ,CAAC;AAgBnD,MAAM,CAAC,OAAO,OAAgB,8BAA8B;IAKvC,WAAW,CAA8B;IACzC,SAAS,CAA2B;IACpC,GAAG,CAA6B;IAChC,KAAK,CAAU;IAElC,YAAmB,IAAsB;QACvC,qCAAqC;QACrC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,WAAgD,CAAC;QAEjE,sHAAsH;QACtH,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,WAAW,GAA4C,SAAS,CAAC;QACrE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;gBACzC,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;YACpE,CAAC;YACD,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,+BAA+B,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,MAAM,OAAO,GAAY,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,oBAAoB,GAAiB;YACzC,OAAO;YACP,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;SACxB,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,MAAM,CAAmB,oBAAoB,CAAC,CAAC;IACtE,CAAC;IAMD,IAAW,EAAE;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAChC,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/adapters/schemavaults-postgres-adapter.d.ts

@@ -0,0 +1,11 @@
+import type { IDatabaseHandler } from "../types/IDatabaseHandler";
+import type { IAbstractSchemaVaultsDbhAdapterConstructorOpts } from "../adapters/abstract-schemavaults-dbh-adapter";
+import AbstractSchemaVaultsDbhAdapter from "../adapters/abstract-schemavaults-dbh-adapter";
+import { type Dialect } from "kysely";
+export interface ISchemaVaultsPostgresAdapterConstructorOpts extends IAbstractSchemaVaultsDbhAdapterConstructorOpts {
+}
+export declare class SchemaVaultsPostgresAdapter<KyselyTablesType extends object> extends AbstractSchemaVaultsDbhAdapter<KyselyTablesType, ISchemaVaultsPostgresAdapterConstructorOpts> implements IDatabaseHandler<KyselyTablesType> {
+    protected initializeDbDialect(): Dialect;
+    constructor(opts: ISchemaVaultsPostgresAdapterConstructorOpts);
+}
+export default SchemaVaultsPostgresAdapter;

package/dist/adapters/schemavaults-postgres-adapter.js

@@ -0,0 +1,31 @@
+// schemavaults-postgres-adapter.ts
+// This file sets up kysely to connect to postgres
+import parsePort from "../utils/parsePort";
+import AbstractSchemaVaultsDbhAdapter from "../adapters/abstract-schemavaults-dbh-adapter";
+import { PostgresDialect, } from "kysely";
+import { Pool } from "pg";
+export class SchemaVaultsPostgresAdapter extends AbstractSchemaVaultsDbhAdapter {
+    initializeDbDialect() {
+        const credentials = this.credentials;
+        const postgres_dialect_conig = {
+            pool: async () => new Pool({
+                database: credentials.POSTGRES_DATABASE,
+                host: credentials.POSTGRES_HOST,
+                user: credentials.POSTGRES_USER,
+                password: credentials.POSTGRES_PASSWORD,
+                port: parsePort(credentials.POSTGRES_PORT),
+                connectionString: credentials.POSTGRES_URL,
+            }),
+        };
+        const dialect = new PostgresDialect(postgres_dialect_conig);
+        return dialect;
+    }
+    constructor(opts) {
+        super(opts);
+        if (this.debug) {
+            console.log("[SchemaVaultsPostgresNeonProxyAdapter] Initialized SchemaVaults x Kysely x Neon database adapter in environment: ", this.env);
+        }
+    }
+}
+export default SchemaVaultsPostgresAdapter;
+//# sourceMappingURL=schemavaults-postgres-adapter.js.map

package/dist/adapters/schemavaults-postgres-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemavaults-postgres-adapter.js","sourceRoot":"","sources":["../../src/adapters/schemavaults-postgres-adapter.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,kDAAkD;AAGlD,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,8BAA8B,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EACL,eAAe,GAGhB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAI1B,MAAM,OAAO,2BACX,SAAQ,8BAGP;IAGS,mBAAmB;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,MAAM,sBAAsB,GAA0B;YACpD,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,IAAI,IAAI,CAAC;gBACP,QAAQ,EAAE,WAAW,CAAC,iBAAkC;gBACxD,IAAI,EAAE,WAAW,CAAC,aAA8B;gBAChD,IAAI,EAAE,WAAW,CAAC,aAA8B;gBAChD,QAAQ,EAAE,WAAW,CAAC,iBAAkC;gBACxD,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,aAAa,CAAkB;gBAC3D,gBAAgB,EAAE,WAAW,CAAC,YAA6B;aAC5D,CAAC;SACL,CAAC;QAEF,MAAM,OAAO,GAAY,IAAI,eAAe,CAAC,sBAAsB,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,YAAmB,IAAiD;QAClE,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,mHAAmH,EACnH,IAAI,CAAC,GAAG,CACT,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,eAAe,2BAA2B,CAAC"}

package/dist/adapters/schemavaults-postgres-neon-proxy-adapter.d.ts

@@ -0,0 +1,18 @@
+import { type WsProxyUrlGenerator } from "../utils/getPostgresNeonWsProxyUrl";
+import type { IDatabaseHandler } from "../types/IDatabaseHandler";
+import type { IAbstractSchemaVaultsDbhAdapterConstructorOpts } from "../adapters/abstract-schemavaults-dbh-adapter";
+import AbstractSchemaVaultsDbhAdapter from "../adapters/abstract-schemavaults-dbh-adapter";
+import type { Dialect } from "kysely";
+export interface ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts extends IAbstractSchemaVaultsDbhAdapterConstructorOpts {
+    /**
+     * @description Pass a custom function, it will receive an object containing the 'pg_host' and 'environment' and should output the endpoint of the proxy to use
+     * @example given { pg_host: 'localhost', environment: 'development' } it might return => 'localhost:5433/v1'
+     */
+    wsProxyUrl?: WsProxyUrlGenerator | string;
+}
+export declare class SchemaVaultsPostgresNeonProxyAdapter<KyselyTablesType extends object> extends AbstractSchemaVaultsDbhAdapter<KyselyTablesType, ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts> implements IDatabaseHandler<KyselyTablesType> {
+    protected initializeDbDialect(opts: Omit<ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts, "credentials">): Dialect;
+    constructor(opts: ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts);
+}
+export default SchemaVaultsPostgresNeonProxyAdapter;
+export type { WsProxyUrlGenerator, IGetPostgresNeonWsProxyUrlOpts, } from "../utils/getPostgresNeonWsProxyUrl";

package/dist/{schemavaults-postgres-neon-proxy-adapter.js → adapters/schemavaults-postgres-neon-proxy-adapter.js}

@@ -1,49 +1,15 @@
-// This file sets up kysely to connect to postgress
+// schemavaults-postgres-neon-proxy-adapter.ts
+// This file sets up kysely to connect to postgres via a Neon websocket proxy
+// (allows database usage from a serverless/edge environment)
 import { NeonDialect } from "kysely-neon";
-import { Kysely } from "kysely";
-import { isValidAppEnvironment, } from "./SchemaVaultsAppEnvironment";
-import getPostgresNeonWsProxyUrl from "./utils/getPostgresNeonWsProxyUrl";
-import isDbhInDebugMode from "./utils/isDbhInDebugMode";
-import parseDatabaseCredentialsFromEnv from "./utils/parseDatabaseCredentialsFromEnv";
-import parseDatabaseCredentials from "./utils/parseDatabaseCredentials";
-export class SchemaVaultsPostgresNeonProxyAdapter {
-    kysely_db;
-    env;
-    debug;
-    static getPostgresNeonWsProxyUrl(opts) {
-        return getPostgresNeonWsProxyUrl(opts);
-    } // end of getPostgresNeonWsProxyUrl()
-    static parsePort(credentials) {
-        const port = typeof credentials.POSTGRES_PORT === "number"
-            ? credentials.POSTGRES_PORT
-            : Number.parseInt(credentials.POSTGRES_PORT);
-        if (isNaN(port)) {
-            throw new Error(`Invalid port number: ${credentials.POSTGRES_PORT}`);
-        }
-        return port;
-    }
-    // Initialized from getInstance() (Singleton pattern)
-    constructor({ environment, ...opts }) {
-        if (!isValidAppEnvironment(environment)) {
-            throw new TypeError("Invalid SCHEMAVAULTS_APP_ENVIRONMENT!");
-        }
-        this.env = environment;
-        // checks if 'SCHEMAVAULTS_DBH_DEBUG="true"' is set in env vars, or defaults to yes if in dev/test/staging environment
-        const debug = isDbhInDebugMode(this.env);
-        this.debug = debug;
-        let credentials = undefined;
-        if (opts.credentials) {
-            if (typeof opts.credentials !== "object") {
-                throw new TypeError("'credentials' is truthy but not an object!");
-            }
-            credentials = parseDatabaseCredentials(opts.credentials, this.debug);
-        }
-        else {
-            credentials = parseDatabaseCredentialsFromEnv(process.env, this.debug);
-        }
-        if (!credentials) {
-            throw new Error("Failed to parse database credentials from options or environment variables!");
-        }
+import getPostgresNeonWsProxyUrl from "../utils/getPostgresNeonWsProxyUrl";
+import parsePort from "../utils/parsePort";
+import AbstractSchemaVaultsDbhAdapter from "../adapters/abstract-schemavaults-dbh-adapter";
+export class SchemaVaultsPostgresNeonProxyAdapter extends AbstractSchemaVaultsDbhAdapter {
+    initializeDbDialect(opts) {
+        const debug = this.debug;
+        const environment = this.env;
+        const credentials = this.credentials;
         const kysely_neon_dialect_config = {
             connectionString: credentials.POSTGRES_URL,
             host: credentials.POSTGRES_HOST,
@@ -51,7 +17,7 @@ export class SchemaVaultsPostgresNeonProxyAdapter {
             password: credentials.POSTGRES_PASSWORD,
             database: credentials.POSTGRES_DATABASE,
             useSecureWebSocket: (this.env === "production"),
-            port: SchemaVaultsPostgresNeonProxyAdapter.parsePort(credentials),
+            port: parsePort(credentials.POSTGRES_PORT),
             wsProxy: (pg_host) => {
                 if (debug) {
                     console.log(`[SchemaVaultsPostgresNeonProxyAdapter] NeonDialectConfig.wsProxy("${pg_host}")`);
@@ -66,8 +32,7 @@ export class SchemaVaultsPostgresNeonProxyAdapter {
                     };
                     if (typeof opts.wsProxyUrl === "undefined" || !opts.wsProxyUrl) {
                         // Default ws proxy URL generator
-                        resolvedWsProxyUrl =
-                            SchemaVaultsPostgresNeonProxyAdapter.getPostgresNeonWsProxyUrl(wsProxyUrlGeneratorSettings);
+                        resolvedWsProxyUrl = getPostgresNeonWsProxyUrl(wsProxyUrlGeneratorSettings);
                     }
                     else if (typeof opts.wsProxyUrl === "string" &&
                         opts.wsProxyUrl &&
@@ -99,26 +64,15 @@ export class SchemaVaultsPostgresNeonProxyAdapter {
         if (this.debug) {
             console.log("[SchemaVaultsPostgresNeonProxyAdapter] Kysely Neon DB adapter configuration: ", kysely_neon_dialect_config);
         }
-        if (this.debug) {
-            console.log("[SchemaVaultsPostgresNeonProxyAdapter] Initializing SchemaVaults x Kysely x Neon database adapter...");
-        }
         const dialect = new NeonDialect(kysely_neon_dialect_config);
-        const kysely_configuration = {
-            dialect,
-            log: ["query", "error"],
-        };
-        this.kysely_db = new Kysely(kysely_configuration);
+        return dialect;
+    }
+    constructor(opts) {
+        super(opts);
         if (this.debug) {
             console.log("[SchemaVaultsPostgresNeonProxyAdapter] Initialized SchemaVaults x Kysely x Neon database adapter in environment: ", this.env);
         }
     }
-    get db() {
-        return this.kysely_db;
-    }
-    async destroy() {
-        await this.kysely_db.destroy();
-        return;
-    }
 }
 export default SchemaVaultsPostgresNeonProxyAdapter;
 //# sourceMappingURL=schemavaults-postgres-neon-proxy-adapter.js.map

package/dist/adapters/schemavaults-postgres-neon-proxy-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemavaults-postgres-neon-proxy-adapter.js","sourceRoot":"","sources":["../../src/adapters/schemavaults-postgres-neon-proxy-adapter.ts"],"names":[],"mappings":"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"}

package/dist/create-dbh.d.ts

@@ -0,0 +1,67 @@
+import type { SchemaVaultsPostgresAdapter, ISchemaVaultsPostgresAdapterConstructorOpts } from "./adapters/schemavaults-postgres-adapter";
+import type { SchemaVaultsPostgresNeonProxyAdapter, ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts } from "./adapters/schemavaults-postgres-neon-proxy-adapter";
+/**
+ * Asynchronously construct a SchemaVaults database handler for the given
+ * adapter type, dynamically importing only the adapter that was requested.
+ *
+ * The returned instance implements `Symbol.asyncDispose`, so it is designed
+ * to be used with TC39 explicit-resource-management (`await using`) — the
+ * underlying Kysely connection pool is destroyed automatically when the
+ * binding goes out of scope.
+ *
+ * @template KyselyTablesType - The Kysely table-types interface describing
+ * the schema of the target database.
+ *
+ * @param adapter_type - Discriminator selecting which adapter to instantiate:
+ *   - `"postgres"` — direct Postgres connection via `pg` Pool.
+ *   - `"postgres-neon-proxy"` — Postgres connection tunneled through a
+ *     Neon-compatible WebSocket proxy (serverless/edge-friendly).
+ * @param opts - Adapter-specific constructor options. The shape is narrowed
+ *   per-overload to match the chosen `adapter_type`.
+ *
+ * @returns A Promise resolving to a ready-to-use adapter instance whose
+ *   concrete type is narrowed per-overload.
+ *
+ * @example Direct Postgres connection
+ * ```ts
+ * import createDbh from "@schemavaults/dbh/create-dbh";
+ * import type { DB } from "./db-types";
+ *
+ * await using dbh = await createDbh<DB>("postgres", {
+ *   environment: "development",
+ * });
+ * const users = await dbh.db.selectFrom("users").selectAll().execute();
+ * ```
+ *
+ * @example Neon WebSocket proxy with custom proxy URL
+ * ```ts
+ * await using dbh = await createDbh<DB>("postgres-neon-proxy", {
+ *   environment: "production",
+ *   wsProxyUrl: ({ pg_host }) => `wss://proxy.example.com/${pg_host}/v1`,
+ * });
+ * ```
+ *
+ * @example Explicit credentials instead of process.env
+ * ```ts
+ * await using dbh = await createDbh<DB>("postgres", {
+ *   environment: "test",
+ *   credentials: {
+ *     POSTGRES_HOST: "localhost",
+ *     POSTGRES_PORT: "5432",
+ *     POSTGRES_USER: "postgres",
+ *     POSTGRES_PASSWORD: "postgres",
+ *     POSTGRES_DATABASE: "schemavaults_test",
+ *   },
+ * });
+ * ```
+ *
+ * @see {@link SchemaVaultsPostgresAdapter} — adapter loaded when
+ *   `adapter_type === "postgres"`.
+ * @see {@link SchemaVaultsPostgresNeonProxyAdapter} — adapter loaded when
+ *   `adapter_type === "postgres-neon-proxy"`.
+ */
+export default function createDbh<KyselyTablesType extends object>(adapter_type: "postgres", opts: ISchemaVaultsPostgresAdapterConstructorOpts): Promise<SchemaVaultsPostgresAdapter<KyselyTablesType>>;
+/**
+ * @see {@link SchemaVaultsPostgresNeonProxyAdapter}
+ */
+export default function createDbh<KyselyTablesType extends object>(adapter_type: "postgres-neon-proxy", opts: ISchemaVaultsPostgresNeonProxyAdapterConstructorOpts): Promise<SchemaVaultsPostgresNeonProxyAdapter<KyselyTablesType>>;

package/dist/create-dbh.js

@@ -0,0 +1,17 @@
+// create-dbh.ts
+const ADAPTER_MAP = {
+    postgres: async () => await import("./adapters/schemavaults-postgres-adapter").then((mod) => mod.SchemaVaultsPostgresAdapter),
+    "postgres-neon-proxy": async () => await import("./adapters/schemavaults-postgres-neon-proxy-adapter").then((mod) => mod.SchemaVaultsPostgresNeonProxyAdapter),
+};
+export default async function createDbh(adapter_type, opts) {
+    if (typeof adapter_type !== "string") {
+        throw new TypeError(`Invalid adapter type '${typeof adapter_type}'`);
+    }
+    const adapter_loader = ADAPTER_MAP[adapter_type];
+    if (typeof adapter_loader !== "function") {
+        throw new TypeError(`Failed to load database adapter loader for type '${adapter_type}'`);
+    }
+    const AdapterClass = (await adapter_loader());
+    return new AdapterClass(opts);
+}
+//# sourceMappingURL=create-dbh.js.map

package/dist/create-dbh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-dbh.js","sourceRoot":"","sources":["../src/create-dbh.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAahB,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,KAAK,IAAI,EAAE,CACnB,MAAM,MAAM,CAAC,0CAA0C,CAAC,CAAC,IAAI,CAC3D,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,2BAA2B,CACzC;IACH,qBAAqB,EAAE,KAAK,IAAI,EAAE,CAChC,MAAM,MAAM,CAAC,qDAAqD,CAAC,CAAC,IAAI,CACtE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,oCAAoC,CAClD;CACK,CAAC;AA2EX,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,SAAS,CACrC,YAAwB,EACxB,IAAoD;IAEpD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,yBAAyB,OAAO,YAAY,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,SAAS,CACjB,oDAAoD,YAAY,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,MAAM,cAAc,EAAE,CAEL,CAAC;IACxC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export { SchemaVaultsPostgresNeonProxyAdapter, SchemaVaultsPostgresNeonProxyAdapter as default, } from "./schemavaults-postgres-neon-proxy-adapter";
-export type { WsProxyUrlGenerator, IGetPostgresNeonWsProxyUrlOpts, } from "./schemavaults-postgres-neon-proxy-adapter";
+export { default as default, default as createDbh } from "./create-dbh";
+export { SchemaVaultsPostgresNeonProxyAdapter } from "./adapters/schemavaults-postgres-neon-proxy-adapter";
+export type { WsProxyUrlGenerator, IGetPostgresNeonWsProxyUrlOpts, } from "./adapters/schemavaults-postgres-neon-proxy-adapter";
+export { SchemaVaultsPostgresAdapter } from "./adapters/schemavaults-postgres-adapter";
 export { sql } from "./sql";
 export type * from "kysely";

package/dist/index.js

@@ -1,3 +1,9 @@
-export { SchemaVaultsPostgresNeonProxyAdapter, SchemaVaultsPostgresNeonProxyAdapter as default, } from "./schemavaults-postgres-neon-proxy-adapter";
+// index.ts
+export { default as default, default as createDbh } from "./create-dbh";
+// Postgres Neon Proxy Adapter (for use in serverless environments)
+export { SchemaVaultsPostgresNeonProxyAdapter } from "./adapters/schemavaults-postgres-neon-proxy-adapter";
+// Postgres Adapter (for use in standard Node.js environments)
+export { SchemaVaultsPostgresAdapter } from "./adapters/schemavaults-postgres-adapter";
+// Kysely SQL builder + types
 export { sql } from "./sql";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EACpC,oCAAoC,IAAI,OAAO,GAChD,MAAM,4CAA4C,CAAC;AAMpD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AAEX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,cAAc,CAAC;AAExE,mEAAmE;AACnE,OAAO,EAAE,oCAAoC,EAAE,MAAM,qDAAqD,CAAC;AAM3G,8DAA8D;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAEvF,6BAA6B;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}

package/dist/migrate.d.ts

@@ -1,4 +1,4 @@
-import { Kysely } from "kysely";
+import type { Kysely } from "kysely";
 export interface IMigrationResult {
     migrationName: string;
     status: "Success" | "Error" | "NotExecuted";

package/dist/migrate.js

@@ -1,5 +1,5 @@
 // migrate.ts
-import { Migrator, FileMigrationProvider, } from "kysely";
+import { Migrator, FileMigrationProvider, } from "kysely/migration";
 import fs from "fs/promises";
 import path from "path";
 import { existsSync } from "fs";

package/dist/migrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"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"}

package/dist/types/IDatabaseHandler.d.ts

@@ -0,0 +1,5 @@
+import type { Kysely } from "kysely";
+export interface IDatabaseHandler<KyselyTablesType extends object> extends AsyncDisposable {
+    destroy(): Promise<void>;
+    db: Kysely<KyselyTablesType>;
+}

package/dist/types/IDatabaseHandler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IDatabaseHandler.js.map

package/dist/types/IDatabaseHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDatabaseHandler.js","sourceRoot":"","sources":["../../src/types/IDatabaseHandler.ts"],"names":[],"mappings":""}

package/dist/types/PostgresDatabaseCredentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresDatabaseCredentials.js","sourceRoot":"","sources":["../../src/types/PostgresDatabaseCredentials.ts"],"names":[],"mappings":""}

package/dist/types/SchemaVaultsAppEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaVaultsAppEnvironment.js","sourceRoot":"","sources":["../../src/types/SchemaVaultsAppEnvironment.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QACzF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/buildPostgresUrl.d.ts

@@ -1,3 +1,3 @@
-import type { BaseInitializablePostgresDatabaseCredentials } from "../PostgresDatabaseCredentials";
+import type { BaseInitializablePostgresDatabaseCredentials } from "../types/PostgresDatabaseCredentials";
 declare function buildPostgresUrl(opts: Pick<BaseInitializablePostgresDatabaseCredentials, "POSTGRES_HOST" | "POSTGRES_PORT" | "POSTGRES_USER" | "POSTGRES_PASSWORD" | "POSTGRES_DATABASE">): string;
 export default buildPostgresUrl;

package/dist/utils/getAppEnvironment.d.ts

@@ -1,3 +1,3 @@
-import { type SchemaVaultsAppEnvironment } from "../SchemaVaultsAppEnvironment";
+import { type SchemaVaultsAppEnvironment } from "../types/SchemaVaultsAppEnvironment";
 export declare function getAppEnvironment(): SchemaVaultsAppEnvironment;
 export default getAppEnvironment;

package/dist/utils/getAppEnvironment.js

@@ -1,4 +1,4 @@
-import { isValidAppEnvironment } from "../SchemaVaultsAppEnvironment";
+import { isValidAppEnvironment, } from "../types/SchemaVaultsAppEnvironment";
 export function getAppEnvironment() {
     const env = process.env["SCHEMAVAULTS_APP_ENVIRONMENT"];
     if (isValidAppEnvironment(env)) {

package/dist/utils/getAppEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAppEnvironment.js","sourceRoot":"","sources":["../../src/utils/getAppEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAmC,MAAM,8BAA8B,CAAC;AAEtG,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACxD,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,8CAA8C;AACrE,CAAC;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"getAppEnvironment.js","sourceRoot":"","sources":["../../src/utils/getAppEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACxD,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,8CAA8C;AACrE,CAAC;AAED,eAAe,iBAAiB,CAAC"}

package/dist/utils/getPostgresNeonWsProxyUrl.d.ts

@@ -1,4 +1,4 @@
-import { type SchemaVaultsAppEnvironment } from "../SchemaVaultsAppEnvironment";
+import { type SchemaVaultsAppEnvironment } from "../types/SchemaVaultsAppEnvironment";
 export interface IGetPostgresNeonWsProxyUrlOpts {
     pg_host: string;
     environment: SchemaVaultsAppEnvironment;

package/dist/utils/getPostgresNeonWsProxyUrl.js

@@ -1,4 +1,4 @@
-import { isValidAppEnvironment, } from "../SchemaVaultsAppEnvironment";
+import { isValidAppEnvironment, } from "../types/SchemaVaultsAppEnvironment";
 export function getPostgresNeonWsProxyUrl({ pg_host, environment, ...opts }) {
     const debug = opts.debug ?? false;
     if (debug) {

package/dist/utils/getPostgresNeonWsProxyUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"getPostgresNeonWsProxyUrl.js","sourceRoot":"","sources":["../../src/utils/getPostgresNeonWsProxyUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,8BAA8B,CAAC;AAYtC,MAAM,UAAU,yBAAyB,CAAC,EACxC,OAAO,EACP,WAAW,EACX,GAAG,IAAI,EACwB;IAC/B,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CACT,2EAA2E,WAAW,4BAA4B,EAClH,OAAO,CACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;SAAM,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,WAAW,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,mBAAmB,CAAC;QAChC,CAAC;IACH,CAAC;SAAM,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC/D,OAAO,GAAG,mBAAmB,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,CAAC,MAAM,CACZ,qBAAqB,CAAC,WAAW,CAAC,EAClC,6EAA6E,CAC9E,CAAC;IAEF,MAAM,uBAAuB,GAC3B,WAAW,KAAK,YAAY;QAC1B,CAAC,CAAE,IAA+B;QAClC,CAAC,CAAE,IAA+B,CAAC;IAEvC,MAAM,4BAA4B,GAAY,WAAW,KAAK,YAAY,CAAC;IAC3E,MAAM,gBAAgB,GAAY,4BAA4B,CAAC;IAE/D,MAAM,sBAAsB,GAC1B,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,uBAAuB,EAA4B,CAAC;IAEtG,OAAO,CAAC,MAAM,CACZ,CAAC,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC;QACzC,CAAC,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC9C,6FAA6F,CAC9F,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CACT,0DAA0D,EAC1D,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,eAAe,yBAAuD,CAAC"}
+{"version":3,"file":"getPostgresNeonWsProxyUrl.js","sourceRoot":"","sources":["../../src/utils/getPostgresNeonWsProxyUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,oCAAoC,CAAC;AAY5C,MAAM,UAAU,yBAAyB,CAAC,EACxC,OAAO,EACP,WAAW,EACX,GAAG,IAAI,EACwB;IAC/B,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CACT,2EAA2E,WAAW,4BAA4B,EAClH,OAAO,CACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC;SAAM,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,WAAW,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,mBAAmB,CAAC;QAChC,CAAC;IACH,CAAC;SAAM,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC/D,OAAO,GAAG,mBAAmB,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,CAAC,MAAM,CACZ,qBAAqB,CAAC,WAAW,CAAC,EAClC,6EAA6E,CAC9E,CAAC;IAEF,MAAM,uBAAuB,GAC3B,WAAW,KAAK,YAAY;QAC1B,CAAC,CAAE,IAA+B;QAClC,CAAC,CAAE,IAA+B,CAAC;IAEvC,MAAM,4BAA4B,GAAY,WAAW,KAAK,YAAY,CAAC;IAC3E,MAAM,gBAAgB,GAAY,4BAA4B,CAAC;IAE/D,MAAM,sBAAsB,GAC1B,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,uBAAuB,EAA4B,CAAC;IAEtG,OAAO,CAAC,MAAM,CACZ,CAAC,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC;QACzC,CAAC,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAC9C,6FAA6F,CAC9F,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CACT,0DAA0D,EAC1D,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,eAAe,yBAAuD,CAAC"}

package/dist/utils/isDbhInDebugMode.d.ts

@@ -1,8 +1,8 @@
-import type { SchemaVaultsAppEnvironment } from "../SchemaVaultsAppEnvironment";
+import type { SchemaVaultsAppEnvironment } from "../types/SchemaVaultsAppEnvironment";
 declare global {
     namespace NodeJS {
         interface ProcessEnv {
-            SCHEMAVAULTS_DBH_DEBUG?: 'true' | 'false';
+            SCHEMAVAULTS_DBH_DEBUG?: "true" | "false";
         }
     }
 }

package/dist/utils/parseDatabaseCredentials.d.ts

@@ -1,3 +1,3 @@
-import type { BaseInitializablePostgresDatabaseCredentials, PostgresDatabaseCredentials } from "../PostgresDatabaseCredentials";
+import type { BaseInitializablePostgresDatabaseCredentials, PostgresDatabaseCredentials } from "../types/PostgresDatabaseCredentials";
 declare function parseDatabaseCredentials(minimum_credentials: Record<string, boolean | string | number | undefined> | BaseInitializablePostgresDatabaseCredentials, debug?: boolean): PostgresDatabaseCredentials;
 export default parseDatabaseCredentials;

package/dist/utils/parseDatabaseCredentialsFromEnv.d.ts

@@ -1,3 +1,3 @@
-import type { PostgresDatabaseCredentials } from "../PostgresDatabaseCredentials";
+import type { PostgresDatabaseCredentials } from "../types/PostgresDatabaseCredentials";
 export declare function parseDatabaseCredentialsFromEnv(env: Record<string, string | undefined>, debug?: boolean): PostgresDatabaseCredentials;
 export default parseDatabaseCredentialsFromEnv;

package/dist/utils/parsePort.d.ts

@@ -0,0 +1 @@
+export default function parsePort(val: string | number): number;

package/dist/utils/parsePort.js

@@ -0,0 +1,21 @@
+function isValidPort(val) {
+    return (!isNaN(val) && Number.isInteger(val) && Number.isFinite(val) && val > 0);
+}
+export default function parsePort(val) {
+    if (typeof val === "number") {
+        if (isValidPort(val)) {
+            return val;
+        }
+    }
+    else if (typeof val === "string") {
+        const parsed = Number.parseInt(val);
+        if (isValidPort(parsed)) {
+            return parsed;
+        }
+    }
+    else {
+        throw new TypeError(`Unexpected type for value to parse port number from: '${typeof val}'`);
+    }
+    throw new TypeError("Failed to parse port number for database configuration!");
+}
+//# sourceMappingURL=parsePort.js.map

package/dist/utils/parsePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePort.js","sourceRoot":"","sources":["../../src/utils/parsePort.ts"],"names":[],"mappings":"AAAA,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,CACL,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,GAAoB;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,SAAS,CACjB,yDAAyD,OAAO,GAAG,GAAG,CACvE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,SAAS,CACjB,yDAAyD,CAC1D,CAAC;AACJ,CAAC"}