@nauth-toolkit/core 0.1.14 → 0.1.18

package/dist/adapters/fastify.adapter.js

@@ -1,24 +1,58 @@
 "use strict";
+/**
+ * Fastify Framework Adapter
+ *
+ * Adapts NAuth to work with Fastify with proper AsyncLocalStorage support.
+ *
+ * **Context Management:**
+ * - First hook (clientInfo) initializes AsyncLocalStorage context
+ * - Context is stored on request object for subsequent hooks
+ * - Each hook restores context using ContextStorage.enterStore()
+ * - Route handlers MUST use wrapRouteHandler() for context access
+ *
+ * **Why Context Restoration is Needed:**
+ * Unlike Express where middleware runs in a continuous call stack,
+ * Fastify hooks run independently. Each hook invocation loses the
+ * AsyncLocalStorage context, so we store it on the request and restore it.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FastifyAdapter = void 0;
 const context_storage_1 = require("../utils/context-storage");
+// Symbol for storing context on request (avoids property name collisions)
 const NAUTH_CONTEXT_STORE = Symbol.for('nauth.contextStore');
 const NAUTH_ATTRIBUTES = Symbol.for('nauth.attributes');
+// ============================================================================
+// Fastify Adapter
+// ============================================================================
+/**
+ * Fastify Adapter Implementation
+ *
+ * Provides NAuth integration for Fastify applications.
+ */
 class FastifyAdapter {
     name = 'FastifyAdapter';
+    /**
+     * Register a middleware handler as Fastify hook
+     *
+     * Handles context initialization for first hook and restoration for subsequent hooks.
+     */
     registerMiddleware(name, handler, options) {
         const initializesContext = options?.initializesContext || name === 'clientInfo';
         return async (request, reply) => {
+            // Ensure we have attribute storage
             this.ensureAttributes(request);
             const nauthReq = new FastifyRequestWrapper(request);
             const nauthRes = new FastifyResponseWrapper(reply);
             if (initializesContext) {
+                // First hook - initialize context
                 await context_storage_1.ContextStorage.run(async () => {
+                    // Store context on request for subsequent hooks
                     request[NAUTH_CONTEXT_STORE] = context_storage_1.ContextStorage.getStore();
                     await this.executeHandler(handler, nauthReq, nauthRes);
                 });
             }
             else {
+                // Subsequent hook - restore context
                 const store = request[NAUTH_CONTEXT_STORE];
                 if (store) {
                     await context_storage_1.ContextStorage.enterStore(store, async () => {
@@ -26,11 +60,16 @@ class FastifyAdapter {
                     });
                 }
                 else {
+                    // No context available - execute without context
+                    // This shouldn't happen if clientInfo runs first
                     await this.executeHandler(handler, nauthReq, nauthRes);
                 }
             }
         };
     }
+    /**
+     * Execute handler with proper async flow control
+     */
     async executeHandler(handler, req, res) {
         await new Promise((resolve, reject) => {
             const result = handler(req, res, () => {
@@ -41,18 +80,26 @@ class FastifyAdapter {
             }
         });
     }
+    /**
+     * Register a response interceptor using Fastify onSend hook
+     *
+     * The onSend hook receives the serialized payload before sending.
+     */
     registerResponseInterceptor(handler) {
         return async (request, reply, payload) => {
             this.ensureAttributes(request);
             const nauthReq = new FastifyRequestWrapper(request);
             const nauthRes = new FastifyResponseWrapper(reply);
+            // Restore context for interceptor
             const store = request[NAUTH_CONTEXT_STORE];
             if (!store) {
+                // No context - pass through unchanged
                 return payload;
             }
             return context_storage_1.ContextStorage.enterStore(store, async () => {
                 try {
                     let parsedPayload = payload;
+                    // Parse JSON payload if needed (Fastify serializes before onSend)
                     const contentType = reply.getHeader('content-type');
                     const isJson = contentType?.includes('application/json');
                     if (isJson && typeof payload === 'string') {
@@ -60,34 +107,47 @@ class FastifyAdapter {
                             parsedPayload = JSON.parse(payload);
                         }
                         catch {
+                            // Not valid JSON, use as-is
                         }
                     }
                     const modifiedBody = await handler(nauthReq, nauthRes, parsedPayload);
+                    // Re-serialize if we parsed it
                     if (modifiedBody !== parsedPayload && isJson && typeof modifiedBody === 'object') {
                         return JSON.stringify(modifiedBody);
                     }
                     return modifiedBody !== parsedPayload ? modifiedBody : payload;
                 }
                 catch {
+                    // On error, return original payload
                     return payload;
                 }
             });
         };
     }
+    /**
+     * Wrap a route handler to ensure context is available
+     *
+     * For Fastify, this is REQUIRED for route handlers to access ContextStorage.
+     */
     wrapRouteHandler(handler) {
         return async (request, reply) => {
             this.ensureAttributes(request);
             const nauthReq = new FastifyRequestWrapper(request);
             const nauthRes = new FastifyResponseWrapper(reply);
+            // Restore context
             const store = request[NAUTH_CONTEXT_STORE];
             if (store) {
                 return context_storage_1.ContextStorage.enterStore(store, async () => {
                     return handler(nauthReq, nauthRes);
                 });
             }
+            // No context - execute without (shouldn't happen with proper setup)
             return handler(nauthReq, nauthRes);
         };
     }
+    /**
+     * Ensure attribute storage exists on request
+     */
     ensureAttributes(request) {
         if (!request[NAUTH_ATTRIBUTES]) {
             request[NAUTH_ATTRIBUTES] = {};
@@ -95,6 +155,12 @@ class FastifyAdapter {
     }
 }
 exports.FastifyAdapter = FastifyAdapter;
+// ============================================================================
+// Fastify Request Wrapper
+// ============================================================================
+/**
+ * Wraps Fastify request into NAuthRequest interface
+ */
 class FastifyRequestWrapper {
     request;
     constructor(request) {
@@ -107,6 +173,7 @@ class FastifyRequestWrapper {
         return this.request.method.toUpperCase();
     }
     get path() {
+        // Fastify provides routeOptions.url for path, or extract from url
         return this.request.url.split('?')[0];
     }
     get url() {
@@ -125,12 +192,14 @@ class FastifyRequestWrapper {
         return this.request.headers;
     }
     get cookies() {
+        // Fastify with @fastify/cookie
         return this.request.cookies || {};
     }
     get ip() {
         return this.request.ip || '0.0.0.0';
     }
     get attributes() {
+        // Return isolated storage
         return this.request[NAUTH_ATTRIBUTES] || {};
     }
     getHeader(name) {
@@ -140,6 +209,12 @@ class FastifyRequestWrapper {
         return val;
     }
 }
+// ============================================================================
+// Fastify Response Wrapper
+// ============================================================================
+/**
+ * Wraps Fastify reply into NAuthResponse interface
+ */
 class FastifyResponseWrapper {
     reply;
     constructor(reply) {
@@ -157,6 +232,7 @@ class FastifyResponseWrapper {
         return this;
     }
     setCookie(name, value, options) {
+        // Fastify with @fastify/cookie
         const replyWithCookies = this.reply;
         if (typeof replyWithCookies.setCookie === 'function') {
             replyWithCookies.setCookie(name, value, this.convertCookieOptions(options));
@@ -169,6 +245,7 @@ class FastifyResponseWrapper {
             replyWithCookies.clearCookie(name, this.convertCookieOptions(options));
         }
         else if (typeof replyWithCookies.setCookie === 'function') {
+            // Fallback: set empty cookie with immediate expiry
             replyWithCookies.setCookie(name, '', {
                 ...this.convertCookieOptions(options),
                 maxAge: 0,
@@ -181,6 +258,7 @@ class FastifyResponseWrapper {
         this.reply.send(body);
     }
     json(body) {
+        // Fastify auto-serializes objects
         this.reply.send(body);
     }
     redirect(url, status) {
@@ -194,6 +272,9 @@ class FastifyResponseWrapper {
     isSent() {
         return this.reply.sent;
     }
+    /**
+     * Convert NAuth cookie options to Fastify cookie options
+     */
     convertCookieOptions(options) {
         if (!options)
             return {};
@@ -208,4 +289,9 @@ class FastifyResponseWrapper {
         };
     }
 }
+// ============================================================================
+// NOTE
+// ============================================================================
+// For route handlers, use `nauth.adapter.wrapRouteHandler(...)` to ensure AsyncLocalStorage
+// context is available when calling `nauth.helpers.*` and context-dependent services.
 //# sourceMappingURL=fastify.adapter.js.map

package/dist/adapters/fastify.adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Platform Adapters
+ *
+ * Framework-specific adapters that implement NAuthAdapter interface.
+ */
 export * from '../platform/interfaces';
 export { ExpressAdapter, ExpressMiddlewareType } from './express.adapter';
 export { FastifyAdapter } from './fastify.adapter';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAOA,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/adapters/index.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Platform Adapters
+ *
+ * Framework-specific adapters that implement NAuthAdapter interface.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -15,9 +20,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FastifyAdapter = exports.ExpressAdapter = void 0;
+// Platform interfaces (for custom adapter development)
 __exportStar(require("../platform/interfaces"), exports);
+// Built-in adapters
 var express_adapter_1 = require("./express.adapter");
 Object.defineProperty(exports, "ExpressAdapter", { enumerable: true, get: function () { return express_adapter_1.ExpressAdapter; } });
 var fastify_adapter_1 = require("./fastify.adapter");
 Object.defineProperty(exports, "FastifyAdapter", { enumerable: true, get: function () { return fastify_adapter_1.FastifyAdapter; } });
+// Legacy export for backward compatibility (deprecated)
+// TODO: Remove in next major version
 //# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAOA,yDAAuC;AAGvC,qDAA0E;AAAjE,iHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,uDAAuD;AACvD,yDAAuC;AAEvC,oBAAoB;AACpB,qDAA0E;AAAjE,iHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,wDAAwD;AACxD,qCAAqC"}

package/dist/adapters/storage.factory.d.ts

@@ -1,6 +1,113 @@
+/**
+ * Storage Adapter Factory Functions
+ *
+ * Provides clean factory functions for creating storage adapters.
+ * These factories handle proper initialization and simplify configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createDatabaseStorageAdapter, createRedisStorageAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Database adapter (uses existing TypeORM connection)
+ *   storageAdapter: createDatabaseStorageAdapter(),
+ *
+ *   // Or Redis adapter
+ *   storageAdapter: createRedisStorageAdapter(process.env.REDIS_URL),
+ * };
+ * ```
+ */
 import { StorageAdapter } from '../interfaces/storage-adapter.interface';
+/**
+ * Create a database storage adapter
+ *
+ * Uses the existing TypeORM connection. Make sure storage entities are included
+ * in your DataSource configuration:
+ *
+ * ```typescript
+ * import { getNAuthTransientStorageEntities } from '@nauth-toolkit/database-typeorm-postgres';
+ * const dataSource = new DataSource({
+ *   entities: [...getNAuthEntities(), ...getNAuthTransientStorageEntities()],
+ * });
+ * ```
+ *
+ * @returns DatabaseStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createDatabaseStorageAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   storageAdapter: createDatabaseStorageAdapter(),
+ *   // ... other config
+ * };
+ * ```
+ */
 export declare function createDatabaseStorageAdapter(): StorageAdapter;
+/**
+ * Create a Redis storage adapter
+ *
+ * Creates and connects a Redis client automatically using the `redis` package (node-redis).
+ * The client connection is managed internally by the adapter.
+ *
+ * Supports both single-instance Redis and Redis Cluster configurations.
+ *
+ * @param url - Redis connection URL (default: 'redis://localhost:6379')
+ *   Supports authentication in URL format:
+ *   - redis://localhost:6379 (no auth)
+ *   - redis://:password@localhost:6379 (password only)
+ *   - redis://username:password@localhost:6379 (username + password)
+ *   - rediss://localhost:6379 (TLS/SSL, with optional auth)
+ * @returns RedisStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createRedisStorageAdapter, createRedisClusterAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Single-instance Redis
+ *   storageAdapter: createRedisStorageAdapter(process.env.REDIS_URL),
+ *
+ *   // Or Redis Cluster (for production high-availability)
+ *   storageAdapter: createRedisClusterAdapter([
+ *     { url: 'redis://redis-node-1:6379' },
+ *     { url: 'redis://redis-node-2:6379' },
+ *     { url: 'redis://redis-node-3:6379' },
+ *   ]),
+ * };
+ * ```
+ */
 export declare function createRedisStorageAdapter(url?: string): StorageAdapter;
+/**
+ * Create a Redis Cluster storage adapter
+ *
+ * Creates and connects a Redis Cluster client automatically using the `redis` package (node-redis).
+ * The cluster client handles automatic topology discovery, command routing, and failover.
+ *
+ * **Production Use:**
+ * Use Redis Cluster for high-availability production deployments. The cluster automatically:
+ * - Discovers cluster topology
+ * - Routes commands to correct nodes based on key hash slots
+ * - Handles node failures and redirects (MOVED/ASK errors)
+ * - Provides high availability and horizontal scaling
+ *
+ * @param nodes - Array of cluster node URLs
+ * @returns RedisStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createRedisClusterAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Redis Cluster with 3 nodes
+ *   storageAdapter: createRedisClusterAdapter([
+ *     { url: 'redis://redis-node-1:6379' },
+ *     { url: 'redis://redis-node-2:6379' },
+ *     { url: 'redis://redis-node-3:6379' },
+ *   ]),
+ * };
+ * ```
+ */
 export declare function createRedisClusterAdapter(nodes: Array<{
     url: string;
 }>): StorageAdapter;

package/dist/adapters/storage.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.factory.d.ts","sourceRoot":"","sources":["../../src/adapters/storage.factory.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,4BAA4B,IAAI,cAAc,CAI7D;AAmCD,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAiC,GAAG,cAAc,CAWhG;AAgCD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,CAavF"}
+{"version":3,"file":"storage.factory.d.ts","sourceRoot":"","sources":["../../src/adapters/storage.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,4BAA4B,IAAI,cAAc,CAI7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAiC,GAAG,cAAc,CAWhG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,CAavF"}

package/dist/adapters/storage.factory.js

@@ -1,24 +1,138 @@
 "use strict";
+/**
+ * Storage Adapter Factory Functions
+ *
+ * Provides clean factory functions for creating storage adapters.
+ * These factories handle proper initialization and simplify configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createDatabaseStorageAdapter, createRedisStorageAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Database adapter (uses existing TypeORM connection)
+ *   storageAdapter: createDatabaseStorageAdapter(),
+ *
+ *   // Or Redis adapter
+ *   storageAdapter: createRedisStorageAdapter(process.env.REDIS_URL),
+ * };
+ * ```
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDatabaseStorageAdapter = createDatabaseStorageAdapter;
 exports.createRedisStorageAdapter = createRedisStorageAdapter;
 exports.createRedisClusterAdapter = createRedisClusterAdapter;
+/**
+ * Create a database storage adapter
+ *
+ * Uses the existing TypeORM connection. Make sure storage entities are included
+ * in your DataSource configuration:
+ *
+ * ```typescript
+ * import { getNAuthTransientStorageEntities } from '@nauth-toolkit/database-typeorm-postgres';
+ * const dataSource = new DataSource({
+ *   entities: [...getNAuthEntities(), ...getNAuthTransientStorageEntities()],
+ * });
+ * ```
+ *
+ * @returns DatabaseStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createDatabaseStorageAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   storageAdapter: createDatabaseStorageAdapter(),
+ *   // ... other config
+ * };
+ * ```
+ */
 function createDatabaseStorageAdapter() {
+    // Lazy import to avoid bundling if not used
     const { DatabaseStorageAdapter } = require('@nauth-toolkit/storage-database');
     return new DatabaseStorageAdapter(null, null, null);
 }
+/**
+ * Create a Redis storage adapter
+ *
+ * Creates and connects a Redis client automatically using the `redis` package (node-redis).
+ * The client connection is managed internally by the adapter.
+ *
+ * Supports both single-instance Redis and Redis Cluster configurations.
+ *
+ * @param url - Redis connection URL (default: 'redis://localhost:6379')
+ *   Supports authentication in URL format:
+ *   - redis://localhost:6379 (no auth)
+ *   - redis://:password@localhost:6379 (password only)
+ *   - redis://username:password@localhost:6379 (username + password)
+ *   - rediss://localhost:6379 (TLS/SSL, with optional auth)
+ * @returns RedisStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createRedisStorageAdapter, createRedisClusterAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Single-instance Redis
+ *   storageAdapter: createRedisStorageAdapter(process.env.REDIS_URL),
+ *
+ *   // Or Redis Cluster (for production high-availability)
+ *   storageAdapter: createRedisClusterAdapter([
+ *     { url: 'redis://redis-node-1:6379' },
+ *     { url: 'redis://redis-node-2:6379' },
+ *     { url: 'redis://redis-node-3:6379' },
+ *   ]),
+ * };
+ * ```
+ */
 function createRedisStorageAdapter(url = 'redis://localhost:6379') {
+    // Lazy import to avoid bundling if not used
     const { RedisStorageAdapter } = require('@nauth-toolkit/storage-redis');
     const { createClient } = require('redis');
     const redisClient = createClient({ url });
+    // Don't connect here - let adapter.initialize() handle connection
+    // This ensures proper error handling and allows initialize() to wait for connection
     return new RedisStorageAdapter(redisClient);
 }
+/**
+ * Create a Redis Cluster storage adapter
+ *
+ * Creates and connects a Redis Cluster client automatically using the `redis` package (node-redis).
+ * The cluster client handles automatic topology discovery, command routing, and failover.
+ *
+ * **Production Use:**
+ * Use Redis Cluster for high-availability production deployments. The cluster automatically:
+ * - Discovers cluster topology
+ * - Routes commands to correct nodes based on key hash slots
+ * - Handles node failures and redirects (MOVED/ASK errors)
+ * - Provides high availability and horizontal scaling
+ *
+ * @param nodes - Array of cluster node URLs
+ * @returns RedisStorageAdapter instance
+ *
+ * @example
+ * ```typescript
+ * import { createRedisClusterAdapter } from '@nauth-toolkit/express';
+ *
+ * export const authConfig = {
+ *   // Redis Cluster with 3 nodes
+ *   storageAdapter: createRedisClusterAdapter([
+ *     { url: 'redis://redis-node-1:6379' },
+ *     { url: 'redis://redis-node-2:6379' },
+ *     { url: 'redis://redis-node-3:6379' },
+ *   ]),
+ * };
+ * ```
+ */
 function createRedisClusterAdapter(nodes) {
+    // Lazy import to avoid bundling if not used
     const { RedisStorageAdapter } = require('@nauth-toolkit/storage-redis');
     const { createCluster } = require('redis');
     const clusterClient = createCluster({
         rootNodes: nodes,
     });
+    // Don't connect here - let adapter.initialize() handle connection
+    // This ensures proper error handling and allows initialize() to wait for connection
     return new RedisStorageAdapter(clusterClient);
 }
 //# sourceMappingURL=storage.factory.js.map

package/dist/adapters/storage.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.factory.js","sourceRoot":"","sources":["../../src/adapters/storage.factory.ts"],"names":[],"mappings":";;AA+CA,oEAIC;AAmCD,8DAWC;AAgCD,8DAaC;AA/FD,SAAgB,4BAA4B;IAE1C,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAC9E,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAmCD,SAAgB,yBAAyB,CAAC,MAAc,wBAAwB;IAE9E,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACxE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAK1C,OAAO,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAgCD,SAAgB,yBAAyB,CAAC,KAA6B;IAErE,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACxE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,aAAa,CAAC;QAClC,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IAKH,OAAO,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"storage.factory.js","sourceRoot":"","sources":["../../src/adapters/storage.factory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AA6BH,oEAIC;AAmCD,8DAWC;AAgCD,8DAaC;AAxHD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,4BAA4B;IAC1C,4CAA4C;IAC5C,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAC9E,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,yBAAyB,CAAC,MAAc,wBAAwB;IAC9E,4CAA4C;IAC5C,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACxE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,WAAW,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAE1C,kEAAkE;IAClE,oFAAoF;IAEpF,OAAO,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,yBAAyB,CAAC,KAA6B;IACrE,4CAA4C;IAC5C,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACxE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,aAAa,GAAG,aAAa,CAAC;QAClC,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,kEAAkE;IAClE,oFAAoF;IAEpF,OAAO,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/adapters.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Adapters barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./adapters.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 export * from './adapters/index';
 //# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAQA,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,kBAAkB,CAAC"}

package/dist/adapters.js

@@ -14,5 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Adapters barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./adapters.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 __exportStar(require("./adapters/index"), exports);
 //# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAQA,mDAAiC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,mDAAiC"}