@aexhq/sdk 0.46.4-canary → 0.50.0

package/dist/_contracts/workspace-resources.d.ts

@@ -1,98 +0,0 @@
-import type { ToolInputSchema } from "./session-config.js";
-/**
- * Persisted workspace file resource names accepted by the public wire boundary.
- *
- * This is deliberately separate from filename validation and from the SDK's
- * filename-to-storage-slug derivation. Equal syntax with instruction names
- * today does not make those resource domains one contract.
- */
-export declare const WORKSPACE_FILE_RESOURCE_NAME_PATTERN: RegExp;
-/**
- * Persisted workspace instruction resource names accepted by the public wire
- * boundary. Callers supply these names directly; consumers must not normalize,
- * lowercase, trim, or otherwise rewrite an accepted value.
- */
-export declare const WORKSPACE_INSTRUCTION_RESOURCE_NAME_PATTERN: RegExp;
-/** Assert a directly supplied persisted workspace file resource name. */
-export declare function assertWorkspaceFileResourceName(value: unknown, path: string): asserts value is string;
-/** Assert a directly supplied persisted workspace instruction resource name. */
-export declare function assertWorkspaceInstructionResourceName(value: unknown, path: string): asserts value is string;
-/** Immutable bytes in the workspace content-addressed asset store. */
-export interface AssetIdentity {
-    readonly assetId: string;
-    /** Canonical `sha256:<hex>` digest of the asset bytes. */
-    readonly contentHash: string;
-    readonly sizeBytes: number;
-    readonly contentType: string;
-}
-interface WorkspaceResourceRefBase {
-    /** Stable logical resource id. */
-    readonly resourceId: string;
-    /** Immutable positive version of the logical resource. */
-    readonly version: number;
-    readonly assetId: string;
-    readonly contentHash: string;
-}
-/** A reusable file input pinned to immutable bytes and a workspace version. */
-export interface WorkspaceFileRef extends WorkspaceResourceRefBase {
-    readonly kind: "file";
-    readonly name: string;
-    readonly mountPath: string;
-}
-/** A reusable skill input pinned to immutable bytes and a workspace version. */
-export interface WorkspaceSkillRef extends WorkspaceResourceRefBase {
-    readonly kind: "skill";
-    readonly name: string;
-    readonly description: string;
-}
-/** A reusable custom tool input pinned to immutable bytes and a workspace version. */
-export interface WorkspaceToolRef extends WorkspaceResourceRefBase {
-    readonly kind: "tool";
-    readonly name: string;
-    readonly description: string;
-    readonly input_schema: ToolInputSchema;
-    readonly entry: string;
-}
-/** Versioned instruction context backed by immutable asset bytes. */
-export interface WorkspaceInstructionRef extends WorkspaceResourceRefBase {
-    readonly kind: "instruction";
-    readonly name: string;
-}
-export type WorkspaceResourceRef = WorkspaceFileRef | WorkspaceSkillRef | WorkspaceToolRef | WorkspaceInstructionRef;
-/** The only resource-bearing section of a session submission. */
-export interface SubmissionAssets {
-    readonly files: readonly WorkspaceFileRef[];
-    readonly skills: readonly WorkspaceSkillRef[];
-    readonly tools: readonly WorkspaceToolRef[];
-    readonly instructions: readonly WorkspaceInstructionRef[];
-}
-interface WorkspaceResourceRecordFields {
-    readonly createdAt: string;
-    readonly updatedAt?: string;
-    readonly sizeBytes: number;
-    readonly contentType: string;
-}
-export type WorkspaceFileRecord = WorkspaceFileRef & WorkspaceResourceRecordFields;
-export type WorkspaceSkillRecord = WorkspaceSkillRef & WorkspaceResourceRecordFields;
-export type WorkspaceToolRecord = WorkspaceToolRef & WorkspaceResourceRecordFields;
-export type WorkspaceInstructionRecord = WorkspaceInstructionRef & WorkspaceResourceRecordFields;
-export interface WorkspaceResourcePage<T> {
-    readonly resources: readonly T[];
-    readonly nextCursor?: string;
-}
-export interface WorkspaceResourceListQuery {
-    /** Opaque cursor returned by the previous page. */
-    readonly cursor?: string;
-    /** Page size. Defaults to 100 and must be an integer from 1 through 100. */
-    readonly limit?: number;
-}
-/**
- * Validate the immutable identity fields common to every submitted resource.
- *
- * The canonical digest grammar is passed to the schema rather than imported by
- * it: `canonical-sha256.ts` declares that grammar once and this module is its
- * declared consumer, which is the arrangement `canonical-sha256-ownership.test.ts`
- * pins.
- */
-export declare function assertPinnedWorkspaceResource(value: WorkspaceResourceRef, path: string): void;
-export {};

