meridianjs 0.1.0

package/dist/providers/openai/index.d.ts.map

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

package/dist/providers/openai/index.js

@@ -0,0 +1,3 @@
+export * from "./adapter.js";
+export * from "./pagination.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/openai/index.js.map

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

package/dist/providers/openai/pagination.d.ts

@@ -0,0 +1,11 @@
+import type { PaginationStrategy, RawResponse, RequestOptions } from "../../core/types.js";
+export declare class OpenAIPaginationStrategy implements PaginationStrategy {
+    extractCursor(response: RawResponse): string | null;
+    extractTotal(_response: RawResponse): number | null;
+    hasNext(response: RawResponse): boolean;
+    buildNextRequest(endpoint: string, options: RequestOptions, cursor: string): {
+        endpoint: string;
+        options: RequestOptions;
+    };
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/providers/openai/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/pagination.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG3F,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAWnD,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAInD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAQvC,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE;CAYjD"}

package/dist/providers/openai/pagination.js

@@ -0,0 +1,35 @@
+export class OpenAIPaginationStrategy {
+    extractCursor(response) {
+        // OpenAI list APIs return: { object: "list", data: [], has_more: boolean, last_id: string | null }
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            if (body["has_more"] === true && typeof body["last_id"] === "string") {
+                return body["last_id"];
+            }
+        }
+        return null;
+    }
+    extractTotal(_response) {
+        return null;
+    }
+    hasNext(response) {
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            return body["has_more"] === true;
+        }
+        return false;
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        return {
+            endpoint,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    after: cursor,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/providers/openai/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/providers/openai/pagination.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,wBAAwB;IACnC,aAAa,CAAC,QAAqB;QACjC,mGAAmG;QACnG,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YACtD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACrE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,SAAsB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,QAAqB;QAC3B,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YACtD,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CACd,QAAgB,EAChB,OAAuB,EACvB,MAAc;QAEd,OAAO;YACL,QAAQ;YACR,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,KAAK,EAAE;oBACL,GAAG,OAAO,CAAC,KAAK;oBAChB,KAAK,EAAE,MAAM;iBACd;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/stripe/adapter.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderAdapter, AuthConfig, AuthToken, RawResponse, NormalizedResponse, RateLimitInfo, PaginationStrategy, IdempotencyConfig, AdapterInput, BuiltRequest } from "../../core/types.js";
+import { MeridianError } from "../../core/types.js";
+export declare class StripeAdapter implements ProviderAdapter {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    buildRequest(input: AdapterInput): BuiltRequest;
+    parseResponse(raw: RawResponse): NormalizedResponse;
+    parseError(raw: unknown): MeridianError;
+    private parseHttpError;
+    authStrategy(config: AuthConfig): Promise<AuthToken>;
+    rateLimitPolicy(headers: Headers): RateLimitInfo;
+    paginationStrategy(): PaginationStrategy;
+    getIdempotencyConfig(): IdempotencyConfig;
+    private createMeridianError;
+    private extractRetryAfter;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/stripe/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/stripe/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAiC,MAAM,qBAAqB,CAAC;AAiBnF,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAiC;IAItD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IA+C/C,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;IAOnD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa;IAsCvC,OAAO,CAAC,cAAc;IA6HhB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAe1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAyBhD,kBAAkB,IAAI,kBAAkB;IAIxC,oBAAoB,IAAI,iBAAiB;IAoBzC,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/providers/stripe/adapter.js

@@ -0,0 +1,177 @@
+import { MeridianError, IdempotencyLevel, SDK_VERSION } from "../../core/types.js";
+import { StripePaginationStrategy } from "./pagination.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { parseRetryAfter } from "../../core/header-parser.js";
+export class StripeAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://api.stripe.com") {
+        this.baseUrl = baseUrl;
+    }
+    buildRequest(input) {
+        const { endpoint, options, authToken, baseUrl } = input;
+        const effectiveBaseUrl = baseUrl ?? this.baseUrl;
+        const url = new URL(endpoint, effectiveBaseUrl);
+        if (options.query) {
+            for (const [key, value] of Object.entries(options.query)) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        // Stripe uses HTTP Basic auth: API key as username, empty password
+        const credentials = Buffer.from(`${authToken.token}:`).toString("base64");
+        const headers = {
+            "Authorization": `Basic ${credentials}`,
+            "Stripe-Version": "2024-11-20.acacia",
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        // Stripe has native idempotency key support on all write operations
+        if (options.idempotencyKey) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        let body;
+        const method = options.method ?? "GET";
+        if (options.body && method !== "GET" && method !== "HEAD") {
+            // Stripe accepts application/x-www-form-urlencoded for most endpoints,
+            // but JSON is supported with the header set
+            body = JSON.stringify(options.body);
+            headers["Content-Type"] = "application/json";
+        }
+        const built = {
+            url: url.toString(),
+            method,
+            headers,
+        };
+        if (body !== undefined) {
+            built.body = body;
+        }
+        return built;
+    }
+    parseResponse(raw) {
+        const rateLimitInfo = this.rateLimitPolicy(raw.headers);
+        const paginationStrategy = this.paginationStrategy();
+        const paginationInfo = ResponseNormalizer.extractPaginationInfo(raw, paginationStrategy);
+        return ResponseNormalizer.normalize(raw, "stripe", rateLimitInfo, paginationInfo, [], "1.0.0");
+    }
+    parseError(raw) {
+        if (raw instanceof Error) {
+            const msg = raw.message.toLowerCase();
+            if (msg.includes("fetch") ||
+                msg.includes("network") ||
+                msg.includes("econnreset") ||
+                msg.includes("etimedout") ||
+                msg.includes("enotfound") ||
+                msg.includes("timeout")) {
+                return this.createMeridianError("network", true, "Network request failed. Check your connection and try again.", { originalError: raw.message });
+            }
+        }
+        if (typeof raw === "object" &&
+            raw !== null &&
+            "status" in raw &&
+            typeof raw["status"] === "number") {
+            const httpError = raw;
+            return this.parseHttpError(httpError);
+        }
+        return this.createMeridianError("provider", false, "An unexpected error occurred", { raw });
+    }
+    parseHttpError(error) {
+        const { status, body, headers } = error;
+        const errorBody = body;
+        const errorMessage = errorBody?.error?.message;
+        const errorType = errorBody?.error?.type;
+        const declineCode = errorBody?.error?.decline_code;
+        if (status === 401) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Authentication failed. Check your Stripe API key.", { stripeError: errorBody?.error }, undefined, 401);
+        }
+        if (status === 402) {
+            // Card errors — payment declined
+            return this.createMeridianError("validation", false, errorMessage ?? "Payment was declined.", { stripeError: errorBody?.error, declineCode }, undefined, 402);
+        }
+        if (status === 403) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Permission denied. Your API key lacks the required permissions.", { stripeError: errorBody?.error }, undefined, 403);
+        }
+        if (status === 404) {
+            return this.createMeridianError("validation", false, errorMessage ?? "Resource not found.", { stripeError: errorBody?.error }, undefined, 404);
+        }
+        if (status === 409) {
+            // Idempotency key was reused with different request parameters
+            return this.createMeridianError("validation", false, errorMessage ?? "Idempotency key reused with different parameters.", { stripeError: errorBody?.error, errorType }, undefined, 409);
+        }
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            return this.createMeridianError("rate_limit", true, errorMessage ?? "Rate limit exceeded. Please wait before retrying.", { stripeError: errorBody?.error, retryAfter: retryAfter?.toISOString() }, retryAfter, 429);
+        }
+        if (status === 422) {
+            return this.createMeridianError("validation", false, errorMessage ?? "Request validation failed.", { stripeError: errorBody?.error }, undefined, 422);
+        }
+        // 500, 502, 503, 504 — Stripe infrastructure errors, safe to retry
+        if (status >= 500) {
+            return this.createMeridianError("provider", true, errorMessage ?? `Stripe API returned error ${status}. This may be temporary.`, { status, stripeError: errorBody?.error }, undefined, status);
+        }
+        if (status >= 400) {
+            return this.createMeridianError("validation", false, errorMessage ?? `Request failed with status ${status}.`, { status, stripeError: errorBody?.error }, undefined, status);
+        }
+        return this.createMeridianError("provider", false, `Unexpected response status ${status}.`, { status }, undefined, status);
+    }
+    async authStrategy(config) {
+        const key = config.apiKey ?? config.token;
+        if (!key) {
+            throw this.createMeridianError("auth", false, "Stripe authentication requires an API key. Set auth.apiKey or auth.token to your Stripe secret key.", {}, undefined, 401);
+        }
+        return { token: key };
+    }
+    rateLimitPolicy(headers) {
+        // Stripe exposes these headers when rate limit info is available
+        const limitStr = headers.get("Stripe-Ratelimit-Limit");
+        const remainingStr = headers.get("Stripe-Ratelimit-Remaining");
+        if (limitStr && remainingStr) {
+            const limit = parseInt(limitStr, 10);
+            const remaining = parseInt(remainingStr, 10);
+            if (!isNaN(limit) && !isNaN(remaining)) {
+                return {
+                    limit,
+                    remaining,
+                    reset: new Date(Date.now() + 1000), // Stripe resets per second
+                };
+            }
+        }
+        return {
+            limit: 100,
+            remaining: 100,
+            reset: new Date(Date.now() + 1000),
+        };
+    }
+    paginationStrategy() {
+        return new StripePaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return {
+            defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: new Map([
+                // All Stripe write operations support idempotency keys
+                ["POST /v1/charges", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/payment_intents", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/payment_intents/:id/confirm", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/customers", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/subscriptions", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/invoices", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/refunds", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/payouts", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/transfers", IdempotencyLevel.CONDITIONAL],
+                ["DELETE /v1/customers/:id", IdempotencyLevel.IDEMPOTENT],
+                ["DELETE /v1/subscriptions/:id", IdempotencyLevel.IDEMPOTENT],
+            ]),
+        };
+    }
+    createMeridianError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "stripe", retryable, "", metadata, retryAfter, status);
+    }
+    extractRetryAfter(headers) {
+        if (!headers)
+            return undefined;
+        const value = headers instanceof Headers
+            ? headers.get("retry-after")
+            : (Object.entries(headers).find(([k]) => k.toLowerCase() === "retry-after")?.[1] ?? null);
+        return parseRetryAfter(value) ?? undefined;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/providers/stripe/adapter.js.map

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

package/dist/providers/stripe/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./adapter.js";
+export * from "./pagination.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/stripe/index.d.ts.map

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

package/dist/providers/stripe/index.js

@@ -0,0 +1,3 @@
+export * from "./adapter.js";
+export * from "./pagination.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/stripe/index.js.map

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

package/dist/providers/stripe/pagination.d.ts

@@ -0,0 +1,11 @@
+import type { PaginationStrategy, RawResponse, RequestOptions } from "../../core/types.js";
+export declare class StripePaginationStrategy implements PaginationStrategy {
+    extractCursor(response: RawResponse): string | null;
+    extractTotal(_response: RawResponse): number | null;
+    hasNext(response: RawResponse): boolean;
+    buildNextRequest(endpoint: string, options: RequestOptions, cursor: string): {
+        endpoint: string;
+        options: RequestOptions;
+    };
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/providers/stripe/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/stripe/pagination.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG3F,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAsBnD,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAInD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAQvC,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE;CAYjD"}

package/dist/providers/stripe/pagination.js

@@ -0,0 +1,44 @@
+export class StripePaginationStrategy {
+    extractCursor(response) {
+        // Stripe list responses: { object: "list", data: [...], has_more: boolean, url: string }
+        // Cursor for next page = id of the last item in data
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            if (body["has_more"] === true && Array.isArray(body["data"])) {
+                const data = body["data"];
+                const lastItem = data[data.length - 1];
+                if (lastItem !== undefined &&
+                    typeof lastItem === "object" &&
+                    lastItem !== null &&
+                    "id" in lastItem &&
+                    typeof lastItem["id"] === "string") {
+                    return lastItem["id"];
+                }
+            }
+        }
+        return null;
+    }
+    extractTotal(_response) {
+        return null;
+    }
+    hasNext(response) {
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            return body["has_more"] === true;
+        }
+        return false;
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        return {
+            endpoint,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    starting_after: cursor,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/providers/stripe/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/providers/stripe/pagination.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,wBAAwB;IACnC,aAAa,CAAC,QAAqB;QACjC,yFAAyF;QACzF,qDAAqD;QACrD,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YACtD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAc,CAAC;gBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACvC,IACE,QAAQ,KAAK,SAAS;oBACtB,OAAO,QAAQ,KAAK,QAAQ;oBAC5B,QAAQ,KAAK,IAAI;oBACjB,IAAI,IAAI,QAAQ;oBAChB,OAAQ,QAAoC,CAAC,IAAI,CAAC,KAAK,QAAQ,EAC/D,CAAC;oBACD,OAAQ,QAAoC,CAAC,IAAI,CAAW,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,SAAsB;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,QAAqB;QAC3B,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAA+B,CAAC;YACtD,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CACd,QAAgB,EAChB,OAAuB,EACvB,MAAc;QAEd,OAAO;YACL,QAAQ;YACR,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,KAAK,EAAE;oBACL,GAAG,OAAO,CAAC,KAAK;oBAChB,cAAc,EAAE,MAAM;iBACvB;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/public.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Public API surface for Meridian SDK.
+ *
+ * This is the ONLY file consumers should import from.
+ * All other modules are internal implementation details.
+ */
+export { Meridian } from "./index.js";
+export type { MeridianConfig, ProviderConfig, NormalizedResponse, ResponseMeta, PaginationInfo, RateLimitInfo, RequestOptions, CircuitBreakerStatus, } from "./core/types.js";
+export { MeridianError } from "./core/types.js";
+export type { MeridianErrorCategory, MeridianErrorCode } from "./core/types.js";
+export type { AuthConfig, AuthToken } from "./core/types.js";
+export type { ProviderAdapter } from "./core/types.js";
+export type { ProviderClient } from "./index.js";
+export type { ObservabilityAdapter, RequestContext, ResponseContext, ErrorContext, Metric, } from "./core/types.js";
+export { ConsoleObservability } from "./observability/console.js";
+export { NoOpObservability } from "./observability/noop.js";
+export type { StateStorage } from "./core/types.js";
+export { IdempotencyLevel } from "./core/types.js";
+export type { IdempotencyConfig } from "./core/types.js";
+export { CircuitState } from "./core/types.js";
+export type { Schema, SchemaStorage, SchemaMetadata, SchemaDrift, } from "./core/types.js";
+export type { PaginationStrategy } from "./core/types.js";
+export { AnthropicAdapter } from "./providers/anthropic/adapter.js";
+export { OpenAIAdapter } from "./providers/openai/adapter.js";
+export { StripeAdapter } from "./providers/stripe/adapter.js";
+export { GitHubAdapter } from "./providers/github/adapter.js";
+//# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,YAAY,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGhF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG7D,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,MAAM,GACP,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EACV,MAAM,EACN,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/public.js

@@ -0,0 +1,23 @@
+/**
+ * Public API surface for Meridian SDK.
+ *
+ * This is the ONLY file consumers should import from.
+ * All other modules are internal implementation details.
+ */
+// Main client
+export { Meridian } from "./index.js";
+// Error type - frozen contract
+export { MeridianError } from "./core/types.js";
+// Built-in observability adapters
+export { ConsoleObservability } from "./observability/console.js";
+export { NoOpObservability } from "./observability/noop.js";
+// Idempotency configuration
+export { IdempotencyLevel } from "./core/types.js";
+// Circuit breaker state
+export { CircuitState } from "./core/types.js";
+// Built-in provider adapters
+export { AnthropicAdapter } from "./providers/anthropic/adapter.js";
+export { OpenAIAdapter } from "./providers/openai/adapter.js";
+export { StripeAdapter } from "./providers/stripe/adapter.js";
+export { GitHubAdapter } from "./providers/github/adapter.js";
+//# sourceMappingURL=public.js.map

package/dist/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../src/public.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AActC,+BAA+B;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAqBhD,kCAAkC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,4BAA4B;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAa/C,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/strategies/circuit-breaker.d.ts

@@ -0,0 +1,22 @@
+import { type CircuitBreakerConfig, type CircuitBreakerStatus, MeridianError } from "../core/types.js";
+export declare class CircuitOpenError extends MeridianError {
+    constructor(provider: string, retryAfter?: Date);
+}
+export declare class ProviderCircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private nextAttempt;
+    private recentResults;
+    private config;
+    private provider;
+    constructor(provider: string, config?: Partial<CircuitBreakerConfig>);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    private shouldOpenCircuit;
+    private addResult;
+    getStatus(): CircuitBreakerStatus;
+    reset(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/strategies/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/strategies/circuit-breaker.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAG1B,qBAAa,gBAAiB,SAAQ,aAAa;gBACrC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI;CAoBhD;AAOD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAYlE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBlD,OAAO,CAAC,SAAS;IAiBjB,OAAO,CAAC,SAAS;IAmBjB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,SAAS;IAUjB,SAAS,IAAI,oBAAoB;IAmBjC,KAAK,IAAI,IAAI;CAOd"}

package/dist/strategies/circuit-breaker.js

@@ -0,0 +1,124 @@
+import { CircuitState, MeridianError, } from "../core/types.js";
+export class CircuitOpenError extends MeridianError {
+    constructor(provider, retryAfter) {
+        super(`Circuit breaker is OPEN for provider: ${provider}`, "provider", provider, false, "", {
+            reason: "circuit_breaker_open",
+            nextAttempt: retryAfter?.toISOString() ?? "unknown",
+        }, retryAfter);
+        this.name = "CircuitOpenError";
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CircuitOpenError);
+        }
+    }
+}
+export class ProviderCircuitBreaker {
+    state = CircuitState.CLOSED;
+    failures = 0;
+    successes = 0;
+    nextAttempt = null;
+    recentResults = [];
+    config;
+    provider;
+    constructor(provider, config = {}) {
+        this.provider = provider;
+        this.config = {
+            failureThreshold: config.failureThreshold ?? 5,
+            successThreshold: config.successThreshold ?? 2,
+            timeout: config.timeout ?? 60000,
+            volumeThreshold: config.volumeThreshold ?? 10,
+            rollingWindowMs: config.rollingWindowMs ?? 60000,
+            errorThresholdPercentage: config.errorThresholdPercentage ?? 50,
+        };
+    }
+    async execute(fn) {
+        if (this.state === CircuitState.OPEN) {
+            if (this.nextAttempt && Date.now() < this.nextAttempt.getTime()) {
+                throw new CircuitOpenError(this.provider, this.nextAttempt);
+            }
+            this.state = CircuitState.HALF_OPEN;
+            this.successes = 0;
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.addResult({ success: true, timestamp: Date.now() });
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.successes++;
+            if (this.successes >= this.config.successThreshold) {
+                this.state = CircuitState.CLOSED;
+                this.failures = 0;
+                this.nextAttempt = null;
+            }
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            this.failures = 0;
+        }
+    }
+    onFailure() {
+        this.addResult({ success: false, timestamp: Date.now() });
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.state = CircuitState.OPEN;
+            this.failures = 0;
+            this.nextAttempt = new Date(Date.now() + this.config.timeout);
+        }
+        else if (this.state === CircuitState.CLOSED) {
+            this.failures++;
+            if (this.shouldOpenCircuit()) {
+                this.state = CircuitState.OPEN;
+                this.nextAttempt = new Date(Date.now() + this.config.timeout);
+            }
+        }
+    }
+    shouldOpenCircuit() {
+        if (this.recentResults.length < this.config.volumeThreshold) {
+            return false;
+        }
+        if (this.failures >= this.config.failureThreshold) {
+            return true;
+        }
+        const windowStart = Date.now() - this.config.rollingWindowMs;
+        const recentInWindow = this.recentResults.filter((r) => r.timestamp >= windowStart);
+        if (recentInWindow.length < this.config.volumeThreshold) {
+            return false;
+        }
+        const failuresInWindow = recentInWindow.filter((r) => !r.success).length;
+        const errorRate = (failuresInWindow / recentInWindow.length) * 100;
+        return errorRate >= this.config.errorThresholdPercentage;
+    }
+    addResult(result) {
+        this.recentResults.push(result);
+        const windowStart = Date.now() - this.config.rollingWindowMs;
+        this.recentResults = this.recentResults.filter((r) => r.timestamp >= windowStart);
+    }
+    getStatus() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            lastFailure: this.recentResults
+                .filter((r) => !r.success)
+                .sort((a, b) => b.timestamp - a.timestamp)[0]?.timestamp
+                ? new Date(this.recentResults
+                    .filter((r) => !r.success)
+                    .sort((a, b) => b.timestamp - a.timestamp)[0].timestamp)
+                : null,
+            nextAttempt: this.nextAttempt,
+        };
+    }
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failures = 0;
+        this.successes = 0;
+        this.nextAttempt = null;
+        this.recentResults = [];
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/strategies/circuit-breaker.js.map

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

package/dist/strategies/idempotency.d.ts

@@ -0,0 +1,11 @@
+import { IdempotencyLevel, type IdempotencyConfig, type RequestOptions } from "../core/types.js";
+export declare class IdempotencyResolver {
+    private config;
+    private defaultLevel;
+    constructor(config: Partial<IdempotencyConfig>, defaultLevel?: IdempotencyLevel);
+    getIdempotencyLevel(method: string, endpoint: string, _options: RequestOptions): IdempotencyLevel;
+    private findOverride;
+    private matchesPattern;
+    shouldRetry(idempotencyLevel: IdempotencyLevel, _error: Error, attempt: number, maxRetries: number, hasIdempotencyKey: boolean): boolean;
+}
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/strategies/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/strategies/idempotency.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAmB;gBAGrC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,EAClC,YAAY,GAAE,gBAAwC;IAWxD,mBAAmB,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,GACvB,gBAAgB;IAiBnB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,cAAc;IAUtB,WAAW,CACT,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,KAAK,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,OAAO,GACzB,OAAO;CAkBX"}