alepha 0.15.0 → 0.15.1

package/dist/bucket/index.d.ts

@@ -7,36 +7,36 @@ import * as alepha_logger0 from "alepha/logger";
 //#region ../../src/bucket/providers/FileStorageProvider.d.ts
 declare abstract class FileStorageProvider {
   /**
-       * Uploads a file to the storage.
-       *
-       * @param bucketName - Container name
-       * @param file - File to upload
-       * @param fileId - Optional file identifier. If not provided, a unique ID will be generated.
-       * @return The identifier of the uploaded file.
-       */
+   * Uploads a file to the storage.
+   *
+   * @param bucketName - Container name
+   * @param file - File to upload
+   * @param fileId - Optional file identifier. If not provided, a unique ID will be generated.
+   * @return The identifier of the uploaded file.
+   */
   abstract upload(bucketName: string, file: FileLike, fileId?: string): Promise<string>;
   /**
-       * Downloads a file from the storage.
-       *
-       * @param bucketName - Container name
-       * @param fileId - Identifier of the file to download
-       * @return The downloaded file as a FileLike object.
-       */
+   * Downloads a file from the storage.
+   *
+   * @param bucketName - Container name
+   * @param fileId - Identifier of the file to download
+   * @return The downloaded file as a FileLike object.
+   */
   abstract download(bucketName: string, fileId: string): Promise<FileLike>;
   /**
-       * Check if fileId exists in the storage bucket.
-       *
-       * @param bucketName - Container name
-       * @param fileId - Identifier of the file to stream
-       * @return True is the file exists, false otherwise.
-       */
+   * Check if fileId exists in the storage bucket.
+   *
+   * @param bucketName - Container name
+   * @param fileId - Identifier of the file to stream
+   * @return True is the file exists, false otherwise.
+   */
   abstract exists(bucketName: string, fileId: string): Promise<boolean>;
   /**
-       * Delete permanently a file from the storage.
-       *
-       * @param bucketName - Container name
-       * @param fileId - Identifier of the file to delete
-       */
+   * Delete permanently a file from the storage.
+   *
+   * @param bucketName - Container name
+   * @param fileId - Identifier of the file to delete
+   */
   abstract delete(bucketName: string, fileId: string): Promise<void>;
 }
 //#endregion
