@igniter-js/caller 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this package will be documented in this file.
 
+## 0.1.3
+
+### Added
+
+- Telemetry integration via `@igniter-js/telemetry` with a dedicated subpath export.
+- Mock store adapter in `@igniter-js/caller/adapters` for testing.
+- Expanded test coverage for core, builders, adapters, and utils.
+
+### Changed
+
+- Standardized builders/core structure and public entrypoint pattern.
+- Updated documentation to match the current API and telemetry events.
+
 ## 0.1.1
 
 ### New Features

package/README.md

@@ -14,7 +14,8 @@ Type-safe HTTP client for Igniter.js apps. Built on top of `fetch`, it gives you
 - ✅ **Retries** - linear or exponential backoff + status-based retry
 - ✅ **Caching** - in-memory cache + optional persistent store adapter
 - ✅ **Schema Validation** - validate request/response using `StandardSchemaV1`
-- ✅ **Zod Support** - optional per-request `responseType(zodSchema)` validation
+- ✅ **StandardSchema Support** - Zod or any library that implements `StandardSchemaV1`
+- ✅ **Telemetry-ready** - optional integration with `@igniter-js/telemetry`
 - ✅ **Global Events** - observe responses for logging/telemetry/cache invalidation
 - ✅ **Auto query encoding** - body in GET requests converts to query params
 
@@ -22,19 +23,29 @@ Type-safe HTTP client for Igniter.js apps. Built on top of `fetch`, it gives you
 
 ```bash
 # npm
-npm install @igniter-js/caller @igniter-js/core zod
+npm install @igniter-js/caller @igniter-js/core
 
 # pnpm
-pnpm add @igniter-js/caller @igniter-js/core zod
+pnpm add @igniter-js/caller @igniter-js/core
 
 # yarn
-yarn add @igniter-js/caller @igniter-js/core zod
+yarn add @igniter-js/caller @igniter-js/core
 
 # bun
-bun add @igniter-js/caller @igniter-js/core zod
+bun add @igniter-js/caller @igniter-js/core
 ```
 
-> `@igniter-js/core` and `zod` are peer dependencies.
+Optional dependencies:
+
+```bash
+# Telemetry (optional)
+npm install @igniter-js/telemetry
+
+# Schema validation (optional - Zod or any StandardSchemaV1-compatible lib)
+npm install zod
+```
+
+> `@igniter-js/core` is required. `@igniter-js/telemetry` and `zod` are optional peer dependencies.
 
 ## Quick Start
 
@@ -230,9 +241,66 @@ const api = IgniterCaller.create()
   .build()
 ```
 
+## Adapters
+
+The package ships a mock store adapter for tests and local development:
+
+```ts
+import { MockCallerStoreAdapter } from '@igniter-js/caller/adapters'
+import { IgniterCaller } from '@igniter-js/caller'
+
+const store = MockCallerStoreAdapter.create()
+
+const api = IgniterCaller.create()
+  .withStore(store)
+  .build()
+```
+
 ## Schema Validation (StandardSchemaV1)
 
 If you already use schemas in your Igniter.js app, you can validate requests and responses automatically.
+Schemas must implement `StandardSchemaV1` (Zod is supported, and any compatible library works).
+
+### Preferred: IgniterCallerSchema builder
+
+```ts
+import { IgniterCaller, IgniterCallerSchema } from '@igniter-js/caller'
+import { z } from 'zod'
+
+const UserSchema = z.object({ id: z.string(), name: z.string() })
+const ErrorSchema = z.object({ message: z.string() })
+
+const callerSchemas = IgniterCallerSchema.create()
+  .schema('User', UserSchema)
+  .schema('Error', ErrorSchema)
+  .path('/users/:id', (path) =>
+    path.get({
+      responses: {
+        200: path.ref('User').schema,
+        404: path.ref('Error').schema,
+      },
+      doc: 'Get user by id',
+      tags: ['users'],
+      operationId: 'users.get',
+    }),
+  )
+  .build()
+
+const api = IgniterCaller.create()
+  .withBaseUrl('https://api.example.com')
+  .withSchemas(callerSchemas, { mode: 'strict' })
+  .build()
+
+type UserResponse = ReturnType<
+  typeof callerSchemas.$Infer.Response<'/users/:id', 'GET', 200>
+>
+```
+
+`callerSchemas.get` exposes runtime helpers (`path`, `endpoint`, `request`, `response`, `schema`) and
+`callerSchemas.$Infer` provides type inference without extra imports. `path.ref()` helpers use Zod
+wrappers; when using a different StandardSchema implementation, use `ref().schema` directly.
+
+### Manual object literal (still supported)
 
 ```ts
 import { IgniterCaller } from '@igniter-js/caller'
