superbee 0.1.5 → 0.1.6

package/README.md

@@ -49,7 +49,7 @@ Ubuntu, or Docker. On Windows, Superbee keeps per-user operational state under
 Superbee currently has two npm release channels:
 
 - `latest` is the stable channel selected by bare `superbee`, including native Windows support.
-- `next` is the prerelease channel for future release candidates.
+- `next` is the prerelease channel for release candidates.
 
 Install Superbee on Windows:
 

package/dist/bundle-descriptor/generated/bundle-descriptor-v1.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A stable authority-qualified identity. The publisher controls the first segment; directory policy owns collision handling.
+ *
+ * This interface was referenced by `SuperbeeBundleDescriptorV1`'s JSON-Schema
+ * via the `definition` "bundleId".
+ */
+export type BundleId = string;
+/**
+ * Untrusted display text. Presenters must still escape it for their output context.
+ *
+ * This interface was referenced by `SuperbeeBundleDescriptorV1`'s JSON-Schema
+ * via the `definition` "displayText".
+ */
+export type DisplayText = string;
+/**
+ * A bundle's minimal, portable self-description. This contract conveys no access, authority, ownership, lifecycle, policy, routing, or resolution claims.
+ */
+export interface SuperbeeBundleDescriptorV1 {
+    schema: "https://getsuperbee.com/schemas/bundle-descriptor/v1";
+    bundleId: BundleId;
+    /**
+     * Untrusted display text. Presenters must still escape it for their output context.
+     */
+    name: string;
+    /**
+     * Untrusted display text. Presenters must still escape it for their output context.
+     */
+    purpose: string;
+}
+//# sourceMappingURL=bundle-descriptor-v1.d.ts.map

package/dist/bundle-descriptor/index.d.ts

@@ -0,0 +1,3 @@
+export { BUNDLE_DESCRIPTOR_SCHEMA_V1, BUNDLE_DESCRIPTOR_V1 } from "./schema.js";
+export type { SuperbeeBundleDescriptorV1 as BundleDescriptorV1 } from "./generated/bundle-descriptor-v1.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/bundle-descriptor/schema/bundle-descriptor-v1.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getsuperbee.com/schemas/bundle-descriptor/v1",
+  "title": "Superbee Bundle Descriptor v1",
+  "description": "A bundle's minimal, portable self-description. This contract conveys no access, authority, ownership, lifecycle, policy, routing, or resolution claims.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "bundleId", "name", "purpose"],
+  "properties": {
+    "schema": {
+      "const": "https://getsuperbee.com/schemas/bundle-descriptor/v1"
+    },
+    "bundleId": {
+      "$ref": "#/$defs/bundleId"
+    },
+    "name": {
+      "$ref": "#/$defs/displayText",
+      "type": "string",
+      "maxLength": 120
+    },
+    "purpose": {
+      "$ref": "#/$defs/displayText",
+      "type": "string",
+      "maxLength": 500
+    }
+  },
+  "$defs": {
+    "bundleId": {
+      "description": "A stable authority-qualified identity. The publisher controls the first segment; directory policy owns collision handling.",
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9_-]{0,62}(?:\\.[a-z0-9][a-z0-9_-]{0,62})+$"
+    },
+    "displayText": {
+      "description": "Untrusted display text. Presenters must still escape it for their output context.",
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?=.*\\S)[^\\u0000-\\u001F\\u007F-\\u009F\\u061C\\u200E-\\u200F\\u202A-\\u202E\\u2066-\\u2069]+$"
+    }
+  }
+}

package/dist/bundle-descriptor/schema.d.ts

@@ -0,0 +1,5 @@
+/** The stable Bundle Descriptor v1 schema identifier. */
+export declare const BUNDLE_DESCRIPTOR_V1: "https://getsuperbee.com/schemas/bundle-descriptor/v1";
+/** The canonical JSON Schema 2020-12 contract, deeply immutable at runtime. */
+export declare const BUNDLE_DESCRIPTOR_SCHEMA_V1: Readonly<Record<string, unknown>>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/bundle-descriptor.mjs

