@silvermoon-work/ipfs-payload 0.0.0-stage → 0.1.0-rc.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 preset-pnpm-monorepo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,103 @@
-# Temporary Holding Version
+# @silvermoon-work/ipfs-payload
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Pure typed references, self-contained JSON payloads and canonical DAG-CBOR.
+No Store, Task SDK, Engine, file-tree dependency, network, pin or content access.
+
+```ts
+import { Type, type Static } from "@sinclair/typebox";
+import {
+  ContentRef, ContentRefSchema, encodePayload, decodePayload,
+  encodePayloadBlock, decodePayloadBlock,
+} from "@silvermoon-work/ipfs-payload";
+
+const schema = Type.Object({
+  document: ContentRefSchema(),
+  label: Type.String(),
+});
+const parameters: Static<typeof schema> = {
+  document: ContentRef.fromCID(targetCid),
+  label: targetCid.toString(), // ordinary business text
+};
+const json = encodePayload(schema, parameters);
+// { data: { document: "...", label: "..." }, cidPaths: ['$["document"]'] }
+const restored = decodePayload(json, schema);
+restored.document.cid; // native CID; no read methods or path
+const block = await encodePayloadBlock(json, schema);
+const roundTrip = await decodePayloadBlock(block.bytes, schema, { cid: block.cid });
+```
+
+`ContentRefSchema()` is a TypeBox extension with `Static<> = ContentRef`, a
+registered author-side TypeBox validator, and serializable
+`{ type: "string", "x-ipfs-content-ref": true }` semantics. The package's codecs
+validate this keyword and the complete business schema; an unrelated JSON
+Schema validator ignoring the keyword is **not** sufficient. Current Task
+Builder/Engine protocol integration is a later phase, not added by this package.
+Author fields require `ContentRef.fromCID(CID | string)`, not untyped strings,
+lookalike `{ cid }` objects or bare native CIDs. References retain immutable
+identity only; reading an exposed CID cannot mutate the original identity.
+
+## Conversions and validation
+
+- `encodePayload(schema, author, options?)` produces `IpfsPayload<JsonOf<T>>`.
+- `validatePayload(unknown, schema?, options?)` validates and snapshots the
+  exact `{ data, cidPaths }` envelope.
+- `decodePayload(payload, schema?, options?)` restores `ContentRef` only at
+  marked positions. Without a schema it validates the self-contained descriptor,
+  not an absent business contract; admission must supply the contract.
+- `toDagPayload` / `fromDagPayload` convert the same envelope between JSON and
+  logical DAG values. Marked fields become genuine `multiformats` CID links.
+  Every actual link must agree with the metadata, in both directions.
+- `encodePayloadBlock` returns `{ cid, bytes }` using DAG-CBOR and SHA-256.
+  `decodePayloadBlock` rejects noncanonical encodings and, when supplied,
+  verifies `options.cid`. Neither function stores anything.
+
+All conversions snapshot without invoking getters, `toJSON` or prototype
+properties. Ordinary strings, `{ cid: "..." }`, `{ "/": "..." }` and even
+CID-shaped business objects stay ordinary. `./dag-cbor` exposes `encodeDagCbor`
+plus the standard codec `code`/`decode` for generic structured blocks: it reuses
+the standard DAG-CBOR encoder options with identity-only CID detection, rather
+than its permissive object-shape detection. `asNativeCID` rebases native instances
+from separately loaded modern multiformats modules using data descriptors, never
+getters or plain JSON object shapes. This subpath loads no TypeBox/AJV.
+
+Finite JSON primitives, objects, arrays and tuples are supported. Sparse arrays,
+undefined, custom prototypes, cycles, nonfinite numbers, negative zero, unsafe
+integers and malformed Unicode fail rather than silently changing on round trip.
+References may contain syntactically valid CIDs; host codec/hash allowlists and
+target integrity/availability are separate Store responsibilities.
+
+## Contracts and bounded paths
+
+Supported schemas are the JSON-compatible TypeBox primitives, literals/enums,
+objects, optional properties, homogeneous arrays, tuples, and unions. Common
+JSON Schema value constraints are enforced by AJV in strict mode. Reference
+unions require uniquely distinguishing **required literal object properties**;
+direct `ContentRef | string`, optional/duplicate discriminators and ambiguous
+branches fail. Reference-bearing non-object unions (including nullable direct
+refs) are intentionally unsupported; use a tagged object union. `$ref`, recursive
+schemas, transforms, intersections, patternProperties, formats and schema-valued
+tuple additionalItems are rejected explicitly, not ignored.
+
+Paths are relative to `data`. `parseCidPath` accepts only `$`, bracket properties,
+nonnegative fixed array indices, array `[*]`, and array literal filters such as
+`$["items"][?@["kind"] == "reference"]["value"]`. Quoted strings may use single
+or double quotes with JSON escapes. No recursive descent, slices, functions,
+logical expressions, evaluation or arbitrary query scripts are supported.
+
+Encoding derives paths from the contract **and actual discriminator branches**.
+It uses wildcards/filters only when they match no extra positions, otherwise
+falls back to concrete indices. Re-encoding recomposed results recalculates
+positions. Validation compares the exact selected location sets; missing, extra,
+duplicate or overlapping matches fail. Optional/empty paths may match nothing;
+with a contract such zero-match paths must be schema-declared.
+
+`options.limits` may bound path count (default 1,024), each path's length (4,096),
+structure/path depth (64), cumulative visited/evaluated nodes (100,000), and
+JSON/encoded block bytes (2 MiB). Schema inspection and repeated path evaluation
+consume the same operation budget. Canonical encoding fixes CBOR map ordering,
+numbers and CID tags, not the semantic equivalence of differently written
+but valid path expressions. Fixed byte/CID vectors are in `test/payload.test.ts`.
+
+Encoding does not prove targets exist; pinning does not commit a business fact.
+SQLite remains the authority. Finalized RunHistory assembly, retention intent
+management and Task protocol switching are outside this foundation package.

