meridianjs 0.1.0

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

@@ -0,0 +1,11 @@
+import type { PaginationStrategy, RawResponse, RequestOptions } from "../../core/types.js";
+export declare class AnthropicPaginationStrategy 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/anthropic/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/anthropic/pagination.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG3F,qBAAa,2BAA4B,YAAW,kBAAkB;IACpE,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAYnD,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/anthropic/pagination.js

@@ -0,0 +1,36 @@
+export class AnthropicPaginationStrategy {
+    extractCursor(response) {
+        // Anthropic list APIs (batches, models, etc.) return:
+        // { has_more: boolean, last_id: string | null, data: [] }
+        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_id: cursor,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/providers/anthropic/pagination.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,2BAA2B;IACtC,aAAa,CAAC,QAAqB;QACjC,sDAAsD;QACtD,0DAA0D;QAC1D,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,QAAQ,EAAE,MAAM;iBACjB;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+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 GitHubAdapter 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 getHeaderValue;
+    private extractRetryAfter;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/github/adapter.ts"],"names":[],"mappings":"AAEA,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;AAkBnF,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAiC;IAKtD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAmD/C,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;IAuBnD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa;IAgDvC,OAAO,CAAC,cAAc;IAoLhB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAoB1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAqBhD,kBAAkB,IAAI,kBAAkB;IAKxC,oBAAoB,IAAI,iBAAiB;IAyBzC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,iBAAiB;CA8B1B"}

package/dist/providers/github/adapter.js

@@ -0,0 +1,232 @@
+import { MeridianError, IdempotencyLevel, SDK_VERSION } from "../../core/types.js";
+import { GitHubPaginationStrategy } from "./pagination.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { parseRetryAfter, parseRateLimitHeaders } from "../../core/header-parser.js";
+export class GitHubAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://api.github.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));
+            }
+        }
+        const headers = {
+            "Accept": "application/vnd.github.v3+json",
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        if (authToken.token) {
+            headers["Authorization"] = `Bearer ${authToken.token}`;
+        }
+        if (options.idempotencyKey) {
+            headers["X-Idempotency-Key"] = options.idempotencyKey;
+        }
+        let body;
+        const method = options.method ?? "GET";
+        if (options.body && method !== "GET" && method !== "HEAD") {
+            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, "github", rateLimitInfo, paginationInfo, [], "1.0.0");
+    }
+    parseError(raw) {
+        if (raw instanceof Error) {
+            const errorMessage = raw.message.toLowerCase();
+            if (errorMessage.includes("fetch") ||
+                errorMessage.includes("network") ||
+                errorMessage.includes("econnreset") ||
+                errorMessage.includes("etimedout") ||
+                errorMessage.includes("enotfound") ||
+                errorMessage.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 = error.status;
+        const body = error.body;
+        const headers = error.headers;
+        if (status === 401) {
+            return this.createMeridianError("auth", false, "Authentication failed. Check your token is valid and not expired.", {
+                githubMessage: body?.message,
+                documentationUrl: body?.documentation_url,
+            }, undefined, 401);
+        }
+        if (status === 403) {
+            const rateLimitRemaining = this.getHeaderValue(headers, "X-RateLimit-Remaining");
+            if (rateLimitRemaining === "0") {
+                const retryAfter = this.extractRetryAfter(headers);
+                return this.createMeridianError("rate_limit", true, "Rate limit exceeded. Please wait before retrying.", {
+                    githubMessage: body?.message,
+                    retryAfter: retryAfter?.toISOString(),
+                }, retryAfter, 403);
+            }
+            return this.createMeridianError("auth", false, "Permission denied. Check your token has the required scopes.", {
+                githubMessage: body?.message,
+                documentationUrl: body?.documentation_url,
+            }, undefined, 403);
+        }
+        if (status === 404) {
+            const message = body?.message?.toLowerCase() ?? "";
+            if (message.includes("not found") ||
+                message.includes("does not exist") ||
+                message.includes("not accessible")) {
+                return this.createMeridianError("validation", false, "Resource not found or not accessible.", {
+                    githubMessage: body?.message,
+                    note: "GitHub returns 404 for both missing resources and inaccessible resources",
+                }, undefined, 404);
+            }
+            return this.createMeridianError("validation", false, "Resource not found.", {
+                githubMessage: body?.message,
+            }, undefined, 404);
+        }
+        if (status === 422) {
+            const fieldErrors = body?.errors
+                ?.map((e) => `${e.field ?? "unknown"}: ${e.message ?? e.code ?? "validation error"}`)
+                .join("; ");
+            return this.createMeridianError("validation", false, fieldErrors
+                ? `Validation failed: ${fieldErrors}`
+                : body?.message ?? "Request validation failed.", {
+                githubMessage: body?.message,
+                fieldErrors: body?.errors,
+            }, undefined, 422);
+        }
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            return this.createMeridianError("rate_limit", true, "Rate limit exceeded. Please wait before retrying.", {
+                githubMessage: body?.message,
+                retryAfter: retryAfter?.toISOString(),
+            }, retryAfter, 429);
+        }
+        if (status >= 500) {
+            return this.createMeridianError("provider", true, `GitHub API returned error ${status}. This may be temporary.`, {
+                status,
+                githubMessage: body?.message,
+            }, undefined, status);
+        }
+        if (status >= 400) {
+            return this.createMeridianError("validation", false, body?.message ?? `Request failed with status ${status}.`, {
+                status,
+                githubMessage: body?.message,
+            }, undefined, status);
+        }
+        return this.createMeridianError("provider", false, `Unexpected response status ${status}.`, {
+            status,
+            githubMessage: body?.message,
+        }, undefined, status);
+    }
+    async authStrategy(config) {
+        if (!config.token) {
+            throw this.createMeridianError("auth", false, "GitHub authentication requires a token.", {}, undefined, 401);
+        }
+        return {
+            token: config.token,
+        };
+    }
+    rateLimitPolicy(headers) {
+        const parsed = parseRateLimitHeaders(headers);
+        if (parsed) {
+            return {
+                limit: parsed.limit,
+                remaining: parsed.remaining,
+                reset: parsed.reset,
+            };
+        }
+        return {
+            limit: 5000,
+            remaining: 5000,
+            reset: new Date(Date.now() + 60 * 60 * 1000),
+        };
+    }
+    paginationStrategy() {
+        return new GitHubPaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return {
+            defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: new Map([
+                [
+                    "POST /repos/:owner/:repo/pulls",
+                    IdempotencyLevel.CONDITIONAL,
+                ],
+                [
+                    "POST /repos/:owner/:repo/issues",
+                    IdempotencyLevel.CONDITIONAL,
+                ],
+                ["GET /search/code", IdempotencyLevel.UNSAFE],
+                ["GET /search/repositories", IdempotencyLevel.UNSAFE],
+                ["GET /search/users", IdempotencyLevel.UNSAFE],
+                ["DELETE /repos/:owner/:repo", IdempotencyLevel.IDEMPOTENT],
+                ["DELETE /repos/:owner/:repo/issues/:issue_number", IdempotencyLevel.IDEMPOTENT],
+            ]),
+        };
+    }
+    createMeridianError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "github", retryable, "", metadata, retryAfter, status);
+    }
+    getHeaderValue(headers, name) {
+        if (!headers) {
+            return null;
+        }
+        if (headers instanceof Headers) {
+            return headers.get(name);
+        }
+        const lowerName = name.toLowerCase();
+        for (const [key, value] of Object.entries(headers)) {
+            if (key.toLowerCase() === lowerName) {
+                return value;
+            }
+        }
+        return null;
+    }
+    extractRetryAfter(headers) {
+        if (!headers) {
+            return undefined;
+        }
+        const retryAfterValue = this.getHeaderValue(headers, "Retry-After");
+        const parsed = parseRetryAfter(retryAfterValue);
+        if (parsed) {
+            return parsed;
+        }
+        const resetValue = this.getHeaderValue(headers, "X-RateLimit-Reset");
+        if (resetValue) {
+            const timestamp = parseInt(resetValue.trim(), 10);
+            if (!isNaN(timestamp) && timestamp > 0) {
+                const now = Math.floor(Date.now() / 1000);
+                if (timestamp >= now - 60 && timestamp < now + 86400 * 365) {
+                    return new Date(timestamp * 1000);
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=adapter.js.map

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

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

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

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

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

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

package/dist/providers/github/index.js

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

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

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

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

@@ -0,0 +1,11 @@
+import type { PaginationStrategy, RawResponse, RequestOptions } from "../../core/types.js";
+export declare class GitHubPaginationStrategy 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/github/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/github/pagination.ts"],"names":[],"mappings":"AAEA,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;IAyBnD,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAelD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAUvC,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/github/pagination.js

@@ -0,0 +1,53 @@
+import { parseLinkHeader, findLinkByRel } from "../../core/header-parser.js";
+export class GitHubPaginationStrategy {
+    extractCursor(response) {
+        const linkHeader = response.headers.get("Link");
+        if (!linkHeader) {
+            return null;
+        }
+        const links = parseLinkHeader(linkHeader);
+        const nextLink = findLinkByRel(links, "next");
+        if (!nextLink) {
+            return null;
+        }
+        try {
+            const url = new URL(nextLink.url);
+            const page = url.searchParams.get("page");
+            return page;
+        }
+        catch {
+            return null;
+        }
+    }
+    extractTotal(response) {
+        const totalHeader = response.headers.get("X-Total-Count");
+        if (totalHeader) {
+            const parsed = parseInt(totalHeader, 10);
+            if (!isNaN(parsed) && parsed >= 0 && parsed <= Number.MAX_SAFE_INTEGER) {
+                return parsed;
+            }
+        }
+        return null;
+    }
+    hasNext(response) {
+        const linkHeader = response.headers.get("Link");
+        if (!linkHeader) {
+            return false;
+        }
+        const links = parseLinkHeader(linkHeader);
+        return findLinkByRel(links, "next") !== null;
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        return {
+            endpoint,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    page: cursor,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/providers/github/pagination.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE7E,MAAM,OAAO,wBAAwB;IACnC,aAAa,CAAC,QAAqB;QACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YAEP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,YAAY,CAAC,QAAqB;QAGhC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YAEzC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACvE,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,QAAqB;QAC3B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAC/C,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,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/openai/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 OpenAIAdapter 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/openai/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/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;AAiCnF,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAiC;IAItD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IA2C/C,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;IAOnD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa;IAsCvC,OAAO,CAAC,cAAc;IAqGhB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAc1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IA6BhD,kBAAkB,IAAI,kBAAkB;IAIxC,oBAAoB,IAAI,iBAAiB;IAczC,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/providers/openai/adapter.js

@@ -0,0 +1,178 @@
+import { MeridianError, IdempotencyLevel, SDK_VERSION } from "../../core/types.js";
+import { OpenAIPaginationStrategy } from "./pagination.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { parseRetryAfter } from "../../core/header-parser.js";
+// OpenAI encodes rate limit reset as a duration string: "6m0s", "1s", "2h30m", "500ms"
+function parseOpenAIDuration(duration) {
+    let totalMs = 0;
+    const hoursMatch = /(\d+)h/.exec(duration);
+    const minutesMatch = /(\d+)m(?!s)/.exec(duration);
+    const secondsMatch = /(\d+)s/.exec(duration);
+    const msMatch = /(\d+)ms/.exec(duration);
+    if (hoursMatch?.[1] !== undefined)
+        totalMs += parseInt(hoursMatch[1], 10) * 3_600_000;
+    if (minutesMatch?.[1] !== undefined)
+        totalMs += parseInt(minutesMatch[1], 10) * 60_000;
+    if (secondsMatch?.[1] !== undefined)
+        totalMs += parseInt(secondsMatch[1], 10) * 1_000;
+    if (msMatch?.[1] !== undefined)
+        totalMs += parseInt(msMatch[1], 10);
+    return totalMs;
+}
+export class OpenAIAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://api.openai.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));
+            }
+        }
+        const headers = {
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        if (authToken.token) {
+            headers["Authorization"] = `Bearer ${authToken.token}`;
+        }
+        if (options.idempotencyKey) {
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        }
+        let body;
+        const method = options.method ?? "GET";
+        if (options.body && method !== "GET" && method !== "HEAD") {
+            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, "openai", 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 errorCode = errorBody?.error?.code;
+        if (status === 401) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Authentication failed. Check your OpenAI API key.", { openaiError: errorBody?.error }, undefined, 401);
+        }
+        if (status === 403) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Permission denied. Your API key lacks the required permissions.", { openaiError: errorBody?.error }, undefined, 403);
+        }
+        if (status === 404) {
+            return this.createMeridianError("validation", false, errorMessage ?? "Resource not found.", { openaiError: errorBody?.error }, undefined, 404);
+        }
+        if (status === 422) {
+            return this.createMeridianError("validation", false, errorMessage ?? "Request validation failed.", { openaiError: errorBody?.error }, undefined, 422);
+        }
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            // insufficient_quota means billing limit hit — retrying won't help
+            const isQuotaExhausted = errorCode === "insufficient_quota";
+            return this.createMeridianError("rate_limit", !isQuotaExhausted, errorMessage ?? "Rate limit exceeded. Please wait before retrying.", { openaiError: errorBody?.error, retryAfter: retryAfter?.toISOString() }, retryAfter, 429);
+        }
+        if (status >= 500) {
+            return this.createMeridianError("provider", true, errorMessage ?? `OpenAI API returned error ${status}. This may be temporary.`, { status, openaiError: errorBody?.error }, undefined, status);
+        }
+        if (status >= 400) {
+            return this.createMeridianError("validation", false, errorMessage ?? `Request failed with status ${status}.`, { status, openaiError: errorBody?.error }, undefined, status);
+        }
+        return this.createMeridianError("provider", false, `Unexpected response status ${status}.`, { status }, undefined, status);
+    }
+    async authStrategy(config) {
+        if (!config.token) {
+            throw this.createMeridianError("auth", false, "OpenAI authentication requires an API key. Set auth.token to your OpenAI API key.", {}, undefined, 401);
+        }
+        return { token: config.token };
+    }
+    rateLimitPolicy(headers) {
+        const limitStr = headers.get("x-ratelimit-limit-requests");
+        const remainingStr = headers.get("x-ratelimit-remaining-requests");
+        const resetStr = headers.get("x-ratelimit-reset-requests");
+        if (limitStr && remainingStr) {
+            const limit = parseInt(limitStr, 10);
+            const remaining = parseInt(remainingStr, 10);
+            let reset = new Date(Date.now() + 60 * 1000);
+            if (resetStr) {
+                const durationMs = parseOpenAIDuration(resetStr);
+                if (durationMs > 0) {
+                    reset = new Date(Date.now() + durationMs);
+                }
+            }
+            if (!isNaN(limit) && !isNaN(remaining)) {
+                return { limit, remaining, reset };
+            }
+        }
+        return {
+            limit: 3_500,
+            remaining: 3_500,
+            reset: new Date(Date.now() + 60 * 1000),
+        };
+    }
+    paginationStrategy() {
+        return new OpenAIPaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return {
+            defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: new Map([
+                ["POST /v1/chat/completions", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/completions", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/embeddings", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/images/generations", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/audio/transcriptions", IdempotencyLevel.CONDITIONAL],
+                ["POST /v1/audio/speech", IdempotencyLevel.CONDITIONAL],
+            ]),
+        };
+    }
+    createMeridianError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "openai", 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/openai/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/openai/adapter.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAa9D,uFAAuF;AACvF,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;IACtF,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IACvF,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IACtF,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpE,OAAO,OAAO,CAAC;AACjB,CAAC;AAGD,MAAM,OAAO,aAAa;IAChB,OAAO,CAAS;IAExB,YAAY,UAAkB,wBAAwB;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,KAAmB;QAC9B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QACxD,MAAM,gBAAgB,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QAEjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,gBAAgB,WAAW,EAAE;YAC3C,GAAG,OAAO,CAAC,OAAO;SACnB,CAAC;QAEF,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,SAAS,CAAC,KAAK,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;QACtD,CAAC;QAED,IAAI,IAAwB,CAAC;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1D,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,MAAM,KAAK,GAAiB;YAC1B,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;YACnB,MAAM;YACN,OAAO;SACR,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,aAAa,CAAC,GAAgB;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACrD,MAAM,cAAc,GAAG,kBAAkB,CAAC,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACzF,OAAO,kBAAkB,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACjG,CAAC;IAED,UAAU,CAAC,GAAY;QACrB,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACtC,IACE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACvB,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC1B,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACzB,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACzB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EACvB,CAAC;gBACD,OAAO,IAAI,CAAC,mBAAmB,CAC7B,SAAS,EACT,IAAI,EACJ,8DAA8D,EAC9D,EAAE,aAAa,EAAE,GAAG,CAAC,OAAO,EAAE,CAC/B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,IACE,OAAO,GAAG,KAAK,QAAQ;YACvB,GAAG,KAAK,IAAI;YACZ,QAAQ,IAAI,GAAG;YACf,OAAQ,GAA+B,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAC9D,CAAC;YACD,MAAM,SAAS,GAAG,GAKjB,CAAC;YACF,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,8BAA8B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9F,CAAC;IAEO,cAAc,CAAC,KAKtB;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QACxC,MAAM,SAAS,GAAG,IAAmC,CAAC;QACtD,MAAM,YAAY,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC;QAC/C,MAAM,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC;QAEzC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,MAAM,EACN,KAAK,EACL,YAAY,IAAI,mDAAmD,EACnE,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACjC,SAAS,EACT,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,MAAM,EACN,KAAK,EACL,YAAY,IAAI,iEAAiE,EACjF,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACjC,SAAS,EACT,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,YAAY,EACZ,KAAK,EACL,YAAY,IAAI,qBAAqB,EACrC,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACjC,SAAS,EACT,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,YAAY,EACZ,KAAK,EACL,YAAY,IAAI,4BAA4B,EAC5C,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACjC,SAAS,EACT,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACnD,mEAAmE;YACnE,MAAM,gBAAgB,GAAG,SAAS,KAAK,oBAAoB,CAAC;YAC5D,OAAO,IAAI,CAAC,mBAAmB,CAC7B,YAAY,EACZ,CAAC,gBAAgB,EACjB,YAAY,IAAI,mDAAmD,EACnE,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EACxE,UAAU,EACV,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,UAAU,EACV,IAAI,EACJ,YAAY,IAAI,6BAA6B,MAAM,0BAA0B,EAC7E,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACzC,SAAS,EACT,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,mBAAmB,CAC7B,YAAY,EACZ,KAAK,EACL,YAAY,IAAI,8BAA8B,MAAM,GAAG,EACvD,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,EACzC,SAAS,EACT,MAAM,CACP,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAC7B,UAAU,EACV,KAAK,EACL,8BAA8B,MAAM,GAAG,EACvC,EAAE,MAAM,EAAE,EACV,SAAS,EACT,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAkB;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,mBAAmB,CAC5B,MAAM,EACN,KAAK,EACL,mFAAmF,EACnF,EAAE,EACF,SAAS,EACT,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAE3D,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAE7C,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC7C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;gBACjD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACnB,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;SACxC,CAAC;IACJ,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED,oBAAoB;QAClB,OAAO;YACL,qBAAqB,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;YAC1D,kBAAkB,EAAE,IAAI,GAAG,CAAC;gBAC1B,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,WAAW,CAAC;gBAC3D,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,WAAW,CAAC;gBACtD,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,WAAW,CAAC;gBACrD,CAAC,6BAA6B,EAAE,gBAAgB,CAAC,WAAW,CAAC;gBAC7D,CAAC,+BAA+B,EAAE,gBAAgB,CAAC,WAAW,CAAC;gBAC/D,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,WAAW,CAAC;aACxD,CAAC;SACH,CAAC;IACJ,CAAC;IAEO,mBAAmB,CACzB,QAAmC,EACnC,SAAkB,EAClB,OAAe,EACf,QAAkC,EAClC,UAAiB,EACjB,MAAe;QAEf,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACrG,CAAC;IAEO,iBAAiB,CACvB,OAAqD;QAErD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,MAAM,KAAK,GAAG,OAAO,YAAY,OAAO;YACtC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YAC5B,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QAE5F,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IAC7C,CAAC;CACF"}

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

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