@usestatemachines/sdk 0.1.1

package/esm/lib/base64.js

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod/v4-mini";
+export function bytesToBase64(u8arr) {
+    return btoa(String.fromCodePoint(...u8arr));
+}
+export function bytesFromBase64(encoded) {
+    return Uint8Array.from(atob(encoded), (c) => c.charCodeAt(0));
+}
+export function stringToBytes(str) {
+    return new TextEncoder().encode(str);
+}
+export function stringFromBytes(u8arr) {
+    return new TextDecoder().decode(u8arr);
+}
+export function stringToBase64(str) {
+    return bytesToBase64(stringToBytes(str));
+}
+export function stringFromBase64(b64str) {
+    return stringFromBytes(bytesFromBase64(b64str));
+}
+export const zodOutbound = z.union([
+    z.custom(x => x instanceof Uint8Array),
+    z.pipe(z.string(), z.transform(stringToBytes)),
+]);
+export const zodInbound = z.union([
+    z.custom(x => x instanceof Uint8Array),
+    z.pipe(z.string(), z.transform(bytesFromBase64)),
+]);

package/esm/lib/config.d.ts

@@ -0,0 +1,37 @@
+import { HTTPClient } from "./http.js";
+import { Logger } from "./logger.js";
+import { RetryConfig } from "./retries.js";
+/**
+ * Contains the list of servers available to the SDK
+ */
+export declare const ServerList: readonly ["https://state-api.usestatemachines.workers.dev"];
+export type SDKOptions = {
+    apiKey?: string | (() => Promise<string>) | undefined;
+    httpClient?: HTTPClient;
+    /**
+     * Allows overriding the default server used by the SDK
+     */
+    serverIdx?: number | undefined;
+    /**
+     * Allows overriding the default server URL used by the SDK
+     */
+    serverURL?: string | undefined;
+    /**
+     * Allows overriding the default user agent used by the SDK
+     */
+    userAgent?: string | undefined;
+    /**
+     * Allows overriding the default retry config used by the SDK
+     */
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+    debugLogger?: Logger;
+};
+export declare function serverURLFromOptions(options: SDKOptions): URL | null;
+export declare const SDK_METADATA: {
+    readonly language: "typescript";
+    readonly openapiDocVersion: "1.0.0";
+    readonly sdkVersion: "0.1.1";
+    readonly genVersion: "2.941.0";
+    readonly userAgent: "speakeasy-sdk/typescript 0.1.1 2.941.0 1.0.0 @usestatemachines/sdk";
+};

package/esm/lib/config.js

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { pathToFunc } from "./url.js";
+/**
+ * Contains the list of servers available to the SDK
+ */
+export const ServerList = [
+    "https://state-api.usestatemachines.workers.dev",
+];
+export function serverURLFromOptions(options) {
+    let serverURL = options.serverURL;
+    const params = {};
+    if (!serverURL) {
+        const serverIdx = options.serverIdx ?? 0;
+        if (serverIdx < 0 || serverIdx >= ServerList.length) {
+            throw new Error(`Invalid server index ${serverIdx}`);
+        }
+        serverURL = ServerList[serverIdx] || "";
+    }
+    const u = pathToFunc(serverURL)(params);
+    return new URL(u);
+}
+export const SDK_METADATA = {
+    language: "typescript",
+    openapiDocVersion: "1.0.0",
+    sdkVersion: "0.1.1",
+    genVersion: "2.941.0",
+    userAgent: "speakeasy-sdk/typescript 0.1.1 2.941.0 1.0.0 @usestatemachines/sdk",
+};

package/esm/lib/encodings.d.ts

