@opencoredev/social-sdk 0.1.0

package/dist/testing/index.js

@@ -0,0 +1,413 @@
+import { SocialError, connectedAccountRef, defineAdapter, platformPostRef, } from "../core/index.js";
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+function mockManifest() {
+    return {
+        schemaVersion: 1,
+        backend: "mock",
+        apiRevision: "mock-v1",
+        runtime: ["node", "bun"],
+        capabilities: [
+            { operation: "accounts.read", platform: "*", availability: "available" },
+            { operation: "posts.status", platform: "*", availability: "available" },
+            {
+                operation: "posts.publish",
+                platform: "*",
+                availability: "available",
+                formats: ["text", "image", "video"],
+            },
+            { operation: "comments.read", platform: "*", availability: "available" },
+            { operation: "comments.write", platform: "*", availability: "available" },
+            { operation: "analytics.read", platform: "*", availability: "available" },
+            { operation: "webhooks.verify", platform: "*", availability: "available" },
+        ],
+    };
+}
+function fixture(name, eventId, occurredAt) {
+    return {
+        name,
+        headers: { "x-mock-signature": name === "invalid" ? "invalid" : "valid" },
+        body: encoder.encode(JSON.stringify({ version: 1, eventId, type: "post.updated", occurredAt })),
+    };
+}
+export function mockBackend(options = {}) {
+    let scenario = options.scenario ?? "immediate-text-success";
+    const backend = options.backendInstance ?? "default";
+    const clock = options.clock ?? (() => new Date("2026-01-01T00:00:00.000Z"));
+    const accountOne = connectedAccountRef({ backend, platform: "x", accountId: "mock-account-1" });
+    const accountTwo = connectedAccountRef({
+        backend,
+        platform: "threads",
+        accountId: "mock-account-2",
+    });
+    const accounts = [
+        { ref: accountOne, displayName: "Mock Creator", handle: "mock.creator", status: "connected" },
+        {
+            ref: accountTwo,
+            displayName: "Mock Studio",
+            handle: "mock.studio",
+            status: scenario === "reconnect-required" ? "reconnect-required" : "connected",
+        },
+    ];
+    let sequence = 0;
+    let deliverySequence = 0;
+    const deliveries = new Map();
+    let processingAdvanced = false;
+    const historyEntries = [];
+    const webhooks = [
+        fixture("valid", "event-1", "2026-01-01T00:00:02.000Z"),
+        fixture("duplicate", "event-1", "2026-01-01T00:00:02.000Z"),
+        fixture("out-of-order", "event-0", "2026-01-01T00:00:01.000Z"),
+        fixture("invalid", "event-invalid", "2026-01-01T00:00:03.000Z"),
+    ];
+    function record(operation, context, account) {
+        historyEntries.push({
+            sequence: ++sequence,
+            operation,
+            backend: context.backendInstance,
+            ...(account === undefined ? {} : { account }),
+            ...(context.targetIdempotencyKey === undefined
+                ? {}
+                : { idempotencyKey: context.targetIdempotencyKey }),
+        });
+    }
+    const testing = {
+        setScenario(next) {
+            scenario = next;
+            processingAdvanced = false;
+        },
+        history: () => historyEntries.map((entry) => ({ ...entry })),
+        reset: () => {
+            historyEntries.length = 0;
+            sequence = 0;
+            processingAdvanced = false;
+        },
+        advanceProcessing: () => {
+            processingAdvanced = true;
+        },
+        webhookFixtures: webhooks,
+    };
+    const adapter = defineAdapter({
+        id: "mock",
+        capabilities: mockManifest(),
+        testing,
+        accounts: {
+            async list(_input, context) {
+                record("accounts.list", context);
+                if (scenario === "account-selection-cancellation")
+                    return { items: [] };
+                return { items: accounts };
+            },
+            async get(ref, context) {
+                record("accounts.get", context, ref);
+                const found = accounts.find((account) => account.ref.accountId === ref.accountId);
+                if (found === undefined) {
+                    throw new SocialError({
+                        code: "invalid_input",
+                        operation: "accounts.get",
+                        message: "Mock account was not found",
+                        account: ref,
+                    });
+                }
+                return found;
+            },
+        },
+        posts: {
+            prepareTarget(target) {
+                if (scenario === "unsupported-feature") {
+                    return [
+                        {
+                            code: "mock.unsupported",
+                            message: "This scenario does not support publishing",
+                            severity: "error",
+                            targetIndex: target.targetIndex,
+                        },
+                    ];
+                }
+                if (scenario === "expired-media-url" &&
+                    target.content.media?.some((media) => media.source.kind === "https-url" && media.source.url.includes("expired"))) {
+                    return [
+                        {
+                            code: "media.url_expired",
+                            message: "The mock media URL has expired",
+                            severity: "error",
+                            targetIndex: target.targetIndex,
+                        },
+                    ];
+                }
+                return [];
+            },
+            async publishTarget(target, context) {
+                const deliveryNumber = ++deliverySequence;
+                const execute = async () => {
+                    record("posts.publishTarget", context, target.account);
+                    const base = {
+                        targetIndex: target.targetIndex,
+                        account: target.account,
+                        observedAt: clock().toISOString(),
+                        delivery: {
+                            kind: "delivery",
+                            version: 1,
+                            backend,
+                            platform: target.account.platform,
+                            accountId: target.account.accountId,
+                            deliveryId: `delivery-${deliveryNumber}`,
+                        },
+                    };
+                    if (scenario === "accepted-response-lost") {
+                        throw new SocialError({
+                            code: "ambiguous_outcome",
+                            operation: "posts.publish",
+                            message: "The mock backend accepted the request but the response was lost",
+                            account: target.account,
+                            retryDisposition: { kind: "reconcile-first" },
+                        });
+                    }
+                    if (scenario === "reconnect-required") {
+                        throw new SocialError({
+                            code: "reconnect_required",
+                            operation: "posts.publish",
+                            message: "Reconnect the mock account",
+                            account: target.account,
+                            retryDisposition: { kind: "after-reconnect" },
+                        });
+                    }
+                    if (scenario === "mixed-success-failure" && target.targetIndex % 2 === 1) {
+                        return {
+                            ...base,
+                            state: "failed",
+                            code: "mock.rejected",
+                            message: "Mock target rejected",
+                            retryDisposition: { kind: "never" },
+                        };
+                    }
+                    if (scenario === "expired-permission") {
+                        return {
+                            ...base,
+                            state: "failed",
+                            code: "missing_permission",
+                            message: "Mock permission expired",
+                            retryDisposition: { kind: "after-reconnect" },
+                        };
+                    }
+                    if (scenario === "rate-limited") {
+                        return {
+                            ...base,
+                            state: "failed",
+                            code: "rate_limited",
+                            message: "Mock rate limit",
+                            retryDisposition: { kind: "after-delay", delayMs: 1_000 },
+                        };
+                    }
+                    if (scenario === "provider-state-unknown") {
+                        return {
+                            ...base,
+                            state: "unknown",
+                            reason: "unmapped-state",
+                            backendState: "FUTURE_STATE",
+                            diagnostic: "Unmapped mock provider state",
+                        };
+                    }
+                    if (scenario === "failed-upload-finalization") {
+                        return {
+                            ...base,
+                            state: "failed",
+                            code: "media_error",
+                            message: "Mock upload finalization failed",
+                            retryDisposition: { kind: "never" },
+                        };
+                    }
+                    if (scenario === "media-processing-then-success" && !processingAdvanced) {
+                        return { ...base, state: "processing", backendState: "PROCESSING_MEDIA" };
+                    }
+                    return {
+                        ...base,
+                        state: "published",
+                        post: platformPostRef({
+                            backend,
+                            platform: target.account.platform,
+                            accountId: target.account.accountId,
+                            postId: `post-${deliveryNumber}`,
+                        }),
+                        url: `https://social.example.invalid/${target.account.platform}/post-${deliveryNumber}`,
+                    };
+                };
+                const outcome = await execute();
+                if (outcome.delivery)
+                    deliveries.set(outcome.delivery.deliveryId, structuredClone(outcome));
+                return outcome;
+            },
+            async getDelivery(ref, context) {
+                record("posts.getDelivery", context, connectedAccountRef({
+                    backend: ref.backend,
+                    platform: ref.platform,
+                    accountId: ref.accountId,
+                }));
+                if (scenario === "cancelled-polling" && context.signal?.aborted) {
+                    throw new SocialError({
+                        code: "cancelled",
+                        operation: "posts.getDelivery",
+                        message: "Mock polling was cancelled",
+                    });
+                }
+                const saved = deliveries.get(ref.deliveryId);
+                if (!saved ||
+                    saved.account.accountId !== ref.accountId ||
+                    saved.account.platform !== ref.platform ||
+                    saved.account.backend !== ref.backend)
+                    throw new SocialError({
+                        code: "unauthorized",
+                        operation: "posts.getDelivery",
+                        message: "Mock delivery does not belong to this account.",
+                    });
+                if (saved.state !== "processing" || !processingAdvanced)
+                    return structuredClone(saved);
+                const next = {
+                    ...saved,
+                    state: "published",
+                    observedAt: clock().toISOString(),
+                    post: platformPostRef({
+                        ...saved.account,
+                        postId: ref.deliveryId.replace(/^delivery-/, "post-"),
+                    }),
+                };
+                deliveries.set(ref.deliveryId, next);
+                return structuredClone(next);
+            },
+        },
+        comments: {
+            async list(post, _input, context) {
+                record("comments.list", context, connectedAccountRef(post));
+                if (!accounts.some((account) => account.ref.accountId === post.accountId && account.ref.platform === post.platform))
+                    throw new SocialError({
+                        code: "unauthorized",
+                        operation: "comments.read",
+                        message: "Mock account is not authorized",
+                    });
+                return {
+                    items: [{ id: "comment-1", text: "Can you share more about this?", postId: post.postId }],
+                };
+            },
+            async reply(comment, content, context) {
+                if (comment.commentId !== "comment-1" ||
+                    !content.text.trim() ||
+                    !accounts.some((account) => account.ref.accountId === comment.accountId &&
+                        account.ref.platform === comment.platform))
+                    throw new SocialError({
+                        code: "invalid_input",
+                        operation: "comments.write",
+                        message: "Select the returned mock comment and provide reply text",
+                    });
+                record("comments.reply", context, connectedAccountRef(comment));
+                return { ...comment, commentId: `mock-reply-${sequence}` };
+            },
+        },
+        analytics: {
+            async getPostMetrics(post, context) {
+                record("analytics.getPostMetrics", context, connectedAccountRef(post));
+                if (scenario === "no-metric-available")
+                    return [];
+                return [
+                    {
+                        name: "views",
+                        value: 42,
+                        unit: "count",
+                        period: "lifetime",
+                        measuredAt: clock().toISOString(),
+                        source: "mock",
+                    },
+                ];
+            },
+        },
+        webhooks: {
+            async verify(input, context) {
+                record("webhooks.verify", context);
+                return {
+                    valid: input.headers.get("x-mock-signature") === "valid",
+                    method: "mock",
+                    ...(input.headers.get("x-mock-signature") === "valid"
+                        ? {}
+                        : { reason: "Invalid mock signature" }),
+                };
+            },
+            async decode(input, context) {
+                record("webhooks.decode", context);
+                const parsed = JSON.parse(decoder.decode(input.body));
+                if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                    throw new SocialError({
+                        code: "invalid_input",
+                        operation: "webhooks.decode",
+                        message: "Invalid mock webhook body",
+                    });
+                }
+                const entries = [];
+                for (const [key, value] of Object.entries(parsed)) {
+                    if (typeof value === "string" ||
+                        typeof value === "number" ||
+                        typeof value === "boolean" ||
+                        value === null) {
+                        entries.push([key, value]);
+                    }
+                }
+                return Object.fromEntries(entries);
+            },
+        },
+        native: { scenario: () => scenario },
+    });
+    return adapter;
+}
+export class MemoryIdempotencyStore {
+    #claimsByKey = new Map();
+    #claimsById = new Map();
+    #sequence = 0;
+    async claim(input) {
+        const mapKey = JSON.stringify([input.scope, input.key]);
+        const existing = this.#claimsByKey.get(mapKey);
+        if (existing !== undefined) {
+            if (existing.fingerprint !== input.fingerprint ||
+                JSON.stringify(existing.targetKeys) !== JSON.stringify(input.targetKeys))
+                return { kind: "conflict" };
+            return {
+                kind: "existing",
+                claimId: existing.claimId,
+                outcomes: structuredClone(existing.outcomes),
+            };
+        }
+        const claim = {
+            claimId: `mock-claim-${++this.#sequence}`,
+            fingerprint: input.fingerprint,
+            targetKeys: [...input.targetKeys],
+            outcomes: {},
+        };
+        this.#claimsByKey.set(mapKey, claim);
+        this.#claimsById.set(claim.claimId, claim);
+        return { kind: "new", claimId: claim.claimId, outcomes: {} };
+    }
+    async saveOutcome(input) {
+        const claim = this.#claimsById.get(input.claimId);
+        if (claim === undefined)
+            throw new Error(`Unknown idempotency claim: ${input.claimId}`);
+        if (!claim.targetKeys.includes(input.targetKey)) {
+            throw new Error(`Target does not belong to idempotency claim: ${input.targetKey}`);
+        }
+        claim.outcomes[input.targetKey] = structuredClone(input.outcome);
+    }
+    reset() {
+        this.#claimsByKey.clear();
+        this.#claimsById.clear();
+        this.#sequence = 0;
+    }
+}
+export function mockSharedAccountAuthorization(input) {
+    return {
+        async authorizeTargets({ accounts, context }) {
+            const tenant = context.authorization?.tenantId;
+            return accounts.map((account) => ({
+                account,
+                allowed: tenant !== undefined && (input.memberships[tenant]?.includes(account.accountId) ?? false),
+                ...(tenant === undefined ? { reason: "A tenant is required" } : {}),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/testing.d.ts

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

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/testing.js

@@ -0,0 +1,2 @@
+export * from "./testing/index.js";
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/transport/binary.d.ts

@@ -0,0 +1,3 @@
+/** Bounded buffering for APIs that require one small binary image payload. */
+export declare function readBinary(stream: ReadableStream<Uint8Array>, maxBytes: number, signal: AbortSignal): Promise<Uint8Array>;
+//# sourceMappingURL=binary.d.ts.map

package/dist/transport/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

package/dist/transport/binary.js

@@ -0,0 +1,30 @@
+import { abortable, HttpError } from "./http.js";
+/** Bounded buffering for APIs that require one small binary image payload. */
+export async function readBinary(stream, maxBytes, signal) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let length = 0;
+    try {
+        for (;;) {
+            const chunk = await abortable(reader.read(), signal);
+            if (chunk.done)
+                break;
+            length += chunk.value.byteLength;
+            if (length > maxBytes)
+                throw new HttpError("Media exceeds its byte limit.", "invalid-input", false);
+            chunks.push(chunk.value);
+        }
+    }
+    finally {
+        void reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+    }
+    const result = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result;
+}
+//# sourceMappingURL=binary.js.map

package/dist/transport/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/transport/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjD,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkC,EAClC,QAAgB,EAChB,MAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,KAAK,CAAC,IAAI;gBAAE,MAAM;YACtB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;YACjC,IAAI,MAAM,GAAG,QAAQ;gBACnB,MAAM,IAAI,SAAS,CAAC,+BAA+B,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/transport/budget.d.ts

@@ -0,0 +1,4 @@
+import type { AdapterOperationContext } from "../core/types.js";
+/** Sequential requests sharing an operation context consume one elapsed budget. */
+export declare function remainingBudget(context: AdapterOperationContext, now?: number): number;
+//# sourceMappingURL=budget.d.ts.map

package/dist/transport/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/transport/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAIhE,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,SAAoB,GAAG,MAAM,CAsBjG"}

package/dist/transport/budget.js

@@ -0,0 +1,27 @@
+import { SocialError } from "../core/errors.js";
+const deadlines = new WeakMap();
+/** Sequential requests sharing an operation context consume one elapsed budget. */
+export function remainingBudget(context, now = performance.now()) {
+    const duration = context.retryBudget.maxElapsedMs;
+    if (!Number.isFinite(duration) || duration <= 0)
+        throw new SocialError({
+            code: "invalid_input",
+            operation: "transport",
+            message: "Elapsed request budget must be positive and finite.",
+        });
+    let deadline = deadlines.get(context);
+    if (deadline === undefined) {
+        deadline = now + duration;
+        deadlines.set(context, deadline);
+    }
+    const remaining = deadline - now;
+    if (remaining <= 0)
+        throw new SocialError({
+            code: "timeout",
+            operation: "transport",
+            message: "The operation exhausted its elapsed request budget before the next dispatch.",
+            retryDisposition: { kind: "never" },
+        });
+    return remaining;
+}
+//# sourceMappingURL=budget.js.map

package/dist/transport/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/transport/budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,SAAS,GAAG,IAAI,OAAO,EAAmC,CAAC;AACjE,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,OAAgC,EAAE,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE;IACvF,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC;QAC7C,MAAM,IAAI,WAAW,CAAC;YACpB,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,IAAI,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;QAC1B,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,GAAG,GAAG,CAAC;IACjC,IAAI,SAAS,IAAI,CAAC;QAChB,MAAM,IAAI,WAAW,CAAC;YACpB,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,8EAA8E;YACvF,gBAAgB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SACpC,CAAC,CAAC;IACL,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transport/http.d.ts

@@ -0,0 +1,44 @@
+/** Portable, bounded HTTP transport. Construction performs no I/O. */
+export interface HttpOptions {
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    maxResponseBytes?: number;
+    now?: () => number;
+    random?: () => number;
+    sleep?: (milliseconds: number, signal: AbortSignal) => Promise<void>;
+    onRequest?: (event: RequestEvent) => void | Promise<void>;
+}
+export interface RequestEvent {
+    method: string;
+    status?: number;
+    attempt: number;
+    elapsedMs: number;
+}
+export interface HttpRequest {
+    url: URL;
+    method?: "GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: HeadersInit;
+    body?: BodyInit;
+    signal?: AbortSignal;
+    /** Read retries only. Writes are never replayed by this transport. */
+    maxAttempts?: number;
+    /** Return only these selected response headers alongside the parsed body. */
+    responseHeaders?: readonly string[];
+    /** Per-operation elapsed budget, capped by the transport's configured deadline. */
+    timeoutMs?: number;
+}
+export declare class HttpError extends Error {
+    readonly kind: "http" | "network" | "timeout" | "cancelled" | "invalid-response" | "invalid-input";
+    readonly dispatched: boolean;
+    readonly status?: number | undefined;
+    readonly retryAfterMs?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly name = "HttpError";
+    constructor(message: string, kind: "http" | "network" | "timeout" | "cancelled" | "invalid-response" | "invalid-input", dispatched: boolean, status?: number | undefined, retryAfterMs?: number | undefined, requestId?: string | undefined);
+}
+export declare function retryDelay(value: string | null, now: number): number | undefined;
+/** Enforce cancellation even when an injected I/O implementation ignores signals. */
+export declare function abortable<T>(work: Promise<T>, signal: AbortSignal): Promise<T>;
+export declare function readJson(response: Response, limit: number, signal?: AbortSignal): Promise<unknown>;
+export declare function createHttp(options?: HttpOptions): (input: HttpRequest) => Promise<unknown>;
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AACA,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAIhC,QAAQ,CAAC,IAAI,EACT,MAAM,GACN,SAAS,GACT,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,eAAe;IACnB,QAAQ,CAAC,UAAU,EAAE,OAAO;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAb7B,SAAkB,IAAI,eAAe;gBAEnC,OAAO,EAAE,MAAM,EACN,IAAI,EACT,MAAM,GACN,SAAS,GACT,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,eAAe,EACV,UAAU,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,SAAS,CAAC,EAAE,MAAM,YAAA;CAI9B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhF;AAiBD,qFAAqF;AACrF,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAepF;AAED,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAqDlB;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAgB,IAkBpB,OAAO,WAAW,KAAG,OAAO,CAAC,OAAO,CAAC,CAiJpE"}