@@ -270,10 +338,17 @@ By default this outputs `src/callers/<hostname>/schema.ts` and `index.ts`:
 
 ```ts
 import { facebookCaller } from './src/callers/api.example.com'
+import { facebookCallerSchemas } from './src/callers/api.example.com/schema'
 
 const result = await facebookCaller.get('/products').execute()
+type ProductsResponse = ReturnType<
+  typeof facebookCallerSchemas.$Infer.Response<'/products', 'GET', 200>
+>
 ```
 
+The generated `schema.ts` uses `IgniterCallerSchema` (path-first builder), registers reusable
+schemas, and includes derived type aliases for each endpoint.
+
 ## `responseType()` for Typing and Validation
 
 Use `responseType()` to:
@@ -296,12 +371,12 @@ const result = await api.get('/file').responseType<Blob>().execute()
 
 ## Global Events
 
-You can observe responses globally using `IgniterCaller.on()`:
+You can observe responses globally using `IgniterCallerManager.on()`:
 
 ```ts
-import { IgniterCaller } from '@igniter-js/caller'
+import { IgniterCallerManager } from '@igniter-js/caller'
 
-const unsubscribe = IgniterCaller.on(/^\/users/, (result, ctx) => {
+const unsubscribe = IgniterCallerManager.on(/^\/users/, (result, ctx) => {
   console.log(`[${ctx.method}] ${ctx.url}`, {
     ok: !result.error,
     status: result.status,
@@ -312,6 +387,24 @@ const unsubscribe = IgniterCaller.on(/^\/users/, (result, ctx) => {
 unsubscribe()
 ```
 
+## Observability (Telemetry)
+
+```ts
+import { IgniterTelemetry } from '@igniter-js/telemetry'
+import { IgniterCaller } from '@igniter-js/caller'
+import { IgniterCallerTelemetryEvents } from '@igniter-js/caller/telemetry'
+
+const telemetry = IgniterTelemetry.create()
+  .withService('my-api')
+  .addEvents(IgniterCallerTelemetryEvents)
+  .build()
+
+const api = IgniterCaller.create()
+  .withBaseUrl('https://api.example.com')
+  .withTelemetry(telemetry)
+  .build()
+```
+
 ## Error Handling
 
 All predictable failures return an `IgniterCallerError` with stable error codes.
@@ -351,6 +444,7 @@ Creates a new caller builder.
 | `.withResponseInterceptor(fn)` | Adds a response interceptor |
 | `.withStore(store, options)` | Configures a persistent store |
 | `.withSchemas(schemas, options)` | Configures schema validation |
+| `.withTelemetry(telemetry)` | Attaches telemetry manager |
 | `.build()` | Builds the caller instance |
 
 ### Request Methods
@@ -385,11 +479,11 @@ Creates a new caller builder.
 
 | Method | Description |
 |--------|-------------|
