@lotics/app-sdk 0.100.1 → 0.101.0

package/dist/src/select.d.ts

@@ -1,48 +0,0 @@
-/**
- * Reader for `select` cells in `useQuery` rows.
- *
- * The server (`backend/lib/select_option_resolver.ts`) rewrites every
- * `select` column from its storage shape (`string[]` of bare `opt_*` keys)
- * into `ResolvedOption[]` before the row reaches the app. Apps used to
- * hardcode an `opt_* → label` map because the SDK didn't expose the resolved
- * shape; this helper makes the right shape the obvious one.
- *
- * If the wire format changes, the resolver and this reader move together.
- */
-export interface ResolvedOption {
-    key: string;
-    /** Option display name. Falls back to the key when the option was deleted
-     *  after the cell was written — surfaces the stale state explicitly. */
-    label: string;
-    /**
-     * Named palette color token (e.g. `"blue"`, `"emerald"`). Populated by
-     * `useFieldOptions` (which reads the field config); absent on options read
-     * back from a query CELL via `readSelect` — a cell carries only key + label.
-     * Pass the resolved option straight to `@lotics/ui`'s `Status`, which
-     * degrades a missing/unknown token to a neutral badge.
-     */
-    color?: string;
-    /**
-     * The option's own mark, where its field gives one to every option — the
-     * channel it IS (`brand`, a `BrandMark` name) or a glyph (`icon`, a kit icon
-     * name). Populated by `useFieldOptions` like `color`, absent on a cell. Pass
-     * the option to `@lotics/ui`'s `Status`, which draws it in the dot's place and
-     * degrades a name its build does not draw to the dot.
-     */
-    mark?: {
-        kind: "brand";
-        name: string;
-    } | {
-        kind: "icon";
-        name: string;
-    };
-}
-/**
- * Parse a `useQuery` cell value into `ResolvedOption[]`. Returns `[]` for
- * null/undefined/empty cells and for any unexpected shape — callers iterate
- * uniformly without null-checks. A bare-string entry (a column whose source
- * options couldn't be resolved server-side) becomes `{ key, label: key }` so
- * single-value reads still work. Entries that fail the shape check are
- * dropped silently rather than corrupting the array with partial data.
- */
-export declare function readSelect(value: unknown): ResolvedOption[];

package/dist/src/select.js

@@ -1,40 +0,0 @@
-/**
- * Reader for `select` cells in `useQuery` rows.
- *
- * The server (`backend/lib/select_option_resolver.ts`) rewrites every
- * `select` column from its storage shape (`string[]` of bare `opt_*` keys)
- * into `ResolvedOption[]` before the row reaches the app. Apps used to
- * hardcode an `opt_* → label` map because the SDK didn't expose the resolved
- * shape; this helper makes the right shape the obvious one.
- *
- * If the wire format changes, the resolver and this reader move together.
- */
-/**
- * Parse a `useQuery` cell value into `ResolvedOption[]`. Returns `[]` for
- * null/undefined/empty cells and for any unexpected shape — callers iterate
- * uniformly without null-checks. A bare-string entry (a column whose source
- * options couldn't be resolved server-side) becomes `{ key, label: key }` so
- * single-value reads still work. Entries that fail the shape check are
- * dropped silently rather than corrupting the array with partial data.
- */
-export function readSelect(value) {
-    if (!Array.isArray(value))
-        return [];
-    const out = [];
-    for (const entry of value) {
-        if (typeof entry === "string") {
-            if (entry !== "")
-                out.push({ key: entry, label: entry });
-            continue;
-        }
-        if (!entry || typeof entry !== "object")
-            continue;
-        const obj = entry;
-        const key = obj.key;
-        if (typeof key !== "string" || key === "")
-            continue;
-        const label = typeof obj.label === "string" ? obj.label : key;
-        out.push({ key, label });
-    }
-    return out;
-}

package/dist/src/types.d.ts

