meridianjs 0.1.2 → 0.2.0

package/dist/providers/cleartax/adapter.js

@@ -0,0 +1,135 @@
+import { parseRetryAfter } from "../../core/header-parser.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { MeridianError, SDK_VERSION } from "../../core/types.js";
+import { CleartaxPaginationStrategy } from "./pagination.js";
+export class CleartaxAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://api.cleartax.in") {
+        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 = {
+            "x-cleartax-auth-token": authToken.token,
+            "Content-Type": "application/json",
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        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);
+        }
+        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, "cleartax", 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 errorCode = errorBody?.errorCode;
+        const errorMessage = errorBody?.message ?? errorBody?.error;
+        if (status === 401) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Authentication failed. Check your ClearTax auth token.", { cleartaxCode: errorCode }, undefined, 401);
+        }
+        if (status === 403) {
+            return this.createMeridianError("auth", false, errorMessage ?? "Permission denied. Check GSTIN or owner permissions.", { cleartaxCode: errorCode }, undefined, 403);
+        }
+        if (status === 404) {
+            return this.createMeridianError("validation", false, errorMessage ?? "Resource not found.", { cleartaxCode: errorCode }, undefined, 404);
+        }
+        if (status === 400 || status === 422) {
+            return this.createMeridianError("validation", false, errorMessage ?? "GST filing validation failed. Check your request parameters.", { cleartaxCode: errorCode }, undefined, status);
+        }
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            return this.createMeridianError("rate_limit", true, errorMessage ?? "Rate limit exceeded. Please wait before retrying.", { cleartaxCode: errorCode, retryAfter: retryAfter?.toISOString() }, retryAfter, 429);
+        }
+        if (status >= 500) {
+            return this.createMeridianError("provider", true, errorMessage ?? `ClearTax API returned error ${status}. This may be temporary.`, { status, cleartaxCode: errorCode }, undefined, status);
+        }
+        if (status >= 400) {
+            return this.createMeridianError("validation", false, errorMessage ?? `Request failed with status ${status}.`, { status, cleartaxCode: errorCode }, undefined, status);
+        }
+        return this.createMeridianError("provider", false, `Unexpected response status ${status}.`, { status }, undefined, status);
+    }
+    async authStrategy(config) {
+        const token = config.token ?? config.apiKey;
+        if (!token) {
+            throw this.createMeridianError("auth", false, "ClearTax authentication requires an auth token. Set auth.token or auth.apiKey.", {}, undefined, 401);
+        }
+        return { token };
+    }
+    rateLimitPolicy(_headers) {
+        // ClearTax does not publish rate-limit headers; return conservative defaults
+        return {
+            limit: 100,
+            remaining: 100,
+            reset: new Date(Date.now() + 60_000),
+        };
+    }
+    paginationStrategy() {
+        return new CleartaxPaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return {
+            defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: new Map(),
+        };
+    }
+    createMeridianError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "cleartax", 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/cleartax/adapter.js.map

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

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

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

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

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

package/dist/providers/cleartax/index.js

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/cleartax/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3F,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAoBnD,YAAY,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAclD,OAAO,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO;IAgBvC,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/cleartax/pagination.js

