cesr-ts 0.8.0 → 0.9.0

package/esm/src/primitives/counter.js

@@ -1,5 +1,6 @@
-import { b, b64ToInt, codeB2ToB64, codeB64ToB2, intToB64, nabSextets, sceil } from "../core/bytes.js";
+import { b, b64ToInt, codeB2ToB64, codeB64ToB2, concatBytes, intToB64, nabSextets, sceil } from "../core/bytes.js";
 import { DeserializeError, ShortageError, UnknownCodeError } from "../core/errors.js";
+import { CtrDexV2 } from "../tables/counter-codex.js";
 import { resolveCounterCodeNameTable, resolveCounterSizeTable } from "../tables/counter-version-registry.js";
 import { COUNTER_HARDS } from "../tables/counter.tables.generated.js";
 const COUNTER_BARDS = new Map([...COUNTER_HARDS.entries()].map(([code, hs]) => [
@@ -126,6 +127,38 @@ function encodeCounterFromFields(code, count, version) {
         version,
     };
 }
+function semanticNameForCode(code, version) {
+    const nameTable = resolveCounterCodeNameTable(version);
+    return nameTable[code] ?? null;
+}
+function codeForSemanticName(name, version) {
+    const nameTable = resolveCounterCodeNameTable(version);
+    for (const [code, candidate] of Object.entries(nameTable)) {
+        if (candidate === name) {
+            return code;
+        }
+    }
+    return null;
+}
+function promoteCounterCodeForCount(code, count, version) {
+    const sizeTable = resolveCounterSizeTable(version);
+    const sizage = sizeTable.get(code);
+    if (!sizage) {
+        throw new UnknownCodeError(`Unsupported counter code for version: ${code}`);
+    }
+    if (count <= (64 ** sizage.ss) - 1) {
+        return code;
+    }
+    const name = semanticNameForCode(code, version);
+    if (!name || name.startsWith("Big")) {
+        throw new DeserializeError(`Invalid count=${count} for code=${code}`);
+    }
+    const bigCode = codeForSemanticName(`Big${name}`, version);
+    if (!bigCode) {
+        throw new DeserializeError(`Counter code=${code} has no Big${name} form.`);
+    }
+    return bigCode;
+}
 /** Normalize the supported constructor variants into one shared counter payload. */
 function parseCounterInit(init) {
     const version = init.version ?? { major: 2, minor: 0 };
@@ -152,6 +185,34 @@ function parseCounterInit(init) {
  * payload groups and carry versioned code-name semantics.
  */
 export class Counter {
+    static makeGVC(version) {
+        return new Counter({
+            code: CtrDexV2.KERIACDCGenusVersion,
+            countB64: `${intToB64(version.major, 1)}${intToB64(version.minor, 2)}`,
+            version,
+        }).qb64b;
+    }
+    static enclose({ qb64 = undefined, qb2 = undefined, code = "AttachmentGroup", version = { major: 2, minor: 0 }, } = {}) {
+        const actualQb64 = typeof qb64 === "string" ? b(qb64) : qb64;
+        if (actualQb64 !== undefined && actualQb64 !== null) {
+            if (actualQb64.length % 4 !== 0) {
+                throw new DeserializeError(`Bad enclosed qb64 length=${actualQb64.length}`);
+            }
+            const count = actualQb64.length / 4;
+            const counterCode = promoteCounterCodeForCount(codeForSemanticName(code, version) ?? code, count, version);
+            return concatBytes(new Counter({ code: counterCode, count, version }).qb64b, actualQb64);
+        }
+        if (qb2 !== undefined && qb2 !== null) {
+            if (qb2.length % 3 !== 0) {
+                throw new DeserializeError(`Bad enclosed qb2 length=${qb2.length}`);
+            }
+            const count = qb2.length / 3;
+            const counterCode = promoteCounterCodeForCount(codeForSemanticName(code, version) ?? code, count, version);
+            return concatBytes(new Counter({ code: counterCode, count, version }).qb2, qb2);
+        }
+        const counterCode = promoteCounterCodeForCount(codeForSemanticName(code, version) ?? code, 0, version);
+        return new Counter({ code: counterCode, count: 0, version }).qb64b;
+    }
     constructor(init) {
         Object.defineProperty(this, "_code", {
             enumerable: true,
@@ -195,11 +256,7 @@ export class Counter {
             writable: true,
             value: void 0
         });
-        const data = init instanceof Counter
-            ? init.toCounterData()
-            : isCounterData(init)
-                ? init
-                : parseCounterInit(init);
+        const data = init instanceof Counter ? init.toCounterData() : isCounterData(init) ? init : parseCounterInit(init);
         this._code = data.code;
         this._count = data.count;
         this._fullSize = data.fullSize;
@@ -287,7 +344,5 @@ export function parseCounterFromBinary(input, version) {
 }
 /** Parse counter using domain hint (`txt` or `bny`) and versioned codex tables. */
 export function parseCounter(input, version, cold) {
-    return cold === "bny"
-        ? parseCounterFromBinary(input, version)
-        : parseCounterFromText(input, version);
+    return cold === "bny" ? parseCounterFromBinary(input, version) : parseCounterFromText(input, version);
 }

package/esm/src/version.js

@@ -6,9 +6,9 @@
  * `src/version.ts` files by hand; edit this template instead.
  */
 /** Package semantic version copied from the owning package manifest. */
-export const PACKAGE_VERSION = "0.8.0";
+export const PACKAGE_VERSION = "0.9.0";
 /** Optional build metadata stamp injected by release/CI workflows. */
-export const BUILD_METADATA = "build.8.5884299463b061ec0fe2847a35a28b4189dee3f8";
+export const BUILD_METADATA = "build.9.a6b6e2ba5a202ef9b6cd9eaeb62fabdb904cc8f3";
 /** User-facing version string with build metadata appended when present. */
 export const DISPLAY_VERSION = BUILD_METADATA
     ? `${PACKAGE_VERSION}+${BUILD_METADATA}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cesr-ts",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "CESR parser, primitives, and annotation tooling for TypeScript/JavaScript",
   "homepage": "https://github.com/kentbull/keri-ts/tree/main/packages/cesr",
   "repository": {

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

@@ -16,6 +16,12 @@ export interface CounterInit {
     qb2?: Uint8Array;
     version?: Versionage;
 }
+export interface CounterEncloseInit {
+    qb64?: Uint8Array | string | null;
+    qb2?: Uint8Array | null;
+    code?: string;
+    version?: Versionage;
+}
 interface CounterData {
     code: string;
     count: number;
@@ -39,6 +45,8 @@ export declare class Counter {
     protected readonly _qb64: string;
     protected readonly _name: string;
     protected readonly _version: Versionage;
+    static makeGVC(version: Versionage): Uint8Array;
+    static enclose({ qb64, qb2, code, version, }?: CounterEncloseInit): Uint8Array;
     constructor(init: Counter | CounterData | CounterInit);
     protected toCounterData(): CounterData;
     get code(): string;

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":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,UAAU,WAAW;IACnB,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;IACb,OAAO,EAAE,UAAU,CAAC;CACrB;AAgMD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;gBAE5B,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW;IAgBrD,SAAS,CAAC,aAAa,IAAI,WAAW;IAYtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,UAAU,CAEtB;IAED,IAAI,GAAG,IAAI,UAAU,CAEpB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAIxC,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;gBAE1B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE;CAK5E;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CAET;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,GAClB,OAAO,CAET;AAED,mFAAmF;AACnF,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":"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"}

package/types/src/version.d.ts

@@ -6,9 +6,9 @@
  * `src/version.ts` files by hand; edit this template instead.
  */
 /** Package semantic version copied from the owning package manifest. */
-export declare const PACKAGE_VERSION = "0.8.0";
+export declare const PACKAGE_VERSION = "0.9.0";
 /** Optional build metadata stamp injected by release/CI workflows. */
-export declare const BUILD_METADATA = "build.8.5884299463b061ec0fe2847a35a28b4189dee3f8";
+export declare const BUILD_METADATA = "build.9.a6b6e2ba5a202ef9b6cd9eaeb62fabdb904cc8f3";
 /** User-facing version string with build metadata appended when present. */
 export declare const DISPLAY_VERSION: string;
 //# sourceMappingURL=version.d.ts.map