@neutron-build/data 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tyler
+
+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,25 @@
+# @neutron-build/data
+
+Data layer for Neutron applications.
+
+Pluggable cache, session, queue, and storage drivers. Works with Drizzle ORM, Redis, S3, BullMQ, and more.
+
+## Installation
+
+```bash
+npm install @neutron-build/data
+```
+
+## Usage
+
+```typescript
+import { createS3StorageDriver } from "@neutron-build/data";
+```
+
+## Documentation
+
+[neutron.build](https://neutron.build)
+
+## License
+
+MIT

package/dist/cache/index.d.ts

@@ -0,0 +1,14 @@
+export interface CacheClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSec?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    incr(key: string, ttlSec?: number): Promise<number>;
+}
+export declare class MemoryCacheClient implements CacheClient {
+    private store;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSec?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    incr(key: string, ttlSec?: number): Promise<number>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,KAAK,CAAkC;IAEzC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAcxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAO1D"}

package/dist/cache/index.js

@@ -0,0 +1,29 @@
+export class MemoryCacheClient {
+    store = new Map();
+    async get(key) {
+        const record = this.store.get(key);
+        if (!record) {
+            return null;
+        }
+        if (record.expiresAt !== null && record.expiresAt <= Date.now()) {
+            this.store.delete(key);
+            return null;
+        }
+        return record.value;
+    }
+    async set(key, value, ttlSec) {
+        const expiresAt = typeof ttlSec === "number" && ttlSec > 0 ? Date.now() + ttlSec * 1000 : null;
+        this.store.set(key, { value, expiresAt });
+    }
+    async del(key) {
+        this.store.delete(key);
+    }
+    async incr(key, ttlSec) {
+        const currentRaw = await this.get(key);
+        const current = currentRaw ? Number.parseInt(currentRaw, 10) : 0;
+        const next = Number.isFinite(current) ? current + 1 : 1;
+        await this.set(key, String(next), ttlSec);
+        return next;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,iBAAiB;IACpB,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,MAAe;QACnD,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,MAAe;QACrC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/cache/nucleus.d.ts

@@ -0,0 +1,46 @@
+import type { CacheClient } from "./index.js";
+/**
+ * A KV-like interface matching the subset of @neutron-build/nucleus KVModel
+ * needed by NucleusCacheClient.
+ *
+ * We define this locally to avoid a hard dependency on @neutron-build/nucleus
+ * from neutron-data (it's a peer dependency).
+ */
+export interface NucleusKVLike {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        ttl?: number;
+        namespace?: string;
+    }): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    incr(key: string, amount?: number): Promise<number>;
+    expire(key: string, seconds: number): Promise<boolean>;
+}
+export interface NucleusCacheClientOptions {
+    /** A KV model instance (from `@neutron-build/nucleus`). */
+    kv: NucleusKVLike;
+    /** Key prefix for all cache entries (default `"cache:"`). */
+    prefix?: string;
+}
+/**
+ * CacheClient implementation backed by Nucleus KV.
+ *
+ * This is a drop-in replacement for `MemoryCacheClient` or `RedisCacheClient`
+ * that stores data directly in Nucleus, avoiding the need for a separate
+ * Redis instance.
+ */
+export declare class NucleusCacheClient implements CacheClient {
+    private readonly kv;
+    private readonly prefix;
+    constructor(options: NucleusCacheClientOptions);
+    private key;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSec?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    incr(key: string, ttlSec?: number): Promise<number>;
+}
+/**
+ * Factory function matching the pattern of `createRedisCacheClient`.
+ */
+export declare function createNucleusCacheClient(options: NucleusCacheClientOptions): NucleusCacheClient;
+//# sourceMappingURL=nucleus.d.ts.map

package/dist/cache/nucleus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nucleus.d.ts","sourceRoot":"","sources":["../../src/cache/nucleus.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,EAAE,EAAE,aAAa,CAAC;IAClB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAgB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,yBAAyB;IAK9C,OAAO,CAAC,GAAG;IAIL,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAQ1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAE/F"}

package/dist/cache/nucleus.js

@@ -0,0 +1,50 @@
+// ---------------------------------------------------------------------------
+// CacheClient backed by Nucleus KV model
+// ---------------------------------------------------------------------------
+//
+// When the application connects to Nucleus (instead of Redis), this adapter
+// bridges neutron-data's CacheClient interface to the KV model's SQL functions.
+// ---------------------------------------------------------------------------
+/**
+ * CacheClient implementation backed by Nucleus KV.
+ *
+ * This is a drop-in replacement for `MemoryCacheClient` or `RedisCacheClient`
+ * that stores data directly in Nucleus, avoiding the need for a separate
+ * Redis instance.
+ */
+export class NucleusCacheClient {
+    kv;
+    prefix;
+    constructor(options) {
+        this.kv = options.kv;
+        this.prefix = options.prefix ?? "cache:";
+    }
+    key(k) {
+        return `${this.prefix}${k}`;
+    }
+    async get(key) {
+        return this.kv.get(this.key(key));
+    }
+    async set(key, value, ttlSec) {
+        const opts = ttlSec && ttlSec > 0 ? { ttl: ttlSec } : undefined;
+        await this.kv.set(this.key(key), value, opts);
+    }
+    async del(key) {
+        await this.kv.delete(this.key(key));
+    }
+    async incr(key, ttlSec) {
+        const k = this.key(key);
+        const next = await this.kv.incr(k);
+        if (ttlSec && ttlSec > 0) {
+            await this.kv.expire(k, ttlSec);
+        }
+        return next;
+    }
+}
+/**
+ * Factory function matching the pattern of `createRedisCacheClient`.
+ */
+export function createNucleusCacheClient(options) {
+    return new NucleusCacheClient(options);
+}
+//# sourceMappingURL=nucleus.js.map

package/dist/cache/nucleus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nucleus.js","sourceRoot":"","sources":["../../src/cache/nucleus.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AA0B9E;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACZ,EAAE,CAAgB;IAClB,MAAM,CAAS;IAEhC,YAAY,OAAkC;QAC5C,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC3C,CAAC;IAEO,GAAG,CAAC,CAAS;QACnB,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,MAAe;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,MAAe;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/cache/redis.d.ts

@@ -0,0 +1,28 @@
+import type { CacheClient } from "./index.js";
+export interface RedisCacheClientOptions {
+    url?: string;
+    keyPrefix?: string;
+    connectTimeoutMs?: number;
+}
+interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode?: "EX", ttlSec?: number): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    incr(key: string): Promise<number>;
+    expire(key: string, ttlSec: number): Promise<unknown>;
+    quit(): Promise<unknown>;
+}
+export declare class RedisCacheClient implements CacheClient {
+    private readonly client;
+    private readonly keyPrefix;
+    constructor(client: RedisLikeClient, keyPrefix: string);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttlSec?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    incr(key: string, ttlSec?: number): Promise<number>;
+    close(): Promise<void>;
+    private key;
+}
+export declare function createRedisCacheClient(options?: RedisCacheClientOptions): Promise<RedisCacheClient>;
+export {};
+//# sourceMappingURL=redis.d.ts.map

