meridianjs 0.1.0

package/dist/core/types.js

@@ -0,0 +1,92 @@
+export class MeridianError extends Error {
+    category;
+    retryable;
+    provider;
+    requestId;
+    status;
+    metadata;
+    retryAfter;
+    constructor(message, category, provider, retryable, requestId = "", metadata, retryAfter, status) {
+        super(message);
+        this.name = "MeridianError";
+        this.category = category;
+        this.provider = provider;
+        this.retryable = retryable;
+        this.requestId = requestId;
+        if (status !== undefined) {
+            this.status = status;
+        }
+        if (metadata !== undefined) {
+            this.metadata = metadata;
+        }
+        if (retryAfter !== undefined) {
+            this.retryAfter = retryAfter;
+        }
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, MeridianError);
+        }
+    }
+    /**
+     * Returns the frozen error code from the MeridianErrorCode enum.
+     * Maps internal category to public error code contract.
+     */
+    get code() {
+        return mapCategoryToErrorCode(this.category, this.status);
+    }
+}
+export function mapCategoryToErrorCode(category, status) {
+    switch (category) {
+        case "auth":
+            return "AUTH_FAILED";
+        case "rate_limit":
+            return "RATE_LIMITED";
+        case "network":
+            return "NETWORK_ERROR";
+        case "validation":
+            if (status === 404) {
+                return "NOT_FOUND";
+            }
+            if (status && status >= 400 && status < 500) {
+                return "BAD_REQUEST";
+            }
+            return "BAD_REQUEST";
+        case "provider":
+            if (status && status >= 500) {
+                return "UPSTREAM_5XX";
+            }
+            return "UNKNOWN";
+        default:
+            return "UNKNOWN";
+    }
+}
+export function isRetryableByCode(code) {
+    switch (code) {
+        case "NETWORK_ERROR":
+        case "TIMEOUT":
+        case "UPSTREAM_5XX":
+        case "RATE_LIMITED":
+            return true;
+        case "AUTH_FAILED":
+        case "NOT_FOUND":
+        case "BAD_REQUEST":
+        case "UNKNOWN":
+        default:
+            return false;
+    }
+}
+export var IdempotencyLevel;
+(function (IdempotencyLevel) {
+    IdempotencyLevel["SAFE"] = "SAFE";
+    IdempotencyLevel["IDEMPOTENT"] = "IDEMPOTENT";
+    IdempotencyLevel["CONDITIONAL"] = "CONDITIONAL";
+    IdempotencyLevel["UNSAFE"] = "UNSAFE";
+})(IdempotencyLevel || (IdempotencyLevel = {}));
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+import packageJson from "../../package.json";
+export const SDK_VERSION = packageJson.version;
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import type { MeridianConfig, ProviderConfig, NormalizedResponse, CircuitBreakerStatus, RequestOptions } from "./core/types.js";
+import type { ProviderAdapter } from "./core/types.js";
+export interface ProviderClient {
+    get<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
+    post<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
+    put<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
+    patch<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
+    delete<T = unknown>(endpoint: string, options?: RequestOptions): Promise<NormalizedResponse<T>>;
+    paginate<T = unknown>(endpoint: string, options?: RequestOptions): AsyncGenerator<NormalizedResponse<T>>;
+}
+export declare class Meridian {
+    private config;
+    private pipelines;
+    private circuitBreakers;
+    private observability;
+    private adapters;
+    private started;
+    private adapterCache;
+    private constructor();
+    static create(config: MeridianConfig, adapters?: Map<string, ProviderAdapter>): Promise<Meridian>;
+    private emitLocalStateWarning;
+    private validateConfig;
+    private initializeProvider;
+    private createProviderClient;
+    getCircuitStatus(provider: string): CircuitBreakerStatus | null;
+    provider(name: "anthropic"): ProviderClient | undefined;
+    provider(name: "openai"): ProviderClient | undefined;
+    provider(name: "stripe"): ProviderClient | undefined;
+    provider(name: "github"): ProviderClient | undefined;
+    provider(name: string): ProviderClient | undefined;
+    registerProvider(name: string, adapter: ProviderAdapter, config: ProviderConfig): Promise<void>;
+    start(): Promise<void>;
+    private ensureStarted;
+}
+export * from "./core/types.js";
+export * from "./observability/index.js";
+export * from "./strategies/index.js";
+export * from "./validation/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EAEpB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAQzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAsCvD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC1G;AAGD,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAA2C;IAE/D,OAAO;WA0DM,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAOnF,OAAO,CAAC,qBAAqB;IA2D7B,OAAO,CAAC,cAAc;YAuDR,kBAAkB;IAwFhC,OAAO,CAAC,oBAAoB;IAsG5B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAO/D,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS;IACvD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAS5C,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IAuBV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B,OAAO,CAAC,aAAa;CAQtB;AAGD,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,341 @@
+import { RequestPipeline } from "./core/pipeline.js";
+import { ProviderCircuitBreaker } from "./strategies/circuit-breaker.js";
+import { RateLimiter } from "./strategies/rate-limit.js";
+import { RetryStrategy } from "./strategies/retry.js";
+import { IdempotencyResolver } from "./strategies/idempotency.js";
+import { IdempotencyLevel } from "./core/types.js";
+import { ConsoleObservability } from "./observability/console.js";
+import { assertValidAdapter } from "./core/adapter-validator.js";
+import { GitHubAdapter } from "./providers/github/adapter.js";
+import { AnthropicAdapter } from "./providers/anthropic/adapter.js";
+import { OpenAIAdapter } from "./providers/openai/adapter.js";
+import { StripeAdapter } from "./providers/stripe/adapter.js";
+import { sanitizeObject } from "./core/observability-sanitizer.js";
+const BUILTIN_ADAPTER_CLASSES = {
+    github: GitHubAdapter,
+    anthropic: AnthropicAdapter,
+    openai: OpenAIAdapter,
+    stripe: StripeAdapter,
+};
+function getBuiltinAdapter(name, cache) {
+    if (cache.has(name)) {
+        return cache.get(name);
+    }
+    const AdapterClass = BUILTIN_ADAPTER_CLASSES[name];
+    if (!AdapterClass) {
+        return null;
+    }
+    const adapter = new AdapterClass();
+    cache.set(name, adapter);
+    return adapter;
+}
+export class Meridian {
+    config;
+    pipelines = new Map();
+    circuitBreakers = new Map();
+    observability;
+    adapters = new Map();
+    started = false;
+    adapterCache = new Map();
+    constructor(config, adapters) {
+        this.validateConfig(config);
+        const providers = "providers" in config && config.providers
+            ? config.providers
+            : (() => {
+                const knownKeys = new Set([
+                    "defaults",
+                    "schemaValidation",
+                    "observability",
+                    "observabilitySanitizer",
+                    "idempotency",
+                    "providers",
+                    "stateStorage",
+                    "localUnsafe",
+                    "mode",
+                    "compliance",
+                ]);
+                const providerConfigs = {};
+                for (const [key, value] of Object.entries(config)) {
+                    if (!knownKeys.has(key) && value && typeof value === "object") {
+                        providerConfigs[key] = value;
+                    }
+                }
+                return providerConfigs;
+            })();
+        this.config = {
+            ...config,
+            providers,
+        };
+        if (adapters) {
+            this.adapters = adapters;
+        }
+        if (Array.isArray(this.config.observability)) {
+            this.observability = this.config.observability;
+        }
+        else if (this.config.observability) {
+            this.observability = [this.config.observability];
+        }
+        else {
+            this.observability = [new ConsoleObservability()];
+        }
+    }
+    static async create(config, adapters) {
+        const b = new Meridian(config, adapters);
+        await b.start();
+        return b;
+    }
+    emitLocalStateWarning() {
+        const warning = [
+            "[Meridian] WARNING: Using in-memory state for circuit breaker and rate limiter.",
+            "This state will be lost on process restart or serverless cold start.",
+            "For production serverless deployments, consider:",
+            "  1. Implementing StateStorage interface with Redis/Memcached",
+            "  2. Using external rate limiting (API gateway)",
+            "  3. Accepting state reset as a trade-off for simplicity",
+            "See: https://github.com/Raghaverma/Meridian#state-persistence",
+        ].join("\n");
+        const safeMetadata = sanitizeObject({ component: "Meridian", type: "state_warning" }, this.config.observabilitySanitizer);
+        if (this.observability && this.observability.length > 0) {
+            const errors = [];
+            for (const obs of this.observability) {
+                try {
+                    obs.logWarning(warning, safeMetadata);
+                }
+                catch (error) {
+                    errors.push({
+                        adapter: obs.constructor?.name || "UnknownObservabilityAdapter",
+                        error,
+                    });
+                }
+            }
+            if (errors.length === this.observability.length) {
+                console.warn(warning);
+                console.error(`[Meridian] All observability adapters failed for logWarning:\n${errors
+                    .map(({ adapter, error }) => `  - ${adapter}: ${error instanceof Error ? error.message : String(error)}`)
+                    .join("\n")}`);
+            }
+            else if (errors.length > 0) {
+                console.error(`[Meridian] Some observability adapters failed for logWarning (${errors.length}/${this.observability.length}):\n${errors
+                    .map(({ adapter, error }) => `  - ${adapter}: ${error instanceof Error ? error.message : String(error)}`)
+                    .join("\n")}`);
+            }
+        }
+        else {
+            console.warn(warning);
+        }
+    }
+    validateConfig(config) {
+        const errors = [];
+        if (config.defaults?.rateLimit) {
+            const { tokensPerSecond, maxTokens, queueSize } = config.defaults.rateLimit;
+            if (tokensPerSecond !== undefined && tokensPerSecond <= 0) {
+                errors.push("defaults.rateLimit.tokensPerSecond must be positive");
+            }
+            if (maxTokens !== undefined && maxTokens <= 0) {
+                errors.push("defaults.rateLimit.maxTokens must be positive");
+            }
+            if (queueSize !== undefined && queueSize <= 0) {
+                errors.push("defaults.rateLimit.queueSize must be positive");
+            }
+        }
+        if (config.defaults?.retry) {
+            const { maxRetries, baseDelay, maxDelay } = config.defaults.retry;
+            if (maxRetries !== undefined && maxRetries < 0) {
+                errors.push("defaults.retry.maxRetries must be non-negative");
+            }
+            if (baseDelay !== undefined && baseDelay <= 0) {
+                errors.push("defaults.retry.baseDelay must be positive");
+            }
+            if (maxDelay !== undefined && maxDelay <= 0) {
+                errors.push("defaults.retry.maxDelay must be positive");
+            }
+        }
+        if (config.defaults?.circuitBreaker) {
+            const { failureThreshold, timeout, successThreshold } = config.defaults.circuitBreaker;
+            if (failureThreshold !== undefined && failureThreshold <= 0) {
+                errors.push("defaults.circuitBreaker.failureThreshold must be positive");
+            }
+            if (timeout !== undefined && timeout <= 0) {
+                errors.push("defaults.circuitBreaker.timeout must be positive");
+            }
+            if (successThreshold !== undefined && successThreshold <= 0) {
+                errors.push("defaults.circuitBreaker.successThreshold must be positive");
+            }
+        }
+        if (config.defaults?.timeout !== undefined && config.defaults.timeout <= 0) {
+            errors.push("defaults.timeout must be positive");
+        }
+        if (errors.length > 0) {
+            throw new Error(`Invalid Meridian configuration:\n  - ${errors.join()}`);
+        }
+    }
+    async initializeProvider(providerName, providerConfig) {
+        let adapter = providerConfig.adapter ?? this.adapters.get(providerName);
+        if (!adapter) {
+            const builtinAdapter = getBuiltinAdapter(providerName, this.adapterCache);
+            if (builtinAdapter) {
+                this.adapters.set(providerName, builtinAdapter);
+                adapter = builtinAdapter;
+            }
+        }
+        if (!adapter) {
+            throw new Error(`No adapter found for provider: ${providerName}. Provide adapter in config or use registerProvider().`);
+        }
+        await assertValidAdapter(adapter, providerName);
+        this.adapters.set(providerName, adapter);
+        const circuitBreakerConfig = {
+            ...this.config.defaults?.circuitBreaker,
+            ...providerConfig.circuitBreaker,
+        };
+        const circuitBreaker = new ProviderCircuitBreaker(providerName, circuitBreakerConfig);
+        this.circuitBreakers.set(providerName, circuitBreaker);
+        const rateLimitConfig = {
+            ...this.config.defaults?.rateLimit,
+            ...providerConfig.rateLimit,
+        };
+        const rateLimiter = new RateLimiter(rateLimitConfig);
+        const retryConfig = {
+            ...this.config.defaults?.retry,
+            ...providerConfig.retry,
+        };
+        const idempotencyConfig = adapter.getIdempotencyConfig();
+        const idempotencyResolver = new IdempotencyResolver({
+            ...idempotencyConfig,
+            ...providerConfig.idempotency,
+        }, this.config.idempotency?.defaultLevel ?? IdempotencyLevel.SAFE);
+        const retryStrategy = new RetryStrategy(retryConfig, idempotencyResolver);
+        const pipelineConfig = {
+            provider: providerName,
+            adapter,
+            authConfig: providerConfig.auth,
+            circuitBreaker,
+            rateLimiter,
+            retryStrategy,
+            idempotencyResolver,
+            observability: this.observability,
+            timeout: this.config.defaults?.timeout ?? undefined,
+            autoGenerateIdempotencyKeys: this.config.idempotency?.autoGenerateKeys ?? false,
+            sanitizerOptions: {
+                ...(this.config.observabilitySanitizer ?? {}),
+                piiRedaction: this.config.compliance?.piiRedaction,
+            },
+            compliance: this.config.compliance,
+        };
+        const pipeline = new RequestPipeline(pipelineConfig);
+        this.pipelines.set(providerName, pipeline);
+        this[providerName] = this.createProviderClient(providerName);
+    }
+    createProviderClient(providerName) {
+        const pipeline = this.pipelines.get(providerName);
+        const adapter = this.adapters.get(providerName);
+        if (!adapter) {
+            throw new Error(`Adapter not found for provider: ${providerName}`);
+        }
+        const meridian = this;
+        const maxPages = 1000;
+        const makeRequest = async (method, endpoint, options = {}) => {
+            meridian.ensureStarted();
+            return pipeline.execute(endpoint, {
+                ...options,
+                method: method,
+            });
+        };
+        const paginate = async function* (endpoint, options = {}) {
+            meridian.ensureStarted();
+            const currentAdapter = meridian.adapters.get(providerName);
+            if (!currentAdapter) {
+                throw new Error(`Adapter not found for provider: ${providerName}`);
+            }
+            let currentEndpoint = endpoint;
+            let currentOptions = { ...options, method: "GET" };
+            let pageCount = 0;
+            const seenCursors = new Set();
+            const paginationStrategy = currentAdapter.paginationStrategy();
+            while (pageCount < maxPages) {
+                const response = await makeRequest("GET", currentEndpoint, currentOptions);
+                pageCount++;
+                yield response;
+                const hasNext = response.meta.pagination?.hasNext ?? false;
+                const cursor = response.meta.pagination?.cursor;
+                if (!hasNext || !cursor) {
+                    break;
+                }
+                if (seenCursors.has(cursor)) {
+                    throw new Error(`Pagination cycle detected: cursor "${cursor}" was encountered twice. ` +
+                        `This indicates a malformed pagination implementation. Stopping at page ${pageCount}.`);
+                }
+                seenCursors.add(cursor);
+                const next = paginationStrategy.buildNextRequest(currentEndpoint, currentOptions, cursor);
+                currentEndpoint = next.endpoint;
+                currentOptions = next.options;
+            }
+            if (pageCount >= maxPages) {
+                throw new Error(`Pagination limit reached: ${maxPages} pages. ` +
+                    `This may indicate an infinite pagination loop. Consider using a more specific query.`);
+            }
+        };
+        return {
+            get: (endpoint, options) => makeRequest("GET", endpoint, options),
+            post: (endpoint, options) => makeRequest("POST", endpoint, options),
+            put: (endpoint, options) => makeRequest("PUT", endpoint, options),
+            patch: (endpoint, options) => makeRequest("PATCH", endpoint, options),
+            delete: (endpoint, options) => makeRequest("DELETE", endpoint, options),
+            paginate: (endpoint, options) => paginate(endpoint, options),
+        };
+    }
+    getCircuitStatus(provider) {
+        this.ensureStarted();
+        const circuitBreaker = this.circuitBreakers.get(provider);
+        return circuitBreaker?.getStatus() ?? null;
+    }
+    provider(name) {
+        this.ensureStarted();
+        return this[name];
+    }
+    async registerProvider(name, adapter, config) {
+        this.ensureStarted();
+        this.adapters.set(name, adapter);
+        if (!this.config.providers) {
+            this.config.providers = {};
+        }
+        this.config.providers[name] = {
+            ...config,
+            adapter,
+        };
+        if (this.started) {
+            await this.initializeProvider(name, this.config.providers[name]);
+        }
+    }
+    async start() {
+        if (this.config.mode === "distributed" && !this.config.stateStorage) {
+            throw new Error("Meridian requires a configured stateStorage in 'distributed' mode. " +
+                "Provide a StateStorage implementation (e.g., Redis) for distributed deployments. " +
+                "If you intend to use local in-memory state, set mode to 'local' or omit the mode field.");
+        }
+        if (!this.config.stateStorage && !this.config.localUnsafe && this.config.mode !== "local") {
+            throw new Error("Meridian requires a configured stateStorage unless 'localUnsafe' is set to true. " +
+                "For production deployments, provide a StateStorage implementation. " +
+                "For local development, explicitly set 'localUnsafe: true' to acknowledge the limitation.");
+        }
+        if (this.config.providers) {
+            for (const [providerName, providerConfig] of Object.entries(this.config.providers)) {
+                await this.initializeProvider(providerName, providerConfig);
+            }
+        }
+        if (this.config.mode !== "distributed" && this.config.localUnsafe) {
+            this.emitLocalStateWarning();
+        }
+        this.started = true;
+    }
+    ensureStarted() {
+        if (!this.started) {
+            throw new Error("Meridian SDK must be initialized before use. " +
+                "Call 'await Meridian.create(config)' and await the result before using any methods.");
+        }
+    }
+}
+export * from "./core/types.js";
+export * from "./observability/index.js";
+export * from "./strategies/index.js";
+export * from "./validation/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/observability/adapter.d.ts

