cesr-ts 0.2.2 → 0.3.0

package/types/src/core/recovery-diagnostics.d.ts

@@ -0,0 +1,59 @@
+import type { Versionage } from "../tables/table-types.js";
+/** Attachment-dispatch recovery can only occur in counter domains. */
+export type RecoveryDispatchDomain = "txt" | "bny";
+/** Backward-compatible fallback callback payload shape. */
+export interface RecoveryVersionFallbackInfo {
+    from: Versionage;
+    to: Versionage;
+    domain: RecoveryDispatchDomain;
+    reason: string;
+}
+/** Version-retry fallback accepted in attachment dispatch. */
+export interface VersionFallbackAcceptedDiagnostic {
+    type: "version-fallback-accepted";
+    from: Versionage;
+    to: Versionage;
+    domain: RecoveryDispatchDomain;
+    reason: string;
+}
+/** Version-retry fallback rejected in attachment dispatch. */
+export interface VersionFallbackRejectedDiagnostic {
+    type: "version-fallback-rejected";
+    version: Versionage;
+    domain: RecoveryDispatchDomain;
+    errorName: string;
+    reason: string;
+}
+/** Wrapper nested parse failure recovered by preserving opaque tail units. */
+export interface WrapperOpaqueTailPreservedDiagnostic {
+    type: "wrapper-opaque-tail-preserved";
+    version: Versionage;
+    domain: RecoveryDispatchDomain;
+    wrapperCode: string;
+    opaqueItemCount: number;
+    errorName: string;
+    reason: string;
+}
+/** Parser non-shortage error handling path that emits error + reset. */
+export interface ParserErrorResetDiagnostic {
+    type: "parser-error-reset";
+    offset: number;
+    errorName: string;
+    reason: string;
+}
+/** Structured recovery diagnostics union for parser/dispatch observability. */
+export type RecoveryDiagnostic = VersionFallbackAcceptedDiagnostic | VersionFallbackRejectedDiagnostic | WrapperOpaqueTailPreservedDiagnostic | ParserErrorResetDiagnostic;
+/** Observer contract for structured recovery diagnostics. */
+export type RecoveryDiagnosticObserver = (diagnostic: RecoveryDiagnostic) => void;
+/**
+ * Compose diagnostics and legacy fallback callback observers.
+ *
+ * Why:
+ * keeps compatibility with legacy fallback callbacks while normalizing
+ * observability through one structured diagnostics stream.
+ */
+export declare function composeRecoveryDiagnosticObserver(options?: {
+    onRecoveryDiagnostic?: RecoveryDiagnosticObserver;
+    onAttachmentVersionFallback?: (info: RecoveryVersionFallbackInfo) => void;
+}): RecoveryDiagnosticObserver | undefined;
+//# sourceMappingURL=recovery-diagnostics.d.ts.map

package/types/src/core/recovery-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/src/core/recovery-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,2BAA2B,CAAC;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAC1B,iCAAiC,GACjC,iCAAiC,GACjC,oCAAoC,GACpC,0BAA0B,CAAC;AAE/B,6DAA6D;AAC7D,MAAM,MAAM,0BAA0B,GAAG,CACvC,UAAU,EAAE,kBAAkB,KAC3B,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,GAAE;IACzD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,2BAA2B,CAAC,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,IAAI,CAAC;CACtE,GAAG,0BAA0B,GAAG,SAAS,CAsB9C"}

package/types/src/core/types.d.ts

@@ -8,18 +8,33 @@ export interface Smellage {
     gvrsn: Versionage | null;
 }
 export type ColdCode = "msg" | "txt" | "bny" | "ano";