@@ -0,0 +1,58 @@
+// ../bundle-descriptor/schema/bundle-descriptor-v1.schema.json
+var bundle_descriptor_v1_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://getsuperbee.com/schemas/bundle-descriptor/v1",
+  title: "Superbee Bundle Descriptor v1",
+  description: "A bundle's minimal, portable self-description. This contract conveys no access, authority, ownership, lifecycle, policy, routing, or resolution claims.",
+  type: "object",
+  additionalProperties: false,
+  required: ["schema", "bundleId", "name", "purpose"],
+  properties: {
+    schema: {
+      const: "https://getsuperbee.com/schemas/bundle-descriptor/v1"
+    },
+    bundleId: {
+      $ref: "#/$defs/bundleId"
+    },
+    name: {
+      $ref: "#/$defs/displayText",
+      type: "string",
+      maxLength: 120
+    },
+    purpose: {
+      $ref: "#/$defs/displayText",
+      type: "string",
+      maxLength: 500
+    }
+  },
+  $defs: {
+    bundleId: {
+      description: "A stable authority-qualified identity. The publisher controls the first segment; directory policy owns collision handling.",
+      type: "string",
+      minLength: 3,
+      maxLength: 128,
+      pattern: "^[a-z0-9][a-z0-9_-]{0,62}(?:\\.[a-z0-9][a-z0-9_-]{0,62})+$"
+    },
+    displayText: {
+      description: "Untrusted display text. Presenters must still escape it for their output context.",
+      type: "string",
+      minLength: 1,
+      pattern: "^(?=.*\\S)[^\\u0000-\\u001F\\u007F-\\u009F\\u061C\\u200E-\\u200F\\u202A-\\u202E\\u2066-\\u2069]+$"
+    }
+  }
+};
+
+// ../bundle-descriptor/src/schema.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+    Object.freeze(value);
+    for (const child of Object.values(value)) deepFreeze(child);
+  }
+  return value;
+}
+var BUNDLE_DESCRIPTOR_V1 = "https://getsuperbee.com/schemas/bundle-descriptor/v1";
+var BUNDLE_DESCRIPTOR_SCHEMA_V1 = deepFreeze(bundle_descriptor_v1_schema_default);
+export {
+  BUNDLE_DESCRIPTOR_SCHEMA_V1,
+  BUNDLE_DESCRIPTOR_V1
+};

package/dist/publication-bridge.mjs