package/dist/_contracts/workspace-resources.js

@@ -1,39 +0,0 @@
-import { CANONICAL_SHA256_DIGEST_PATTERN } from "./canonical-sha256.js";
-import { pinnedWorkspaceResourceSchema, workspaceResourceNameSchema } from "./schemas/workspace-resources.js";
-import { parseWire } from "./schemas/wire.js";
-/**
- * Persisted workspace file resource names accepted by the public wire boundary.
- *
- * This is deliberately separate from filename validation and from the SDK's
- * filename-to-storage-slug derivation. Equal syntax with instruction names
- * today does not make those resource domains one contract.
- */
-export const WORKSPACE_FILE_RESOURCE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
-/**
- * Persisted workspace instruction resource names accepted by the public wire
- * boundary. Callers supply these names directly; consumers must not normalize,
- * lowercase, trim, or otherwise rewrite an accepted value.
- */
-export const WORKSPACE_INSTRUCTION_RESOURCE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
-/** Assert a directly supplied persisted workspace file resource name. */
-export function assertWorkspaceFileResourceName(value, path) {
-    assertWorkspaceResourceName(value, path, WORKSPACE_FILE_RESOURCE_NAME_PATTERN);
-}
-/** Assert a directly supplied persisted workspace instruction resource name. */
-export function assertWorkspaceInstructionResourceName(value, path) {
-    assertWorkspaceResourceName(value, path, WORKSPACE_INSTRUCTION_RESOURCE_NAME_PATTERN);
-}
-function assertWorkspaceResourceName(value, path, pattern) {
-    parseWire(workspaceResourceNameSchema(path, pattern), value);
-}
-/**
- * Validate the immutable identity fields common to every submitted resource.
- *
- * The canonical digest grammar is passed to the schema rather than imported by
- * it: `canonical-sha256.ts` declares that grammar once and this module is its
- * declared consumer, which is the arrangement `canonical-sha256-ownership.test.ts`
- * pins.
- */
-export function assertPinnedWorkspaceResource(value, path) {
-    parseWire(pinnedWorkspaceResourceSchema(path, CANONICAL_SHA256_DIGEST_PATTERN), value);
-}

package/dist/archive-limits.d.ts

@@ -1 +0,0 @@
-export { assertArchiveCompressedSize, assertArchiveEntryCount, assertArchiveExpandedSize } from "./_contracts/internal.js";

package/dist/archive-limits.js

@@ -1,2 +0,0 @@
-export { assertArchiveCompressedSize, assertArchiveEntryCount, assertArchiveExpandedSize } from "./_contracts/internal.js";
-//# sourceMappingURL=archive-limits.js.map

package/dist/archive-limits.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"archive-limits.js","sourceRoot":"","sources":["../src/archive-limits.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC"}

package/dist/asset-upload.d.ts