package/dist/cache/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/cache/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,eAAe;IACvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAEhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM;IAG9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,GAAG;CAGZ;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAmB3B"}

package/dist/cache/redis.js

@@ -0,0 +1,52 @@
+import { lazyImport } from "../internal/lazy-import.js";
+export class RedisCacheClient {
+    client;
+    keyPrefix;
+    constructor(client, keyPrefix) {
+        this.client = client;
+        this.keyPrefix = keyPrefix;
+    }
+    async get(key) {
+        return await this.client.get(this.key(key));
+    }
+    async set(key, value, ttlSec) {
+        const fullKey = this.key(key);
+        if (typeof ttlSec === "number" && ttlSec > 0) {
+            await this.client.set(fullKey, value, "EX", ttlSec);
+            return;
+        }
+        await this.client.set(fullKey, value);
+    }
+    async del(key) {
+        await this.client.del(this.key(key));
+    }
+    async incr(key, ttlSec) {
+        const fullKey = this.key(key);
+        const value = await this.client.incr(fullKey);
+        if (typeof ttlSec === "number" && ttlSec > 0 && value === 1) {
+            await this.client.expire(fullKey, ttlSec);
+        }
+        return value;
+    }
+    async close() {
+        await this.client.quit();
+    }
+    key(key) {
+        return this.keyPrefix ? `${this.keyPrefix}${key}` : key;
+    }
+}
+export async function createRedisCacheClient(options = {}) {
+    const redisModule = await lazyImport("ioredis", "Install with `pnpm add ioredis` (or npm/yarn equivalent)");
+    const RedisCtor = redisModule.default;
+    if (!RedisCtor) {
+        throw new Error("Failed to resolve ioredis default export.");
+    }
+    const url = options.url || process.env.DRAGONFLY_URL || process.env.REDIS_URL || "redis://127.0.0.1:6379";
+    const client = new RedisCtor(url, {
+        lazyConnect: false,
+        maxRetriesPerRequest: 3,
+        connectTimeout: options.connectTimeoutMs ?? 10000,
+    });
+    return new RedisCacheClient(client, options.keyPrefix || "");
+}
+//# sourceMappingURL=redis.js.map

