@pantheon-systems/nextjs-cache-handler 0.1.0

package/README.md

@@ -0,0 +1,256 @@
+# @pantheon-systems/nextjs-cache-handler
+
+Custom cache handler for Next.js with support for Google Cloud Storage and file-based caching. Designed for Pantheon's Next.js hosting platform.
+
+## Features
+
+- **Dual Cache Handlers**: Support for both GCS (production) and file-based (development) caching
+- **Tag-Based Invalidation**: Efficient O(1) cache invalidation using tag mapping
+- **Buffer Serialization**: Handles Next.js 15 buffer compatibility issues
+- **Build-Aware Caching**: Automatically invalidates route cache on new builds
+- **Static Route Preservation**: Preserves SSG routes during cache clearing
+
+## Installation
+
+```bash
+npm install @pantheon-systems/nextjs-cache-handler
+```
+
+## Quick Start
+
+### 1. Create a cache handler file
+
+```typescript
+// cacheHandler.ts
+import { createCacheHandler } from '@pantheon-systems/nextjs-cache-handler';
+
+const CacheHandler = createCacheHandler({
+  type: 'auto', // Auto-detect: GCS if CACHE_BUCKET exists, else file-based
+});
+
+export default CacheHandler;
+```
+
+### 2. Configure Next.js
+
+```javascript
+// next.config.mjs
+const nextConfig = {
+  cacheHandler: require.resolve('./cacheHandler'),
+  cacheMaxMemorySize: 0, // Disable in-memory caching to use custom handler
+};
+
+export default nextConfig;
+```
+
+## Configuration
+
+### `createCacheHandler(config?)`
+
+Creates a cache handler based on the provided configuration.
+
+```typescript
+interface CacheHandlerConfig {
+  /**
+   * Handler type selection:
+   * - 'auto': Automatically detect based on environment (GCS if CACHE_BUCKET is set, otherwise file)
+   * - 'file': Use file-based caching (local development)
+   * - 'gcs': Use Google Cloud Storage (production/Pantheon)
+   */
+  type?: 'auto' | 'file' | 'gcs';
+}
+```
+
+> **Note:** Debug logging is controlled via the `CACHE_DEBUG` environment variable. See the [Debugging](#debugging) section for details.
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `CACHE_BUCKET` | GCS bucket name for storing cache | Required for GCS handler |
+| `OUTBOUND_PROXY_ENDPOINT` | Edge cache proxy endpoint | Optional (enables edge cache clearing) |
+| `CACHE_DEBUG` | Enable debug logging (`true` or `1`) | Optional |
+
+## API Reference
+
+### `createCacheHandler(config?)`
+
+Factory function that returns the appropriate cache handler class based on configuration.
+
+```typescript
+import { createCacheHandler } from '@pantheon-systems/nextjs-cache-handler';
+
+// Auto-detect based on environment
+const CacheHandler = createCacheHandler();
+
+// Force file-based caching
+const FileCacheHandler = createCacheHandler({ type: 'file' });
+
+// Force GCS caching
+const GcsCacheHandler = createCacheHandler({ type: 'gcs' });
+```
+
+### `getSharedCacheStats()`
+
+Returns cache statistics for the current environment.
+
+```typescript
+import { getSharedCacheStats } from '@pantheon-systems/nextjs-cache-handler';
+
+const stats = await getSharedCacheStats();
+console.log(stats);
+// {
+//   size: 10,
+//   keys: ['fetch:abc123', 'route:_index'],
+//   entries: [
+//     { key: 'fetch:abc123', tags: ['posts'], type: 'fetch', lastModified: 1234567890 }
+//   ]
+// }
+```
+
+### `clearSharedCache()`
+
+Clears all cache entries (preserving static SSG routes).
+
+```typescript
+import { clearSharedCache } from '@pantheon-systems/nextjs-cache-handler';
+
+const clearedCount = await clearSharedCache();
+console.log(`Cleared ${clearedCount} cache entries`);
+```
+
+### Direct Handler Access
+
+For advanced use cases, you can import the handlers directly:
+
+```typescript
+import { FileCacheHandler, GcsCacheHandler } from '@pantheon-systems/nextjs-cache-handler';
+
+// Use directly in your configuration
+export default FileCacheHandler;
+```
+
+## Cache Types
+
+The handler distinguishes between two cache types:
+
+- **Fetch Cache**: Stores data from `fetch()` calls with caching enabled
+- **Route Cache**: Stores rendered pages and route data
+
+## Tag-Based Invalidation
+
+The handler maintains a tag-to-keys mapping for efficient O(1) cache invalidation:
+
+```typescript
+// When setting cache with tags
+await cacheHandler.set('post-1', data, { tags: ['posts', 'blog'] });
+
+// When invalidating by tag
+await cacheHandler.revalidateTag('posts');
+// All entries tagged with 'posts' are invalidated
+```
+
+## Build Invalidation
+
+On each new build, the handler automatically:
+
+1. Detects the new build ID
+2. Invalidates the route cache (Full Route Cache)
+3. Preserves the data cache (Fetch Cache)
+
+This matches Next.js's expected behavior where route cache is invalidated on each deploy but data cache persists.
+
+## Debugging
+
+Enable debug logging to see detailed cache operations by setting the `CACHE_DEBUG` environment variable:
+
+```bash
+# Enable debug logging
+CACHE_DEBUG=true npm run start
+
+# Or
+CACHE_DEBUG=1 npm run start
+```
+
+### Log Levels
+
+The cache handler uses four log levels:
+
+| Level | When Shown | Use Case |
+|-------|------------|----------|
+| `debug` | Only when `CACHE_DEBUG=true` | Verbose operational logs (GET, SET, HIT, MISS) |
+| `info` | Only when `CACHE_DEBUG=true` | Important events (initialization, cache cleared) |
+| `warn` | Always | Recoverable issues that might need attention |
+| `error` | Always | Errors that affect cache operations |
+
+### Example Output
+
+When debug logging is enabled, you'll see output like:
+
+```
+[GcsCacheHandler] Initializing cache handler
+[GcsCacheHandler] GET: /api/posts
+[GcsCacheHandler] HIT: /api/posts (route)
+[GcsCacheHandler] SET: /api/users (fetch)
+[EdgeCacheClear] Cleared 3 paths in 45ms
+[GcsCacheHandler] Revalidated 5 entries for tags: posts, blog
+```
+
+This helps diagnose cache behavior, verify cache hits/misses, and troubleshoot invalidation issues.
+
+## Publishing
+
+### Prerequisites
+
+1. Ensure you're logged into npm with access to the `@pantheon-systems` scope:
+   ```bash
+   npm login --scope=@pantheon-systems
+   ```
+
+2. Verify your login:
+   ```bash
+   npm whoami
+   ```
+
+### Publishing Steps
+
+1. **Update the version** in `package.json`:
+   ```bash
+   # Patch release (0.1.0 -> 0.1.1)
+   npm version patch
+
+   # Minor release (0.1.0 -> 0.2.0)
+   npm version minor
+
+   # Major release (0.1.0 -> 1.0.0)
+   npm version major
+   ```
+
+2. **Build and test**:
+   ```bash
+   npm run build
+   npm test
+   ```
+
+3. **Publish to npm**:
+   ```bash
+   npm publish --access public
+   ```
+
+   The `--access public` flag is required for scoped packages to be publicly accessible.
+
+### Verify Publication
+
+After publishing, verify the package is available:
+```bash
+npm view @pantheon-systems/nextjs-cache-handler
+```
+
+Or install it in a test project:
+```bash
+npm install @pantheon-systems/nextjs-cache-handler
+```
+
+## License
+
+MIT

package/dist/edge/edge-cache-clear.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Result of a cache clear operation.
+ * @internal
+ */
+interface CacheClearResult {
+    success: boolean;
+    error?: string;
+    statusCode?: number;
+    duration?: number;
+    paths?: string[];
+}
+/**
+ * Edge cache clearer for clearing CDN cache via the outbound proxy.
+ * This is an internal class not exposed in the public API.
+ * @internal
+ */
+export declare class EdgeCacheClear {
+    private baseUrl;
+    constructor(endpoint?: string);
+    /**
+     * Clear the entire edge cache (nuclear option).
+     */
+    nukeCache(): Promise<CacheClearResult>;
+    /**
+     * Clear specific paths from the edge cache (granular invalidation).
+     * @param paths Array of paths to clear (e.g., ['/blogs/my-post', '/blogs'])
+     */
+    clearPaths(paths: string[]): Promise<CacheClearResult>;
+    private clearSinglePath;
+    /**
+     * Clear a single path from the edge cache.
+     */
+    clearPath(routePath: string): Promise<CacheClearResult>;
+    /**
+     * Clear paths in the background (non-blocking).
+     */
+    clearPathsInBackground(paths: string[], context: string): void;
+    /**
+     * Clear a single path in the background (non-blocking).
+     */
+    clearPathInBackground(routePath: string, context: string): void;
+    /**
+     * Clear cache entries by key/tag.
+     * @param keys Array of cache keys/tags to clear
+     */
+    clearKeys(keys: string[]): Promise<CacheClearResult>;
+    private clearSingleKey;
+    /**
+     * Clear keys in the background (non-blocking).
+     */
+    clearKeysInBackground(keys: string[], context: string): void;
+    /**
+     * Clear entire cache in the background (non-blocking).
+     */
+    nukeCacheInBackground(context: string): void;
+}
+/**
+ * Creates an EdgeCacheClear instance if the environment is configured.
+ * Returns null if edge cache clearing is not available.
+ * @internal
+ */
+export declare function createEdgeCacheClearer(): EdgeCacheClear | null;
+export {};
+//# sourceMappingURL=edge-cache-clear.d.ts.map

package/dist/edge/edge-cache-clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-cache-clear.d.ts","sourceRoot":"","sources":["../../src/edge/edge-cache-clear.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,CAAC,EAAE,MAAM;IAQ7B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAqC5C;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;YA8B9C,eAAe;IAmC7B;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7D;;OAEG;IACH,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB9D;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/D;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;YA8B5C,cAAc;IAgC5B;;OAEG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB5D;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAa7C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,GAAG,IAAI,CAM9D"}

package/dist/edge/edge-cache-clear.js

@@ -0,0 +1,245 @@
+import { createLogger } from '../utils/logger.js';
+const edgeLog = createLogger('EdgeCacheClear');
+/**
+ * Edge cache clearer for clearing CDN cache via the outbound proxy.
+ * This is an internal class not exposed in the public API.
+ * @internal
+ */
+export class EdgeCacheClear {
+    constructor(endpoint) {
+        const proxyEndpoint = endpoint || process.env.OUTBOUND_PROXY_ENDPOINT;
+        if (!proxyEndpoint) {
+            throw new Error('OUTBOUND_PROXY_ENDPOINT environment variable is required for edge cache clearing');
+        }
+        this.baseUrl = `http://${proxyEndpoint}/rest/v0alpha1/cache`;
+    }
+    /**
+     * Clear the entire edge cache (nuclear option).
+     */
+    async nukeCache() {
+        const startTime = Date.now();
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 10000);
+            const response = await fetch(this.baseUrl, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const duration = Date.now() - startTime;
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => 'Unknown error');
+                return {
+                    success: false,
+                    error: `HTTP ${response.status}: ${errorText}`,
+                    statusCode: response.status,
+                    duration,
+                };
+            }
+            edgeLog.debug(`Cleared entire edge cache in ${duration}ms`);
+            return { success: true, statusCode: response.status, duration };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: errorMessage, duration };
+        }
+    }
+    /**
+     * Clear specific paths from the edge cache (granular invalidation).
+     * @param paths Array of paths to clear (e.g., ['/blogs/my-post', '/blogs'])
+     */
+    async clearPaths(paths) {
+        if (paths.length === 0) {
+            return { success: true, duration: 0, paths: [] };
+        }
+        const startTime = Date.now();
+        const results = [];
+        try {
+            const clearPromises = paths.map((routePath) => this.clearSinglePath(routePath, results));
+            await Promise.all(clearPromises);
+            const duration = Date.now() - startTime;
+            const successCount = results.filter((r) => r.success).length;
+            const clearedPaths = results.filter((r) => r.success).map((r) => r.path);
+            edgeLog.debug(`Cleared ${successCount}/${paths.length} paths in ${duration}ms`);
+            return {
+                success: successCount > 0,
+                duration,
+                paths: clearedPaths,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: errorMessage, duration, paths: [] };
+        }
+    }
+    async clearSinglePath(routePath, results) {
+        try {
+            const normalizedPath = routePath.startsWith('/') ? routePath : `/${routePath}`;
+            const cleanPath = normalizedPath.replace(/\/$/, '') || '/';
+            const pathSegment = cleanPath === '/' ? '' : cleanPath.substring(1);
+            const url = `${this.baseUrl}/paths/${pathSegment}`;
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                results.push({ path: routePath, success: true });
+            }
+            else {
+                edgeLog.warn(`Failed to clear path ${routePath}: HTTP ${response.status}`);
+                results.push({ path: routePath, success: false });
+            }
+        }
+        catch (error) {
+            edgeLog.warn(`Error clearing path ${routePath}:`, error);
+            results.push({ path: routePath, success: false });
+        }
+    }
+    /**
+     * Clear a single path from the edge cache.
+     */
+    async clearPath(routePath) {
+        return this.clearPaths([routePath]);
+    }
+    /**
+     * Clear paths in the background (non-blocking).
+     */
+    clearPathsInBackground(paths, context) {
+        if (paths.length === 0)
+            return;
+        this.clearPaths(paths)
+            .then((result) => {
+            if (result.success) {
+                edgeLog.debug(`Background path clear for ${context}: ${result.paths?.length} paths cleared`);
+            }
+            else {
+                edgeLog.warn(`Background path clear failed for ${context}: ${result.error}`);
+            }
+        })
+            .catch((error) => {
+            edgeLog.error(`Background path clear error for ${context}:`, error);
+        });
+    }
+    /**
+     * Clear a single path in the background (non-blocking).
+     */
+    clearPathInBackground(routePath, context) {
+        this.clearPathsInBackground([routePath], context);
+    }
+    /**
+     * Clear cache entries by key/tag.
+     * @param keys Array of cache keys/tags to clear
+     */
+    async clearKeys(keys) {
+        if (keys.length === 0) {
+            return { success: true, duration: 0, paths: [] };
+        }
+        const startTime = Date.now();
+        const results = [];
+        try {
+            const clearPromises = keys.map((key) => this.clearSingleKey(key, results));
+            await Promise.all(clearPromises);
+            const duration = Date.now() - startTime;
+            const successCount = results.filter((r) => r.success).length;
+            const clearedKeys = results.filter((r) => r.success).map((r) => r.key);
+            edgeLog.debug(`Cleared ${successCount}/${keys.length} keys in ${duration}ms`);
+            return {
+                success: successCount > 0,
+                duration,
+                paths: clearedKeys,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: errorMessage, duration, paths: [] };
+        }
+    }
+    async clearSingleKey(key, results) {
+        try {
+            const url = `${this.baseUrl}/keys/${encodeURIComponent(key)}`;
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, {
+                method: 'DELETE',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                results.push({ key, success: true });
+            }
+            else {
+                edgeLog.warn(`Failed to clear key ${key}: HTTP ${response.status}`);
+                results.push({ key, success: false });
+            }
+        }
+        catch (error) {
+            edgeLog.warn(`Error clearing key ${key}:`, error);
+            results.push({ key, success: false });
+        }
+    }
+    /**
+     * Clear keys in the background (non-blocking).
+     */
+    clearKeysInBackground(keys, context) {
+        if (keys.length === 0)
+            return;
+        this.clearKeys(keys)
+            .then((result) => {
+            if (result.success) {
+                edgeLog.debug(`Background key clear for ${context}: ${result.paths?.length} keys cleared`);
+            }
+            else {
+                edgeLog.warn(`Background key clear failed for ${context}: ${result.error}`);
+            }
+        })
+            .catch((error) => {
+            edgeLog.error(`Background key clear error for ${context}:`, error);
+        });
+    }
+    /**
+     * Clear entire cache in the background (non-blocking).
+     */
+    nukeCacheInBackground(context) {
+        this.nukeCache()
+            .then((result) => {
+            if (result.success) {
+                edgeLog.debug(`Background nuke successful for ${context} (${result.duration}ms)`);
+            }
+            else {
+                edgeLog.warn(`Background nuke failed for ${context}: ${result.error}`);
+            }
+        })
+            .catch((error) => {
+            edgeLog.error(`Background nuke error for ${context}:`, error);
+        });
+    }
+}
+/**
+ * Creates an EdgeCacheClear instance if the environment is configured.
+ * Returns null if edge cache clearing is not available.
+ * @internal
+ */
+export function createEdgeCacheClearer() {
+    try {
+        return new EdgeCacheClear();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=edge-cache-clear.js.map

package/dist/edge/edge-cache-clear.js.map

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

package/dist/handlers/base.d.ts

@@ -0,0 +1,69 @@
+import type { CacheData, CacheHandlerParametersGet, CacheHandlerParametersSet, CacheHandlerParametersRevalidateTag, CacheHandlerValue, FileSystemCacheContext, Revalidate, SerializedCacheData } from '../types.js';
+import { type Logger } from '../utils/logger.js';
+/**
+ * Reset the build invalidation check flag.
+ * Useful for testing purposes.
+ * @internal
+ */
+export declare function resetBuildInvalidationCheck(): void;
+export interface BuildMeta {
+    buildId: string;
+    timestamp: number;
+}
+/**
+ * Abstract base class for cache handlers.
+ * Provides shared functionality for tag mapping, serialization, and build invalidation.
+ */
+export declare abstract class BaseCacheHandler {
+    protected readonly context: FileSystemCacheContext;
+    protected readonly handlerName: string;
+    protected readonly log: Logger;
+    constructor(context: FileSystemCacheContext, handlerName: string);
+    /**
+     * Initialize the handler. Should be called after construction.
+     * Handles build invalidation check and tags mapping initialization.
+     */
+    protected initialize(): Promise<void>;
+    protected abstract initializeTagsMapping(): Promise<void>;
+    protected abstract readTagsMapping(): Promise<Record<string, string[]>>;
+    protected abstract writeTagsMapping(tagsMapping: Record<string, string[]>): Promise<void>;
+    protected abstract readCacheEntry(cacheKey: string, cacheType: 'fetch' | 'route'): Promise<CacheHandlerValue | null>;
+    protected abstract writeCacheEntry(cacheKey: string, cacheValue: CacheHandlerValue, cacheType: 'fetch' | 'route'): Promise<void>;
+    protected abstract deleteCacheEntry(cacheKey: string, cacheType: 'fetch' | 'route'): Promise<void>;
+    protected abstract readBuildMeta(): Promise<BuildMeta>;
+    protected abstract writeBuildMeta(meta: BuildMeta): Promise<void>;
+    protected abstract invalidateRouteCache(): Promise<void>;
+    protected updateTagsMapping(cacheKey: string, tags: string[], isDelete?: boolean): Promise<void>;
+    protected updateTagsMappingBulkDelete(cacheKeysToDelete: string[], tagsMapping: Record<string, string[]>): Promise<void>;
+    /**
+     * Removes cache keys from all tag mappings they're associated with.
+     * This is used when cache entries are deleted to keep the tag mapping consistent.
+     * Empty tags are cleaned up automatically.
+     */
+    private removeKeysFromAllTags;
+    private addKeyToTags;
+    private checkBuildInvalidation;
+    protected serializeForStorage(data: CacheData): SerializedCacheData;
+    protected deserializeFromStorage(data: SerializedCacheData): CacheData;
+    protected determineCacheType(ctx?: CacheHandlerParametersGet[1]): 'fetch' | 'route';
+    protected determineCacheTypeFromValue(incrementalCacheValue: CacheHandlerParametersSet[1]): 'fetch' | 'route';
+    get(cacheKey: CacheHandlerParametersGet[0], ctx?: CacheHandlerParametersGet[1]): Promise<CacheHandlerValue | null>;
+    set(cacheKey: CacheHandlerParametersSet[0], incrementalCacheValue: CacheHandlerParametersSet[1], ctx: CacheHandlerParametersSet[2] & {
+        tags?: string[];
+        revalidate?: Revalidate;
+    }): Promise<void>;
+    revalidateTag(tag: CacheHandlerParametersRevalidateTag[0]): Promise<void>;
+    /**
+     * Hook called after revalidation is complete.
+     * Subclasses can override to perform additional cleanup.
+     */
+    protected onRevalidateComplete(_tags: string[], _deletedKeys: string[]): Promise<void>;
+    /**
+     * Hook called when a route cache entry is set (ISR page update).
+     * Subclasses can override to perform edge cache invalidation.
+     */
+    protected onRouteCacheSet(_cacheKey: string): void;
+    private tryDeleteCacheEntry;
+    resetRequestCache(): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/handlers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/handlers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yBAAyB,EACzB,yBAAyB,EACzB,mCAAmC,EACnC,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM;IAWhE;;;OAGG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3C,SAAS,CAAC,QAAQ,CAAC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzF,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACpH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAChI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAElG,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;IACtD,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;cAMxC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;cAgBpF,2BAA2B,CACzC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAShB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,YAAY;YAeN,sBAAsB;IA6BpC,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB;IAInE,SAAS,CAAC,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS;IAQtE,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,OAAO;IAoBnF,SAAS,CAAC,2BAA2B,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,OAAO;IAgBvG,GAAG,CACP,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACtC,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAwB9B,GAAG,CACP,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACtC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACnD,GAAG,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG;QAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,GACA,OAAO,CAAC,IAAI,CAAC;IAmCV,aAAa,CAAC,GAAG,EAAE,mCAAmC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C/E;;;OAGG;cACa,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YAIpC,mBAAmB;IAsBjC,iBAAiB,IAAI,IAAI;CAK1B"}