@runappsai/sdk 0.0.0-stage → 0.3.0

package/dist/events.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Typed runtime event bus for SDK call telemetry.
+ *
+ * Every LLM-ish service method (chat, embeddings, image, audio, video,
+ * computer) emits start / streamDelta / end / error events on the
+ * shared `client.events` bus so UI overlays (e.g. the bottom-right
+ * identity badge with its activity ring) can render real-time state
+ * without business code having to thread anything through.
+ *
+ * Goals:
+ *   - **Typed**: handler signatures are inferred from the event name.
+ *   - **Zero-cost when nobody listens**: no listeners → emit is a few
+ *     property reads. The browser `EventTarget` does the heavy lifting.
+ *   - **Service-agnostic**: events carry just enough context (id /
+ *     model / capability / token counts) for a generic UI to render
+ *     them without knowing which service fired the call.
+ *
+ * Why a custom wrapper instead of `EventTarget` directly:
+ *   - The native API is untyped (`addEventListener("foo", anyHandler)`).
+ *   - Browser CustomEvent's `detail` payload trick is awkward to read.
+ *   - Subscribers want an `off()` closure, not a separate
+ *     `removeEventListener` call with the same callback reference.
+ */
+/** Capability bucket of the calling service, mirroring /v1/models. */
+export type SDKCapability = "text" | "vision" | "embedding" | "image_generation" | "image_edit" | "text_to_speech" | "speech_to_text" | "video_generation" | "computer_use";
+/** Fired the moment a request hits the wire. */
+export interface RequestStartEvent {
+    /** Stable id correlating start → end/error events for one call. */
+    id: string;
+    /** Model name the caller asked for (NOT the upstream id). */
+    model: string;
+    /** Capability bucket — drives badge icon / colour. */
+    capability: SDKCapability;
+    /** ms since epoch when the request left the SDK. */
+    startedAt: number;
+    /** `true` for stream:true requests so the UI can pre-pick the
+     *  pulsing-ring animation instead of swapping mid-call. */
+    streaming: boolean;
+}
+/** Fired on every stream chunk that carried new content tokens. */
+export interface RequestStreamDeltaEvent {
+    /** Matches the corresponding RequestStartEvent.id. */
+    id: string;
+    /** Approximate completion tokens in THIS chunk (one delta event
+     *  per visible SSE chunk; usage roll-up arrives in end). */
+    deltaTokens: number;
+    /** Cumulative completion tokens since stream start. */
+    totalTokens: number;
+}
+/** Fired once when the call settles successfully. */
+export interface RequestEndEvent {
+    id: string;
+    model: string;
+    capability: SDKCapability;
+    /** Wall-clock from start to settle. */
+    latencyMs: number;
+    /** Final completion tokens (matches the gateway's usage.completion_tokens
+     *  when the response carries it; 0 otherwise). */
+    totalTokens: number;
+    /** USD cost as reported by the gateway's `usage.total_cost`. May be
+     *  undefined for endpoints that don't return cost (rare). */
+    costUSD?: number;
+    /** OpenAI-style stop / length / tool_calls / content_filter, or
+     *  undefined for non-chat endpoints. */
+    finishReason?: string;
+}
+/** Fired once when the call fails — at start, mid-stream, or anywhere. */
+export interface RequestErrorEvent {
+    id: string;
+    model: string;
+    capability: SDKCapability;
+    latencyMs: number;
+    /** The thrown Error (typically `APIError` with statusCode / body). */
+    error: Error;
+    /** HTTP status when known (forwarded from APIError when present). */
+    statusCode?: number;
+}
+/** Compile-time map of event name → payload shape. Drives handler
+ *  inference in `on()` / `emit()` so callers can't subscribe to a
+ *  typo'd name or read a non-existent field. */
+export interface SDKEventMap {
+    "request:start": RequestStartEvent;
+    "request:streamDelta": RequestStreamDeltaEvent;
+    "request:end": RequestEndEvent;
+    "request:error": RequestErrorEvent;
+}
+/** Disposer returned by `on()` — call to unsubscribe. */
+export type Unsubscribe = () => void;
+/**
+ * Lightweight typed event bus. Backed by `EventTarget` so memory
+ * leaks from un-disposed listeners surface in the standard DevTools
+ * memory profile path. In Node we fall back to a plain Map<string,
+ * Set<handler>> since `EventTarget` was only added in Node 15+ and we
+ * still support 14 in places (the SDK targets 18+ but tests sometimes
+ * stub globals).
+ */
+export declare class SDKEvents {
+    private readonly handlers;
+    /**
+     * Subscribe to an event. Returns a disposer; calling the disposer
+     * removes the subscription. Multiple subscriptions to the same
+     * event are supported.
+     */
+    on<K extends keyof SDKEventMap>(name: K, handler: (event: SDKEventMap[K]) => void): Unsubscribe;
+    /**
+     * Fire an event. Handlers run synchronously in subscription order.
+     * Throws inside one handler don't prevent the others from running —
+     * the bus catches and logs (console.error) so a buggy listener can't
+     * take down the rest of the UI.
+     */
+    emit<K extends keyof SDKEventMap>(name: K, payload: SDKEventMap[K]): void;
+    /** Drop all subscriptions. Tests call this between cases. */
+    clear(): void;
+}
+/** Generate a short opaque ID for correlating start/end events.
+ *  Not a UUID — sub-microsecond uniqueness within a session is
+ *  enough, and we want to keep the wire log compact. */
+export declare function newRequestId(): string;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,sEAAsE;AACtE,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,QAAQ,GACR,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,CAAC;AAEnB,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,UAAU,EAAE,aAAa,CAAC;IAC1B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB;+DAC2D;IAC3D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX;gEAC4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,aAAa,CAAC;IAC1B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB;sDACkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB;iEAC6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;4CACwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,aAAa,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,KAAK,CAAC;IACb,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;gDAEgD;AAChD,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,iBAAiB,CAAC;IACnC,qBAAqB,EAAE,uBAAuB,CAAC;IAC/C,aAAa,EAAE,eAAe,CAAC;IAC/B,eAAe,EAAE,iBAAiB,CAAC;CACpC;AAED,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiE;IAE1F;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW;IAa/F;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAezE,6DAA6D;IAC7D,KAAK,IAAI,IAAI;CAGd;AAED;;wDAEwD;AACxD,wBAAgB,YAAY,IAAI,MAAM,CAOrC"}