-export interface SerderEnvelope {
+/** Body payload for one parsed CESR frame. */
+export interface CesrBody {
+    /** The raw bytes of the body. */
     raw: Uint8Array;
+    /**
+     * The "key event dictionary" of the parsed bytes. Insertion ordered dictionary of fields.
+     */
     ked: Record<string, unknown> | null;
-    proto: Protocol;
+    /** Serialization kind of the body. */
     kind: Kind;
+    /** The size of the body in bytes. */
     size: number;
+    /** The protocol of the body. */
+    proto: Protocol;
+    /** The protocol version of the body. */
     pvrsn: Versionage;
+    /** The genus version of the body. */
     gvrsn: Versionage | null;
+    /** The event type of the body. */
     ilk: string | null;
+    /** The SAID of the body. */
     said: string | null;
+    /** The native fields of the body. */
     native?: {
+        /** The body code of the native fields. */
         bodyCode: string;
+        /** The fields of the native fields. */
         fields: Array<{
             label: string | null;
             code: string;
@@ -27,24 +42,63 @@ export interface SerderEnvelope {
         }>;
     };
 }
+/** Discriminated model for one parsed attachment payload unit. */
+export type AttachmentItem = AttachmentQb64Item | AttachmentQb2Item | AttachmentTupleItem | AttachmentNestedGroupItem;
+/** Text-domain unit (single qb64 token or opaque quadlet). */
+export interface AttachmentQb64Item {
+    kind: "qb64";
+    qb64: string;
+    opaque: boolean;
+}
+/** Binary-domain unit (single qb2 token or opaque triplet). */
+export interface AttachmentQb2Item {
+    kind: "qb2";
+    qb2: Uint8Array;
+    opaque: boolean;
+}
+/** Tuple/repeated payload unit preserving source ordering. */
+export interface AttachmentTupleItem {
+    kind: "tuple";
+    items: AttachmentItem[];
+}
+/** Wrapper-enclosed nested group summary. */
+export interface AttachmentNestedGroupItem {
+    kind: "group";
+    code: string;
+    name: string;
+    count: number;
+}
+/** Trailing attachment group parsed after a frame body. */
 export interface AttachmentGroup {
     code: string;
     name: string;
     count: number;
     raw: Uint8Array;
-    items: unknown[];
+    items: AttachmentItem[];
 }
-export interface CesrFrame {
-    serder: SerderEnvelope;
+/**
+ * Historical public type name for one parsed frame payload.
+ *
+ * Terminology note: parser docs use "frame" for the emitted unit
+ * (`body` + trailing `attachments`), while this exported type name
+ * remains `CesrMessage` for backward compatibility.
+ */
+export interface CesrMessage {
+    body: CesrBody;
     attachments: AttachmentGroup[];
 }
+/**
+ * State of the CESR parser engine.
+ * Contains the buffer of bytes to be parsed and the current offset.
+ */
 export interface ParserState {
     buffer: Uint8Array;
     offset: number;
 }
-export type ParseEmission = {
+/** Parser stream event union: parsed frame payload or parse error. */
+export type CesrFrame = {
     type: "frame";
-    frame: CesrFrame;
+    frame: CesrMessage;
 } | {
     type: "error";
     error: Error;

package/types/src/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/core/types.ts"],"names":[],"mappings":"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"}

package/types/src/index.d.ts

@@ -1,6 +1,8 @@
 export * from "./core/types.js";
 export * from "./core/errors.js";
 export * from "./core/parser-engine.js";
+export * from "./core/parser-policy.js";
+export * from "./core/recovery-diagnostics.js";
 export * from "./parser/cold-start.js";
 export * from "./parser/group-dispatch.js";
 export * from "./serder/smell.js";
@@ -39,9 +41,11 @@ export * from "./router/router-stub.js";
 export * from "./tables/versions.js";
 export * from "./tables/table-types.js";
 export * from "./tables/counter-codex.js";
+export * from "./tables/counter-version-registry.js";
 export * from "./annotate/types.js";
 export * from "./annotate/comments.js";
 export * from "./annotate/render.js";
 export * from "./annotate/annotator.js";
 export * from "./annotate/denot.js";
+export * from "./bench/parser-benchmark.js";
 //# sourceMappingURL=index.d.ts.map

package/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC"}

package/types/src/parser/attachment-fallback-policy.d.ts

@@ -0,0 +1,78 @@
+import type { ColdCode } from "../core/types.js";
+import type { Versionage } from "../tables/table-types.js";
+/** Attachment dispatch fallback is only defined for counter domains. */
+export type AttachmentDispatchDomain = Extract<ColdCode, "txt" | "bny">;
+/** Named presets for default attachment fallback strategy behavior. */
+export type AttachmentDispatchMode = "strict" | "compat";
+/** Structured info emitted when compat fallback crosses major versions. */
+export interface VersionFallbackInfo {
+    /** Version used for the failed primary dispatch attempt. */
+    from: Versionage;
+    /** Version selected for retry by compat policy. */
+    to: Versionage;
+    /** Parse domain where fallback occurred (`txt` qb64 or `bny` qb2). */
+    domain: AttachmentDispatchDomain;
+    /** Root parse failure message from the primary attempt. */
+    reason: string;
+}
+/**
+ * Policy decision for versioned attachment dispatch failure handling.
+ *
+ * `throw`:
+ * - preserve strict fail-fast behavior.
+ *
+ * `retry`:
+ * - perform one alternate-major retry and surface structured fallback info.
+ */
+export type VersionDispatchDecision = {
+    action: "throw";
+} | {
+    action: "retry";
+    retryVersion: Versionage;
+    info: VersionFallbackInfo;
+};
+/**
+ * Strategy interface for strict/compat dispatch fallback and wrapper recovery
+ * semantics.
+ */
+export interface AttachmentVersionFallbackPolicy {
+    /**
+     * Decide whether a versioned dispatch failure should rethrow or retry.
+     *
+     * Why this exists:
+     * keeps strict-vs-compat behavior out of parser control flow so policy can be
+     * injected and validated independently.
+     */
+    onVersionDispatchFailure(error: Error, version: Versionage, domain: AttachmentDispatchDomain): VersionDispatchDecision;
+    /**
+     * Observe accepted fallback decisions (callback/telemetry/warning hook).
+     *
+     * Why this exists:
+     * dispatch logic should not hardcode observability side effects.
+     */
+    onVersionFallback(info: VersionFallbackInfo): void;
+    /**
+     * Decide whether wrapper nested parse errors should preserve opaque remainder.
+     *
+     * Why this exists:
+     * strict mode must fail on malformed wrapper tails; compat mode intentionally
+     * keeps opaque remainder to preserve real-world stream tolerance.
+     */
+    shouldPreserveWrapperRemainder(error: Error): boolean;
+}
+/** Legacy strict/compat configuration inputs for policy construction. */
+export interface AttachmentVersionFallbackPolicyOptions {
+    /** Legacy strict/compat selector used only when no explicit policy is supplied. */
+    mode?: AttachmentDispatchMode;
+    /** Optional callback invoked when compat policy accepts a major-version retry. */
+    onVersionFallback?: (info: VersionFallbackInfo) => void;
+}
+/**
+ * Build default fallback strategy from legacy options.
+ *
+ * Why:
+ * preserves backward-compatible `mode` API while allowing explicit policy
+ * injection for new call sites.
+ */
+export declare function createAttachmentVersionFallbackPolicy(options?: AttachmentVersionFallbackPolicyOptions): AttachmentVersionFallbackPolicy;
+//# sourceMappingURL=attachment-fallback-policy.d.ts.map

package/types/src/parser/attachment-fallback-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-fallback-policy.d.ts","sourceRoot":"","sources":["../../../src/src/parser/attachment-fallback-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wEAAwE;AACxE,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;AACxE,uEAAuE;AACvE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,IAAI,EAAE,UAAU,CAAC;IACjB,mDAAmD;IACnD,EAAE,EAAE,UAAU,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,wBAAwB,CAAC;IACjC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IACA,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,UAAU,CAAC;IACzB,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEJ;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;;OAMG;IACH,wBAAwB,CACtB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,wBAAwB,GAC/B,uBAAuB,CAAC;IAC3B;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnD;;;;;;OAMG;IACH,8BAA8B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;CACvD;AAED,yEAAyE;AACzE,MAAM,WAAW,sCAAsC;IACrD,mFAAmF;IACnF,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACzD;AAiJD;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,sCAA2C,GACnD,+BAA+B,CAKjC"}

package/types/src/parser/group-dispatch.d.ts

@@ -1,29 +1,99 @@
-import type { AttachmentGroup, ColdCode } from "../core/types.js";
+import type { AttachmentGroup } from "../core/types.js";
 import type { Versionage } from "../tables/table-types.js";
-type ParseDomain = Extract<ColdCode, "txt" | "bny">;
-type AttachmentDispatchMode = "strict" | "compat";
-export interface VersionFallbackInfo {
-    from: Versionage;
-    to: Versionage;
-    domain: ParseDomain;
-    reason: string;
+import { type RecoveryDiagnosticObserver } from "../core/recovery-diagnostics.js";
+import { type AttachmentDispatchDomain, type AttachmentVersionFallbackPolicy, type AttachmentVersionFallbackPolicyOptions } from "./attachment-fallback-policy.js";
+export { createAttachmentVersionFallbackPolicy, } from "./attachment-fallback-policy.js";
+export type { AttachmentDispatchMode, AttachmentVersionFallbackPolicy, VersionDispatchDecision, VersionFallbackInfo, } from "./attachment-fallback-policy.js";
+/** Attachment parsing can only proceed in counter domains. */
+type ParseDomain = AttachmentDispatchDomain;
+/** Primitive token families used by tuple/repetition parsers. */
+type PrimitiveKind = "matter" | "indexer";
+/**
+ * Public options for attachment dispatch behavior and fallback observability.
+ *
+ * Precedence:
+ * 1) `versionFallbackPolicy` when provided (fully explicit strategy injection)
+ * 2) otherwise build default strategy from `mode` and adapt
+ *    `onVersionFallback` into structured diagnostics.
+ */
+export interface AttachmentDispatchOptions extends AttachmentVersionFallbackPolicyOptions {
+    /** Explicit strategy override for fallback + wrapper remainder decisions. */
+    versionFallbackPolicy?: AttachmentVersionFallbackPolicy;
+    /** Structured recovery diagnostics observer. */
+    onRecoveryDiagnostic?: RecoveryDiagnosticObserver;
 }
-export interface AttachmentDispatchOptions {
-    mode?: AttachmentDispatchMode;
-    onVersionFallback?: (info: VersionFallbackInfo) => void;
+/**
+ * Dispatch table major-version discriminator.
+ *
+ * Invariant:
+ * all dispatch artifacts in this module are built for exactly these two major
+ * versions; runtime fallback policy decides when/if cross-version retry occurs.
+ */
+type DispatchVersion = 1 | 2;
+/**
+ * Parser family keys used to map descriptor entries to concrete parser functions.
+ *
+ * Maintainer rule:
+ * adding a new parser family requires touching this union and
+ * `parserForDescriptor(...)` together so routing remains exhaustive.
+ */
+type DispatchParserKind = "genusVersion" | "quadlet" | "repeatTuple" | "transIdxSigGroups" | "transLastIdxSigGroups" | "sadPathSig" | "sadPathSigGroup";
+/**
+ * Semantic classification for descriptor entries.
+ *
+ * This metadata is intentionally domain-facing (review/debug/docs) and does not
+ * alter parser behavior by itself. Behavioral switches are driven only by
+ * `parserKind`, `tupleKinds`, `wrapperGroup`, and `allowsSigerList`.
+ */
+type DispatchSemanticShape = "genusVersionMarker" | "countedGroupPayload" | "wrapperGroupPayload" | "primitiveTuples" | "signatureGroupTuples" | "lastSignatureGroupTuples" | "sadPathSignatures" | "sadPathSignatureGroup";
+/**
+ * Authoring-time dispatch spec row.
+ *
+ * This form groups equivalent parser semantics across major versions to reduce
+ * duplicate declarations in the canonical spec constant.
+ */
+interface DispatchFamilySpec {
+    parserKind: DispatchParserKind;
+    semanticShape: DispatchSemanticShape;
+    codesByVersion: Partial<Record<DispatchVersion, readonly string[]>>;
+    tupleKinds?: readonly PrimitiveKind[];
+    wrapperGroup?: boolean;
+    allowsSigerList?: boolean;
 }
 /**
- * Parse with primary version, then retry with the alternate major on unknown
- * code/deserialize failures. This mirrors real-world mixed-stream tolerance.
+ * Canonical attachment dispatch specification (authoring form).
+ *
+ * This is the single source of truth for:
+ * - code -> parser routing
+ * - semantic shape classification
+ * - wrapper-group recursion eligibility
+ * - nested siger-list allowance
+ *
+ * Maintainer workflow:
+ * when adding/removing a counter route, edit this constant only, then rely on
+ * descriptor expansion + generated dispatch maps below.
+ */
+export declare const ATTACHMENT_DISPATCH_SPEC: readonly DispatchFamilySpec[];
+/**
+ * Parse one attachment group with policy-aware fallback behavior.
+ *
+ * By default this uses compat policy semantics to mirror historical
+ * `parseAttachmentDispatchCompat` behavior unless overridden via
+ * `options.versionFallbackPolicy`.
  */
 export declare function parseAttachmentDispatchCompat(input: Uint8Array, version: Versionage, domain: ParseDomain, options?: AttachmentDispatchOptions): {
     group: AttachmentGroup;
     consumed: number;
 };
-/** Strict versioned attachment-group dispatch (no major-version fallback). */
+/**
+ * Parse one attachment group with strict fail-fast semantics.
+ *
+ * Why:
+ * this API guarantees no major-version fallback and no wrapper opaque-tail
+ * preservation, matching parity/validation use cases.
+ */
 export declare function parseAttachmentDispatch(input: Uint8Array, version: Versionage, domain: ParseDomain): {
     group: AttachmentGroup;
     consumed: number;
 };
-export {};
 //# sourceMappingURL=group-dispatch.d.ts.map

package/types/src/parser/group-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group-dispatch.d.ts","sourceRoot":"","sources":["../../../src/src/parser/group-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AA2B3D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;AAEpD,KAAK,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACzD;AA6kBD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,yBAA8B,GACtC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAM9C;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAClB;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAI9C"}
+{"version":3,"file":"group-dispatch.d.ts","sourceRoot":"","sources":["../../../src/src/parser/group-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAe3D,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,sCAAsC,EAE5C,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qCAAqC,GACtC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAmBzC,8DAA8D;AAC9D,KAAK,WAAW,GAAG,wBAAwB,CAAC;AAC5C,iEAAiE;AACjE,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AA2B1C;;;;;;;GAOG;AACH,MAAM,WAAW,yBACf,SAAQ,sCAAsC;IAC9C,6EAA6E;IAC7E,qBAAqB,CAAC,EAAE,+BAA+B,CAAC;IACxD,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CACnD;AAuBD;;;;;;GAMG;AACH,KAAK,eAAe,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7B;;;;;;GAMG;AACH,KAAK,kBAAkB,GACnB,cAAc,GACd,SAAS,GACT,aAAa,GACb,mBAAmB,GACnB,uBAAuB,GACvB,YAAY,GACZ,iBAAiB,CAAC;AAEtB;;;;;;GAMG;AACH,KAAK,qBAAqB,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,iBAAiB,GACjB,sBAAsB,GACtB,0BAA0B,GAC1B,mBAAmB,GACnB,uBAAuB,CAAC;AAE5B;;;;;GAKG;AACH,UAAU,kBAAkB;IAC1B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,EAAE,qBAAqB,CAAC;IACrC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACpE,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAkBD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,kBAAkB,EA8NjE,CAAC;AA+qBF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,yBAA8B,GACtC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgB9C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAClB;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAM9C"}

package/types/src/primitives/aggor.d.ts

@@ -1,11 +1,11 @@
-import type { ColdCode } from "../core/types.js";
+import type { AttachmentItem, ColdCode } from "../core/types.js";
 import type { Versionage } from "../tables/table-types.js";
 import type { MapperField } from "./mapper.js";
 export interface Aggor {
     code: string;
     count: number;
     kind: "list" | "map";
-    listItems?: unknown[];
+    listItems?: AttachmentItem[];
     mapFields?: MapperField[];
     consumed: number;
 }

package/types/src/primitives/aggor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggor.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/aggor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,KAAK,CA2BP"}
+{"version":3,"file":"aggor.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/aggor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB/C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,KAAK,CA2BP"}

package/types/src/primitives/blinder.d.ts

@@ -1,10 +1,10 @@
-import type { ColdCode } from "../core/types.js";
+import type { AttachmentItem, ColdCode } from "../core/types.js";
 import type { Versionage } from "../tables/table-types.js";
 export interface Blinder {
     code: string;
     name: string;
     count: number;
-    items: unknown[];
+    items: AttachmentItem[];
     raw: Uint8Array;
     consumed: number;
 }

package/types/src/primitives/blinder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blinder.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/blinder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAW3D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,OAAO,CAeT"}
+{"version":3,"file":"blinder.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/blinder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAW3D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,OAAO,CAeT"}

package/types/src/primitives/counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/counter.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CAkDT;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CA2CT;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,OAAO,CAIT"}
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/counter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMjD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAgBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CAkDT;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CA2CT;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,OAAO,CAIT"}

package/types/src/primitives/mapper.d.ts

@@ -17,9 +17,52 @@ export interface Mapper {
     totalSizeB2: number;
     fields: MapperField[];
 }
+/** Label token artifact produced during map payload syntax parsing. */
+export interface MapperLabelTokenSyntax {
+    kind: "label";
+    code: string;
+    qb64: string;
+    label: string;
+    consumed: number;
+}
+/** Value token artifact produced during map payload syntax parsing. */
+export interface MapperValueTokenSyntax {
+    kind: "value";
+    code: string;
+    qb64: string;
+    isCounter: boolean;
+    consumed: number;
+    children?: MapperBodySyntax;
+}
+/** Ordered syntax token stream for one map payload. */
+export type MapperSyntaxEntry = MapperLabelTokenSyntax | MapperValueTokenSyntax;
+/** Syntax artifact for a parsed map-body/group token sequence. */
+export interface MapperBodySyntax {
+    /** Map/group counter code parsed at the payload head. */
+    code: string;
+    /** Counter count from map/group header. */
+    count: number;
+    /** Counter token size in qb64 bytes. */
+    fullSize: number;
+    /** Counter token size in qb2 bytes. */
+    fullSizeB2: number;
+    /** Total group span in qb64 bytes (header + payload). */
+    totalSize: number;
+    /** Total group span in qb2 bytes (header + payload). */
+    totalSizeB2: number;
+    /** Ordered token artifacts from payload tokenization. */
+    entries: MapperSyntaxEntry[];
+}
+/** Convert syntax entries into labeled semantic map fields. */
+export declare function interpretMapperBodySyntax(syntax: MapperBodySyntax): MapperField[];
+/**
+ * Parse map-style native bodies/counters into syntax artifacts.
+ * Parsing is strict: payload boundaries must be exact.
+ */
+export declare function parseMapperBodySyntax(input: Uint8Array, version: Versionage, domain: ParseDomain): MapperBodySyntax;
 /**
  * Parse map-style native bodies/counters into labeled semantic fields.
- * Parsing is strict: payload boundaries and label/value pairing must be exact.
+ * Compatibility wrapper over syntax parsing + semantic interpretation phases.
  */
 export declare function parseMapperBody(input: Uint8Array, version: Versionage, domain: ParseDomain): Mapper;
 /** True for counter codes that represent map/list-native aggregate primitives. */

package/types/src/primitives/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/mapper.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;AAgBpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAgJD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAClB,MAAM,CA6BR;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/mapper.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D,KAAK,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;AAgBpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,uDAAuD;AACvD,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEhF,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AA4JD,+DAA+D;AAC/D,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,GACvB,WAAW,EAAE,CA2Bf;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAClB,gBAAgB,CA+ClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAClB,MAAM,CA4BR;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/types/src/primitives/mediar.d.ts

@@ -1,10 +1,10 @@
-import type { ColdCode } from "../core/types.js";
+import type { AttachmentItem, ColdCode } from "../core/types.js";
 import type { Versionage } from "../tables/table-types.js";
 export interface Mediar {
     code: string;
     name: string;
     count: number;
-    items: unknown[];
+    items: AttachmentItem[];
     raw: Uint8Array;
     consumed: number;
 }

package/types/src/primitives/mediar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediar.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/mediar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAS3D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAeR"}
+{"version":3,"file":"mediar.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/mediar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAS3D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAeR"}

package/types/src/primitives/sealer.d.ts

@@ -1,10 +1,10 @@
-import type { ColdCode } from "../core/types.js";
+import type { AttachmentItem, ColdCode } from "../core/types.js";
 import type { Versionage } from "../tables/table-types.js";
 export interface Sealer {
     code: string;
     name: string;
     count: number;
-    items: unknown[];
+    items: AttachmentItem[];
     raw: Uint8Array;
     consumed: number;
 }

package/types/src/primitives/sealer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sealer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/sealer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAuB3D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAeR"}
+{"version":3,"file":"sealer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/sealer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAuB3D,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAeR"}

package/types/src/router/router-stub.d.ts

@@ -1,11 +1,11 @@
-import type { CesrFrame } from "../core/types.js";
+import type { CesrMessage } from "../core/types.js";
 export interface CesrRouter {
-    route(frame: CesrFrame): Promise<void>;
+    route(message: CesrMessage): Promise<void>;
 }
 export interface RouterHandlers {
-    onKeri?: (frame: CesrFrame) => Promise<void> | void;
-    onAcdc?: (frame: CesrFrame) => Promise<void> | void;
-    onUnknown?: (frame: CesrFrame) => Promise<void> | void;
+    onKeri?: (message: CesrMessage) => Promise<void> | void;
+    onAcdc?: (message: CesrMessage) => Promise<void> | void;
+    onUnknown?: (message: CesrMessage) => Promise<void> | void;
 }
 export declare function createRouterStub(handlers?: RouterHandlers): CesrRouter;
 //# sourceMappingURL=router-stub.d.ts.map

package/types/src/router/router-stub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-stub.d.ts","sourceRoot":"","sources":["../../../src/src/router/router-stub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,cAAmB,GAAG,UAAU,CAgB1E"}
+{"version":3,"file":"router-stub.d.ts","sourceRoot":"","sources":["../../../src/src/router/router-stub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,cAAmB,GAAG,UAAU,CAgB1E"}

package/types/src/serder/serder.d.ts

@@ -1,4 +1,4 @@
-import type { SerderEnvelope } from "../core/types.js";
+import type { CesrBody } from "../core/types.js";
 import type { Smellage } from "../core/types.js";
-export declare function parseSerder(raw: Uint8Array, smellage: Smellage): SerderEnvelope;
+export declare function parseSerder(raw: Uint8Array, smellage: Smellage): CesrBody;
 //# sourceMappingURL=serder.d.ts.map

package/types/src/serder/serder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serder.d.ts","sourceRoot":"","sources":["../../../src/src/serder/serder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAuBhB"}
+{"version":3,"file":"serder.d.ts","sourceRoot":"","sources":["../../../src/src/serder/serder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA4BjD,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CA0CV"}

package/types/src/serder/serdery.d.ts

@@ -1,6 +1,6 @@
-import type { SerderEnvelope } from "../core/types.js";
+import type { CesrBody } from "../core/types.js";
 export declare function reapSerder(input: Uint8Array): {
-    serder: SerderEnvelope;
+    serder: CesrBody;
     consumed: number;
 };
 //# sourceMappingURL=serdery.d.ts.map

package/types/src/serder/serdery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serdery.d.ts","sourceRoot":"","sources":["../../../src/src/serder/serdery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,GAChB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQ9C"}
+{"version":3,"file":"serdery.d.ts","sourceRoot":"","sources":["../../../src/src/serder/serdery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,GAChB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQxC"}