@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/sdk.js

@@ -0,0 +1,238 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { parseDocument } from 'yaml';
+import { BuildOptionsSchema, MadeEasyError, SourceRefSchema, summarizeDiagnostics, } from './contracts/index.js';
+import { buildArtifacts, deliverFiles } from './build.js';
+import { readGuide, entriesOf } from './model.js';
+import { toNormalizedGuide } from './normalize.js';
+import { parseMarkdownDoc } from './markdown-doc.js';
+import { buildBriefDocument } from './render/brief.js';
+import { renderPage } from './render/html.js';
+import { renderBriefJson, renderBriefMarkdown, renderTrackMarkdown } from './render/markdown-out.js';
+import { BundleFiles, DEFAULT_LIMITS, directorySource, memorySource, zipSource, checkBundlePath, } from './source.js';
+import { validateModel } from './validate.js';
+import { VERSION } from './version.js';
+import { normalizeText, sha256Digest, slugify } from './util.js';
+export async function resolveInput(input, options = {}) {
+    if (typeof input === 'string')
+        return directorySource(input);
+    if (input instanceof BundleFiles)
+        return input;
+    if ('list' in input && 'read' in input)
+        return input;
+    const ref = SourceRefSchema.parse(input);
+    switch (ref.kind) {
+        case 'path':
+            if (options.allowPath === false) {
+                throw new MadeEasyError('BUNDLE_PATH_UNSAFE', 'Local path sources are not accepted by this adapter. Send the files inline or reference a stored guide.');
+            }
+            return directorySource(ref.path);
+        case 'files':
+            return memorySource(ref.files, 'upload');
+        case 'zip':
+            return zipSource(Buffer.from(ref.base64, 'base64'), options.limits ?? DEFAULT_LIMITS);
+        case 'guide':
+            throw new MadeEasyError('SCHEMA_INVALID', 'Stored guide references are resolved by the hosted service, not the SDK.');
+    }
+}
+/** Read and parse a bundle into the normalized model. Never throws for bad bundle content. */
+export async function loadGuide(input, options = {}) {
+    try {
+        const source = await resolveInput(input, options);
+        return await readGuide(source, options.limits ?? DEFAULT_LIMITS);
+    }
+    catch (e) {
+        if (e instanceof MadeEasyError)
+            throw e;
+        const code = e.code === 'BUNDLE_LIMIT_EXCEEDED' ? 'BUNDLE_LIMIT_EXCEEDED' : 'BUNDLE_FILE_MISSING';
+        throw new MadeEasyError(code, e.message);
+    }
+}
+function failureResult(e, make) {
+    if (e instanceof MadeEasyError)
+        return make(e.diagnostics);
+    throw e;
+}
+export async function validateGuide(input, options = {}) {
+    const mode = options.mode ?? 'draft';
+    try {
+        const model = await loadGuide(input, options);
+        const r = validateModel(model, { mode, audience: options.audience });
+        return {
+            ok: r.ok,
+            mode,
+            guideId: r.guideId,
+            revision: r.revision,
+            referenceRevision: r.referenceRevision,
+            summary: r.summary,
+            diagnostics: r.diagnostics,
+        };
+    }
+    catch (e) {
+        return failureResult(e, (diagnostics) => ({ ok: false, mode, summary: summarizeDiagnostics(diagnostics), diagnostics }));
+    }
+}
+export async function previewGuide(input, request = {}) {
+    const track = request.track ?? 'human';
+    const format = request.format ?? 'html';
+    const mode = request.mode ?? 'draft';
+    const mediaType = format === 'html' ? 'text/html' : format === 'markdown' ? 'text/markdown' : 'application/json';
+    const empty = (diagnostics, revision) => ({ ok: false, track, format, mediaType, revision, diagnostics });
+    let model;
+    try {
+        model = await loadGuide(input, request);
+    }
+    catch (e) {
+        return failureResult(e, (d) => empty(d));
+    }
+    const report = validateModel(model, { mode, audience: request.audience });
+    if (!model.guide || report.diagnostics.some((d) => d.severity === 'error' && ['YAML_PARSE_ERROR', 'BUNDLE_FILE_MISSING'].includes(d.code) && d.path === 'guide.yaml')) {
+        return empty(report.diagnostics, report.revision);
+    }
+    let content;
+    if (format === 'json') {
+        content = track === 'brief' ? renderBriefJson(model) : `${JSON.stringify(toNormalizedGuide(model), null, 2)}\n`;
+    }
+    else if (format === 'markdown') {
+        content = track === 'brief' ? renderBriefMarkdown(buildBriefDocument(model)) : renderTrackMarkdown(model, track);
+    }
+    else {
+        const page = track === 'operator' ? 'operator' : 'human';
+        const draft = mode === 'draft';
+        const assetSrc = (a) => {
+            const b = model.files.bytes(a.path);
+            return b ? `data:${a.mediaType};base64,${Buffer.from(b).toString('base64')}` : undefined;
+        };
+        content = renderPage({
+            model,
+            page,
+            version: VERSION,
+            standalone: true,
+            audience: request.audience,
+            draft,
+            draftNote: `${report.summary.errors} error(s), ${report.summary.warnings} warning(s).`,
+            assetSrc,
+        });
+    }
+    return { ok: report.ok, track, format, mediaType, revision: report.revision, content, diagnostics: report.diagnostics };
+}
+function parseBuildOptions(options) {
+    const { mode, formats, paper, audience, zip, allowPartial } = options;
+    const picked = Object.fromEntries(Object.entries({ mode, formats, paper, audience, zip, allowPartial }).filter(([, v]) => v !== undefined));
+    return BuildOptionsSchema.parse(picked);
+}
+/** Build and keep every output in memory. Used by the hosted service. */
+export async function buildGuideArtifacts(input, options = {}) {
+    const parsed = parseBuildOptions(options);
+    const model = await loadGuide(input, options);
+    const ab = await buildArtifacts(model, { ...parsed, browserPath: options.browserPath, signal: options.signal });
+    return { ...ab, guideId: model.guide?.guideId, revision: model.revision, referenceRevision: model.referenceRevision };
+}
+export async function buildGuide(input, options = {}) {
+    const parsed = parseBuildOptions(options);
+    let ab;
+    try {
+        ab = await buildGuideArtifacts(input, options);
+    }
+    catch (e) {
+        return failureResult(e, (diagnostics) => ({
+            ok: false,
+            status: 'failed',
+            mode: parsed.mode,
+            visibility: 'private',
+            complete: false,
+            summary: summarizeDiagnostics(diagnostics),
+            diagnostics,
+            artifacts: [],
+        }));
+    }
+    let diagnostics = ab.diagnostics;
+    let ok = ab.ok;
+    let status = ab.status;
+    if (ab.status !== 'failed' && options.out) {
+        const problem = await deliverFiles(options.out, ab.files, options.overwrite === true);
+        if (problem) {
+            diagnostics = [...diagnostics, problem];
+            ok = false;
+            status = 'failed';
+        }
+    }
+    return {
+        ok,
+        status,
+        mode: parsed.mode,
+        guideId: ab.guideId,
+        revision: ab.revision,
+        referenceRevision: ab.referenceRevision,
+        visibility: ab.visibility,
+        complete: status === 'failed' ? false : ab.complete,
+        summary: summarizeDiagnostics(diagnostics),
+        diagnostics,
+        artifacts: status === 'failed' ? [] : ab.artifacts,
+        outDir: status !== 'failed' && options.out ? resolve(options.out) : undefined,
+    };
+}
+/* ------------------------------- bundle files ------------------------------ */
+/** Write a bundle (relative path -> text) to a directory. Refuses unsafe paths; requires overwrite for non-empty targets. */
+export async function writeBundle(files, dir, options = {}) {
+    const root = resolve(dir);
+    const { readdir } = await import('node:fs/promises');
+    const existing = await readdir(root).catch(() => []);
+    if (existing.length && !options.overwrite) {
+        throw new MadeEasyError('OUTPUT_EXISTS', `${dir} already exists and is not empty. Pass --overwrite to write into it.`);
+    }
+    const written = [];
+    for (const [rel, text] of Object.entries(files)) {
+        const check = checkBundlePath(rel);
+        if (!check.ok)
+            throw new MadeEasyError('BUNDLE_PATH_UNSAFE', `Refusing to write "${rel}": ${check.reason}.`);
+        const abs = join(root, ...check.path.split('/'));
+        await mkdir(dirname(abs), { recursive: true });
+        await writeFile(abs, text);
+        written.push(check.path);
+    }
+    return written.sort();
+}
+/** Record the current digest of every pinned operator-reference entry in brief.yaml (keeps comments). */
+export async function pinGuide(input, options = {}) {
+    const model = await loadGuide(input, options);
+    const text = model.files.text('brief.yaml');
+    if (text === undefined)
+        throw new MadeEasyError('BUNDLE_FILE_MISSING', 'brief.yaml is missing.');
+    const doc = parseDocument(text);
+    const operator = new Map(entriesOf(model, 'operator').map((e) => [e.id, e]));
+    const wanted = options.all ? [...operator.keys()] : (model.brief?.operatorReference?.entries ?? []).map((p) => p.id);
+    const current = new Map((model.brief?.operatorReference?.entries ?? []).map((p) => [p.id, p.digest]));
+    const next = wanted.filter((id) => operator.has(id)).map((id) => ({ id, digest: operator.get(id).digest }));
+    doc.setIn(['operatorReference', 'entries'], doc.createNode(next));
+    const out = doc.toString({ lineWidth: 0 });
+    const entries = next.map((n) => ({ ...n, changed: current.get(n.id) !== n.digest }));
+    return { brief: normalizeText(out) === normalizeText(text) ? undefined : out, entries };
+}
+/** Add explicit `{#anchor}` to headings that lack one so links survive heading edits. Returns changed files. */
+export async function stabilizeAnchors(input, options = {}) {
+    const model = await loadGuide(input, options);
+    const changed = {};
+    for (const entry of model.entries) {
+        const raw = model.files.text(entry.path);
+        if (raw === undefined)
+            continue;
+        const parsed = parseMarkdownDoc(entry.path, raw);
+        const lines = raw.replace(/\r\n?/g, '\n').split('\n');
+        let touched = false;
+        for (const h of parsed.headings) {
+            if (h.explicit)
+                continue;
+            const i = h.line - 1;
+            if (lines[i] !== undefined) {
+                lines[i] = `${lines[i].replace(/[ \t]+$/, '')} {#${h.anchor || slugify(h.text)}}`;
+                touched = true;
+            }
+        }
+        if (touched)
+            changed[entry.path] = lines.join('\n');
+    }
+    return changed;
+}
+export { sha256Digest };
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

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