-| `IgniterCaller.on(pattern, callback)` | Registers event listener |
-| `IgniterCaller.off(pattern, callback?)` | Removes event listener |
-| `IgniterCaller.invalidate(key)` | Invalidates cache entry |
-| `IgniterCaller.invalidatePattern(pattern)` | Invalidates cache by pattern |
-| `IgniterCaller.batch(requests)` | Executes requests in parallel |
+| `IgniterCallerManager.on(pattern, callback)` | Registers event listener |
+| `IgniterCallerManager.off(pattern, callback?)` | Removes event listener |
+| `IgniterCallerManager.invalidate(key)` | Invalidates cache entry |
+| `IgniterCallerManager.invalidatePattern(pattern)` | Invalidates cache by pattern |
+| `IgniterCallerManager.batch(requests)` | Executes requests in parallel |
 
 ## Contributing
 

package/dist/adapters/index.d.mts

@@ -0,0 +1 @@
+export { M as MockCallerStoreAdapter } from '../index-COZVROi_.mjs';

package/dist/adapters/index.d.ts

@@ -0,0 +1 @@
+export { M as MockCallerStoreAdapter } from '../index-COZVROi_.js';

package/dist/adapters/index.js

@@ -0,0 +1,91 @@
+'use strict';
+
+// src/adapters/mock.adapter.ts
+var MockCallerStoreAdapter = class _MockCallerStoreAdapter {
+  constructor() {
+    /** Underlying in-memory store. */
+    this.client = /* @__PURE__ */ new Map();
+    /** Tracks all calls for assertions. */
+    this.calls = {
+      get: 0,
+      set: 0,
+      delete: 0,
+      has: 0
+    };
+    /** Captures recent operations. */
+    this.history = {
+      get: [],
+      set: [],
+      delete: [],
+      has: []
+    };
+  }
+  /** Creates a new mock adapter instance. */
+  static create() {
+    return new _MockCallerStoreAdapter();
+  }
+  /**
+   * Retrieves a cached value by key.
+   *
+   * @param key - Cache key (without prefix).
+   * @returns Cached value or null.
+   */
+  async get(key) {
+    this.calls.get += 1;
+    this.history.get.push(key);
+    return this.client.has(key) ? this.client.get(key) : null;
+  }
+  /**
+   * Stores a cached value.
+   *
+   * @param key - Cache key (without prefix).
+   * @param value - Value to store.
+   * @param options - Cache options (ttl, etc).
+   */
+  async set(key, value, options) {
+    this.calls.set += 1;
+    this.history.set.push({ key, value, options });
+    this.client.set(key, value);
+  }
+  /**
+   * Removes a cached value.
+   *
+   * @param key - Cache key (without prefix).
+   */
+  async delete(key) {
+    this.calls.delete += 1;
+    this.history.delete.push(key);
+    this.client.delete(key);
+  }
+  /**
+   * Checks if a cached value exists.
+   *
+   * @param key - Cache key (without prefix).
+   * @returns True when the key exists.
+   */
+  async has(key) {
+    this.calls.has += 1;
+    this.history.has.push(key);
+    return this.client.has(key);
+  }
+  /**
+   * Clears all tracked state.
+   *
+   * @returns Nothing.
+   */
+  clear() {
+    this.client.clear();
+    this.calls.get = 0;
+    this.calls.set = 0;
+    this.calls.delete = 0;
+    this.calls.has = 0;
+    this.history.get = [];
+    this.history.set = [];
+    this.history.delete = [];
+    this.history.has = [];
+  }
+};
+
+exports.MockCallerStoreAdapter = MockCallerStoreAdapter;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/mock.adapter.ts"],"names":[],"mappings":";;;AAUO,IAAM,sBAAA,GAAN,MAAM,uBAAA,CAEb;AAAA,EAFO,WAAA,GAAA;AASL;AAAA,IAAA,IAAA,CAAS,MAAA,uBAAa,GAAA,EAAqB;AAG3C;AAAA,IAAA,IAAA,CAAS,KAAA,GAAQ;AAAA,MACf,GAAA,EAAK,CAAA;AAAA,MACL,GAAA,EAAK,CAAA;AAAA,MACL,MAAA,EAAQ,CAAA;AAAA,MACR,GAAA,EAAK;AAAA,KACP;AAGA;AAAA,IAAA,IAAA,CAAS,OAAA,GAAU;AAAA,MACjB,KAAK,EAAC;AAAA,MACN,KAAK,EAAC;AAAA,MACN,QAAQ,EAAC;AAAA,MACT,KAAK;AAAC,KACR;AAAA,EAAA;AAAA;AAAA,EArBA,OAAO,MAAA,GAAiC;AACtC,IAAA,OAAO,IAAI,uBAAA,EAAuB;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BA,MAAM,IAAa,GAAA,EAAgC;AACjD,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,OAAQ,IAAA,CAAK,OAAO,GAAA,CAAI,GAAG,IAAK,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA,GAAU,IAAA;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,GAAA,CACJ,GAAA,EACA,KAAA,EACA,OAAA,EACe;AACf,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,IAAA,CAAK,EAAE,GAAA,EAAK,KAAA,EAAO,SAAS,CAAA;AAC7C,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,GAAA,EAA4B;AACvC,IAAA,IAAA,CAAK,MAAM,MAAA,IAAU,CAAA;AACrB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA;AAC5B,IAAA,IAAA,CAAK,MAAA,CAAO,OAAO,GAAG,CAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,GAAA,EAA+B;AACvC,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAO,KAAA,EAAM;AAClB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,MAAM,MAAA,GAAS,CAAA;AACpB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AACpB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AACpB,IAAA,IAAA,CAAK,OAAA,CAAQ,SAAS,EAAC;AACvB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AAAA,EACtB;AACF","file":"index.js","sourcesContent":["/**\n * @fileoverview In-memory mock store adapter for @igniter-js/caller.\n * @module @igniter-js/caller/adapters/mock\n */\n\nimport type { IgniterCallerStoreAdapter, IgniterCallerStoreOptions } from \"../types/store\";\n\n/**\n * In-memory mock adapter for request caching in tests.\n */\nexport class MockCallerStoreAdapter\n  implements IgniterCallerStoreAdapter<Map<string, unknown>>\n{\n  /** Creates a new mock adapter instance. */\n  static create(): MockCallerStoreAdapter {\n    return new MockCallerStoreAdapter();\n  }\n\n  /** Underlying in-memory store. */\n  readonly client = new Map<string, unknown>();\n\n  /** Tracks all calls for assertions. */\n  readonly calls = {\n    get: 0,\n    set: 0,\n    delete: 0,\n    has: 0,\n  };\n\n  /** Captures recent operations. */\n  readonly history = {\n    get: [] as string[],\n    set: [] as Array<{ key: string; value: unknown; options?: IgniterCallerStoreOptions }>,\n    delete: [] as string[],\n    has: [] as string[],\n  };\n\n  /**\n   * Retrieves a cached value by key.\n   *\n   * @param key - Cache key (without prefix).\n   * @returns Cached value or null.\n   */\n  async get<T = any>(key: string): Promise<T | null> {\n    this.calls.get += 1;\n    this.history.get.push(key);\n    return (this.client.has(key) ? (this.client.get(key) as T) : null);\n  }\n\n  /**\n   * Stores a cached value.\n   *\n   * @param key - Cache key (without prefix).\n   * @param value - Value to store.\n   * @param options - Cache options (ttl, etc).\n   */\n  async set(\n    key: string,\n    value: any,\n    options?: IgniterCallerStoreOptions,\n  ): Promise<void> {\n    this.calls.set += 1;\n    this.history.set.push({ key, value, options });\n    this.client.set(key, value);\n  }\n\n  /**\n   * Removes a cached value.\n   *\n   * @param key - Cache key (without prefix).\n   */\n  async delete(key: string): Promise<void> {\n    this.calls.delete += 1;\n    this.history.delete.push(key);\n    this.client.delete(key);\n  }\n\n  /**\n   * Checks if a cached value exists.\n   *\n   * @param key - Cache key (without prefix).\n   * @returns True when the key exists.\n   */\n  async has(key: string): Promise<boolean> {\n    this.calls.has += 1;\n    this.history.has.push(key);\n    return this.client.has(key);\n  }\n\n  /**\n   * Clears all tracked state.\n   *\n   * @returns Nothing.\n   */\n  clear(): void {\n    this.client.clear();\n    this.calls.get = 0;\n    this.calls.set = 0;\n    this.calls.delete = 0;\n    this.calls.has = 0;\n    this.history.get = [];\n    this.history.set = [];\n    this.history.delete = [];\n    this.history.has = [];\n  }\n}\n"]}