package/dist/cache/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/cache/redis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAiBxD,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,MAAuB,EACvB,SAAiB;QADjB,WAAM,GAAN,MAAM,CAAiB;QACvB,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,MAAe;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,MAAe;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,GAAG,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAmC,EAAE;IAErC,MAAM,WAAW,GAAG,MAAM,UAAU,CAClC,SAAS,EACT,0DAA0D,CAC3D,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC;IACtC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAC1G,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE;QAChC,WAAW,EAAE,KAAK;QAClB,oBAAoB,EAAE,CAAC;QACvB,cAAc,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;KAClD,CAAC,CAAC;IAEH,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+export type DatabaseProvider = "sqlite" | "postgres" | "nucleus";
+export interface DataConfigInput {
+    database?: DatabaseProvider;
+    sqlitePath?: string;
+    postgresUrlEnv?: string;
+    /**
+     * Environment variable holding the Nucleus server URL.
+     * When `database` is `"nucleus"` (or auto-detected), this is used to
+     * configure the `@neutron-build/nucleus` client transport.
+     * Defaults to `"NUCLEUS_URL"`, falling back to the Postgres URL env var.
+     */
+    nucleusUrlEnv?: string;
+}
+export interface ResolvedDataConfig {
+    database: DatabaseProvider;
+    sqlitePath: string;
+    postgresUrlEnv: string;
+    nucleusUrlEnv: string;
+}
+export declare function resolveDataConfig(input?: DataConfigInput): ResolvedDataConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,eAAoB,GAAG,kBAAkB,CAiCjF"}

package/dist/config.js