@@ -3132,8 +3132,8 @@ var require_js_yaml = __commonJS({
 var require_js_yaml2 = __commonJS({
   "../../node_modules/js-yaml/index.js"(exports2, module2) {
     "use strict";
-    var yaml3 = require_js_yaml();
-    module2.exports = yaml3;
+    var yaml4 = require_js_yaml();
+    module2.exports = yaml4;
   }
 });
 
@@ -3537,6 +3537,53 @@ import path3 from "node:path";
 // ../core/src/frontmatter.ts
 var import_gray_matter = __toESM(require_gray_matter(), 1);
 var import_js_yaml = __toESM(require_js_yaml2(), 1);
+
+// ../core/src/frontmatter-contract.ts
+var MalformedDocumentError = class extends Error {
+  name = "MalformedDocumentError";
+  context;
+  detail;
+  constructor(context, cause) {
+    const detail = ((cause instanceof Error ? cause.message : String(cause)).split("\n")[0] ?? "").trim();
+    super(
+      `malformed frontmatter${context ? ` in '${context}'` : ""}: ${detail} \u2014 fix the YAML or remove the file`
+    );
+    if (context !== void 0) this.context = context;
+    this.detail = detail;
+    if (cause !== void 0) this.cause = cause;
+  }
+};
+
+// ../core/src/frontmatter-splitter.ts
+function delimiterLineEnd(input, offset) {
+  if (!input.startsWith("---", offset)) return null;
+  const suffix = offset + 3;
+  if (suffix === input.length) return suffix;
+  if (input[suffix] === "\n") return suffix + 1;
+  if (input[suffix] === "\r" && input[suffix + 1] === "\n") return suffix + 2;
+  return null;
+}
+function splitLeadingFrontmatter(raw, context) {
+  const input = raw.startsWith("\uFEFF") ? raw.slice(1) : raw;
+  const openingEnd = delimiterLineEnd(input, 0);
+  if (openingEnd === null) return { body: input };
+  let lineStart = openingEnd;
+  while (lineStart < input.length) {
+    const closingEnd = delimiterLineEnd(input, lineStart);
+    if (closingEnd !== null) {
+      return {
+        yamlSource: input.slice(openingEnd, lineStart),
+        body: input.slice(closingEnd)
+      };
+    }
+    const nextLineFeed = input.indexOf("\n", lineStart);
+    if (nextLineFeed === -1) break;
+    lineStart = nextLineFeed + 1;
+  }
+  throw new MalformedDocumentError(context, new Error("unterminated YAML frontmatter delimiter"));
+}
+
+// ../core/src/frontmatter.ts
 var YAML_TIMESTAMP_TAG = "tag:yaml.org,2002:timestamp";
 function requireYamlTimestampType() {
   const type = import_js_yaml.default.DEFAULT_SAFE_SCHEMA.implicit.find(
@@ -3573,38 +3620,17 @@ function normalizeFrontmatter(data) {
   }
   return out;
 }
-var MalformedDocumentError = class extends Error {
-  name = "MalformedDocumentError";
-  /** The document id/path the malformed content belongs to (when the caller supplied one). */
-  context;
-  /** The underlying parser message, first line only — for compact per-doc reporting. */
-  detail;
-  constructor(context, cause) {
-    const detail = ((cause instanceof Error ? cause.message : String(cause)).split("\n")[0] ?? "").trim();
-    super(
-      `malformed frontmatter${context ? ` in '${context}'` : ""}: ${detail} \u2014 fix the YAML or remove the file`
-    );
-    if (context !== void 0) this.context = context;
-    this.detail = detail;
-    if (cause !== void 0) this.cause = cause;
-  }
-};
 function parseMarkdown(raw, context) {
-  if (/^---(?:\r?\n|$)/.test(raw)) {
-    const firstLineEnd = raw.indexOf("\n");
-    const afterOpening = firstLineEnd === -1 ? "" : raw.slice(firstLineEnd + 1);
-    if (!/^---\r?$/m.test(afterOpening)) {
-      throw new MalformedDocumentError(context, new Error("unterminated YAML frontmatter delimiter"));
-    }
-  }
+  const split = splitLeadingFrontmatter(raw, context);
+  if (!("yamlSource" in split)) return { frontmatter: {}, body: split.body };
   let parsed;
   try {
-    parsed = (0, import_gray_matter.default)(raw, { engines: { yaml: yamlEngine } });
+    parsed = yamlEngine.parse(split.yamlSource);
   } catch (err) {
     throw new MalformedDocumentError(context, err);
   }
-  const frontmatter2 = normalizeFrontmatter(parsed.data ?? {});
-  return { frontmatter: frontmatter2, body: parsed.content };
+  const frontmatter2 = normalizeFrontmatter(parsed);
+  return { frontmatter: frontmatter2, body: split.body };
 }
 function normalizeDocumentBodyForStorage(body) {
   return body.endsWith("\n") ? body : `${body}
@@ -3612,13 +3638,13 @@ function normalizeDocumentBodyForStorage(body) {
 }
 function stringifyWithData(data, body) {
   const engines2 = import_gray_matter.default.engines;
-  const yaml3 = engines2.yaml.stringify(data).trim();
+  const yaml4 = engines2.yaml.stringify(data).trim();
   const content = body ?? "";
   const newline = (value) => value.endsWith("\n") ? value : `${value}
 `;
-  if (yaml3 === "{}") return normalizeDocumentBodyForStorage(content);
+  if (yaml4 === "{}") return normalizeDocumentBodyForStorage(content);
   return `---
-${newline(yaml3)}---
+${newline(yaml4)}---
 ${normalizeDocumentBodyForStorage(content)}`;
 }
 function stringifyDoc(frontmatter2, body) {
@@ -4524,25 +4550,12 @@ function mutationActorFromFrontmatter(frontmatter2) {
 
 // ../core/src/versioning.ts
 import { createHash as createHash3 } from "node:crypto";
-function sha256Hex(input) {
-  return createHash3("sha256").update(input, "utf8").digest("hex");
-}
-function versionOfBytes(raw) {
-  return `sha256:${sha256Hex(raw)}`;
-}
-function blobVersion(bytes) {
-  return `sha256:${createHash3("sha256").update(bytes).digest("hex")}`;
-}
-function defaultActor() {
-  return process.env.USER?.trim() || process.env.USERNAME?.trim() || process.env.LOGNAME?.trim() || "local";
-}
+
+// ../core/src/version-transport.ts
 var VersionConflict = class extends Error {
   name = "VersionConflict";
-  /** The concept id whose write was rejected. */
   id;
-  /** The version the caller expected the backend to currently hold (`null` = expected absent). */
   expected;
-  /** The version the backend actually holds (`null` if the document does not exist). */
   actual;
   constructor(id, expected, actual) {
     super(
@@ -4554,6 +4567,20 @@ var VersionConflict = class extends Error {
   }
 };
 
+// ../core/src/versioning.ts
+function sha256Hex(input) {
+  return createHash3("sha256").update(input, "utf8").digest("hex");
+}
+function versionOfBytes(raw) {
+  return `sha256:${sha256Hex(raw)}`;
+}
+function blobVersion(bytes) {
+  return `sha256:${createHash3("sha256").update(bytes).digest("hex")}`;
+}
+function defaultActor() {
+  return process.env.USER?.trim() || process.env.USERNAME?.trim() || process.env.LOGNAME?.trim() || "local";
+}
+
 // ../core/src/backend.ts
 var publicationRoots = /* @__PURE__ */ new WeakMap();
 function firstString(...vals) {
@@ -4792,16 +4819,51 @@ function normalizeSegments(segments) {
 function joinPosix(base, rel) {
   return normalizeSegments([...base.split("/"), ...rel.split("/")]).join("/");
 }
-var MD_LINK_RE = /\[([^\]]*)\]\(([^)\s]+)\)/g;
 function isExternalHref(href) {
   const h = href.trim();
   return /^[a-z][a-z0-9+.-]*:\/\//i.test(h) || h.startsWith("mailto:") || h.startsWith("#");
 }
 function extractMarkdownLinks(body) {
   const out = [];
-  for (const m of body.matchAll(MD_LINK_RE)) {
-    if (typeof m.index === "number" && m.index > 0 && body[m.index - 1] === "!") continue;
-    out.push({ text: m[1] ?? "", href: m[2] ?? "" });
+  let textOpen = -1;
+  let afterClose;
+  let hrefFirst;
+  let hrefRest;
+  for (let cursor = 0; cursor < body.length; cursor++) {
+    const char = body[cursor];
+    if (hrefRest) {
+      if (char === ")") {
+        if (hrefRest.open === 0 || body[hrefRest.open - 1] !== "!") {
+          out.push({
+            text: body.slice(hrefRest.open + 1, hrefRest.close),
+            href: body.slice(hrefRest.hrefStart, cursor)
+          });
+        }
+        textOpen = -1;
+        afterClose = void 0;
+        hrefFirst = void 0;
+        hrefRest = void 0;
+        continue;
+      }
+      if (char.trim() === "") hrefRest = void 0;
+    }
+    if (hrefFirst) {
+      if (char !== ")" && char.trim() !== "" && !hrefRest) {
+        hrefRest = hrefFirst;
+      }
+      hrefFirst = void 0;
+    }
+    if (afterClose) {
+      if (char === "(") {
+        hrefFirst = { ...afterClose, hrefStart: cursor + 1 };
+      }
+      afterClose = void 0;
+    }
+    if (textOpen >= 0 && char === "]") {
+      afterClose = { open: textOpen, close: cursor };
+      textOpen = -1;
+    }
+    if (char === "[" && textOpen < 0) textOpen = cursor;
   }
   return out;
 }
@@ -4838,6 +4900,24 @@ function parseLinksFromDoc(doc) {
   return links;
 }
 
+// ../core/src/portable-frontmatter.ts
+var import_js_yaml2 = __toESM(require_js_yaml2(), 1);
+function parseLeadingFrontmatter(raw, context) {
+  const split = splitLeadingFrontmatter(raw, context);
+  if (!("yamlSource" in split)) return {};
+  try {
+    const parsed = import_js_yaml2.default.safeLoad(split.yamlSource);
+    if (parsed === void 0 || parsed === null) return {};
+    if (typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new TypeError("YAML frontmatter must be a mapping");
+    }
+    return parsed;
+  } catch (error) {
+    if (error instanceof MalformedDocumentError) throw error;
+    throw new MalformedDocumentError(context, error);
+  }
+}
+
 // ../core/src/query-filter.ts
 function matchesFilter(doc, filter) {
   if (filter.prefix && !doc.id.startsWith(filter.prefix)) return false;
@@ -4857,25 +4937,27 @@ function matchesFilter(doc, filter) {
   return true;
 }
 
-// ../core/src/bundle.ts
-function backendFor(bundle) {
-  return bundle.backend ?? new FilesystemBackend(bundle.root);
-}
-async function readBundleOkfVersion(bundle) {
-  const index = await backendFor(bundle).readReserved("", "index.md");
+// ../core/src/engine.ts
+async function readBundleOkfVersion(backend) {
+  const index = await backend.readReserved("", "index.md");
   if (!index) return void 0;
-  const value = parseMarkdown(index.content, "index.md").frontmatter.okf_version;
+  const value = parseLeadingFrontmatter(index.content, "index.md").okf_version;
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
 }
-async function readDocVersioned(bundle, id) {
+function assertReadableConceptId(id) {
   assertSafeConceptId(id);
   const rel = pathFromConceptId(id);
   if (isReservedFile(rel)) {
     throw new InvalidInputError(`'${id}' is a reserved file (index.md / log.md), not a concept document.`);
   }
-  return backendFor(bundle).read(id);
 }
-var isEnoent = (err) => err?.code === "ENOENT";
+async function readDocVersioned(backend, id) {
+  assertReadableConceptId(id);
+  return backend.read(id);
+}
+function isEnoent(err) {
+  return typeof err === "object" && err !== null && err.code === "ENOENT";
+}
 async function readManyExisting(backend, ids, onMalformed) {
   try {
     return await backend.readMany(ids);
@@ -4886,13 +4968,13 @@ async function readManyExisting(backend, ids, onMalformed) {
     for (const id of ids) {
       try {
         out.push(await backend.read(id));
-      } catch (e) {
-        if (isEnoent(e)) continue;
-        if (e instanceof MalformedDocumentError && onMalformed) {
-          onMalformed({ id, reason: e.detail });
+      } catch (candidate) {
+        if (isEnoent(candidate)) continue;
+        if (candidate instanceof MalformedDocumentError && onMalformed) {
+          onMalformed({ id, reason: candidate.detail });
           continue;
         }
-        throw e;
+        throw candidate;
       }
     }
     return out;
@@ -4902,25 +4984,25 @@ async function scanMatching(backend, filter, onSkip) {
   const ids = await backend.list(filter.prefix);
   const results = [];
   for (const result of await readManyExisting(backend, ids, onSkip)) {
-    if (!matchesFilter(result.doc, filter)) continue;
-    results.push(result);
+    if (matchesFilter(result.doc, filter)) results.push(result);
   }
   results.sort((a, b) => a.doc.id.localeCompare(b.doc.id));
   return results;
 }
-async function query(bundle, filter = {}, options2 = {}) {
-  const scanned = await scanMatching(backendFor(bundle), filter, options2.onSkip);
-  return scanned.map((r) => r.doc);
+async function query(backend, filter = {}, options2 = {}) {
+  return (await scanMatching(backend, filter, options2.onSkip)).map((result) => result.doc);
 }
-async function queryHeads(bundle, filter = {}, options2 = {}) {
-  const backend = backendFor(bundle);
+async function queryHeads(backend, filter = {}, options2 = {}) {
   if (backend.queryHeads) {
-    const rows = (await backend.queryHeads(filter)).filter((r) => matchesFilter(r, filter));
+    const rows = (await backend.queryHeads(filter)).filter((row) => matchesFilter(row, filter));
     rows.sort((a, b) => a.id.localeCompare(b.id));
     return rows;
   }
-  const scanned = await scanMatching(backend, filter, options2.onSkip);
-  return scanned.map(({ doc, version }) => ({ id: doc.id, frontmatter: doc.frontmatter, version }));
+  return (await scanMatching(backend, filter, options2.onSkip)).map(({ doc, version }) => ({
+    id: doc.id,
+    frontmatter: doc.frontmatter,
+    version
+  }));
 }
 function normalizeEdgeSelector(raw) {
   if (raw.endsWith("/")) {
@@ -4933,25 +5015,19 @@ function normalizeEdgeSelector(raw) {
 }
 function matchesEdgeSelector(value, selectors) {
   if (selectors === void 0) return true;
-  for (const normalized of selectors) {
-    if (normalized.endsWith("/")) {
-      if (value.startsWith(normalized)) return true;
-    } else if (value === normalized) {
-      return true;
-    }
-  }
-  return false;
+  return selectors.some(
+    (selector2) => selector2.endsWith("/") ? value.startsWith(selector2) : value === selector2
+  );
 }
-function toSelectorList(v) {
-  if (v === void 0) return void 0;
-  return Array.isArray(v) ? v : [v];
+function toSelectorList(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value : [value];
 }
-async function queryEdges(bundle, filter = {}) {
+async function queryEdges(backend, filter = {}) {
   const fromSelectors = toSelectorList(filter.from)?.map(normalizeEdgeSelector);
   const toSelectors = toSelectorList(filter.to)?.map(normalizeEdgeSelector);
-  const docs = await query(bundle);
   const edges = [];
-  for (const doc of docs) {
+  for (const doc of await query(backend)) {
     for (const link of parseLinksFromDoc(doc)) {
       if (!matchesEdgeSelector(link.from, fromSelectors)) continue;
       if (!matchesEdgeSelector(link.to, toSelectors)) continue;
@@ -4963,6 +5039,26 @@ async function queryEdges(bundle, filter = {}) {
   return edges;
 }
 
+// ../core/src/bundle.ts
+function backendFor(bundle) {
+  return bundle.backend ?? new FilesystemBackend(bundle.root);
+}
+async function readBundleOkfVersion2(bundle) {
+  return readBundleOkfVersion(backendFor(bundle));
+}
+async function readDocVersioned2(bundle, id) {
+  return readDocVersioned(backendFor(bundle), id);
+}
+async function query2(bundle, filter = {}, options2 = {}) {
+  return query(backendFor(bundle), filter, options2);
+}
+async function queryHeads2(bundle, filter = {}, options2 = {}) {
+  return queryHeads(backendFor(bundle), filter, options2);
+}
+async function queryEdges2(bundle, filter = {}) {
+  return queryEdges(backendFor(bundle), filter);
+}
+
 // ../core/src/kinds.ts
 var CONVENTIONS_PREFIX = "conventions/";
 var CONVENTION_TYPE = "Convention";
@@ -5555,7 +5651,7 @@ function applyQuerySelectionFilters(rows, params, kinds = []) {
 // ../core/src/kinds-load.ts
 async function loadKinds(bundle) {
   const warnings = [];
-  const docs = await query(bundle, { prefix: CONVENTIONS_PREFIX, type: CONVENTION_TYPE }, {
+  const docs = await query2(bundle, { prefix: CONVENTIONS_PREFIX, type: CONVENTION_TYPE }, {
     onSkip: ({ id, reason }) => warnings.push({
       code: "KIND_CONVENTION_MALFORMED",
       message: `skipped kind convention '${id}' with unparseable frontmatter: ${reason}`,
@@ -5838,13 +5934,13 @@ var BridgeService = class {
     let outcome;
     try {
       outcome = await this.execute(before, request);
-    } catch (error) {
+    } catch {
       outcome = {
         reply: fail(
           request.id,
           request.bridge,
           "RUNTIME",
-          error instanceof Error ? error.message : String(error)
+          "the View request failed"
         )
       };
     }
@@ -5888,11 +5984,8 @@ var BridgeService = class {
     let next;
     try {
       next = await this.subscriptionSnapshot();
-    } catch (error) {
-      return this.reload(
-        launchId,
-        error instanceof Error ? error.message : String(error)
-      );
+    } catch {
+      return this.reload(launchId, "the View subscription could not be refreshed");
     }
     const after = await this.options.launches.resolve(launchId, true);
     if (!after) return this.reload(launchId, "the View changed while its subscription was polled");
@@ -5927,7 +6020,7 @@ var BridgeService = class {
     return { status: "reload-required", message };
   }
   async subscriptionSnapshot() {
-    const rows = await queryHeads(this.options.bundle, {});
+    const rows = await queryHeads2(this.options.bundle, {});
     if (rows.length > MAX_SUBSCRIPTION_HEADS) {
       throw new Error("the bundle is too large for the experimental View polling snapshot");
     }
@@ -5942,7 +6035,7 @@ var BridgeService = class {
         return { reply: null, openPageId: request.pageId };
       }
       try {
-        const target = await readDocVersioned(this.options.bundle, request.pageId);
+        const target = await readDocVersioned2(this.options.bundle, request.pageId);
         if (!isAnyRegistryId(target.doc.id) || !parseRegistration(target.doc.id, target.doc.frontmatter)) {
           throw new Error("invalid View target");
         }
@@ -5963,13 +6056,13 @@ var BridgeService = class {
       };
     }
     if (request.type === "query") {
-      const rows = await queryHeads(this.options.bundle, {
+      const rows = await queryHeads2(this.options.bundle, {
         ...request.params.type ? { type: request.params.type } : {},
         ...request.params.prefix ? { prefix: request.params.prefix } : {}
       });
       const [registry, okfVersion] = await Promise.all([
         loadKinds(this.options.bundle),
-        readBundleOkfVersion(this.options.bundle)
+        readBundleOkfVersion2(this.options.bundle)
       ]);
       const result = boundedRows(
         rows,
@@ -5984,9 +6077,9 @@ var BridgeService = class {
     }
     if (request.type === "read" || request.type === "read-versioned") {
       const [result, registry, okfVersion] = await Promise.all([
-        readDocVersioned(this.options.bundle, request.docId),
+        readDocVersioned2(this.options.bundle, request.docId),
         loadKinds(this.options.bundle),
-        readBundleOkfVersion(this.options.bundle)
+        readBundleOkfVersion2(this.options.bundle)
       ]);
       if (Buffer.byteLength(result.doc.body, "utf8") > MAX_DOCUMENT_BODY_BYTES) {
         return { reply: fail(request.id, request.bridge, "TOO_LARGE", "the document body exceeded the 1 MiB View limit") };
@@ -6005,7 +6098,7 @@ var BridgeService = class {
     if (request.type === "render-document") {
       let result;
       try {
-        result = await readDocVersioned(this.options.bundle, request.docId);
+        result = await readDocVersioned2(this.options.bundle, request.docId);
       } catch (error) {
         if (error?.code === "ENOENT") {
           return {
@@ -6032,7 +6125,7 @@ var BridgeService = class {
       };
     }
     if (request.type === "edges") {
-      const edges = await queryEdges(this.options.bundle, request.params);
+      const edges = await queryEdges2(this.options.bundle, request.params);
       if (edges.length > MAX_EDGE_ROWS) {
         return { reply: fail(request.id, request.bridge, "TOO_LARGE", `the edge query exceeded ${MAX_EDGE_ROWS} rows`) };
       }