@@ -1,47 +0,0 @@
-/**
- * Asset materialization for the SDK run / session path.
- *
- * Every inline `Skill` / `Tool` / `Instructions` / `File` draft is materialized
- * to the hosted API's content-addressable asset store before the session
- * starts, so the wire submission carries only storage-neutral refs.
- *
- * Upload is direct-to-storage (no bytes through the hosted API, so bundle size
- * is bounded by the object store rather than by the API's memory /
- * request-payload limits):
- *
- *   1. POST /api/assets/presign -> { exists } | { uploadUrl, requiredHeaders }
- *      - `exists:true` is a dedup hit; we're done.
- *      - otherwise the hosted API mints a presigned PUT scoped to the exact
- *        content-addressed key and signs `x-amz-checksum-sha256` so the object
- *        store enforces integrity server-side.
- *   2. PUT the bytes straight to `uploadUrl` with `requiredHeaders` (the signed
- *      checksum). The store rejects a byte mismatch — a 2xx proves bytes == hash.
- *   3. POST /api/assets/finalize -> confirms the object exists (HEAD only).
- *
- */
-import { type AssetFetch, type AssetUploadRetryOptions, type AssetsHttpClient, type UploadedAsset } from "./_contracts/internal.js";
-import type { ByteSink } from "./canonical-zip.js";
-export { uploadAsset } from "./_contracts/internal.js";
-export type { AssetFetch, AssetsHttpClient, UploadAssetArgs, UploadedAsset } from "./_contracts/internal.js";
-/** Default multipart part size for runtime input archives. */
-export declare const DEFAULT_MULTIPART_PART_SIZE: number;
-/** Default in-flight part concurrency. */
-export declare const DEFAULT_MULTIPART_CONCURRENCY = 4;
-/**
- * Drives the canonical-zip framer, pushing every zip byte into `sink` in order.
- * Called TWICE (pass 1 hash, pass 2 upload); the framer is deterministic so both
- * passes emit byte-identical streams.
- */
-export type ZipStreamDriver = (sink: ByteSink) => Promise<void>;
-export interface UploadAssetStreamArgs {
-    readonly http: AssetsHttpClient;
-    /** Re-openable, deterministic canonical-zip stream driver (pass-1 hash == pass-2 bytes). */
-    readonly drive: ZipStreamDriver;
-    readonly contentType?: string;
-    readonly fetch?: AssetFetch;
-    readonly retry?: AssetUploadRetryOptions;
-    readonly partSize?: number;
-    readonly partConcurrency?: number;
-}
-/** Stream a large asset to the content store via the two-pass multipart flow. */
-export declare function uploadAssetMultipart(args: UploadAssetStreamArgs): Promise<UploadedAsset>;

package/dist/asset-upload.js

