@rdlabo/workers-hono-kit 0.9.1 → 0.9.2

package/dist/offline/index.d.ts

@@ -10,3 +10,5 @@ export { fromTinyIntFlag, replicaTimestampMs, toReplicaDateOnly, toReplicaIsoDat
 export { replicaNowIso } from './clock.js';
 export { defineRestDbMethodConverter } from './rest-db-method-converter.js';
 export type { RestDbMethodConverter } from './rest-db-method-converter.js';
+export { decodeOfflineSnapshotCursor, encodeOfflineSnapshotCursor } from './snapshot-cursor.js';
+export type { OfflineSnapshotCursor } from './snapshot-cursor.js';

package/dist/offline/index.js

@@ -9,3 +9,4 @@
 export { fromTinyIntFlag, replicaTimestampMs, toReplicaDateOnly, toReplicaIsoDatetime, toTinyIntFlag } from './wire.js';
 export { replicaNowIso } from './clock.js';
 export { defineRestDbMethodConverter } from './rest-db-method-converter.js';
+export { decodeOfflineSnapshotCursor, encodeOfflineSnapshotCursor } from './snapshot-cursor.js';

package/dist/offline/snapshot-cursor.d.ts

@@ -0,0 +1,13 @@
+/** Position of a keyset-paginated initial snapshot at a captured journal watermark. */
+export interface OfflineSnapshotCursor {
+    /** Highest journal revision captured before the snapshot scan starts. */
+    watermark: number;
+    /** Zero-based product-defined snapshot source index. */
+    sourceIndex: number;
+    /** Last server-side numeric ID emitted from the current source. */
+    afterId: number;
+}
+/** Encodes an initial-snapshot position as a stable versioned cursor. */
+export declare function encodeOfflineSnapshotCursor(cursor: OfflineSnapshotCursor): string;
+/** Decodes a versioned initial-snapshot cursor, returning null for malformed input. */
+export declare function decodeOfflineSnapshotCursor(value: string): OfflineSnapshotCursor | null;

package/dist/offline/snapshot-cursor.js

@@ -0,0 +1,39 @@
+const SNAPSHOT_CURSOR_PREFIX = 'snapshot:v1';
+const CANONICAL_NON_NEGATIVE_INTEGER = /^(0|[1-9]\d*)$/;
+/** Encodes an initial-snapshot position as a stable versioned cursor. */
+export function encodeOfflineSnapshotCursor(cursor) {
+    assertNonNegativeSafeInteger(cursor.watermark, 'watermark');
+    assertNonNegativeSafeInteger(cursor.sourceIndex, 'sourceIndex');
+    assertNonNegativeSafeInteger(cursor.afterId, 'afterId');
+    return `${SNAPSHOT_CURSOR_PREFIX}:${cursor.watermark}:${cursor.sourceIndex}:${cursor.afterId}`;
+}
+/** Decodes a versioned initial-snapshot cursor, returning null for malformed input. */
+export function decodeOfflineSnapshotCursor(value) {
+    const parts = value.split(':');
+    if (parts.length !== 5 || `${parts[0]}:${parts[1]}` !== SNAPSHOT_CURSOR_PREFIX) {
+        return null;
+    }
+    const [, , watermarkValue, sourceIndexValue, afterIdValue] = parts;
+    if (!CANONICAL_NON_NEGATIVE_INTEGER.test(watermarkValue) ||
+        !CANONICAL_NON_NEGATIVE_INTEGER.test(sourceIndexValue) ||
+        !CANONICAL_NON_NEGATIVE_INTEGER.test(afterIdValue)) {
+        return null;
+    }
+    const watermark = Number(watermarkValue);
+    const sourceIndex = Number(sourceIndexValue);
+    const afterId = Number(afterIdValue);
+    if (!isNonNegativeSafeInteger(watermark) ||
+        !isNonNegativeSafeInteger(sourceIndex) ||
+        !isNonNegativeSafeInteger(afterId)) {
+        return null;
+    }
+    return { watermark, sourceIndex, afterId };
+}
+function isNonNegativeSafeInteger(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function assertNonNegativeSafeInteger(value, field) {
+    if (!isNonNegativeSafeInteger(value)) {
+        throw new RangeError(`Offline snapshot cursor ${field} must be a non-negative safe integer.`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rdlabo/workers-hono-kit",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "private": false,
   "publishConfig": {
     "access": "public"