@1sat/actions 0.0.202 → 0.0.204

package/dist/ordfs/manifest.d.ts

@@ -0,0 +1,119 @@
+/**
+ * ord-fs/json directory tree builder.
+ *
+ * Pure, key-agnostic logic that lays out a set of relative file paths into the
+ * ord-fs directory structure used by ORDFS: a root manifest, one manifest per
+ * subdirectory, and a mapping from each file to the transaction vout that will
+ * carry its inscription.
+ *
+ * ORDFS manifests are JSON objects whose values are `_N` relative-vout
+ * references — `_3` points at output index 3 in the same transaction. A
+ * directory manifest therefore maps each child name (file or subdirectory) to
+ * the vout of the inscription that holds that child's content (for files) or
+ * that child's own manifest (for subdirectories).
+ *
+ * Vout layout produced here:
+ *   [0..F-1]   one inscription per file, in caller order
+ *   [F..F+D-1] one inscription per subdirectory manifest, in first-seen order
+ *   [F+D]      the root manifest inscription (always last)
+ *
+ * This module computes the layout only. It does not build scripts, derive
+ * keys, or create inscriptions — see `buildOrdFsDirOutputs` for that.
+ *
+ * Nesting is bounded by the ordfs server's own traversal limit: 1sat-stack's
+ * `resolveDirectoryPath` (pkg/ordfs/routes.go) recurses into a child manifest
+ * one path segment at a time and rejects requests past `maxDirectoryDepth`
+ * (8). {@link MAX_ORDFS_DIRECTORY_DEPTH} mirrors that limit so a too-deep
+ * tree fails here, at build time, instead of producing a manifest tree the
+ * server will refuse to resolve.
+ */
+/**
+ * Maximum number of directory levels a file path may nest under, mirroring
+ * 1sat-stack's `maxDirectoryDepth` (pkg/ordfs/routes.go). A path with more
+ * directory segments than this would require more manifest hops than the
+ * ordfs server's `resolveDirectoryPath` will traverse.
+ */
+export declare const MAX_ORDFS_DIRECTORY_DEPTH = 8;
+/**
+ * A subdirectory manifest in the ord-fs tree — one per directory at any depth.
+ */
+export interface OrdfsSubdirManifest {
+    /**
+     * Full directory path from the root (e.g. `"refs"` or `"refs/v1"`). The
+     * parent manifest references this directory by its last segment.
+     */
+    path: string;
+    /**
+     * The manifest object: maps each child's single-segment name to its `_N`
+     * relative-vout reference — a file's inscription vout, or a nested
+     * subdirectory manifest's vout. Keys never contain `/`; each directory level
+     * is its own manifest, matching how the ordfs server resolves a path one
+     * segment at a time.
+     */
+    manifest: Record<string, string>;
+    /**
+     * The output index this subdirectory manifest's inscription occupies in
+     * the transaction. Referenced from the parent manifest as `_<vout>`.
+     */
+    vout: number;
+}
+/**
+ * The full ord-fs directory tree layout for a set of file paths.
+ */
+export interface OrdfsDirManifest {
+    /**
+     * The root manifest object: maps each root-level file name and each
+     * top-level subdirectory name to its `_N` relative-vout reference. This is
+     * the object that becomes the tradeable directory inscription.
+     */
+    root: Record<string, string>;
+    /**
+     * One entry per subdirectory at any depth, each with its own manifest and
+     * vout. A nested directory `a/b` produces two entries (`a` and `a/b`), with
+     * `a`'s manifest pointing at `a/b`'s vout.
+     */
+    subdirs: OrdfsSubdirManifest[];
+    /**
+     * Per-file output layout, parallel to the input `files` array (same order,
+     * same length). `vout` is the output index of that file's inscription.
+     */
+    files: Array<{
+        path: string;
+        vout: number;
+    }>;
+    /**
+     * The output index the root manifest inscription occupies — always the
+     * last output (`files.length + subdirs.length`).
+     */
+    manifestVout: number;
+    /**
+     * Content type for every manifest inscription (root and subdirectories):
+     * `ord-fs/json`. Exposed so callers building outputs do not need to import
+     * the registry constant separately.
+     */
+    manifestContentType: string;
+}
+/**
+ * Build the ord-fs/json directory tree for a set of relative file paths.
+ *
+ * Each input path may contain `/` to denote subdirectories. Every directory
+ * level — root and each nested directory — gets its own manifest, and a parent
+ * references a child directory by the child's single-segment name. This matches
+ * how the ordfs server resolves a path: one segment at a time, recursing into a
+ * child manifest when the segment points at another `ord-fs/json` inscription.
+ *
+ * Pure layout computation — no keys, scripts, or inscriptions. The returned
+ * `vout` indices assume file inscriptions occupy outputs `0..F-1` in `files`
+ * order, then the subdirectory manifests, then the root manifest last.
+ *
+ * @param files - Relative file paths in the order their inscriptions will be
+ *   created. Paths use `/` as the directory separator (e.g. `"SKILL.md"`,
+ *   `"refs/api.md"`). Order is significant: file `i` is assigned vout `i`.
+ * @returns The directory tree layout — root manifest, the per-directory
+ *   subdirectory manifests, per-file vout assignments, the root manifest's
+ *   vout, and the manifest content type.
+ */
+export declare function buildOrdfsDirManifest(files: Array<{
+    path: string;
+}>): OrdfsDirManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/ordfs/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/ordfs/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B;;;;OAIG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5C;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5B,gBAAgB,CA2FlB"}