package/dist/adapters/index.mjs

@@ -0,0 +1,89 @@
+// src/adapters/mock.adapter.ts
+var MockCallerStoreAdapter = class _MockCallerStoreAdapter {
+  constructor() {
+    /** Underlying in-memory store. */
+    this.client = /* @__PURE__ */ new Map();
+    /** Tracks all calls for assertions. */
+    this.calls = {
+      get: 0,
+      set: 0,
+      delete: 0,
+      has: 0
+    };
+    /** Captures recent operations. */
+    this.history = {
+      get: [],
+      set: [],
+      delete: [],
+      has: []
+    };
+  }
+  /** Creates a new mock adapter instance. */
+  static create() {
+    return new _MockCallerStoreAdapter();
+  }
+  /**
+   * Retrieves a cached value by key.
+   *
+   * @param key - Cache key (without prefix).
+   * @returns Cached value or null.
+   */
+  async get(key) {
+    this.calls.get += 1;
+    this.history.get.push(key);
+    return this.client.has(key) ? this.client.get(key) : null;
+  }
+  /**
+   * Stores a cached value.
+   *
+   * @param key - Cache key (without prefix).
+   * @param value - Value to store.
+   * @param options - Cache options (ttl, etc).
+   */
+  async set(key, value, options) {
+    this.calls.set += 1;
+    this.history.set.push({ key, value, options });
+    this.client.set(key, value);
+  }
+  /**
+   * Removes a cached value.
+   *
+   * @param key - Cache key (without prefix).
+   */
+  async delete(key) {
+    this.calls.delete += 1;
+    this.history.delete.push(key);
+    this.client.delete(key);
+  }
+  /**
+   * Checks if a cached value exists.
+   *
+   * @param key - Cache key (without prefix).
+   * @returns True when the key exists.
+   */
+  async has(key) {
+    this.calls.has += 1;
+    this.history.has.push(key);
+    return this.client.has(key);
+  }
+  /**
+   * Clears all tracked state.
+   *
+   * @returns Nothing.
+   */
+  clear() {
+    this.client.clear();
+    this.calls.get = 0;
+    this.calls.set = 0;
+    this.calls.delete = 0;
+    this.calls.has = 0;
+    this.history.get = [];
+    this.history.set = [];
+    this.history.delete = [];
+    this.history.has = [];
+  }
+};
+
+export { MockCallerStoreAdapter };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/adapters/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/mock.adapter.ts"],"names":[],"mappings":";AAUO,IAAM,sBAAA,GAAN,MAAM,uBAAA,CAEb;AAAA,EAFO,WAAA,GAAA;AASL;AAAA,IAAA,IAAA,CAAS,MAAA,uBAAa,GAAA,EAAqB;AAG3C;AAAA,IAAA,IAAA,CAAS,KAAA,GAAQ;AAAA,MACf,GAAA,EAAK,CAAA;AAAA,MACL,GAAA,EAAK,CAAA;AAAA,MACL,MAAA,EAAQ,CAAA;AAAA,MACR,GAAA,EAAK;AAAA,KACP;AAGA;AAAA,IAAA,IAAA,CAAS,OAAA,GAAU;AAAA,MACjB,KAAK,EAAC;AAAA,MACN,KAAK,EAAC;AAAA,MACN,QAAQ,EAAC;AAAA,MACT,KAAK;AAAC,KACR;AAAA,EAAA;AAAA;AAAA,EArBA,OAAO,MAAA,GAAiC;AACtC,IAAA,OAAO,IAAI,uBAAA,EAAuB;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA2BA,MAAM,IAAa,GAAA,EAAgC;AACjD,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,OAAQ,IAAA,CAAK,OAAO,GAAA,CAAI,GAAG,IAAK,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA,GAAU,IAAA;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,GAAA,CACJ,GAAA,EACA,KAAA,EACA,OAAA,EACe;AACf,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,IAAA,CAAK,EAAE,GAAA,EAAK,KAAA,EAAO,SAAS,CAAA;AAC7C,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,KAAK,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,GAAA,EAA4B;AACvC,IAAA,IAAA,CAAK,MAAM,MAAA,IAAU,CAAA;AACrB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA;AAC5B,IAAA,IAAA,CAAK,MAAA,CAAO,OAAO,GAAG,CAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,GAAA,EAA+B;AACvC,IAAA,IAAA,CAAK,MAAM,GAAA,IAAO,CAAA;AAClB,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,GAAG,CAAA;AACzB,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,GAAG,CAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,OAAO,KAAA,EAAM;AAClB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,MAAM,MAAA,GAAS,CAAA;AACpB,IAAA,IAAA,CAAK,MAAM,GAAA,GAAM,CAAA;AACjB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AACpB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AACpB,IAAA,IAAA,CAAK,OAAA,CAAQ,SAAS,EAAC;AACvB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,EAAC;AAAA,EACtB;AACF","file":"index.mjs","sourcesContent":["/**\n * @fileoverview In-memory mock store adapter for @igniter-js/caller.\n * @module @igniter-js/caller/adapters/mock\n */\n\nimport type { IgniterCallerStoreAdapter, IgniterCallerStoreOptions } from \"../types/store\";\n\n/**\n * In-memory mock adapter for request caching in tests.\n */\nexport class MockCallerStoreAdapter\n  implements IgniterCallerStoreAdapter<Map<string, unknown>>\n{\n  /** Creates a new mock adapter instance. */\n  static create(): MockCallerStoreAdapter {\n    return new MockCallerStoreAdapter();\n  }\n\n  /** Underlying in-memory store. */\n  readonly client = new Map<string, unknown>();\n\n  /** Tracks all calls for assertions. */\n  readonly calls = {\n    get: 0,\n    set: 0,\n    delete: 0,\n    has: 0,\n  };\n\n  /** Captures recent operations. */\n  readonly history = {\n    get: [] as string[],\n    set: [] as Array<{ key: string; value: unknown; options?: IgniterCallerStoreOptions }>,\n    delete: [] as string[],\n    has: [] as string[],\n  };\n\n  /**\n   * Retrieves a cached value by key.\n   *\n   * @param key - Cache key (without prefix).\n   * @returns Cached value or null.\n   */\n  async get<T = any>(key: string): Promise<T | null> {\n    this.calls.get += 1;\n    this.history.get.push(key);\n    return (this.client.has(key) ? (this.client.get(key) as T) : null);\n  }\n\n  /**\n   * Stores a cached value.\n   *\n   * @param key - Cache key (without prefix).\n   * @param value - Value to store.\n   * @param options - Cache options (ttl, etc).\n   */\n  async set(\n    key: string,\n    value: any,\n    options?: IgniterCallerStoreOptions,\n  ): Promise<void> {\n    this.calls.set += 1;\n    this.history.set.push({ key, value, options });\n    this.client.set(key, value);\n  }\n\n  /**\n   * Removes a cached value.\n   *\n   * @param key - Cache key (without prefix).\n   */\n  async delete(key: string): Promise<void> {\n    this.calls.delete += 1;\n    this.history.delete.push(key);\n    this.client.delete(key);\n  }\n\n  /**\n   * Checks if a cached value exists.\n   *\n   * @param key - Cache key (without prefix).\n   * @returns True when the key exists.\n   */\n  async has(key: string): Promise<boolean> {\n    this.calls.has += 1;\n    this.history.has.push(key);\n    return this.client.has(key);\n  }\n\n  /**\n   * Clears all tracked state.\n   *\n   * @returns Nothing.\n   */\n  clear(): void {\n    this.client.clear();\n    this.calls.get = 0;\n    this.calls.set = 0;\n    this.calls.delete = 0;\n    this.calls.has = 0;\n    this.history.get = [];\n    this.history.set = [];\n    this.history.delete = [];\n    this.history.has = [];\n  }\n}\n"]}