package/dist/content-ref.d.ts

@@ -0,0 +1,9 @@
+import { CID } from "multiformats/cid";
+/** Immutable identity only; no reads, paths, credentials or host authority. */
+export declare class ContentRef {
+    #private;
+    private constructor();
+    static fromCID(value: CID | string): ContentRef;
+    get cid(): CID;
+}
+//# sourceMappingURL=content-ref.d.ts.map

package/dist/content-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-ref.d.ts","sourceRoot":"","sources":["../src/content-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,+EAA+E;AAC/E,qBAAa,UAAU;;IAErB,OAAO;IAIP,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,UAAU;IAK/C,IAAI,GAAG,IAAI,GAAG,CAEb;CACF"}

package/dist/content-ref.js

@@ -0,0 +1,19 @@
+import { CID } from "multiformats/cid";
+/** Immutable identity only; no reads, paths, credentials or host authority. */
+export class ContentRef {
+    #value;
+    constructor(cid) {
+        this.#value = cid.toString();
+        Object.freeze(this);
+    }
+    static fromCID(value) {
+        const cid = typeof value === "string" ? CID.parse(value) : CID.asCID(value);
+        if (!cid)
+            throw new Error("Expected a CID.");
+        return new ContentRef(CID.decode(cid.bytes));
+    }
+    get cid() {
+        return CID.parse(this.#value);
+    }
+}
+//# sourceMappingURL=content-ref.js.map

package/dist/content-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-ref.js","sourceRoot":"","sources":["../src/content-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,OAAO,UAAU;IACZ,MAAM,CAAS;IACxB,YAAoB,GAAQ;QAC1B,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,KAAmB;QAChC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7C,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG;QACL,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/contract.d.ts

@@ -0,0 +1,9 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { Budget, type JsonValue } from "./value.js";
+export declare function addContentRefKeyword(ajv: Ajv2020): void;
+/** Locate ContentRef positions using the Task JSON Schema dialect; never the P1 keyword allowlist. */
+export declare function inspectTaskSchema(input: unknown, data: JsonValue, budget: Budget, validate?: (data: JsonValue) => void): {
+    expected: Map<string, string>;
+    rules: Set<string>;
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAA0B,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAkC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAEvD;AAmCD,sGAAsG;AACtG,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI;;;EAsQrC"}

package/dist/contract.js

@@ -0,0 +1,280 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { Budget, propertyPath, snapshot } from "./value.js";
+const metadata = new Set([
+    "$schema",
+    "$id",
+    "$anchor",
+    "$comment",
+    "title",
+    "description",
+    "default",
+    "examples",
+    "readOnly",
+    "writeOnly",
+    "deprecated",
+]);
+export function addContentRefKeyword(ajv) {
+    ajv.addKeyword({ keyword: "x-ipfs-content-ref", schemaType: "boolean", errors: false });
+}
+function record(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function pointer(root, ref, budget, depth) {
+    budget.visit(depth);
+    if (typeof ref !== "string" || !ref.startsWith("#") || (ref !== "#" && !ref.startsWith("#/")))
+        throw new Error("Only local schema references are supported.");
+    if (ref === "#")
+        return root;
+    let node = root;
+    for (const part of ref.slice(2).split("/")) {
+        const key = part.replaceAll("~1", "/").replaceAll("~0", "~");
+        if (!node || typeof node !== "object" || !Object.hasOwn(node, key))
+            throw new Error("Unresolved local schema reference.");
+        node = node[key];
+    }
+    if (typeof node === "boolean")
+        return node;
+    if (!record(node))
+        throw new Error("Reference target is not a schema location.");
+    return node;
+}
+function extras(schema) {
+    const rest = {};
+    for (const [key, value] of Object.entries(schema))
+        if (key !== "$ref" && !metadata.has(key))
+            Object.defineProperty(rest, key, { value, enumerable: true });
+    return rest;
+}
+function isRef(schema) {
+    return record(schema) && schema["x-ipfs-content-ref"] === true;
+}
+/** Locate ContentRef positions using the Task JSON Schema dialect; never the P1 keyword allowlist. */
+export function inspectTaskSchema(input, data, budget, validate) {
+    const root = snapshot(input, budget, undefined, true);
+    budget.bytes(root);
+    if (validate)
+        validate(data);
+    else {
+        const ajv = new Ajv2020({
+            strict: true,
+            strictTuples: false,
+            allowUnionTypes: true,
+            validateFormats: false,
+            ownProperties: true,
+            allErrors: false,
+        });
+        addContentRefKeyword(ajv);
+        if (!ajv.validateSchema(root))
+            throw new Error("Invalid payload schema.");
+        const check = ajv.compile(root);
+        if (!check(data))
+            throw new Error(`Payload does not match schema: ${ajv.errorsText(check.errors)}.`);
+    }
+    const cache = new WeakMap();
+    const resolve = (schema, depth, trail) => {
+        budget.visit(depth);
+        if (!record(schema) || schema.$ref === undefined)
+            return schema;
+        const cached = cache.get(schema);
+        if (cached)
+            return cached;
+        if (trail.has(schema))
+            throw new Error("Cyclic schema reference.");
+        const target = resolve(pointer(root, schema.$ref, budget, depth + 1), depth + 1, new Set(trail).add(schema));
+        const rest = extras(schema);
+        const combined = Object.keys(rest).length
+            ? record(target)
+                ? { allOf: [target, rest] }
+                : rest
+            : target;
+        cache.set(schema, combined);
+        return combined;
+    };
+    const checkRef = (schema) => {
+        if (!isRef(schema))
+            return false;
+        if (schema.type !== "string" ||
+            Object.keys(schema).some((key) => !metadata.has(key) &&
+                !["type", "x-ipfs-content-ref", "$ref", "$id", "$anchor"].includes(key)))
+            throw new Error("Invalid ContentRef schema.");
+        return true;
+    };
+    const unionOf = (schema) => schema.anyOf ?? schema.oneOf;
+    const discriminators = new Map();
+    const references = new Map();
+    const inspect = (schema, depth, trail) => {
+        budget.visit(depth);
+        schema = resolve(schema, depth, trail);
+        if (typeof schema === "boolean") {
+            references.set(schema, false);
+            return false;
+        }
+        if (checkRef(schema)) {
+            references.set(schema, true);
+            return true;
+        }
+        let hasRefs = false;
+        if (schema.allOf) {
+            let refNodes = 0;
+            for (const child of schema.allOf) {
+                const resolved = resolve(child, depth + 1, trail);
+                if (checkRef(resolved))
+                    refNodes++;
+                hasRefs = inspect(child, depth + 1, trail) || hasRefs;
+            }
+            if (refNodes &&
+                schema.allOf.some((child) => {
+                    const resolved = resolve(child, depth + 1, trail);
+                    return (record(resolved) &&
+                        !checkRef(resolved) &&
+                        !!(resolved.properties || resolved.items || resolved.prefixItems || unionOf(resolved)));
+                }))
+                throw new Error("Reference unions require a unique required literal discriminator.");
+        }
+        for (const child of Object.values(schema.properties ?? {}))
+            hasRefs = inspect(child, depth + 1, trail) || hasRefs;
+        if (record(schema.additionalProperties))
+            hasRefs = inspect(schema.additionalProperties, depth + 1, trail) || hasRefs;
+        const prefix = schema.prefixItems ?? (Array.isArray(schema.items) ? schema.items : undefined);
+        if (prefix)
+            for (const child of prefix)
+                hasRefs = inspect(child, depth + 1, trail) || hasRefs;
+        if (schema.items && !Array.isArray(schema.items))
+            hasRefs = inspect(schema.items, depth + 1, trail) || hasRefs;
+        if (record(schema.additionalItems))
+            throw new Error("Schema-valued additionalItems are unsupported; use a homogeneous array.");
+        const options = unionOf(schema);
+        if (options) {
+            let unionRefs = false;
+            for (const branch of options)
+                unionRefs = inspect(branch, depth + 1, trail) || unionRefs;
+            if (unionRefs) {
+                const first = options[0];
+                const key = record(first) &&
+                    Object.keys(first.properties ?? {}).find((key) => {
+                        const literals = new Set();
+                        for (const branch of options) {
+                            const resolved = resolve(branch, depth + 1, trail);
+                            const property = record(resolved) ? resolved.properties?.[key] : undefined;
+                            const field = property ? resolve(property, depth + 2, trail) : undefined;
+                            if (!record(resolved) ||
+                                !resolved.required?.includes(key) ||
+                                !record(field) ||
+                                !Object.hasOwn(field, "const") ||
+                                (field.const !== null && typeof field.const === "object") ||
+                                field["x-ipfs-content-ref"] ||
+                                unionOf(resolved))
+                                return false;
+                            const literal = JSON.stringify(field.const);
+                            if (literals.has(literal))
+                                return false;
+                            literals.add(literal);
+                        }
+                        return true;
+                    });
+                if (!key)
+                    throw new Error("Reference unions require a unique required literal discriminator.");
+                discriminators.set(schema, key);
+            }
+            hasRefs = hasRefs || unionRefs;
+        }
+        if (options &&
+            (schema.properties || schema.items || schema.prefixItems || schema.additionalProperties))
+            throw new Error("Reference traversal does not support union structural siblings.");
+        references.set(schema, hasRefs);
+        return hasRefs;
+    };
+    inspect(root, 0, new Set());
+    const expected = new Map();
+    const rules = new Set();
+    const selected = (schema, value) => {
+        const key = discriminators.get(schema);
+        const options = unionOf(schema);
+        if (!value || typeof value !== "object" || Array.isArray(value) || !Object.hasOwn(value, key))
+            throw new Error("Missing payload discriminator.");
+        const branches = options.filter((branch) => {
+            const resolved = resolve(branch, 0, new Set());
+            const property = record(resolved) ? resolved.properties?.[key] : undefined;
+            const field = property ? resolve(property, 0, new Set()) : undefined;
+            return record(field) && field.const === value[key];
+        });
+        if (branches.length !== 1)
+            throw new Error("Invalid or ambiguous payload discriminator.");
+        return resolve(branches[0], 0, new Set());
+    };
+    const filter = (path, key, literal) => `${path}[?@[${JSON.stringify(key)}] == ${JSON.stringify(literal)}]`;
+    const constant = (schema, key) => {
+        const property = record(schema) ? schema.properties?.[key] : undefined;
+        const field = property ? resolve(property, 0, new Set()) : undefined;
+        return record(field) ? field.const : undefined;
+    };
+    const walk = (schema, value, path, rule, depth) => {
+        budget.visit(depth);
+        schema = resolve(schema, depth, new Set());
+        if (typeof schema === "boolean" || !references.get(schema))
+            return;
+        if (checkRef(schema)) {
+            rules.add(rule);
+            if (value !== undefined)
+                expected.set(path, rule);
+            return;
+        }
+        if (schema.allOf) {
+            for (const child of schema.allOf)
+                walk(child, value, path, rule, depth + 1);
+            return;
+        }
+        const options = unionOf(schema);
+        if (options) {
+            const branch = value === undefined ? undefined : selected(schema, value);
+            for (const option of options) {
+                const resolved = resolve(option, depth + 1, new Set());
+                walk(resolved, resolved === branch ? value : undefined, path, rule, depth + 1);
+            }
+            return;
+        }
+        if (schema.properties)
+            for (const [key, child] of Object.entries(schema.properties))
+                walk(child, value && typeof value === "object" && !Array.isArray(value) && Object.hasOwn(value, key)
+                    ? value[key]
+                    : undefined, propertyPath(path, key), propertyPath(rule, key), depth + 1);
+        if (record(schema.additionalProperties) &&
+            value &&
+            typeof value === "object" &&
+            !Array.isArray(value))
+            for (const [key, item] of Object.entries(value))
+                if (!Object.hasOwn(schema.properties ?? {}, key))
+                    walk(schema.additionalProperties, item, propertyPath(path, key), propertyPath(rule, key), depth + 1);
+        const prefix = schema.prefixItems ?? (Array.isArray(schema.items) ? schema.items : undefined);
+        if (prefix)
+            prefix.forEach((item, i) => {
+                walk(item, Array.isArray(value) ? value[i] : undefined, `${path}[${i}]`, `${rule}[${i}]`, depth + 1);
+            });
+        const rest = schema.items && !Array.isArray(schema.items)
+            ? resolve(schema.items, depth + 1, new Set())
+            : undefined;
+        if (rest !== undefined) {
+            const key = record(rest) ? discriminators.get(rest) : undefined;
+            if (key && record(rest) && unionOf(rest)) {
+                for (const branch of unionOf(rest)) {
+                    const resolved = resolve(branch, depth + 2, new Set());
+                    walk(resolved, undefined, path, filter(rule, key, constant(resolved, key)), depth + 1);
+                }
+            }
+            else
+                walk(rest, undefined, path, `${rule}[*]`, depth + 1);
+            if (Array.isArray(value))
+                value.forEach((child, i) => {
+                    if (prefix && i < prefix.length)
+                        return;
+                    const branch = key && record(rest) ? selected(rest, child) : rest;
+                    walk(branch, child, `${path}[${i}]`, key ? filter(rule, key, constant(branch, key)) : `${rule}[*]`, depth + 1);
+                });
+        }
+    };
+    walk(root, data, "$", "$", 0);
+    if (rules.size > budget.limits.maxPaths)
+        throw new Error("Schema reference path capacity exceeded.");
+    return { expected, rules };
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/dag-cbor.d.ts

@@ -0,0 +1,7 @@
+import { CID } from "multiformats/cid";
+export { code, decode } from "@ipld/dag-cbor";
+/** Rebase separately loaded multiformats instances without consulting object getters. */
+export declare function asNativeCID(value: unknown): CID | null;
+/** Reuse the canonical codec, but never interpret a plain business object as a CID. */
+export declare function encodeDagCbor(value: unknown): Uint8Array;
+//# sourceMappingURL=dag-cbor.d.ts.map

package/dist/dag-cbor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-cbor.d.ts","sourceRoot":"","sources":["../src/dag-cbor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE9C,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,CAYtD;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAWxD"}

package/dist/dag-cbor.js

@@ -0,0 +1,36 @@
+import { encodeOptions } from "@ipld/dag-cbor";
+import { encode } from "cborg";
+import { CID } from "multiformats/cid";
+export { code, decode } from "@ipld/dag-cbor";
+/** Rebase separately loaded multiformats instances without consulting object getters. */
+export function asNativeCID(value) {
+    if (value instanceof CID)
+        return value;
+    if (!value || typeof value !== "object")
+        return null;
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === Object.prototype || prototype === null)
+        return null;
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    const bytes = descriptors.bytes?.value;
+    if (!(bytes instanceof Uint8Array) || descriptors["/"]?.value !== bytes)
+        return null;
+    const cid = CID.decode(bytes);
+    if (cid.version !== descriptors.version?.value || cid.code !== descriptors.code?.value)
+        throw new Error("Invalid native CID identity.");
+    return cid;
+}
+/** Reuse the canonical codec, but never interpret a plain business object as a CID. */
+export function encodeDagCbor(value) {
+    return encode(value, {
+        ...encodeOptions,
+        typeEncoders: {
+            ...encodeOptions.typeEncoders,
+            Object: (object) => {
+                const cid = asNativeCID(object);
+                return cid ? encodeOptions.typeEncoders.Object(cid) : null;
+            },
+        },
+    });
+}
+//# sourceMappingURL=dag-cbor.js.map

package/dist/dag-cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-cbor.js","sourceRoot":"","sources":["../src/dag-cbor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE9C,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,GAAG;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAY,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;IAChD,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACrF,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,GAAG,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,KAAK;QACpF,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,MAAM,CAAC,KAAK,EAAE;QACnB,GAAG,aAAa;QAChB,YAAY,EAAE;YACZ,GAAG,aAAa,CAAC,YAAY;YAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;gBACjB,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;gBAChC,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7D,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import type { Static, TSchema } from "@sinclair/typebox";
+import { CID } from "multiformats/cid";
+import { ContentRef } from "./content-ref.js";
+import { Budget, type JsonValue, type PayloadLimits } from "./value.js";
+export { addContentRefKeyword, inspectTaskSchema } from "./contract.js";
+export { ContentRef } from "./content-ref.js";
+export { parseCidPath, type CidPathStep } from "./paths.js";
+export { Budget, defaultPayloadLimits, type JsonValue, type PayloadLimits } from "./value.js";
+export type IpfsPayload<T = JsonValue> = {
+    data: T;
+    cidPaths: string[];
+};
+export type DagValue = null | boolean | number | string | CID | DagValue[] | {
+    [key: string]: DagValue;
+};
+export type DagPayload = IpfsPayload<DagValue>;
+export type JsonOf<T> = T extends ContentRef ? string : T extends readonly unknown[] ? {
+    [K in keyof T]: JsonOf<T[K]>;
+} : T extends object ? {
+    [K in keyof T]: JsonOf<T[K]>;
+} : T;
+export type PayloadInspector = (schema: unknown, data: JsonValue, budget: Budget) => {
+    expected: Map<string, string>;
+    rules: Set<string>;
+};
+export interface PayloadOptions {
+    limits?: Partial<PayloadLimits>;
+    /** Task contracts inject inspectTaskSchema; the P1 profile remains the default. */
+    inspect?: PayloadInspector;
+    /** Host-supplied Task dialect validator; never skip business keywords. */
+    validate?: (data: JsonValue) => void;
+}
+export interface PayloadBlock {
+    cid: CID;
+    bytes: Uint8Array;
+}
+/** Encode ContentRef instances without a contract; lookalike strings stay ordinary. */
+export declare function encodeReferences(value: unknown, options?: PayloadOptions): IpfsPayload;
+/** Encode author values according to their contract; strings and lookalike objects stay ordinary. */
+export declare function encodePayload<S extends TSchema>(schema: S, value: Static<S>, options?: PayloadOptions): IpfsPayload<JsonOf<Static<S>>>;
+export declare function validatePayload(payload: unknown, schema?: unknown, options?: PayloadOptions): IpfsPayload;
+export declare function decodePayload<S extends TSchema>(payload: unknown, schema: S, options?: PayloadOptions): Static<S>;
+export declare function decodePayload(payload: unknown, schema?: unknown, options?: PayloadOptions): unknown;
+/** The DAG envelope preserves metadata, but reference positions contain real IPLD CID links. */
+export declare function toDagPayload(payload: unknown, schema?: unknown, options?: PayloadOptions): DagPayload;
+export declare function fromDagPayload(value: unknown, schema?: unknown, options?: PayloadOptions): IpfsPayload;
+export declare function encodePayloadBlock(payload: unknown, schema?: unknown, options?: PayloadOptions): Promise<PayloadBlock>;
+export declare function decodePayloadBlock(bytes: Uint8Array, schema?: unknown, options?: PayloadOptions & {
+    cid?: CID;
+}): Promise<IpfsPayload>;
+export interface TrustedPayloadContract {
+    readonly schema: unknown;
+    encode(value: unknown): IpfsPayload;
+    decode(payload: unknown): unknown;
+    validate(payload: unknown): IpfsPayload;
+    toDag(payload: unknown): DagPayload;
+    fromDag(value: unknown): IpfsPayload;
+    encodeBlock(payload: unknown): Promise<PayloadBlock>;
+    decodeBlock(bytes: Uint8Array, cid?: CID): Promise<IpfsPayload>;
+}
+/** Trusted Task-dialect bridge: snapshot/path conversion plus full Schema validation. */
+export declare function compileTrustedContract(schema: unknown, options?: PayloadOptions): TrustedPayloadContract;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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