@gusnips/sdkgen 0.1.0 → 0.2.1

package/dist/transport.d.ts

@@ -0,0 +1,88 @@
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/** What a generated method tells the transport about its operation. */
+export interface RequestSpec {
+    method: HttpMethod;
+    /** `/numbers/:numberId/pair`. Each `:name` is filled from the params field of that name. */
+    path: string;
+    /** The operation reads an `Idempotency-Key`, so the server answers a repeat from the first run. */
+    keyed?: boolean;
+    /** Safe to run twice with no key, such as a read sent as a POST. Absent: true for a GET only. */
+    repeatable?: boolean;
+}
+/** The last argument of every generated method. */
+export interface RequestOptions {
+    /**
+     * Your own key for a call that takes one, such as a UUID saved with the message you send.
+     * Every attempt sends the same key, and so can your own retry after a crash.
+     */
+    idempotencyKey?: string;
+    /** How long one attempt waits for an answer, in milliseconds. Overrides the SDK's. */
+    timeoutMs?: number;
+}
+/** The `error` of the envelope, as the answer carried it. */
+export interface EnvelopeError {
+    /** What went wrong, as a word a program can check. */
+    code: string;
+    message: string | undefined;
+    messageKey: string | undefined;
+    params: Record<string, string | number> | undefined;
+    /** As sent. `{ retryAfterSecs: null }` means waiting never helps. */
+    details: unknown;
+}
+/** A call that did not work, as `error` gets it to build the SDK's own error. */
+export interface Failure {
+    method: HttpMethod;
+    /** The path with its values filled in: `/numbers/n_1/pair`. */
+    path: string;
+    /** The HTTP status, or 0 when no answer came back: offline, a dropped connection, a timeout. */
+    status: number;
+    /** No answer within `timeoutMs`. The call may still have run. */
+    timedOut: boolean;
+    timeoutMs: number;
+    /** The envelope's `error`, when the answer carried one. */
+    error: EnvelopeError | undefined;
+    /** An answer that was not the envelope, such as a gateway's HTML page: its first 500 characters. */
+    text: string | undefined;
+    /** `Retry-After` in seconds, whichever of its two forms it came in. */
+    retryAfterSecs: number | undefined;
+    /** The `x-request-id` header, for the API's support to find the call. */
+    requestId: string | undefined;
+    /** The key the call was sent with. Retry with it, and a call that ran answers from its first run. */
+    idempotencyKey: string | undefined;
+    /** What fetch threw, when no answer came back. */
+    cause: unknown;
+}
+/** One SDK's settings. */
+export interface Transport {
+    /** Where the API lives, with its base path: `https://api.example.com/v1`. */
+    baseUrl: string;
+    /** Sent on every call, such as the credential and the SDK's version. */
+    headers?: Readonly<Record<string, string>>;
+    /** Default: the global `fetch`. */
+    fetch?: typeof fetch;
+    /** How long one attempt of this call waits for an answer, in milliseconds. Default 30,000. */
+    timeoutMs?: (spec: RequestSpec, params: object) => number;
+    /** Extra attempts after a failure the retry rule says is worth repeating. Default 2. */
+    maxRetries?: number;
+    /** Error codes that waiting does not clear, such as a spent monthly quota. */
+    durableCodes?: readonly string[];
+    /**
+     * Make up a key for a call that takes one when the caller sent none, so the call can be retried.
+     * Default false: without a key, a write that may have run is not sent again.
+     */
+    mintKeys?: boolean;
+    /** Builds the SDK's own error for a failed call. The transport throws what this returns. */
+    error: (failure: Failure) => Error;
+}
+/** A call that worked. `data` is `undefined` for a 204 or any other empty answer. */
+export interface Answer<T, M> {
+    data: T;
+    meta: M | undefined;
+}
+/**
+ * Sends one call, retries it while the rule says so, and returns `{ data, meta }` or throws
+ * `transport.error(failure)`. A value the path needs and did not get throws a TypeError before
+ * anything is sent.
+ */
+export declare function send<T = unknown, M = unknown>(transport: Transport, spec: RequestSpec, params?: object, opts?: RequestOptions): Promise<Answer<T, M>>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iGAAiG;IACjG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC;IACpD,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,oGAAoG;IACpG,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,uEAAuE;IACvE,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qGAAqG;IACrG,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,0BAA0B;AAC1B,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4FAA4F;IAC5F,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC;CACpC;AAED,qFAAqF;AACrF,MAAM,WAAW,MAAM,CAAC,CAAC,EAAE,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;CACrB;AAKD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACjD,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,WAAW,EACjB,MAAM,GAAE,MAAW,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAsCvB"}

