cesr-ts 0.4.0 → 0.6.0

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

@@ -23,7 +23,8 @@ interface MatterData {
  * Base CESR primitive carrying qualified matter material.
  *
  * KERIpy substance: `Matter` is the foundational primitive abstraction that
- * handles exfil/infil between raw bytes and qualified CESR encodings.
+ * handles exfil/infil between raw bytes and qualified CESR encodings and owns
+ * the base derivation-code semantic projections shared by semantic subclasses.
  */
 export declare class Matter {
     protected readonly _code: string;
@@ -34,16 +35,47 @@ export declare class Matter {
     constructor(init: Matter | MatterData | MatterInit);
     protected toMatterData(): MatterData;
     get code(): string;
+    /** KERIpy parity alias: codex member name for this derivation code. */
+    get name(): string;
+    /** KERIpy parity alias: hard code portion of the qualified text code. */
+    get hard(): string;
+    /** Soft code portion exclusive of any prepad xtra characters. */
+    get soft(): string;
+    /**
+     * KERIpy parity size projection.
+     *
+     * This follows KERIpy's generic `Matter.size` rule: decode the soft sextets
+     * when present, otherwise return `null`.
+     */
+    get size(): number | null;
+    /** Hard + padded-soft view of the full text code. */
+    get both(): string;
     get raw(): Uint8Array;
     get qb64(): string;
     get qb64b(): Uint8Array;
     get qb2(): Uint8Array;
     get fullSize(): number;
     get fullSizeB2(): number;
+    /** Generic KERIpy derivation-code transferability rule. */
+    get transferable(): boolean;
+    /** Generic KERIpy digest-family semantic projection. */
+    get digestive(): boolean;
+    /** Generic KERIpy identifier-prefix semantic projection. */
+    get prefixive(): boolean;
+    /** True when the code family carries fixed-size soft text metadata. */
+    get special(): boolean;
+    /** True when both qb64 and qb2 are 24-bit aligned and round-trip exactly. */
+    get composable(): boolean;
     equals(other: {
         qb64: string;
     }): boolean;
     toString(): string;
+    /** KERIpy parity helper: fixed raw size for one code. */
+    static rawSizeForCode(code: string): number;
+    /** KERIpy parity helper: fixed full qb64 size for one code. */
+    static fullSizeForCode(code: string): number;
+    /** KERIpy parity helper: lead-byte size for one code. */
+    static leadSizeForCode(code: string): number;
 }
 /** Parse matter from text-domain CESR bytes. */
 export declare function parseMatterFromText(input: Uint8Array): Matter;

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

@@ -1 +1 @@
-{"version":3,"file":"matter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/matter.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAuMD;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAE3B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU;IAclD,SAAS,CAAC,YAAY,IAAI,UAAU;IAUpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAIxC,QAAQ,IAAI,MAAM;CAGnB;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE7D;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAIR"}
+{"version":3,"file":"matter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/matter.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAuRD;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAE3B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU;IAclD,SAAS,CAAC,YAAY,IAAI,UAAU;IAUpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uEAAuE;IACvE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yEAAyE;IACzE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,iEAAiE;IACjE,IAAI,IAAI,IAAI,MAAM,CAMjB;IAED;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IAED,qDAAqD;IACrD,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,2DAA2D;IAC3D,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,wDAAwD;IACxD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4DAA4D;IAC5D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,uEAAuE;IACvE,IAAI,OAAO,IAAI,OAAO,CAGrB;IAED,6EAA6E;IAC7E,IAAI,UAAU,IAAI,OAAO,CAMxB;IAED,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAIxC,QAAQ,IAAI,MAAM;IAIlB,yDAAyD;IACzD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3C,+DAA+D;IAC/D,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ5C,yDAAyD;IACzD,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG7C;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE7D;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAIR"}

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

@@ -9,6 +9,12 @@ export declare function isMediarCode(code: string): boolean;
  *
  * KERIpy substance: `Mediar` materializes media metadata/value tuple groups
  * used in blinded media attachments and related CESR payload envelopes.
+ *
+ * Maintainer note:
+ * - this class owns counted-group transport framing only
+ * - semantic disclosure helpers live in `disclosure.ts`
+ * - the semantic fixed-field record carried by these groups is `TypeMedia`
+ *   from `structing.ts`
  */
 export declare class Mediar extends Structor {
     constructor(init: Structor | ConstructorParameters<typeof Structor>[0]);

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;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAiB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,QAAQ;gBACtB,IAAI,EAAE,QAAQ,GAAG,qBAAqB,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAUtE,oEAAoE;WACpD,SAAS,CACvB,KAAK,EAAE,gBAAgB,EACvB,YAAY,GAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAS,GACrD,MAAM;CAGV;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAIR"}
+{"version":3,"file":"mediar.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/mediar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAiB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,MAAO,SAAQ,QAAQ;gBACtB,IAAI,EAAE,QAAQ,GAAG,qBAAqB,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAUtE,oEAAoE;WACpD,SAAS,CACvB,KAAK,EAAE,gBAAgB,EACvB,YAAY,GAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAS,GACrD,MAAM;CAGV;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAIR"}

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

@@ -1 +1 @@
-{"version":3,"file":"noncer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/noncer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,KAAK;gBACnB,IAAI,EAAE,MAAM,GAAG,UAAU;IAQrC;;;;;OAKG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,+EAA+E;IAC/E,IAAI,MAAM,IAAI,UAAU,CAEvB;CACF;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}
+{"version":3,"file":"noncer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/noncer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,KAAK;gBACnB,IAAI,EAAE,MAAM,GAAG,UAAU;IAOrC;;;;;OAKG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,+EAA+E;IAC/E,IAAI,MAAM,IAAI,UAAU,CAEvB;CACF;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}

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

@@ -1 +1 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/number.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,MAAM;gBAC7B,IAAI,EAAE,MAAM,GAAG,UAAU;IAQrC,IAAI,GAAG,IAAI,MAAM,CAMhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,eAAe,CAEjB"}
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/number.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,MAAM;gBAC7B,IAAI,EAAE,MAAM,GAAG,UAAU;IAOrC,IAAI,GAAG,IAAI,MAAM,CAMhB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,eAAe,CAEjB"}

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

@@ -1,5 +1,26 @@
 import type { ColdCode } from "../core/types.js";
 import { Matter, type MatterInit } from "./matter.js";
+/**
+ * Build a Pather from semantic route/path text.
+ *
+ * This mirrors the KERIpy `Pather(path=..., relative=..., pathive=...)`
+ * constructor path:
+ * - "pathive" base64-safe segments use compact StrB64 encoding with `-`
+ *   separators
+ * - non-pathive routes fall back to byte/text encoding when they contain
+ *   characters like `/`
+ * - relative routes keep the first segment as-is, while absolute paths are
+ *   forced to start with an empty root segment
+ *
+ * Examples:
+ * - `makePather("ksn", { relative: true, pathive: false }).qb64 === "4AABAksn"`
+ * - `makePather("reply", { relative: true, pathive: false }).qb64 === "6AACAAAreply"`
+ * - `makePather("credential/issue", { relative: true, pathive: false }).qb64 === "4AAEcredential-issue"`
+ */
+export declare function makePather(path: string | readonly string[], opts?: {
+    relative?: boolean;
+    pathive?: boolean;
+}): Pather;
 /**
  * CESR path primitive for SAD traversal routes.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"pather.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/pather.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAMnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IAUrC,iFAAiF;IACjF,IAAI,IAAI,IAAI,MAAM,CAMjB;CACF;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}
+{"version":3,"file":"pather.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/pather.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAiDnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,MAAM,CAiDR;AAED;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IASrC,iFAAiF;IACjF,IAAI,IAAI,IAAI,MAAM,CAMjB;CACF;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}

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

@@ -1 +1 @@
-{"version":3,"file":"prefixer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/prefixer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,MAAM;gBACtB,IAAI,EAAE,MAAM,GAAG,UAAU;IAQrC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,QAAQ,CAEV"}
+{"version":3,"file":"prefixer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/prefixer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,MAAM;gBACtB,IAAI,EAAE,MAAM,GAAG,UAAU;IAOrC,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,QAAQ,CAEV"}

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

@@ -1,6 +1,7 @@
 import type { Counter } from "./counter.js";
 import type { Indexer } from "./indexer.js";
 import type { Matter } from "./matter.js";
+import type { Streamer } from "./streamer.js";
 import type { UnknownPrimitive } from "./unknown.js";
 /**
  * Structural contract used by parser outputs for counted group payloads.
@@ -14,6 +15,23 @@ export interface CounterGroupLike extends Counter {
 }
 /** Any first-class hydrated CESR primitive returned by parser hydration. */
 export type Primitive = Matter | Indexer | Counter | UnknownPrimitive;
+/**
+ * Rehydratable qualified primitive from one parsed recursive group graph.
+ *
+ * These entries are safe to pass through `new X({ qb64b: entry.qb64b })` style
+ * reconstruction because they are real qualified CESR primitives, not tuple
+ * payloads, nested counted groups, or lossless unknown placeholders.
+ */
+export type QualifiedPrimitive = Matter | Indexer | Counter;
+/**
+ * Primitive family that cipher encryption/decryption can faithfully round-trip.
+ *
+ * This intentionally excludes `UnknownPrimitive`: sealed-box decrypt returns a
+ * fully hydrated constructor-backed value, not a parser fallback placeholder.
+ */
+export type CipherHydratable = QualifiedPrimitive | Streamer;
+/** Constructor contract for cipher plaintext rehydration. */
+export type CipherHydratableCtor<T extends CipherHydratable = CipherHydratable> = new (...args: any[]) => T;
 /** Ordered tuple payload used by grouped attachments (for fixed small tuples). */
 export type PrimitiveTuple = readonly GroupEntry[];
 /** Recursive parser graph entry for attachment/native payloads. */
@@ -22,4 +40,12 @@ export type GroupEntry = Primitive | PrimitiveTuple | CounterGroupLike;
 export declare function isPrimitiveTuple(entry: GroupEntry): entry is PrimitiveTuple;
 /** Runtime guard for parsed counter-group nodes in recursive payload graphs. */
 export declare function isCounterGroupLike(entry: GroupEntry): entry is CounterGroupLike;
+/**
+ * Runtime guard for one rehydratable qualified primitive in a parsed group graph.
+ *
+ * This intentionally means "real CESR primitive with `qb64b`" rather than
+ * "any parser primitive union member", so tuples, nested counter groups, and
+ * `UnknownPrimitive` placeholders are all excluded.
+ */
+export declare function isQualifiedPrimitive(entry: unknown): entry is QualifiedPrimitive;
 //# sourceMappingURL=primitive.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,gBAAgB,CAAC;AACtE,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,SAAS,UAAU,EAAE,CAAC;AACnD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEvE,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,cAAc,CAE3E;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,GAChB,KAAK,IAAI,gBAAgB,CAG3B"}
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,gBAAgB,CAAC;AACtE;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAC5D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAC7D,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,CAC9B,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAC3C,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC7B,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,SAAS,UAAU,EAAE,CAAC;AACnD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEvE,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,cAAc,CAE3E;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,GAChB,KAAK,IAAI,gBAAgB,CAG3B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAM7B"}

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

@@ -1,3 +1,4 @@
+/** Lossless summary of one primitive token parsed from text-domain CESR. */
 export interface PrimitiveToken {
     code: string;
     name: string;
@@ -5,6 +6,8 @@ export interface PrimitiveToken {
     raw: Uint8Array;
     fullSize: number;
 }
+/** Parse one text-domain primitive token and include its generated code name. */
 export declare function parsePrimitiveFromText(input: Uint8Array): PrimitiveToken;
+/** Return all known generated matter codes sorted for deterministic scans. */
 export declare function supportedPrimitiveCodes(): string[];
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/registry.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAWxE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/registry.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAWxE;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD"}

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

@@ -1,5 +1,22 @@
 import type { ColdCode } from "../core/types.js";
+import type { Kind } from "../tables/versions.js";
 import { Matter, type MatterInit } from "./matter.js";
+/** Digest callback seam used by SAID derivation helpers. */
+export type SaidDigestFn = (ser: Uint8Array, code: string) => Uint8Array;
+/** Options for deriving one top-level saidive field from a SAD. */
+export interface SaidifyOptions {
+    code?: string;
+    kind?: Kind;
+    label?: string;
+    ignore?: string[];
+    digest?: SaidDigestFn;
+}
+/** Options for computing multiple saidive fields from one sized SAD. */
+export interface SaidifyFieldsOptions {
+    kind?: Kind;
+    saids: Record<string, string>;
+    digest?: SaidDigestFn;
+}
 /**
  * Self-addressing identifier digest primitive.
  *
@@ -10,6 +27,30 @@ export declare class Saider extends Matter {
     constructor(init: Matter | MatterInit);
     get said(): string;
     get digest(): Uint8Array;
+    /**
+     * Derive one SAID from a SAD, inject it at `label`, and return the updated SAD.
+     *
+     * KERIpy places `saidify` on `Saider`, not `Serder`: the responsibility here
+     * is digest derivation for one saidive field, while event-specific policies
+     * such as mirrored `i == d` handling belong in higher layers.
+     */
+    static saidify(sad: Record<string, unknown>, { code, kind, label, ignore, digest, }: SaidifyOptions): {
+        saider: Saider;
+        sad: Record<string, unknown>;
+    };
+    /**
+     * Compute all digestive saidive fields from the same sized-dummied SAD bytes.
+     *
+     * This mirrors the KERIpy `makify/_compute` model for top-level saidive
+     * fields: resolve effective field codes first, dummy only digestive fields,
+     * size the version string once, hash once, then fill all digestive fields
+     * from that same raw serialization.
+     */
+    static saidifyFields(sad: Record<string, unknown>, { kind, saids, digest, }: SaidifyFieldsOptions): {
+        sad: Record<string, unknown>;
+        raw: Uint8Array;
+        saiders: Record<string, Saider>;
+    };
 }
 /** Parse and hydrate `Saider` from txt/qb2 bytes. */
 export declare function parseSaider(input: Uint8Array, cold: Extract<ColdCode, "txt" | "bny">): Saider;

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

@@ -1 +1 @@
-{"version":3,"file":"saider.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/saider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IAUrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,UAAU,CAEvB;CACF;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}
+{"version":3,"file":"saider.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/saider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;AAEzE,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IASrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,EACE,IAAU,EACV,IAAI,EACJ,KAAW,EACX,MAAM,EACN,MAAqB,GACtB,EAAE,cAAc,GAChB;QACD,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9B;IAmBD;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,EACE,IAAI,EACJ,KAAK,EACL,MAAqB,GACtB,EAAE,oBAAoB,GACtB;QACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,GAAG,EAAE,UAAU,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC;CAyCF;AASD,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}

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

@@ -1,13 +1,68 @@
+import { type Tier } from "../core/vocabulary.js";
 import { Matter, type MatterInit } from "./matter.js";
+import { Signer } from "./signer.js";
+export interface SalterInit extends MatterInit {
+    tier?: Tier;
+}
+export interface SalterStretchOptions {
+    size?: number;
+    path?: string;
+    tier?: Tier;
+    temp?: boolean;
+}
+export interface SalterSignerOptions {
+    code?: string;
+    transferable?: boolean;
+    path?: string;
+    tier?: Tier;
+    temp?: boolean;
+}
+export interface SalterSignersOptions extends SalterSignerOptions {
+    count?: number;
+    start?: number;
+    codes?: string[];
+}
 /**
  * Salt primitive for deterministic secret/signer derivation workflows.
  *
  * KERIpy substance: Salter stores random or fixed salt bytes and is used as
  * input to deterministic signer/seed generation paths.
+ *
+ * Maintainer model:
+ * - `tier` is the default stretch policy carried with the salt instance
+ * - individual `stretch()` / `signer()` calls may still override it
  */
 export declare class Salter extends Matter {
-    constructor(init: Matter | MatterInit);
+    readonly tier: Tier;
+    constructor(init: Matter | SalterInit);
     /** Raw salt bytes used by key-derivation consumers. */
     get salt(): Uint8Array;
+    /**
+     * Derive deterministic secret bytes from this salt and one derivation path.
+     *
+     * KERIpy correspondence:
+     * - mirrors `Salter.stretch(...)` using Argon2id and tier/temp policy
+     *
+     * Path rule:
+     * - callers supply the fully formed KERI salty path string
+     * - `Salter` does not impose `pidx/ridx/kidx` structure itself; that remains
+     *   a higher-layer manager/creator responsibility
+     */
+    stretch({ size, path, tier, temp, }?: SalterStretchOptions): Uint8Array;
+    /**
+     * Derive one deterministic executable signer from this salt and one path.
+     *
+     * The signer suite controls seed width; `Salter` only owns the deterministic
+     * seed derivation.
+     */
+    signer({ code, transferable, path, tier, temp, }?: SalterSignerOptions): Signer;
+    /**
+     * Derive an ordered signer list from one path prefix plus hex suffix range.
+     *
+     * KERIpy correspondence:
+     * - successive signers append lowercase-hex offsets to the supplied path
+     *   prefix
+     */
+    signers({ count, start, path, code, codes, transferable, tier, temp, }?: SalterSignersOptions): Signer[];
 }
 //# sourceMappingURL=salter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"salter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/salter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IAQrC,uDAAuD;IACvD,IAAI,IAAI,IAAI,UAAU,CAErB;CACF"}
+{"version":3,"file":"salter.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/salter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,IAAI,EAAS,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD;;;;;;;;;GASG;AACH,qBAAa,MAAO,SAAQ,MAAM;IAChC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAER,IAAI,EAAE,MAAM,GAAG,UAAU;IAUrC,uDAAuD;IACvD,IAAI,IAAI,IAAI,UAAU,CAErB;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EACN,IAAS,EACT,IAAS,EACT,IAAgB,EAChB,IAAY,GACb,GAAE,oBAAyB,GAAG,UAAU;IAWzC;;;;;OAKG;IACH,MAAM,CAAC,EACL,IAA0B,EAC1B,YAAmB,EACnB,IAAS,EACT,IAAI,EACJ,IAAY,GACb,GAAE,mBAAwB,GAAG,MAAM;IAapC;;;;;;OAMG;IACH,OAAO,CAAC,EACN,KAAS,EACT,KAAS,EACT,IAAS,EACT,IAA0B,EAC1B,KAAK,EACL,YAAmB,EACnB,IAAI,EACJ,IAAY,GACb,GAAE,oBAAyB,GAAG,MAAM,EAAE;CAYxC"}

package/types/src/primitives/sealed-box.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Internal libsodium-backed sealed-box seam for KERIpy cipher parity.
+ *
+ * Boundary rule:
+ * - CESR primitives own sealed-box behavior
+ * - higher layers consume `Cipher`/`Encrypter`/`Decrypter`, not sodium calls
+ * - this module returns only raw key/plaintext/cipher bytes; derivation codes
+ *   and primitive hydration stay outside at the CESR primitive layer
+ */
+/** Derive X25519 public key material from one Ed25519 verifier key. */
+export declare function boxPublicKeyFromEd25519Verfer(verferRaw: Uint8Array): Uint8Array;
+/**
+ * Derive the X25519 box keypair corresponding to one Ed25519 signing seed.
+ *
+ * KERIpy parity:
+ * - derive the Ed25519 signing keypair first
+ * - then convert both sides to the associated X25519 box keys
+ */
+export declare function boxKeyPairFromEd25519Seed(seedRaw: Uint8Array): {
+    publicKey: Uint8Array;
+    privateKey: Uint8Array;
+};
+/** Recover the X25519 public key corresponding to one raw X25519 private key. */
+export declare function boxPublicKeyFromPrivateKey(privateKey: Uint8Array): Uint8Array;
+/** Encrypt one plaintext using libsodium's X25519 sealed-box primitive. */
+export declare function sealBox(plaintext: Uint8Array, publicKey: Uint8Array): Uint8Array;
+/** Open one libsodium X25519 sealed-box ciphertext back to raw plaintext bytes. */
+export declare function openSealedBox(cipher: Uint8Array, publicKey: Uint8Array, privateKey: Uint8Array): Uint8Array;
+//# sourceMappingURL=sealed-box.d.ts.map

package/types/src/primitives/sealed-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sealed-box.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/sealed-box.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,uEAAuE;AACvE,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,UAAU,GACpB,UAAU,CAIZ;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG;IAC9D,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;CACxB,CAUA;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAE7E;AAED,2EAA2E;AAC3E,wBAAgB,OAAO,CACrB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,UAAU,GACpB,UAAU,CAEZ;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,UAAU,EACrB,UAAU,EAAE,UAAU,GACrB,UAAU,CAIZ"}

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

@@ -1 +1 @@
-{"version":3,"file":"seqner.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/seqner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IAUrC,IAAI,EAAE,IAAI,MAAM,CAMf;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}
+{"version":3,"file":"seqner.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/seqner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAe,MAAM,aAAa,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IASrC,IAAI,EAAE,IAAI,MAAM,CAMf;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;CACF;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,MAAM,CAER"}

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

@@ -1,6 +1,14 @@
 import type { ColdCode } from "../core/types.js";
+import { Cigar } from "./cigar.js";
 import { Indexer, type IndexerInit } from "./indexer.js";
 import type { Verfer } from "./verfer.js";
+/** Rebuild options for turning detached signature material into indexed signature material. */
+export interface SigerFromCigarOptions {
+    index: number;
+    ondex?: number | null;
+    only?: boolean;
+    verfer?: Verfer;
+}
 /**
  * Indexed signature primitive with optional verifier association.
  *
@@ -10,6 +18,12 @@ import type { Verfer } from "./verfer.js";
 export declare class Siger extends Indexer {
     readonly verfer?: Verfer;
     constructor(init: Indexer | IndexerInit, verfer?: Verfer);
+    /** Rebuild indexed signature material from detached signature bytes plus verifier context. */
+    static fromCigar(cigar: Cigar, { index, ondex, only, verfer }: SigerFromCigarOptions): Siger;
+    /** Resolve the indexed-signature family implied by one verifier suite. */
+    private static indexedSignatureFamilyForVerfer;
+    /** Resolve the indexed-signature code emitted for one verifier suite and signature shape. */
+    private static indexedSignatureCodeForVerfer;
 }
 /** Parse and hydrate `Siger` from txt or qb2 encoded bytes. */
 export declare function parseSiger(input: Uint8Array, cold: Extract<ColdCode, "txt" | "bny">): Siger;

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

@@ -1 +1 @@
-{"version":3,"file":"siger.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/siger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,OAAO;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM;CAUzD;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,KAAK,CAEP"}
+{"version":3,"file":"siger.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/siger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAS1C,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,OAAO;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM;IAUxD,8FAA8F;IAC9F,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,KAAK,EACZ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,MAAqB,EAAE,EAAE,qBAAqB,GAC3E,KAAK;IA0BR,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,+BAA+B;IAmC9C,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,6BAA6B;CAmB7C;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,GACrC,KAAK,CAEP"}

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

@@ -1,14 +1,90 @@
+import { Cigar } from "./cigar.js";
 import { Matter, type MatterInit } from "./matter.js";
+import { Siger } from "./siger.js";
+import { Verfer } from "./verfer.js";
+/** Construction options for one executable signer seed. */
+export interface SignerInit extends MatterInit {
+    transferable?: boolean;
+}
+/** Explicit factory options for `Signer.random(...)`. */
+export interface SignerRandomOptions {
+    code?: string;
+    transferable?: boolean;
+}
+/** Signature-shape options for `Signer.sign(...)`. */
+export interface SignerSignOptions {
+    index?: number;
+    only?: boolean;
+    ondex?: number | null;
+}
 /**
  * Signing-seed primitive.
  *
- * KERIpy substance: Signer wraps private seed material that is used to derive
- * signing key pairs and associated verifier material; this TS layer constrains
- * codex validity while higher crypto layers perform key derivation/signing.
+ * KERIpy substance: Signer wraps private seed material, derives the associated
+ * verifier, and owns suite-driven signature creation.
+ *
+ * TypeScript difference:
+ * - seed derivation codes do not themselves encode transferability, so
+ *   `Signer` carries an explicit transferability choice rather than inheriting
+ *   `Matter.transferable`
  */
 export declare class Signer extends Matter {
-    constructor(init: Matter | MatterInit);
+    private readonly _transferable;
+    private readonly _signRaw;
+    /** Public verifier derived from this seed and the explicit transferability choice. */
+    readonly verfer: Verfer;
+    constructor(init: Matter | SignerInit);
+    /**
+     * Explicit signer transferability override.
+     *
+     * Seed codes do not encode transferability, so `Signer` intentionally does
+     * not inherit the generic `Matter.transferable` rule.
+     */
+    get transferable(): boolean;
     /** Raw seed bytes for signer key-derivation/instantiation. */
     get seed(): Uint8Array;
+    /** Return the raw seed size implied by one signer-suite code. */
+    static seedSizeForCode(code: string): number;
+    /**
+     * Project one verifier code back to the signer seed code for the same suite.
+     *
+     * Keeper-style derivation flows use this without reopening a free helper seam.
+     */
+    static seedCodeForVerferCode(verferCode: string): string;
+    /** Create one explicit random signer seed for creator-style flows. */
+    static random({ code, transferable }?: SignerRandomOptions): Signer;
+    private static assertSupportedSeedCode;
+    private static assertSupportedVerferCode;
+    /** Resolve the verifier code implied by one signer seed code and transferability choice. */
+    private static verferCodeForSeedCode;
+    /** Derive one raw public verification key from signer seed bytes and suite code. */
+    private static publicKeyForSeedCode;
+    /** Bind one KERIpy-style signer suite at construction time. */
+    private static bindSuite;
+    /** Resolve the detached-signature code emitted by this signer suite. */
+    private detachedSignatureCode;
+    /** Resolve the indexed-signature family emitted by this signer suite. */
+    private indexedSignatureFamily;
+    /**
+     * Resolve the indexed-signature code emitted by this signer and signature shape.
+     *
+     * KERIpy correspondence:
+     * - `only=true` selects the current-list-only family
+     * - otherwise `ondex` defaults to `index`
+     * - the small `both` family is valid only when `index === ondex <= 63`
+     */
+    private indexedSignatureCode;
+    /**
+     * Sign one message and return either a detached `Cigar` or indexed `Siger`.
+     *
+     * KERIpy correspondence:
+     * - `index === undefined` returns a detached non-indexed signature
+     * - otherwise the seed suite decides the emitted indexed signature code family
+     * - `only=true` selects the current-list-only family and ignores any caller
+     *   `ondex` override
+     * - otherwise `ondex` defaults to `index`, preserving KERIpy's implicit
+     *   same-index rule for ordinary indexed signatures
+     */
+    sign(ser: Uint8Array, { index, only, ondex }?: SignerSignOptions): Cigar | Siger;
 }
 //# sourceMappingURL=signer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/signer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,MAAO,SAAQ,MAAM;gBACpB,IAAI,EAAE,MAAM,GAAG,UAAU;IAUrC,8DAA8D;IAC9D,IAAI,IAAI,IAAI,UAAU,CAErB;CACF"}
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/signer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,2DAA2D;AAC3D,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAsCD;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,MAAM;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,MAAM,GAAG,UAAU;IASrC;;;;;OAKG;IACH,IAAa,YAAY,IAAI,OAAO,CAEnC;IAED,8DAA8D;IAC9D,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,iEAAiE;IACjE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK5C;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAgBxD,sEAAsE;IACtE,MAAM,CAAC,MAAM,CACX,EAAE,IAA0B,EAAE,YAAmB,EAAE,GAAE,mBAAwB,GAC5E,MAAM;IAOT,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAQtC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAexC,4FAA4F;IAC5F,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAcpC,oFAAoF;IACpF,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAcnC,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAC,SAAS;IAuCxB,wEAAwE;IACxE,OAAO,CAAC,qBAAqB;IAa7B,yEAAyE;IACzE,OAAO,CAAC,sBAAsB;IA4B9B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;;;;;;;;OAUG;IACH,IAAI,CACF,GAAG,EAAE,UAAU,EACf,EAAE,KAAK,EAAE,IAAY,EAAE,KAAK,EAAE,GAAE,iBAAsB,GACrD,KAAK,GAAG,KAAK;CAoBjB"}

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

@@ -0,0 +1,31 @@
+import { type ByteLike } from "./byte-like.js";
+/**
+ * Constructor surface for one sniffable CESR stream holder.
+ *
+ * `verify` is retained for KERIpy vocabulary parity, but the current
+ * TypeScript port does not yet implement stream sniffability verification on
+ * construction.
+ */
+export interface StreamerInit {
+    stream: ByteLike;
+    verify?: boolean;
+}
+/**
+ * Sniffable CESR stream holder.
+ *
+ * KERIpy substance: `Streamer` is the minimal primitive used when encryption
+ * and decryption round-trip whole CESR streams instead of one qualified matter
+ * instance.
+ *
+ * Current `keri-ts` scope:
+ * - owns raw stream bytes only
+ * - does not yet port KERIpy's `text` / `binary` / `texter` / `bexter`
+ *   projection helpers or sniffability verification behavior
+ */
+export declare class Streamer {
+    protected readonly _stream: Uint8Array;
+    constructor({ stream }: StreamerInit);
+    /** Raw sniffable CESR stream bytes. */
+    get stream(): Uint8Array;
+}
+//# sourceMappingURL=streamer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streamer.d.ts","sourceRoot":"","sources":["../../../src/src/primitives/streamer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,gBAAgB,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IACnB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;gBAE3B,EAAE,MAAM,EAAE,EAAE,YAAY;IAIpC,uCAAuC;IACvC,IAAI,MAAM,IAAI,UAAU,CAEvB;CACF"}