alepha 0.12.1 → 0.13.1

package/dist/cache/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["AlephaError","DateTimeProvider","t","Descriptor","DateTimeProvider","keysToDelete: string[]","KIND","alepha"],"sources":["../../src/cache/errors/CacheError.ts","../../src/cache/providers/CacheProvider.ts","../../src/cache/providers/MemoryCacheProvider.ts","../../src/cache/descriptors/$cache.ts","../../src/cache/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","/**\n * Cache provider interface.\n *\n * All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n */\nexport abstract class CacheProvider {\n  /**\n   * Get the value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to get.\n   *\n   * @return The value of the key, or undefined if the key does not exist.\n   */\n  public abstract get(\n    name: string,\n    key: string,\n  ): Promise<Uint8Array | undefined>;\n\n  /**\n   * Set the string value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param ttl The time-to-live of the key, in milliseconds.\n   *\n   * @return The value of the key.\n   */\n  public abstract set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param keys The keys to delete.\n   */\n  public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n  public abstract has(name: string, key: string): Promise<boolean>;\n\n  public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n  /**\n   * Remove all keys from all cache names.\n   */\n  public abstract clear(): Promise<void>;\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n  data?: Uint8Array;\n  timeout?: Timeout;\n};\n\nexport class MemoryCacheProvider implements CacheProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    return this.store[name]?.[key]?.data;\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    this.store[name][key] ??= {};\n    this.store[name][key].data = value;\n\n    this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n    // clear previous timeout if exists\n    if (this.store[name][key].timeout) {\n      this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n      this.store[name][key].timeout = undefined;\n    }\n\n    if (ttl) {\n      this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n        () => this.del(name, key),\n        ttl,\n      );\n    }\n\n    return this.store[name][key].data;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    // delete all keys in name\n    if (keys.length === 0) {\n      this.log.debug(`Deleting all cache for name`, { name });\n\n      if (this.store[name]) {\n        for (const key of Object.keys(this.store[name])) {\n          const timeout = this.store[name][key]?.timeout;\n          if (timeout) {\n            this.dateTimeProvider.clearTimeout(timeout);\n          }\n        }\n      }\n      delete this.store[name];\n      return;\n    }\n\n    this.log.debug(`Deleting cache for name`, { name, keys });\n\n    // delete specific keys in name\n    for (const key of keys) {\n      if (this.store[name] == null) break;\n\n      const timeout = this.store[name][key]?.timeout;\n      if (timeout) {\n        this.dateTimeProvider.clearTimeout(timeout);\n      }\n\n      delete this.store[name][key];\n    }\n\n    if (Object.keys(this.store[name] ?? {}).length === 0) {\n      // if name is empty, delete it\n      delete this.store[name];\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.store[name]?.[key]?.data != null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const store = this.store[name] ?? {};\n    const keys = Object.keys(store);\n    if (filter) {\n      return keys.filter((key) => key.startsWith(filter));\n    }\n    return keys;\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n\n    // Clear all timeouts before clearing the store\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n  }\n}\n","import {\n  $env,\n  $inject,\n  createDescriptor,\n  Descriptor,\n  type InstantiableClass,\n  KIND,\n  t,\n} from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { CacheError } from \"../errors/CacheError.ts\";\nimport { CacheProvider } from \"../providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"../providers/MemoryCacheProvider.ts\";\n\n/**\n * Creates a cache descriptor for high-performance data caching with automatic management.\n *\n * Provides a caching layer that improves application performance by storing frequently accessed\n * data in memory or external stores like Redis, with support for both function result caching\n * and manual cache operations.\n *\n * **Key Features**\n * - Automatic function result caching based on input parameters\n * - Multiple storage backends (in-memory, Redis, custom providers)\n * - Intelligent serialization for JSON, strings, and binary data\n * - Configurable TTL with automatic expiration\n * - Pattern-based cache invalidation with wildcard support\n * - Environment controls to enable/disable caching\n *\n * **Storage Backends**\n * - Memory: Fast in-memory cache (default for development)\n * - Redis: Distributed cache for production environments\n * - Custom providers: Implement your own storage backend\n *\n * @example\n * ```ts\n * class DataService {\n *   // Function result caching\n *   getUserData = $cache({\n *     name: \"user-data\",\n *     ttl: [10, \"minutes\"],\n *     handler: async (userId: string) => {\n *       return await database.users.findById(userId);\n *     }\n *   });\n *\n *   // Manual cache operations\n *   sessionCache = $cache<UserSession>({\n *     name: \"sessions\",\n *     ttl: [1, \"hour\"]\n *   });\n *\n *   async storeSession(id: string, session: UserSession) {\n *     await this.sessionCache.set(id, session);\n *   }\n *\n *   async invalidateUserSessions(userId: string) {\n *     await this.sessionCache.invalidate(`user:${userId}:*`);\n *   }\n * }\n * ```\n */\nexport const $cache = <TReturn = string, TParameter extends any[] = any[]>(\n  options: CacheDescriptorOptions<TReturn, TParameter> = {},\n): CacheDescriptorFn<TReturn, TParameter> => {\n  const instance = createDescriptor(\n    CacheDescriptor<TReturn, TParameter>,\n    options,\n  );\n  const fn = (...args: TParameter): Promise<TReturn> => instance.run(...args);\n  return Object.setPrototypeOf(fn, instance) as CacheDescriptorFn<\n    TReturn,\n    TParameter\n  >;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface CacheDescriptorOptions<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> {\n  /**\n   * The cache name. This is useful for invalidating multiple caches at once.\n   *\n   * Store key as `cache:$name:$key`.\n   *\n   * @default Name of the key of the class.\n   */\n  name?: string;\n\n  /**\n   * Function which returns cached data.\n   */\n  handler?: (...args: TParameter) => TReturn;\n\n  /**\n   * The key generator for the cache.\n   * If not provided, the arguments will be json.stringify().\n   */\n  key?: (...args: TParameter) => string;\n\n  /**\n   * The store provider for the cache.\n   * If not provided, the default store provider will be used.\n   */\n  provider?: InstantiableClass<CacheProvider> | \"memory\";\n\n  /**\n   * The time-to-live for the cache in seconds.\n   * Set 0 to skip expiration.\n   *\n   * @default 300 (5 minutes).\n   */\n  ttl?: DurationLike;\n\n  /**\n   * If the cache is disabled.\n   */\n  disabled?: boolean;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  CACHE_ENABLED: t.boolean({ default: true }),\n  CACHE_DEFAULT_TTL: t.number({\n    default: 300, // 5 minutes\n    description: \"The default time to live for cache entries. In seconds.\",\n  }),\n});\n\nexport class CacheDescriptor<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends Descriptor<CacheDescriptorOptions<TReturn, TParameter>> {\n  protected readonly env = $env(envSchema);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly provider = this.$provider();\n  protected encoder: TextEncoder = new TextEncoder();\n  protected decoder: TextDecoder = new TextDecoder();\n  protected codes = {\n    BINARY: 0x01,\n    JSON: 0x02,\n    STRING: 0x03,\n  };\n\n  public get container(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}:${this.config.propertyKey}`\n    );\n  }\n\n  public async run(...args: TParameter): Promise<TReturn> {\n    const handler = this.options.handler;\n    if (!handler) {\n      throw new Error(\"Cache handler is not defined.\");\n    }\n\n    const key = this.key(...args);\n    const cached = await this.get(key);\n    if (cached) {\n      return cached;\n    }\n\n    const result = await handler(...args);\n    // note: when exception occurs, don't cache the result\n\n    await this.set(key, result);\n\n    return result;\n  }\n\n  public key(...args: TParameter): string {\n    return this.options.key ? this.options.key(...args) : JSON.stringify(args);\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    for (const key of keys) {\n      if (key.endsWith(\"*\")) {\n        const result = await this.provider.keys(\n          this.container,\n          key.slice(0, -1),\n        );\n        keysToDelete.push(...result);\n      } else {\n        keysToDelete.push(key);\n      }\n    }\n\n    await this.provider.del(this.container, ...keysToDelete);\n  }\n\n  public async set(\n    key: string,\n    value: TReturn,\n    ttl?: DurationLike,\n  ): Promise<void> {\n    const px = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.env.CACHE_DEFAULT_TTL, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    await this.provider.set(\n      this.container,\n      key,\n      this.serialize(value),\n      px > 0 ? px : undefined,\n    );\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.env.CACHE_ENABLED\n    ) {\n      return undefined;\n    }\n\n    const data = await this.provider.get(this.container, key);\n    if (data) {\n      return await this.deserialize<TReturn>(data);\n    }\n\n    return undefined;\n  }\n\n  protected serialize<TReturn>(value: TReturn): Uint8Array {\n    if (value instanceof Uint8Array) {\n      return new Uint8Array([this.codes.BINARY, ...value]); // TODO: check if copy is ok?\n    }\n\n    if (typeof value === \"string\") {\n      return new Uint8Array([this.codes.STRING, ...this.encoder.encode(value)]);\n    }\n\n    return new Uint8Array([\n      this.codes.JSON,\n      ...this.encoder.encode(JSON.stringify(value)),\n    ]);\n  }\n\n  protected async deserialize<TReturn>(\n    uint8Array: Uint8Array,\n  ): Promise<TReturn> {\n    const type = uint8Array[0];\n    const payload = uint8Array.slice(1);\n\n    if (type === this.codes.BINARY) {\n      return payload as TReturn;\n    }\n    if (type === this.codes.JSON) {\n      return JSON.parse(this.decoder.decode(payload)) as TReturn;\n    }\n    if (type === this.codes.STRING) {\n      return this.decoder.decode(payload) as TReturn;\n    }\n\n    throw new CacheError(`Unknown serialization type: ${type}`);\n  }\n\n  protected $provider(): CacheProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(CacheProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryCacheProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n}\n\nexport interface CacheDescriptorFn<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends CacheDescriptor<TReturn, TParameter> {\n  /**\n   * Run the cache descriptor with the provided arguments.\n   */\n  (...args: TParameter): Promise<TReturn>;\n}\n\n$cache[KIND] = CacheDescriptor;\n","import { $module } from \"alepha\";\nimport { $cache } from \"./descriptors/$cache.ts\";\nimport { CacheProvider } from \"./providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$cache.ts\";\nexport * from \"./providers/CacheProvider.ts\";\nexport * from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides high-performance caching capabilities for Alepha applications with configurable TTL and multiple storage backends.\n *\n * The cache module enables declarative caching through the `$cache` descriptor, allowing you to cache method results,\n * API responses, or computed values with automatic invalidation and type safety. It supports both in-memory and\n * persistent storage backends for different performance and durability requirements.\n *\n * @see {@link $cache}\n * @see {@link CacheProvider}\n * @module alepha.cache\n */\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  descriptors: [$cache],\n  services: [CacheProvider, MemoryCacheProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: MemoryCacheProvider,\n    }),\n});\n"],"mappings":"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"}