package/dist/index-COZVROi_.d.mts

@@ -0,0 +1,121 @@
+/**
+ * Store adapter interface compatible with Igniter.js Store.
+ *
+ * This allows IgniterCaller to use any store implementation (Redis, in-memory, etc.)
+ * for persistent caching across requests and deployments.
+ */
+interface IgniterCallerStoreAdapter<TClient = any> {
+    /** The underlying client instance (e.g., Redis client). */
+    readonly client: TClient;
+    /**
+     * Retrieves a value from the store by its key.
+     *
+     * @param key - The key to retrieve.
+     * @returns The value if found (auto-deserialized), otherwise null.
+     */
+    get<T = any>(key: string): Promise<T | null>;
+    /**
+     * Stores a value in the store.
+     *
+     * @param key - The key to store the value under.
+     * @param value - The value to store (will be auto-serialized).
+     * @param options - Configuration options, such as TTL.
+     */
+    set(key: string, value: any, options?: {
+        ttl?: number;
+        [key: string]: any;
+    }): Promise<void>;
+    /**
+     * Deletes a key from the store.
+     *
+     * @param key - The key to delete.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Checks if a key exists in the store.
+     *
+     * @param key - The key to check.
+     * @returns `true` if the key exists, otherwise `false`.
+     */
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Configuration options for store-based caching.
+ */
+interface IgniterCallerStoreOptions {
+    /** Default TTL in seconds for cached entries (default: 3600 = 1 hour). */
+    ttl?: number;
+    /** Prefix for all cache keys (default: 'igniter:caller:'). */
+    keyPrefix?: string;
+    /** Whether to fallback to fetch cache when store is unavailable (default: true). */
+    fallbackToFetch?: boolean;
+}
+
+/**
+ * @fileoverview In-memory mock store adapter for @igniter-js/caller.
+ * @module @igniter-js/caller/adapters/mock
+ */
+
+/**
+ * In-memory mock adapter for request caching in tests.
+ */
+declare class MockCallerStoreAdapter implements IgniterCallerStoreAdapter<Map<string, unknown>> {
+    /** Creates a new mock adapter instance. */
+    static create(): MockCallerStoreAdapter;
+    /** Underlying in-memory store. */
+    readonly client: Map<string, unknown>;
+    /** Tracks all calls for assertions. */
+    readonly calls: {
+        get: number;
+        set: number;
+        delete: number;
+        has: number;
+    };
+    /** Captures recent operations. */
+    readonly history: {
+        get: string[];
+        set: Array<{
+            key: string;
+            value: unknown;
+            options?: IgniterCallerStoreOptions;
+        }>;
+        delete: string[];
+        has: string[];
+    };
+    /**
+     * Retrieves a cached value by key.
+     *
+     * @param key - Cache key (without prefix).
+     * @returns Cached value or null.
+     */
+    get<T = any>(key: string): Promise<T | null>;
+    /**
+     * Stores a cached value.
+     *
+     * @param key - Cache key (without prefix).
+     * @param value - Value to store.
+     * @param options - Cache options (ttl, etc).
+     */
+    set(key: string, value: any, options?: IgniterCallerStoreOptions): Promise<void>;
+    /**
+     * Removes a cached value.
+     *
+     * @param key - Cache key (without prefix).
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Checks if a cached value exists.
+     *
+     * @param key - Cache key (without prefix).
+     * @returns True when the key exists.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clears all tracked state.
+     *
+     * @returns Nothing.
+     */
+    clear(): void;
+}
+
+export { type IgniterCallerStoreAdapter as I, MockCallerStoreAdapter as M, type IgniterCallerStoreOptions as a };

package/dist/index-COZVROi_.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Store adapter interface compatible with Igniter.js Store.
+ *
+ * This allows IgniterCaller to use any store implementation (Redis, in-memory, etc.)
+ * for persistent caching across requests and deployments.
+ */
+interface IgniterCallerStoreAdapter<TClient = any> {
+    /** The underlying client instance (e.g., Redis client). */
+    readonly client: TClient;
+    /**
+     * Retrieves a value from the store by its key.
+     *
+     * @param key - The key to retrieve.
+     * @returns The value if found (auto-deserialized), otherwise null.
+     */
+    get<T = any>(key: string): Promise<T | null>;
+    /**
+     * Stores a value in the store.
+     *
+     * @param key - The key to store the value under.
+     * @param value - The value to store (will be auto-serialized).
+     * @param options - Configuration options, such as TTL.
+     */
+    set(key: string, value: any, options?: {
+        ttl?: number;
+        [key: string]: any;
+    }): Promise<void>;
+    /**
+     * Deletes a key from the store.
+     *
+     * @param key - The key to delete.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Checks if a key exists in the store.
+     *
+     * @param key - The key to check.
+     * @returns `true` if the key exists, otherwise `false`.
+     */
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Configuration options for store-based caching.
+ */
+interface IgniterCallerStoreOptions {
+    /** Default TTL in seconds for cached entries (default: 3600 = 1 hour). */
+    ttl?: number;
+    /** Prefix for all cache keys (default: 'igniter:caller:'). */
+    keyPrefix?: string;
+    /** Whether to fallback to fetch cache when store is unavailable (default: true). */
+    fallbackToFetch?: boolean;
+}
+
+/**
+ * @fileoverview In-memory mock store adapter for @igniter-js/caller.
+ * @module @igniter-js/caller/adapters/mock
+ */
+
+/**
+ * In-memory mock adapter for request caching in tests.
+ */
+declare class MockCallerStoreAdapter implements IgniterCallerStoreAdapter<Map<string, unknown>> {
+    /** Creates a new mock adapter instance. */
+    static create(): MockCallerStoreAdapter;
+    /** Underlying in-memory store. */
+    readonly client: Map<string, unknown>;
+    /** Tracks all calls for assertions. */
+    readonly calls: {
+        get: number;
+        set: number;
+        delete: number;
+        has: number;
+    };
+    /** Captures recent operations. */
+    readonly history: {
+        get: string[];
+        set: Array<{
+            key: string;
+            value: unknown;
+            options?: IgniterCallerStoreOptions;
+        }>;
+        delete: string[];
+        has: string[];
+    };
+    /**
+     * Retrieves a cached value by key.
+     *
+     * @param key - Cache key (without prefix).
+     * @returns Cached value or null.
+     */
+    get<T = any>(key: string): Promise<T | null>;
+    /**
+     * Stores a cached value.
+     *
+     * @param key - Cache key (without prefix).
+     * @param value - Value to store.
+     * @param options - Cache options (ttl, etc).
+     */
+    set(key: string, value: any, options?: IgniterCallerStoreOptions): Promise<void>;
+    /**
+     * Removes a cached value.
+     *
+     * @param key - Cache key (without prefix).
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Checks if a cached value exists.
+     *
+     * @param key - Cache key (without prefix).
+     * @returns True when the key exists.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clears all tracked state.
+     *
+     * @returns Nothing.
+     */
+    clear(): void;
+}
+
+export { type IgniterCallerStoreAdapter as I, MockCallerStoreAdapter as M, type IgniterCallerStoreOptions as a };