@@ -0,0 +1,62 @@
+export class CleartaxPaginationStrategy {
+    extractCursor(response) {
+        // ClearTax page-based pagination: { data: [...], meta: { total, page, per_page } }
+        // OR einvoice list: { einvoices: [...], total_count: number }
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            const meta = body.meta;
+            if (meta !== undefined) {
+                const page = typeof meta.page === "number" ? meta.page : null;
+                const perPage = typeof meta.per_page === "number" ? meta.per_page : null;
+                const total = typeof meta.total === "number" ? meta.total : null;
+                if (page !== null && perPage !== null && total !== null) {
+                    if (page * perPage < total) {
+                        return String(page + 1);
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    extractTotal(response) {
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            const meta = body.meta;
+            if (meta !== undefined && typeof meta.total === "number") {
+                return meta.total;
+            }
+            if (typeof body.total_count === "number") {
+                return body.total_count;
+            }
+        }
+        return null;
+    }
+    hasNext(response) {
+        if (typeof response.body === "object" && response.body !== null) {
+            const body = response.body;
+            const meta = body.meta;
+            if (meta !== undefined) {
+                const page = typeof meta.page === "number" ? meta.page : null;
+                const perPage = typeof meta.per_page === "number" ? meta.per_page : null;
+                const total = typeof meta.total === "number" ? meta.total : null;
+                if (page !== null && perPage !== null && total !== null) {
+                    return page * perPage < total;
+                }
+            }
+        }
+        return false;
+    }
+    buildNextRequest(endpoint, options, cursor) {
+        return {
+            endpoint,
+            options: {
+                ...options,
+                query: {
+                    ...options.query,
+                    page_no: cursor,
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=pagination.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/cohere/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAGjE,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAA6B;IAIhD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAiC/C,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;IAOnD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAStC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa;IAavC,OAAO,CAAC,cAAc;IAqBhB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAM1D,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAahD,kBAAkB,IAAI,kBAAkB;IAIxC,oBAAoB,IAAI,iBAAiB;IAIzC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhH,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/providers/cohere/adapter.js

@@ -0,0 +1,128 @@
+import { parseRetryAfter } from "../../core/header-parser.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { MeridianError, SDK_VERSION } from "../../core/types.js";
+import { CoherePaginationStrategy } from "./pagination.js";
+export class CohereAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://api.cohere.ai/v1") {
+        this.baseUrl = baseUrl;
+    }
+    buildRequest(input) {
+        const { endpoint, options, authToken, baseUrl } = input;
+        const effectiveBaseUrl = baseUrl ?? this.baseUrl;
+        const baseUrlStripped = effectiveBaseUrl.endsWith("/") ? effectiveBaseUrl.slice(0, -1) : effectiveBaseUrl;
+        const endpointStripped = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+        const url = new URL(baseUrlStripped + endpointStripped);
+        if (options.query) {
+            for (const [key, value] of Object.entries(options.query)) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${authToken.token}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "X-Client-Name": `Meridian-SDK/${SDK_VERSION}`,
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        let body;
+        const method = options.method ?? "POST";
+        if (options.body && method !== "GET" && method !== "HEAD") {
+            body = JSON.stringify(options.body);
+        }
+        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, "cohere", rateLimitInfo, paginationInfo, [], "1.0.0");
+    }
+    parseStreamChunk(raw) {
+        try {
+            const parsed = JSON.parse(raw);
+            return parsed;
+        }
+        catch {
+            return { text: raw };
+        }
+    }
+    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.createError("network", true, "Network request failed.", { originalError: raw.message });
+            }
+        }
+        if (typeof raw === "object" && raw !== null && "status" in raw && typeof raw.status === "number") {
+            return this.parseHttpError(raw);
+        }
+        return this.createError("provider", false, "An unexpected error occurred.", { raw });
+    }
+    parseHttpError(error) {
+        const { status, body, headers } = error;
+        let message = "";
+        if (typeof body === "object" && body !== null) {
+            const b = body;
+            message = String(b.message ?? b.error ?? "");
+        }
+        else if (typeof body === "string") {
+            message = body;
+        }
+        const meta = { cohereError: message };
+        if (status === 401 || status === 403)
+            return this.createError("auth", false, message || "Unauthorized", meta, undefined, status);
+        if (status === 404)
+            return this.createError("validation", false, message || "Not Found", meta, undefined, 404);
+        if (status === 422)
+            return this.createError("validation", false, message || "Unprocessable Entity", meta, undefined, 422);
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            return this.createError("rate_limit", true, message || "Rate limit exceeded.", { ...meta, retryAfter: retryAfter?.toISOString() }, retryAfter, 429);
+        }
+        if (status >= 500)
+            return this.createError("provider", true, message || `Cohere API error ${status}`, meta, undefined, status);
+        return this.createError("validation", false, message || `Request failed with status ${status}`, meta, undefined, status);
+    }
+    async authStrategy(config) {
+        const key = config.apiKey ?? config.token;
+        if (!key)
+            throw this.createError("auth", false, "Cohere requires an API key. Set auth.apiKey.", {}, undefined, 401);
+        return { token: key };
+    }
+    rateLimitPolicy(headers) {
+        const limitStr = headers.get("X-RateLimit-Limit");
+        const remainingStr = headers.get("X-RateLimit-Remaining");
+        if (limitStr && remainingStr) {
+            const limit = Number.parseInt(limitStr, 10);
+            const remaining = Number.parseInt(remainingStr, 10);
+            if (!Number.isNaN(limit) && !Number.isNaN(remaining)) {
+                return { limit, remaining, reset: new Date(Date.now() + 60000) };
+            }
+        }
+        return { limit: 1000, remaining: 1000, reset: new Date(Date.now() + 60000) };
+    }
+    paginationStrategy() {
+        return new CoherePaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return { defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]), operationOverrides: new Map() };
+    }
+    verifyWebhook(_payload, _signature, _secret) {
+        return false; // Cohere does not currently publish a webhook signing scheme
+    }
+    createError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "cohere", 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/cohere/adapter.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cohere/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/providers/cohere/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/cohere/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/providers/cohere/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3F,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IACpD,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IACnD,OAAO,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO;IACxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE;CAG5H"}

package/dist/providers/cohere/pagination.js

@@ -0,0 +1,9 @@
+export class CoherePaginationStrategy {
+    extractCursor(_response) { return null; }
+    extractTotal(_response) { return null; }
+    hasNext(_response) { return false; }
+    buildNextRequest(endpoint, options, _cursor) {
+        return { endpoint, options };
+    }
+}
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/providers/cohere/pagination.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,wBAAwB;IACnC,aAAa,CAAC,SAAsB,IAAmB,OAAO,IAAI,CAAC,CAAC,CAAC;IACrE,YAAY,CAAC,SAAsB,IAAmB,OAAO,IAAI,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,SAAsB,IAAa,OAAO,KAAK,CAAC,CAAC,CAAC;IAC1D,gBAAgB,CAAC,QAAgB,EAAE,OAAuB,EAAE,OAAe;QACzE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import type { AdapterInput, AuthConfig, AuthToken, BuiltRequest, IdempotencyConfig, NormalizedResponse, PaginationStrategy, ProviderAdapter, RateLimitInfo, RawResponse } from "../../core/types.js";
+import { MeridianError } from "../../core/types.js";
+export declare class DecentroAdapter 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;
+    verifyWebhook(payload: string | Buffer, signature: string, secret: string): boolean;
+    private createMeridianError;
+    private extractRetryAfter;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/decentro/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAyB,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAUxF,qBAAa,eAAgB,YAAW,eAAe;IACrD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAA6B;IAIhD,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAqC/C,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,kBAAkB;IAcnD,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa;IAkCvC,OAAO,CAAC,cAAc;IAsFhB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAiB1D,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,aAAa;IAIjD,kBAAkB,IAAI,kBAAkB;IAIxC,oBAAoB,IAAI,iBAAiB;IAOzC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAYnF,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/providers/decentro/adapter.js

@@ -0,0 +1,144 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { parseRetryAfter } from "../../core/header-parser.js";
+import { ResponseNormalizer } from "../../core/normalizer.js";
+import { MeridianError, SDK_VERSION } from "../../core/types.js";
+import { DecentroPaginationStrategy } from "./pagination.js";
+export class DecentroAdapter {
+    baseUrl;
+    constructor(baseUrl = "https://in.decentro.tech") {
+        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));
+            }
+        }
+        // Token is encoded as "clientId|clientSecret|moduleSecret"
+        const parts = authToken.token.split("|");
+        const clientId = parts[0] ?? "";
+        const clientSecret = parts[1] ?? "";
+        const moduleSecret = parts[2] ?? "";
+        const headers = {
+            client_id: clientId,
+            client_secret: clientSecret,
+            module_secret: moduleSecret,
+            "User-Agent": `Meridian-SDK/${SDK_VERSION}`,
+            ...options.headers,
+        };
+        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, "decentro", 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.", {
+                    originalError: raw.message,
+                });
+            }
+        }
+        if (typeof raw === "object" &&
+            raw !== null &&
+            "status" in raw &&
+            typeof raw.status === "number") {
+            return this.parseHttpError(raw);
+        }
+        return this.createMeridianError("provider", false, "An unexpected error occurred", { raw });
+    }
+    parseHttpError(error) {
+        const { status, body, headers } = error;
+        const errorBody = body;
+        const errorMessage = errorBody?.message;
+        const responseCode = errorBody?.responseCode;
+        if (status === 401)
+            return this.createMeridianError("auth", false, errorMessage ?? "Authentication failed.", { responseCode }, undefined, 401);
+        if (status === 403)
+            return this.createMeridianError("auth", false, errorMessage ?? "Permission denied.", { responseCode }, undefined, 403);
+        if (status === 404)
+            return this.createMeridianError("validation", false, errorMessage ?? "Resource not found.", { responseCode }, undefined, 404);
+        if (status === 429) {
+            const retryAfter = this.extractRetryAfter(headers);
+            return this.createMeridianError("rate_limit", true, "Rate limit exceeded.", { responseCode }, retryAfter, 429);
+        }
+        if (status === 400 || status === 422)
+            return this.createMeridianError("validation", false, errorMessage ?? "Validation failed.", { responseCode }, undefined, status);
+        if (status >= 500)
+            return this.createMeridianError("provider", true, `Decentro API returned error ${status}.`, { status }, undefined, status);
+        if (status >= 400)
+            return this.createMeridianError("validation", false, `Request failed with status ${status}.`, { status }, undefined, status);
+        return this.createMeridianError("provider", false, `Unexpected response status ${status}.`, { status }, undefined, status);
+    }
+    async authStrategy(config) {
+        const clientId = config.clientId ?? config.custom?.clientId;
+        const clientSecret = config.clientSecret ?? config.custom?.clientSecret;
+        const moduleSecret = config.custom?.moduleSecret;
+        if (!clientId || !clientSecret || !moduleSecret) {
+            throw this.createMeridianError("auth", false, "Requires clientId, clientSecret, and moduleSecret.", {}, undefined, 401);
+        }
+        return { token: `${clientId}|${clientSecret}|${moduleSecret}` };
+    }
+    rateLimitPolicy(_headers) {
+        return { limit: 100, remaining: 100, reset: new Date(Date.now() + 60_000) };
+    }
+    paginationStrategy() {
+        return new DecentroPaginationStrategy();
+    }
+    getIdempotencyConfig() {
+        return {
+            defaultSafeOperations: new Set(["GET", "HEAD", "OPTIONS"]),
+            operationOverrides: new Map(),
+        };
+    }
+    verifyWebhook(payload, signature, secret) {
+        const expected = createHmac("sha256", secret).update(payload).digest("hex");
+        try {
+            const a = Buffer.from(expected);
+            const b = Buffer.from(signature);
+            if (a.length !== b.length)
+                return false;
+            return timingSafeEqual(a, b);
+        }
+        catch {
+            return false;
+        }
+    }
+    createMeridianError(category, retryable, message, metadata, retryAfter, status) {
+        return new MeridianError(message, category, "decentro", 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