@igniter-js/caller 0.1.3 → 0.1.5

package/dist/store-D2p2dqGN.d.mts

@@ -0,0 +1,54 @@
+/**
+ * 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;
+}
+
+export type { IgniterCallerStoreAdapter as I, IgniterCallerStoreOptions as a };

package/dist/store-D2p2dqGN.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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;
+}
+
+export type { IgniterCallerStoreAdapter as I, IgniterCallerStoreOptions as a };

package/dist/telemetry/index.d.mts

@@ -0,0 +1,100 @@
+import * as _igniter_js_telemetry from '@igniter-js/telemetry';
+import { z } from 'zod';
+
+/**
+ * Telemetry events registry for `@igniter-js/caller`.
+ */
+declare const IgniterCallerTelemetryEvents: _igniter_js_telemetry.IgniterTelemetryEventsDescriptor<"igniter.caller", {
+    request: {
+        "execute.started": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    } & {
+        "execute.success": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.request.durationMs": z.ZodNumber;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+            "ctx.response.contentType": z.ZodOptional<z.ZodString>;
+            "ctx.cache.hit": z.ZodOptional<z.ZodBoolean>;
+            "ctx.request.fallback": z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    } & {
+        "execute.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.request.durationMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+            "ctx.error.code": z.ZodString;
+            "ctx.error.message": z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        "timeout.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodNumber;
+        }, z.core.$strip>;
+    };
+} & {
+    cache: {
+        "read.hit": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.cache.key": z.ZodString;
+            "ctx.cache.staleTime": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+} & {
+    retry: {
+        "attempt.started": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.retry.attempt": z.ZodNumber;
+            "ctx.retry.maxAttempts": z.ZodNumber;
+            "ctx.retry.delayMs": z.ZodNumber;
+        }, z.core.$strip>;
+    };
+} & {
+    validation: {
+        "request.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.validation.type": z.ZodEnum<{
+                request: "request";
+                response: "response";
+            }>;
+            "ctx.validation.error": z.ZodString;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    } & {
+        "response.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.validation.type": z.ZodEnum<{
+                request: "request";
+                response: "response";
+            }>;
+            "ctx.validation.error": z.ZodString;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+}>;
+type IgniterCallerTelemetryEvents = typeof IgniterCallerTelemetryEvents.$Infer.registry;
+
+export { IgniterCallerTelemetryEvents };

package/dist/telemetry/index.d.ts

@@ -0,0 +1,100 @@
+import * as _igniter_js_telemetry from '@igniter-js/telemetry';
+import { z } from 'zod';
+
+/**
+ * Telemetry events registry for `@igniter-js/caller`.
+ */
+declare const IgniterCallerTelemetryEvents: _igniter_js_telemetry.IgniterTelemetryEventsDescriptor<"igniter.caller", {
+    request: {
+        "execute.started": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    } & {
+        "execute.success": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.request.durationMs": z.ZodNumber;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+            "ctx.response.contentType": z.ZodOptional<z.ZodString>;
+            "ctx.cache.hit": z.ZodOptional<z.ZodBoolean>;
+            "ctx.request.fallback": z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    } & {
+        "execute.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.request.durationMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+            "ctx.error.code": z.ZodString;
+            "ctx.error.message": z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        "timeout.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodNumber;
+        }, z.core.$strip>;
+    };
+} & {
+    cache: {
+        "read.hit": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.cache.key": z.ZodString;
+            "ctx.cache.staleTime": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+} & {
+    retry: {
+        "attempt.started": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.retry.attempt": z.ZodNumber;
+            "ctx.retry.maxAttempts": z.ZodNumber;
+            "ctx.retry.delayMs": z.ZodNumber;
+        }, z.core.$strip>;
+    };
+} & {
+    validation: {
+        "request.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.validation.type": z.ZodEnum<{
+                request: "request";
+                response: "response";
+            }>;
+            "ctx.validation.error": z.ZodString;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    } & {
+        "response.error": z.ZodObject<{
+            "ctx.request.method": z.ZodString;
+            "ctx.request.url": z.ZodString;
+            "ctx.request.baseUrl": z.ZodOptional<z.ZodString>;
+            "ctx.request.timeoutMs": z.ZodOptional<z.ZodNumber>;
+            "ctx.validation.type": z.ZodEnum<{
+                request: "request";
+                response: "response";
+            }>;
+            "ctx.validation.error": z.ZodString;
+            "ctx.response.status": z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+    };
+}>;
+type IgniterCallerTelemetryEvents = typeof IgniterCallerTelemetryEvents.$Infer.registry;
+
+export { IgniterCallerTelemetryEvents };

package/dist/telemetry/index.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var telemetry = require('@igniter-js/telemetry');
+var zod = require('zod');
+
+// src/telemetry/index.ts
+var RequestBaseSchema = zod.z.object({
+  "ctx.request.method": zod.z.string(),
+  "ctx.request.url": zod.z.string(),
+  "ctx.request.baseUrl": zod.z.string().optional(),
+  "ctx.request.timeoutMs": zod.z.number().optional()
+});
+var RequestSuccessSchema = RequestBaseSchema.extend({
+  "ctx.request.durationMs": zod.z.number(),
+  "ctx.response.status": zod.z.number().optional(),
+  "ctx.response.contentType": zod.z.string().optional(),
+  "ctx.cache.hit": zod.z.boolean().optional(),
+  "ctx.request.fallback": zod.z.boolean().optional()
+});
+var RequestErrorSchema = RequestBaseSchema.extend({
+  "ctx.request.durationMs": zod.z.number().optional(),
+  "ctx.response.status": zod.z.number().optional(),
+  "ctx.error.code": zod.z.string(),
+  "ctx.error.message": zod.z.string()
+});
+var CacheHitSchema = RequestBaseSchema.extend({
+  "ctx.cache.key": zod.z.string(),
+  "ctx.cache.staleTime": zod.z.number().optional()
+});
+var RetryAttemptSchema = RequestBaseSchema.extend({
+  "ctx.retry.attempt": zod.z.number(),
+  "ctx.retry.maxAttempts": zod.z.number(),
+  "ctx.retry.delayMs": zod.z.number()
+});
+var ValidationErrorSchema = RequestBaseSchema.extend({
+  "ctx.validation.type": zod.z.enum(["request", "response"]),
+  "ctx.validation.error": zod.z.string(),
+  "ctx.response.status": zod.z.number().optional()
+});
+var IgniterCallerTelemetryEvents = telemetry.IgniterTelemetryEvents.namespace(
+  "igniter.caller"
+).group(
+  "request",
+  (g) => g.event("execute.started", RequestBaseSchema).event("execute.success", RequestSuccessSchema).event("execute.error", RequestErrorSchema).event("timeout.error", RequestBaseSchema.extend({
+    "ctx.request.timeoutMs": zod.z.number()
+  }))
+).group("cache", (g) => g.event("read.hit", CacheHitSchema)).group("retry", (g) => g.event("attempt.started", RetryAttemptSchema)).group(
+  "validation",
+  (g) => g.event("request.error", ValidationErrorSchema).event("response.error", ValidationErrorSchema)
+).build();
+
+exports.IgniterCallerTelemetryEvents = IgniterCallerTelemetryEvents;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/index.ts"],"names":["z","IgniterTelemetryEvents"],"mappings":";;;;;;AAeA,IAAM,iBAAA,GAAoBA,MAAE,MAAA,CAAO;AAAA,EACjC,oBAAA,EAAsBA,MAAE,MAAA,EAAO;AAAA,EAC/B,iBAAA,EAAmBA,MAAE,MAAA,EAAO;AAAA,EAC5B,qBAAA,EAAuBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,uBAAA,EAAyBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACtC,CAAC,CAAA;AAKD,IAAM,oBAAA,GAAuB,kBAAkB,MAAA,CAAO;AAAA,EACpD,wBAAA,EAA0BA,MAAE,MAAA,EAAO;AAAA,EACnC,qBAAA,EAAuBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,0BAAA,EAA4BA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChD,eAAA,EAAiBA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EACtC,sBAAA,EAAwBA,KAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACtC,CAAC,CAAA;AAKD,IAAM,kBAAA,GAAqB,kBAAkB,MAAA,CAAO;AAAA,EAClD,wBAAA,EAA0BA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC9C,qBAAA,EAAuBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,gBAAA,EAAkBA,MAAE,MAAA,EAAO;AAAA,EAC3B,mBAAA,EAAqBA,MAAE,MAAA;AACzB,CAAC,CAAA;AAKD,IAAM,cAAA,GAAiB,kBAAkB,MAAA,CAAO;AAAA,EAC9C,eAAA,EAAiBA,MAAE,MAAA,EAAO;AAAA,EAC1B,qBAAA,EAAuBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACpC,CAAC,CAAA;AAKD,IAAM,kBAAA,GAAqB,kBAAkB,MAAA,CAAO;AAAA,EAClD,mBAAA,EAAqBA,MAAE,MAAA,EAAO;AAAA,EAC9B,uBAAA,EAAyBA,MAAE,MAAA,EAAO;AAAA,EAClC,mBAAA,EAAqBA,MAAE,MAAA;AACzB,CAAC,CAAA;AAKD,IAAM,qBAAA,GAAwB,kBAAkB,MAAA,CAAO;AAAA,EACrD,uBAAuBA,KAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAW,UAAU,CAAC,CAAA;AAAA,EACrD,sBAAA,EAAwBA,MAAE,MAAA,EAAO;AAAA,EACjC,qBAAA,EAAuBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACpC,CAAC,CAAA;AAKM,IAAM,+BAA+BC,gCAAA,CAAuB,SAAA;AAAA,EACjE;AACF,CAAA,CAIG,KAAA;AAAA,EAAM,SAAA;AAAA,EAAW,CAAC,CAAA,KACjB,CAAA,CACG,MAAM,iBAAA,EAAmB,iBAAiB,EAC1C,KAAA,CAAM,iBAAA,EAAmB,oBAAoB,CAAA,CAC7C,MAAM,eAAA,EAAiB,kBAAkB,EACzC,KAAA,CAAM,eAAA,EAAiB,kBAAkB,MAAA,CAAO;AAAA,IAC/C,uBAAA,EAAyBD,MAAE,MAAA;AAAO,GACnC,CAAC;AACN,CAAA,CAIC,MAAM,OAAA,EAAS,CAAC,MAAM,CAAA,CAAE,KAAA,CAAM,YAAY,cAAc,CAAC,EAIzD,KAAA,CAAM,OAAA,EAAS,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,iBAAA,EAAmB,kBAAkB,CAAC,CAAA,CAIpE,KAAA;AAAA,EAAM,YAAA;AAAA,EAAc,CAAC,MACpB,CAAA,CACG,KAAA,CAAM,iBAAiB,qBAAqB,CAAA,CAC5C,KAAA,CAAM,gBAAA,EAAkB,qBAAqB;AAClD,CAAA,CACC,KAAA","file":"index.js","sourcesContent":["/**\n * @fileoverview Telemetry events for @igniter-js/caller\n * @module @igniter-js/caller/telemetry\n *\n * @description\n * Defines all telemetry events for request execution, caching, retry, and validation.\n * Events follow the `igniter.caller.<group>.<event>` convention.\n */\n\nimport { IgniterTelemetryEvents } from \"@igniter-js/telemetry\";\nimport { z } from \"zod\";\n\n/**\n * Base attributes for request-level telemetry.\n */\nconst RequestBaseSchema = z.object({\n  \"ctx.request.method\": z.string(),\n  \"ctx.request.url\": z.string(),\n  \"ctx.request.baseUrl\": z.string().optional(),\n  \"ctx.request.timeoutMs\": z.number().optional(),\n});\n\n/**\n * Attributes for successful request completion.\n */\nconst RequestSuccessSchema = RequestBaseSchema.extend({\n  \"ctx.request.durationMs\": z.number(),\n  \"ctx.response.status\": z.number().optional(),\n  \"ctx.response.contentType\": z.string().optional(),\n  \"ctx.cache.hit\": z.boolean().optional(),\n  \"ctx.request.fallback\": z.boolean().optional(),\n});\n\n/**\n * Attributes for failed request completion.\n */\nconst RequestErrorSchema = RequestBaseSchema.extend({\n  \"ctx.request.durationMs\": z.number().optional(),\n  \"ctx.response.status\": z.number().optional(),\n  \"ctx.error.code\": z.string(),\n  \"ctx.error.message\": z.string(),\n});\n\n/**\n * Attributes for cache hits.\n */\nconst CacheHitSchema = RequestBaseSchema.extend({\n  \"ctx.cache.key\": z.string(),\n  \"ctx.cache.staleTime\": z.number().optional(),\n});\n\n/**\n * Attributes for retry attempts.\n */\nconst RetryAttemptSchema = RequestBaseSchema.extend({\n  \"ctx.retry.attempt\": z.number(),\n  \"ctx.retry.maxAttempts\": z.number(),\n  \"ctx.retry.delayMs\": z.number(),\n});\n\n/**\n * Attributes for validation errors.\n */\nconst ValidationErrorSchema = RequestBaseSchema.extend({\n  \"ctx.validation.type\": z.enum([\"request\", \"response\"]),\n  \"ctx.validation.error\": z.string(),\n  \"ctx.response.status\": z.number().optional(),\n});\n\n/**\n * Telemetry events registry for `@igniter-js/caller`.\n */\nexport const IgniterCallerTelemetryEvents = IgniterTelemetryEvents.namespace(\n  \"igniter.caller\",\n)\n  // ============================================================================\n  // REQUEST EVENTS\n  // ============================================================================\n  .group(\"request\", (g) =>\n    g\n      .event(\"execute.started\", RequestBaseSchema)\n      .event(\"execute.success\", RequestSuccessSchema)\n      .event(\"execute.error\", RequestErrorSchema)\n      .event(\"timeout.error\", RequestBaseSchema.extend({\n        \"ctx.request.timeoutMs\": z.number(),\n      })),\n  )\n  // ============================================================================\n  // CACHE EVENTS\n  // ============================================================================\n  .group(\"cache\", (g) => g.event(\"read.hit\", CacheHitSchema))\n  // ============================================================================\n  // RETRY EVENTS\n  // ============================================================================\n  .group(\"retry\", (g) => g.event(\"attempt.started\", RetryAttemptSchema))\n  // ============================================================================\n  // VALIDATION EVENTS\n  // ============================================================================\n  .group(\"validation\", (g) =>\n    g\n      .event(\"request.error\", ValidationErrorSchema)\n      .event(\"response.error\", ValidationErrorSchema),\n  )\n  .build();\n\nexport type IgniterCallerTelemetryEvents =\n  typeof IgniterCallerTelemetryEvents.$Infer.registry;\n"]}