package/dist/cache/index.d.cts

@@ -1,202 +0,0 @@
-import * as alepha0 from "alepha";
-import { Descriptor, InstantiableClass, KIND } from "alepha";
-import { DateTimeProvider, DurationLike, Timeout } from "alepha/datetime";
-import * as alepha_logger0 from "alepha/logger";
-
-//#region src/cache/providers/CacheProvider.d.ts
-/**
- * Cache provider interface.
- *
- * All methods are asynchronous and return promises.
- * Values are stored as Uint8Array.
- */
-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.
-   */
-  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.
-   */
-  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.
-   */
-  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.
-   */
-  abstract clear(): Promise<void>;
-}
-//#endregion
-//#region src/cache/descriptors/$cache.d.ts
-/**
- * Creates a cache descriptor for high-performance data caching with automatic management.
- *
- * Provides a caching layer that improves application performance by storing frequently accessed
- * data in memory or external stores like Redis, with support for both function result caching
- * and manual cache operations.
- *
- * **Key Features**
- * - Automatic function result caching based on input parameters
- * - Multiple storage backends (in-memory, Redis, custom providers)
- * - Intelligent serialization for JSON, strings, and binary data
- * - Configurable TTL with automatic expiration
- * - Pattern-based cache invalidation with wildcard support
- * - Environment controls to enable/disable caching
- *
- * **Storage Backends**
- * - Memory: Fast in-memory cache (default for development)
- * - Redis: Distributed cache for production environments
- * - Custom providers: Implement your own storage backend
- *
- * @example
- * ```ts
- * class DataService {
- *   // Function result caching
- *   getUserData = $cache({
- *     name: "user-data",
- *     ttl: [10, "minutes"],
- *     handler: async (userId: string) => {
- *       return await database.users.findById(userId);
- *     }
- *   });
- *
- *   // Manual cache operations
- *   sessionCache = $cache<UserSession>({
- *     name: "sessions",
- *     ttl: [1, "hour"]
- *   });
- *
- *   async storeSession(id: string, session: UserSession) {
- *     await this.sessionCache.set(id, session);
- *   }
- *
- *   async invalidateUserSessions(userId: string) {
- *     await this.sessionCache.invalidate(`user:${userId}:*`);
- *   }
- * }
- * ```
- */
-declare const $cache: {
-  <TReturn = string, TParameter extends any[] = any[]>(options?: CacheDescriptorOptions<TReturn, TParameter>): CacheDescriptorFn<TReturn, TParameter>;
-  [KIND]: typeof CacheDescriptor;
-};
-interface CacheDescriptorOptions<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.
-   */
-  name?: string;
-  /**
-   * Function which returns cached data.
-   */
-  handler?: (...args: TParameter) => TReturn;
-  /**
-   * 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.
-   */
-  provider?: InstantiableClass<CacheProvider> | "memory";
-  /**
-   * 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.
-   */
-  disabled?: boolean;
-}
-declare class CacheDescriptor<TReturn = any, TParameter extends any[] = any[]> extends Descriptor<CacheDescriptorOptions<TReturn, TParameter>> {
-  protected readonly env: {
-    CACHE_ENABLED: boolean;
-    CACHE_DEFAULT_TTL: number;
-  };
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly provider: CacheProvider;
-  protected encoder: TextEncoder;
-  protected decoder: TextDecoder;
-  protected codes: {
-    BINARY: number;
-    JSON: number;
-    STRING: number;
-  };
-  get container(): string;
-  run(...args: TParameter): Promise<TReturn>;
-  key(...args: TParameter): string;
-  invalidate(...keys: string[]): Promise<void>;
-  set(key: string, value: TReturn, ttl?: DurationLike): Promise<void>;
-  get(key: string): Promise<TReturn | undefined>;
-  protected serialize<TReturn>(value: TReturn): Uint8Array;
-  protected deserialize<TReturn>(uint8Array: Uint8Array): Promise<TReturn>;
-  protected $provider(): CacheProvider;
-}
-interface CacheDescriptorFn<TReturn = any, TParameter extends any[] = any[]> extends CacheDescriptor<TReturn, TParameter> {
-  /**
-   * Run the cache descriptor with the provided arguments.
-   */
-  (...args: TParameter): Promise<TReturn>;
-}
-//#endregion
-//#region src/cache/providers/MemoryCacheProvider.d.ts
-type CacheName = string;
-type CacheKey = string;
-type CacheValue = {
-  data?: Uint8Array;
-  timeout?: Timeout;
-};
-declare class MemoryCacheProvider implements CacheProvider {
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: alepha_logger0.Logger;
-  protected store: Record<CacheName, Record<CacheKey, CacheValue>>;
-  get(name: string, key: string): Promise<Uint8Array | undefined>;
-  set(name: string, key: string, value: Uint8Array, ttl?: number): Promise<Uint8Array>;
-  del(name: string, ...keys: string[]): Promise<void>;
-  has(name: string, key: string): Promise<boolean>;
-  keys(name: string, filter?: string): Promise<string[]>;
-  clear(): Promise<void>;
-}
-//#endregion
-//#region src/cache/index.d.ts
-/**
- * Provides high-performance caching capabilities for Alepha applications with configurable TTL and multiple storage backends.
- *
- * The cache module enables declarative caching through the `$cache` descriptor, allowing you to cache method results,
- * API responses, or computed values with automatic invalidation and type safety. It supports both in-memory and
- * persistent storage backends for different performance and durability requirements.
- *
- * @see {@link $cache}
- * @see {@link CacheProvider}
- * @module alepha.cache
- */
-declare const AlephaCache: alepha0.Service<alepha0.Module>;
-//#endregion
-export { $cache, AlephaCache, CacheDescriptor, CacheDescriptorFn, CacheDescriptorOptions, CacheProvider, MemoryCacheProvider };
-//# sourceMappingURL=index.d.cts.map