package/dist/transport.js

@@ -0,0 +1,198 @@
+/**
+ * The transport under every generated SDK method: one request, one retry rule, one error.
+ *
+ * This file is a template. `transportSource()` hands it to a generator, which writes it into each
+ * SDK as `generated/transport.ts` beside `generated/retry.ts`, so the SDK keeps zero runtime
+ * dependencies. It lives here as code rather than as a string so that this package typechecks it
+ * and its tests run it. It may import nothing but the retry rule, and only globals that Node, Bun,
+ * Deno, a Worker and a browser all have.
+ *
+ * Whether a failed call is tried again is `@gusnips/http`'s rule, not this file's. What this file
+ * decides is what the rule is asked, and the SDKs that wrote their own asked it wrong:
+ * - **A write is repeatable only with a key the server reads.** A retried send is a second
+ *   message to a real person; with an `Idempotency-Key` the server answers the retry from the
+ *   first run instead.
+ * - **The rule reads the answer, not the SDK's error.** Three copies decided from their error
+ *   class's `retryAfter`, a number or nothing, so the server's explicit
+ *   `details.retryAfterSecs: null`, which says waiting never helps, never reached the decision.
+ * - **The header is read first, in both its forms.** Two copies read the body's wait before the
+ *   `Retry-After` header, and read the header only as seconds, so an HTTP date was no wait at all.
+ */
+import { parseRetryAfter, retryDelayMs, shouldRetry } from "@gusnips/http/retry";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Sends one call, retries it while the rule says so, and returns `{ data, meta }` or throws
+ * `transport.error(failure)`. A value the path needs and did not get throws a TypeError before
+ * anything is sent.
+ */
+export async function send(transport, spec, params = {}, opts = {}) {
+    // A key the server does not read cannot stop a second run, and treating the call as
+    // repeatable because it carries one would send a write twice.
+    if (!spec.keyed && opts.idempotencyKey !== undefined) {
+        throw new TypeError(`${spec.method} ${spec.path} takes no idempotency key, so a key cannot stop it running twice. Leave it out.`);
+    }
+    // One key per call, not per attempt: a retry has to send the same key to get the first answer.
+    const key = spec.keyed
+        ? (opts.idempotencyKey ?? (transport.mintKeys ? globalThis.crypto.randomUUID() : undefined))
+        : undefined;
+    const repeatable = (spec.repeatable ?? spec.method === "GET") || key !== undefined;
+    const request = prepare(transport, spec, params, key);
+    const timeoutMs = opts.timeoutMs ?? transport.timeoutMs?.(spec, params) ?? DEFAULT_TIMEOUT_MS;
+    const maxRetries = transport.maxRetries ?? DEFAULT_MAX_RETRIES;
+    // A local, never `transport.fetch(...)`: called as a method, a browser's fetch gets the
+    // settings object as `this` and throws "Illegal invocation".
+    const fetchImpl = transport.fetch ?? globalThis.fetch;
+    for (let attempt = 0;; attempt++) {
+        const outcome = await once(fetchImpl, request, timeoutMs);
+        if (outcome.ok)
+            return outcome.answer;
+        const failure = { ...outcome.failure, idempotencyKey: key };
+        // The rule reads these fields as the answer sent them: the header's wait apart from the
+        // body's, and `details` untouched, so an explicit `retryAfterSecs: null` still says never.
+        const answer = {
+            status: failure.status,
+            code: failure.error?.code,
+            details: failure.error?.details,
+            retryAfterSecs: failure.retryAfterSecs,
+        };
+        const again = attempt < maxRetries &&
+            shouldRetry(answer, { repeatable, durableCodes: transport.durableCodes });
+        if (!again)
+            throw transport.error(failure);
+        await new Promise((resolve) => setTimeout(resolve, retryDelayMs(attempt, answer)));
+    }
+}
+/** The request every attempt sends: the path filled in, the rest in the query or the body. */
+function prepare(transport, spec, params, key) {
+    const values = new Map(Object.entries(params));
+    const path = spec.path.replace(/:(\w+)/g, (_slot, name) => {
+        const value = values.get(name);
+        // An empty segment would send the call to a different route: `/numbers//pair`.
+        if ((typeof value !== "string" && typeof value !== "number") || value === "") {
+            throw new TypeError(`${spec.method} ${spec.path} needs \`${name}\` for its path.`);
+        }
+        return encodeURIComponent(String(value));
+    });
+    for (const name of spec.path.match(/:\w+/g) ?? [])
+        values.delete(name.slice(1));
+    const url = new URL(transport.baseUrl.replace(/\/+$/, "") + path);
+    const inQuery = spec.method === "GET" || spec.method === "DELETE";
+    if (inQuery) {
+        for (const [name, value] of values) {
+            // An array is the name repeated, `?tag=a&tag=b`, which is how a query string carries a list.
+            for (const item of Array.isArray(value) ? value : [value]) {
+                if (item === undefined || item === null)
+                    continue;
+                if (typeof item === "object") {
+                    throw new TypeError(`${spec.method} ${spec.path}: \`${name}\` cannot go in a query string.`);
+                }
+                url.searchParams.append(name, String(item));
+            }
+        }
+    }
+    const headers = new Headers(transport.headers);
+    if (!headers.has("accept"))
+        headers.set("accept", "application/json");
+    if (!inQuery)
+        headers.set("content-type", "application/json");
+    if (key !== undefined)
+        headers.set("idempotency-key", key);
+    return {
+        method: spec.method,
+        path,
+        url: url.toString(),
+        headers,
+        // Every write sends a body, `{}` included: a handler that parses JSON answers 400 to none.
+        body: inQuery ? undefined : JSON.stringify(Object.fromEntries(values)),
+    };
+}
+/** One attempt. Never throws: a failure is a value, so the loop can ask the rule about it. */
+async function once(fetchImpl, request, timeoutMs) {
+    const base = { method: request.method, path: request.path, timeoutMs };
+    let response;
+    let text;
+    try {
+        response = await fetchImpl(request.url, {
+            method: request.method,
+            headers: request.headers,
+            body: request.body,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        // Inside the try: a connection that drops halfway through the body is no answer either.
+        text = await response.text();
+    }
+    catch (cause) {
+        return {
+            ok: false,
+            failure: {
+                ...base,
+                status: 0,
+                timedOut: isTimeout(cause),
+                error: undefined,
+                text: undefined,
+                retryAfterSecs: undefined,
+                requestId: undefined,
+                cause,
+            },
+        };
+    }
+    const body = parse(text);
+    if (response.ok && body !== undefined) {
+        // The one place the SDK takes the API's word for a type: the contract says what `data` is.
+        return { ok: true, answer: { data: body["data"], meta: body["meta"] } };
+    }
+    const error = envelopeError(body?.["error"]);
+    return {
+        ok: false,
+        failure: {
+            ...base,
+            // A 2xx lands here only when its body is not JSON, which is not the API answering.
+            status: response.status,
+            timedOut: false,
+            error,
+            text: error === undefined && text !== "" ? text.slice(0, 500) : undefined,
+            retryAfterSecs: parseRetryAfter(response.headers.get("retry-after")),
+            requestId: response.headers.get("x-request-id") ?? undefined,
+            cause: undefined,
+        },
+    };
+}
+/** The body as a JSON object: `{}` when empty, `undefined` when it is not a JSON object. */
+function parse(text) {
+    if (text === "")
+        return {};
+    try {
+        const value = JSON.parse(text);
+        return isRecord(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function envelopeError(value) {
+    if (!isRecord(value))
+        return undefined;
+    const { code, message, messageKey, params, details } = value;
+    if (typeof code !== "string")
+        return undefined;
+    return {
+        code,
+        message: typeof message === "string" ? message : undefined,
+        messageKey: typeof messageKey === "string" ? messageKey : undefined,
+        params: isParams(params) ? params : undefined,
+        details,
+    };
+}
+function isParams(value) {
+    return (isRecord(value) &&
+        Object.values(value).every((v) => typeof v === "string" || typeof v === "number"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** `AbortSignal.timeout` rejects with a DOMException named TimeoutError. */
+function isTimeout(cause) {
+    return (typeof cause === "object" && cause !== null && "name" in cause && cause.name === "TimeoutError");
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA0FjF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,SAAoB,EACpB,IAAiB,EACjB,SAAiB,EAAE,EACnB,OAAuB,EAAE;IAEzB,oFAAoF;IACpF,8DAA8D;IAC9D,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACrD,MAAM,IAAI,SAAS,CACjB,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,iFAAiF,CAC7G,CAAC;IACJ,CAAC;IACD,+FAA+F;IAC/F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK;QACpB,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5F,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,SAAS,CAAC;IACnF,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,kBAAkB,CAAC;IAC9F,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC/D,wFAAwF;IACxF,6DAA6D;IAC7D,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAEtD,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAO,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC;QACtC,MAAM,OAAO,GAAY,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;QACrE,wFAAwF;QACxF,2FAA2F;QAC3F,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI;YACzB,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO;YAC/B,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC;QACF,MAAM,KAAK,GACT,OAAO,GAAG,UAAU;YACpB,WAAW,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK;YAAE,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAaD,8FAA8F;AAC9F,SAAS,OAAO,CACd,SAAoB,EACpB,IAAiB,EACjB,MAAc,EACd,GAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAkB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,+EAA+E;QAC/E,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC7E,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,YAAY,IAAI,kBAAkB,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;IAClE,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACnC,6FAA6F;YAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1D,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,SAAS;gBAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7B,MAAM,IAAI,SAAS,CACjB,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,iCAAiC,CACxE,CAAC;gBACJ,CAAC;gBACD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC9D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI;QACJ,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;QACnB,OAAO;QACP,2FAA2F;QAC3F,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,IAAI,CACjB,SAAuB,EACvB,OAAiB,EACjB,SAAiB;IAEjB,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IACvE,IAAI,QAAkB,CAAC;IACvB,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;QACH,wFAAwF;QACxF,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE;gBACP,GAAG,IAAI;gBACP,MAAM,EAAE,CAAC;gBACT,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC;gBAC1B,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,SAAS;gBACf,cAAc,EAAE,SAAS;gBACzB,SAAS,EAAE,SAAS;gBACpB,KAAK;aACN;SACF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,QAAQ,CAAC,EAAE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,2FAA2F;QAC3F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAkB,EAAE,EAAE,CAAC;IAChG,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,EAAE,EAAE,KAAK;QACT,OAAO,EAAE;YACP,GAAG,IAAI;YACP,mFAAmF;YACnF,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,QAAQ,EAAE,KAAK;YACf,KAAK;YACL,IAAI,EAAE,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YACzE,cAAc,EAAE,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACpE,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS;YAC5D,KAAK,EAAE,SAAS;SACjB;KACF,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,SAAS,KAAK,CAAC,IAAY;IACzB,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QAC1D,UAAU,EAAE,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACnE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAClF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,4EAA4E;AAC5E,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAChG,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/sdkgen",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "The pieces of an SDK generator: copy your API's types with their comments, write a schema as a TypeScript type, and keep the output current.",
   "type": "module",
   "license": "MIT",
@@ -48,6 +48,9 @@
     "release:minor": "bun pm version minor && bun publish --access public",
     "release:major": "bun pm version major && bun publish --access public"
   },
+  "dependencies": {
+    "@gusnips/http": "^0.1.5"
+  },
   "peerDependencies": {
     "prettier": ">=3.4 <4"
   },

package/src/index.ts

@@ -1,4 +1,15 @@
 export { liftContract, type LiftOptions } from "./contract.ts";
+export {
+  retrySource,
+  sdkMethods,
+  transportSource,
+  type InjectedMember,
+  type SdkMethods,
+  type SdkMethodsOptions,
+  type SdkOperation,
+  type SdkPlacement,
+  type SdkRoute,
+} from "./methods.ts";
 export {
   camelCase,
   docComment,