@@ -1,115 +0,0 @@
-/**
- * App-specific workflow augmentation point.
- *
- * The base SDK ships `AppWorkflows` empty — `useWorkflow(alias)` accepts any
- * string at runtime. Per-app codegen (folded into `lotics app pull`) emits a
- * file that augments this interface with the aliases declared in the app's
- * `package.json` lotics.workflows, giving compile-time autocomplete +
- * "undeclared alias" errors:
- *
- * ```ts
- * // .lotics/app_workflows.d.ts (generated)
- * import "@lotics/app-sdk";
- * declare module "@lotics/app-sdk" {
- *   interface AppWorkflows {
- *     "issueInvoiceStorageDrop": { record_id: string };
- *     "issueInvoiceReuseLift": Record<string, never>;
- *   }
- * }
- * ```
- *
- * The value type is the workflow's declared input shape — `Record<string, never>`
- * for a workflow that takes no typed inputs, the typed object otherwise.
- */
-export interface AppWorkflows {
-}
-/**
- * App-specific workflow-RESULT augmentation point. Same pattern as AppWorkflows,
- * but maps each alias to the type of the `data` its workflow returns via
- * `return({ data })` — derived from the alias's declared `outputs` schema.
- *
- * The base SDK ships it empty, so `useWorkflow(alias)` resolves `result.data` as
- * `unknown`. Per-app codegen augments it for aliases that declare `outputs`:
- *
- * ```ts
- * // .lotics/app_workflows.d.ts (generated)
- * declare module "@lotics/app-sdk" {
- *   interface AppWorkflowResults {
- *     "computeQuote": { total: number; lines: ReadonlyArray<{ name: string; amount: number }> };
- *   }
- * }
- * ```
- *
- * An alias absent from this map (no declared `outputs`) gets `result.data: unknown`.
- */
-export interface AppWorkflowResults {
-}
-/**
- * App-specific named-query augmentation point. Same pattern as AppWorkflows.
- *
- * The base SDK ships `AppQueries` empty — `useQuery(alias)` accepts any string
- * at runtime. Per-app codegen (`lotics app pull`) emits a file that augments
- * this interface with the queries declared in the app's `package.json`
- * lotics.queries, mapping each alias to its declared param type:
- *
- * ```ts
- * // .lotics/app_queries.d.ts (generated)
- * import "@lotics/app-sdk";
- * declare module "@lotics/app-sdk" {
- *   interface AppQueries {
- *     "openOrders": { status: string };
- *     "allContainers": Record<string, never>;
- *   }
- * }
- * ```
- *
- * The value type is the query's declared param shape — `Record<string, never>`
- * for a query that takes no params, the typed object otherwise.
- */
-export interface AppQueries {
-}
-/**
- * The OUTPUT COLUMN NAMES each query projects — the same codegen, from the same
- * manifest, as a literal union per alias:
- *
- * ```ts
- * declare module "@lotics/app-sdk" {
- *   interface AppQueryColumns {
- *     "openOrders": "id" | "customer" | "total";
- *   }
- * }
- * ```
- *
- * A runtime `filter` / `sort` `field_key` is typed against it, so a column the
- * query does not carry is a `tsc` error instead of the server's request-time
- * refusal. An alias is ABSENT when its names cannot be read off the AST alone
- * (a bare `from_table`); its key stays `string` and the server's check is the
- * only one — a union that could be wrong is worse than none.
- */
-export interface AppQueryColumns {
-}
-/**
- * App-specific AGENT augmentation point — same pattern as `AppWorkflows`, for
- * the streaming agents declared in `package.json` lotics.agents and invoked via
- * `useAgentRun(alias)`. Per-app codegen maps each alias to its declared input
- * shape, so an undeclared alias is a compile-time error and the run input is
- * typed:
- *
- * ```ts
- * declare module "@lotics/app-sdk" {
- *   interface AppAgents {
- *     "recognize": { image_file_id: string };
- *     "edit": { current: Record<string, unknown>; prompt: string };
- *   }
- * }
- * ```
- */
-export interface AppAgents {
-}
-/**
- * App-specific agent-RESULT augmentation point — maps each agent alias to the
- * type of its declared `outputs` (the structured result the run emits). Absent
- * ⇒ `run.output` is `unknown`. Same pattern as `AppWorkflowResults`.
- */
-export interface AppAgentResults {
-}

package/dist/src/types.js

@@ -1 +0,0 @@
-export {};

package/dist/src/upload/optimize.d.ts

