@quantcdn/edge-kv 0.1.0-rc.0 → 0.1.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantcdn/edge-kv",
-  "version": "0.1.0-rc.0",
+  "version": "0.1.0-rc.1",
   "description": "The Quant edge kvStore API and a local KV and ledger backend, for local development and emulators",
   "type": "module",
   "license": "Apache-2.0",

package/src/adapters/reference/backend/core.mjs

@@ -1,8 +1,8 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright 2026 QuantCDN Pty Ltd
 // Shared state of the local backend: stores, server time, versions, store-level errors and the storage hook.
-import { randomBytes } from 'node:crypto';
 import { ERROR_CODES } from '../../../lib/error-contract.mjs';
+import { createUlid } from './ulid.mjs';
 
 /** A store record. archives and digests belong to the simulated archive (archive.mjs). */
 export function newStore(id, format) {
@@ -40,9 +40,11 @@ export function createCore({ clock, KVError, storage, org, seed }) {
     if (store === undefined) throw core.error('STORE_NOT_FOUND', `store ${storeId} does not exist`);
     return store;
   };
+  // A ULID on server time, as the platform gives. versionSeq counts the versions (it is in the snapshot).
+  const ulid = createUlid();
   core.newVersion = () => {
     core.versionSeq += 1;
-    return `${core.now().toString(36)}-${core.versionSeq.toString(36)}-${randomBytes(3).toString('hex')}`;
+    return ulid(core.now());
   };
   return core;
 }

package/src/adapters/reference/backend/ulid.mjs

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright 2026 QuantCDN Pty Ltd
+// Item versions in the shape the platform gives: a ULID, 26 characters of Crockford base32 (48-bit millisecond time,
+// then 80 random bits). This one is monotonic in one process: in the same millisecond, or when the clock moves back,
+// the random part goes up by one, so versions sort in the order of the writes.
+import { randomBytes } from 'node:crypto';
+
+const ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+const MAX_TIME = 2 ** 48 - 1;
+const RANDOM_MAX = (1n << 80n) - 1n;
+
+function encode(value, length) {
+  let out = '';
+  for (let v = BigInt(value), i = 0; i < length; i += 1, v >>= 5n) out = ALPHABET[Number(v & 31n)] + out;
+  return out;
+}
+
+const randomPart = () => BigInt(`0x${randomBytes(10).toString('hex')}`);
+
+/** A function that makes monotonic ULIDs for the time it is given (epoch ms). */
+export function createUlid() {
+  let lastTime = -1;
+  let lastRandom = 0n;
+  return function ulid(nowMs) {
+    if (!Number.isSafeInteger(nowMs) || nowMs < 0 || nowMs > MAX_TIME) throw new RangeError('ulid time out of range');
+    const repeat = nowMs <= lastTime && lastRandom < RANDOM_MAX;
+    lastTime = repeat ? lastTime : nowMs;
+    lastRandom = repeat ? lastRandom + 1n : randomPart();
+    return encode(lastTime, 10) + encode(lastRandom, 16);
+  };
+}
+
+export const ULID_PATTERN = /^[0-9A-HJKMNP-TV-Z]{26}$/;

package/src/lib/check-util.mjs

@@ -12,11 +12,19 @@ export const isTtl = (v) => isIntIn(v, LIMITS.ttl);
 export const isAmount = (v) => Number.isSafeInteger(v) && v !== 0;
 export const byteCompare = (a, b) => Buffer.compare(Buffer.from(a, 'utf8'), Buffer.from(b, 'utf8'));
 
-/** A plain object: prototype Object.prototype or null. Arrays, dates and class instances are not. */
+// The Object.prototype of another realm (for example a node:vm context): its own prototype is null and its
+// constructor is a function named Object.
+function isForeignObjectPrototype(proto) {
+  return Object.getPrototypeOf(proto) === null && typeof proto.constructor === 'function'
+    && proto.constructor.name === 'Object';
+}
+
+/** A plain object of any realm: prototype Object.prototype or null. Arrays, dates and class instances are not. */
 export function isPlainObject(v) {
-  if (v === null || typeof v !== 'object') return false;
+  if (v === null || typeof v !== 'object' || Array.isArray(v)) return false;
   const proto = Object.getPrototypeOf(v);
-  return proto === Object.prototype || proto === null;
+  if (proto === Object.prototype || proto === null) return true;
+  return Object.prototype.toString.call(v) === '[object Object]' && isForeignObjectPrototype(proto);
 }
 
 export function isScalar(v) {

package/src/lib/edge-calls.mjs

@@ -37,7 +37,7 @@ export function createEdgeCalls({ backend, checks, KVError, isAllowed, warn = ()
     checks.checkStoreId(storeId);
     argumentChecks();
     if (!isAllowed(storeId)) {
-      throw new KVError('FORBIDDEN', `access to KV store ${storeId} is not allowed`, { status: 403 });
+      throw new KVError('FORBIDDEN', `Access to KV store ${storeId} is not allowed`, { status: 403 });
     }
   }