@@ -0,0 +1,54 @@
+export declare class EncodingError extends Error {
+    constructor(message: string);
+}
+export type CharEncoding = "percent" | "percentExceptReserved" | "none";
+export declare function encodeMatrix(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+}): string | undefined;
+export declare function encodeLabel(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+}): string | undefined;
+type FormEncoder = (key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+}) => string | undefined;
+export declare const encodeForm: FormEncoder;
+export declare const encodeSpaceDelimited: FormEncoder;
+export declare const encodePipeDelimited: FormEncoder;
+export declare function encodeBodyForm(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+}): string;
+export declare function encodeDeepObject(key: string, value: unknown, options?: {
+    charEncoding?: CharEncoding;
+}): string | undefined;
+export declare function encodeDeepObjectObject(key: string, value: unknown, options?: {
+    charEncoding?: CharEncoding;
+}): string | undefined;
+export declare function encodeJSON(key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+}): string | undefined;
+export declare const encodeSimple: (key: string, value: unknown, options?: {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+} | undefined) => string | undefined;
+export declare function queryJoin(...args: (string | undefined)[]): string;
+type QueryEncoderOptions = {
+    explode?: boolean;
+    charEncoding?: CharEncoding;
+    allowEmptyValue?: string[];
+};
+type QueryEncoder = (key: string, value: unknown, options?: QueryEncoderOptions) => string | undefined;
+type BulkQueryEncoder = (values: Record<string, unknown>, options?: QueryEncoderOptions) => string;
+export declare function queryEncoder(f: QueryEncoder): BulkQueryEncoder;
+export declare const encodeJSONQuery: BulkQueryEncoder;
+export declare const encodeFormQuery: BulkQueryEncoder;
+export declare const encodeSpaceDelimitedQuery: BulkQueryEncoder;
+export declare const encodePipeDelimitedQuery: BulkQueryEncoder;
+export declare const encodeDeepObjectQuery: BulkQueryEncoder;
+export declare function appendForm(fd: FormData, key: string, value: unknown, fileName?: string): void;
+export declare function normalizeBlob(value: Pick<Blob, "arrayBuffer" | "type">): Promise<Blob>;
+export {};

package/esm/lib/encodings.js