package/dist/telemetry/index.mjs

@@ -0,0 +1,52 @@
+import { IgniterTelemetryEvents } from '@igniter-js/telemetry';
+import { z } from 'zod';
+
+// src/telemetry/index.ts
+var RequestBaseSchema = z.object({
+  "ctx.request.method": z.string(),
+  "ctx.request.url": z.string(),
+  "ctx.request.baseUrl": z.string().optional(),
+  "ctx.request.timeoutMs": z.number().optional()
+});
+var RequestSuccessSchema = RequestBaseSchema.extend({
+  "ctx.request.durationMs": z.number(),
+  "ctx.response.status": z.number().optional(),
+  "ctx.response.contentType": z.string().optional(),
+  "ctx.cache.hit": z.boolean().optional(),
+  "ctx.request.fallback": z.boolean().optional()
+});
+var RequestErrorSchema = RequestBaseSchema.extend({
+  "ctx.request.durationMs": z.number().optional(),
+  "ctx.response.status": z.number().optional(),
+  "ctx.error.code": z.string(),
+  "ctx.error.message": z.string()
+});
+var CacheHitSchema = RequestBaseSchema.extend({
+  "ctx.cache.key": z.string(),
+  "ctx.cache.staleTime": z.number().optional()
+});
+var RetryAttemptSchema = RequestBaseSchema.extend({
+  "ctx.retry.attempt": z.number(),
+  "ctx.retry.maxAttempts": z.number(),
+  "ctx.retry.delayMs": z.number()
+});
+var ValidationErrorSchema = RequestBaseSchema.extend({
+  "ctx.validation.type": z.enum(["request", "response"]),
+  "ctx.validation.error": z.string(),
+  "ctx.response.status": z.number().optional()
+});
+var IgniterCallerTelemetryEvents = IgniterTelemetryEvents.namespace(
+  "igniter.caller"
+).group(
+  "request",
+  (g) => g.event("execute.started", RequestBaseSchema).event("execute.success", RequestSuccessSchema).event("execute.error", RequestErrorSchema).event("timeout.error", RequestBaseSchema.extend({
+    "ctx.request.timeoutMs": z.number()
+  }))
+).group("cache", (g) => g.event("read.hit", CacheHitSchema)).group("retry", (g) => g.event("attempt.started", RetryAttemptSchema)).group(
+  "validation",
+  (g) => g.event("request.error", ValidationErrorSchema).event("response.error", ValidationErrorSchema)
+).build();
+
+export { IgniterCallerTelemetryEvents };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/telemetry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/index.ts"],"names":[],"mappings":";;;;AAeA,IAAM,iBAAA,GAAoB,EAAE,MAAA,CAAO;AAAA,EACjC,oBAAA,EAAsB,EAAE,MAAA,EAAO;AAAA,EAC/B,iBAAA,EAAmB,EAAE,MAAA,EAAO;AAAA,EAC5B,qBAAA,EAAuB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,uBAAA,EAAyB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACtC,CAAC,CAAA;AAKD,IAAM,oBAAA,GAAuB,kBAAkB,MAAA,CAAO;AAAA,EACpD,wBAAA,EAA0B,EAAE,MAAA,EAAO;AAAA,EACnC,qBAAA,EAAuB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,0BAAA,EAA4B,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAChD,eAAA,EAAiB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,EAAS;AAAA,EACtC,sBAAA,EAAwB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA;AACtC,CAAC,CAAA;AAKD,IAAM,kBAAA,GAAqB,kBAAkB,MAAA,CAAO;AAAA,EAClD,wBAAA,EAA0B,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC9C,qBAAA,EAAuB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC3C,gBAAA,EAAkB,EAAE,MAAA,EAAO;AAAA,EAC3B,mBAAA,EAAqB,EAAE,MAAA;AACzB,CAAC,CAAA;AAKD,IAAM,cAAA,GAAiB,kBAAkB,MAAA,CAAO;AAAA,EAC9C,eAAA,EAAiB,EAAE,MAAA,EAAO;AAAA,EAC1B,qBAAA,EAAuB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACpC,CAAC,CAAA;AAKD,IAAM,kBAAA,GAAqB,kBAAkB,MAAA,CAAO;AAAA,EAClD,mBAAA,EAAqB,EAAE,MAAA,EAAO;AAAA,EAC9B,uBAAA,EAAyB,EAAE,MAAA,EAAO;AAAA,EAClC,mBAAA,EAAqB,EAAE,MAAA;AACzB,CAAC,CAAA;AAKD,IAAM,qBAAA,GAAwB,kBAAkB,MAAA,CAAO;AAAA,EACrD,uBAAuB,CAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAW,UAAU,CAAC,CAAA;AAAA,EACrD,sBAAA,EAAwB,EAAE,MAAA,EAAO;AAAA,EACjC,qBAAA,EAAuB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACpC,CAAC,CAAA;AAKM,IAAM,+BAA+B,sBAAA,CAAuB,SAAA;AAAA,EACjE;AACF,CAAA,CAIG,KAAA;AAAA,EAAM,SAAA;AAAA,EAAW,CAAC,CAAA,KACjB,CAAA,CACG,MAAM,iBAAA,EAAmB,iBAAiB,EAC1C,KAAA,CAAM,iBAAA,EAAmB,oBAAoB,CAAA,CAC7C,MAAM,eAAA,EAAiB,kBAAkB,EACzC,KAAA,CAAM,eAAA,EAAiB,kBAAkB,MAAA,CAAO;AAAA,IAC/C,uBAAA,EAAyB,EAAE,MAAA;AAAO,GACnC,CAAC;AACN,CAAA,CAIC,MAAM,OAAA,EAAS,CAAC,MAAM,CAAA,CAAE,KAAA,CAAM,YAAY,cAAc,CAAC,EAIzD,KAAA,CAAM,OAAA,EAAS,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,iBAAA,EAAmB,kBAAkB,CAAC,CAAA,CAIpE,KAAA;AAAA,EAAM,YAAA;AAAA,EAAc,CAAC,MACpB,CAAA,CACG,KAAA,CAAM,iBAAiB,qBAAqB,CAAA,CAC5C,KAAA,CAAM,gBAAA,EAAkB,qBAAqB;AAClD,CAAA,CACC,KAAA","file":"index.mjs","sourcesContent":["/**\n * @fileoverview Telemetry events for @igniter-js/caller\n * @module @igniter-js/caller/telemetry\n *\n * @description\n * Defines all telemetry events for request execution, caching, retry, and validation.\n * Events follow the `igniter.caller.<group>.<event>` convention.\n */\n\nimport { IgniterTelemetryEvents } from \"@igniter-js/telemetry\";\nimport { z } from \"zod\";\n\n/**\n * Base attributes for request-level telemetry.\n */\nconst RequestBaseSchema = z.object({\n  \"ctx.request.method\": z.string(),\n  \"ctx.request.url\": z.string(),\n  \"ctx.request.baseUrl\": z.string().optional(),\n  \"ctx.request.timeoutMs\": z.number().optional(),\n});\n\n/**\n * Attributes for successful request completion.\n */\nconst RequestSuccessSchema = RequestBaseSchema.extend({\n  \"ctx.request.durationMs\": z.number(),\n  \"ctx.response.status\": z.number().optional(),\n  \"ctx.response.contentType\": z.string().optional(),\n  \"ctx.cache.hit\": z.boolean().optional(),\n  \"ctx.request.fallback\": z.boolean().optional(),\n});\n\n/**\n * Attributes for failed request completion.\n */\nconst RequestErrorSchema = RequestBaseSchema.extend({\n  \"ctx.request.durationMs\": z.number().optional(),\n  \"ctx.response.status\": z.number().optional(),\n  \"ctx.error.code\": z.string(),\n  \"ctx.error.message\": z.string(),\n});\n\n/**\n * Attributes for cache hits.\n */\nconst CacheHitSchema = RequestBaseSchema.extend({\n  \"ctx.cache.key\": z.string(),\n  \"ctx.cache.staleTime\": z.number().optional(),\n});\n\n/**\n * Attributes for retry attempts.\n */\nconst RetryAttemptSchema = RequestBaseSchema.extend({\n  \"ctx.retry.attempt\": z.number(),\n  \"ctx.retry.maxAttempts\": z.number(),\n  \"ctx.retry.delayMs\": z.number(),\n});\n\n/**\n * Attributes for validation errors.\n */\nconst ValidationErrorSchema = RequestBaseSchema.extend({\n  \"ctx.validation.type\": z.enum([\"request\", \"response\"]),\n  \"ctx.validation.error\": z.string(),\n  \"ctx.response.status\": z.number().optional(),\n});\n\n/**\n * Telemetry events registry for `@igniter-js/caller`.\n */\nexport const IgniterCallerTelemetryEvents = IgniterTelemetryEvents.namespace(\n  \"igniter.caller\",\n)\n  // ============================================================================\n  // REQUEST EVENTS\n  // ============================================================================\n  .group(\"request\", (g) =>\n    g\n      .event(\"execute.started\", RequestBaseSchema)\n      .event(\"execute.success\", RequestSuccessSchema)\n      .event(\"execute.error\", RequestErrorSchema)\n      .event(\"timeout.error\", RequestBaseSchema.extend({\n        \"ctx.request.timeoutMs\": z.number(),\n      })),\n  )\n  // ============================================================================\n  // CACHE EVENTS\n  // ============================================================================\n  .group(\"cache\", (g) => g.event(\"read.hit\", CacheHitSchema))\n  // ============================================================================\n  // RETRY EVENTS\n  // ============================================================================\n  .group(\"retry\", (g) => g.event(\"attempt.started\", RetryAttemptSchema))\n  // ============================================================================\n  // VALIDATION EVENTS\n  // ============================================================================\n  .group(\"validation\", (g) =>\n    g\n      .event(\"request.error\", ValidationErrorSchema)\n      .event(\"response.error\", ValidationErrorSchema),\n  )\n  .build();\n\nexport type IgniterCallerTelemetryEvents =\n  typeof IgniterCallerTelemetryEvents.$Infer.registry;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igniter-js/caller",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Type-safe HTTP client for Igniter.js with interceptors, retries, caching, and StandardSchema validation",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,8 +14,23 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
+      "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./telemetry": {
+      "types": "./dist/telemetry/index.d.ts",
+      "import": "./dist/telemetry/index.mjs",
+      "require": "./dist/telemetry/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.mjs",
+      "require": "./dist/adapters/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
     }
   },
   "scripts": {
@@ -52,17 +67,31 @@
     "url": "https://github.com/felipebarcelospro/igniter-js/issues"
   },
   "homepage": "https://igniterjs.com",
+  "dependencies": {
+    "@igniter-js/common": ">=0.1.0",
+    "@igniter-js/telemetry": ">=0.1.12"
+  },
   "devDependencies": {
-    "@igniter-js/core": "*",
+    "@igniter-js/common": "*",
+    "@igniter-js/telemetry": "*",
     "@types/node": "^22.7.5",
     "tsup": "^8.3.0",
     "typescript": "^5.6.3",
     "vitest": "^2.1.4",
-    "zod": "^3.23.8"
+    "zod": "^4.2.1",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1"
   },
   "peerDependencies": {
-    "@igniter-js/core": "*",
-    "zod": "^3.0.0"
+    "@igniter-js/common": ">=0.1.0",
+    "@igniter-js/telemetry": ">=0.1.12",
+    "zod": ">=4.2.1",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "access": "public"