package/dist/ordfs/manifest.js

@@ -0,0 +1,137 @@
+/**
+ * ord-fs/json directory tree builder.
+ *
+ * Pure, key-agnostic logic that lays out a set of relative file paths into the
+ * ord-fs directory structure used by ORDFS: a root manifest, one manifest per
+ * subdirectory, and a mapping from each file to the transaction vout that will
+ * carry its inscription.
+ *
+ * ORDFS manifests are JSON objects whose values are `_N` relative-vout
+ * references — `_3` points at output index 3 in the same transaction. A
+ * directory manifest therefore maps each child name (file or subdirectory) to
+ * the vout of the inscription that holds that child's content (for files) or
+ * that child's own manifest (for subdirectories).
+ *
+ * Vout layout produced here:
+ *   [0..F-1]   one inscription per file, in caller order
+ *   [F..F+D-1] one inscription per subdirectory manifest, in first-seen order
+ *   [F+D]      the root manifest inscription (always last)
+ *
+ * This module computes the layout only. It does not build scripts, derive
+ * keys, or create inscriptions — see `buildOrdFsDirOutputs` for that.
+ *
+ * Nesting is bounded by the ordfs server's own traversal limit: 1sat-stack's
+ * `resolveDirectoryPath` (pkg/ordfs/routes.go) recurses into a child manifest
+ * one path segment at a time and rejects requests past `maxDirectoryDepth`
+ * (8). {@link MAX_ORDFS_DIRECTORY_DEPTH} mirrors that limit so a too-deep
+ * tree fails here, at build time, instead of producing a manifest tree the
+ * server will refuse to resolve.
+ */
+import { MANIFEST_CONTENT_TYPE } from '../registry/constants.js';
+/**
+ * Maximum number of directory levels a file path may nest under, mirroring
+ * 1sat-stack's `maxDirectoryDepth` (pkg/ordfs/routes.go). A path with more
+ * directory segments than this would require more manifest hops than the
+ * ordfs server's `resolveDirectoryPath` will traverse.
+ */
+export const MAX_ORDFS_DIRECTORY_DEPTH = 8;
+/**
+ * Build the ord-fs/json directory tree for a set of relative file paths.
+ *
+ * Each input path may contain `/` to denote subdirectories. Every directory
+ * level — root and each nested directory — gets its own manifest, and a parent
+ * references a child directory by the child's single-segment name. This matches
+ * how the ordfs server resolves a path: one segment at a time, recursing into a
+ * child manifest when the segment points at another `ord-fs/json` inscription.
+ *
+ * Pure layout computation — no keys, scripts, or inscriptions. The returned
+ * `vout` indices assume file inscriptions occupy outputs `0..F-1` in `files`
+ * order, then the subdirectory manifests, then the root manifest last.
+ *
+ * @param files - Relative file paths in the order their inscriptions will be
+ *   created. Paths use `/` as the directory separator (e.g. `"SKILL.md"`,
+ *   `"refs/api.md"`). Order is significant: file `i` is assigned vout `i`.
+ * @returns The directory tree layout — root manifest, the per-directory
+ *   subdirectory manifests, per-file vout assignments, the root manifest's
+ *   vout, and the manifest content type.
+ */
+export function buildOrdfsDirManifest(files) {
+    const fileLayout = files.map((file, i) => ({ path: file.path, vout: i }));
+    const rootNode = new Map();
+    const collide = (key, scope) => {
+        throw new Error(`ord-fs directory path collision: "${key}" conflicts with an existing entry in ${scope}`);
+    };
+    for (const { path, vout } of fileLayout) {
+        const parts = path.split('/');
+        const depth = parts.length - 1; // directory levels above this file
+        if (depth >= MAX_ORDFS_DIRECTORY_DEPTH) {
+            throw new Error(`ord-fs directory path too deep: "${path}" nests ${depth} directory levels; the ordfs server resolves at most ${MAX_ORDFS_DIRECTORY_DEPTH} (see 1sat-stack pkg/ordfs/routes.go maxDirectoryDepth)`);
+        }
+        let node = rootNode;
+        let walked = '';
+        for (let i = 0; i < parts.length - 1; i++) {
+            const seg = parts[i];
+            const existing = node.get(seg);
+            if (existing === undefined) {
+                const child = new Map();
+                node.set(seg, child);
+                node = child;
+            }
+            else if (existing instanceof Map) {
+                node = existing;
+            }
+            else {
+                collide(seg, walked ? `directory "${walked}/"` : 'the root directory');
+            }
+            walked = walked ? `${walked}/${seg}` : seg;
+        }
+        const name = parts[parts.length - 1];
+        if (node.has(name)) {
+            collide(name, walked ? `directory "${walked}/"` : 'the root directory');
+        }
+        node.set(name, vout);
+    }
+    // Assign each subdirectory manifest a vout after the file inscriptions, in
+    // depth-first order; the root manifest is always last.
+    const dirPaths = [];
+    const collect = (node, path) => {
+        for (const [name, child] of node) {
+            if (child instanceof Map) {
+                const childPath = path ? `${path}/${name}` : name;
+                dirPaths.push({ path: childPath, node: child });
+                collect(child, childPath);
+            }
+        }
+    };
+    collect(rootNode, '');
+    const voutByPath = new Map();
+    let nextVout = files.length;
+    for (const { path } of dirPaths)
+        voutByPath.set(path, nextVout++);
+    const manifestVout = nextVout; // root manifest last
+    // Build a manifest object: file children → their vout, directory children →
+    // the child manifest's vout. Keys stay single-segment.
+    const manifestFor = (node, path) => {
+        const manifest = {};
+        for (const [name, child] of node) {
+            const vout = child instanceof Map
+                ? voutByPath.get(path ? `${path}/${name}` : name)
+                : child;
+            manifest[name] = `_${vout}`;
+        }
+        return manifest;
+    };
+    const subdirs = dirPaths.map(({ path, node }) => ({
+        path,
+        manifest: manifestFor(node, path),
+        vout: voutByPath.get(path),
+    }));
+    return {
+        root: manifestFor(rootNode, ''),
+        subdirs,
+        files: fileLayout,
+        manifestVout,
+        manifestContentType: MANIFEST_CONTENT_TYPE,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/ordfs/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/ordfs/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAA;AA4D1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACpC,KAA8B;IAE9B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAKzE,MAAM,QAAQ,GAAY,IAAI,GAAG,EAAE,CAAA;IAEnC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,KAAa,EAAS,EAAE;QACrD,MAAM,IAAI,KAAK,CACd,qCAAqC,GAAG,yCAAyC,KAAK,EAAE,CACxF,CAAA;IACF,CAAC,CAAA;IAED,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA,CAAC,mCAAmC;QAClE,IAAI,KAAK,IAAI,yBAAyB,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACd,oCAAoC,IAAI,WAAW,KAAK,wDAAwD,yBAAyB,yDAAyD,CAClM,CAAA;QACF,CAAC;QACD,IAAI,IAAI,GAAG,QAAQ,CAAA;QACnB,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAY,IAAI,GAAG,EAAE,CAAA;gBAChC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;gBACpB,IAAI,GAAG,KAAK,CAAA;YACb,CAAC;iBAAM,IAAI,QAAQ,YAAY,GAAG,EAAE,CAAC;gBACpC,IAAI,GAAG,QAAQ,CAAA;YAChB,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,MAAM,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAA;YACvE,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAC3C,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,MAAM,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAA;QACxE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,QAAQ,GAA2C,EAAE,CAAA;IAC3D,MAAM,OAAO,GAAG,CAAC,IAAa,EAAE,IAAY,EAAQ,EAAE;QACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;gBACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBAC/C,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YAC1B,CAAC;QACF,CAAC;IACF,CAAC,CAAA;IACD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAErB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC5C,IAAI,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAA;IAC3B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,QAAQ;QAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACjE,MAAM,YAAY,GAAG,QAAQ,CAAA,CAAC,qBAAqB;IAEnD,4EAA4E;IAC5E,uDAAuD;IACvD,MAAM,WAAW,GAAG,CAAC,IAAa,EAAE,IAAY,EAA0B,EAAE;QAC3E,MAAM,QAAQ,GAA2B,EAAE,CAAA;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,GACT,KAAK,YAAY,GAAG;gBACnB,CAAC,CAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAY;gBAC7D,CAAC,CAAC,KAAK,CAAA;YACT,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAA;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,OAAO,GAA0B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI;QACJ,QAAQ,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAW;KACpC,CAAC,CAAC,CAAA;IAEH,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC/B,OAAO;QACP,KAAK,EAAE,UAAU;QACjB,YAAY;QACZ,mBAAmB,EAAE,qBAAqB;KAC1C,CAAA;AACF,CAAC"}

package/dist/ordfs/outputs.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Builds the outputs for an ord-fs/json directory: one per file, one per
+ * subdirectory manifest, and the root manifest last. The root manifest is the
+ * directory's identity and the only output that carries MAP or a signature.
+ *
+ * Outputs are written in one of three layouts, chosen by
+ * `writeMode` (see {@link OrdfsDirWriteMode}):
+ *   - `'mixed'` — 0-sat B leaves and one 1-sat root inscription. This is the
+ *     default: the directory has one ownable token without a UTXO per file.
+ *   - `'inscription'` — a 1-sat ord envelope, built on the shared
+ *     `Inscription` template. Ownable/transferable/updatable; holds a UTXO.
+ *   - `'b'` — a 0-sat B protocol (bitcom `B://`) output, built on the shared
+ *     `B` template (composed with `MAP` via `BitCom` when metadata is
+ *     supplied, rather than reimplementing multi-protocol script layout).
+ *     Plain on-chain data; nothing is owned or held as a UTXO.
+ *
+ * Locking is pluggable (an address or a per-vout resolver) and applies to
+ * ordinal outputs — `'b'` outputs are OP_RETURN and provably
+ * unspendable, so there is nothing to lock. MAP is whatever the caller
+ * passes. Signing is deliberately NOT policy-enforced here: this builder
+ * accepts any `aip` signer regardless of `writeMode` (it is the pure, "dumb"
+ * primitive). It's `deployOrdfsDir` (the publishing action) that enforces the
+ * real policy — SIGMA for an ordinal root, AIP for an all-B tree — since
+ * SIGMA needs a spending input that only exists during transaction building.
+ */
+import { type LockingScript, Script } from '@bsv/sdk';
+import type { OneSatContext } from '../types.js';
+import { type OrdfsDirManifest } from './manifest.js';
+/**
+ * A file to include in an ord-fs directory inscription.
+ *
+ * Structurally identical to the registry's `PackageFile`, redeclared here so
+ * the ordfs primitives carry no dependency on the registry module's types.
+ */
+export interface OrdfsDirFile {
+    /** Relative path within the directory (e.g. `"SKILL.md"`, `"refs/api.md"`). */
+    path: string;
+    /** File content as raw bytes. */
+    content: Uint8Array;
+    /** MIME content type for the file inscription (e.g. `"text/markdown"`). */
+    contentType: string;
+}
+/**
+ * How an ord-fs directory publish is written on-chain.
+ *
+ * - `'mixed'` (default) — 0-sat B leaves and a 1-sat ordinal root.
+ * - `'inscription'` — a 1-sat ord envelope per output. Ownable,
+ *   transferable, and updatable; holds a UTXO on chain until explicitly
+ *   spent. `locking` controls who can spend it.
+ * - `'b'` — a 0-sat B protocol (bitcom `B://`) output per output. Plain
+ *   on-chain data, not an ordinal: no UTXO is held, nothing is
+ *   ownable/transferable, and `locking` is ignored — OP_RETURN outputs are
+ *   provably unspendable.
+ */
+export type OrdfsDirWriteMode = 'mixed' | 'inscription' | 'b';
+/**
+ * An address applied to every output, or a resolver that returns the locking
+ * script per vout. The resolver lets callers vary the lock per output without
+ * exposing a raw private key here. Used by every ordinal output, including
+ * the root of a `mixed` layout.
+ */
+export type OrdfsLocking = {
+    address: string;
+} | {
+    resolve: (vout: number) => LockingScript;
+};
+/**
+ * Options for {@link buildOrdFsDirOutputs}.
+ */
+export interface BuildOrdFsDirOutputsOptions {
+    /**
+     * Output layout. Defaults to `'mixed'` (B leaves, ordinal root).
+     */
+    writeMode?: OrdfsDirWriteMode;
+    /**
+     * Locking applied to ordinal outputs, so the caller controls who can spend
+     * them. Required for `mixed` and `inscription`; ignored for `b`.
+     */
+    locking?: OrdfsLocking;
+    /**
+     * MAP fields for the root manifest only, composed with the manifest's
+     * content via the shared `MAP`/`BitCom` templates. Written as given —
+     * nothing added or rewritten.
+     */
+    map?: Record<string, string>;
+    /**
+     * AIP signer for the root manifest. Receives the manifest script (with any
+     * MAP suffix) and returns it with an AIP suffix. This builder does not
+     * tie `aip` to a particular `writeMode` — see the module doc comment for
+     * why that policy lives in the publishing action instead.
+     */
+    aip?: (ctx: OneSatContext, manifestScript: Script) => Promise<Script>;
+}
+/**
+ * A single output in an ord-fs directory publish transaction.
+ */
+export interface OrdfsDirOutput {
+    /** Hex-encoded locking script (inscription envelope or B protocol, plus any suffix). */
+    lockingScriptHex: string;
+    /** Satoshi amount: 1 for ordinal outputs, 0 for B outputs. */
+    satoshis: number;
+    /** Human-readable description of what this output carries. */
+    description: string;
+    /** Whether this is the root manifest output (the directory's identity). */
+    isManifest: boolean;
+}
+/**
+ * Result of {@link buildOrdFsDirOutputs}.
+ */
+export interface BuildOrdFsDirOutputsResult {
+    /**
+     * All outputs in transaction order: file inscriptions, then subdirectory
+     * manifests, then the root manifest (last).
+     */
+    outputs: OrdfsDirOutput[];
+    /** Output index of the root manifest — equals `outputs.length - 1`. */
+    manifestVout: number;
+    /** The root manifest's locking script (with MAP/AIP suffix), for signing. */
+    manifestScript: Script;
+    /** The computed directory tree layout, for callers that need the `_N` map. */
+    tree: OrdfsDirManifest;
+}
+/**
+ * Build the outputs that publish an ord-fs/json directory.
+ *
+ * Layout (matching {@link buildOrdfsDirManifest}):
+ *   [0..F-1]   one output per file, in `files` order
+ *   [F..F+D-1] one output per subdirectory manifest
+ *   [F+D]      the root manifest output (MAP + AIP suffix, if supplied)
+ *
+ * @param files - Files to publish, in the order their outputs are created.
+ *   Paths use `/` for subdirectories (e.g. `"refs/api.md"`).
+ * @param opts - Write mode, locking strategy (for ordinal outputs), plus
+ *   optional MAP and AIP signer for the root manifest.
+ * @param ctx - Forwarded to the AIP signer; may be omitted when none is given.
+ * @returns The outputs, the root manifest's vout and script, and the tree.
+ */
+export declare function buildOrdFsDirOutputs(files: OrdfsDirFile[], opts: BuildOrdFsDirOutputsOptions, ctx?: OneSatContext): Promise<BuildOrdFsDirOutputsResult>;
+//# sourceMappingURL=outputs.d.ts.map

package/dist/ordfs/outputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outputs.d.ts","sourceRoot":"","sources":["../../src/ordfs/outputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAYH,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,EAAS,MAAM,UAAU,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,KAAK,gBAAgB,EAAyB,MAAM,eAAe,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,OAAO,EAAE,UAAU,CAAA;IACnB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,aAAa,GAAG,GAAG,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACrB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAA;CAAE,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,wFAAwF;IACxF,gBAAgB,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,IAAI,EAAE,gBAAgB,CAAA;CACtB;AAqGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,EAAE,2BAA2B,EACjC,GAAG,CAAC,EAAE,aAAa,GACjB,OAAO,CAAC,0BAA0B,CAAC,CA2FrC"}

package/dist/ordfs/outputs.js

@@ -0,0 +1,177 @@
+/**
+ * Builds the outputs for an ord-fs/json directory: one per file, one per
+ * subdirectory manifest, and the root manifest last. The root manifest is the
+ * directory's identity and the only output that carries MAP or a signature.
+ *
+ * Outputs are written in one of three layouts, chosen by
+ * `writeMode` (see {@link OrdfsDirWriteMode}):
+ *   - `'mixed'` — 0-sat B leaves and one 1-sat root inscription. This is the
+ *     default: the directory has one ownable token without a UTXO per file.
+ *   - `'inscription'` — a 1-sat ord envelope, built on the shared
+ *     `Inscription` template. Ownable/transferable/updatable; holds a UTXO.
+ *   - `'b'` — a 0-sat B protocol (bitcom `B://`) output, built on the shared
+ *     `B` template (composed with `MAP` via `BitCom` when metadata is
+ *     supplied, rather than reimplementing multi-protocol script layout).
+ *     Plain on-chain data; nothing is owned or held as a UTXO.
+ *
+ * Locking is pluggable (an address or a per-vout resolver) and applies to
+ * ordinal outputs — `'b'` outputs are OP_RETURN and provably
+ * unspendable, so there is nothing to lock. MAP is whatever the caller
+ * passes. Signing is deliberately NOT policy-enforced here: this builder
+ * accepts any `aip` signer regardless of `writeMode` (it is the pure, "dumb"
+ * primitive). It's `deployOrdfsDir` (the publishing action) that enforces the
+ * real policy — SIGMA for an ordinal root, AIP for an all-B tree — since
+ * SIGMA needs a spending input that only exists during transaction building.
+ */
+import { B, B_PREFIX, BitCom, Encoding, Inscription, MAP, MAP_PREFIX, } from '@1sat/templates';
+import { P2PKH, Script, Utils } from '@bsv/sdk';
+import { buildOrdfsDirManifest } from './manifest.js';
+/**
+ * Resolve the locking script for a given output index from the strategy.
+ */
+function lockFor(locking, vout) {
+    if ('address' in locking) {
+        return new P2PKH().lock(locking.address);
+    }
+    return locking.resolve(vout);
+}
+/**
+ * Slice a single-protocol BitCom-locked script (e.g. from `B.lock()`,
+ * `MAP.set()`) down to its bare protocol descriptor — stripping the leading
+ * OP_RETURN and protocol-prefix pushdata chunks — so it can be recomposed
+ * with other protocols into one combined OP_RETURN via {@link BitCom}. This
+ * reuses the same multi-protocol layout `BitCom.lock()` already implements,
+ * rather than hand-assembling pipe-delimited OP_RETURN chunks again.
+ */
+function toProtocol(prefix, locked) {
+    return {
+        protocol: prefix,
+        script: new Script(locked.chunks.slice(2)).toBinary(),
+        pos: 0,
+    };
+}
+/**
+ * Build a single output's content script for the given write mode.
+ *
+ * `'inscription'` requires `locking` (there's a UTXO to protect); `'b'` never
+ * touches `locking` (there's nothing to own).
+ */
+function buildLeafScript(writeMode, content, contentType, locking, vout) {
+    if (writeMode === 'b') {
+        return new Script(B.lock(content, contentType, Encoding.Binary).chunks);
+    }
+    if (!locking) {
+        throw new Error("buildOrdFsDirOutputs: 'locking' is required for ordinal outputs — it controls who can spend the UTXO");
+    }
+    const inscription = Inscription.create(content, contentType, {
+        scriptPrefix: lockFor(locking, vout),
+    });
+    return new Script(inscription.lock().chunks);
+}
+/**
+ * Build the root manifest's content script, with the optional MAP suffix
+ * composed for the given write mode.
+ *
+ * `'inscription'`: MAP is appended as a scriptSuffix after the ord envelope
+ * (the envelope itself carries no OP_RETURN, so MAP's own is the first and
+ * only one). `'b'`: the manifest's B protocol output already contains an
+ * OP_RETURN, so MAP must be recomposed into the *same* OP_RETURN via
+ * {@link BitCom} — appending a second OP_RETURN-prefixed script would produce
+ * a malformed BitCom multi-protocol layout.
+ */
+function buildManifestScript(writeMode, manifestBytes, contentType, locking, vout, map) {
+    const hasMap = map != null && Object.keys(map).length > 0;
+    if (writeMode === 'b') {
+        const protocols = [
+            toProtocol(B_PREFIX, B.lock(manifestBytes, contentType, Encoding.Binary)),
+        ];
+        if (hasMap) {
+            protocols.push(toProtocol(MAP_PREFIX, MAP.set(map)));
+        }
+        return new Script(new BitCom(protocols).lock().chunks);
+    }
+    if (!locking) {
+        throw new Error("buildOrdFsDirOutputs: 'locking' is required for the ordinal root — it controls who can spend the UTXO");
+    }
+    const suffix = hasMap ? MAP.set(map) : undefined;
+    const manifestInscription = Inscription.create(manifestBytes, contentType, {
+        scriptPrefix: lockFor(locking, vout),
+        ...(suffix ? { scriptSuffix: suffix } : {}),
+    });
+    return new Script(manifestInscription.lock().chunks);
+}
+/**
+ * Build the outputs that publish an ord-fs/json directory.
+ *
+ * Layout (matching {@link buildOrdfsDirManifest}):
+ *   [0..F-1]   one output per file, in `files` order
+ *   [F..F+D-1] one output per subdirectory manifest
+ *   [F+D]      the root manifest output (MAP + AIP suffix, if supplied)
+ *
+ * @param files - Files to publish, in the order their outputs are created.
+ *   Paths use `/` for subdirectories (e.g. `"refs/api.md"`).
+ * @param opts - Write mode, locking strategy (for ordinal outputs), plus
+ *   optional MAP and AIP signer for the root manifest.
+ * @param ctx - Forwarded to the AIP signer; may be omitted when none is given.
+ * @returns The outputs, the root manifest's vout and script, and the tree.
+ */
+export async function buildOrdFsDirOutputs(files, opts, ctx) {
+    const writeMode = opts.writeMode ?? 'mixed';
+    const leafWriteMode = writeMode === 'mixed' ? 'b' : writeMode;
+    const manifestWriteMode = writeMode === 'mixed' ? 'inscription' : writeMode;
+    const leafSatoshis = leafWriteMode === 'b' ? 0 : 1;
+    const manifestSatoshis = manifestWriteMode === 'b' ? 0 : 1;
+    const tree = buildOrdfsDirManifest(files);
+    const outputs = [];
+    // -------------------------------------------------------------------
+    // 1. File outputs (vouts 0..F-1)
+    // -------------------------------------------------------------------
+    for (let i = 0; i < files.length; i++) {
+        const file = files[i];
+        const script = buildLeafScript(leafWriteMode, file.content, file.contentType, opts.locking, i);
+        outputs.push({
+            lockingScriptHex: Utils.toHex(script.toBinary()),
+            satoshis: leafSatoshis,
+            description: `file: ${file.path}`,
+            isManifest: false,
+        });
+    }
+    // -------------------------------------------------------------------
+    // 2. Subdirectory manifest outputs (vouts F..F+D-1)
+    // -------------------------------------------------------------------
+    for (const subdir of tree.subdirs) {
+        const subdirBytes = new Uint8Array(Utils.toArray(JSON.stringify(subdir.manifest), 'utf8'));
+        const script = buildLeafScript(leafWriteMode, subdirBytes, tree.manifestContentType, opts.locking, subdir.vout);
+        outputs.push({
+            lockingScriptHex: Utils.toHex(script.toBinary()),
+            satoshis: leafSatoshis,
+            description: `dir: ${subdir.path}/`,
+            isManifest: false,
+        });
+    }
+    // -------------------------------------------------------------------
+    // 3. Root manifest output (last). MAP is composed into it; AIP is
+    //    applied afterward, since it signs over the MAP data too.
+    // -------------------------------------------------------------------
+    const manifestBytes = new Uint8Array(Utils.toArray(JSON.stringify(tree.root), 'utf8'));
+    let manifestScript = buildManifestScript(manifestWriteMode, manifestBytes, tree.manifestContentType, opts.locking, tree.manifestVout, opts.map);
+    if (opts.aip) {
+        if (!ctx) {
+            throw new Error('buildOrdFsDirOutputs: an AIP signer was supplied but no context was provided');
+        }
+        manifestScript = await opts.aip(ctx, manifestScript);
+    }
+    outputs.push({
+        lockingScriptHex: Utils.toHex(manifestScript.toBinary()),
+        satoshis: manifestSatoshis,
+        description: 'manifest (ord-fs/json)',
+        isManifest: true,
+    });
+    return {
+        outputs,
+        manifestVout: tree.manifestVout,
+        manifestScript,
+        tree,
+    };
+}
+//# sourceMappingURL=outputs.js.map

package/dist/ordfs/outputs.js.map

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

package/dist/ordinals/index.d.ts

@@ -5,7 +5,7 @@
  * Returns WalletOutput[] directly from the SDK - no custom mapping needed.
  */
 import { type BEEF, type CreateActionArgs, Script, type WalletOutput } from '@bsv/sdk';
-import type { Action, ActionOptions, OneSatContext } from '../types';
+import type { Action, ActionOptions, OneSatContext } from '../types.js';
 /**
  * Resolve ordinal tags (type, origin, name) and basket for a self-spend output.
  * Fetches missing data from ORDFS when services are available.

package/dist/ordinals/index.d.ts.map

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

package/dist/ordinals/index.js

@@ -9,14 +9,14 @@ import { OrdLock } from '@1sat/templates';
 import { buildInputAssetLabel, displayNameForCi, nameFromMap, ordinalTagsFromMetadata, readAssetIdTag, } from '@1sat/types';
 import { parseOutpoint } from '@1sat/utils';
 import { Beef, BigNumber, LockingScript, OP, P2PKH, PublicKey, Script, TransactionSignature, UnlockingScript, Utils, } from '@bsv/sdk';
-import { prepareP1SatArgs } from '../apply';
-import { MAX_INSCRIPTION_BYTES, OPNS_BASKET, ORDINALS_BASKET, ORD_LOCK_PREFIX, ORD_LOCK_SUFFIX, P1SAT_PROTOCOL, } from '../constants';
-import { appendSigmaPlaceholder } from '../signing/sigma';
-import { executeTrackedAction } from '../utils/createTrackedAction';
-import { loadBasketOutputBeef } from '../utils/loadBasketOutput';
-import { buildOrdinalCustomInstructions } from '../utils/ordinalRemittance';
-import { ordinalSeedTags } from '../utils/ordinalSeedTags';
-import { unlockingScriptLengthForInstructions } from '../utils/signOrdinalInput';
+import { prepareP1SatArgs } from '../apply/index.js';
+import { MAX_INSCRIPTION_BYTES, OPNS_BASKET, ORDINALS_BASKET, ORD_LOCK_PREFIX, ORD_LOCK_SUFFIX, P1SAT_PROTOCOL, } from '../constants.js';
+import { appendSigmaPlaceholder } from '../signing/sigma.js';
+import { executeTrackedAction } from '../utils/createTrackedAction.js';
+import { loadBasketOutputBeef } from '../utils/loadBasketOutput.js';
+import { buildOrdinalCustomInstructions } from '../utils/ordinalRemittance.js';
+import { ordinalSeedTags } from '../utils/ordinalSeedTags.js';
+import { unlockingScriptLengthForInstructions } from '../utils/signOrdinalInput.js';
 // ============================================================================
 // Helpers
 // ============================================================================