@@ -1,54 +0,0 @@
-/**
- * Browser-side image compression for app uploads.
- *
- * Phone-camera photos are huge (4–10 MB HEIC/JPEG) and no document needs
- * megapixels. Resize to ≤2000px on the long edge — above the standard vision
- * tier's 1568px so a high-resolution reader keeps real detail, but under the
- * limit that rejects requests carrying more than 20 images — and
- * re-encode as JPEG at q=0.9, which keeps small glyphs (container numbers,
- * invoice lines) legible to a reader and to an extraction agent.
- *
- * HEIC/HEIF / PNG / WebP are converted to JPEG. Non-image files (PDF, etc.)
- * pass through unchanged. Falls through gracefully on any browser API gap
- * — the original file is always returned as a usable upload candidate.
- *
- * Ported from `frontend/lib/upload_file_optimization.ts` so public-app forms
- * get the same mobile-friendly upload behavior as the in-Lotics UI. Kept
- * dependency-free (no logger, no ImageFidelity abstraction) so the SDK ships
- * as a single drop-in.
- */
-/**
- * How faithful the STORED image must be — a closed ordinal scale, not a taxonomy
- * of subjects, so a caller can read the value and know what it costs.
- * `@lotics/shared/image_policy` carries the same scale and the reasoning.
- */
-export type ImageFidelity = "original" | "high" | "standard";
-/**
- * What an upload defaults to when the caller says nothing. MIRRORS
- * `@lotics/shared/image_policy` — this package ships dependency-free and cannot
- * import it — and a test fails when the two drift.
- *
- * `high` because the surfaces that do not think about this mostly carry text; a
- * caller collecting in volume declares `"standard"` and pays a fraction as much.
- */
-export declare const DEFAULT_IMAGE_FIDELITY: ImageFidelity;
-export interface ImagePolicy {
-    maxDimensionPx: number;
-    jpegQuality: number;
-}
-/** The mirror, exposed so the drift guard can compare it with the shared
- *  source of truth. Not part of the package's public surface. */
-export declare const IMAGE_POLICIES_FOR_TEST: Record<"high" | "standard", ImagePolicy>;
-export type OptimizationReason = "optimized" | "skipped_original" | "skipped_unsupported_format" | "skipped_environment_unsupported" | "skipped_decode_unavailable" | "skipped_invalid_dimensions" | "skipped_small_dimensions" | "skipped_canvas_unavailable" | "skipped_canvas_type_mismatch";
-export interface OptimizationResult {
-    file: File;
-    optimized: boolean;
-    reason: OptimizationReason;
-    originalSizeBytes: number;
-    optimizedSizeBytes: number;
-    width: number;
-    height: number;
-    targetWidth: number;
-    targetHeight: number;
-}
-export declare function optimizeImageForUpload(file: File, fidelity?: ImageFidelity): Promise<OptimizationResult>;

package/dist/src/upload/optimize.js