@@ -0,0 +1,406 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { bytesToBase64 } from "./base64.js";
+import { isPlainObject } from "./primitives.js";
+export class EncodingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EncodingError";
+    }
+}
+const reservedEscapes = /%(2[346bcf]|3[abdf]|40|5[bd])/gi;
+function encodeKeyChars(v, charEncoding) {
+    return encodeChars(v, charEncoding === "percentExceptReserved" ? "percent" : charEncoding);
+}
+function encodeChars(v, charEncoding) {
+    switch (charEncoding) {
+        case "percent":
+            return encodeURIComponent(v);
+        case "percentExceptReserved":
+            return encodeURIComponent(v).replace(reservedEscapes, (m) => decodeURIComponent(m));
+        default:
+            return v;
+    }
+}
+export function encodeMatrix(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        let encValue = null;
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `,${encodeString(k)},${encodeValue(v)}`;
+            });
+            encValue = mapped?.join("").slice(1);
+        }
+        else {
+            encValue = `${encodeValue(pv)}`;
+        }
+        if (encValue == null) {
+            return;
+        }
+        const keyPrefix = encodeKeyChars(pk, options?.charEncoding);
+        tmp = `${keyPrefix}=${encValue}`;
+        // trim trailing '=' if value was empty
+        if (tmp === `${keyPrefix}=`) {
+            tmp = tmp.slice(0, -1);
+        }
+        // If we end up with the nothing then skip forward
+        if (!tmp) {
+            return;
+        }
+        out += `;${tmp}`;
+    });
+    return out;
+}
+export function encodeLabel(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let encValue = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(".");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `.${encodeString(k)}.${encodeValue(v)}`;
+            });
+            encValue = mapped?.join("").slice(1);
+        }
+        else {
+            const k = options?.explode && isPlainObject(value)
+                ? `${encodeKeyChars(pk, options?.charEncoding)}=`
+                : "";
+            encValue = `${k}${encodeValue(pv)}`;
+        }
+        out += encValue == null ? "" : `.${encValue}`;
+    });
+    return out;
+}
+function formEncoder(sep) {
+    return (key, value, options) => {
+        let out = "";
+        const pairs = options?.explode
+            ? explode(key, value)
+            : [[key, value]];
+        if (pairs.every(([_, v]) => v == null)) {
+            return;
+        }
+        const encodeString = (v) => {
+            return encodeChars(v, options?.charEncoding);
+        };
+        const encodeValue = (v) => encodeString(serializeValue(v));
+        const encodedSep = encodeString(sep);
+        pairs.forEach(([pk, pv]) => {
+            let tmp = "";
+            let encValue = null;
+            if (pv == null) {
+                return;
+            }
+            else if (Array.isArray(pv)) {
+                encValue = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(encodedSep);
+            }
+            else if (isPlainObject(pv)) {
+                encValue = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                    return `${encodeString(k)}${encodedSep}${encodeValue(v)}`;
+                })?.join(encodedSep);
+            }
+            else {
+                encValue = `${encodeValue(pv)}`;
+            }
+            if (encValue == null) {
+                return;
+            }
+            tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
+            // If we end up with the nothing then skip forward
+            if (!tmp || tmp === "=") {
+                return;
+            }
+            out += `&${tmp}`;
+        });
+        return out.slice(1);
+    };
+}
+export const encodeForm = formEncoder(",");
+export const encodeSpaceDelimited = formEncoder(" ");
+export const encodePipeDelimited = formEncoder("|");
+export function encodeBodyForm(key, value, options) {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        let encValue = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            encValue = JSON.stringify(pv, jsonReplacer);
+        }
+        else if (isPlainObject(pv)) {
+            encValue = JSON.stringify(pv, jsonReplacer);
+        }
+        else {
+            encValue = `${encodeValue(pv)}`;
+        }
+        tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
+        // If we end up with the nothing then skip forward
+        if (!tmp || tmp === "=") {
+            return;
+        }
+        out += `&${tmp}`;
+    });
+    return out.slice(1);
+}
+export function encodeDeepObject(key, value, options) {
+    if (value == null) {
+        return;
+    }
+    if (!isPlainObject(value)) {
+        throw new EncodingError(`Value of parameter '${key}' which uses deepObject encoding must be an object or null`);
+    }
+    return encodeDeepObjectObject(key, value, options);
+}
+export function encodeDeepObjectObject(key, value, options) {
+    if (value == null) {
+        return;
+    }
+    let out = "";
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    if (!isPlainObject(value)) {
+        throw new EncodingError(`Expected parameter '${key}' to be an object.`);
+    }
+    Object.entries(value).forEach(([ck, cv]) => {
+        if (cv == null) {
+            return;
+        }
+        const pk = `${key}[${ck}]`;
+        if (isPlainObject(cv)) {
+            const objOut = encodeDeepObjectObject(pk, cv, options);
+            out += objOut == null ? "" : `&${objOut}`;
+            return;
+        }
+        const pairs = Array.isArray(cv) ? cv : [cv];
+        const encoded = mapDefined(pairs, (v) => {
+            return `${encodeKeyChars(pk, options?.charEncoding)}=${encodeString(serializeValue(v))}`;
+        })?.join("&");
+        out += encoded == null ? "" : `&${encoded}`;
+    });
+    return out.slice(1);
+}
+export function encodeJSON(key, value, options) {
+    if (typeof value === "undefined") {
+        return;
+    }
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    const encVal = encodeString(JSON.stringify(value, jsonReplacer));
+    return options?.explode
+        ? encVal
+        : `${encodeKeyChars(key, options?.charEncoding)}=${encVal}`;
+}
+export const encodeSimple = (key, value, options) => {
+    let out = "";
+    const pairs = options?.explode
+        ? explode(key, value)
+        : [[key, value]];
+    if (pairs.every(([_, v]) => v == null)) {
+        return;
+    }
+    const encodeString = (v) => {
+        return encodeChars(v, options?.charEncoding);
+    };
+    const encodeValue = (v) => encodeString(serializeValue(v));
+    pairs.forEach(([pk, pv]) => {
+        let tmp = "";
+        if (pv == null) {
+            return;
+        }
+        else if (Array.isArray(pv)) {
+            tmp = mapDefined(pv, (v) => `${encodeValue(v)}`)?.join(",");
+        }
+        else if (isPlainObject(pv)) {
+            const mapped = mapDefinedEntries(Object.entries(pv), ([k, v]) => {
+                return `,${encodeString(k)},${encodeValue(v)}`;
+            });
+            tmp = mapped?.join("").slice(1);
+        }
+        else {
+            const k = options?.explode && isPlainObject(value) ? `${pk}=` : "";
+            tmp = `${k}${encodeValue(pv)}`;
+        }
+        out += tmp ? `,${tmp}` : "";
+    });
+    return out.slice(1);
+};
+function explode(key, value) {
+    if (Array.isArray(value)) {
+        return value.map((v) => [key, v]);
+    }
+    else if (isPlainObject(value)) {
+        const o = value ?? {};
+        return Object.entries(o).map(([k, v]) => [k, v]);
+    }
+    else {
+        return [[key, value]];
+    }
+}
+function serializeValue(value) {
+    if (value == null) {
+        return "";
+    }
+    else if (value instanceof Date) {
+        return value.toISOString();
+    }
+    else if (value instanceof Uint8Array) {
+        return bytesToBase64(value);
+    }
+    else if (typeof value === "object") {
+        return JSON.stringify(value, jsonReplacer);
+    }
+    return `${value}`;
+}
+function jsonReplacer(_, value) {
+    if (value instanceof Uint8Array) {
+        return bytesToBase64(value);
+    }
+    else {
+        return value;
+    }
+}
+function mapDefined(inp, mapper) {
+    const res = inp.reduce((acc, v) => {
+        if (v == null) {
+            return acc;
+        }
+        const m = mapper(v);
+        if (m == null) {
+            return acc;
+        }
+        acc.push(m);
+        return acc;
+    }, []);
+    return res.length ? res : null;
+}
+function mapDefinedEntries(inp, mapper) {
+    const acc = [];
+    for (const [k, v] of inp) {
+        if (v == null) {
+            continue;
+        }
+        const m = mapper([k, v]);
+        if (m == null) {
+            continue;
+        }
+        acc.push(m);
+    }
+    return acc.length ? acc : null;
+}
+export function queryJoin(...args) {
+    return args.filter(Boolean).join("&");
+}
+export function queryEncoder(f) {
+    const bulkEncode = function (values, options) {
+        const opts = {
+            ...options,
+            explode: options?.explode ?? true,
+            charEncoding: options?.charEncoding ?? "percent",
+        };
+        const allowEmptySet = new Set(options?.allowEmptyValue ?? []);
+        const encoded = Object.entries(values).map(([key, value]) => {
+            if (allowEmptySet.has(key)) {
+                if (value === undefined
+                    || value === null
+                    || value === ""
+                    || (Array.isArray(value) && value.length === 0)) {
+                    return `${encodeURIComponent(key)}=`;
+                }
+            }
+            return f(key, value, opts);
+        });
+        return queryJoin(...encoded);
+    };
+    return bulkEncode;
+}
+export const encodeJSONQuery = queryEncoder(encodeJSON);
+export const encodeFormQuery = queryEncoder(encodeForm);
+export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
+export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
+export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
+function isBlobLike(val) {
+    if (val instanceof Blob) {
+        return true;
+    }
+    if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+        return false;
+    }
+    const tag = val[Symbol.toStringTag];
+    if (tag !== "Blob" && tag !== "File") {
+        return false;
+    }
+    return "stream" in val && typeof val.stream === "function";
+}
+export function appendForm(fd, key, value, fileName) {
+    if (value == null) {
+        return;
+    }
+    else if (isBlobLike(value)) {
+        if (fileName) {
+            fd.append(key, value, fileName);
+        }
+        else {
+            fd.append(key, value);
+        }
+    }
+    else if (Array.isArray(value)) {
+        value.forEach((v) => {
+            appendForm(fd, key, v);
+        });
+    }
+    else {
+        fd.append(key, String(value));
+    }
+}
+export async function normalizeBlob(value) {
+    if (value instanceof Blob) {
+        return value;
+    }
+    return new Blob([await value.arrayBuffer()], { type: value.type });
+}