package/dist/cache-redis/index.cjs

@@ -1,84 +0,0 @@
-let alepha = require("alepha");
-let alepha_cache = require("alepha/cache");
-let alepha_logger = require("alepha/logger");
-let alepha_redis = require("alepha/redis");
-
-//#region src/cache-redis/providers/RedisCacheProvider.ts
-const envSchema = alepha.t.object({ REDIS_CACHE_PREFIX: alepha.t.optional(alepha.t.text({ description: "Force a prefix for all cache keys in Redis. Useful for testing or multi-tenant applications." })) });
-var RedisCacheProvider = class {
-	log = (0, alepha_logger.$logger)();
-	redisProvider = (0, alepha.$inject)(alepha_redis.RedisProvider);
-	env = (0, alepha.$env)(envSchema);
-	alepha = (0, alepha.$inject)(alepha.Alepha);
-	async get(name, key) {
-		if (!this.alepha.isStarted()) return;
-		const keyWithPrefix = this.prefix(name, key);
-		const buffer = await this.redisProvider.get(keyWithPrefix);
-		if (!buffer) return;
-		this.log.debug(`Cache hit`, {
-			size: buffer.byteLength,
-			key: keyWithPrefix
-		});
-		return new Uint8Array(buffer);
-	}
-	async set(name, key, value, ttl) {
-		if (!this.alepha.isReady()) return new Uint8Array(Buffer.from(value));
-		const buffer = Buffer.from(value);
-		const prefix = this.prefix(name, key);
-		if (ttl) return new Uint8Array(await this.redisProvider.set(prefix, buffer, { expiration: {
-			type: "PX",
-			value: ttl
-		} }));
-		return new Uint8Array(await this.redisProvider.set(prefix, buffer));
-	}
-	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);
-			return;
-		}
-		await this.redisProvider.del(keys.map((key) => key.startsWith(nameKey) ? key : this.prefix(name, key)));
-	}
-	async has(name, key) {
-		return this.get(name, key).then((value) => value != null);
-	}
-	async keys(name, filter) {
-		if (filter) return await this.redisProvider.keys(`${this.prefix(name)}:${filter}*`);
-		return this.redisProvider.keys(`${this.prefix(name)}:*`);
-	}
-	async clear() {
-		this.log.debug("Clearing all cache");
-		const pattern = `${this.prefix()}:*`;
-		const keys = await this.redisProvider.keys(pattern);
-		await this.redisProvider.del(keys);
-	}
-	prefix(...path) {
-		const parts = ["cache", ...path];
-		if (this.env.REDIS_CACHE_PREFIX) parts.unshift(this.env.REDIS_CACHE_PREFIX);
-		return parts.join(":");
-	}
-};
-
-//#endregion
-//#region src/cache-redis/index.ts
-/**
-* Plugin for Alepha Cache that provides Redis caching capabilities.
-*
-* @see {@link RedisCacheProvider}
-* @module alepha.cache.redis
-*/
-const AlephaCacheRedis = (0, alepha.$module)({
-	name: "alepha.cache.redis",
-	services: [RedisCacheProvider],
-	register: (alepha$1) => alepha$1.with({
-		provide: alepha_cache.CacheProvider,
-		use: RedisCacheProvider,
-		optional: true
-	}).with(alepha_cache.AlephaCache)
-});
-
-//#endregion
-exports.AlephaCacheRedis = AlephaCacheRedis;
-exports.RedisCacheProvider = RedisCacheProvider;
-//# sourceMappingURL=index.cjs.map

