@uwmd/core 1.1.2 → 1.5.0

package/dist/composition.js

@@ -0,0 +1,536 @@
+// Composable UWX documents (RFC 0021) — fragments and section externalization.
+//
+// One invariant carries the whole design:
+//
+//   I-1 (Digest invariance). A record with externalized parts, resolved, has
+//   the same semantic digest as the byte-identical inline record in which every
+//   part has been substituted in place.
+//
+// Composition is therefore a *packaging* decision, not a modelling one:
+// externalizing a section does not change what the record means, does not
+// invalidate a receipt over the resolved form, and is not a Tier-2 edit.
+//
+// Everything here exists to make I-1 hold, and two things about it are less
+// obvious than the RFC's statement of the rule suggests:
+//
+//   1. The semantic value includes the block's `annotation` and `prose`, not
+//      just its content (see `toEnvelopeBlock` in `envelope.ts`). A resolved
+//      block that kept `external=true` in its fence annotation would digest
+//      differently from its inline twin and I-1 would fail on every fixture.
+//      Resolution therefore normalizes the annotation.
+//   2. Merge order cannot come from `parts` order or archive order, or the same
+//      forty rows would canonicalize two ways. Rows are sorted by the declared
+//      collection key under a byte-wise total order.
+//
+// Browser-safe: no I/O. Resolution reads parts a caller has already supplied,
+// and never performs network or filesystem access — a reference pointing
+// outside the package is unresolvable, not fetched.
+import { isStandardSectionId } from './protocol.js';
+// ─── Representation ──────────────────────────────────────────────────────────
+export const UWPART_EXTENSION = '.uwpart.md';
+export const UWPART_MEDIA_TYPE = 'text/vnd.uwmd.part+markdown';
+export const UWPART_REPRESENTATION_ID = 'uwx-part-markdown';
+export const UWPART_VERSION = '1.0';
+/**
+ * The annotation key marking a section block as externalized. Stripped during
+ * resolution — see the note on I-1 above.
+ */
+export const EXTERNAL_ANNOTATION_KEY = 'external';
+export class CompositionError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[${code}] ${message}`);
+        this.name = 'CompositionError';
+        this.code = code;
+    }
+}
+function compError(code, message, pointer) {
+    return { category: 'validate', code, message, ...(pointer ? { pointer } : {}) };
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function nonEmptyString(v) {
+    return typeof v === 'string' && v.trim() !== '';
+}
+/**
+ * Read a fragment from an already-parsed file.
+ *
+ * A fragment must parse standalone — that is a hard requirement, not a nicety.
+ * A fragment only understandable in the context of its parent is not
+ * independently reviewable and cannot be usefully content-addressed.
+ */
+export function parseUWPart(parsed, opts = {}) {
+    const fm = parsed.frontmatter;
+    const where = opts.filename ? ` (${opts.filename})` : '';
+    if (!nonEmptyString(fm['uwpart_version'])) {
+        throw new CompositionError('COMP-PART-MALFORMED', `Fragment requires uwpart_version${where}.`);
+    }
+    if (!nonEmptyString(fm['part_id'])) {
+        throw new CompositionError('COMP-PART-MALFORMED', `Fragment requires part_id${where}.`);
+    }
+    if (!nonEmptyString(fm['section'])) {
+        throw new CompositionError('COMP-PART-MALFORMED', `Fragment requires section${where}.`);
+    }
+    // A fragment is not an underwriting record and must never be presented as
+    // one; carrying a deal_id is the cheapest way for that to happen.
+    if ('deal_id' in fm) {
+        throw new CompositionError('COMP-PART-MALFORMED', `A fragment MUST NOT carry deal_id${where} — it is not an underwriting record.`);
+    }
+    const section = fm['section'];
+    if (!isStandardSectionId(section) && !section.startsWith('x_')) {
+        throw new CompositionError('COMP-PART-MALFORMED', `Fragment declares section '${section}', which the format does not register${where}.`);
+    }
+    const blocks = [];
+    for (const [sectionId, entry] of Object.entries(parsed.sections)) {
+        const found = isRecord(entry) && 'annotation' in entry
+            ? [entry]
+            : Object.values(entry);
+        // A fragment must not contribute to two sections — that is what two
+        // fragments are for.
+        if (sectionId !== section) {
+            throw new CompositionError('COMP-SECTION-MISMATCH', `Fragment '${fm['part_id']}' declares section '${section}' but carries a block for '${sectionId}'${where}.`);
+        }
+        blocks.push(...found);
+    }
+    if (blocks.length === 0) {
+        throw new CompositionError('COMP-PART-MALFORMED', `Fragment '${fm['part_id']}' carries no block for section '${section}'${where}.`);
+    }
+    return {
+        part_id: fm['part_id'],
+        section,
+        collection_member: fm['collection_member'] === true,
+        blocks,
+    };
+}
+export function validateExternalDirective(candidate) {
+    const errors = [];
+    if (!isRecord(candidate)) {
+        return [compError('COMP-DIRECTIVE-MALFORMED', 'external must be an object.')];
+    }
+    const d = candidate;
+    if (!Array.isArray(d.parts) || d.parts.some((p) => !nonEmptyString(p))) {
+        errors.push(compError('COMP-DIRECTIVE-MALFORMED', 'external.parts must be an array of part ids.', 'external.parts'));
+    }
+    else if (d.parts.length === 0) {
+        errors.push(compError('COMP-DIRECTIVE-MALFORMED', 'external.parts must not be empty.', 'external.parts'));
+    }
+    else {
+        const seen = new Set();
+        for (const p of d.parts) {
+            if (seen.has(p)) {
+                errors.push(compError('COMP-DUP-KEY', `external.parts names '${p}' more than once.`, 'external.parts'));
+            }
+            seen.add(p);
+        }
+    }
+    // Redundant on purpose. A truncated `parts` array is then a detectable error
+    // rather than a silently smaller rent roll — which still totals, still
+    // validates, and still produces a confident DSCR.
+    if (typeof d.part_count !== 'number' || !Number.isInteger(d.part_count)) {
+        errors.push(compError('COMP-DIRECTIVE-MALFORMED', 'external.part_count must be an integer.', 'external.part_count'));
+    }
+    else if (Array.isArray(d.parts) && d.part_count !== d.parts.length) {
+        errors.push(compError('COMP-COUNT-MISMATCH', `external.part_count is ${d.part_count} but parts lists ${d.parts.length}.`, 'external.part_count'));
+    }
+    if (d.collection_key !== undefined && !nonEmptyString(d.collection_key)) {
+        errors.push(compError('COMP-DIRECTIVE-MALFORMED', 'external.collection_key must be a non-empty string.', 'external.collection_key'));
+    }
+    if (d.collection_path !== undefined && !nonEmptyString(d.collection_path)) {
+        errors.push(compError('COMP-DIRECTIVE-MALFORMED', 'external.collection_path must be a non-empty string.', 'external.collection_path'));
+    }
+    return errors;
+}
+/** Read the directive off a section block, or null when the section is inline. */
+export function readExternalDirective(block) {
+    const external = block.content['external'];
+    if (external === undefined)
+        return null;
+    const errors = validateExternalDirective(external);
+    if (errors.length > 0) {
+        throw new CompositionError(errors[0].code, errors.map((e) => e.message).join('; '));
+    }
+    return external;
+}
+/**
+ * Byte-wise total order on the UTF-8 key. `localeCompare` would be
+ * locale-dependent and so would make the canonical form — and therefore the
+ * digest — vary by machine, which is exactly what I-1 forbids.
+ */
+function byteCompare(a, b) {
+    const left = new TextEncoder().encode(a);
+    const right = new TextEncoder().encode(b);
+    const n = Math.min(left.length, right.length);
+    for (let i = 0; i < n; i++) {
+        if (left[i] !== right[i])
+            return left[i] - right[i];
+    }
+    return left.length - right.length;
+}
+/**
+ * Strip the externalization marker from a fence annotation, so a resolved block
+ * carries the annotation its inline equivalent would. Without this I-1 fails:
+ * the envelope's semantic value includes `annotation`, not only `content`.
+ */
+function inlineAnnotation(annotation) {
+    const { [EXTERNAL_ANNOTATION_KEY]: _external, ...rest } = annotation;
+    return rest;
+}
+function sectionBlocks(entry) {
+    return isRecord(entry) && 'annotation' in entry
+        ? [entry]
+        : Object.values(entry);
+}
+/**
+ * Resolve every externalized section into its inline equivalent.
+ *
+ * Returns `unresolved` rather than throwing when a part is missing, because a
+ * record referencing a fragment the caller does not hold is *undecidable*, not
+ * wrong — the same distinction the receipt verifier draws with `unverifiable`.
+ * A missing part never yields a smaller collection.
+ */
+export function resolveComposition(parsed, opts) {
+    const issues = [];
+    const externalized = [];
+    const sections = { ...parsed.sections };
+    for (const [sectionId, entry] of Object.entries(parsed.sections)) {
+        const blocks = sectionBlocks(entry);
+        if (blocks.length !== 1)
+            continue;
+        const block = blocks[0];
+        let directive;
+        try {
+            directive = readExternalDirective(block);
+        }
+        catch (e) {
+            issues.push(compError(e.code, e.message, sectionId));
+            continue;
+        }
+        if (!directive)
+            continue;
+        externalized.push(sectionId);
+        const resolvedParts = [];
+        let missing = false;
+        for (const partId of directive.parts) {
+            const part = opts.parts.get(partId);
+            if (!part) {
+                issues.push(compError('COMP-UNRESOLVED', `Part '${partId}' does not resolve within this package.`, `${sectionId}.external.parts`));
+                missing = true;
+                continue;
+            }
+            if (part.section !== sectionId) {
+                issues.push(compError('COMP-SECTION-MISMATCH', `Part '${partId}' declares section '${part.section}' but is referenced from '${sectionId}'.`, `${sectionId}.external.parts`));
+                missing = true;
+                continue;
+            }
+            resolvedParts.push(part);
+        }
+        if (missing)
+            continue;
+        const collectionParts = resolvedParts.filter((p) => p.collection_member);
+        const wholeParts = resolvedParts.filter((p) => !p.collection_member);
+        if (collectionParts.length > 0 && wholeParts.length > 0) {
+            issues.push(compError('COMP-DIRECTIVE-MALFORMED', `Section '${sectionId}' mixes collection-member fragments with whole-section fragments.`, sectionId));
+            continue;
+        }
+        // Whole-section: exactly one fragment supplies the section.
+        if (wholeParts.length > 0) {
+            if (wholeParts.length !== 1) {
+                issues.push(compError('COMP-DIRECTIVE-MALFORMED', `Section '${sectionId}' names ${wholeParts.length} whole-section fragments; exactly one supplies a section.`, sectionId));
+                continue;
+            }
+            const source = wholeParts[0].blocks[0];
+            sections[sectionId] = {
+                ...block,
+                annotation: inlineAnnotation(block.annotation),
+                content: source.content,
+            };
+            continue;
+        }
+        // Collection: merge rows, keyed and totally ordered.
+        if (!directive.collection_key) {
+            issues.push(compError('COMP-DIRECTIVE-MALFORMED', `Section '${sectionId}' composes collection fragments but declares no collection_key.`, `${sectionId}.external.collection_key`));
+            continue;
+        }
+        if (!directive.collection_path) {
+            issues.push(compError('COMP-DIRECTIVE-MALFORMED', `Section '${sectionId}' composes collection fragments but declares no collection_path naming where rows land.`, `${sectionId}.external.collection_path`));
+            continue;
+        }
+        const rows = [];
+        const seenKeys = new Map();
+        let conflicted = false;
+        for (const part of collectionParts) {
+            for (const b of part.blocks) {
+                const { _meta: _dropped, ...row } = b.content;
+                const key = row[directive.collection_key];
+                if (!nonEmptyString(key)) {
+                    issues.push(compError('COMP-DIRECTIVE-MALFORMED', `Part '${part.part_id}' has no usable '${directive.collection_key}' value.`, `${sectionId}.external.collection_key`));
+                    conflicted = true;
+                    continue;
+                }
+                const prior = seenKeys.get(key);
+                if (prior !== undefined) {
+                    // Never last-one-wins: two fragments claiming suite 210 is a conflict
+                    // a human resolves, not an ordering question.
+                    issues.push(compError('COMP-DUP-KEY', `Parts '${prior}' and '${part.part_id}' both claim ${directive.collection_key} '${key}'.`, sectionId));
+                    conflicted = true;
+                    continue;
+                }
+                seenKeys.set(key, part.part_id);
+                rows.push(row);
+            }
+        }
+        if (conflicted)
+            continue;
+        rows.sort((a, b) => byteCompare(String(a[directive.collection_key]), String(b[directive.collection_key])));
+        const { external: _external, ...rest } = block.content;
+        sections[sectionId] = {
+            ...block,
+            annotation: inlineAnnotation(block.annotation),
+            content: { ...rest, [directive.collection_path]: rows },
+        };
+    }
+    return {
+        status: issues.length > 0 ? 'unresolved' : 'resolved',
+        document: { ...parsed, sections: sections },
+        issues,
+        externalized,
+    };
+}
+// ─── Composites and recursion (RFC 0021 §4) ──────────────────────────────────
+/**
+ * Depth and member bounds. These mirror the safe-ZIP limits and exist for the
+ * same reason: a nested-package expansion is a decompression bomb wearing a
+ * different hat.
+ */
+export const DEFAULT_MAX_COMPOSITION_DEPTH = 8;
+export const DEFAULT_MAX_COMPOSITION_MEMBERS = 4096;
+/**
+ * Walk the composition DAG, enforcing the normative bounds.
+ *
+ * Resolution performs no network or filesystem access: members resolve from
+ * what the caller already holds. A reference pointing outside the package is
+ * unresolvable, never fetched — that is what keeps a package offline-verifiable
+ * and keeps validation from writing untrusted bytes anywhere.
+ */
+export function resolveComposite(opts) {
+    const maxDepth = opts.maxDepth ?? DEFAULT_MAX_COMPOSITION_DEPTH;
+    const maxMembers = opts.maxMembers ?? DEFAULT_MAX_COMPOSITION_MEMBERS;
+    const issues = [];
+    const known = new Set(opts.members);
+    const childrenOf = new Map();
+    for (const link of opts.links) {
+        if (!known.has(link.from)) {
+            issues.push(compError('COMP-UNRESOLVED', `Link names child '${link.from}', which is not a member of this package.`));
+            continue;
+        }
+        if (!known.has(link.to)) {
+            issues.push(compError('COMP-UNRESOLVED', `Link names parent '${link.to}', which is not a member of this package.`));
+            continue;
+        }
+        const list = childrenOf.get(link.to) ?? [];
+        list.push(link.from);
+        childrenOf.set(link.to, list);
+    }
+    if (issues.length > 0) {
+        return { status: 'unresolved', order: [], depth: 0, member_count: 0, stale: [], issues };
+    }
+    if (known.size > maxMembers) {
+        return {
+            status: 'unresolved',
+            order: [],
+            depth: 0,
+            member_count: known.size,
+            stale: [],
+            issues: [compError('COMP-DEPTH', `Package holds ${known.size} members, above the bound of ${maxMembers}.`)],
+        };
+    }
+    // Roots are members nothing contributes to.
+    const isChild = new Set(opts.links.map((l) => l.from));
+    const roots = [...known].filter((id) => !isChild.has(id)).sort();
+    const order = [];
+    const finished = new Set();
+    const onPath = new Set();
+    let deepest = 0;
+    const stale = [];
+    // Iterative DFS: a recursive walk would blow the JS stack before hitting the
+    // depth bound on a hostile graph, turning a clean COMP-DEPTH into a crash.
+    const walk = (root) => {
+        const stack = [
+            { id: root, depth: 1, expanded: false },
+        ];
+        while (stack.length > 0) {
+            const frame = stack[stack.length - 1];
+            if (frame.expanded) {
+                stack.pop();
+                onPath.delete(frame.id);
+                if (!finished.has(frame.id)) {
+                    finished.add(frame.id);
+                    order.push(frame.id);
+                }
+                continue;
+            }
+            frame.expanded = true;
+            deepest = Math.max(deepest, frame.depth);
+            if (frame.depth > maxDepth) {
+                issues.push(compError('COMP-DEPTH', `Composition depth ${frame.depth} at '${frame.id}' exceeds the bound of ${maxDepth}.`));
+                return false;
+            }
+            if (onPath.has(frame.id)) {
+                issues.push(compError('COMP-CYCLE', `Composition cycle reaches '${frame.id}' again.`));
+                return false;
+            }
+            onPath.add(frame.id);
+            for (const child of (childrenOf.get(frame.id) ?? []).slice().sort()) {
+                if (onPath.has(child)) {
+                    issues.push(compError('COMP-CYCLE', `Composition cycle: '${frame.id}' and '${child}' are mutually reachable.`));
+                    return false;
+                }
+                // Staleness is checked on the edge, because the recorded digest belongs
+                // to the parent's view of the child, not to the child.
+                const recorded = opts.recordedDigests?.get(`${frame.id}::${child}`);
+                const actual = opts.actualDigests?.get(child);
+                if (recorded !== undefined && actual !== undefined && recorded !== actual) {
+                    stale.push({ parent: frame.id, child, recorded, actual });
+                }
+                if (!finished.has(child)) {
+                    stack.push({ id: child, depth: frame.depth + 1, expanded: false });
+                }
+            }
+        }
+        return true;
+    };
+    for (const root of roots) {
+        if (!walk(root)) {
+            return { status: 'unresolved', order: [], depth: deepest, member_count: known.size, stale, issues };
+        }
+    }
+    // Any member never reached from a root sits in a cycle: it has a parent, but
+    // no root leads to it.
+    if (finished.size !== known.size) {
+        const unreached = [...known].filter((id) => !finished.has(id)).sort();
+        issues.push(compError('COMP-CYCLE', `Members unreachable from any root, indicating a cycle: ${unreached.join(', ')}.`));
+        return { status: 'unresolved', order: [], depth: deepest, member_count: known.size, stale, issues };
+    }
+    return {
+        status: stale.length > 0 ? 'stale' : 'resolved',
+        order,
+        depth: deepest,
+        member_count: known.size,
+        stale,
+        issues,
+    };
+}
+/**
+ * Split a collection section into fragments, leaving a directive behind.
+ *
+ * This is the inverse of `resolveComposition`, and the pair is what makes
+ * externalizing a packaging decision rather than a modelling one: resolving the
+ * output of this function MUST reproduce the input's canonical form. That is
+ * I-1 read backwards, and it is asserted as a round-trip rather than assumed.
+ */
+export function externalizeSection(parsed, opts) {
+    const entry = parsed.sections[opts.section];
+    if (entry === undefined) {
+        throw new CompositionError('COMP-SECTION-MISMATCH', `Record has no section '${opts.section}' to externalize.`);
+    }
+    const blocks = sectionBlocks(entry);
+    if (blocks.length !== 1) {
+        throw new CompositionError('COMP-SECTION-MISMATCH', `Section '${opts.section}' holds ${blocks.length} blocks; externalization expects exactly one.`);
+    }
+    const block = blocks[0];
+    const content = block.content;
+    if (content['external'] !== undefined) {
+        throw new CompositionError('COMP-DIRECTIVE-MALFORMED', `Section '${opts.section}' is already externalized.`);
+    }
+    const rows = content[opts.collectionPath];
+    if (!Array.isArray(rows) || rows.length === 0) {
+        throw new CompositionError('COMP-DIRECTIVE-MALFORMED', `Section '${opts.section}' has no non-empty collection at '${opts.collectionPath}'.`);
+    }
+    const prefix = opts.partIdPrefix ?? opts.section;
+    const parts = [];
+    const seen = new Set();
+    for (const row of rows) {
+        if (!isRecord(row)) {
+            throw new CompositionError('COMP-DIRECTIVE-MALFORMED', `Collection '${opts.collectionPath}' holds a non-object row.`);
+        }
+        const key = row[opts.collectionKey];
+        if (!nonEmptyString(key)) {
+            throw new CompositionError('COMP-DIRECTIVE-MALFORMED', `A row has no usable '${opts.collectionKey}' value, so it cannot be addressed as a fragment.`);
+        }
+        if (seen.has(key)) {
+            throw new CompositionError('COMP-DUP-KEY', `Two rows claim ${opts.collectionKey} '${key}'; the source collection is already inconsistent.`);
+        }
+        seen.add(key);
+        parts.push({
+            part_id: `${prefix}-${key}`,
+            section: opts.section,
+            collection_member: true,
+            blocks: [
+                {
+                    ...block,
+                    annotation: inlineAnnotation(block.annotation),
+                    // The fragment is independently reviewable, so it carries the
+                    // section's provenance. Resolution drops it again (§3.7): inline
+                    // rows are plain objects, and I-1 requires the merge to match them.
+                    content: { _meta: content['_meta'], ...row },
+                },
+            ],
+        });
+    }
+    // Byte-wise on the key, matching resolution's merge order, so the directive
+    // lists parts in the order they will come back.
+    parts.sort((a, b) => byteCompare(a.part_id, b.part_id));
+    const { [opts.collectionPath]: _rows, ...restContent } = content;
+    const directive = {
+        parts: parts.map((p) => p.part_id),
+        collection_key: opts.collectionKey,
+        collection_path: opts.collectionPath,
+        part_count: parts.length,
+    };
+    const sections = { ...parsed.sections };
+    sections[opts.section] = {
+        ...block,
+        annotation: { ...block.annotation, [EXTERNAL_ANNOTATION_KEY]: true },
+        content: { ...restContent, external: directive },
+    };
+    return {
+        document: { ...parsed, sections: sections },
+        parts,
+    };
+}
+/** Section id → a readable heading, e.g. `rent_roll` → `Rent Roll`. */
+function sectionHeading(section) {
+    return section
+        .split('_')
+        .map((w) => (w.length > 0 ? w[0].toUpperCase() + w.slice(1) : w))
+        .join(' ');
+}
+/**
+ * Serialize a fragment to `.uwpart.md` source.
+ *
+ * A fragment must parse standalone, so this emits the frontmatter and a single
+ * section block — everything `parseUWPart` needs and nothing that would make
+ * the file readable only in the context of its parent.
+ */
+export function stringifyUWPart(part) {
+    const lines = [
+        '---',
+        `uwpart_version: "${UWPART_VERSION}"`,
+        `part_id: ${part.part_id}`,
+        `section: ${part.section}`,
+        ...(part.collection_member ? ['collection_member: true'] : []),
+        '---',
+        '',
+        `## ${sectionHeading(part.section)} {#${part.section}}`,
+        '',
+    ];
+    for (const block of part.blocks) {
+        lines.push(`\`\`\`json uw:section=${part.section} v=1`);
+        lines.push(JSON.stringify(block.content, null, 2));
+        lines.push('```');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=composition.js.map

package/dist/composition.js.map

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

package/dist/deal-package-context.d.ts

@@ -0,0 +1,52 @@
+import { UW_PACKAGE_VERSION, type UWDealPackageManifest, type UWPackageMember, type UWSourceReference } from './deal-package.js';
+import type { ProtocolError } from './protocol.js';
+export interface UWContextContent {
+    kind: 'utf8';
+    text: string;
+}
+export type UWSourceEvidenceDescriptor = {
+    status: 'not_transferred';
+} | {
+    status: 'reference';
+    reference: UWSourceReference[];
+};
+export interface UWDealPackageContext {
+    package_version: typeof UW_PACKAGE_VERSION;
+    package_id: string;
+    members: UWPackageMember[];
+    links: UWDealPackageManifest['links'];
+    contents: Record<string, UWContextContent>;
+    source_evidence: Record<string, UWSourceEvidenceDescriptor>;
+    /** Present and true so a consumer cannot mistake a view for an archive. */
+    incomplete_evidence_context: true;
+}
+export interface ProjectContextOptions {
+    /**
+     * Member id → exact UTF-8 bytes. Supplied by the caller because this module
+     * performs no I/O. A member with inlinable role and no supplied text is
+     * omitted from `contents` rather than guessed at.
+     */
+    contents?: Record<string, string>;
+    /** Member id → typed reference handles for source evidence. */
+    references?: Record<string, UWSourceReference[]>;
+}
+export declare function projectUWDealPackageContext(manifest: UWDealPackageManifest, options?: ProjectContextOptions): UWDealPackageContext;
+/**
+ * Validate a context view. Beyond shape, this enforces the §4 rules that make
+ * the view safe to hand to a model:
+ *
+ *   - every `contents` key references a manifest member with an inlinable role;
+ *   - no `contents` key references source evidence or an unlisted member; and
+ *   - every source-evidence member is described, never embedded.
+ */
+export declare function validateUWDealPackageContext(candidate: unknown): ProtocolError[];
+/**
+ * Verify inline payloads against their declared byte digests.
+ *
+ * Kept separate from `validateUWDealPackageContext` because it needs a digest
+ * function the caller supplies — core does not import a hashing implementation
+ * here, and the browser and Node paths differ. A context whose inline bytes do
+ * not match the manifest is a verification failure, not a shape error.
+ */
+export declare function verifyContextContentDigests(ctx: UWDealPackageContext, sha256Hex: (bytes: Uint8Array) => Promise<string>): Promise<ProtocolError[]>;
+//# sourceMappingURL=deal-package-context.d.ts.map

package/dist/deal-package-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deal-package-context.d.ts","sourceRoot":"","sources":["../src/deal-package-context.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,OAAO,kBAAkB,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,2BAA2B,EAAE,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;CAClD;AAMD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAmCtB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,EAAE,CAmEhF;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,oBAAoB,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GAChD,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B"}