package/esm/lib/files.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Consumes a stream and returns a concatenated array buffer. Useful in
+ * situations where we need to read the whole file because it forms part of a
+ * larger payload containing other fields, and we can't modify the underlying
+ * request structure.
+ */
+export declare function readableStreamToArrayBuffer(readable: ReadableStream<Uint8Array>): Promise<ArrayBuffer>;
+/**
+ * Determines the MIME content type based on a file's extension.
+ * Returns null if the extension is not recognized.
+ */
+export declare function getContentTypeFromFileName(fileName: string): string | null;
+/**
+ * Creates a Blob from file content with the given MIME type.
+ *
+ * Node.js Buffers are Uint8Array subclasses that may share a pooled
+ * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
+ * such a Buffer directly to `new Blob([buf])` can include the entire
+ * underlying pool on some runtimes, producing a Blob with extra bytes
+ * that corrupts multipart uploads.
+ *
+ * Copying into a standalone Uint8Array ensures the Blob receives only the
+ * intended bytes regardless of runtime behaviour.
+ */
+export declare function bytesToBlob(content: Uint8Array<ArrayBufferLike> | ArrayBuffer | Blob | string, contentType: string): Blob;

package/esm/lib/files.js

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+/**
+ * Consumes a stream and returns a concatenated array buffer. Useful in
+ * situations where we need to read the whole file because it forms part of a
+ * larger payload containing other fields, and we can't modify the underlying
+ * request structure.
+ */
+export async function readableStreamToArrayBuffer(readable) {
+    const reader = readable.getReader();
+    const chunks = [];
+    let totalLength = 0;
+    let done = false;
+    while (!done) {
+        const { value, done: doneReading } = await reader.read();
+        if (doneReading) {
+            done = true;
+        }
+        else {
+            chunks.push(value);
+            totalLength += value.length;
+        }
+    }
+    const concatenatedChunks = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        concatenatedChunks.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return concatenatedChunks.buffer;
+}
+/**
+ * Determines the MIME content type based on a file's extension.
+ * Returns null if the extension is not recognized.
+ */
+export function getContentTypeFromFileName(fileName) {
+    if (!fileName)
+        return null;
+    const ext = fileName.toLowerCase().split(".").pop();
+    if (!ext)
+        return null;
+    const mimeTypes = {
+        json: "application/json",
+        xml: "application/xml",
+        html: "text/html",
+        htm: "text/html",
+        txt: "text/plain",
+        csv: "text/csv",
+        pdf: "application/pdf",
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        svg: "image/svg+xml",
+        js: "application/javascript",
+        css: "text/css",
+        zip: "application/zip",
+        tar: "application/x-tar",
+        gz: "application/gzip",
+        mp4: "video/mp4",
+        mp3: "audio/mpeg",
+        wav: "audio/wav",
+        webp: "image/webp",
+        ico: "image/x-icon",
+        woff: "font/woff",
+        woff2: "font/woff2",
+        ttf: "font/ttf",
+        otf: "font/otf",
+    };
+    return mimeTypes[ext] || null;
+}
+/**
+ * Creates a Blob from file content with the given MIME type.
+ *
+ * Node.js Buffers are Uint8Array subclasses that may share a pooled
+ * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
+ * such a Buffer directly to `new Blob([buf])` can include the entire
+ * underlying pool on some runtimes, producing a Blob with extra bytes
+ * that corrupts multipart uploads.
+ *
+ * Copying into a standalone Uint8Array ensures the Blob receives only the
+ * intended bytes regardless of runtime behaviour.
+ */
+export function bytesToBlob(content, contentType) {
+    if (content instanceof Uint8Array) {
+        return new Blob([new Uint8Array(content)], { type: contentType });
+    }
+    return new Blob([content], { type: contentType });
+}