@@ -108,134 +108,134 @@ declare const $bucket: {
 };
 interface BucketPrimitiveOptions extends BucketFileOptions {
   /**
-       * File storage provider configuration for the bucket.
-       *
-       * Options:
-       * - **"memory"**: In-memory storage (default for development, lost on restart)
-       * - **Service<FileStorageProvider>**: Custom provider class (e.g., S3FileStorageProvider, AzureBlobProvider)
-       * - **undefined**: Uses the default file storage provider from dependency injection
-       *
-       * **Provider Selection Guidelines**:
-       * - **Development**: Use "memory" for fast, simple testing without external dependencies
-       * - **Production**: Use cloud providers (S3, Azure Blob, Google Cloud Storage) for scalability
-       * - **Local deployment**: Use filesystem providers for on-premise installations
-       * - **Hybrid**: Use different providers for different bucket types (temp files vs permanent storage)
-       *
-       * **Provider Capabilities**:
-       * - File persistence and durability guarantees
-       * - Scalability and performance characteristics
-       * - Geographic distribution and CDN integration
-       * - Cost implications for storage and bandwidth
-       * - Backup and disaster recovery features
-       *
-       * @default Uses injected FileStorageProvider
-       * @example "memory"
-       * @example S3FileStorageProvider
-       * @example AzureBlobStorageProvider
-       */
+   * File storage provider configuration for the bucket.
+   *
+   * Options:
+   * - **"memory"**: In-memory storage (default for development, lost on restart)
+   * - **Service<FileStorageProvider>**: Custom provider class (e.g., S3FileStorageProvider, AzureBlobProvider)
+   * - **undefined**: Uses the default file storage provider from dependency injection
+   *
+   * **Provider Selection Guidelines**:
+   * - **Development**: Use "memory" for fast, simple testing without external dependencies
+   * - **Production**: Use cloud providers (S3, Azure Blob, Google Cloud Storage) for scalability
+   * - **Local deployment**: Use filesystem providers for on-premise installations
+   * - **Hybrid**: Use different providers for different bucket types (temp files vs permanent storage)
+   *
+   * **Provider Capabilities**:
+   * - File persistence and durability guarantees
+   * - Scalability and performance characteristics
+   * - Geographic distribution and CDN integration
+   * - Cost implications for storage and bandwidth
+   * - Backup and disaster recovery features
+   *
+   * @default Uses injected FileStorageProvider
+   * @example "memory"
+   * @example S3FileStorageProvider
+   * @example AzureBlobStorageProvider
+   */
   provider?: Service<FileStorageProvider> | "memory";
   /**
-       * Unique name identifier for the bucket.
-       *
-       * This name is used for:
-       * - Storage backend organization and partitioning
-       * - File path generation and URL construction
-       * - Logging, monitoring, and debugging
-       * - Access control and permissions management
-       * - Backup and replication configuration
-       *
-       * **Naming Conventions**:
-       * - Use lowercase with hyphens for consistency
-       * - Include purpose or content type in the name
-       * - Avoid spaces and special characters
-       * - Consider environment prefixes for deployment isolation
-       *
-       * If not provided, defaults to the property key where the bucket is declared.
-       *
-       * @example "user-avatars"
-       * @example "product-images"
-       * @example "legal-documents"
-       * @example "temp-processing-files"
-       */
+   * Unique name identifier for the bucket.
+   *
+   * This name is used for:
+   * - Storage backend organization and partitioning
+   * - File path generation and URL construction
+   * - Logging, monitoring, and debugging
+   * - Access control and permissions management
+   * - Backup and replication configuration
+   *
+   * **Naming Conventions**:
+   * - Use lowercase with hyphens for consistency
+   * - Include purpose or content type in the name
+   * - Avoid spaces and special characters
+   * - Consider environment prefixes for deployment isolation
+   *
+   * If not provided, defaults to the property key where the bucket is declared.
+   *
+   * @example "user-avatars"
+   * @example "product-images"
+   * @example "legal-documents"
+   * @example "temp-processing-files"
+   */
   name?: string;
 }
 interface BucketFileOptions {
   /**
-       * Human-readable description of the bucket's purpose and contents.
-       *
-       * Used for:
-       * - Documentation generation and API references
-       * - Developer onboarding and system understanding
-       * - Monitoring dashboards and admin interfaces
-       * - Compliance and audit documentation
-       *
-       * **Description Best Practices**:
-       * - Explain what types of files this bucket stores
-       * - Mention any special handling or processing requirements
-       * - Include information about retention policies if applicable
-       * - Note any compliance or security considerations
-       *
-       * @example "User profile pictures and avatar images"
-       * @example "Product catalog images with automated thumbnail generation"
-       * @example "Legal documents requiring long-term retention"
-       * @example "Temporary files for data processing workflows"
-       */
+   * Human-readable description of the bucket's purpose and contents.
+   *
+   * Used for:
+   * - Documentation generation and API references
+   * - Developer onboarding and system understanding
+   * - Monitoring dashboards and admin interfaces
+   * - Compliance and audit documentation
+   *
+   * **Description Best Practices**:
+   * - Explain what types of files this bucket stores
+   * - Mention any special handling or processing requirements
+   * - Include information about retention policies if applicable
+   * - Note any compliance or security considerations
+   *
+   * @example "User profile pictures and avatar images"
+   * @example "Product catalog images with automated thumbnail generation"
+   * @example "Legal documents requiring long-term retention"
+   * @example "Temporary files for data processing workflows"
+   */
   description?: string;
   /**
-       * Array of allowed MIME types for files uploaded to this bucket.
-       *
-       * When specified, only files with these exact MIME types will be accepted.
-       * Files with disallowed MIME types will be rejected with an InvalidFileError.
-       *
-       * **MIME Type Categories**:
-       * - Images: "image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"
-       * - Documents: "application/pdf", "text/plain", "text/csv"
-       * - Office: "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
-       * - Archives: "application/zip", "application/x-tar", "application/gzip"
-       * - Media: "video/mp4", "audio/mpeg", "audio/wav"
-       *
-       * **Security Considerations**:
-       * - Always validate MIME types for user uploads
-       * - Be cautious with executable file types
-       * - Consider using allow-lists rather than deny-lists
-       * - Remember that MIME types can be spoofed by malicious users
-       *
-       * If not specified, all MIME types are allowed (not recommended for user uploads).
-       *
-       * @example ["image/jpeg", "image/png"] // Only JPEG and PNG images
-       * @example ["application/pdf", "text/plain"] // Documents only
-       * @example ["video/mp4", "video/webm"] // Video files
-       */
+   * Array of allowed MIME types for files uploaded to this bucket.
+   *
+   * When specified, only files with these exact MIME types will be accepted.
+   * Files with disallowed MIME types will be rejected with an InvalidFileError.
+   *
+   * **MIME Type Categories**:
+   * - Images: "image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"
+   * - Documents: "application/pdf", "text/plain", "text/csv"
+   * - Office: "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+   * - Archives: "application/zip", "application/x-tar", "application/gzip"
+   * - Media: "video/mp4", "audio/mpeg", "audio/wav"
+   *
+   * **Security Considerations**:
+   * - Always validate MIME types for user uploads
+   * - Be cautious with executable file types
+   * - Consider using allow-lists rather than deny-lists
+   * - Remember that MIME types can be spoofed by malicious users
+   *
+   * If not specified, all MIME types are allowed (not recommended for user uploads).
+   *
+   * @example ["image/jpeg", "image/png"] // Only JPEG and PNG images
+   * @example ["application/pdf", "text/plain"] // Documents only
+   * @example ["video/mp4", "video/webm"] // Video files
+   */
   mimeTypes?: string[];
   /**
-       * Maximum file size allowed in megabytes (MB).
-       *
-       * Files larger than this limit will be rejected with an InvalidFileError.
-       * This helps prevent:
-       * - Storage quota exhaustion
-       * - Memory issues during file processing
-       * - Long upload times and timeouts
-       * - Abuse of storage resources
-       *
-       * **Size Guidelines by File Type**:
-       * - Profile images: 1-5 MB
-       * - Product photos: 5-10 MB
-       * - Documents: 10-50 MB
-       * - Video files: 50-500 MB
-       * - Data files: 100-1000 MB
-       *
-       * **Considerations**:
-       * - Consider your storage costs and limits
-       * - Factor in network upload speeds for users
-       * - Account for processing requirements (thumbnails, compression)
-       * - Set reasonable limits based on actual use cases
-       *
-       * @default 10 MB
-       *
-       * @example 1    // 1MB for small images
-       * @example 25   // 25MB for documents
-       * @example 100  // 100MB for media files
-       */
+   * Maximum file size allowed in megabytes (MB).
+   *
+   * Files larger than this limit will be rejected with an InvalidFileError.
+   * This helps prevent:
+   * - Storage quota exhaustion
+   * - Memory issues during file processing
+   * - Long upload times and timeouts
+   * - Abuse of storage resources
+   *
+   * **Size Guidelines by File Type**:
+   * - Profile images: 1-5 MB
+   * - Product photos: 5-10 MB
+   * - Documents: 10-50 MB
+   * - Video files: 50-500 MB
+   * - Data files: 100-1000 MB
+   *
+   * **Considerations**:
+   * - Consider your storage costs and limits
+   * - Factor in network upload speeds for users
+   * - Account for processing requirements (thumbnails, compression)
+   * - Set reasonable limits based on actual use cases
+   *
+   * @default 10 MB
+   *
+   * @example 1    // 1MB for small images
+   * @example 25   // 25MB for documents
+   * @example 100  // 100MB for media files
+   */
   maxSize?: number;
 }
 declare class BucketPrimitive extends Primitive<BucketPrimitiveOptions> {
@@ -243,37 +243,37 @@ declare class BucketPrimitive extends Primitive<BucketPrimitiveOptions> {
   private readonly fileSystem;
   get name(): string;
   /**
-       * Uploads a file to the bucket.
-       */
+   * Uploads a file to the bucket.
+   */
   upload(file: FileLike, options?: BucketFileOptions): Promise<string>;
   /**
-       * Delete permanently a file from the bucket.
-       */
+   * Delete permanently a file from the bucket.
+   */
   delete(fileId: string, skipHook?: boolean): Promise<void>;
   /**
-       * Checks if a file exists in the bucket.
-       */
+   * Checks if a file exists in the bucket.
+   */
   exists(fileId: string): Promise<boolean>;
   /**
-       * Downloads a file from the bucket.
-       */
+   * Downloads a file from the bucket.
+   */
   download(fileId: string): Promise<FileLike>;
   protected $provider(): FileStorageProvider | MemoryFileStorageProvider;
 }
 interface BucketFileOptions {
   /**
-       * Optional description of the bucket.
-       */
+   * Optional description of the bucket.
+   */
   description?: string;
   /**
-       * Allowed MIME types.
-       */
+   * Allowed MIME types.
+   */
   mimeTypes?: string[];
   /**
-       * Maximum size of the files in the bucket.
-       *
-       * @default 10
-       */
+   * Maximum size of the files in the bucket.
+   *
+   * @default 10
+   */
   maxSize?: number;
 }
 //#endregion
@@ -320,9 +320,9 @@ declare class LocalFileStorageProvider implements FileStorageProvider {
 declare module "alepha" {
   interface Hooks {
     /**
-             * Triggered when a file is uploaded to a bucket.
-             * Can be used to perform actions after a file is uploaded, like creating a database record!
-             */
+     * Triggered when a file is uploaded to a bucket.
+     * Can be used to perform actions after a file is uploaded, like creating a database record!
+     */
     "bucket:file:uploaded": {
       id: string;
       file: FileLike;
@@ -330,8 +330,8 @@ declare module "alepha" {
       options: BucketFileOptions;
     };
     /**
-             * Triggered when a file is deleted from a bucket.
-             */
+     * Triggered when a file is deleted from a bucket.
+     */
     "bucket:file:deleted": {
       id: string;
       bucket: BucketPrimitive;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}

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

@@ -12,37 +12,37 @@ import * as alepha_logger0 from "alepha/logger";
  */
 declare abstract class CacheProvider {
   /**
-       * Get the value of a key.
-       *
-       * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
-       * @param key The key of the value to get.
-       *
-       * @return The value of the key, or undefined if the key does not exist.
-       */
+   * Get the value of a key.
+   *
+   * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
+   * @param key The key of the value to get.
+   *
+   * @return The value of the key, or undefined if the key does not exist.
+   */
   abstract get(name: string, key: string): Promise<Uint8Array | undefined>;
   /**
-       * Set the string value of a key.
-       *
-       * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
-       * @param key The key of the value to set.
-       * @param value The value to set.
-       * @param ttl The time-to-live of the key, in milliseconds.
-       *
-       * @return The value of the key.
-       */
+   * Set the string value of a key.
+   *
+   * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
+   * @param key The key of the value to set.
+   * @param value The value to set.
+   * @param ttl The time-to-live of the key, in milliseconds.
+   *
+   * @return The value of the key.
+   */
   abstract set(name: string, key: string, value: Uint8Array, ttl?: number): Promise<Uint8Array>;
   /**
-       * Remove the specified keys.
-       *
-       * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
-       * @param keys The keys to delete.
-       */
+   * Remove the specified keys.
+   *
+   * @param name Cache name, used to group keys. Should be Redis-like "some:group:name" format.
+   * @param keys The keys to delete.
+   */
   abstract del(name: string, ...keys: string[]): Promise<void>;
   abstract has(name: string, key: string): Promise<boolean>;
   abstract keys(name: string, filter?: string): Promise<string[]>;
   /**
-       * Remove all keys from all cache names.
-       */
+   * Remove all keys from all cache names.
+   */
   abstract clear(): Promise<void>;
 }
 //#endregion
@@ -101,37 +101,37 @@ declare const $cache: {
 };
 interface CachePrimitiveOptions<TReturn = any, TParameter extends any[] = any[]> {
   /**
-       * The cache name. This is useful for invalidating multiple caches at once.
-       *
-       * Store key as `cache:$name:$key`.
-       *
-       * @default Name of the key of the class.
-       */
+   * The cache name. This is useful for invalidating multiple caches at once.
+   *
+   * Store key as `cache:$name:$key`.
+   *
+   * @default Name of the key of the class.
+   */
   name?: string;
   /**
-       * Function which returns cached data.
-       */
+   * Function which returns cached data.
+   */
   handler?: (...args: TParameter) => TReturn;
   /**
-       * The key generator for the cache.
-       * If not provided, the arguments will be json.stringify().
-       */
+   * The key generator for the cache.
+   * If not provided, the arguments will be json.stringify().
+   */
   key?: (...args: TParameter) => string;
   /**
-       * The store provider for the cache.
-       * If not provided, the default store provider will be used.
-       */
+   * The store provider for the cache.
+   * If not provided, the default store provider will be used.
+   */
   provider?: InstantiableClass<CacheProvider> | "memory";
   /**
-       * The time-to-live for the cache in seconds.
-       * Set 0 to skip expiration.
-       *
-       * @default 300 (5 minutes).
-       */
+   * The time-to-live for the cache in seconds.
+   * Set 0 to skip expiration.
+   *
+   * @default 300 (5 minutes).
+   */
   ttl?: DurationLike;
   /**
-       * If the cache is disabled.
-       */
+   * If the cache is disabled.
+   */
   disabled?: boolean;
 }
 declare class CachePrimitive<TReturn = any, TParameter extends any[] = any[]> extends Primitive<CachePrimitiveOptions<TReturn, TParameter>> {
@@ -160,8 +160,8 @@ declare class CachePrimitive<TReturn = any, TParameter extends any[] = any[]> ex
 }
 interface CachePrimitiveFn<TReturn = any, TParameter extends any[] = any[]> extends CachePrimitive<TReturn, TParameter> {
   /**
-       * Run the cache primitive with the provided arguments.
-       */
+   * Run the cache primitive with the provided arguments.
+   */
   (...args: TParameter): Promise<TReturn>;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/index.ts"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"mappings":";;;;;;;cAKM,SAAA,UAAS,OAAA;EAAA,kBAAA,oBAOb,OAAA,CAAA,OAAA;AAAA;AAAA;EAAA,UAAA,GAAA,SAGsB,OAAA,CAAQ,MAAA,QAAc,SAAA;AAAA;AAAA,cAGjC,kBAAA,YAA8B,aAAA;EAAA,mBAAA,GAAA,EAAX,cAAA,CACR,MAAA;EAAA,mBAAA,aAAA,EACU,aAAA;EAAA,mBAAA,GAAA;IAAA,kBAAA;EAAA;EAAA,mBAAA,MAAA,EAEP,MAAA;EAAA,IAAA,IAAA,UAAA,GAAA,WAEoB,OAAA,CAAQ,UAAA;EAAA,IAAA,IAAA,UAAA,GAAA,UAAA,KAAA,EAsB5C,UAAA,WAAA,GAAA,YAEN,OAAA,CAAQ,UAAA;EAAA,IAAA,IAAA,aAAA,IAAA,aAmBwC,OAAA;EAAA,IAAA,IAAA,UAAA,GAAA,WAgBN,OAAA;EAAA,KAAA,IAAA,UAAA,MAAA,YAIK,OAAA;EAAA,MAAA,GAO5B,OAAA;EAAA,UAAA,OAAA,GAAA,IAAA;AAAA;;;;AC9ExB;;;;;cAAa,gBAAA,EAAgB,OAAA,CAAA,OAAA,CAW3B,OAAA,CAX2B,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"mappings":";;;;;;;cAKM,SAAA,UAAS,OAAA;wCAOb,OAAA,CAAA,OAAA;AAAA;AAAA;EAAA,UAGU,GAAA,SAAY,OAAA,CAAQ,MAAA,QAAc,SAAA;AAAA;AAAA,cAGjC,kBAAA,YAA8B,aAAA;EAAA,mBACtB,GAAA,EADW,cAAA,CACR,MAAA;EAAA,mBACH,aAAA,EAAa,aAAA;EAAA,mBACb,GAAA;;;qBACA,MAAA,EAAM,MAAA;EAEZ,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA,CAAQ,UAAA;EAmBxC,GAAA,CACX,IAAA,UACA,GAAA,UACA,KAAA,EAAO,UAAA,WACP,GAAA,YACC,OAAA,CAAQ,UAAA;EAmBE,GAAA,CAAI,IAAA,aAAiB,IAAA,aAAiB,OAAA;EAgBtC,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA;EAIhC,IAAA,CAAK,IAAA,UAAc,MAAA,YAAkB,OAAA;EAOrC,KAAA,CAAA,GAAS,OAAA;EAAA,UAOZ,MAAA,CAAA,GAAU,IAAA;AAAA;;;;;;;;;cCrFT,gBAAA,EAAgB,OAAA,CAAA,OAAA,CAW3B,OAAA,CAX2B,MAAA"}

package/dist/cache/redis/index.js

@@ -34,8 +34,8 @@ var RedisCacheProvider = class {
 	async del(name, ...keys) {
 		const nameKey = this.prefix(name);
 		if (keys.length === 0) {
-			const keys$1 = await this.redisProvider.keys(`${nameKey}:*`);
-			await this.redisProvider.del(keys$1);
+			const keys = await this.redisProvider.keys(`${nameKey}:*`);
+			await this.redisProvider.del(keys);
 			return;
 		}
 		await this.redisProvider.del(keys.map((key) => key.startsWith(nameKey) ? key : this.prefix(name, key)));

package/dist/cache/redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["keys"],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"sourcesContent":["import { $env, $inject, Alepha, type Static, t } from \"alepha\";\nimport type { CacheProvider } from \"alepha/cache\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider } from \"alepha/redis\";\n\nconst envSchema = t.object({\n  REDIS_CACHE_PREFIX: t.optional(\n    t.text({\n      description:\n        \"Force a prefix for all cache keys in Redis. Useful for testing or multi-tenant applications.\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\nexport class RedisCacheProvider implements CacheProvider {\n  protected readonly log = $logger();\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const keyWithPrefix = this.prefix(name, key);\n    const buffer = await this.redisProvider.get(keyWithPrefix);\n    if (!buffer) {\n      return;\n    }\n\n    this.log.debug(`Cache hit`, {\n      size: buffer.byteLength,\n      key: keyWithPrefix,\n    });\n\n    return new Uint8Array(buffer);\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array | string,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (!this.alepha.isReady()) {\n      return new Uint8Array(Buffer.from(value));\n    }\n\n    const buffer = Buffer.from(value);\n    const prefix = this.prefix(name, key);\n\n    if (ttl) {\n      return new Uint8Array(\n        await this.redisProvider.set(prefix, buffer, {\n          expiration: { type: \"PX\", value: ttl },\n        }),\n      );\n    }\n\n    return new Uint8Array(await this.redisProvider.set(prefix, buffer));\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    const nameKey = this.prefix(name);\n\n    if (keys.length === 0) {\n      const keys = await this.redisProvider.keys(`${nameKey}:*`);\n      await this.redisProvider.del(keys);\n      return;\n    }\n\n    await this.redisProvider.del(\n      keys.map((key) =>\n        key.startsWith(nameKey) ? key : this.prefix(name, key),\n      ),\n    );\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.get(name, key).then((value) => value != null);\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    if (filter) {\n      return await this.redisProvider.keys(`${this.prefix(name)}:${filter}*`);\n    }\n    return this.redisProvider.keys(`${this.prefix(name)}:*`);\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n    const pattern = `${this.prefix()}:*`;\n    const keys = await this.redisProvider.keys(pattern);\n    await this.redisProvider.del(keys);\n  }\n\n  protected prefix(...path: string[]): string {\n    const parts = [\"cache\", ...path];\n\n    if (this.env.REDIS_CACHE_PREFIX) {\n      parts.unshift(this.env.REDIS_CACHE_PREFIX);\n    }\n\n    return parts.join(\":\");\n  }\n}\n","import { $module } from \"alepha\";\nimport { AlephaCache, CacheProvider } from \"alepha/cache\";\nimport { RedisCacheProvider } from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Cache that provides Redis caching capabilities.\n *\n * @see {@link RedisCacheProvider}\n * @module alepha.cache.redis\n */\nexport const AlephaCacheRedis = $module({\n  name: \"alepha.cache.redis\",\n  services: [RedisCacheProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        provide: CacheProvider,\n        use: RedisCacheProvider,\n        optional: true,\n      })\n      .with(AlephaCache),\n});\n"],"mappings":";;;;;;AAKA,MAAM,YAAY,EAAE,OAAO,EACzB,oBAAoB,EAAE,SACpB,EAAE,KAAK,EACL,aACE,gGACH,CAAC,CACH,EACF,CAAC;AAMF,IAAa,qBAAb,MAAyD;CACvD,AAAmB,MAAM,SAAS;CAClC,AAAmB,gBAAgB,QAAQ,cAAc;CACzD,AAAmB,MAAM,KAAK,UAAU;CACxC,AAAmB,SAAS,QAAQ,OAAO;CAE3C,MAAa,IAAI,MAAc,KAA8C;AAC3E,MAAI,CAAC,KAAK,OAAO,WAAW,CAC1B;EAGF,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI;EAC5C,MAAM,SAAS,MAAM,KAAK,cAAc,IAAI,cAAc;AAC1D,MAAI,CAAC,OACH;AAGF,OAAK,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK;GACN,CAAC;AAEF,SAAO,IAAI,WAAW,OAAO;;CAG/B,MAAa,IACX,MACA,KACA,OACA,KACqB;AACrB,MAAI,CAAC,KAAK,OAAO,SAAS,CACxB,QAAO,IAAI,WAAW,OAAO,KAAK,MAAM,CAAC;EAG3C,MAAM,SAAS,OAAO,KAAK,MAAM;EACjC,MAAM,SAAS,KAAK,OAAO,MAAM,IAAI;AAErC,MAAI,IACF,QAAO,IAAI,WACT,MAAM,KAAK,cAAc,IAAI,QAAQ,QAAQ,EAC3C,YAAY;GAAE,MAAM;GAAM,OAAO;GAAK,EACvC,CAAC,CACH;AAGH,SAAO,IAAI,WAAW,MAAM,KAAK,cAAc,IAAI,QAAQ,OAAO,CAAC;;CAGrE,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,MAAM,UAAU,KAAK,OAAO,KAAK;AAEjC,MAAI,KAAK,WAAW,GAAG;GACrB,MAAMA,SAAO,MAAM,KAAK,cAAc,KAAK,GAAG,QAAQ,IAAI;AAC1D,SAAM,KAAK,cAAc,IAAIA,OAAK;AAClC;;AAGF,QAAM,KAAK,cAAc,IACvB,KAAK,KAAK,QACR,IAAI,WAAW,QAAQ,GAAG,MAAM,KAAK,OAAO,MAAM,IAAI,CACvD,CACF;;CAGH,MAAa,IAAI,MAAc,KAA+B;AAC5D,SAAO,KAAK,IAAI,MAAM,IAAI,CAAC,MAAM,UAAU,SAAS,KAAK;;CAG3D,MAAa,KAAK,MAAc,QAAoC;AAClE,MAAI,OACF,QAAO,MAAM,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,GAAG,OAAO,GAAG;AAEzE,SAAO,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,IAAI;;CAG1D,MAAa,QAAuB;AAClC,OAAK,IAAI,MAAM,qBAAqB;EACpC,MAAM,UAAU,GAAG,KAAK,QAAQ,CAAC;EACjC,MAAM,OAAO,MAAM,KAAK,cAAc,KAAK,QAAQ;AACnD,QAAM,KAAK,cAAc,IAAI,KAAK;;CAGpC,AAAU,OAAO,GAAG,MAAwB;EAC1C,MAAM,QAAQ,CAAC,SAAS,GAAG,KAAK;AAEhC,MAAI,KAAK,IAAI,mBACX,OAAM,QAAQ,KAAK,IAAI,mBAAmB;AAG5C,SAAO,MAAM,KAAK,IAAI;;;;;;;;;;;;AC5F1B,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,SAAS;EACT,KAAK;EACL,UAAU;EACX,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"sourcesContent":["import { $env, $inject, Alepha, type Static, t } from \"alepha\";\nimport type { CacheProvider } from \"alepha/cache\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider } from \"alepha/redis\";\n\nconst envSchema = t.object({\n  REDIS_CACHE_PREFIX: t.optional(\n    t.text({\n      description:\n        \"Force a prefix for all cache keys in Redis. Useful for testing or multi-tenant applications.\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\nexport class RedisCacheProvider implements CacheProvider {\n  protected readonly log = $logger();\n  protected readonly redisProvider = $inject(RedisProvider);\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const keyWithPrefix = this.prefix(name, key);\n    const buffer = await this.redisProvider.get(keyWithPrefix);\n    if (!buffer) {\n      return;\n    }\n\n    this.log.debug(`Cache hit`, {\n      size: buffer.byteLength,\n      key: keyWithPrefix,\n    });\n\n    return new Uint8Array(buffer);\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array | string,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (!this.alepha.isReady()) {\n      return new Uint8Array(Buffer.from(value));\n    }\n\n    const buffer = Buffer.from(value);\n    const prefix = this.prefix(name, key);\n\n    if (ttl) {\n      return new Uint8Array(\n        await this.redisProvider.set(prefix, buffer, {\n          expiration: { type: \"PX\", value: ttl },\n        }),\n      );\n    }\n\n    return new Uint8Array(await this.redisProvider.set(prefix, buffer));\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    const nameKey = this.prefix(name);\n\n    if (keys.length === 0) {\n      const keys = await this.redisProvider.keys(`${nameKey}:*`);\n      await this.redisProvider.del(keys);\n      return;\n    }\n\n    await this.redisProvider.del(\n      keys.map((key) =>\n        key.startsWith(nameKey) ? key : this.prefix(name, key),\n      ),\n    );\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.get(name, key).then((value) => value != null);\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    if (filter) {\n      return await this.redisProvider.keys(`${this.prefix(name)}:${filter}*`);\n    }\n    return this.redisProvider.keys(`${this.prefix(name)}:*`);\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n    const pattern = `${this.prefix()}:*`;\n    const keys = await this.redisProvider.keys(pattern);\n    await this.redisProvider.del(keys);\n  }\n\n  protected prefix(...path: string[]): string {\n    const parts = [\"cache\", ...path];\n\n    if (this.env.REDIS_CACHE_PREFIX) {\n      parts.unshift(this.env.REDIS_CACHE_PREFIX);\n    }\n\n    return parts.join(\":\");\n  }\n}\n","import { $module } from \"alepha\";\nimport { AlephaCache, CacheProvider } from \"alepha/cache\";\nimport { RedisCacheProvider } from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Plugin for Alepha Cache that provides Redis caching capabilities.\n *\n * @see {@link RedisCacheProvider}\n * @module alepha.cache.redis\n */\nexport const AlephaCacheRedis = $module({\n  name: \"alepha.cache.redis\",\n  services: [RedisCacheProvider],\n  register: (alepha) =>\n    alepha\n      .with({\n        provide: CacheProvider,\n        use: RedisCacheProvider,\n        optional: true,\n      })\n      .with(AlephaCache),\n});\n"],"mappings":";;;;;;AAKA,MAAM,YAAY,EAAE,OAAO,EACzB,oBAAoB,EAAE,SACpB,EAAE,KAAK,EACL,aACE,gGACH,CAAC,CACH,EACF,CAAC;AAMF,IAAa,qBAAb,MAAyD;CACvD,AAAmB,MAAM,SAAS;CAClC,AAAmB,gBAAgB,QAAQ,cAAc;CACzD,AAAmB,MAAM,KAAK,UAAU;CACxC,AAAmB,SAAS,QAAQ,OAAO;CAE3C,MAAa,IAAI,MAAc,KAA8C;AAC3E,MAAI,CAAC,KAAK,OAAO,WAAW,CAC1B;EAGF,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI;EAC5C,MAAM,SAAS,MAAM,KAAK,cAAc,IAAI,cAAc;AAC1D,MAAI,CAAC,OACH;AAGF,OAAK,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK;GACN,CAAC;AAEF,SAAO,IAAI,WAAW,OAAO;;CAG/B,MAAa,IACX,MACA,KACA,OACA,KACqB;AACrB,MAAI,CAAC,KAAK,OAAO,SAAS,CACxB,QAAO,IAAI,WAAW,OAAO,KAAK,MAAM,CAAC;EAG3C,MAAM,SAAS,OAAO,KAAK,MAAM;EACjC,MAAM,SAAS,KAAK,OAAO,MAAM,IAAI;AAErC,MAAI,IACF,QAAO,IAAI,WACT,MAAM,KAAK,cAAc,IAAI,QAAQ,QAAQ,EAC3C,YAAY;GAAE,MAAM;GAAM,OAAO;GAAK,EACvC,CAAC,CACH;AAGH,SAAO,IAAI,WAAW,MAAM,KAAK,cAAc,IAAI,QAAQ,OAAO,CAAC;;CAGrE,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,MAAM,UAAU,KAAK,OAAO,KAAK;AAEjC,MAAI,KAAK,WAAW,GAAG;GACrB,MAAM,OAAO,MAAM,KAAK,cAAc,KAAK,GAAG,QAAQ,IAAI;AAC1D,SAAM,KAAK,cAAc,IAAI,KAAK;AAClC;;AAGF,QAAM,KAAK,cAAc,IACvB,KAAK,KAAK,QACR,IAAI,WAAW,QAAQ,GAAG,MAAM,KAAK,OAAO,MAAM,IAAI,CACvD,CACF;;CAGH,MAAa,IAAI,MAAc,KAA+B;AAC5D,SAAO,KAAK,IAAI,MAAM,IAAI,CAAC,MAAM,UAAU,SAAS,KAAK;;CAG3D,MAAa,KAAK,MAAc,QAAoC;AAClE,MAAI,OACF,QAAO,MAAM,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,GAAG,OAAO,GAAG;AAEzE,SAAO,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,IAAI;;CAG1D,MAAa,QAAuB;AAClC,OAAK,IAAI,MAAM,qBAAqB;EACpC,MAAM,UAAU,GAAG,KAAK,QAAQ,CAAC;EACjC,MAAM,OAAO,MAAM,KAAK,cAAc,KAAK,QAAQ;AACnD,QAAM,KAAK,cAAc,IAAI,KAAK;;CAGpC,AAAU,OAAO,GAAG,MAAwB;EAC1C,MAAM,QAAQ,CAAC,SAAS,GAAG,KAAK;AAEhC,MAAI,KAAK,IAAI,mBACX,OAAM,QAAQ,KAAK,IAAI,mBAAmB;AAG5C,SAAO,MAAM,KAAK,IAAI;;;;;;;;;;;;AC5F1B,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,SAAS;EACT,KAAK;EACL,UAAU;EACX,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}