@@ -1,269 +0,0 @@
-/**
- * Asset materialization for the SDK run / session path.
- *
- * Every inline `Skill` / `Tool` / `Instructions` / `File` draft is materialized
- * to the hosted API's content-addressable asset store before the session
- * starts, so the wire submission carries only storage-neutral refs.
- *
- * Upload is direct-to-storage (no bytes through the hosted API, so bundle size
- * is bounded by the object store rather than by the API's memory /
- * request-payload limits):
- *
- *   1. POST /api/assets/presign -> { exists } | { uploadUrl, requiredHeaders }
- *      - `exists:true` is a dedup hit; we're done.
- *      - otherwise the hosted API mints a presigned PUT scoped to the exact
- *        content-addressed key and signs `x-amz-checksum-sha256` so the object
- *        store enforces integrity server-side.
- *   2. PUT the bytes straight to `uploadUrl` with `requiredHeaders` (the signed
- *      checksum). The store rejects a byte mismatch — a 2xx proves bytes == hash.
- *   3. POST /api/assets/finalize -> confirms the object exists (HEAD only).
- *
- */
-import { directUploadNetworkError, directUploadResponseError, isRetryableUploadError, isRetryableUploadStatus, tryParseRetryAfterMs } from "./_contracts/internal.js";
-import { nextHttpRetryDelayMs, resolveHttpRetryDeps, resolveHttpRetryPolicy } from "./_contracts/index.js";
-export { uploadAsset } from "./_contracts/internal.js";
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-function assetIdFromContentHash(contentHash) {
-    const hex = contentHash.startsWith("sha256:") ? contentHash.slice("sha256:".length) : contentHash;
-    return `asset_${hex}`;
-}
-// ===========================================================================
-// Multipart streaming upload (large assets — the "kill the in-memory ceiling"
-// path). Two-pass over a re-openable, DETERMINISTIC canonical-zip byte stream:
-//   pass 1 — stream → running SHA-256 → presign BY HASH (dedup still short-
-//            circuits `exists:true` with zero bytes uploaded);
-//   pass 2 — re-stream → chunk into parts → S3 multipart UploadPart (bounded
-//            concurrency + per-part retry, only the failed part re-sent) →
-//            CompleteMultipartUpload (server validates the full-object SHA-256).
-// A failure after presign aborts the multipart upload so no orphaned parts bill.
-// ===========================================================================
-/** Default multipart part size for runtime input archives. */
-export const DEFAULT_MULTIPART_PART_SIZE = 16 * 1024 * 1024;
-/** Default in-flight part concurrency. */
-export const DEFAULT_MULTIPART_CONCURRENCY = 4;
-/** Stream a large asset to the content store via the two-pass multipart flow. */
-export async function uploadAssetMultipart(args) {
-    const partSize = args.partSize ?? DEFAULT_MULTIPART_PART_SIZE;
-    const concurrency = Math.max(1, args.partConcurrency ?? DEFAULT_MULTIPART_CONCURRENCY);
-    const doFetch = args.fetch ?? globalThis.fetch;
-    // ---- Pass 1: stream → running SHA-256 + byte count ----
-    const { hashHex, sizeBytes } = await hashAndSizeViaDrive(args.drive);
-    const contentHashHeader = `sha256:${hashHex}`;
-    const contentType = args.contentType ?? "application/zip";
-    // ---- Presign (multipart) — dedup short-circuits before any bytes move ----
-    const presign = await args.http.request("/api/assets/presign", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ hash: contentHashHeader, sizeBytes, contentType, multipart: true, partSize })
-    });
-    if (presign.exists) {
-        const contentHash = presign.contentHash ?? contentHashHeader;
-        return {
-            assetId: presign.assetId ?? assetIdFromContentHash(contentHash),
-            contentHash,
-            sizeBytes: presign.sizeBytes ?? sizeBytes,
-            contentType: presign.contentType ?? contentType,
-            exists: true
-        };
-    }
-    const mp = presign.multipart;
-    if (!mp || !mp.uploadId || !mp.key || !Array.isArray(mp.partUrls)) {
-        throw new Error("uploadAssetMultipart: presign returned no multipart plan and exists:false");
-    }
-    // ---- Pass 2: re-stream → parts → UploadPart (bounded concurrency + retry) ----
-    const urlByPart = new Map();
-    for (const p of mp.partUrls)
-        urlByPart.set(p.partNumber, p.url);
-    const parts = [];
-    const inflight = new Set();
-    let failed;
-    const refreshPartUrl = async (partNumber) => {
-        const res = await args.http.request("/api/assets/mpu/presign-parts", {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ uploadId: mp.uploadId, key: mp.key, partNumbers: [partNumber] })
-        });
-        const fresh = res.partUrls?.find((p) => p.partNumber === partNumber)?.url;
-        if (!fresh)
-            throw new Error(`uploadAssetMultipart: could not refresh URL for part ${partNumber}`);
-        urlByPart.set(partNumber, fresh);
-        return fresh;
-    };
-    const uploadOnePart = async (partNumber, bytes) => {
-        let url = urlByPart.get(partNumber);
-        if (!url)
-            url = await refreshPartUrl(partNumber);
-        const etag = await putPartWithRetry(doFetch, url, bytes, contentType, () => refreshPartUrl(partNumber), args.retry);
-        if (!etag) {
-            throw new Error(`uploadAssetMultipart: part ${partNumber} PUT succeeded without an ETag header`);
-        }
-        parts.push({ partNumber, etag });
-    };
-    const submitPart = async (partNumber, bytes) => {
-        while (inflight.size >= concurrency)
-            await Promise.race(inflight);
-        if (failed !== undefined)
-            throw failed;
-        const tracked = uploadOnePart(partNumber, bytes)
-            .catch((err) => {
-            failed ??= err;
-        })
-            .finally(() => {
-            inflight.delete(tracked);
-        });
-        inflight.add(tracked);
-    };
-    try {
-        let partNumber = 0;
-        const chunker = makePartChunker(partSize, async (bytes) => {
-            partNumber += 1;
-            await submitPart(partNumber, bytes);
-        });
-        await args.drive(async (chunk) => {
-            await chunker.push(chunk);
-            if (failed !== undefined)
-                throw failed;
-        });
-        await chunker.flush();
-        await Promise.all(inflight);
-        if (failed !== undefined)
-            throw failed;
-        if (partNumber === 0) {
-            // Zero-length streams cannot happen for a real zip (EOCD is always emitted),
-            // but guard so a bug fails loud rather than completing an empty MPU.
-            throw new Error("uploadAssetMultipart: no parts produced from the zip stream");
-        }
-        parts.sort((a, b) => a.partNumber - b.partNumber);
-        const fin = await args.http.request("/api/assets/finalize", {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ hash: contentHashHeader, sizeBytes, uploadId: mp.uploadId, key: mp.key, parts })
-        });
-        const contentHash = fin.contentHash ?? contentHashHeader;
-        return {
-            assetId: fin.assetId ?? assetIdFromContentHash(contentHash),
-            contentHash,
-            sizeBytes: fin.sizeBytes ?? sizeBytes,
-            contentType: fin.contentType ?? presign.contentType ?? contentType,
-            exists: false
-        };
-    }
-    catch (err) {
-        // Abort so orphaned parts don't bill silently (backed by the S3 lifecycle rule too).
-        await args.http
-            .request("/api/assets/mpu/abort", {
-            method: "POST",
-            headers: { "content-type": "application/json" },
-            body: JSON.stringify({ uploadId: mp.uploadId, key: mp.key })
-        })
-            .catch(() => undefined);
-        throw err;
-    }
-}
-/** Drive the framer through SHA-256, returning the hex digest + total byte count. Node/Bun only. */
-async function hashAndSizeViaDrive(drive) {
-    const { createHash } = await import("node:crypto");
-    const hash = createHash("sha256");
-    let sizeBytes = 0;
-    // NO per-chunk compressed-size gate here (review-2026-07-25 plan 04): the
-    // multipart machine exists for 10,000 x 5 MiB parts, so the archive ceiling
-    // trips before part 4 and every larger upload this path was BUILT for was
-    // unreachable. Admission owns the size decision; this function hashes.
-    await drive((chunk) => {
-        sizeBytes += chunk.length;
-        hash.update(chunk);
-    });
-    return { hashHex: hash.digest("hex"), sizeBytes };
-}
-/**
- * Repackage an arbitrary-boundary byte stream into fixed `partSize` parts (the
- * last may be smaller), invoking `emit` once per full part. Efficient: front-of-
- * queue splitting, no O(n²) buffer growth.
- */
-function makePartChunker(partSize, emit) {
-    const chunks = [];
-    let buffered = 0;
-    const emitPart = async (size) => {
-        const part = new Uint8Array(size);
-        let off = 0;
-        while (off < size) {
-            const head = chunks[0];
-            const take = Math.min(head.length, size - off);
-            part.set(head.subarray(0, take), off);
-            off += take;
-            if (take === head.length)
-                chunks.shift();
-            else
-                chunks[0] = head.subarray(take);
-        }
-        buffered -= size;
-        await emit(part);
-    };
-    return {
-        push: async (chunk) => {
-            if (chunk.length === 0)
-                return;
-            chunks.push(chunk);
-            buffered += chunk.length;
-            while (buffered >= partSize)
-                await emitPart(partSize);
-        },
-        flush: async () => {
-            if (buffered > 0)
-                await emitPart(buffered);
-        }
-    };
-}
-/** PUT one part with bounded retry; refreshes the URL once on a 403 (expiry). Returns the ETag. */
-async function putPartWithRetry(fetchImpl, url, bytes, contentType, refreshUrl, retryOptions) {
-    let currentUrl = url;
-    let refreshed = false;
-    const policy = resolveHttpRetryPolicy(retryOptions);
-    const deps = resolveHttpRetryDeps(retryOptions);
-    const startedAtMs = deps.now();
-    for (let attempt = 1; attempt <= policy.maxAttempts; attempt++) {
-        let response;
-        try {
-            response = await fetchImpl(currentUrl, {
-                method: "PUT",
-                headers: { "content-type": contentType ?? "application/zip" },
-                body: bytes
-            });
-        }
-        catch (err) {
-            const delayMs = isRetryableUploadError(err)
-                ? nextHttpRetryDelayMs({ policy, attempt, startedAtMs, deps })
-                : undefined;
-            if (delayMs === undefined)
-                throw directUploadNetworkError(currentUrl, err, attempt);
-            await deps.sleep(delayMs);
-            continue;
-        }
-        if (response.ok) {
-            const etag = response.headers?.get?.("etag") ?? response.headers?.get?.("ETag") ?? "";
-            return etag.replace(/"/g, "");
-        }
-        // A 403 mid-upload is a presign-expiry; refresh the URL once and retry.
-        if (response.status === 403 && !refreshed && attempt < policy.maxAttempts) {
-            refreshed = true;
-            await response.text().catch(() => "");
-            currentUrl = await refreshUrl();
-            continue;
-        }
-        const retryAfterMs = tryParseRetryAfterMs(response.headers?.get("retry-after"), deps.now());
-        const delayMs = isRetryableUploadStatus(response.status)
-            ? nextHttpRetryDelayMs({ policy, attempt, startedAtMs, deps, retryAfterMs })
-            : undefined;
-        if (delayMs !== undefined) {
-            await response.text().catch(() => "");
-            await deps.sleep(delayMs);
-            continue;
-        }
-        const detail = await response.text().catch(() => "");
-        throw directUploadResponseError(currentUrl, response.status, detail, attempt);
-    }
-    throw directUploadResponseError(currentUrl, 0, "exhausted retries", policy.maxAttempts);
-}
-//# sourceMappingURL=asset-upload.js.map

package/dist/asset-upload.js.map

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

package/dist/bundle.d.ts

@@ -1,9 +0,0 @@
-import type { BundledSkill, BundledTool, BundleMeta, SkillFiles, ToolBundleManifest } from "./_contracts/internal.js";
-export { splitSkillBundleMetadata } from "./_contracts/internal.js";
-export type { BundledSkill, BundledTool, BundleMeta, ParsedSkillBundle, SkillFiles, ToolBundleManifest } from "./_contracts/internal.js";
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export declare function bundleSkillFiles(files: SkillFiles, meta?: BundleMeta): BundledSkill;
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export declare function bundleToolFiles(files: SkillFiles, manifest: ToolBundleManifest, meta?: BundleMeta): BundledTool;
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export declare function hashSkillBundle(zipBytes: Uint8Array): Promise<string>;

package/dist/bundle.js

@@ -1,20 +0,0 @@
-/**
- * SDK-private compatibility adapter for the dependency-light canonical asset
- * bundle owner. Keep callers on this module while the implementation remains
- * single-sourced in `@aexhq/contracts/internal`.
- */
-import { bundleSkillFiles as bundleSkillFilesInternal, bundleToolFiles as bundleToolFilesInternal, hashSkillBundle as hashSkillBundleInternal } from "./_contracts/internal.js";
-export { splitSkillBundleMetadata } from "./_contracts/internal.js";
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export function bundleSkillFiles(files, meta) {
-    return bundleSkillFilesInternal(files, meta);
-}
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export function bundleToolFiles(files, manifest, meta) {
-    return bundleToolFilesInternal(files, manifest, meta);
-}
-/** Preserve the established SDK signature while delegating to the shared owner. */
-export function hashSkillBundle(zipBytes) {
-    return hashSkillBundleInternal(zipBytes);
-}
-//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,gBAAgB,IAAI,wBAAwB,EAC5C,eAAe,IAAI,uBAAuB,EAC1C,eAAe,IAAI,uBAAuB,EAC3C,MAAM,2BAA2B,CAAC;AASnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAUrE,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,IAAiB;IACnE,OAAO,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,QAA4B,EAC5B,IAAiB;IAEjB,OAAO,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,QAAoB;IAClD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/canonical-zip.d.ts

@@ -1,68 +0,0 @@
-/**
- * Canonical zip framer — the deterministic, content-addressed zip layer the
- * asset upload path dedups on. Two canonical forms, both byte-stable:
- *
- *   Canonical A (the ~99% case: every entry ≤ {@link ENTRY_RAM_CAP}) — a custom
- *   per-entry framer that reproduces fflate's `zipSync(..., {level:6})` output
- *   BYTE-FOR-BYTE (sorted entries, epoch mtime, per-entry crc32, per-entry
- *   one-shot `deflateSync` level 6, real sizes in a flag-0 local header) while
- *   holding only ONE entry in memory at a time. Because it equals `zipSync`, a
- *   streamed large bundle dedups against a small in-memory bundle of the same
- *   content — no dedup seam. Pinned forever by a golden byte-identity test.
- *
- *   Canonical B (a bundle containing ANY entry > {@link ENTRY_RAM_CAP}, e.g. a
- *   lone multi-GB dataset file) — fflate's streaming `Zip`/`ZipDeflate` driven
- *   with a PINNED {@link CANONICAL_B_PUSH_BYTES} push size. It does NOT equal
- *   `zipSync` (it emits streaming data descriptors, GP-flag bit 3), but it IS
- *   internally deterministic: same input → same bytes every time (pinned chunk
- *   size + pinned fflate version). Its own second canonical / dedup namespace,
- *   pinned by its own golden determinism test. A single giant entry cannot be
- *   both `zipSync`-identical AND framed in O(part) memory, so this is the
- *   accepted tradeoff (such a file has no small twin to dedup against).
- *
- * Browser-safe: this module imports ONLY fflate (no `node:*`). The node-only
- * streaming SHA-256 + multipart sink live in the callers (file.ts / asset-upload).
- */
-/** Epoch every entry mtime is pinned to (matches the pre-streaming `zipSync` path). */
-export declare const ZIP_EPOCH: Date;
-/**
- * Per-entry raw-byte ceiling for Canonical A. A single entry above this cannot be
- * one-shot `deflateSync`-ed within a bounded memory budget, so a bundle carrying
- * any such entry falls to Canonical B. A memory-budget knob, NOT a correctness
- * boundary (the golden tests pin both forms).
- */
-export declare const ENTRY_RAM_CAP: number;
-/** Pinned push size for Canonical B's streaming deflate. LOAD-BEARING for determinism. */
-export declare const CANONICAL_B_PUSH_BYTES: number;
-/** One-shot CRC-32 over `bytes`. */
-export declare function crc32(bytes: Uint8Array): number;
-/** A byte sink; may apply backpressure (pass-2 multipart) or run sync (pass-1 hash). */
-export type ByteSink = (chunk: Uint8Array) => void | Promise<void>;
-/**
- * One bundle entry to frame, in FINAL canonical order. `name` is the forward-slash
- * bundle-relative path; `size` its raw byte length (from `stat` or the in-memory
- * bytes). `read()` yields the whole entry (Canonical A / small); `openStream()` is
- * required only when `size > ENTRY_RAM_CAP` (Canonical B).
- */
-export interface ZipEntrySource {
-    readonly name: string;
-    readonly size: number;
-    read(): Uint8Array | Promise<Uint8Array>;
-    openStream?(): AsyncIterable<Uint8Array>;
-}
-/** True when the bundle must use Canonical B (some entry exceeds the RAM cap). */
-export declare function bundleNeedsCanonicalB(entries: readonly {
-    readonly size: number;
-}[]): boolean;
-/**
- * Stream the canonical zip of `entries` (FINAL canonical order) into `sink`.
- * Picks Canonical A (byte-identical to `zipSync`) unless an entry exceeds
- * {@link ENTRY_RAM_CAP}, in which case the whole bundle uses Canonical B.
- */
-export declare function streamBundleZip(entries: readonly ZipEntrySource[], sink: ByteSink): Promise<void>;
-/**
- * Synchronous Canonical-A convenience — frame an ordered `[name, bytes]` list to
- * a single buffer. Used by the golden byte-identity test (`=== zipSync`) and by
- * callers that already hold all bytes in memory. NOT for giant entries.
- */
-export declare function frameCanonicalZipSync(entries: ReadonlyArray<readonly [string, Uint8Array]>): Uint8Array;