@@ -1,207 +0,0 @@
-/**
- * Browser-side image compression for app uploads.
- *
- * Phone-camera photos are huge (4–10 MB HEIC/JPEG) and no document needs
- * megapixels. Resize to ≤2000px on the long edge — above the standard vision
- * tier's 1568px so a high-resolution reader keeps real detail, but under the
- * limit that rejects requests carrying more than 20 images — and
- * re-encode as JPEG at q=0.9, which keeps small glyphs (container numbers,
- * invoice lines) legible to a reader and to an extraction agent.
- *
- * HEIC/HEIF / PNG / WebP are converted to JPEG. Non-image files (PDF, etc.)
- * pass through unchanged. Falls through gracefully on any browser API gap
- * — the original file is always returned as a usable upload candidate.
- *
- * Ported from `frontend/lib/upload_file_optimization.ts` so public-app forms
- * get the same mobile-friendly upload behavior as the in-Lotics UI. Kept
- * dependency-free (no logger, no ImageFidelity abstraction) so the SDK ships
- * as a single drop-in.
- */
-/**
- * What an upload defaults to when the caller says nothing. MIRRORS
- * `@lotics/shared/image_policy` — this package ships dependency-free and cannot
- * import it — and a test fails when the two drift.
- *
- * `high` because the surfaces that do not think about this mostly carry text; a
- * caller collecting in volume declares `"standard"` and pays a fraction as much.
- */
-export const DEFAULT_IMAGE_FIDELITY = "high";
-// MIRRORS `@lotics/shared/image_policy` — the SDK ships dependency-free so it
-// cannot import it. Change both together.
-//  · standard — bulk visual evidence, NEVER read by a model, so tokens do not
-//    enter it: sized purely for upload time and storage across dozens of files.
-//  · high     — read by a model or a person. Token cost depends on DIMENSION
-//    alone, so this buys quality (free in tokens) and keeps the dimension modest.
-const IMAGE_POLICIES = {
-    standard: { maxDimensionPx: 1280, jpegQuality: 0.8 },
-    high: { maxDimensionPx: 1568, jpegQuality: 0.95 },
-};
-/** The mirror, exposed so the drift guard can compare it with the shared
- *  source of truth. Not part of the package's public surface. */
-export const IMAGE_POLICIES_FOR_TEST = IMAGE_POLICIES;
-const CONVERTIBLE_EXTENSION_PATTERN = /\.(heic|heif|png|webp)$/i;
-export async function optimizeImageForUpload(file, fidelity = DEFAULT_IMAGE_FIDELITY) {
-    if (fidelity === "original")
-        return unchanged(file, "skipped_original");
-    const policy = IMAGE_POLICIES[fidelity];
-    const format = getOptimizableFormat(file);
-    const mimeType = format?.outputMimeType;
-    const unsupportedReason = getUnsupportedReason(file, mimeType);
-    if (unsupportedReason)
-        return unchanged(file, unsupportedReason);
-    if (!mimeType || !format)
-        return unchanged(file, "skipped_unsupported_format");
-    const loaded = await loadImage(file);
-    if (loaded.status === "decode_unavailable")
-        return unchanged(file, "skipped_decode_unavailable");
-    const { source, width, height } = loaded;
-    if (width <= 0 || height <= 0) {
-        closeSource(source);
-        return unchanged(file, "skipped_invalid_dimensions");
-    }
-    if (Math.max(width, height) <= policy.maxDimensionPx) {
-        closeSource(source);
-        return unchanged(file, "skipped_small_dimensions", width, height);
-    }
-    const { width: targetWidth, height: targetHeight } = scale(width, height, policy.maxDimensionPx);
-    const canvas = document.createElement("canvas");
-    canvas.width = targetWidth;
-    canvas.height = targetHeight;
-    const ctx = canvas.getContext("2d");
-    if (!ctx || typeof canvas.toBlob !== "function") {
-        closeSource(source);
-        return unchanged(file, "skipped_canvas_unavailable", width, height);
-    }
-    ctx.imageSmoothingEnabled = true;
-    ctx.imageSmoothingQuality = "high";
-    ctx.drawImage(source, 0, 0, targetWidth, targetHeight);
-    closeSource(source);
-    const blob = await canvasToBlob(canvas, mimeType, policy.jpegQuality);
-    if (blob.type !== mimeType) {
-        return unchanged(file, "skipped_canvas_type_mismatch", width, height, targetWidth, targetHeight);
-    }
-    return {
-        file: new File([blob], format.outputFilename, {
-            type: mimeType,
-            lastModified: file.lastModified,
-        }),
-        optimized: true,
-        reason: "optimized",
-        originalSizeBytes: file.size,
-        optimizedSizeBytes: blob.size,
-        width,
-        height,
-        targetWidth,
-        targetHeight,
-    };
-}
-function getUnsupportedReason(file, mimeType) {
-    void file;
-    if (mimeType === undefined)
-        return "skipped_unsupported_format";
-    if (typeof window === "undefined" ||
-        typeof document === "undefined" ||
-        typeof document.createElement !== "function" ||
-        typeof URL.createObjectURL !== "function" ||
-        typeof URL.revokeObjectURL !== "function" ||
-        typeof Image === "undefined") {
-        return "skipped_environment_unsupported";
-    }
-    return undefined;
-}
-function getOptimizableFormat(file) {
-    const mimeType = normalizeMimeType(file.type);
-    if (!mimeType)
-        return undefined;
-    if (mimeType === "image/jpeg") {
-        return { outputMimeType: "image/jpeg", outputFilename: file.name };
-    }
-    // PNG / WebP / HEIC / HEIF → JPEG (transparency lost on PNG; acceptable
-    // for document uploads where we explicitly opt into lossy compression).
-    return { outputMimeType: "image/jpeg", outputFilename: replaceExtensionWithJpeg(file.name) };
-}
-function normalizeMimeType(mimeType) {
-    const m = mimeType.toLowerCase();
-    if (m === "image/jpeg" || m === "image/jpg")
-        return "image/jpeg";
-    if (m === "image/heic" || m === "image/heif")
-        return m;
-    if (m === "image/png" || m === "image/webp")
-        return m;
-    return undefined;
-}
-function replaceExtensionWithJpeg(filename) {
-    if (CONVERTIBLE_EXTENSION_PATTERN.test(filename)) {
-        return filename.replace(CONVERTIBLE_EXTENSION_PATTERN, ".jpg");
-    }
-    return `${filename}.jpg`;
-}
-function unchanged(file, reason, width = 0, height = 0, targetWidth = width, targetHeight = height) {
-    return {
-        file,
-        optimized: false,
-        reason,
-        originalSizeBytes: file.size,
-        optimizedSizeBytes: file.size,
-        width,
-        height,
-        targetWidth,
-        targetHeight,
-    };
-}
-function closeSource(source) {
-    if ("close" in source && typeof source.close === "function")
-        source.close();
-}
-function scale(width, height, maxDimensionPx) {
-    const largest = Math.max(width, height);
-    if (largest <= maxDimensionPx)
-        return { width, height };
-    const factor = maxDimensionPx / largest;
-    return {
-        width: Math.max(1, Math.round(width * factor)),
-        height: Math.max(1, Math.round(height * factor)),
-    };
-}
-async function loadImage(file) {
-    // Prefer createImageBitmap — off-main-thread decode, more reliable on
-    // mobile under memory pressure where Image() silently fails.
-    if (typeof createImageBitmap === "function") {
-        try {
-            const bitmap = await createImageBitmap(file);
-            return { status: "decoded", source: bitmap, width: bitmap.width, height: bitmap.height };
-        }
-        catch {
-            // unsupported format / corrupt — fall back to Image()
-        }
-    }
-    const objectUrl = URL.createObjectURL(file);
-    return new Promise((resolve) => {
-        const image = new Image();
-        const cleanup = () => {
-            image.onload = null;
-            image.onerror = null;
-            URL.revokeObjectURL(objectUrl);
-        };
-        image.onload = () => {
-            cleanup();
-            resolve({ status: "decoded", source: image, width: image.naturalWidth, height: image.naturalHeight });
-        };
-        image.onerror = () => {
-            cleanup();
-            resolve({ status: "decode_unavailable" });
-        };
-        image.src = objectUrl;
-    });
-}
-async function canvasToBlob(canvas, mimeType, jpegQuality) {
-    return new Promise((resolve, reject) => {
-        canvas.toBlob((blob) => {
-            if (!blob) {
-                reject(new Error("Canvas export returned no data during upload optimization"));
-                return;
-            }
-            resolve(blob);
-        }, mimeType, jpegQuality);
-    });
-}

