@runappsai/sdk 0.0.0-stage → 0.3.0

package/dist/validate.js

@@ -0,0 +1,329 @@
+// Generic validator for the gateway's options schema. Mirrors
+// /Users/zero/repos/sdk-go/validate.go — three-pass algorithm,
+// same field/constraint vocabulary, same parse logic.
+import { normalizeGroups } from "./model_options.js";
+/**
+ * Three-pass validator: per-field type/enum/bounds → per-field
+ * presence → cross-field constraints. Unknown fields in `req`
+ * (vendor passthroughs) are silently ignored — the gateway still
+ * validates them server-side if it cares.
+ *
+ * Returns an empty array on success, or a flat list of all
+ * validation failures so the UI can surface them at once.
+ */
+export function validateRequest(schema, req = {}) {
+    if (!schema)
+        return [];
+    const errors = [];
+    // Pass 1+2: per-field.
+    if (schema.inputs) {
+        for (const [name, field] of Object.entries(schema.inputs)) {
+            const set = name in req;
+            const val = req[name];
+            if (set && !isEmpty(val)) {
+                errors.push(...validateFieldValue(name, field, val));
+            }
+            else if (set && field.min_items !== undefined) {
+                // Empty array trips min_items even when isEmpty() short-
+                // circuits validateFieldValue. Mirrors the sdk-go fix: bound
+                // was declared explicitly, dropping it silently would let a
+                // client POST `groups: []` to a schema that requires >=1.
+                if (Array.isArray(val) && val.length < field.min_items) {
+                    errors.push({ field: name, reason: `at least ${field.min_items} items` });
+                }
+            }
+            errors.push(...validatePresence(name, field, val, set));
+        }
+    }
+    // Pass 3: cross-field.
+    for (const c of schema.constraints ?? []) {
+        errors.push(...validateConstraint(c, req));
+    }
+    return errors;
+}
+function validateFieldValue(name, field, val) {
+    const errors = [];
+    if (!typeMatches(field.type, val)) {
+        errors.push({
+            field: name,
+            reason: `expected type ${field.type}, got ${describeType(val)}`,
+        });
+        return errors; // bail early — bound/enum checks need correct type
+    }
+    if (field.enum && field.enum.length > 0 && !inEnum(val, field.enum)) {
+        errors.push({
+            field: name,
+            reason: `must be one of ${JSON.stringify(field.enum)}`,
+        });
+    }
+    if (field.type === "int" || field.type === "float") {
+        const n = numberValue(val);
+        if (n !== null) {
+            if (field.min !== undefined && n < field.min) {
+                errors.push({ field: name, reason: `must be >= ${field.min}` });
+            }
+            if (field.max !== undefined && n > field.max) {
+                errors.push({ field: name, reason: `must be <= ${field.max}` });
+            }
+        }
+    }
+    // Array bounds — apply to scalar array Types ("url[]", "string[]")
+    // AND to `repeatable` object groups whose value is a JSON array.
+    if (Array.isArray(val)) {
+        if (field.max_items !== undefined && val.length > field.max_items) {
+            errors.push({
+                field: name,
+                reason: `at most ${field.max_items} items`,
+            });
+        }
+        if (field.min_items !== undefined && val.length < field.min_items) {
+            errors.push({
+                field: name,
+                reason: `at least ${field.min_items} items`,
+            });
+        }
+    }
+    // Nested object recursion. `field.fields` declares a structured
+    // sub-object; with `repeatable: true` the wire value is an array of
+    // such objects. Errors carry a dotted path like
+    // "groups[1].prompt: required" so callers see the offending row.
+    // `ui.show_when` is deliberately NOT honoured at validation time —
+    // it's a UI hint only; conditionally-hidden fields are still
+    // subject to the same checks if a client sends them.
+    if (field.fields) {
+        if (field.repeatable) {
+            if (!Array.isArray(val)) {
+                errors.push({
+                    field: name,
+                    reason: `expected array of objects, got ${describeType(val)}`,
+                });
+            }
+            else {
+                val.forEach((item, i) => {
+                    if (typeof item !== "object" || item === null || Array.isArray(item)) {
+                        errors.push({
+                            field: `${name}[${i}]`,
+                            reason: `expected object, got ${describeType(item)}`,
+                        });
+                        return;
+                    }
+                    errors.push(...validateObject(`${name}[${i}]`, field.fields, item));
+                });
+            }
+        }
+        else {
+            if (typeof val !== "object" || val === null || Array.isArray(val)) {
+                errors.push({
+                    field: name,
+                    reason: `expected object, got ${describeType(val)}`,
+                });
+            }
+            else {
+                errors.push(...validateObject(name, field.fields, val));
+            }
+        }
+    }
+    return errors;
+}
+/** validateObject runs per-field validation against a sub-schema's
+ *  `fields` map for one object value. Errors return with
+ *  `<pathPrefix>.<innerName>` so the caller sees the full nested path. */
+function validateObject(pathPrefix, fields, obj) {
+    const errors = [];
+    for (const [innerName, innerField] of Object.entries(fields)) {
+        const childPath = `${pathPrefix}.${innerName}`;
+        const val = obj[innerName];
+        const set = innerName in obj;
+        if (set && !isEmpty(val)) {
+            errors.push(...validateFieldValue(childPath, innerField, val));
+        }
+        errors.push(...validatePresence(childPath, innerField, val, set));
+    }
+    return errors;
+}
+function validatePresence(name, field, val, set) {
+    const presence = field.presence ?? "optional";
+    if (presence === "required" && (!set || isEmpty(val))) {
+        return [{ field: name, reason: "required" }];
+    }
+    if (presence === "forbidden" && set && !isEmpty(val)) {
+        return [{ field: name, reason: "must not be set for this model" }];
+    }
+    return [];
+}
+function validateConstraint(c, req) {
+    switch (c.kind) {
+        case "any_of_required": {
+            const fields = c.fields ?? [];
+            const anySet = fields.some((f) => f in req && !isEmpty(req[f]));
+            if (anySet)
+                return [];
+            return [
+                {
+                    field: fields.join("/"),
+                    reason: `at least one of ${fields.join(", ")} is required`,
+                },
+            ];
+        }
+        case "mutually_exclusive": {
+            const fields = c.fields ?? [];
+            const setFields = fields.filter((f) => f in req && !isEmpty(req[f]));
+            if (setFields.length > 1) {
+                return [
+                    {
+                        field: setFields.join("/"),
+                        reason: `at most one of ${fields.join(", ")} may be set (got: ${setFields.join(", ")})`,
+                    },
+                ];
+            }
+            return [];
+        }
+        case "group_mutex": {
+            // Best-effort: enforce only the anonymous "at most one group
+            // active" rule for both shapes. The strict discriminator-based
+            // check (validating `c.name`'s value + rejecting non-active
+            // group fields) lives in the gateway only — SDK validation
+            // stays a fast pre-flight hint, not a contract enforcer, so we
+            // avoid doubling the maintenance surface across SDKs.
+            const groups = normalizeGroups(c.groups);
+            const activeGroups = [];
+            const activeFields = [];
+            for (const g of groups) {
+                const setHere = g.fields.filter((f) => f in req && !isEmpty(req[f]));
+                if (setHere.length > 0) {
+                    activeGroups.push(g);
+                    activeFields.push(...setHere);
+                }
+            }
+            if (activeGroups.length > 1) {
+                const labels = groups.map((g) => `[${g.fields.join("+")}]`).join(" or ");
+                return [
+                    {
+                        field: activeFields.join("/"),
+                        reason: `at most one of ${labels} may be used (got: ${activeFields.join(", ")})`,
+                    },
+                ];
+            }
+            return [];
+        }
+        case "requires_all": {
+            const whenName = c.when;
+            if (!whenName)
+                return [];
+            const whenSet = whenName in req && !isEmpty(req[whenName]);
+            if (!whenSet)
+                return [];
+            const missing = (c.then ?? []).filter((f) => !(f in req) || isEmpty(req[f]));
+            if (missing.length === 0)
+                return [];
+            return [
+                {
+                    field: missing.join("/"),
+                    reason: `required when ${whenName} is set`,
+                },
+            ];
+        }
+        case "pixel_bounds": {
+            const fieldName = c.fields?.[0];
+            if (!fieldName)
+                return [];
+            const raw = req[fieldName];
+            if (typeof raw !== "string" || raw === "")
+                return [];
+            const dims = parsePixelDims(raw);
+            if (!dims) {
+                return [{ field: fieldName, reason: `expected WxH dimensions, got "${raw}"` }];
+            }
+            const [w, h] = dims;
+            const px = w * h;
+            const errs = [];
+            if (c.min !== undefined && px < c.min) {
+                errs.push({
+                    field: fieldName,
+                    reason: `image too small: ${w}x${h} = ${px} pixels, minimum ${c.min}`,
+                });
+            }
+            if (c.max !== undefined && px > c.max) {
+                errs.push({
+                    field: fieldName,
+                    reason: `image too large: ${w}x${h} = ${px} pixels, maximum ${c.max}`,
+                });
+            }
+            return errs;
+        }
+    }
+    // Unknown constraint kind — skip (forward-compat).
+    return [];
+}
+// ─── Type helpers ────────────────────────────────────────────────────
+function typeMatches(typ, val) {
+    switch (typ) {
+        case "string":
+            return typeof val === "string";
+        case "int":
+        case "float":
+            return numberValue(val) !== null;
+        case "bool":
+            return typeof val === "boolean";
+        case "url":
+            return typeof val === "string" && isURLLike(val);
+        case "url[]":
+            return Array.isArray(val) && val.every((v) => typeof v === "string" && isURLLike(v));
+        case "string[]":
+            return Array.isArray(val) && val.every((v) => typeof v === "string");
+        case "file":
+            return true; // multipart — can't validate
+        default:
+            return true; // unknown type — forward-compat
+    }
+}
+function describeType(val) {
+    if (val === null)
+        return "null";
+    if (Array.isArray(val))
+        return "array";
+    return typeof val;
+}
+function numberValue(val) {
+    if (typeof val === "number" && Number.isFinite(val))
+        return val;
+    return null;
+}
+function isURLLike(s) {
+    return s.startsWith("http://") || s.startsWith("https://") || s.startsWith("data:");
+}
+function isEmpty(val) {
+    if (val === undefined || val === null)
+        return true;
+    if (typeof val === "string")
+        return val === "";
+    if (Array.isArray(val))
+        return val.length === 0;
+    return false;
+}
+function inEnum(val, enumVals) {
+    for (const e of enumVals) {
+        if (equalLoose(val, e))
+            return true;
+    }
+    return false;
+}
+function equalLoose(a, b) {
+    // Numbers compared as JS numbers (already float64-equivalent);
+    // strings/bools by ===.
+    return a === b;
+}
+function parsePixelDims(s) {
+    for (const sep of ["x", "X", "*", "×"]) {
+        const idx = s.indexOf(sep);
+        if (idx <= 0)
+            continue;
+        const w = parseInt(s.slice(0, idx).trim(), 10);
+        const h = parseInt(s.slice(idx + sep.length).trim(), 10);
+        if (Number.isFinite(w) && Number.isFinite(h) && w > 0 && h > 0) {
+            return [w, h];
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/video.d.ts

@@ -0,0 +1,134 @@
+import type { Transport } from "./transport.js";
+import type { Usage } from "./types.js";
+import type { SDKEvents } from "./events.js";
+/**
+ * Video generation params. Most fields map 1:1 to the gateway's
+ * `/v1/videos/generations` body. Optional booleans (`generate_audio`,
+ * `watermark`, `camera_fixed`, `return_last_frame`, `draft`) are
+ * tri-state — omit to use the upstream default; explicit `false`
+ * forces off.
+ */
+export interface VideoGenerateParams {
+    prompt: string;
+    aspect_ratio?: string;
+    duration?: number;
+    resolution?: string;
+    generate_audio?: boolean;
+    /**
+     * First / last frame keyframes (image-to-video). Each accepts:
+     *   - hosted https:// URL
+     *   - data:image/...;base64,<payload> URI (use `encodeImageUrl`)
+     *
+     * The previous `first_frame_b64` / `last_frame_b64` sibling fields
+     * were removed — wrap raw bytes in a data: URI client-side via
+     * `encodeImageUrl` and pass through `*_url` instead.
+     */
+    first_frame_url?: string;
+    last_frame_url?: string;
+    /**
+     * Multimodal reference inputs (Seedance 2.0). Each entry can be a
+     * hosted URL or a data: URI (use `encodeImageUrl` for raw bytes).
+     * `reference_images_b64` was removed — fold any raw-base64 entries
+     * into `reference_image_urls` as data: URIs.
+     */
+    reference_image_urls?: string[];
+    reference_video_urls?: string[];
+    reference_audio_urls?: string[];
+    /** Single-input drivers (video-edit / motion-transfer / lip-sync). */
+    source_video_url?: string;
+    source_image_url?: string;
+    source_audio_url?: string;
+    watermark?: boolean;
+    camera_fixed?: boolean;
+    return_last_frame?: boolean;
+    seed?: number;
+    /** Alternative to `duration` for Seedance 1.0 pro / lite. */
+    frames?: number;
+    /** Seedance 1.5 pro Draft Mode. */
+    draft?: boolean;
+    draft_task_id?: string;
+    /** "flex" = offline (~50% price); pair with execution_expires_after. */
+    service_tier?: string;
+    execution_expires_after?: number;
+    /** Webhook for state-transition notifications. */
+    callback_url?: string;
+    user?: string;
+    /** Pass-through for provider-specific knobs. */
+    [extra: string]: unknown;
+}
+export interface VideoTask {
+    id: string;
+    status: string;
+    usage: Usage;
+}
+export interface VideoUsageTokens {
+    completion_tokens?: number;
+    total_tokens?: number;
+}
+export interface VideoStatus {
+    id: string;
+    status: string;
+    progress: number;
+    video_url?: string;
+    error?: string;
+    /** Final frame as a separate image — populated when return_last_frame=true. */
+    last_frame_url?: string;
+    /** Seedance Draft Mode Step1 task id, exposed when the draft succeeds. */
+    draft_task_id?: string;
+    duration?: number;
+    fps?: number;
+    resolution?: string;
+    ratio?: string;
+    seed?: number;
+    service_tier?: string;
+    /** Upstream-reported tokens (Seedance bills per output token). */
+    usage_tokens?: VideoUsageTokens;
+    created_at?: number;
+    updated_at?: number;
+    /**
+     * Human-readable credit line that the client SHOULD display alongside
+     * the video. Populated by stock-library models (Pexels) whose terms
+     * of service require crediting the contributor; AI generators leave
+     * it empty. Render verbatim — don't try to parse the format. See
+     * ImageResult.attribution for the same convention.
+     */
+    attribution?: string;
+}
+export interface WaitOptions {
+    /** Defaults to 5000ms. */
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+}
+export declare class VideoService {
+    private readonly transport;
+    private readonly events;
+    constructor(transport: Transport, events: SDKEvents);
+    /** Submit a video generation task.
+     *
+     * Telemetry note: only the submit step fires start/end on
+     * `client.events` — the per-call latency reflects the gateway
+     * accepting the job, NOT how long upstream takes to render. The
+     * caller's poll loop sees status flips but the SDK doesn't emit
+     * end events for those (would otherwise leave the badge "active"
+     * for as long as the upstream renders, sometimes minutes). */
+    generate(model: string, params: VideoGenerateParams, init?: {
+        signal?: AbortSignal;
+    }): Promise<VideoTask>;
+    /** Fetch the current status of a task. */
+    getStatus(taskID: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<VideoStatus>;
+    /**
+     * Poll `getStatus()` until the task reaches a terminal state
+     * (`succeeded` / `failed`). Default poll interval is 5s.
+     */
+    wait(taskID: string, opts?: WaitOptions): Promise<VideoStatus>;
+    /** Download the raw video bytes for a completed task. */
+    getContent(taskID: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        data: Uint8Array;
+        contentType: string;
+    }>;
+}
+//# sourceMappingURL=video.d.ts.map

package/dist/video.d.ts.map

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

package/dist/video.js

@@ -0,0 +1,60 @@
+import { wrapEvents } from "./event-wrap.js";
+export class VideoService {
+    transport;
+    events;
+    constructor(transport, events) {
+        this.transport = transport;
+        this.events = events;
+    }
+    /** Submit a video generation task.
+     *
+     * Telemetry note: only the submit step fires start/end on
+     * `client.events` — the per-call latency reflects the gateway
+     * accepting the job, NOT how long upstream takes to render. The
+     * caller's poll loop sees status flips but the SDK doesn't emit
+     * end events for those (would otherwise leave the badge "active"
+     * for as long as the upstream renders, sometimes minutes). */
+    async generate(model, params, init) {
+        return wrapEvents(this.events, { model, capability: "video_generation" }, () => this.transport.postJSON("/v1/videos/generations", { model, ...params }, init));
+    }
+    /** Fetch the current status of a task. */
+    async getStatus(taskID, init) {
+        return this.transport.getJSON(`/v1/videos/generations/${encodeURIComponent(taskID)}`, init);
+    }
+    /**
+     * Poll `getStatus()` until the task reaches a terminal state
+     * (`succeeded` / `failed`). Default poll interval is 5s.
+     */
+    async wait(taskID, opts = {}) {
+        const interval = opts.pollIntervalMs ?? 5000;
+        while (true) {
+            const status = await this.getStatus(taskID, { signal: opts.signal });
+            if (status.status === "succeeded" || status.status === "failed") {
+                return status;
+            }
+            await sleep(interval, opts.signal);
+        }
+    }
+    /** Download the raw video bytes for a completed task. */
+    async getContent(taskID, init) {
+        return this.transport.getRaw(`/v1/videos/${encodeURIComponent(taskID)}/content`, init);
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error("aborted"));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason ?? new Error("aborted"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=video.js.map

package/dist/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA8H7C,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAAoB,EACpB,MAAiB;QADjB,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAW;IACjC,CAAC;IAEJ;;;;;;;kEAO8D;IAC9D,KAAK,CAAC,QAAQ,CACZ,KAAa,EACb,MAA2B,EAC3B,IAA+B;QAE/B,OAAO,UAAU,CACf,IAAI,CAAC,MAAM,EACX,EAAE,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,EACzC,GAAG,EAAE,CACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,wBAAwB,EACxB,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,EACpB,IAAI,CACL,CACJ,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,SAAS,CACb,MAAc,EACd,IAA+B;QAE/B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3B,0BAA0B,kBAAkB,CAAC,MAAM,CAAC,EAAE,EACtD,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,OAAoB,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;QAC7C,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChE,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,UAAU,CACd,MAAc,EACd,IAA+B;QAE/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAC1B,cAAc,kBAAkB,CAAC,MAAM,CAAC,UAAU,EAClD,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAO,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@runappsai/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "JavaScript / TypeScript client for the RunApps AI Gateway",
+  "license": "MIT",
+  "author": "RunApps",
+  "homepage": "https://github.com/runjobsai/sdk-js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runjobsai/sdk-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/runjobsai/sdk-js/issues"
+  },
+  "keywords": [
+    "runapps",
+    "ai",
+    "llm",
+    "gateway",
+    "sdk",
+    "openai-compatible"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/sdk.umd.js",
+  "jsdelivr": "./dist/sdk.umd.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": "./dist/sdk.umd.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsup",
+    "clean": "rm -rf dist",
+    "prepare": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "npm run build && node --test tests/*.test.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.5.0"
+  }
+}