@@ -0,0 +1,2 @@
+export type { ObservabilityAdapter, Metric, RequestContext, ResponseContext, ErrorContext, } from "../core/types.js";
+//# sourceMappingURL=adapter.d.ts.map

package/dist/observability/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/observability/adapter.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,oBAAoB,EACpB,MAAM,EACN,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC"}

package/dist/observability/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/observability/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/observability/adapter.ts"],"names":[],"mappings":""}

package/dist/observability/console.d.ts

@@ -0,0 +1,15 @@
+import type { ObservabilityAdapter, RequestContext, ResponseContext, ErrorContext, Metric } from "../core/types.js";
+export interface ConsoleObservabilityConfig {
+    pretty?: boolean;
+}
+export declare class ConsoleObservability implements ObservabilityAdapter {
+    private config;
+    constructor(config?: ConsoleObservabilityConfig);
+    logRequest(context: RequestContext): void;
+    logResponse(context: ResponseContext): void;
+    logError(context: ErrorContext): void;
+    logWarning(message: string, metadata?: Record<string, unknown>): void;
+    recordMetric(metric: Metric): void;
+    private output;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/observability/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/observability/console.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,MAAM,EACP,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,oBAAqB,YAAW,oBAAoB;IAC/D,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,GAAE,0BAA+B;IAInD,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAczC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAgB3C,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAqBrC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYrE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAalC,OAAO,CAAC,MAAM;CAOf"}

package/dist/observability/console.js

@@ -0,0 +1,81 @@
+export class ConsoleObservability {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    logRequest(context) {
+        const log = {
+            level: "info",
+            type: "request",
+            provider: context.provider,
+            endpoint: context.endpoint,
+            method: context.method,
+            requestId: context.requestId,
+            timestamp: context.timestamp.toISOString(),
+        };
+        this.output(log);
+    }
+    logResponse(context) {
+        const log = {
+            level: "info",
+            type: "response",
+            provider: context.provider,
+            endpoint: context.endpoint,
+            method: context.method,
+            requestId: context.requestId,
+            statusCode: context.statusCode,
+            duration: context.duration,
+            timestamp: context.timestamp.toISOString(),
+        };
+        this.output(log);
+    }
+    logError(context) {
+        const log = {
+            level: "error",
+            type: "error",
+            provider: context.provider,
+            endpoint: context.endpoint,
+            method: context.method,
+            requestId: context.requestId,
+            error: {
+                category: context.error.category,
+                message: context.error.message,
+                retryable: context.error.retryable,
+                retryAfter: context.error.retryAfter?.toISOString(),
+            },
+            duration: context.duration,
+            timestamp: context.timestamp.toISOString(),
+        };
+        this.output(log);
+    }
+    logWarning(message, metadata) {
+        const log = {
+            level: "warn",
+            type: "warning",
+            message,
+            metadata,
+            timestamp: new Date().toISOString(),
+        };
+        this.output(log);
+    }
+    recordMetric(metric) {
+        const log = {
+            level: "info",
+            type: "metric",
+            name: metric.name,
+            value: metric.value,
+            tags: metric.tags,
+            timestamp: metric.timestamp.toISOString(),
+        };
+        this.output(log);
+    }
+    output(data) {
+        if (this.config.pretty) {
+            console.log(JSON.stringify(data, null, 2));
+        }
+        else {
+            console.log(JSON.stringify(data));
+        }
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/observability/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/observability/console.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAA6B;IAE3C,YAAY,SAAqC,EAAE;QACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,UAAU,CAAC,OAAuB;QAChC,MAAM,GAAG,GAAG;YACV,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,OAAwB;QAClC,MAAM,GAAG,GAAG;YACV,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,OAAqB;QAC5B,MAAM,GAAG,GAAG;YACV,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE;gBACL,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;gBAChC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO;gBAC9B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS;gBAClC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE;aACpD;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,OAAe,EAAE,QAAkC;QAC5D,MAAM,GAAG,GAAG;YACV,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,SAAS;YACf,OAAO;YACP,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,MAAM,GAAG,GAAG;YACV,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;SAC1C,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,IAAa;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/observability/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./adapter.js";
+export * from "./console.js";
+export * from "./noop.js";
+export * from "./otel.js";
+export * from "./prometheus.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,6 @@
+export * from "./adapter.js";
+export * from "./console.js";
+export * from "./noop.js";
+export * from "./otel.js";
+export * from "./prometheus.js";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}