package/dist/src/upload/pipeline.d.ts

@@ -1,55 +0,0 @@
-/**
- * Orchestrator for the app-upload pipeline.
- *
- *   File → optimize (image only) → request presigned URL →
- *     PUT to storage (with retry) → complete → ProcessedFile
- *
- * Each step is a focused module (see `optimize.ts`, `transport.ts`); this
- * file just wires them together so `useFileUpload` callers get one robust
- * "uploaded" promise instead of a bare-fetch happy path.
- *
- * Surface is intentionally minimal: the only knob is an optional
- * `AbortSignal` for caller cancellation. Optimization, retries, and
- * timeouts use platform-internal defaults — same conventions as the
- * in-Lotics direct-upload pipeline.
- */
-import { type ImageFidelity } from "./optimize.js";
-interface UploadInitResponse {
-    upload_url: string;
-    file_id: string;
-    file_storage_key: string;
-}
-interface CompleteResponseFile {
-    id: string;
-    filename: string;
-    mime_type: string;
-    url?: string;
-    thumbnail_url?: string;
-    preview_url?: string;
-}
-/**
- * Caller injects the RPC primitives so this module stays decoupled from the
- * SDK's auth / bootstrap layer. The pipeline targets a specific app's upload
- * endpoints via the supplied `initUpload` and `completeUpload`.
- */
-export interface UploadRpc {
-    initUpload(input: {
-        filename: string;
-        mime_type: string;
-        file_size: number;
-    }): Promise<UploadInitResponse>;
-    completeUpload(input: {
-        file_id: string;
-        file_storage_key: string;
-        filename: string;
-    }): Promise<{
-        file: CompleteResponseFile;
-    }>;
-}
-export interface RunUploadPipelineOptions {
-    signal?: AbortSignal;
-    /** What the surface is collecting — selects the stored image resolution. */
-    fidelity?: ImageFidelity;
-}
-export declare function runUploadPipeline(file: File, rpc: UploadRpc, options?: RunUploadPipelineOptions): Promise<CompleteResponseFile>;
-export {};

package/dist/src/upload/pipeline.js

