@carbonenginejs/runtime-resource 0.19.2 → 0.22.0

package/dist/formats/schemabound/CjsSchemaBoundFormat.js

@@ -1,3 +1,4 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
 import { CjsYamlFormat } from '../yaml/CjsYamlFormat.js';
 import { ReadValue } from './core/schemaBoundValues.js';
 import { SchemaBoundError } from './core/schemaBoundErrors.js';
@@ -30,7 +31,7 @@ const ROOT_TYPES = new Set(["dict", "list", "object"]);
  * a decoder written around a constant stride will read the first record
  * correctly and everything after it wrongly.
  */
-class CjsSchemaBoundFormat {
+class CjsSchemaBoundFormat extends CjsFormat {
   /**
    * Reports whether a schema can drive this reader.
    *
@@ -42,9 +43,9 @@ class CjsSchemaBoundFormat {
    * @param {object|Uint8Array|ArrayBuffer|string} schema Schema document or its bytes.
    * @returns {boolean} True when the schema has a root this reader understands.
    */
-  static is(schema) {
+  static is(input, options = null) {
     try {
-      return ROOT_TYPES.has(this.schema(schema).type);
+      return ROOT_TYPES.has(this.schema(options?.schema ?? input).type);
     } catch {
       return false;
     }
@@ -57,13 +58,41 @@ class CjsSchemaBoundFormat {
    * @param {object} [options] Probe options.
    * @returns {object} Resource probe.
    */
-  static isSupported(schema, options = null) {
-    return Probe(this.is(schema), options);
+  static probeSupport(input, options = null) {
+    const usable = this.is(input, options);
+    return {
+      format: this.id,
+      source: options?.source || "buffer",
+      recognized: usable,
+      supported: usable,
+      preferredOutput: usable ? OUTPUT_JSON : "",
+      reason: usable ? "The supplied schema declares a root this reader can decode." : "A readable companion schema was not supplied.",
+      variants: [{
+        kind: OUTPUT_JSON,
+        supported: usable
+      }, {
+        kind: OUTPUT_PAYLOAD,
+        supported: usable
+      }],
+      metadata: usable ? this.inspect(input, options) : {
+        family: this.id,
+        requiresSchema: true,
+        decodable: false
+      }
+    };
   }
 
-  // INTERIM, 2026-08-16. No `inspect` alias, matching CjsSqliteFormat and
-  // diverging from the older formats. Both are held by the same undecided
-  // question; see maintenance/INTERIM-sqlite-and-static-2026-08-16.md.
+  /** Return schema and payload facts without decoding the payload. */
+  static inspect(input, options = null) {
+    const schema = this.schema(options?.schema ?? input);
+    return {
+      family: this.id,
+      rootType: schema.type,
+      requiresSchema: true,
+      decodable: ROOT_TYPES.has(schema.type),
+      byteLength: options?.schema === undefined ? null : Normalize(input).byteLength
+    };
+  }
 
   /**
    * Reads a container against its schema.
@@ -101,7 +130,8 @@ class CjsSchemaBoundFormat {
       view: new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)
     };
     const decoded = ReadValue(context, 0, schema).value;
-    return options.output === OUTPUT_PAYLOAD ? decoded : ToJSON(decoded);
+    const output = options.emit ?? options.output ?? OUTPUT_JSON;
+    return output === OUTPUT_PAYLOAD ? decoded : ToJSON(decoded);
   }
 
   /** Reads to plain JSON-compatible values. */
@@ -145,10 +175,16 @@ class CjsSchemaBoundFormat {
   });
   static id = "schemabound";
   static extensions = Object.freeze([".static"]);
-  static type = Object.freeze(["data"]);
   static mediaTypes = Object.freeze(["data"]);
-  static inputTypes = Object.freeze(["schemabound"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_PAYLOAD]);
+  static outputs = CjsFormat.defineOutputs({
+    json: {
+      default: true,
+      decoded: true
+    },
+    payload: {
+      decoded: true
+    }
+  });
 }
 
 /**
@@ -186,32 +222,6 @@ function Resolve(value) {
   return walk(value);
 }
 
-/** Builds the probe shape the resource manager routes on. */
-function Probe(usable, options) {
-  return {
-    format: "schemabound",
-    source: "buffer",
-    supported: usable ? "full" : "none",
-    confidence: usable ? 1 : 0,
-    preferred: "schemabound",
-    // The schema is read to answer this, so it is measured rather than declared.
-    // It says nothing about any payload: these containers carry no signature.
-    verified: true,
-    reason: usable ? "The schema declares a root this reader can decode." : "The schema is missing, unparsable, or declares an unreadable root.",
-    variants: [{
-      kind: "container",
-      codec: "schemabound",
-      supported: usable
-    }],
-    metadata: {
-      family: "schemabound",
-      requiresSchema: true,
-      decodable: usable
-    },
-    ...(options || {})
-  };
-}
-
 /** Converts decoded values to something `JSON.stringify` keeps losslessly. */
 function ToJSON(value) {
   if (typeof value === "bigint") return value.toString(10);

package/dist/formats/schemabound/CjsSchemaBoundFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsSchemaBoundFormat.js","sources":["../../../../src/formats/schemabound/CjsSchemaBoundFormat.js"],"sourcesContent":["import { CjsYamlFormat } from \"../yaml/index.js\";\nimport { ReadValue } from \"./core/schemaBoundValues.js\";\nimport { SchemaBoundError } from \"./core/schemaBoundErrors.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst ROOT_TYPES = new Set([ \"dict\", \"list\", \"object\" ]);\n\n/**\n * Reads a container whose layout lives in a separate schema.\n *\n * This is the third of the three families that share the `.static` extension,\n * and the one an extension check is least able to help with: the bytes carry no\n * signature, no version and no self-description. What they carry is a payload\n * whose every field position, width and meaning is stated in a sibling `.schema`\n * document — so the schema is not a hint here, it is the reader.\n *\n * That makes this the opposite of the hash-identified containers, where the\n * header names a layout it does not describe and the layout has to be derived\n * and pinned per dataset. Nothing needs deriving for this family. Supply the\n * schema and the bytes decode.\n *\n * **The schema is required and there is no default.** Given the wrong schema\n * these bytes decode into plausible nonsense rather than failing, because there\n * is nothing in them to disagree with. Pair each payload with the `.schema`\n * that shipped beside it.\n *\n * Read {@link CjsSchemaBoundFormat.read} before writing anything that walks the\n * result: a record's variable section changes length from record to record, and\n * a decoder written around a constant stride will read the first record\n * correctly and everything after it wrongly.\n */\nexport class CjsSchemaBoundFormat {\n\n  /**\n   * Reports whether a schema can drive this reader.\n   *\n   * The question is about the schema, never the payload. These containers have\n   * no signature to test, so claiming to recognize the bytes would be a claim\n   * this format cannot support - and `CjsStaticFormat` already answers which\n   * family a `.static` file belongs to.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema document or its bytes.\n   * @returns {boolean} True when the schema has a root this reader understands.\n   */\n  static is(schema) {\n    try {\n      return ROOT_TYPES.has(this.schema(schema).type);\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reports whether this format can read a payload described by a schema.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema document or its bytes.\n   * @param {object} [options] Probe options.\n   * @returns {object} Resource probe.\n   */\n  static isSupported(schema, options = null) {\n    return Probe(this.is(schema), options);\n  }\n\n  // INTERIM, 2026-08-16. No `inspect` alias, matching CjsSqliteFormat and\n  // diverging from the older formats. Both are held by the same undecided\n  // question; see maintenance/INTERIM-sqlite-and-static-2026-08-16.md.\n\n  /**\n   * Reads a container against its schema.\n   *\n   * The whole payload decodes in one pass. Three properties are worth knowing\n   * before relying on the result:\n   *\n   * - **A keyed container's index is at the end.** Nothing at the front points\n   *   at it; it is found by reading the last four bytes as the index's own size.\n   * - **Record offsets are relative to the four-byte header**, not to the file.\n   *   Decoding from the file start reads one field early, which looks like a\n   *   wrong layout rather than a wrong base.\n   * - **The per-record offset table varies in length.** An optional attribute\n   *   that is absent occupies no slot, so consecutive records hold their\n   *   variable data at different distances from their own start.\n   *\n   * An absent optional takes the default its schema declares. Where none is\n   * declared the attribute is left off the record entirely, which is what the\n   * published static data exports show for those same rows.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @param {object} options Read options.\n   * @param {object|Uint8Array|ArrayBuffer|string} options.schema The sibling schema.\n   * @param {string} [options.output] `json` or `payload`.\n   * @returns {object|Array} The decoded container.\n   */\n  static read(input, options = {}) {\n    const bytes = Normalize(input);\n    const schema = this.schema(options.schema);\n\n    if (!ROOT_TYPES.has(schema.type)) {\n      throw SchemaBoundError(`A container's root must be a dict, list or object, not ${schema.type}.`);\n    }\n\n    const context = {\n      bytes,\n      view: new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n    };\n    const decoded = ReadValue(context, 0, schema).value;\n\n    return options.output === OUTPUT_PAYLOAD ? decoded : ToJSON(decoded);\n  }\n\n  /** Reads to plain JSON-compatible values. */\n  static readJSON(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_JSON });\n  }\n\n  /** Reads with wide integers left as `BigInt`. */\n  static readPayload(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_PAYLOAD });\n  }\n\n  /**\n   * Parses a schema document, accepting YAML bytes, YAML text or a parsed object.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema in any accepted form.\n   * @returns {object} The parsed schema.\n   */\n  static schema(schema) {\n    if (!schema) {\n      throw SchemaBoundError(\"This format cannot read a container without its schema.\");\n    }\n\n    if (typeof schema === \"object\" && !ArrayBuffer.isView(schema) && !(schema instanceof ArrayBuffer)) {\n      return schema;\n    }\n\n    const parsed = CjsYamlFormat.read(typeof schema === \"string\" ? schema : Normalize(schema));\n\n    if (!parsed || typeof parsed !== \"object\") {\n      throw SchemaBoundError(\"A schema must parse to a mapping.\");\n    }\n\n    return Resolve(parsed);\n  }\n\n  static Output = Object.freeze({ JSON: OUTPUT_JSON, PAYLOAD: OUTPUT_PAYLOAD });\n\n  static id = \"schemabound\";\n  static extensions = Object.freeze([ \".static\" ]);\n  static type = Object.freeze([ \"data\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static inputTypes = Object.freeze([ \"schemabound\" ]);\n  static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]);\n}\n\n/**\n * Rejoins YAML anchors and aliases into the graph they describe.\n *\n * These schemas share repeated declarations by anchor - a container with two\n * coordinates writes the vector's component aliases once - and the YAML reader\n * reports that sharing as `$yamlId` and `$yamlRef` markers rather than\n * duplicating the node. Left alone, `$yamlId` reads as one more component and\n * `$yamlRef` as a declaration with no fields at all.\n *\n * @param {*} value Parsed schema, or any part of one.\n * @returns {*} The same schema with anchors resolved and markers removed.\n */\nfunction Resolve(value) {\n  const anchors = new Map();\n\n  const walk = node => {\n    if (Array.isArray(node)) return node.map(walk);\n\n    if (!node || typeof node !== \"object\") return node;\n\n    if (Object.hasOwn(node, \"$yamlRef\")) {\n      const target = anchors.get(node.$yamlRef);\n\n      if (!target) {\n        throw SchemaBoundError(`The schema refers to an anchor it never declares: ${node.$yamlRef}.`);\n      }\n\n      return target;\n    }\n\n    const result = {};\n    const id = node.$yamlId;\n\n    if (id !== undefined) anchors.set(id, result);\n\n    for (const [ key, member ] of Object.entries(node)) {\n      if (key !== \"$yamlId\") result[key] = walk(member);\n    }\n\n    return result;\n  };\n\n  return walk(value);\n}\n\n/** Builds the probe shape the resource manager routes on. */\nfunction Probe(usable, options) {\n  return {\n    format: \"schemabound\",\n    source: \"buffer\",\n    supported: usable ? \"full\" : \"none\",\n    confidence: usable ? 1 : 0,\n    preferred: \"schemabound\",\n    // The schema is read to answer this, so it is measured rather than declared.\n    // It says nothing about any payload: these containers carry no signature.\n    verified: true,\n    reason: usable\n      ? \"The schema declares a root this reader can decode.\"\n      : \"The schema is missing, unparsable, or declares an unreadable root.\",\n    variants: [ { kind: \"container\", codec: \"schemabound\", supported: usable } ],\n    metadata: { family: \"schemabound\", requiresSchema: true, decodable: usable },\n    ...(options || {})\n  };\n}\n\n/** Converts decoded values to something `JSON.stringify` keeps losslessly. */\nfunction ToJSON(value) {\n  if (typeof value === \"bigint\") return value.toString(10);\n\n  if (Array.isArray(value)) return value.map(ToJSON);\n\n  if (value && typeof value === \"object\") {\n    const result = {};\n\n    for (const [ key, member ] of Object.entries(value)) result[key] = ToJSON(member);\n\n    return result;\n  }\n\n  return value;\n}\n\n/** Accepts the byte forms every other format here accepts. */\nfunction Normalize(input) {\n  if (input instanceof Uint8Array) return input;\n\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n\n  throw SchemaBoundError(\"A schema-bound container must be supplied as bytes.\");\n}\n\nexport default CjsSchemaBoundFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","ROOT_TYPES","Set","CjsSchemaBoundFormat","is","schema","has","type","isSupported","options","Probe","read","input","bytes","Normalize","SchemaBoundError","context","view","DataView","buffer","byteOffset","byteLength","decoded","ReadValue","value","output","ToJSON","readJSON","readPayload","ArrayBuffer","isView","parsed","CjsYamlFormat","Resolve","Output","Object","freeze","JSON","PAYLOAD","id","extensions","mediaTypes","inputTypes","outputTypes","anchors","Map","walk","node","Array","isArray","map","hasOwn","target","get","$yamlRef","result","$yamlId","undefined","set","key","member","entries","usable","format","source","supported","confidence","preferred","verified","reason","variants","kind","codec","metadata","family","requiresSchema","decodable","toString","Uint8Array"],"mappings":"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"}
+{"version":3,"file":"CjsSchemaBoundFormat.js","sources":["../../../../src/formats/schemabound/CjsSchemaBoundFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport { CjsYamlFormat } from \"../yaml/index.js\";\nimport { ReadValue } from \"./core/schemaBoundValues.js\";\nimport { SchemaBoundError } from \"./core/schemaBoundErrors.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst ROOT_TYPES = new Set([ \"dict\", \"list\", \"object\" ]);\n\n/**\n * Reads a container whose layout lives in a separate schema.\n *\n * This is the third of the three families that share the `.static` extension,\n * and the one an extension check is least able to help with: the bytes carry no\n * signature, no version and no self-description. What they carry is a payload\n * whose every field position, width and meaning is stated in a sibling `.schema`\n * document — so the schema is not a hint here, it is the reader.\n *\n * That makes this the opposite of the hash-identified containers, where the\n * header names a layout it does not describe and the layout has to be derived\n * and pinned per dataset. Nothing needs deriving for this family. Supply the\n * schema and the bytes decode.\n *\n * **The schema is required and there is no default.** Given the wrong schema\n * these bytes decode into plausible nonsense rather than failing, because there\n * is nothing in them to disagree with. Pair each payload with the `.schema`\n * that shipped beside it.\n *\n * Read {@link CjsSchemaBoundFormat.read} before writing anything that walks the\n * result: a record's variable section changes length from record to record, and\n * a decoder written around a constant stride will read the first record\n * correctly and everything after it wrongly.\n */\nexport class CjsSchemaBoundFormat extends CjsFormat {\n\n  /**\n   * Reports whether a schema can drive this reader.\n   *\n   * The question is about the schema, never the payload. These containers have\n   * no signature to test, so claiming to recognize the bytes would be a claim\n   * this format cannot support - and `CjsStaticFormat` already answers which\n   * family a `.static` file belongs to.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema document or its bytes.\n   * @returns {boolean} True when the schema has a root this reader understands.\n   */\n  static is(input, options = null) {\n    try {\n      return ROOT_TYPES.has(this.schema(options?.schema ?? input).type);\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reports whether this format can read a payload described by a schema.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema document or its bytes.\n   * @param {object} [options] Probe options.\n   * @returns {object} Resource probe.\n   */\n  static probeSupport(input, options = null) {\n    const usable = this.is(input, options);\n    return {\n      format: this.id,\n      source: options?.source || \"buffer\",\n      recognized: usable,\n      supported: usable,\n      preferredOutput: usable ? OUTPUT_JSON : \"\",\n      reason: usable\n        ? \"The supplied schema declares a root this reader can decode.\"\n        : \"A readable companion schema was not supplied.\",\n      variants: [\n        { kind: OUTPUT_JSON, supported: usable },\n        { kind: OUTPUT_PAYLOAD, supported: usable }\n      ],\n      metadata: usable ? this.inspect(input, options) : {\n        family: this.id,\n        requiresSchema: true,\n        decodable: false\n      }\n    };\n  }\n\n  /** Return schema and payload facts without decoding the payload. */\n  static inspect(input, options = null) {\n    const schema = this.schema(options?.schema ?? input);\n    return {\n      family: this.id,\n      rootType: schema.type,\n      requiresSchema: true,\n      decodable: ROOT_TYPES.has(schema.type),\n      byteLength: options?.schema === undefined ? null : Normalize(input).byteLength\n    };\n  }\n\n  /**\n   * Reads a container against its schema.\n   *\n   * The whole payload decodes in one pass. Three properties are worth knowing\n   * before relying on the result:\n   *\n   * - **A keyed container's index is at the end.** Nothing at the front points\n   *   at it; it is found by reading the last four bytes as the index's own size.\n   * - **Record offsets are relative to the four-byte header**, not to the file.\n   *   Decoding from the file start reads one field early, which looks like a\n   *   wrong layout rather than a wrong base.\n   * - **The per-record offset table varies in length.** An optional attribute\n   *   that is absent occupies no slot, so consecutive records hold their\n   *   variable data at different distances from their own start.\n   *\n   * An absent optional takes the default its schema declares. Where none is\n   * declared the attribute is left off the record entirely, which is what the\n   * published static data exports show for those same rows.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @param {object} options Read options.\n   * @param {object|Uint8Array|ArrayBuffer|string} options.schema The sibling schema.\n   * @param {string} [options.output] `json` or `payload`.\n   * @returns {object|Array} The decoded container.\n   */\n  static read(input, options = {}) {\n    const bytes = Normalize(input);\n    const schema = this.schema(options.schema);\n\n    if (!ROOT_TYPES.has(schema.type)) {\n      throw SchemaBoundError(`A container's root must be a dict, list or object, not ${schema.type}.`);\n    }\n\n    const context = {\n      bytes,\n      view: new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength)\n    };\n    const decoded = ReadValue(context, 0, schema).value;\n\n    const output = options.emit ?? options.output ?? OUTPUT_JSON;\n    return output === OUTPUT_PAYLOAD ? decoded : ToJSON(decoded);\n  }\n\n  /** Reads to plain JSON-compatible values. */\n  static readJSON(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_JSON });\n  }\n\n  /** Reads with wide integers left as `BigInt`. */\n  static readPayload(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_PAYLOAD });\n  }\n\n  /**\n   * Parses a schema document, accepting YAML bytes, YAML text or a parsed object.\n   *\n   * @param {object|Uint8Array|ArrayBuffer|string} schema Schema in any accepted form.\n   * @returns {object} The parsed schema.\n   */\n  static schema(schema) {\n    if (!schema) {\n      throw SchemaBoundError(\"This format cannot read a container without its schema.\");\n    }\n\n    if (typeof schema === \"object\" && !ArrayBuffer.isView(schema) && !(schema instanceof ArrayBuffer)) {\n      return schema;\n    }\n\n    const parsed = CjsYamlFormat.read(typeof schema === \"string\" ? schema : Normalize(schema));\n\n    if (!parsed || typeof parsed !== \"object\") {\n      throw SchemaBoundError(\"A schema must parse to a mapping.\");\n    }\n\n    return Resolve(parsed);\n  }\n\n  static Output = Object.freeze({ JSON: OUTPUT_JSON, PAYLOAD: OUTPUT_PAYLOAD });\n\n  static id = \"schemabound\";\n  static extensions = Object.freeze([ \".static\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = CjsFormat.defineOutputs({\n      json: { default: true, decoded: true },\n      payload: { decoded: true }\n  });\n}\n\n/**\n * Rejoins YAML anchors and aliases into the graph they describe.\n *\n * These schemas share repeated declarations by anchor - a container with two\n * coordinates writes the vector's component aliases once - and the YAML reader\n * reports that sharing as `$yamlId` and `$yamlRef` markers rather than\n * duplicating the node. Left alone, `$yamlId` reads as one more component and\n * `$yamlRef` as a declaration with no fields at all.\n *\n * @param {*} value Parsed schema, or any part of one.\n * @returns {*} The same schema with anchors resolved and markers removed.\n */\nfunction Resolve(value) {\n  const anchors = new Map();\n\n  const walk = node => {\n    if (Array.isArray(node)) return node.map(walk);\n\n    if (!node || typeof node !== \"object\") return node;\n\n    if (Object.hasOwn(node, \"$yamlRef\")) {\n      const target = anchors.get(node.$yamlRef);\n\n      if (!target) {\n        throw SchemaBoundError(`The schema refers to an anchor it never declares: ${node.$yamlRef}.`);\n      }\n\n      return target;\n    }\n\n    const result = {};\n    const id = node.$yamlId;\n\n    if (id !== undefined) anchors.set(id, result);\n\n    for (const [ key, member ] of Object.entries(node)) {\n      if (key !== \"$yamlId\") result[key] = walk(member);\n    }\n\n    return result;\n  };\n\n  return walk(value);\n}\n\n/** Converts decoded values to something `JSON.stringify` keeps losslessly. */\nfunction ToJSON(value) {\n  if (typeof value === \"bigint\") return value.toString(10);\n\n  if (Array.isArray(value)) return value.map(ToJSON);\n\n  if (value && typeof value === \"object\") {\n    const result = {};\n\n    for (const [ key, member ] of Object.entries(value)) result[key] = ToJSON(member);\n\n    return result;\n  }\n\n  return value;\n}\n\n/** Accepts the byte forms every other format here accepts. */\nfunction Normalize(input) {\n  if (input instanceof Uint8Array) return input;\n\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n\n  throw SchemaBoundError(\"A schema-bound container must be supplied as bytes.\");\n}\n\nexport default CjsSchemaBoundFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","ROOT_TYPES","Set","CjsSchemaBoundFormat","CjsFormat","is","input","options","has","schema","type","probeSupport","usable","format","id","source","recognized","supported","preferredOutput","reason","variants","kind","metadata","inspect","family","requiresSchema","decodable","rootType","byteLength","undefined","Normalize","read","bytes","SchemaBoundError","context","view","DataView","buffer","byteOffset","decoded","ReadValue","value","output","emit","ToJSON","readJSON","readPayload","ArrayBuffer","isView","parsed","CjsYamlFormat","Resolve","Output","Object","freeze","JSON","PAYLOAD","extensions","mediaTypes","outputs","defineOutputs","json","default","payload","anchors","Map","walk","node","Array","isArray","map","hasOwn","target","get","$yamlRef","result","$yamlId","set","key","member","entries","toString","Uint8Array"],"mappings":"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"}

package/dist/formats/sqlite/CjsSqliteFormat.js

@@ -1,6 +1,7 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
 import { ReadColumns } from './core/sqliteSchema.js';
 import { ReadHeader, TableRows } from './core/sqlitePages.js';
-import { SqliteError, ReadRecord } from './core/sqliteRecords.js';
+import { ReadRecord, SqliteError } from './core/sqliteRecords.js';
 
 const OUTPUT_JSON = "json";
 const OUTPUT_PAYLOAD = "payload";
@@ -31,7 +32,7 @@ const MASTER_ROOT_PAGE = 1;
  * than `Number.MAX_SAFE_INTEGER` is returned as a `BigInt` rather than silently
  * rounded.
  */
-class CjsSqliteFormat {
+class CjsSqliteFormat extends CjsFormat {
   /**
    * Reports whether bytes are a SQLite container, by signature.
    *
@@ -59,18 +60,41 @@ class CjsSqliteFormat {
    * @param {object} [options] Probe options.
    * @returns {object} Resource probe.
    */
-  static isSupported(input, options = null) {
-    return Probe(this.is(input), options);
+  static probeSupport(input, options = null) {
+    const recognized = this.is(input);
+    return {
+      format: this.id,
+      source: options?.source || "buffer",
+      recognized,
+      supported: recognized,
+      preferredOutput: recognized ? OUTPUT_JSON : "",
+      reason: recognized ? "Recognized a SQLite 3 container." : "The header signature is not SQLite 3.",
+      variants: [{
+        kind: OUTPUT_JSON,
+        supported: recognized
+      }, {
+        kind: OUTPUT_PAYLOAD,
+        supported: recognized
+      }, {
+        kind: OUTPUT_RAW,
+        supported: recognized
+      }],
+      metadata: recognized ? this.inspect(input) : {
+        family: this.id,
+        decodable: false
+      }
+    };
   }
 
-  // INTERIM, 2026-08-16. No `inspect` alias onto `isSupported`, while nineteen
-  // sibling formats have one. The capability-surface decision page names that
-  // alias as the confusion it wants removed, but its own "What is not proposed"
-  // says not to change things on its strength alone - so this is a divergence
-  // awaiting a decision, not a settled position.
-  //
-  // See maintenance/INTERIM-sqlite-and-static-2026-08-16.md before resolving it,
-  // and search for callers of `inspect` on any format first.
+  /** Return header facts without reading table rows. */
+  static inspect(input) {
+    const header = ReadHeader(Normalize(input));
+    return {
+      family: this.id,
+      decodable: true,
+      header
+    };
+  }
 
   /**
    * Reads every table and row.
@@ -82,7 +106,7 @@ class CjsSqliteFormat {
    * @returns {object} Tables keyed by name, each an array of row objects.
    */
   static read(input, options = {}) {
-    const output = options.output ?? OUTPUT_JSON;
+    const output = options.emit ?? options.output ?? OUTPUT_JSON;
     const bytes = Normalize(input);
     const header = ReadHeader(bytes);
     const schema = ReadMaster(bytes, header);
@@ -146,36 +170,20 @@ class CjsSqliteFormat {
   });
   static id = "sqlite";
   static extensions = Object.freeze([".sqlite", ".db", ".sqlite3"]);
-  static type = Object.freeze(["data"]);
   static mediaTypes = Object.freeze(["data"]);
-  static inputTypes = Object.freeze(["sqlite"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON, OUTPUT_PAYLOAD]);
-  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
-}
-
-/** Builds the probe shape the resource manager routes on. */
-function Probe(recognized, options) {
-  return {
-    format: "sqlite",
-    source: "buffer",
-    supported: recognized ? "full" : "none",
-    confidence: 1,
-    preferred: "sqlite",
-    // The header signature is content, not a declaration, so a match is
-    // evidence rather than a claim to be checked later.
-    verified: true,
-    reason: recognized ? "Recognized a SQLite 3 container." : "The header signature is not SQLite 3.",
-    variants: [{
-      kind: "container",
-      codec: "sqlite",
-      supported: recognized
-    }],
-    metadata: {
-      family: "sqlite",
-      decodable: recognized
+  static outputs = CjsFormat.defineOutputs({
+    json: {
+      default: true,
+      decoded: true
     },
-    ...(options || {})
-  };
+    payload: {
+      decoded: true
+    },
+    raw: {
+      role: "debug",
+      decoded: true
+    }
+  });
 }
 
 /** Reads `sqlite_master`, which is always the table b-tree rooted at page 1. */

package/dist/formats/sqlite/CjsSqliteFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsSqliteFormat.js","sources":["../../../../src/formats/sqlite/CjsSqliteFormat.js"],"sourcesContent":["import { ReadColumns } from \"./core/sqliteSchema.js\";\nimport { ReadHeader, TableRows } from \"./core/sqlitePages.js\";\nimport { ReadRecord, SqliteError } from \"./core/sqliteRecords.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst OUTPUT_RAW = \"raw\";\nconst MASTER_ROOT_PAGE = 1;\n\n/**\n * Reads a SQLite 3 container as data.\n *\n * **This is a reader, not a database.** It accepts no SQL and runs no queries.\n * It returns the tables a container holds and every row of them, because that\n * is the whole of what this organization does with a SQLite file: the client's\n * `.static` containers and the prepared static data export are both opened,\n * scanned once, and closed.\n *\n * That scope is what makes it small. A query planner, an index walker, writing,\n * journalling and transactions are most of SQLite and none of this, so none of\n * them are here. Index b-tree pages are never visited: an index holds no data a\n * table scan does not already produce.\n *\n * It exists because `runtime-resource` is browser-safe and ships no SQLite\n * engine, so `.static` containers of the SQLite family previously needed a\n * driver injected by the caller — which meant Node, and in practice the\n * experimental `node:sqlite`. Nothing here touches a filesystem or a binding.\n *\n * Values map as the format defines them: NULL, integers, doubles, text decoded\n * with the database's own encoding, and blobs as `Uint8Array`. An integer wider\n * than `Number.MAX_SAFE_INTEGER` is returned as a `BigInt` rather than silently\n * rounded.\n */\nexport class CjsSqliteFormat {\n\n  /**\n   * Reports whether bytes are a SQLite container, by signature.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Candidate bytes.\n   * @returns {boolean} True when the header signature matches.\n   */\n  static is(input) {\n    try {\n      ReadHeader(Normalize(input));\n\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reports whether these bytes are a SQLite container, on the signature.\n   *\n   * The signature is the whole claim: the header either says\n   * `SQLite format 3` or it does not, so this is verified by content rather\n   * than inferred from a name — which matters because `.static` carries three\n   * unrelated families and the extension proves nothing.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {object} Resource probe.\n   */\n  static isSupported(input, options = null) {\n    return Probe(this.is(input), options);\n  }\n\n  // INTERIM, 2026-08-16. No `inspect` alias onto `isSupported`, while nineteen\n  // sibling formats have one. The capability-surface decision page names that\n  // alias as the confusion it wants removed, but its own \"What is not proposed\"\n  // says not to change things on its strength alone - so this is a divergence\n  // awaiting a decision, not a settled position.\n  //\n  // See maintenance/INTERIM-sqlite-and-static-2026-08-16.md before resolving it,\n  // and search for callers of `inspect` on any format first.\n\n  /**\n   * Reads every table and row.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @param {object} [options] Read options.\n   * @param {string} [options.output] `json`, `payload` or `raw`.\n   * @param {string[]} [options.tables] Read only these tables.\n   * @returns {object} Tables keyed by name, each an array of row objects.\n   */\n  static read(input, options = {}) {\n    const output = options.output ?? OUTPUT_JSON;\n    const bytes = Normalize(input);\n    const header = ReadHeader(bytes);\n    const schema = ReadMaster(bytes, header);\n\n    if (output === OUTPUT_RAW) {\n      return { header, schema };\n    }\n\n    const wanted = options.tables ? new Set(options.tables) : null;\n    const tables = {};\n\n    for (const entry of schema) {\n      if (entry.type !== \"table\" || (wanted && !wanted.has(entry.name))) {\n        continue;\n      }\n\n      // A table with no root page holds nothing: a view, or WITHOUT ROWID.\n      tables[entry.name] = entry.rootPage\n        ? ReadTable(bytes, header, entry, output === OUTPUT_JSON)\n        : [];\n    }\n\n    return tables;\n  }\n\n  /** Reads to plain JSON-compatible values, converting blobs to arrays. */\n  static readJSON(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_JSON });\n  }\n\n  /** Reads with blobs left as `Uint8Array` and wide integers as `BigInt`. */\n  static readPayload(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_PAYLOAD });\n  }\n\n  /** Returns the parsed header and `sqlite_master` entries, decoding no rows. */\n  static readRaw(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_RAW });\n  }\n\n  /**\n   * Lists the tables a container holds, without reading their rows.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @returns {Array<object>} One entry per table.\n   */\n  static tables(input) {\n    const bytes = Normalize(input);\n\n    return ReadMaster(bytes, ReadHeader(bytes)).filter(entry => entry.type === \"table\");\n  }\n\n  static Output = Object.freeze({\n    JSON: OUTPUT_JSON,\n    PAYLOAD: OUTPUT_PAYLOAD,\n    RAW: OUTPUT_RAW\n  });\n\n  static id = \"sqlite\";\n  static extensions = Object.freeze([ \".sqlite\", \".db\", \".sqlite3\" ]);\n  static type = Object.freeze([ \"data\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static inputTypes = Object.freeze([ \"sqlite\" ]);\n  static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]);\n  static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\n}\n\n/** Builds the probe shape the resource manager routes on. */\nfunction Probe(recognized, options) {\n  return {\n    format: \"sqlite\",\n    source: \"buffer\",\n    supported: recognized ? \"full\" : \"none\",\n    confidence: 1,\n    preferred: \"sqlite\",\n    // The header signature is content, not a declaration, so a match is\n    // evidence rather than a claim to be checked later.\n    verified: true,\n    reason: recognized\n      ? \"Recognized a SQLite 3 container.\"\n      : \"The header signature is not SQLite 3.\",\n    variants: [ { kind: \"container\", codec: \"sqlite\", supported: recognized } ],\n    metadata: { family: \"sqlite\", decodable: recognized },\n    ...(options || {})\n  };\n}\n\n/** Reads `sqlite_master`, which is always the table b-tree rooted at page 1. */\nfunction ReadMaster(bytes, header) {\n  const entries = [];\n\n  for (const row of TableRows(bytes, header, MASTER_ROOT_PAGE)) {\n    const [ type, name, tableName, rootPage, sql ] = ReadRecord(row.payload, header.encoding);\n\n    entries.push({\n      type: String(type ?? \"\"),\n      name: String(name ?? \"\"),\n      tableName: String(tableName ?? \"\"),\n      rootPage: Number(rootPage ?? 0),\n      sql: sql === null || sql === undefined ? \"\" : String(sql)\n    });\n  }\n\n  return entries;\n}\n\n/** Reads one table's rows as objects, named from its `CREATE TABLE` text. */\nfunction ReadTable(bytes, header, entry, json) {\n  const { names, rowidAlias } = ReadColumns(entry.sql);\n  const rows = [];\n\n  for (const row of TableRows(bytes, header, entry.rootPage)) {\n    const values = ReadRecord(row.payload, header.encoding);\n    const record = {};\n\n    for (let index = 0; index < values.length; index += 1) {\n      // Positional names keep a row readable when the statement could not be\n      // parsed, rather than dropping columns that certainly hold data.\n      const name = names[index] ?? `column${index}`;\n      const value = index === rowidAlias && values[index] === null ? row.rowid : values[index];\n\n      record[name] = json ? ToJSON(value) : value;\n    }\n\n    rows.push(record);\n  }\n\n  return rows;\n}\n\n/** Converts a decoded value to something `JSON.stringify` keeps losslessly. */\nfunction ToJSON(value) {\n  if (value instanceof Uint8Array) {\n    return Array.from(value);\n  }\n\n  // A BigInt has no JSON form; a decimal string keeps every digit.\n  return typeof value === \"bigint\" ? value.toString(10) : value;\n}\n\n/** Accepts the byte forms every other format here accepts. */\nfunction Normalize(input) {\n  if (input instanceof Uint8Array) {\n    return input;\n  }\n\n  if (input instanceof ArrayBuffer) {\n    return new Uint8Array(input);\n  }\n\n  if (ArrayBuffer.isView(input)) {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  throw SqliteError(\"A SQLite container must be supplied as bytes.\");\n}\n\nexport default CjsSqliteFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","MASTER_ROOT_PAGE","CjsSqliteFormat","is","input","ReadHeader","Normalize","isSupported","options","Probe","read","output","bytes","header","schema","ReadMaster","wanted","tables","Set","entry","type","has","name","rootPage","ReadTable","readJSON","readPayload","readRaw","filter","Output","Object","freeze","JSON","PAYLOAD","RAW","id","extensions","mediaTypes","inputTypes","outputTypes","debugOutputTypes","recognized","format","source","supported","confidence","preferred","verified","reason","variants","kind","codec","metadata","family","decodable","entries","row","TableRows","tableName","sql","ReadRecord","payload","encoding","push","String","Number","undefined","json","names","rowidAlias","ReadColumns","rows","values","record","index","length","value","rowid","ToJSON","Uint8Array","Array","from","toString","ArrayBuffer","isView","buffer","byteOffset","byteLength","SqliteError"],"mappings":"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"}
+{"version":3,"file":"CjsSqliteFormat.js","sources":["../../../../src/formats/sqlite/CjsSqliteFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\nimport { ReadColumns } from \"./core/sqliteSchema.js\";\nimport { ReadHeader, TableRows } from \"./core/sqlitePages.js\";\nimport { ReadRecord, SqliteError } from \"./core/sqliteRecords.js\";\n\nconst OUTPUT_JSON = \"json\";\nconst OUTPUT_PAYLOAD = \"payload\";\nconst OUTPUT_RAW = \"raw\";\nconst MASTER_ROOT_PAGE = 1;\n\n/**\n * Reads a SQLite 3 container as data.\n *\n * **This is a reader, not a database.** It accepts no SQL and runs no queries.\n * It returns the tables a container holds and every row of them, because that\n * is the whole of what this organization does with a SQLite file: the client's\n * `.static` containers and the prepared static data export are both opened,\n * scanned once, and closed.\n *\n * That scope is what makes it small. A query planner, an index walker, writing,\n * journalling and transactions are most of SQLite and none of this, so none of\n * them are here. Index b-tree pages are never visited: an index holds no data a\n * table scan does not already produce.\n *\n * It exists because `runtime-resource` is browser-safe and ships no SQLite\n * engine, so `.static` containers of the SQLite family previously needed a\n * driver injected by the caller — which meant Node, and in practice the\n * experimental `node:sqlite`. Nothing here touches a filesystem or a binding.\n *\n * Values map as the format defines them: NULL, integers, doubles, text decoded\n * with the database's own encoding, and blobs as `Uint8Array`. An integer wider\n * than `Number.MAX_SAFE_INTEGER` is returned as a `BigInt` rather than silently\n * rounded.\n */\nexport class CjsSqliteFormat extends CjsFormat {\n\n  /**\n   * Reports whether bytes are a SQLite container, by signature.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Candidate bytes.\n   * @returns {boolean} True when the header signature matches.\n   */\n  static is(input) {\n    try {\n      ReadHeader(Normalize(input));\n\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Reports whether these bytes are a SQLite container, on the signature.\n   *\n   * The signature is the whole claim: the header either says\n   * `SQLite format 3` or it does not, so this is verified by content rather\n   * than inferred from a name — which matters because `.static` carries three\n   * unrelated families and the extension proves nothing.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {object} Resource probe.\n   */\n  static probeSupport(input, options = null) {\n    const recognized = this.is(input);\n    return {\n      format: this.id,\n      source: options?.source || \"buffer\",\n      recognized,\n      supported: recognized,\n      preferredOutput: recognized ? OUTPUT_JSON : \"\",\n      reason: recognized\n        ? \"Recognized a SQLite 3 container.\"\n        : \"The header signature is not SQLite 3.\",\n      variants: [\n        { kind: OUTPUT_JSON, supported: recognized },\n        { kind: OUTPUT_PAYLOAD, supported: recognized },\n        { kind: OUTPUT_RAW, supported: recognized }\n      ],\n      metadata: recognized ? this.inspect(input) : { family: this.id, decodable: false }\n    };\n  }\n\n  /** Return header facts without reading table rows. */\n  static inspect(input) {\n    const header = ReadHeader(Normalize(input));\n    return { family: this.id, decodable: true, header };\n  }\n\n  /**\n   * Reads every table and row.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @param {object} [options] Read options.\n   * @param {string} [options.output] `json`, `payload` or `raw`.\n   * @param {string[]} [options.tables] Read only these tables.\n   * @returns {object} Tables keyed by name, each an array of row objects.\n   */\n  static read(input, options = {}) {\n    const output = options.emit ?? options.output ?? OUTPUT_JSON;\n    const bytes = Normalize(input);\n    const header = ReadHeader(bytes);\n    const schema = ReadMaster(bytes, header);\n\n    if (output === OUTPUT_RAW) {\n      return { header, schema };\n    }\n\n    const wanted = options.tables ? new Set(options.tables) : null;\n    const tables = {};\n\n    for (const entry of schema) {\n      if (entry.type !== \"table\" || (wanted && !wanted.has(entry.name))) {\n        continue;\n      }\n\n      // A table with no root page holds nothing: a view, or WITHOUT ROWID.\n      tables[entry.name] = entry.rootPage\n        ? ReadTable(bytes, header, entry, output === OUTPUT_JSON)\n        : [];\n    }\n\n    return tables;\n  }\n\n  /** Reads to plain JSON-compatible values, converting blobs to arrays. */\n  static readJSON(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_JSON });\n  }\n\n  /** Reads with blobs left as `Uint8Array` and wide integers as `BigInt`. */\n  static readPayload(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_PAYLOAD });\n  }\n\n  /** Returns the parsed header and `sqlite_master` entries, decoding no rows. */\n  static readRaw(input, options = {}) {\n    return this.read(input, { ...options, output: OUTPUT_RAW });\n  }\n\n  /**\n   * Lists the tables a container holds, without reading their rows.\n   *\n   * @param {Uint8Array|ArrayBuffer} input Container bytes.\n   * @returns {Array<object>} One entry per table.\n   */\n  static tables(input) {\n    const bytes = Normalize(input);\n\n    return ReadMaster(bytes, ReadHeader(bytes)).filter(entry => entry.type === \"table\");\n  }\n\n  static Output = Object.freeze({\n    JSON: OUTPUT_JSON,\n    PAYLOAD: OUTPUT_PAYLOAD,\n    RAW: OUTPUT_RAW\n  });\n\n  static id = \"sqlite\";\n  static extensions = Object.freeze([ \".sqlite\", \".db\", \".sqlite3\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = CjsFormat.defineOutputs({\n      json: { default: true, decoded: true },\n      payload: { decoded: true },\n      raw: { role: \"debug\", decoded: true }\n  });\n}\n\n/** Reads `sqlite_master`, which is always the table b-tree rooted at page 1. */\nfunction ReadMaster(bytes, header) {\n  const entries = [];\n\n  for (const row of TableRows(bytes, header, MASTER_ROOT_PAGE)) {\n    const [ type, name, tableName, rootPage, sql ] = ReadRecord(row.payload, header.encoding);\n\n    entries.push({\n      type: String(type ?? \"\"),\n      name: String(name ?? \"\"),\n      tableName: String(tableName ?? \"\"),\n      rootPage: Number(rootPage ?? 0),\n      sql: sql === null || sql === undefined ? \"\" : String(sql)\n    });\n  }\n\n  return entries;\n}\n\n/** Reads one table's rows as objects, named from its `CREATE TABLE` text. */\nfunction ReadTable(bytes, header, entry, json) {\n  const { names, rowidAlias } = ReadColumns(entry.sql);\n  const rows = [];\n\n  for (const row of TableRows(bytes, header, entry.rootPage)) {\n    const values = ReadRecord(row.payload, header.encoding);\n    const record = {};\n\n    for (let index = 0; index < values.length; index += 1) {\n      // Positional names keep a row readable when the statement could not be\n      // parsed, rather than dropping columns that certainly hold data.\n      const name = names[index] ?? `column${index}`;\n      const value = index === rowidAlias && values[index] === null ? row.rowid : values[index];\n\n      record[name] = json ? ToJSON(value) : value;\n    }\n\n    rows.push(record);\n  }\n\n  return rows;\n}\n\n/** Converts a decoded value to something `JSON.stringify` keeps losslessly. */\nfunction ToJSON(value) {\n  if (value instanceof Uint8Array) {\n    return Array.from(value);\n  }\n\n  // A BigInt has no JSON form; a decimal string keeps every digit.\n  return typeof value === \"bigint\" ? value.toString(10) : value;\n}\n\n/** Accepts the byte forms every other format here accepts. */\nfunction Normalize(input) {\n  if (input instanceof Uint8Array) {\n    return input;\n  }\n\n  if (input instanceof ArrayBuffer) {\n    return new Uint8Array(input);\n  }\n\n  if (ArrayBuffer.isView(input)) {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  throw SqliteError(\"A SQLite container must be supplied as bytes.\");\n}\n\nexport default CjsSqliteFormat;\n"],"names":["OUTPUT_JSON","OUTPUT_PAYLOAD","OUTPUT_RAW","MASTER_ROOT_PAGE","CjsSqliteFormat","CjsFormat","is","input","ReadHeader","Normalize","probeSupport","options","recognized","format","id","source","supported","preferredOutput","reason","variants","kind","metadata","inspect","family","decodable","header","read","output","emit","bytes","schema","ReadMaster","wanted","tables","Set","entry","type","has","name","rootPage","ReadTable","readJSON","readPayload","readRaw","filter","Output","Object","freeze","JSON","PAYLOAD","RAW","extensions","mediaTypes","outputs","defineOutputs","json","default","decoded","payload","raw","role","entries","row","TableRows","tableName","sql","ReadRecord","encoding","push","String","Number","undefined","names","rowidAlias","ReadColumns","rows","values","record","index","length","value","rowid","ToJSON","Uint8Array","Array","from","toString","ArrayBuffer","isView","buffer","byteOffset","byteLength","SqliteError"],"mappings":"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"}

package/dist/formats/static/CjsStaticFormat.js

@@ -1,3 +1,5 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
+
 const SQLITE_SIGNATURE = "SQLite format 3\0";
 const PICKLE_PREFIX_BYTES = 4;
 
@@ -39,7 +41,7 @@ const CJS_STATIC_FAMILIES = Object.freeze({
  * about what to decode in the wrong place. Nothing outside its own tests ever
  * called it.
  */
-class CjsStaticFormat {
+class CjsStaticFormat extends CjsFormat {
   /**
    * Report which family a container holds, on the declaration seam.
    *
@@ -51,8 +53,16 @@ class CjsStaticFormat {
    * @param {object} [options] Probe options.
    * @returns {CjsResourceProbe} Declaration-derived probe.
    */
-  static isSupported(input, options = null) {
-    return Probe(this.describe(input), false, options);
+  static probeSupport(input, options = null) {
+    const detected = this.describe(input);
+    return {
+      format: this.id,
+      source: options?.source || "buffer",
+      recognized: detected.family !== CJS_STATIC_FAMILIES.UNKNOWN,
+      supported: false,
+      reason: detected.reason ?? `Recognized a ${detected.family} container.`,
+      metadata: detected
+    };
   }
 
   /**
@@ -63,25 +73,7 @@ class CjsStaticFormat {
    * @returns {CjsResourceProbe} Declaration-derived probe.
    */
   static inspect(input, options = null) {
-    return this.isSupported(input, options);
-  }
-
-  /**
-   * Content-verified family resolution.
-   *
-   * Contract: docs/concepts/format-type-resolution.md. There is no declared
-   * type to disagree with here — the extension is silent — so the signature is
-   * both the claim and the evidence, and the resolution is always verified.
-   * `preferred` names the decode route, and all three now lead into this
-   * package: `CjsPickleFormat`, `CjsSqliteFormat`, and `CjsSchemaBoundFormat`
-   * once the caller has the `.schema` companion to hand it.
-   *
-   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.
-   * @param {object} [options] Probe options.
-   * @returns {Promise<CjsResourceProbe>} Verified probe.
-   */
-  static async resolveType(input, options = null) {
-    return Probe(this.describe(input), true, options);
+    return this.describe(input);
   }
 
   /**
@@ -147,8 +139,8 @@ class CjsStaticFormat {
   }
   static id = "static";
   static extensions = Object.freeze([".static"]);
-  static type = Object.freeze(["data"]);
   static mediaTypes = Object.freeze(["data"]);
+  static outputs = Object.freeze({});
 
   /**
    * The extension is the only input this format claims.
@@ -159,40 +151,6 @@ class CjsStaticFormat {
    * nothing and the signature has to be read. The family belongs in
    * `describe()`, which measures it, not in a static that asserts it.
    */
-  static inputTypes = Object.freeze(["static"]);
-  static outputTypes = Object.freeze(["json", "payload"]);
-  static debugOutputTypes = Object.freeze(["raw"]);
-}
-
-/**
- * Build the shared probe payload.
- *
- * Formats report a plain probe-shaped object rather than constructing a
- * `CjsResourceProbe`, which keeps this module free of the decorated class and
- * of the build transform it needs.
- */
-function Probe(detected, verified, options) {
-  return {
-    format: "static",
-    source: "buffer",
-    supported: detected.decodable ? "full" : "partial",
-    confidence: detected.family === CJS_STATIC_FAMILIES.UNKNOWN ? 0.5 : 1,
-    preferred: detected.family,
-    verified,
-    reason: detected.reason ?? `Recognized a ${detected.family} container.`,
-    variants: [{
-      kind: "container",
-      codec: detected.family,
-      supported: detected.decodable
-    }],
-    metadata: verified ? {
-      ...detected,
-      declared: null,
-      resolved: detected.family,
-      mismatch: false
-    } : detected,
-    ...(options || {})
-  };
 }
 function MatchesSqlite(bytes) {
   if (bytes.byteLength < SQLITE_SIGNATURE.length) return false;

package/dist/formats/static/CjsStaticFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsStaticFormat.js","sources":["../../../../src/formats/static/CjsStaticFormat.js"],"sourcesContent":["\nconst SQLITE_SIGNATURE = \"SQLite format 3\\0\";\nconst PICKLE_PREFIX_BYTES = 4;\n\n/** Container families found behind the single `.static` extension. */\nexport const CJS_STATIC_FAMILIES = Object.freeze({\n  SQLITE: \"sqlite\",\n  PICKLE: \"pickle\",\n  UNKNOWN: \"unknown\"\n});\n\n/**\n * Identifies which container a client `.static` file actually holds.\n *\n * The extension names a role, not a format. Three unrelated containers ship\n * under it, and each fails in its own way when guessed at:\n *\n * - **SQLite 3** — a `cache(key, value, time)` plus `indexes(key, value)`\n *   database whose values are JSON documents. `CjsSqliteFormat` reads it.\n * - **Embedded schema** — a four-byte little-endian SCHEMA LENGTH followed by\n *   that schema as a protocol-0 pickle, and then a payload. The prefix is not a\n *   wrapper to skip: slice `[4, 4 + length)` for the schema and give the rest\n *   to `CjsSchemaBoundFormat`. All 25 of these name one global,\n *   `collections.OrderedDict`, which the pickle reader rebuilds as plain data.\n * - **Schema-bound** — a binary record container whose `.schema` companion is\n *   YAML describing its own layout: attribute sizes and types, optional flags,\n *   lists with a fixed item size, vectors with a precision, and a key footer of\n *   key-to-offset pairs. Nothing needs deriving, because the build ships the\n *   layout. Six datasets are stored this way - the map skeleton of regions,\n *   constellations and systems. `CjsSchemaBoundFormat` reads it, given that\n *   companion, and reads the embedded-schema family above from the same code.\n *\n * Detection is signature-based and never executes or trusts file names.\n *\n * **This class identifies and does not decode.** It reports the family, the\n * payload offset and what is still missing; the caller takes that answer to the\n * format that owns the family. It carried a `read()` that dispatched to\n * `CjsPickleFormat` and `CjsSqliteFormat` until 2026-08-15, which made an\n * identification format the routing table for two others and put the decision\n * about what to decode in the wrong place. Nothing outside its own tests ever\n * called it.\n */\nexport class CjsStaticFormat\n{\n\n  /**\n   * Report which family a container holds, on the declaration seam.\n   *\n   * `.static` declares nothing: the extension names a role and every family\n   * wears it. The signature is therefore the only claim there is, which is why\n   * this format reads it here rather than trusting a name.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static isSupported(input, options = null)\n  {\n    return Probe(this.describe(input), false, options);\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static inspect(input, options = null)\n  {\n    return this.isSupported(input, options);\n  }\n\n  /**\n   * Content-verified family resolution.\n   *\n   * Contract: docs/concepts/format-type-resolution.md. There is no declared\n   * type to disagree with here — the extension is silent — so the signature is\n   * both the claim and the evidence, and the resolution is always verified.\n   * `preferred` names the decode route, and all three now lead into this\n   * package: `CjsPickleFormat`, `CjsSqliteFormat`, and `CjsSchemaBoundFormat`\n   * once the caller has the `.schema` companion to hand it.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {Promise<CjsResourceProbe>} Verified probe.\n   */\n  static async resolveType(input, options = null)\n  {\n    return Probe(this.describe(input), true, options);\n  }\n\n  /**\n   * Describe one container without decoding it or building a probe.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {object} Family, payload offset, and whether this package decodes it.\n   */\n  static describe(input)\n  {\n    const bytes = Normalize(input);\n\n    if (MatchesSqlite(bytes))\n    {\n      return Object.freeze({\n        family: CJS_STATIC_FAMILIES.SQLITE,\n        byteLength: bytes.byteLength,\n        payloadOffset: 0,\n        prefix: null,\n        // Decodable outright since CjsSqliteFormat landed. This reported\n        // `requires: \"sqlite\"` while a caller had to supply an engine, and was\n        // the example behind the argument that a capability can depend on the\n        // caller's environment - an argument that now needs a different one.\n        decodable: true,\n        requires: null,\n        reason: \"Recognized a SQLite container.\"\n      });\n    }\n\n    if (MatchesPickle(bytes))\n    {\n      const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n\n      return Object.freeze({\n        family: CJS_STATIC_FAMILIES.PICKLE,\n        byteLength: bytes.byteLength,\n        payloadOffset: PICKLE_PREFIX_BYTES,\n        prefix: view.getUint32(0, true),\n        decodable: true,\n        requires: null,\n        reason: null\n      });\n    }\n\n    return Object.freeze({\n      family: CJS_STATIC_FAMILIES.UNKNOWN,\n      byteLength: bytes.byteLength,\n      payloadOffset: 0,\n      prefix: null,\n      decodable: false,\n      requires: \"schema\",\n      // `decodable` is this format's own answer, and it stays false: these bytes\n      // carry nothing to identify, so the family is an inference from the absence\n      // of the other two signatures rather than a reading. `requires` names what\n      // closes that gap - with the companion, CjsSchemaBoundFormat decodes it.\n      reason: \"No signature. A schema-bound container needs its .schema companion, \"\n        + \"which is YAML describing the layout. CjsSchemaBoundFormat reads it from there.\"\n    });\n  }\n\n  /**\n   * Return the decodable payload for a container, without its wrapper.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {Uint8Array} Payload bytes.\n   */\n  static payload(input)\n  {\n    const bytes = Normalize(input);\n    const detected = this.describe(bytes);\n\n    return bytes.subarray(detected.payloadOffset);\n  }\n\n\n  static id = \"static\";\n  static extensions = Object.freeze([ \".static\" ]);\n  static type = Object.freeze([ \"data\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n\n  /**\n   * The extension is the only input this format claims.\n   *\n   * Naming the three families here would be a lie in the other direction: a\n   * caller cannot hand this format \"a pickle\" or \"a sqlite\" and expect it to\n   * route, because the whole point of the class is that `.static` declares\n   * nothing and the signature has to be read. The family belongs in\n   * `describe()`, which measures it, not in a static that asserts it.\n   */\n  static inputTypes = Object.freeze([ \"static\" ]);\n  static outputTypes = Object.freeze([ \"json\", \"payload\" ]);\n  static debugOutputTypes = Object.freeze([ \"raw\" ]);\n\n}\n\n/**\n * Build the shared probe payload.\n *\n * Formats report a plain probe-shaped object rather than constructing a\n * `CjsResourceProbe`, which keeps this module free of the decorated class and\n * of the build transform it needs.\n */\nfunction Probe(detected, verified, options)\n{\n  return {\n    format: \"static\",\n    source: \"buffer\",\n    supported: detected.decodable ? \"full\" : \"partial\",\n    confidence: detected.family === CJS_STATIC_FAMILIES.UNKNOWN ? 0.5 : 1,\n    preferred: detected.family,\n    verified,\n    reason: detected.reason ?? `Recognized a ${detected.family} container.`,\n    variants: [ { kind: \"container\", codec: detected.family, supported: detected.decodable } ],\n    metadata: verified\n      ? { ...detected, declared: null, resolved: detected.family, mismatch: false }\n      : detected,\n    ...(options || {})\n  };\n}\n\nfunction MatchesSqlite(bytes)\n{\n  if (bytes.byteLength < SQLITE_SIGNATURE.length) return false;\n\n  for (let index = 0; index < SQLITE_SIGNATURE.length; index++)\n  {\n    if (bytes[index] !== SQLITE_SIGNATURE.charCodeAt(index)) return false;\n  }\n\n  return true;\n}\n\nfunction MatchesPickle(bytes)\n{\n  // A protocol-0 pickle opens a container then names it: \"(dp1\\n\" or \"(lp1\\n\".\n  if (bytes.byteLength < PICKLE_PREFIX_BYTES + 3) return false;\n  if (bytes[PICKLE_PREFIX_BYTES] !== 0x28) return false;\n\n  const kind = bytes[PICKLE_PREFIX_BYTES + 1];\n\n  return kind === 0x64 || kind === 0x6c;\n}\n\nfunction Normalize(input)\n{\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input))\n  {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  const error = new TypeError(\"A .static container must be an ArrayBuffer or a view over one.\");\n\n  error.code = \"CJS_STATIC_FORMAT_INPUT_INVALID\";\n  throw error;\n}\n"],"names":["SQLITE_SIGNATURE","PICKLE_PREFIX_BYTES","CJS_STATIC_FAMILIES","Object","freeze","SQLITE","PICKLE","UNKNOWN","CjsStaticFormat","isSupported","input","options","Probe","describe","inspect","resolveType","bytes","Normalize","MatchesSqlite","family","byteLength","payloadOffset","prefix","decodable","requires","reason","MatchesPickle","view","DataView","buffer","byteOffset","getUint32","payload","detected","subarray","id","extensions","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes","verified","format","source","supported","confidence","preferred","variants","kind","codec","metadata","declared","resolved","mismatch","length","index","charCodeAt","ArrayBuffer","Uint8Array","isView","error","TypeError","code"],"mappings":"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"}
+{"version":3,"file":"CjsStaticFormat.js","sources":["../../../../src/formats/static/CjsStaticFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\n\nconst SQLITE_SIGNATURE = \"SQLite format 3\\0\";\nconst PICKLE_PREFIX_BYTES = 4;\n\n/** Container families found behind the single `.static` extension. */\nexport const CJS_STATIC_FAMILIES = Object.freeze({\n  SQLITE: \"sqlite\",\n  PICKLE: \"pickle\",\n  UNKNOWN: \"unknown\"\n});\n\n/**\n * Identifies which container a client `.static` file actually holds.\n *\n * The extension names a role, not a format. Three unrelated containers ship\n * under it, and each fails in its own way when guessed at:\n *\n * - **SQLite 3** — a `cache(key, value, time)` plus `indexes(key, value)`\n *   database whose values are JSON documents. `CjsSqliteFormat` reads it.\n * - **Embedded schema** — a four-byte little-endian SCHEMA LENGTH followed by\n *   that schema as a protocol-0 pickle, and then a payload. The prefix is not a\n *   wrapper to skip: slice `[4, 4 + length)` for the schema and give the rest\n *   to `CjsSchemaBoundFormat`. All 25 of these name one global,\n *   `collections.OrderedDict`, which the pickle reader rebuilds as plain data.\n * - **Schema-bound** — a binary record container whose `.schema` companion is\n *   YAML describing its own layout: attribute sizes and types, optional flags,\n *   lists with a fixed item size, vectors with a precision, and a key footer of\n *   key-to-offset pairs. Nothing needs deriving, because the build ships the\n *   layout. Six datasets are stored this way - the map skeleton of regions,\n *   constellations and systems. `CjsSchemaBoundFormat` reads it, given that\n *   companion, and reads the embedded-schema family above from the same code.\n *\n * Detection is signature-based and never executes or trusts file names.\n *\n * **This class identifies and does not decode.** It reports the family, the\n * payload offset and what is still missing; the caller takes that answer to the\n * format that owns the family. It carried a `read()` that dispatched to\n * `CjsPickleFormat` and `CjsSqliteFormat` until 2026-08-15, which made an\n * identification format the routing table for two others and put the decision\n * about what to decode in the wrong place. Nothing outside its own tests ever\n * called it.\n */\nexport class CjsStaticFormat extends CjsFormat\n{\n\n  /**\n   * Report which family a container holds, on the declaration seam.\n   *\n   * `.static` declares nothing: the extension names a role and every family\n   * wears it. The signature is therefore the only claim there is, which is why\n   * this format reads it here rather than trusting a name.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static probeSupport(input, options = null)\n  {\n    const detected = this.describe(input);\n    return {\n      format: this.id,\n      source: options?.source || \"buffer\",\n      recognized: detected.family !== CJS_STATIC_FAMILIES.UNKNOWN,\n      supported: false,\n      reason: detected.reason ?? `Recognized a ${detected.family} container.`,\n      metadata: detected\n    };\n  }\n\n  /**\n   * Alias for canonical naming.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @param {object} [options] Probe options.\n   * @returns {CjsResourceProbe} Declaration-derived probe.\n   */\n  static inspect(input, options = null)\n  {\n    void options;\n    return this.describe(input);\n  }\n\n  /**\n   * Describe one container without decoding it or building a probe.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {object} Family, payload offset, and whether this package decodes it.\n   */\n  static describe(input)\n  {\n    const bytes = Normalize(input);\n\n    if (MatchesSqlite(bytes))\n    {\n      return Object.freeze({\n        family: CJS_STATIC_FAMILIES.SQLITE,\n        byteLength: bytes.byteLength,\n        payloadOffset: 0,\n        prefix: null,\n        // Decodable outright since CjsSqliteFormat landed. This reported\n        // `requires: \"sqlite\"` while a caller had to supply an engine, and was\n        // the example behind the argument that a capability can depend on the\n        // caller's environment - an argument that now needs a different one.\n        decodable: true,\n        requires: null,\n        reason: \"Recognized a SQLite container.\"\n      });\n    }\n\n    if (MatchesPickle(bytes))\n    {\n      const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n\n      return Object.freeze({\n        family: CJS_STATIC_FAMILIES.PICKLE,\n        byteLength: bytes.byteLength,\n        payloadOffset: PICKLE_PREFIX_BYTES,\n        prefix: view.getUint32(0, true),\n        decodable: true,\n        requires: null,\n        reason: null\n      });\n    }\n\n    return Object.freeze({\n      family: CJS_STATIC_FAMILIES.UNKNOWN,\n      byteLength: bytes.byteLength,\n      payloadOffset: 0,\n      prefix: null,\n      decodable: false,\n      requires: \"schema\",\n      // `decodable` is this format's own answer, and it stays false: these bytes\n      // carry nothing to identify, so the family is an inference from the absence\n      // of the other two signatures rather than a reading. `requires` names what\n      // closes that gap - with the companion, CjsSchemaBoundFormat decodes it.\n      reason: \"No signature. A schema-bound container needs its .schema companion, \"\n        + \"which is YAML describing the layout. CjsSchemaBoundFormat reads it from there.\"\n    });\n  }\n\n  /**\n   * Return the decodable payload for a container, without its wrapper.\n   *\n   * @param {ArrayBuffer|ArrayBufferView} input Container bytes.\n   * @returns {Uint8Array} Payload bytes.\n   */\n  static payload(input)\n  {\n    const bytes = Normalize(input);\n    const detected = this.describe(bytes);\n\n    return bytes.subarray(detected.payloadOffset);\n  }\n\n\n  static id = \"static\";\n  static extensions = Object.freeze([ \".static\" ]);\n  static mediaTypes = Object.freeze([ \"data\" ]);\n  static outputs = Object.freeze({});\n\n  /**\n   * The extension is the only input this format claims.\n   *\n   * Naming the three families here would be a lie in the other direction: a\n   * caller cannot hand this format \"a pickle\" or \"a sqlite\" and expect it to\n   * route, because the whole point of the class is that `.static` declares\n   * nothing and the signature has to be read. The family belongs in\n   * `describe()`, which measures it, not in a static that asserts it.\n   */\n\n}\n\nfunction MatchesSqlite(bytes)\n{\n  if (bytes.byteLength < SQLITE_SIGNATURE.length) return false;\n\n  for (let index = 0; index < SQLITE_SIGNATURE.length; index++)\n  {\n    if (bytes[index] !== SQLITE_SIGNATURE.charCodeAt(index)) return false;\n  }\n\n  return true;\n}\n\nfunction MatchesPickle(bytes)\n{\n  // A protocol-0 pickle opens a container then names it: \"(dp1\\n\" or \"(lp1\\n\".\n  if (bytes.byteLength < PICKLE_PREFIX_BYTES + 3) return false;\n  if (bytes[PICKLE_PREFIX_BYTES] !== 0x28) return false;\n\n  const kind = bytes[PICKLE_PREFIX_BYTES + 1];\n\n  return kind === 0x64 || kind === 0x6c;\n}\n\nfunction Normalize(input)\n{\n  if (input instanceof ArrayBuffer) return new Uint8Array(input);\n\n  if (ArrayBuffer.isView(input))\n  {\n    return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n  }\n\n  const error = new TypeError(\"A .static container must be an ArrayBuffer or a view over one.\");\n\n  error.code = \"CJS_STATIC_FORMAT_INPUT_INVALID\";\n  throw error;\n}\n"],"names":["SQLITE_SIGNATURE","PICKLE_PREFIX_BYTES","CJS_STATIC_FAMILIES","Object","freeze","SQLITE","PICKLE","UNKNOWN","CjsStaticFormat","CjsFormat","probeSupport","input","options","detected","describe","format","id","source","recognized","family","supported","reason","metadata","inspect","bytes","Normalize","MatchesSqlite","byteLength","payloadOffset","prefix","decodable","requires","MatchesPickle","view","DataView","buffer","byteOffset","getUint32","payload","subarray","extensions","mediaTypes","outputs","length","index","charCodeAt","kind","ArrayBuffer","Uint8Array","isView","error","TypeError","code"],"mappings":"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"}

package/dist/formats/static/staticContainers.js

@@ -52,9 +52,9 @@ function FamilyError(path, found, wanted, reason) {
  * @returns {Promise<object>} Records keyed by their container key.
  */
 async function ReadStaticContainer(bytes, path = ".static input") {
-  const probe = await CjsStaticFormat.resolveType(bytes);
-  if (probe.preferred !== CJS_STATIC_FAMILIES.SQLITE) {
-    throw FamilyError(path, probe.preferred, CJS_STATIC_FAMILIES.SQLITE, probe.reason);
+  const detected = CjsStaticFormat.inspect(bytes);
+  if (detected.family !== CJS_STATIC_FAMILIES.SQLITE) {
+    throw FamilyError(path, detected.family, CJS_STATIC_FAMILIES.SQLITE, detected.reason);
   }
   const tables = CjsSqliteFormat.readJSON(bytes, {
     tables: [CACHE_TABLE]
@@ -126,12 +126,12 @@ function ReadEmbeddedSchemaContainer(bytes, path = ".static input") {
  * @returns {Promise<object|Array>} Decoded records.
  */
 async function ReadSchemaBoundContainer(bytes, schema, path = ".static input") {
-  const probe = await CjsStaticFormat.resolveType(bytes);
+  const detected = CjsStaticFormat.inspect(bytes);
 
   // The schema-bound family is the one with nothing to recognize, so it is
   // reported as `unknown` with `requires: "schema"` rather than named outright.
-  if (probe.preferred !== CJS_STATIC_FAMILIES.UNKNOWN) {
-    throw FamilyError(path, probe.preferred, "schema-bound", null);
+  if (detected.family !== CJS_STATIC_FAMILIES.UNKNOWN) {
+    throw FamilyError(path, detected.family, "schema-bound", null);
   }
   return CjsSchemaBoundFormat.read(bytes, {
     schema