@@ -0,0 +1,36 @@
+const DEFAULT_SQLITE_PATH = ".neutron/dev.db";
+const DEFAULT_POSTGRES_URL_ENV = "DATABASE_URL";
+const DEFAULT_NUCLEUS_URL_ENV = "NUCLEUS_URL";
+export function resolveDataConfig(input = {}) {
+    const postgresUrlEnv = input.postgresUrlEnv || DEFAULT_POSTGRES_URL_ENV;
+    const sqlitePath = input.sqlitePath || DEFAULT_SQLITE_PATH;
+    const nucleusUrlEnv = input.nucleusUrlEnv || DEFAULT_NUCLEUS_URL_ENV;
+    if (input.database) {
+        return {
+            database: input.database,
+            sqlitePath,
+            postgresUrlEnv,
+            nucleusUrlEnv,
+        };
+    }
+    // Auto-detect: check for Nucleus URL first, then Postgres, then SQLite.
+    const hasNucleusUrl = Boolean(process.env[nucleusUrlEnv]);
+    const hasPostgresUrl = Boolean(process.env[postgresUrlEnv]);
+    let database;
+    if (hasNucleusUrl) {
+        database = "nucleus";
+    }
+    else if (hasPostgresUrl) {
+        database = "postgres";
+    }
+    else {
+        database = "sqlite";
+    }
+    return {
+        database,
+        sqlitePath,
+        postgresUrlEnv,
+        nucleusUrlEnv,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAsBA,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAC9C,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAChD,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAAC,QAAyB,EAAE;IAC3D,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,wBAAwB,CAAC;IACxE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAErE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU;YACV,cAAc;YACd,aAAa;SACd,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IAE5D,IAAI,QAA0B,CAAC;IAC/B,IAAI,aAAa,EAAE,CAAC;QAClB,QAAQ,GAAG,SAAS,CAAC;IACvB,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,QAAQ,GAAG,UAAU,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC;IAED,OAAO;QACL,QAAQ;QACR,UAAU;QACV,cAAc;QACd,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/db/drizzle.d.ts

@@ -0,0 +1,23 @@
+import type { DataConfigInput } from "../config.js";
+import { type DatabaseProfile } from "./index.js";
+export interface DrizzleDatabaseOptions {
+    profile?: DatabaseProfile;
+    config?: DataConfigInput;
+    schema?: Record<string, unknown>;
+}
+export interface DrizzleDatabase {
+    profile: DatabaseProfile;
+    client: unknown;
+    db: unknown;
+    /**
+     * When connected to Nucleus, this holds the `@neutron-build/nucleus` client
+     * builder return value after `.connect()`. You can use it to access
+     * non-relational models (KV, Vector, Graph, etc.).
+     *
+     * `null` when connected to plain Postgres or SQLite.
+     */
+    nucleus: unknown | null;
+    close: () => Promise<void>;
+}
+export declare function createDrizzleDatabase(options?: DrizzleDatabaseOptions): Promise<DrizzleDatabase>;
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/db/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/db/drizzle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAG1E,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC,CAY1B"}

package/dist/db/drizzle.js

@@ -0,0 +1,124 @@
+import * as path from "node:path";
+import { resolveDatabaseProfile } from "./index.js";
+import { lazyImport } from "../internal/lazy-import.js";
+export async function createDrizzleDatabase(options = {}) {
+    const profile = options.profile || resolveDatabaseProfile(options.config);
+    if (profile.provider === "nucleus") {
+        return await createNucleusDrizzle(profile, options.schema);
+    }
+    if (profile.provider === "postgres") {
+        return await createPostgresDrizzle(profile, options.schema);
+    }
+    return await createSqliteDrizzle(profile, options.schema);
+}
+/**
+ * Create a Drizzle database backed by Nucleus.
+ *
+ * Since Nucleus speaks the PostgreSQL wire protocol, we reuse the same
+ * `postgres` driver for Drizzle ORM. In addition, we create a Nucleus
+ * client to provide access to non-relational data models.
+ */
+async function createNucleusDrizzle(profile, schema) {
+    // Use the same postgres driver — Nucleus speaks pgwire
+    const postgresModule = await lazyImport("postgres", "Install with `pnpm add postgres drizzle-orm` (or npm/yarn equivalent)");
+    const drizzleModule = await lazyImport("drizzle-orm/postgres-js", "Install with `pnpm add drizzle-orm` (or npm/yarn equivalent)");
+    if (!postgresModule.default || !drizzleModule.drizzle) {
+        throw new Error("Failed to initialize Nucleus Drizzle client.");
+    }
+    const sqlClient = postgresModule.default(profile.connectionString, {
+        max: 10,
+        idle_timeout: 20,
+        connect_timeout: 10,
+    });
+    const db = schema
+        ? drizzleModule.drizzle(sqlClient, { schema })
+        : drizzleModule.drizzle(sqlClient);
+    // Optionally create the Nucleus multi-model client.
+    // This uses `@neutron-build/nucleus` which may not be installed in every project.
+    let nucleus = null;
+    try {
+        const nucleusModule = await lazyImport("@neutron-build/nucleus", "@neutron-build/nucleus is optional for multi-model features");
+        if (nucleusModule.createClient) {
+            nucleus = await nucleusModule.createClient({
+                url: profile.connectionString,
+            }).connect();
+        }
+    }
+    catch {
+        // @neutron-build/nucleus not installed — Drizzle-only mode is fine.
+        nucleus = null;
+    }
+    return {
+        profile,
+        client: sqlClient,
+        db,
+        nucleus,
+        close: async () => {
+            if (nucleus && typeof nucleus.close === "function") {
+                await nucleus.close();
+            }
+            if (typeof sqlClient.end === "function") {
+                await sqlClient.end();
+            }
+        },
+    };
+}
+async function createPostgresDrizzle(profile, schema) {
+    const postgresModule = await lazyImport("postgres", "Install with `pnpm add postgres drizzle-orm` (or npm/yarn equivalent)");
+    const drizzleModule = await lazyImport("drizzle-orm/postgres-js", "Install with `pnpm add drizzle-orm` (or npm/yarn equivalent)");
+    if (!postgresModule.default || !drizzleModule.drizzle) {
+        throw new Error("Failed to initialize Postgres Drizzle client.");
+    }
+    const sqlClient = postgresModule.default(profile.connectionString, {
+        max: 10,
+        idle_timeout: 20,
+        connect_timeout: 10,
+    });
+    const db = schema
+        ? drizzleModule.drizzle(sqlClient, { schema })
+        : drizzleModule.drizzle(sqlClient);
+    return {
+        profile,
+        client: sqlClient,
+        db,
+        nucleus: null,
+        close: async () => {
+            if (typeof sqlClient.end === "function") {
+                await sqlClient.end();
+            }
+        },
+    };
+}
+async function createSqliteDrizzle(profile, schema) {
+    const libsqlModule = await lazyImport("@libsql/client", "Install with `pnpm add @libsql/client drizzle-orm` (or npm/yarn equivalent)");
+    const drizzleModule = await lazyImport("drizzle-orm/libsql", "Install with `pnpm add drizzle-orm` (or npm/yarn equivalent)");
+    if (!libsqlModule.createClient || !drizzleModule.drizzle) {
+        throw new Error("Failed to initialize SQLite Drizzle client.");
+    }
+    const url = normalizeSqliteConnection(profile.connectionString);
+    const client = libsqlModule.createClient({ url });
+    const db = schema ? drizzleModule.drizzle(client, { schema }) : drizzleModule.drizzle(client);
+    return {
+        profile,
+        client,
+        db,
+        nucleus: null,
+        close: async () => {
+            const maybeClose = client.close;
+            if (typeof maybeClose === "function") {
+                await maybeClose.call(client);
+            }
+        },
+    };
+}
+function normalizeSqliteConnection(connectionString) {
+    if (connectionString.startsWith("file:") ||
+        connectionString.startsWith("libsql:") ||
+        connectionString.startsWith("http://") ||
+        connectionString.startsWith("https://")) {
+        return connectionString;
+    }
+    const absolute = path.resolve(connectionString);
+    return `file:${absolute}`;
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/db/drizzle.js.map

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

package/dist/db/index.d.ts

@@ -0,0 +1,7 @@
+import { type DataConfigInput, type DatabaseProvider } from "../config.js";
+export interface DatabaseProfile {
+    provider: DatabaseProvider;
+    connectionString: string;
+}
+export declare function resolveDatabaseProfile(input?: DataConfigInput): DatabaseProfile;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,GAAE,eAAoB,GAAG,eAAe,CAsCnF"}

package/dist/db/index.js

@@ -0,0 +1,32 @@
+import { resolveDataConfig } from "../config.js";
+export function resolveDatabaseProfile(input = {}) {
+    const resolved = resolveDataConfig(input);
+    if (resolved.database === "sqlite") {
+        return {
+            provider: "sqlite",
+            connectionString: resolved.sqlitePath,
+        };
+    }
+    if (resolved.database === "nucleus") {
+        // Nucleus uses its own URL env var. Falls back to the Postgres URL if
+        // the Nucleus-specific var is not set (Nucleus speaks pgwire).
+        const connectionString = process.env[resolved.nucleusUrlEnv] ?? process.env[resolved.postgresUrlEnv];
+        if (!connectionString) {
+            throw new Error(`Nucleus profile selected but neither ${resolved.nucleusUrlEnv} nor ${resolved.postgresUrlEnv} is set.`);
+        }
+        return {
+            provider: "nucleus",
+            connectionString,
+        };
+    }
+    // postgres
+    const connectionString = process.env[resolved.postgresUrlEnv];
+    if (!connectionString) {
+        throw new Error(`Postgres profile selected but ${resolved.postgresUrlEnv} is not set.`);
+    }
+    return {
+        provider: "postgres",
+        connectionString,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA+C,MAAM,cAAc,CAAC;AAO9F,MAAM,UAAU,sBAAsB,CAAC,QAAyB,EAAE;IAChE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE1C,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,gBAAgB,EAAE,QAAQ,CAAC,UAAU;SACtC,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,sEAAsE;QACtE,+DAA+D;QAC/D,MAAM,gBAAgB,GACpB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC9E,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,CAAC,aAAa,QAAQ,QAAQ,CAAC,cAAc,UAAU,CACxG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAED,WAAW;IACX,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,iCAAiC,QAAQ,CAAC,cAAc,cAAc,CACvE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { resolveDataConfig, type DataConfigInput, type ResolvedDataConfig, type DatabaseProvider, } from "./config.js";
+export { resolveDatabaseProfile, type DatabaseProfile, } from "./db/index.js";
+export { createDrizzleDatabase, type DrizzleDatabase, type DrizzleDatabaseOptions, } from "./db/drizzle.js";
+export { MemoryCacheClient, type CacheClient, } from "./cache/index.js";
+export { RedisCacheClient, createRedisCacheClient, type RedisCacheClientOptions, } from "./cache/redis.js";
+export { NucleusCacheClient, createNucleusCacheClient, type NucleusCacheClientOptions, type NucleusKVLike, } from "./cache/nucleus.js";
+export { createSessionStore, type SessionData, type SessionRecord, type SessionStore, type SessionStoreOptions, } from "./session/index.js";
+export { createRedisSessionStore, type RedisSessionStore, type RedisSessionStoreOptions, } from "./session/redis.js";
+export { enforceSlidingWindow, type SlidingWindowOptions, type SlidingWindowResult, } from "./ratelimit/index.js";
+export { InMemoryQueueDriver, type QueueDriver, type Job, type JobHandler, } from "./queue/index.js";
+export { BullMqQueueDriver, createBullMqQueueDriver, type BullMqQueueDriverOptions, } from "./queue/bullmq.js";
+export { createJobs, type JobsOptions, } from "./jobs/index.js";
+export { InMemoryStorageDriver, type StorageDriver, type StorageObject, } from "./storage/index.js";
+export { S3StorageDriver, createS3StorageDriver, type S3StorageDriverOptions, } from "./storage/s3.js";
+export { NucleusStorageDriver, createNucleusStorageDriver, type NucleusStorageDriverOptions, type NucleusBlobLike, } from "./storage/nucleus.js";
+export { InMemoryRealtimeBus, type RealtimeBus, } from "./realtime/index.js";
+export { RedisRealtimeBus, createRedisRealtimeBus, type RedisRealtimeBusOptions, } from "./realtime/redis.js";
+export { NucleusRealtimeBus, createNucleusRealtimeBus, type NucleusRealtimeBusOptions, type NucleusPubSubLike, } from "./realtime/nucleus.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,GAAG,EACR,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export { resolveDataConfig, } from "./config.js";
+export { resolveDatabaseProfile, } from "./db/index.js";
+export { createDrizzleDatabase, } from "./db/drizzle.js";
+export { MemoryCacheClient, } from "./cache/index.js";
+export { RedisCacheClient, createRedisCacheClient, } from "./cache/redis.js";
+export { NucleusCacheClient, createNucleusCacheClient, } from "./cache/nucleus.js";
+export { createSessionStore, } from "./session/index.js";
+export { createRedisSessionStore, } from "./session/redis.js";
+export { enforceSlidingWindow, } from "./ratelimit/index.js";
+export { InMemoryQueueDriver, } from "./queue/index.js";
+export { BullMqQueueDriver, createBullMqQueueDriver, } from "./queue/bullmq.js";
+export { createJobs, } from "./jobs/index.js";
+export { InMemoryStorageDriver, } from "./storage/index.js";
+export { S3StorageDriver, createS3StorageDriver, } from "./storage/s3.js";
+export { NucleusStorageDriver, createNucleusStorageDriver, } from "./storage/nucleus.js";
+export { InMemoryRealtimeBus, } from "./realtime/index.js";
+export { RedisRealtimeBus, createRedisRealtimeBus, } from "./realtime/redis.js";
+export { NucleusRealtimeBus, createNucleusRealtimeBus, } from "./realtime/nucleus.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAIlB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,GAEvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,kBAAkB,GAKnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,GAGxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,GAIpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,GAEX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,GAGtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAG3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAGzB,MAAM,uBAAuB,CAAC"}