@@ -1,52 +0,0 @@
-/**
- * Orchestrator for the app-upload pipeline.
- *
- *   File → optimize (image only) → request presigned URL →
- *     PUT to storage (with retry) → complete → ProcessedFile
- *
- * Each step is a focused module (see `optimize.ts`, `transport.ts`); this
- * file just wires them together so `useFileUpload` callers get one robust
- * "uploaded" promise instead of a bare-fetch happy path.
- *
- * Surface is intentionally minimal: the only knob is an optional
- * `AbortSignal` for caller cancellation. Optimization, retries, and
- * timeouts use platform-internal defaults — same conventions as the
- * in-Lotics direct-upload pipeline.
- */
-import { optimizeImageForUpload, DEFAULT_IMAGE_FIDELITY } from "./optimize.js";
-import { putToStorageWithRetry } from "./transport.js";
-export async function runUploadPipeline(file, rpc, options = {}) {
-    const { signal, fidelity = DEFAULT_IMAGE_FIDELITY } = options;
-    // 1. Compress images. Non-image files return unchanged. Failures here are
-    //    intentionally swallowed — the user shouldn't see an upload error
-    //    because canvas threw; we just upload the original bytes.
-    let candidate = file;
-    try {
-        const optimized = await optimizeImageForUpload(file, fidelity);
-        candidate = optimized.file;
-    }
-    catch {
-        // fall through with original file
-    }
-    if (signal?.aborted)
-        throw new Error("Upload aborted");
-    // 2. Ask the backend for a presigned upload URL.
-    const init = await rpc.initUpload({
-        filename: candidate.name,
-        mime_type: candidate.type,
-        file_size: candidate.size,
-    });
-    // 3. PUT the bytes with timeout + retry. This is the mobile-network
-    //    failure point.
-    const putResponse = await putToStorageWithRetry(init.upload_url, candidate, signal);
-    if (!putResponse.ok) {
-        throw new Error(`Storage upload failed (${putResponse.status}). Please check your connection and try again.`);
-    }
-    // 4. Finalize — the server validates the object and creates the file row.
-    const { file: uploaded } = await rpc.completeUpload({
-        file_id: init.file_id,
-        file_storage_key: init.file_storage_key,
-        filename: candidate.name,
-    });
-    return uploaded;
-}

package/dist/src/upload/transport.d.ts

@@ -1,42 +0,0 @@
-/**
- * Transport-layer helpers for the SDK upload pipeline.
- *
- * Two concerns this module owns:
- *
- * 1. **Per-request timeout.** A bare `fetch` hangs forever if the network is
- *    unreachable; we wrap it in an `AbortController` so a stuck request fails
- *    after `UPLOAD_TIMEOUT_MS` instead of leaving the user staring at a
- *    spinner.
- *
- * 2. **Retry with exponential backoff** for the presigned `PUT` to object
- *    storage — the single most failure-prone step on mobile networks. We
- *    retry on network errors / 5xx / timeouts up to `UPLOAD_PUT_MAX_ATTEMPTS`
- *    with 1s → 2s → 4s waits between attempts. We do NOT retry on 4xx
- *    (client error, retrying won't help) or on caller-initiated aborts.
- *
- * Mirrors the conventions in `frontend/lib/api_utils.ts` and
- * `frontend/lib/file_upload.ts`, simplified for the SDK (no logger, no
- * correlation headers).
- */
-export declare const UPLOAD_TIMEOUT_MS: number;
-export declare class UploadTimeoutError extends Error {
-    readonly url: string;
-    readonly timeoutMs: number;
-    readonly name = "UploadTimeoutError";
-    constructor(url: string, timeoutMs: number);
-}
-export declare class UploadAbortedError extends Error {
-    readonly name = "UploadAbortedError";
-    constructor();
-}
-/** `fetch` with timeout + optional external `AbortSignal`. */
-export declare function fetchWithTimeout(url: string, init: RequestInit, timeoutMs: number): Promise<Response>;
-/**
- * Presigned-PUT to object storage with retry + backoff.
- *
- * Retries network errors, timeouts, and 5xx responses up to
- * `UPLOAD_PUT_MAX_ATTEMPTS` times. A 4xx response is returned to the caller
- * unchanged (retrying a 403/400 won't help; the caller decides). Aborts
- * propagate immediately without retry.
- */
-export declare function putToStorageWithRetry(uploadUrl: string, file: File, signal: AbortSignal | undefined): Promise<Response>;