@arki/db 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARKI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# @arki/db
+
+Drizzle ORM repositories and database helpers for ARKI. Provides:
+
+- Two runtime entry points (`node-postgres` pool by default, Bun-native SQL via the `bun` export condition, embedded PGlite via `./runtime-local`).
+- An env-aware connection pool reader (`getDbConnectionOptions`).
+- A typed projection builder (`initDb.schema(...).create(...).projection`) for event-sourced read models.
+- A branded-ID factory (`createPrefixedId`) for stable, type-safe IDs.
+
+## Installation
+
+```sh
+npm install @arki/db
+# or
+bun add @arki/db
+# or
+pnpm add @arki/db
+```
+
+## Usage
+
+### Initialize a database from environment
+
+```ts
+import { createDb } from '@arki/db/init';
+import { defineRelations } from '@arki/db/orm';
+import { schema } from './schema';
+
+export const db = createDb({
+  relations: defineRelations(schema, builder => ({
+    user: { posts: builder.many('post') },
+    post: { author: builder.one('user') },
+  })),
+});
+```
+
+`createDb` reads `DB_URL` and the pool tuning vars (`DB_POOL_MIN`, `DB_POOL_MAX`, `DB_POOL_IDLE_TIMEOUT`, `DB_POOL_CONNECTION_TIMEOUT`, `DB_STATEMENT_TIMEOUT`, …) from `process.env` and throws on missing `DB_URL`.
+
+### Embedded local development (PGlite)
+
+```ts
+import { initDbRuntimeLocal } from '@arki/db/runtime-local';
+
+const { db, pglite } = await initDbRuntimeLocal(
+  { dataDir: './.local/db' },
+  { relations },
+);
+```
+
+### Projections (event sourcing read models)
+
+```ts
+import { initDb } from '@arki/db/builder';
+
+const d = initDb
+  .schema(schema)
+  .create({ connectionString: env.DB_URL, isDev: true });
+
+const userProjection = d.projection
+  .named('user-projection')
+  .on(['UserRegistered'])
+  .handle(async (events, { db, repo: _repo }) => {
+    // ...
+  });
+```
+
+### Branded IDs
+
+```ts
+import { createPrefixedId, createIdFactory } from '@arki/db/id';
+
+const userId = createPrefixedId('usr_'); // 'usr_…'
+const idFactory = createIdFactory('post_');
+const postId = idFactory.next();
+```
+
+## Subpath exports
+
+- `@arki/db` / `@arki/db/init` — `createDb`, `initDb`, `initDbWithOptions`. Under Bun, `./init` resolves to a Bun-native SQL driver.
+- `@arki/db/factory` — `createDb` + connection-option helpers.
+- `@arki/db/builder` — typed projection builder.
+- `@arki/db/runtime-local` — PGlite-backed embedded runtime.
+- `@arki/db/env` — validated env object.
+- `@arki/db/id`, `@arki/db/id-factory` — CUID-based prefixed-ID helpers.
+- `@arki/db/orm` — re-exports of `drizzle-orm` + `drizzle-orm/zod` schema helpers.
+- `@arki/db/pg` — re-export of `drizzle-orm/pg-core`.
+- `@arki/db/bun` — Bun-SQL driver entry (also routed via the `bun` condition on `./init`).
+- `@arki/db/client` — types-only client surface reserved for future Tier-3 sync work.
+
+## Environment variables
+
+| Variable                                | Purpose                                                       |
+| --------------------------------------- | ------------------------------------------------------------- |
+| `DB_URL`                                | Primary Postgres connection URL.                              |
+| `PGHOST`, `PGPORT`, `PGUSER`, …         | Individual params when `DB_URL` is not used.                  |
+| `DB_POOL_MIN`, `DB_POOL_MAX`            | Connection pool sizing (default `2` / `20`).                  |
+| `DB_POOL_IDLE_TIMEOUT`                  | Idle pool timeout in ms (default `30000`).                    |
+| `DB_POOL_CONNECTION_TIMEOUT`            | Acquire timeout in ms (default `2000`).                       |
+| `DB_LOGGING`                            | Enable Drizzle logger when truthy.                            |
+| `DB_STATEMENT_TIMEOUT`, `DB_QUERY_TIMEOUT` | Per-statement / per-query timeouts in ms.                  |
+
+## Documentation
+
+`@arki/db` ships an optional `@arki/db/dot` adapter for the
+[`@arki/dot`](https://www.npmjs.com/package/@arki/dot) framework.
+
+- See `packages/dot/docs/` in the [`@arki/dot`](https://www.npmjs.com/package/@arki/dot)
+  package for plugin authoring, lifecycle, diagnostics, and the
+  [adapter authoring guide](https://github.com/arkijs/arki/blob/main/packages/dot/docs/adapter-authoring.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/builder.d.ts

@@ -0,0 +1,119 @@
+import type { AnyRelations } from 'drizzle-orm';
+import { defineRelations } from 'drizzle-orm';
+import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
+import type { PoolConfig } from 'pg';
+/**
+ * Projection middleware context
+ */
+export type ProjectionMiddlewareContext = {
+    next: () => Promise<void>;
+    meta: {
+        name: string;
+        eventCount: number;
+    };
+};
+/**
+ * Projection middleware function
+ */
+export type ProjectionMiddleware = (context: ProjectionMiddlewareContext) => Promise<void>;
+/**
+ * Projection handler context
+ */
+export type ProjectionHandlerContext<TRepos, TRelations extends AnyRelations = AnyRelations> = {
+    repo: TRepos;
+    db: NodePgDatabase<TRelations>;
+};
+/**
+ * Projection handler function
+ */
+export type ProjectionHandler<TEvent, TRepos, TRelations extends AnyRelations = AnyRelations> = (events: TEvent[], context: ProjectionHandlerContext<TRepos, TRelations>) => Promise<void>;
+/**
+ * Projection builder interface
+ */
+export type ProjectionBuilder<TEvent = never, TRepos = never, TRelations extends AnyRelations = AnyRelations> = {
+    named<TName extends string>(name: TName): ProjectionBuilderWithName<TEvent, TRepos, TRelations, TName>;
+};
+export type ProjectionBuilderWithName<_TEvent, TRepos, TRelations extends AnyRelations, TName extends string> = {
+    on<TEventType extends {
+        type: string;
+    }>(eventTypes: readonly TEventType['type'][] | TEventType['type'][]): ProjectionBuilderWithEvents<TEventType, TRepos, TRelations, TName>;
+};
+export type ProjectionBuilderWithEvents<TEvent, TRepos, TRelations extends AnyRelations, TName extends string> = {
+    handle(handler: ProjectionHandler<TEvent, TRepos, TRelations>): ProjectionDefinition<TName>;
+};
+/**
+ * Emmett-compatible projection definition.
+ */
+export type ProjectionDefinition<TName extends string = string> = {
+    name: TName;
+    canHandle: string[];
+    handle: (events: {
+        type: string;
+    }[]) => Promise<void>;
+};
+/**
+ * Database builder with projection support
+ */
+export type DbBuilder<TRelations extends AnyRelations, TRepos extends Record<string, unknown>> = {
+    readonly db: NodePgDatabase<TRelations>;
+    readonly isDev: boolean;
+    registerRepository<K extends string, R>(key: K, factory: (db: NodePgDatabase<TRelations>) => R): DbBuilder<TRelations, TRepos & Record<K, R>>;
+    projectionMiddleware(fn: ProjectionMiddleware): ProjectionMiddleware;
+    readonly projection: ProjectionBuilderRoot<TRepos, TRelations>;
+};
+/**
+ * Projection builder root that can have middleware applied
+ */
+export type ProjectionBuilderRoot<TRepos, TRelations extends AnyRelations = AnyRelations> = {
+    use(middleware: ProjectionMiddleware): ProjectionBuilderRoot<TRepos, TRelations>;
+} & ProjectionBuilder<never, TRepos, TRelations>;
+/**
+ * Schema configuration step
+ */
+export type SchemaBuilder<TRelations extends AnyRelations> = {
+    create(options: {
+        connectionString: string;
+        isDev?: boolean;
+        poolConfig?: Partial<PoolConfig>;
+    }): DbBuilder<TRelations, Record<string, never>>;
+};
+/**
+ * Initial builder step
+ */
+export type InitialBuilder = {
+    /**
+     * Set the database tables. Internally builds a relations config via
+     * `defineRelations()` so consumers keep passing a plain table record.
+     *
+     * Use this for backends that don't define explicit relations and rely on
+     * auto-derivation (no joins). For explicit RQBv2 relations, prefer
+     * `.relations(...)` with a `defineRelations(tables, cb)` result.
+     */
+    schema<TSchema extends Record<string, unknown>>(schema: TSchema): SchemaBuilder<ReturnType<typeof defineRelations<TSchema>>>;
+    /**
+     * Pass a pre-built relations object (the result of
+     * `defineRelations(tables, cb)`) so the database knows about every table
+     * AND the explicit one/many relations declared by the application.
+     */
+    relations<TRelations extends AnyRelations>(relations: TRelations): SchemaBuilder<TRelations>;
+};
+/**
+ * Initialize the database builder.
+ *
+ * @example
+ * ```typescript
+ * const d = initDb
+ *   .schema(schema)
+ *   .create({
+ *     connectionString: env.DB_URL,
+ *     isDev: process.env.NODE_ENV === 'development',
+ *   });
+ *
+ * const db = d.db;
+ * const projection = d.projection.named('my-proj').on(['EventA']).handle(async (events, ctx) => {
+ *   // handler
+ * });
+ * ```
+ */
+export declare const initDb: InitialBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

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

package/dist/builder.js

@@ -0,0 +1,165 @@
+import { defineRelations } from 'drizzle-orm';
+import { debugProjection } from './debug.js';
+import { initDbWithOptions } from './init.js';
+/**
+ * Applies a middleware chain around a core handler function.
+ */
+function applyMiddleware(middleware, name, eventCount, coreHandler) {
+    const meta = { name, eventCount };
+    let next = coreHandler;
+    for (let i = middleware.length - 1; i >= 0; i--) {
+        const mw = middleware[i];
+        const currentNext = next;
+        next = () => mw({ next: currentNext, meta });
+    }
+    return next();
+}
+class ProjectionBuilderImpl {
+    repos;
+    _db;
+    _name;
+    _eventTypes;
+    _middleware = [];
+    constructor(repos, _db, middleware) {
+        this.repos = repos;
+        this._db = _db;
+        if (middleware) {
+            this._middleware = [...middleware];
+        }
+    }
+    named(name) {
+        debugProjection('[builder] Setting projection name: %s', name);
+        this._name = name;
+        return this;
+    }
+    on(eventTypes) {
+        debugProjection('[builder] Registering event types: %o', eventTypes);
+        this._eventTypes = [...eventTypes];
+        return this;
+    }
+    handle(handler) {
+        if (!this._name) {
+            debugProjection('[builder] Error: Projection name is required');
+            throw new Error('Projection name is required. Call .named() first.');
+        }
+        if (!this._eventTypes) {
+            debugProjection('[builder] Error: Event types are required');
+            throw new Error('Event types are required. Call .on() first.');
+        }
+        const name = this._name;
+        const eventTypes = this._eventTypes;
+        const middleware = this._middleware;
+        const repos = this.repos;
+        const db = this._db;
+        debugProjection('[builder] Creating projection definition (name: %s, eventTypes: %o, middlewareCount: %d)', name, eventTypes, middleware.length);
+        return {
+            name,
+            canHandle: eventTypes,
+            handle: async (events) => {
+                const context = { repo: repos, db };
+                const coreHandler = () => handler(events, context);
+                if (middleware.length > 0) {
+                    await applyMiddleware(middleware, name, events.length, coreHandler);
+                }
+                else {
+                    await coreHandler();
+                }
+            },
+        };
+    }
+    use(middleware) {
+        debugProjection('[builder] Adding projection middleware (currentCount: %d)', this._middleware.length);
+        const newBuilder = new ProjectionBuilderImpl(this.repos, this._db, [
+            ...this._middleware,
+            middleware,
+        ]);
+        debugProjection('[builder] Middleware added (newCount: %d)', this._middleware.length + 1);
+        return newBuilder;
+    }
+}
+class DbBuilderImpl {
+    db;
+    isDev;
+    _repos;
+    _repoFactories;
+    constructor(db, isDev, repoFactories) {
+        this.db = db;
+        this.isDev = isDev;
+        this._repoFactories = repoFactories ?? new Map();
+    }
+    registerRepository(key, factory) {
+        debugProjection('[builder] Registering repository (key: %s, currentCount: %d)', key, this._repoFactories.size);
+        const newFactories = new Map(this._repoFactories);
+        newFactories.set(key, factory);
+        debugProjection('[builder] Repository registered (key: %s, newCount: %d)', key, newFactories.size);
+        return new DbBuilderImpl(this.db, this.isDev, newFactories);
+    }
+    projectionMiddleware(fn) {
+        return fn;
+    }
+    get projection() {
+        if (!this._repos) {
+            debugProjection('[builder] Initializing repositories from factories (count: %d)', this._repoFactories.size);
+            const repos = {};
+            for (const [key, factory] of this._repoFactories) {
+                debugProjection('[builder] Creating repository: %s', key);
+                repos[key] = factory(this.db);
+            }
+            this._repos = repos;
+            debugProjection('[builder] All repositories initialized');
+        }
+        debugProjection('[builder] Creating projection builder');
+        return new ProjectionBuilderImpl(this._repos, this.db);
+    }
+}
+class SchemaBuilderImpl {
+    relations;
+    constructor(relations) {
+        this.relations = relations;
+    }
+    create(options) {
+        debugProjection('[builder] Creating database builder (isDev: %s, hasPoolConfig: %s)', options.isDev ?? false, !!options.poolConfig);
+        const poolConfig = {
+            connectionString: options.connectionString,
+            ...options.poolConfig,
+        };
+        debugProjection('[builder] Initializing database with pool config');
+        const db = initDbWithOptions(poolConfig, {
+            relations: this.relations,
+            logger: options.isDev,
+        });
+        debugProjection('[builder] Database builder created successfully');
+        return new DbBuilderImpl(db, options.isDev ?? false);
+    }
+}
+class InitialBuilderImpl {
+    schema(schema) {
+        debugProjection('[builder] Setting database schema (deriving relations via defineRelations)');
+        const relations = defineRelations(schema);
+        return new SchemaBuilderImpl(relations);
+    }
+    relations(relations) {
+        debugProjection('[builder] Setting database relations (explicit RQBv2)');
+        return new SchemaBuilderImpl(relations);
+    }
+}
+/**
+ * Initialize the database builder.
+ *
+ * @example
+ * ```typescript
+ * const d = initDb
+ *   .schema(schema)
+ *   .create({
+ *     connectionString: env.DB_URL,
+ *     isDev: process.env.NODE_ENV === 'development',
+ *   });
+ *
+ * const db = d.db;
+ * const projection = d.projection.named('my-proj').on(['EventA']).handle(async (events, ctx) => {
+ *   // handler
+ * });
+ * ```
+ */
+export const initDb = new InitialBuilderImpl();
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

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

package/dist/bun.d.ts

@@ -0,0 +1,22 @@
+import type { AnyRelations } from 'drizzle-orm';
+import type { BunSQLDatabase } from 'drizzle-orm/bun-sql/postgres';
+import type { DrizzlePgConfig } from 'drizzle-orm/pg-core/utils';
+/**
+ * Initialize database with Bun's native SQL driver.
+ * @param connectionString - PostgreSQL connection string.
+ * @param config - Drizzle pg configuration.
+ */
+export declare const initDb: <TRelations extends AnyRelations>(connectionString: string, config: Omit<DrizzlePgConfig<TRelations>, "relations"> & {
+    relations: TRelations;
+}) => BunSQLDatabase<TRelations>;
+/**
+ * Create a database connection using environment configuration with Bun SQL.
+ * @param config - Drizzle pg configuration.
+ * @throws Error if DB_URL is not configured.
+ */
+export declare function createDb<TRelations extends AnyRelations>(config: Omit<DrizzlePgConfig<TRelations>, 'relations'> & {
+    relations: TRelations;
+}): BunSQLDatabase<TRelations>;
+export { getDbConnectionOptions, getDbConnectionParams } from './connection-options.js';
+export type { BunSQLDatabase } from 'drizzle-orm/bun-sql/postgres';
+//# sourceMappingURL=bun.d.ts.map

package/dist/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../src/bun.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,UAAU,SAAS,YAAY,EACpD,kBAAkB,MAAM,EACxB,QAAQ,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,EAAE,UAAU,CAAA;CAAE,KACjF,cAAc,CAAC,UAAU,CAU3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,UAAU,SAAS,YAAY,EACtD,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,EAAE,UAAU,CAAA;CAAE,GACjF,cAAc,CAAC,UAAU,CAAC,CAiB5B;AAED,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAExF,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/bun.js

@@ -0,0 +1,37 @@
+import { SQL } from 'bun';
+import { drizzle } from 'drizzle-orm/bun-sql/postgres';
+import { debugInit } from './debug.js';
+import { env } from './env.js';
+/**
+ * Initialize database with Bun's native SQL driver.
+ * @param connectionString - PostgreSQL connection string.
+ * @param config - Drizzle pg configuration.
+ */
+export const initDb = (connectionString, config) => {
+    debugInit('[bun] Initializing database with connection string (logger: %s)', !!config.logger);
+    const client = new SQL(connectionString);
+    const db = drizzle({ ...config, client });
+    debugInit('[bun] Database initialized successfully with Bun SQL driver');
+    return db;
+};
+/**
+ * Create a database connection using environment configuration with Bun SQL.
+ * @param config - Drizzle pg configuration.
+ * @throws Error if DB_URL is not configured.
+ */
+export function createDb(config) {
+    debugInit('[bun] Creating database from environment configuration');
+    const connectionUrl = env.DB_URL;
+    if (!connectionUrl) {
+        debugInit('[bun] Database creation failed: DB_URL not configured');
+        throw new Error('Database URL is not configured. Please set DB_URL environment variable.');
+    }
+    const db = initDb(connectionUrl, {
+        ...config,
+        logger: config.logger ?? (env.DB_LOGGING || env.NODE_ENV === 'development'),
+    });
+    debugInit('[bun] Database created successfully');
+    return db;
+}
+export { getDbConnectionOptions, getDbConnectionParams } from './connection-options.js';
+//# sourceMappingURL=bun.js.map

package/dist/bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.js","sourceRoot":"","sources":["../src/bun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,gBAAwB,EACxB,MAAkF,EACtD,EAAE;IAC9B,SAAS,CAAC,iEAAiE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEzC,MAAM,EAAE,GAAG,OAAO,CAAa,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,SAAS,CAAC,6DAA6D,CAAC,CAAC;IAEzE,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAkF;IAElF,SAAS,CAAC,wDAAwD,CAAC,CAAC;IAEpE,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC;IACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,SAAS,CAAC,uDAAuD,CAAC,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE;QAC/B,GAAG,MAAM;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;KAC5E,CAAC,CAAC;IAEH,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAEjD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/client/ids.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Branded ID type re-exports for the client surface.
+ *
+ * V1: @arki/contracts does not yet export named branded ID types.
+ * Future versions will re-export them here once they are defined, e.g.:
+ *
+ *   export type { UserId, OrgId, AssetId } from '@arki/contracts';
+ *
+ * See docs/superpowers/specs/2026-05-16-arki-offline-design.md §3.3.
+ */
+export type {};
+//# sourceMappingURL=ids.d.ts.map

package/dist/client/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/client/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,YAAY,EAAE,CAAC"}

package/dist/client/ids.js

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

package/dist/client/ids.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @arki/db/client — types-only client surface.
+ *
+ * V1 is intentionally empty: this subpath claims the namespace for future
+ * Drizzle-on-client / Tier-3 sync work (Electric / PowerSync / Zero adapters).
+ * No runtime imports are allowed here — this file must remain free of any
+ * server-only dependencies (postgres, drizzle-orm connection utilities, etc.).
+ *
+ * See docs/superpowers/specs/2026-05-16-arki-offline-design.md §3.3.
+ */
+export type * from './ids.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,mBAAmB,UAAU,CAAC"}

package/dist/client/index.js

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

package/dist/client/index.js.map

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

package/dist/connection-options.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Get database connection options from environment variables
+ * @returns Connection options object for pg Pool
+ */
+export declare function getDbConnectionOptions(): {
+    connectionString: string;
+    min: number;
+    max: number;
+    idleTimeoutMillis: number;
+    connectionTimeoutMillis: number;
+    statement_timeout: number;
+    query_timeout: number;
+    idle_in_transaction_session_timeout: number;
+};
+/**
+ * Get individual database connection parameters from environment variables
+ * Useful when DB_URL is not available but individual parameters are set
+ * @returns Connection parameters object
+ */
+export declare function getDbConnectionParams(): {
+    user: string | undefined;
+    password: string | undefined;
+    host: string;
+    port: number;
+    database: string | undefined;
+    ssl: boolean | {
+        rejectUnauthorized: boolean;
+    };
+};
+//# sourceMappingURL=connection-options.d.ts.map

package/dist/connection-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-options.d.ts","sourceRoot":"","sources":["../src/connection-options.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,sBAAsB;;;;;;;;;EAkBrC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB;;;;;;;;;EAgBpC"}

package/dist/connection-options.js

@@ -0,0 +1,41 @@
+import { debugFactory } from './debug.js';
+import { env } from './env.js';
+/**
+ * Get database connection options from environment variables
+ * @returns Connection options object for pg Pool
+ */
+export function getDbConnectionOptions() {
+    debugFactory('[factory] Retrieving database connection options from environment');
+    const connectionUrl = env.DB_URL;
+    const options = {
+        connectionString: connectionUrl,
+        min: env.DB_POOL_MIN,
+        max: env.DB_POOL_MAX,
+        idleTimeoutMillis: env.DB_POOL_IDLE_TIMEOUT,
+        connectionTimeoutMillis: env.DB_POOL_CONNECTION_TIMEOUT,
+        statement_timeout: env.DB_STATEMENT_TIMEOUT,
+        query_timeout: env.DB_QUERY_TIMEOUT,
+        idle_in_transaction_session_timeout: env.DB_IDLE_IN_TRANSACTION_SESSION_TIMEOUT,
+    };
+    debugFactory('[factory] Connection options retrieved (hasUrl: %s)', !!connectionUrl);
+    return options;
+}
+/**
+ * Get individual database connection parameters from environment variables
+ * Useful when DB_URL is not available but individual parameters are set
+ * @returns Connection parameters object
+ */
+export function getDbConnectionParams() {
+    debugFactory('[factory] Retrieving database connection parameters from environment');
+    const params = {
+        user: env.PGUSER,
+        password: env.PGPASSWORD,
+        host: env.PGHOST,
+        port: env.PGPORT,
+        database: env.PGDATABASE,
+        ssl: env.PGSSLMODE === 'disable' ? false : { rejectUnauthorized: env.PGSSLMODE === 'verify-full' },
+    };
+    debugFactory('[factory] Connection parameters retrieved (host: %s, port: %d, database: %s, ssl: %s)', params.host, params.port, params.database, env.PGSSLMODE);
+    return params;
+}
+//# sourceMappingURL=connection-options.js.map

package/dist/connection-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-options.js","sourceRoot":"","sources":["../src/connection-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,YAAY,CAAC,mEAAmE,CAAC,CAAC;IAElF,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC;IACjC,MAAM,OAAO,GAAG;QACd,gBAAgB,EAAE,aAAa;QAC/B,GAAG,EAAE,GAAG,CAAC,WAAW;QACpB,GAAG,EAAE,GAAG,CAAC,WAAW;QACpB,iBAAiB,EAAE,GAAG,CAAC,oBAAoB;QAC3C,uBAAuB,EAAE,GAAG,CAAC,0BAA0B;QACvD,iBAAiB,EAAE,GAAG,CAAC,oBAAoB;QAC3C,aAAa,EAAE,GAAG,CAAC,gBAAgB;QACnC,mCAAmC,EAAE,GAAG,CAAC,sCAAsC;KAChF,CAAC;IAEF,YAAY,CAAC,qDAAqD,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;IAErF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,YAAY,CAAC,sEAAsE,CAAC,CAAC;IAErF,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,GAAG,CAAC,MAAM;QAChB,QAAQ,EAAE,GAAG,CAAC,UAAU;QACxB,IAAI,EAAE,GAAG,CAAC,MAAM;QAChB,IAAI,EAAE,GAAG,CAAC,MAAM;QAChB,QAAQ,EAAE,GAAG,CAAC,UAAU;QACxB,GAAG,EAAE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,SAAS,KAAK,aAAa,EAAE;KACnG,CAAC;IAEF,YAAY,CAAC,uFAAuF,EAClG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/debug.d.ts

@@ -0,0 +1,21 @@
+import { createDebugLogger } from '@arki/log/debug';
+/**
+ * Debug logger for database initialization and connection operations
+ * Enable with: DEBUG=db:init
+ */
+export declare const debugInit: createDebugLogger.Debugger;
+/**
+ * Debug logger for database factory operations
+ * Enable with: DEBUG=db:factory
+ */
+export declare const debugFactory: createDebugLogger.Debugger;
+/**
+ * Debug logger for projection builder operations
+ * Enable with: DEBUG=db:projection
+ */
+export declare const debugProjection: createDebugLogger.Debugger;
+/**
+ * Enable all database debug logs
+ * Enable with: DEBUG=db:*
+ */
+//# sourceMappingURL=debug.d.ts.map