package/dist/cache-redis/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["t","RedisProvider","Alepha","keys","alepha","CacheProvider","AlephaCache"],"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,YAAYA,SAAE,OAAO,EACzB,oBAAoBA,SAAE,SACpBA,SAAE,KAAK,EACL,aACE,gGACH,CAAC,CACH,EACF,CAAC;AAMF,IAAa,qBAAb,MAAyD;CACvD,AAAmB,kCAAe;CAClC,AAAmB,oCAAwBC,2BAAc;CACzD,AAAmB,uBAAW,UAAU;CACxC,AAAmB,6BAAiBC,cAAO;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,MAAMC,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,uCAA2B;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,aACTC,SACG,KAAK;EACJ,SAASC;EACT,KAAK;EACL,UAAU;EACX,CAAC,CACD,KAAKC,yBAAY;CACvB,CAAC"}

package/dist/cache-redis/index.d.cts

@@ -1,40 +0,0 @@
-import * as alepha1 from "alepha";
-import { Alepha, Static } from "alepha";
-import * as alepha_logger0 from "alepha/logger";
-import { CacheProvider } from "alepha/cache";
-import { RedisProvider } from "alepha/redis";
-
-//#region src/cache-redis/providers/RedisCacheProvider.d.ts
-declare const envSchema: alepha1.TObject<{
-  REDIS_CACHE_PREFIX: alepha1.TOptional<alepha1.TString>;
-}>;
-declare module "alepha" {
-  interface Env extends Partial<Static<typeof envSchema>> {}
-}
-declare class RedisCacheProvider implements CacheProvider {
-  protected readonly log: alepha_logger0.Logger;
-  protected readonly redisProvider: RedisProvider;
-  protected readonly env: {
-    REDIS_CACHE_PREFIX?: string | undefined;
-  };
-  protected readonly alepha: Alepha;
-  get(name: string, key: string): Promise<Uint8Array | undefined>;
-  set(name: string, key: string, value: Uint8Array | string, ttl?: number): Promise<Uint8Array>;
-  del(name: string, ...keys: string[]): Promise<void>;
-  has(name: string, key: string): Promise<boolean>;
-  keys(name: string, filter?: string): Promise<string[]>;
-  clear(): Promise<void>;
-  protected prefix(...path: string[]): string;
-}
-//#endregion
-//#region src/cache-redis/index.d.ts
-/**
- * Plugin for Alepha Cache that provides Redis caching capabilities.
- *
- * @see {@link RedisCacheProvider}
- * @module alepha.cache.redis
- */
-declare const AlephaCacheRedis: alepha1.Service<alepha1.Module>;
-//#endregion
-export { AlephaCacheRedis, RedisCacheProvider };
-//# sourceMappingURL=index.d.cts.map

package/dist/cli/chunk-DSlc6foC.cjs

@@ -1,43 +0,0 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-
-Object.defineProperty(exports, '__commonJS', {
-  enumerable: true,
-  get: function () {
-    return __commonJS;
-  }
-});
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});