package/dist/source.d.ts

@@ -0,0 +1,57 @@
+import type { Diagnostic } from './contracts/diagnostics.js';
+import type { FileContent } from './contracts/api.js';
+export interface BundleLimits {
+    maxFiles: number;
+    maxFileBytes: number;
+    maxTotalBytes: number;
+}
+export declare const DEFAULT_LIMITS: BundleLimits;
+export type PathCheck = {
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Validate and normalise a bundle-relative path. Rejects traversal, absolute and
+ * drive-letter paths, backslashes, control characters, alternate data streams and
+ * empty segments. Returned paths always use forward slashes.
+ */
+export declare function checkBundlePath(input: string): PathCheck;
+/** Files that belong to a bundle: the five YAML files plus human/, operator/ and assets/. */
+export declare function isBundlePath(path: string): boolean;
+export declare function resolveRelative(fromFile: string, rel: string): string | undefined;
+/** Anything that can enumerate and read bundle files. All sources share one parser. */
+export interface BundleSource {
+    /** Human-readable origin, shown in PDFs and manifests (a directory path or label). */
+    readonly label: string;
+    list(): Promise<string[]>;
+    read(path: string): Promise<Uint8Array>;
+}
+/** A label that never leaks absolute local paths: relative to the cwd when inside it, else the folder name. */
+export declare function defaultBundleLabel(root: string): string;
+export declare function directorySource(root: string, label?: string): BundleSource;
+export declare function decodeFileContent(content: FileContent): Uint8Array;
+export declare function memorySource(files: Record<string, string | Uint8Array | FileContent>, label?: string): BundleSource;
+/** Read an uploaded ZIP with bounded extraction and traversal checks. */
+export declare function zipSource(data: Uint8Array | ArrayBuffer | Buffer, limits?: BundleLimits, label?: string): Promise<BundleSource>;
+export declare class BundleFiles {
+    readonly label: string;
+    private readonly map;
+    constructor(label: string, map: Map<string, Uint8Array>);
+    has(path: string): boolean;
+    bytes(path: string): Uint8Array | undefined;
+    text(path: string): string | undefined;
+    paths(): string[];
+    entries(): [string, Uint8Array][];
+    toRecord(): Record<string, string>;
+    with(path: string, value: string | Uint8Array | null): BundleFiles;
+}
+export interface LoadedFiles {
+    files: BundleFiles;
+    diagnostics: Diagnostic[];
+}
+/** Load every file from a source into memory with limits and path safety diagnostics. */
+export declare function loadBundleFiles(source: BundleSource, limits?: BundleLimits): Promise<LoadedFiles>;
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,YAI5B,CAAC;AAIF,MAAM,MAAM,SAAS,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAgBxD;AAID,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYjF;AAID,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzC;AAID,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAgC1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAGlE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,EACxD,KAAK,SAAW,GACf,YAAY,CAqBd;AAED,yEAAyE;AACzE,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACvC,MAAM,GAAE,YAA6B,EACrC,KAAK,SAAe,GACnB,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAID,qBAAa,WAAW;IAEpB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADX,KAAK,EAAE,MAAM,EACL,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAE/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAG1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAG3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItC,KAAK,IAAI,MAAM,EAAE;IAGjB,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE;IAGjC,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAKlC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,WAAW;CAMnE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,yFAAyF;AACzF,wBAAsB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,YAA6B,GAAG,OAAO,CAAC,WAAW,CAAC,CA0EvH"}

package/dist/source.js

@@ -0,0 +1,289 @@
+import { lstat, readdir, readFile } from 'node:fs/promises';
+import { basename, isAbsolute, relative, resolve, sep } from 'node:path';
+import JSZip from 'jszip';
+import { fromBytes, toBytes } from './util.js';
+export const DEFAULT_LIMITS = {
+    maxFiles: 2000,
+    maxFileBytes: 25 * 1024 * 1024,
+    maxTotalBytes: 200 * 1024 * 1024,
+};
+/**
+ * Validate and normalise a bundle-relative path. Rejects traversal, absolute and
+ * drive-letter paths, backslashes, control characters, alternate data streams and
+ * empty segments. Returned paths always use forward slashes.
+ */
+export function checkBundlePath(input) {
+    if (typeof input !== 'string' || input.length === 0)
+        return { ok: false, reason: 'path is empty' };
+    if (input.length > 240)
+        return { ok: false, reason: 'path is longer than 240 characters' };
+    // eslint-disable-next-line no-control-regex
+    if (/[\u0000-\u001f\u007f]/.test(input))
+        return { ok: false, reason: 'path contains control characters' };
+    if (input.includes('\\'))
+        return { ok: false, reason: 'path uses backslashes; use forward slashes' };
+    if (input.startsWith('/') || /^[A-Za-z]:/.test(input))
+        return { ok: false, reason: 'path is absolute' };
+    if (input.includes(':'))
+        return { ok: false, reason: 'path contains ":"' };
+    const segments = input.split('/');
+    for (const s of segments) {
+        if (s === '')
+            return { ok: false, reason: 'path has an empty segment' };
+        if (s === '.' || s === '..')
+            return { ok: false, reason: 'path contains "." or ".." segments' };
+        if (/[. ]$/.test(s))
+            return { ok: false, reason: 'path segment ends with "." or space' };
+        if (/^(con|prn|aux|nul|com[0-9]|lpt[0-9])(\..*)?$/i.test(s))
+            return { ok: false, reason: 'path segment is a reserved device name on Windows' };
+    }
+    return { ok: true, path: segments.join('/') };
+}
+const BUNDLE_ROOT_FILES = new Set(['guide.yaml', 'brief.yaml', 'checks.yaml', 'sources.yaml', 'assets.yaml']);
+/** Files that belong to a bundle: the five YAML files plus human/, operator/ and assets/. */
+export function isBundlePath(path) {
+    return BUNDLE_ROOT_FILES.has(path) || /^(human|operator|assets)\//.test(path);
+}
+export function resolveRelative(fromFile, rel) {
+    const base = fromFile.includes('/') ? fromFile.slice(0, fromFile.lastIndexOf('/')) : '';
+    const parts = (base ? base.split('/') : []).concat(rel.split('/'));
+    const out = [];
+    for (const p of parts) {
+        if (p === '' || p === '.')
+            continue;
+        if (p === '..') {
+            if (!out.length)
+                return undefined;
+            out.pop();
+        }
+        else
+            out.push(p);
+    }
+    return out.join('/');
+}
+const IGNORED_SEGMENTS = new Set(['.git', 'node_modules', '.DS_Store', 'Thumbs.db']);
+/** A label that never leaks absolute local paths: relative to the cwd when inside it, else the folder name. */
+export function defaultBundleLabel(root) {
+    const abs = resolve(root);
+    const rel = relative(process.cwd(), abs).replace(/\\/g, '/');
+    if (!rel)
+        return basename(abs);
+    return rel.startsWith('..') || isAbsolute(rel) ? basename(abs) : rel;
+}
+export function directorySource(root, label) {
+    const absRoot = resolve(root);
+    return {
+        label: label ?? defaultBundleLabel(root),
+        async list() {
+            const out = [];
+            async function walk(dir, prefix) {
+                const entries = await readdir(dir, { withFileTypes: true });
+                entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+                for (const e of entries) {
+                    if (IGNORED_SEGMENTS.has(e.name))
+                        continue;
+                    const rel = prefix ? `${prefix}/${e.name}` : e.name;
+                    const abs = resolve(dir, e.name);
+                    if (e.isSymbolicLink()) {
+                        out.push(`\u0000symlink:${rel}`);
+                    }
+                    else if (e.isDirectory())
+                        await walk(abs, rel);
+                    else if (e.isFile())
+                        out.push(rel);
+                }
+            }
+            await walk(absRoot, '');
+            return out;
+        },
+        async read(path) {
+            const check = checkBundlePath(path);
+            if (!check.ok)
+                throw new Error(`Unsafe bundle path "${path}": ${check.reason}`);
+            const abs = resolve(absRoot, check.path);
+            if (abs !== absRoot && !abs.startsWith(absRoot + sep))
+                throw new Error(`Path escapes the bundle root: ${path}`);
+            const st = await lstat(abs);
+            if (st.isSymbolicLink())
+                throw new Error(`Symbolic links are not allowed: ${path}`);
+            return new Uint8Array(await readFile(abs));
+        },
+    };
+}
+export function decodeFileContent(content) {
+    if (typeof content === 'string')
+        return toBytes(content);
+    return content.encoding === 'base64' ? new Uint8Array(Buffer.from(content.content, 'base64')) : toBytes(content.content);
+}
+export function memorySource(files, label = 'memory') {
+    const map = new Map();
+    const names = [];
+    for (const [name, value] of Object.entries(files)) {
+        names.push(name);
+        map.set(name, typeof value === 'string' || value instanceof Uint8Array ? toBytes(value) : decodeFileContent(value));
+    }
+    return {
+        label,
+        async list() {
+            return [...names].sort();
+        },
+        async read(path) {
+            const v = map.get(path);
+            if (!v)
+                throw new Error(`File not found: ${path}`);
+            return v;
+        },
+    };
+}
+/** Read an uploaded ZIP with bounded extraction and traversal checks. */
+export async function zipSource(data, limits = DEFAULT_LIMITS, label = 'upload.zip') {
+    const zip = await JSZip.loadAsync(data, { checkCRC32: true });
+    const entries = Object.values(zip.files).filter((f) => !f.dir);
+    if (entries.length > limits.maxFiles) {
+        throw Object.assign(new Error(`Archive has ${entries.length} files; the limit is ${limits.maxFiles}.`), {
+            code: 'BUNDLE_LIMIT_EXCEEDED',
+        });
+    }
+    let total = 0;
+    const files = {};
+    for (const entry of entries.sort((a, b) => (a.name < b.name ? -1 : 1))) {
+        // JSZip exposes the declared size internally; verify it before inflating.
+        const declared = entry._data?.uncompressedSize;
+        if (typeof declared === 'number' && declared > limits.maxFileBytes) {
+            throw Object.assign(new Error(`Archive entry ${entry.name} is ${declared} bytes; the limit is ${limits.maxFileBytes}.`), {
+                code: 'BUNDLE_LIMIT_EXCEEDED',
+            });
+        }
+        if (typeof declared === 'number' && total + declared > limits.maxTotalBytes) {
+            throw Object.assign(new Error(`Archive exceeds the ${limits.maxTotalBytes}-byte extraction limit.`), {
+                code: 'BUNDLE_LIMIT_EXCEEDED',
+            });
+        }
+        const bytes = await entry.async('uint8array');
+        total += bytes.length;
+        if (bytes.length > limits.maxFileBytes || total > limits.maxTotalBytes) {
+            throw Object.assign(new Error('Archive exceeds extraction limits.'), { code: 'BUNDLE_LIMIT_EXCEEDED' });
+        }
+        files[entry.name] = bytes;
+    }
+    return memorySource(files, label);
+}
+/* ------------------------------ loaded files ----------------------------- */
+export class BundleFiles {
+    label;
+    map;
+    constructor(label, map) {
+        this.label = label;
+        this.map = map;
+    }
+    has(path) {
+        return this.map.has(path);
+    }
+    bytes(path) {
+        return this.map.get(path);
+    }
+    text(path) {
+        const b = this.map.get(path);
+        return b ? fromBytes(b) : undefined;
+    }
+    paths() {
+        return [...this.map.keys()].sort();
+    }
+    entries() {
+        return this.paths().map((p) => [p, this.map.get(p)]);
+    }
+    toRecord() {
+        const out = {};
+        for (const [p, b] of this.entries())
+            out[p] = fromBytes(b);
+        return out;
+    }
+    with(path, value) {
+        const next = new Map(this.map);
+        if (value === null)
+            next.delete(path);
+        else
+            next.set(path, toBytes(value));
+        return new BundleFiles(this.label, next);
+    }
+}
+/** Load every file from a source into memory with limits and path safety diagnostics. */
+export async function loadBundleFiles(source, limits = DEFAULT_LIMITS) {
+    const diagnostics = [];
+    const map = new Map();
+    let names;
+    try {
+        names = await source.list();
+    }
+    catch (e) {
+        return {
+            files: new BundleFiles(source.label, map),
+            diagnostics: [
+                {
+                    code: 'BUNDLE_FILE_MISSING',
+                    severity: 'error',
+                    path: '.',
+                    message: `Cannot read the bundle at ${source.label}: ${e.message}`,
+                },
+            ],
+        };
+    }
+    if (names.length > limits.maxFiles) {
+        diagnostics.push({
+            code: 'BUNDLE_LIMIT_EXCEEDED',
+            severity: 'error',
+            path: '.',
+            message: `The bundle has ${names.length} files; the limit is ${limits.maxFiles}.`,
+        });
+        names = names.slice(0, limits.maxFiles);
+    }
+    let total = 0;
+    for (const name of names) {
+        if (name.startsWith('\u0000symlink:')) {
+            diagnostics.push({
+                code: 'BUNDLE_PATH_UNSAFE',
+                severity: 'error',
+                path: name.slice('\u0000symlink:'.length),
+                message: 'Symbolic links are not allowed in a bundle.',
+            });
+            continue;
+        }
+        const check = checkBundlePath(name);
+        if (!check.ok) {
+            diagnostics.push({
+                code: 'BUNDLE_PATH_UNSAFE',
+                severity: 'error',
+                path: name,
+                message: `Unsafe path: ${check.reason}.`,
+            });
+            continue;
+        }
+        // Only bundle content is read; stray files next to a bundle never change its revision.
+        if (!isBundlePath(check.path))
+            continue;
+        try {
+            const bytes = await source.read(check.path);
+            total += bytes.length;
+            if (bytes.length > limits.maxFileBytes || total > limits.maxTotalBytes) {
+                diagnostics.push({
+                    code: 'BUNDLE_LIMIT_EXCEEDED',
+                    severity: 'error',
+                    path: check.path,
+                    message: 'The file exceeds the configured size limits.',
+                });
+                continue;
+            }
+            map.set(check.path, bytes);
+        }
+        catch (e) {
+            diagnostics.push({
+                code: 'BUNDLE_FILE_MISSING',
+                severity: 'error',
+                path: check.path,
+                message: e.message,
+            });
+        }
+    }
+    return { files: new BundleFiles(source.label, map), diagnostics };
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

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