package/dist/events.js

@@ -0,0 +1,87 @@
+/**
+ * Typed runtime event bus for SDK call telemetry.
+ *
+ * Every LLM-ish service method (chat, embeddings, image, audio, video,
+ * computer) emits start / streamDelta / end / error events on the
+ * shared `client.events` bus so UI overlays (e.g. the bottom-right
+ * identity badge with its activity ring) can render real-time state
+ * without business code having to thread anything through.
+ *
+ * Goals:
+ *   - **Typed**: handler signatures are inferred from the event name.
+ *   - **Zero-cost when nobody listens**: no listeners → emit is a few
+ *     property reads. The browser `EventTarget` does the heavy lifting.
+ *   - **Service-agnostic**: events carry just enough context (id /
+ *     model / capability / token counts) for a generic UI to render
+ *     them without knowing which service fired the call.
+ *
+ * Why a custom wrapper instead of `EventTarget` directly:
+ *   - The native API is untyped (`addEventListener("foo", anyHandler)`).
+ *   - Browser CustomEvent's `detail` payload trick is awkward to read.
+ *   - Subscribers want an `off()` closure, not a separate
+ *     `removeEventListener` call with the same callback reference.
+ */
+/**
+ * Lightweight typed event bus. Backed by `EventTarget` so memory
+ * leaks from un-disposed listeners surface in the standard DevTools
+ * memory profile path. In Node we fall back to a plain Map<string,
+ * Set<handler>> since `EventTarget` was only added in Node 15+ and we
+ * still support 14 in places (the SDK targets 18+ but tests sometimes
+ * stub globals).
+ */
+export class SDKEvents {
+    handlers = new Map();
+    /**
+     * Subscribe to an event. Returns a disposer; calling the disposer
+     * removes the subscription. Multiple subscriptions to the same
+     * event are supported.
+     */
+    on(name, handler) {
+        let set = this.handlers.get(name);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(name, set);
+        }
+        const wrapped = handler;
+        set.add(wrapped);
+        return () => {
+            this.handlers.get(name)?.delete(wrapped);
+        };
+    }
+    /**
+     * Fire an event. Handlers run synchronously in subscription order.
+     * Throws inside one handler don't prevent the others from running —
+     * the bus catches and logs (console.error) so a buggy listener can't
+     * take down the rest of the UI.
+     */
+    emit(name, payload) {
+        const set = this.handlers.get(name);
+        if (!set || set.size === 0)
+            return;
+        for (const h of set) {
+            try {
+                h(payload);
+            }
+            catch (err) {
+                // Listener bug — don't propagate, but surface in the console
+                // so developers notice during integration.
+                // eslint-disable-next-line no-console
+                console.error("[runapps sdk] event listener for", name, "threw:", err);
+            }
+        }
+    }
+    /** Drop all subscriptions. Tests call this between cases. */
+    clear() {
+        this.handlers.clear();
+    }
+}
+/** Generate a short opaque ID for correlating start/end events.
+ *  Not a UUID — sub-microsecond uniqueness within a session is
+ *  enough, and we want to keep the wire log compact. */
+export function newRequestId() {
+    return ("req_" +
+        Date.now().toString(36) +
+        "_" +
+        Math.random().toString(36).slice(2, 8));
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAmFH;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACH,QAAQ,GAAG,IAAI,GAAG,EAAsD,CAAC;IAE1F;;;;OAIG;IACH,EAAE,CAA8B,IAAO,EAAE,OAAwC;QAC/E,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,OAAO,GAAG,OAAqC,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAA8B,IAAO,EAAE,OAAuB;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,CAAC,CAAC,OAAO,CAAC,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6DAA6D;gBAC7D,2CAA2C;gBAC3C,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAED;;wDAEwD;AACxD,MAAM,UAAU,YAAY;IAC1B,OAAO,CACL,MAAM;QACN,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,GAAG;QACH,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC"}

package/dist/files.d.ts

@@ -0,0 +1,218 @@
+import type { Transport } from "./transport.js";
+export interface FileObject {
+    path: string;
+    size: number;
+    content_type?: string;
+    etag?: string;
+    last_modified?: string;
+    url: string;
+}
+export interface FileListResult {
+    files: FileObject[];
+    next_cursor?: string;
+}
+export interface PutOptions {
+    /** Override the MIME type guessed from the path extension. */
+    contentType?: string;
+    /** Refuse to overwrite an existing object (gateway returns 409). */
+    ifNoneMatch?: boolean;
+    /**
+     * Write only if the stored object still has this ETag — the one
+     * `read()` / `stat()` / a previous `put()` returned. Someone else
+     * having written in between makes the gateway answer 412 instead
+     * of silently overwriting their version; re-read, merge, put again.
+     */
+    ifMatch?: string;
+    signal?: AbortSignal;
+}
+/** The bytes at a path together with the version they are. */
+export interface FileRead {
+    blob: Blob;
+    contentType: string;
+    /** Pass back as `ifMatch` to write only if nobody else has since. */
+    etag?: string;
+}
+export interface ListOptions {
+    prefix?: string;
+    cursor?: string;
+    limit?: number;
+    /**
+     * Shell-style pattern, post-filtered after the underlying S3 list:
+     *   *      any chars except `/`
+     *   **     any chars including `/`
+     *   ?      single non-slash char
+     *   [abc]  character class
+     *
+     * Examples:
+     *   client.files.list({ glob: "*.png" })
+     *   client.files.list({ glob: "projects/*\/assets/*.png" })
+     *   client.files.list({ prefix: "projects/", glob: "**\/*.wav" })
+     *
+     * S3 has no native glob — the gateway extracts the longest literal
+     * head of the pattern as the underlying prefix scan, then filters
+     * the rest in process.  Patterns must match the WHOLE path; no
+     * implicit anchoring needed.
+     */
+    glob?: string;
+    signal?: AbortSignal;
+}
+export interface PutFromURLOptions {
+    contentType?: string;
+    ifNoneMatch?: boolean;
+    ifMatch?: string;
+    signal?: AbortSignal;
+}
+export type BatchOp = {
+    op: "put_url";
+    path: string;
+    src_url: string;
+    content_type?: string;
+    if_none_match?: boolean;
+    if_match?: string;
+} | {
+    op: "del";
+    path: string;
+} | {
+    op: "move";
+    from: string;
+    to: string;
+} | {
+    op: "copy";
+    from: string;
+    to: string;
+} | {
+    op: "exists";
+    path: string;
+} | {
+    op: "stat";
+    path: string;
+};
+export interface BatchResult {
+    ok: boolean;
+    error?: string;
+    object?: FileObject;
+    exists?: boolean;
+}
+export declare class FilesService {
+    private readonly transport;
+    /**
+     * URL prefix for every file call.
+     *
+     * When the client was constructed with `project`, requests go to the
+     * project-scoped form — `/v1/p/<project>/files/...` — instead of the
+     * bare `/v1/files/...`.
+     *
+     * This matters because the unscoped URL is byte-identical across apps:
+     * two bundles built from the same template both read
+     * `projects/index.json`, so anything keying on URL alone (starting
+     * with the browser's HTTP cache, which ignores request headers and is
+     * partitioned by registrable domain, not by subdomain) cannot tell
+     * them apart.  Putting the project in the path makes the URL unique
+     * per app.  The gateway still authorizes purely from the token and
+     * rejects a scope that disagrees with it, so this is a correctness
+     * measure, not a permission one.
+     */
+    private readonly base;
+    constructor(transport: Transport, project?: string);
+    /**
+     * Upload `body` to `path`.  Returns the resulting FileObject — its
+     * `url` is the stable public address for that path.
+     *
+     * `body` accepts anything `fetch` accepts as a request body: Blob,
+     * File, ArrayBuffer, ArrayBufferView, FormData (rare here),
+     * ReadableStream, or a string.
+     */
+    put(path: string, body: BodyInit, opts?: PutOptions): Promise<FileObject>;
+    /** Convenience: upload string content with sensible content-type. */
+    putString(path: string, content: string, opts?: PutOptions): Promise<FileObject>;
+    /**
+     * Download the bytes at `path` as a Blob.  Use `URL.createObjectURL`
+     * to get a temporary local URL, or persist the bytes elsewhere.
+     * Bundles that just need to render an asset should use the FileObject's
+     * `.url` directly instead — that's a stable public URL with no token.
+     */
+    get(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<Blob>;
+    /**
+     * Like `get`, but also returns the ETag of the bytes, so a later
+     * `put(path, body, { ifMatch: etag })` writes only if the file is
+     * still the version that was read.
+     */
+    read(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<FileRead>;
+    /**
+     * Read a JSON file and its version in one call. A missing file is
+     * `{ value: undefined, etag: undefined }`, so a first save can pass
+     * `ifNoneMatch: true` and a later one `ifMatch: etag`.
+     */
+    readJSON<T = unknown>(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        value: T | undefined;
+        etag?: string;
+    }>;
+    /** Stat: HEAD-only object metadata. */
+    stat(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<FileObject>;
+    /** Returns true iff the path resolves to an existing object. */
+    exists(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<boolean>;
+    /** Delete the object at `path`.  Idempotent. */
+    del(path: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** List objects.  Pass an empty / omitted prefix for the root. */
+    list(opts?: ListOptions): Promise<FileListResult>;
+    /**
+     * Bulk delete: removes every object whose path starts with `prefix`
+     * AND (when set) matches `glob`.  Returns the count of deleted
+     * objects.  Refuses an empty prefix + empty glob — the caller must
+     * be explicit about wiping the project namespace.
+     *
+     *   client.files.deleteMany({ prefix: "tmp/" })          // wipe a directory
+     *   client.files.deleteMany({ glob: "**\/*.tmp" })       // wipe by pattern
+     *   client.files.deleteMany({ prefix: "logs/", glob: "*.bak" })
+     */
+    deleteMany(opts: {
+        prefix?: string;
+        glob?: string;
+    }, init?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        deleted: number;
+    }>;
+    /** Atomic rename (copy + delete server-side). */
+    move(from: string, to: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<FileObject>;
+    /** Server-side copy. */
+    copy(from: string, to: string, init?: {
+        signal?: AbortSignal;
+    }): Promise<FileObject>;
+    /**
+     * Ask the gateway to fetch `srcURL` and store the body at `path`.
+     * Saves a round trip vs downloading then re-uploading.  `srcURL`
+     * must be a public http(s) URL (private/loopback hosts rejected).
+     */
+    putFromURL(path: string, srcURL: string, opts?: PutFromURLOptions): Promise<FileObject>;
+    /**
+     * Pipeline several file ops in one round trip.  Operations execute
+     * sequentially server-side; one op failing does not abort the rest.
+     * Inspect each result.ok individually.
+     *
+     * Auto-chunks: the gateway caps a single batch at 64 ops and returns
+     * 400 "too many ops" above that.  This method splits long input into
+     * 30-op chunks, awaits each chunk in order, and concatenates the
+     * results — so callers can hand it 1000 ops in a single call.
+     * Chunks run serially (not in parallel) to preserve the
+     * "operations execute in submission order" contract.
+     */
+    batch(ops: BatchOp[], init?: {
+        signal?: AbortSignal;
+    }): Promise<BatchResult[]>;
+}
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,OAAO,GACf;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACnH;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,qBAAa,YAAY;IAqBrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IApB5B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAGX,SAAS,EAAE,SAAS,EACrC,OAAO,CAAC,EAAE,MAAM;IAOlB;;;;;;;OAOG;IACG,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,UAAU,CAAC;IAWtB,qEAAqE;IAC/D,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,UAAU,CAAC;IAOtB;;;;;OAKG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAS5E;;;;OAIG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC;QAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAcnD,uCAAuC;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB9E,gEAAgE;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7E,gDAAgD;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,kEAAkE;IAC5D,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAavD;;;;;;;;;OASG;IACG,UAAU,CACd,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EACxC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ/B,iDAAiD;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1F,wBAAwB;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1F;;;;OAIG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,UAAU,CAAC;IActB;;;;;;;;;;;OAWG;IACG,KAAK,CACT,GAAG,EAAE,OAAO,EAAE,EACd,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC;CAuB1B"}

package/dist/files.js

@@ -0,0 +1,212 @@
+// Per-project file system at /v1/files/*.  Files are stored under
+// (user, project) on the gateway and addressed by POSIX-style paths.
+// Each FileObject's `url` is a stable public address — embed it
+// directly in `<img src>`, share it, persist it.
+//
+// The bundle's RunApps client uses `client.files` to access these
+// endpoints; the underlying token must be a project-bound resource
+// token (rrt_*) issued by the grant flow.
+function pathToURL(base, p) {
+    const trimmed = p.replace(/^\/+/, "");
+    return base + "/" + trimmed.split("/").map(encodeURIComponent).join("/");
+}
+export class FilesService {
+    transport;
+    /**
+     * URL prefix for every file call.
+     *
+     * When the client was constructed with `project`, requests go to the
+     * project-scoped form — `/v1/p/<project>/files/...` — instead of the
+     * bare `/v1/files/...`.
+     *
+     * This matters because the unscoped URL is byte-identical across apps:
+     * two bundles built from the same template both read
+     * `projects/index.json`, so anything keying on URL alone (starting
+     * with the browser's HTTP cache, which ignores request headers and is
+     * partitioned by registrable domain, not by subdomain) cannot tell
+     * them apart.  Putting the project in the path makes the URL unique
+     * per app.  The gateway still authorizes purely from the token and
+     * rejects a scope that disagrees with it, so this is a correctness
+     * measure, not a permission one.
+     */
+    base;
+    constructor(transport, project) {
+        this.transport = transport;
+        this.base = project
+            ? "/v1/p/" + encodeURIComponent(project) + "/files"
+            : "/v1/files";
+    }
+    /**
+     * Upload `body` to `path`.  Returns the resulting FileObject — its
+     * `url` is the stable public address for that path.
+     *
+     * `body` accepts anything `fetch` accepts as a request body: Blob,
+     * File, ArrayBuffer, ArrayBufferView, FormData (rare here),
+     * ReadableStream, or a string.
+     */
+    async put(path, body, opts) {
+        const headers = {};
+        if (opts?.ifNoneMatch)
+            headers["If-None-Match"] = "*";
+        if (opts?.ifMatch)
+            headers["If-Match"] = `"${opts.ifMatch.replace(/"/g, "")}"`;
+        return this.transport.putBytes(pathToURL(this.base, path), body, {
+            contentType: opts?.contentType,
+            headers: Object.keys(headers).length ? headers : undefined,
+            signal: opts?.signal,
+        });
+    }
+    /** Convenience: upload string content with sensible content-type. */
+    async putString(path, content, opts) {
+        return this.put(path, content, {
+            ...opts,
+            contentType: opts?.contentType ?? "text/plain; charset=utf-8",
+        });
+    }
+    /**
+     * Download the bytes at `path` as a Blob.  Use `URL.createObjectURL`
+     * to get a temporary local URL, or persist the bytes elsewhere.
+     * Bundles that just need to render an asset should use the FileObject's
+     * `.url` directly instead — that's a stable public URL with no token.
+     */
+    async get(path, init) {
+        return (await this.read(path, init)).blob;
+    }
+    /**
+     * Like `get`, but also returns the ETag of the bytes, so a later
+     * `put(path, body, { ifMatch: etag })` writes only if the file is
+     * still the version that was read.
+     */
+    async read(path, init) {
+        const { data, contentType, etag } = await this.transport.getRaw(pathToURL(this.base, path), init);
+        return {
+            blob: new Blob([new Uint8Array(data)], { type: contentType || "application/octet-stream" }),
+            contentType,
+            etag,
+        };
+    }
+    /**
+     * Read a JSON file and its version in one call. A missing file is
+     * `{ value: undefined, etag: undefined }`, so a first save can pass
+     * `ifNoneMatch: true` and a later one `ifMatch: etag`.
+     */
+    async readJSON(path, init) {
+        let r;
+        try {
+            r = await this.read(path, init);
+        }
+        catch (e) {
+            if (e?.statusCode === 404 ||
+                e?.status === 404) {
+                return { value: undefined, etag: undefined };
+            }
+            throw e;
+        }
+        return { value: JSON.parse(await r.blob.text()), etag: r.etag };
+    }
+    /** Stat: HEAD-only object metadata. */
+    async stat(path, init) {
+        const { status, headers } = await this.transport.head(pathToURL(this.base, path), init);
+        if (status === 404) {
+            throw Object.assign(new Error("not found"), { status: 404 });
+        }
+        if (status >= 400) {
+            throw Object.assign(new Error("stat failed"), { status });
+        }
+        const size = parseInt(headers.get("content-length") ?? "0", 10);
+        return {
+            path: headers.get("x-file-path") ?? path,
+            size,
+            content_type: headers.get("content-type") ?? undefined,
+            etag: (headers.get("etag") ?? "").replace(/"/g, "") || undefined,
+            url: headers.get("x-file-url") ?? "",
+        };
+    }
+    /** Returns true iff the path resolves to an existing object. */
+    async exists(path, init) {
+        const { status } = await this.transport.head(pathToURL(this.base, path), init);
+        return status >= 200 && status < 400;
+    }
+    /** Delete the object at `path`.  Idempotent. */
+    async del(path, init) {
+        await this.transport.deletePath(pathToURL(this.base, path), init);
+    }
+    /** List objects.  Pass an empty / omitted prefix for the root. */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.prefix)
+            params.set("prefix", opts.prefix);
+        if (opts?.cursor)
+            params.set("cursor", opts.cursor);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.glob)
+            params.set("glob", opts.glob);
+        const qs = params.toString();
+        return this.transport.getJSON(this.base + (qs ? "?" + qs : ""), opts?.signal ? { signal: opts.signal } : undefined);
+    }
+    /**
+     * Bulk delete: removes every object whose path starts with `prefix`
+     * AND (when set) matches `glob`.  Returns the count of deleted
+     * objects.  Refuses an empty prefix + empty glob — the caller must
+     * be explicit about wiping the project namespace.
+     *
+     *   client.files.deleteMany({ prefix: "tmp/" })          // wipe a directory
+     *   client.files.deleteMany({ glob: "**\/*.tmp" })       // wipe by pattern
+     *   client.files.deleteMany({ prefix: "logs/", glob: "*.bak" })
+     */
+    async deleteMany(opts, init) {
+        return this.transport.postJSON(this.base + "/delete", { prefix: opts.prefix ?? "", glob: opts.glob ?? "" }, init);
+    }
+    /** Atomic rename (copy + delete server-side). */
+    async move(from, to, init) {
+        return this.transport.postJSON(this.base + "/move", { from, to }, init);
+    }
+    /** Server-side copy. */
+    async copy(from, to, init) {
+        return this.transport.postJSON(this.base + "/copy", { from, to }, init);
+    }
+    /**
+     * Ask the gateway to fetch `srcURL` and store the body at `path`.
+     * Saves a round trip vs downloading then re-uploading.  `srcURL`
+     * must be a public http(s) URL (private/loopback hosts rejected).
+     */
+    async putFromURL(path, srcURL, opts) {
+        return this.transport.postJSON(this.base + "/put-url", {
+            path,
+            src_url: srcURL,
+            content_type: opts?.contentType,
+            if_none_match: opts?.ifNoneMatch,
+            if_match: opts?.ifMatch,
+        }, opts?.signal ? { signal: opts.signal } : undefined);
+    }
+    /**
+     * Pipeline several file ops in one round trip.  Operations execute
+     * sequentially server-side; one op failing does not abort the rest.
+     * Inspect each result.ok individually.
+     *
+     * Auto-chunks: the gateway caps a single batch at 64 ops and returns
+     * 400 "too many ops" above that.  This method splits long input into
+     * 30-op chunks, awaits each chunk in order, and concatenates the
+     * results — so callers can hand it 1000 ops in a single call.
+     * Chunks run serially (not in parallel) to preserve the
+     * "operations execute in submission order" contract.
+     */
+    async batch(ops, init) {
+        if (ops.length === 0)
+            return [];
+        const chunkSize = 30;
+        if (ops.length <= chunkSize) {
+            const resp = await this.transport.postJSON(this.base + "/batch", { ops }, init);
+            return resp.results;
+        }
+        const all = [];
+        for (let i = 0; i < ops.length; i += chunkSize) {
+            const chunk = ops.slice(i, i + chunkSize);
+            const resp = await this.transport.postJSON(this.base + "/batch", { ops: chunk }, init);
+            all.push(...resp.results);
+        }
+        return all;
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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