@kubun/hlc 0.12.0 → 0.14.0

package/lib/index.d.ts

@@ -15,6 +15,17 @@ export declare class HLC {
     receive(remote: HLCTimestamp): HLCTimestamp;
     static serialize(ts: HLCTimestamp): string;
     static parse(s: string): HLCTimestamp;
+    /**
+     * Parse a stamp that arrived from somewhere else, or answer `null`.
+     *
+     * `parse` never throws and never returns a uniformly-NaN record: a string with
+     * no `Z` yields a NaN wall time beside a counter that may still parse, so a
+     * caller checking one field admits the other. Every field is checked here, and
+     * anything a peer sends has to come through this rather than `parse` —
+     * `receive` assigns NaN straight into the clock, and the drift bound is blind
+     * to it because every comparison against NaN is false.
+     */
+    static tryParse(s: string): HLCTimestamp | null;
     static compare(a: HLCTimestamp, b: HLCTimestamp): number;
 }
 export {};

package/lib/index.js

@@ -79,6 +79,19 @@ export class HLC {
             nodeID
         };
     }
+    /**
+   * Parse a stamp that arrived from somewhere else, or answer `null`.
+   *
+   * `parse` never throws and never returns a uniformly-NaN record: a string with
+   * no `Z` yields a NaN wall time beside a counter that may still parse, so a
+   * caller checking one field admits the other. Every field is checked here, and
+   * anything a peer sends has to come through this rather than `parse` —
+   * `receive` assigns NaN straight into the clock, and the drift bound is blind
+   * to it because every comparison against NaN is false.
+   */ static tryParse(s) {
+        const ts = HLC.parse(s);
+        return Number.isFinite(ts.wallTime) && Number.isFinite(ts.counter) && ts.nodeID !== '' ? ts : null;
+    }
     static compare(a, b) {
         if (a.wallTime !== b.wallTime) return a.wallTime - b.wallTime;
         if (a.counter !== b.counter) return a.counter - b.counter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/hlc",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -14,6 +14,9 @@
     "lib/*",
     "LICENSE.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "pnpm run build:clean && pnpm run build:js && pnpm run build:types",
     "build:clean": "del lib",