@dxos/keys 0.8.4-main.1da679c → 0.8.4-main.21d9917

package/dist/lib/node-esm/index.mjs

@@ -82,18 +82,20 @@ var require_base32_decode = __commonJS({
 });
 
 // src/dxn.ts
-import { Schema as Schema3 } from "effect";
+import * as Schema3 from "effect/Schema";
 import { devtoolsFormatter, inspectCustom } from "@dxos/debug";
 import { assertArgument, invariant as invariant2 } from "@dxos/invariant";
 
 // src/object-id.ts
-import { Schema } from "effect";
-import { ulid } from "ulidx";
+import * as Schema from "effect/Schema";
+import { monotonicFactory } from "ulidx";
 var ObjectIdSchema = Schema.String.pipe(Schema.pattern(/^[0-7][0-9A-HJKMNP-TV-Z]{25}$/i)).annotations({
   description: "A Universally Unique Lexicographically Sortable Identifier",
   pattern: "^[0-7][0-9A-HJKMNP-TV-Z]{25}$"
 });
 var ObjectId = class extends ObjectIdSchema {
+  static #factory = monotonicFactory();
+  static #seedTime = void 0;
   static isValid(id) {
     try {
       Schema.decodeSync(ObjectId)(id);
@@ -103,7 +105,46 @@ var ObjectId = class extends ObjectIdSchema {
     }
   }
   static random() {
-    return ulid();
+    return this.#factory(this.#seedTime);
+  }
+  static dangerouslyDisableRandomness() {
+    this.#factory = monotonicFactory(makeTestPRNG());
+    this.#seedTime = (/* @__PURE__ */ new Date("2025-01-01")).getTime();
+  }
+};
+var makeTestPRNG = () => {
+  const rng = new SimplePRNG();
+  return () => {
+    return rng.next();
+  };
+};
+var SimplePRNG = class _SimplePRNG {
+  #seed;
+  // LCG parameters (from Numerical Recipes)
+  static #a = 1664525;
+  static #c = 1013904223;
+  static #m = Math.pow(2, 32);
+  /**
+  * Creates a new PRNG instance.
+  * @param seed - Initial seed value. If not provided, uses 0.
+  */
+  constructor(seed = 0) {
+    this.#seed = seed;
+  }
+  /**
+  * Generates the next pseudo-random number in the range [0, 1).
+  * @returns A pseudo-random number between 0 (inclusive) and 1 (exclusive).
+  */
+  next() {
+    this.#seed = (_SimplePRNG.#a * this.#seed + _SimplePRNG.#c) % _SimplePRNG.#m;
+    return this.#seed / _SimplePRNG.#m;
+  }
+  /**
+  * Resets the generator with a new seed.
+  * @param seed - New seed value.
+  */
+  reset(seed) {
+    this.#seed = seed;
   }
 };
 
@@ -170,7 +211,7 @@ function base32Encode(data, variant, options) {
 }
 
 // src/space-id.ts
-import { Schema as Schema2 } from "effect";
+import * as Schema2 from "effect/Schema";
 import { invariant } from "@dxos/invariant";
 
 // src/random-bytes.ts
@@ -182,117 +223,54 @@ var randomBytes = (length) => {
 };
 
 // src/space-id.ts
-function _define_property(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
-var _Schema_String_pipe;
-var _class;
 var __dxlog_file = "/__w/dxos/dxos/packages/common/keys/src/space-id.ts";
 var MULTIBASE_PREFIX = "B";
 var ENCODED_LENGTH = 33;
 var isValid = (value) => {
   return typeof value === "string" && value.startsWith(MULTIBASE_PREFIX) && value.length === ENCODED_LENGTH;
 };
-var SpaceId = (_class = class extends (_Schema_String_pipe = Schema2.String.pipe(Schema2.filter(isValid))) {
-}, _define_property(_class, "byteLength", 20), _define_property(_class, "encode", (value) => {
-  invariant(value instanceof Uint8Array, "Invalid type", {
-    F: __dxlog_file,
-    L: 43,
-    S: _class,
-    A: [
-      "value instanceof Uint8Array",
-      "'Invalid type'"
-    ]
-  });
-  invariant(value.length === SpaceId.byteLength, "Invalid length", {
-    F: __dxlog_file,
-    L: 44,
-    S: _class,
-    A: [
-      "value.length === SpaceId.byteLength",
-      "'Invalid length'"
-    ]
-  });
-  return MULTIBASE_PREFIX + base32Encode(value, "RFC4648");
-}), _define_property(_class, "decode", (value) => {
-  invariant(value.startsWith(MULTIBASE_PREFIX), "Invalid multibase32 encoding", {
-    F: __dxlog_file,
-    L: 49,
-    S: _class,
-    A: [
-      "value.startsWith(MULTIBASE_PREFIX)",
-      "'Invalid multibase32 encoding'"
-    ]
-  });
-  return new Uint8Array((0, import_base32_decode.default)(value.slice(1), "RFC4648"));
-}), _define_property(_class, "isValid", isValid), _define_property(_class, "random", () => {
-  return SpaceId.encode(randomBytes(SpaceId.byteLength));
-}), _class);
+var SpaceId = class extends Schema2.String.pipe(Schema2.filter(isValid)) {
+  static byteLength = 20;
+  static encode = (value) => {
+    invariant(value instanceof Uint8Array, "Invalid type", {
+      F: __dxlog_file,
+      L: 43,
+      S: this,
+      A: [
+        "value instanceof Uint8Array",
+        "'Invalid type'"
+      ]
+    });
+    invariant(value.length === SpaceId.byteLength, "Invalid length", {
+      F: __dxlog_file,
+      L: 44,
+      S: this,
+      A: [
+        "value.length === SpaceId.byteLength",
+        "'Invalid length'"
+      ]
+    });
+    return MULTIBASE_PREFIX + base32Encode(value, "RFC4648");
+  };
+  static decode = (value) => {
+    invariant(value.startsWith(MULTIBASE_PREFIX), "Invalid multibase32 encoding", {
+      F: __dxlog_file,
+      L: 49,
+      S: this,
+      A: [
+        "value.startsWith(MULTIBASE_PREFIX)",
+        "'Invalid multibase32 encoding'"
+      ]
+    });
+    return new Uint8Array((0, import_base32_decode.default)(value.slice(1), "RFC4648"));
+  };
+  static isValid = isValid;
+  static random = () => {
+    return SpaceId.encode(randomBytes(SpaceId.byteLength));
+  };
+};
 
 // src/dxn.ts
-function _check_private_redeclaration(obj, privateCollection) {
-  if (privateCollection.has(obj)) {
-    throw new TypeError("Cannot initialize the same private elements twice on an object");
-  }
-}
-function _class_apply_descriptor_get(receiver, descriptor) {
-  if (descriptor.get) {
-    return descriptor.get.call(receiver);
-  }
-  return descriptor.value;
-}
-function _class_apply_descriptor_set(receiver, descriptor, value) {
-  if (descriptor.set) {
-    descriptor.set.call(receiver, value);
-  } else {
-    if (!descriptor.writable) {
-      throw new TypeError("attempted to set read only private field");
-    }
-    descriptor.value = value;
-  }
-}
-function _class_extract_field_descriptor(receiver, privateMap, action) {
-  if (!privateMap.has(receiver)) {
-    throw new TypeError("attempted to " + action + " private field on non-instance");
-  }
-  return privateMap.get(receiver);
-}
-function _class_private_field_get(receiver, privateMap) {
-  var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
-  return _class_apply_descriptor_get(receiver, descriptor);
-}
-function _class_private_field_init(obj, privateMap, value) {
-  _check_private_redeclaration(obj, privateMap);
-  privateMap.set(obj, value);
-}
-function _class_private_field_set(receiver, privateMap, value) {
-  var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
-  _class_apply_descriptor_set(receiver, descriptor, value);
-  return value;
-}
-function _define_property2(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var __dxlog_file2 = "/__w/dxos/dxos/packages/common/keys/src/dxn.ts";
 var LOCAL_SPACE_TAG = "@";
 var DXN_ECHO_REGEXP = /@(dxn:[a-zA-Z0-p:@]+)/;
@@ -300,15 +278,49 @@ var QueueSubspaceTags = Object.freeze({
   DATA: "data",
   TRACE: "trace"
 });
-var _kind = /* @__PURE__ */ new WeakMap();
-var _parts = /* @__PURE__ */ new WeakMap();
-var _inspectCustom = inspectCustom;
-var _devtoolsFormatter = devtoolsFormatter;
 var DXN = class _DXN {
+  // TODO(burdon): Rename to DXN (i.e., DXN.DXN).
+  // TODO(dmaretskyi): Should this be a transformation into the DXN type?
+  static Schema = Schema3.NonEmptyString.pipe(
+    Schema3.pattern(/^dxn:([^:]+):(?:[^:]+:?)+[^:]$/),
+    // TODO(dmaretskyi): To set the format we need to move the annotation IDs out of the echo-schema package.
+    // FormatAnnotation.set(TypeFormat.DXN),
+    Schema3.annotations({
+      title: "DXN",
+      description: "DXN URI",
+      examples: [
+        "dxn:type:example.com/type/MyType",
+        "dxn:echo:@:01J00J9B45YHYSGZQTQMSKMGJ6"
+      ]
+    })
+  );
   static hash(dxn) {
     return dxn.toString();
   }
   /**
+  * Kind constants.
+  */
+  static kind = Object.freeze({
+    /**
+    * dxn:type:<type_name>[:<version>]
+    */
+    TYPE: "type",
+    /**
+    * dxn:echo:<space_id>:<echo_id>
+    * dxn:echo:@:<echo_id>
+    */
+    // TODO(burdon): Rename to OBJECT? (BREAKING CHANGE to update "echo").
+    // TODO(burdon): Add separate Kind for space?
+    ECHO: "echo",
+    /**
+    * The subspace tag enables us to partition queues by usage within the context of a space.
+    * dxn:queue:<subspace_tag>:<space_id>:<queue_id>[:object_id]
+    * dxn:queue:data:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
+    * dxn:queue:trace:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
+    */
+    QUEUE: "queue"
+  });
+  /**
   * Exactly equals.
   */
   static equals(a, b) {
@@ -347,7 +359,7 @@ var DXN = class _DXN {
     }
   }
   /**
-  * @example `dxn:type:example.com/type/Contact`
+  * @example `dxn:type:example.com/type/Person`
   */
   static fromTypename(typename) {
     return new _DXN(_DXN.kind.TYPE, [
@@ -355,7 +367,7 @@ var DXN = class _DXN {
     ]);
   }
   /**
-  * @example `dxn:type:example.com/type/Contact:0.1.0`
+  * @example `dxn:type:example.com/type/Person:0.1.0`
   */
   // TODO(dmaretskyi): Consider using @ as the version separator.
   static fromTypenameAndVersion(typename, version) {
@@ -398,8 +410,28 @@ var DXN = class _DXN {
       ] : []
     ]);
   }
+  #kind;
+  #parts;
+  constructor(kind, parts) {
+    assertArgument(parts.length > 0, "parts", `Invalid DXN: ${parts}`);
+    assertArgument(parts.every((part) => typeof part === "string" && part.length > 0 && part.indexOf(":") === -1), "parts", `Invalid DXN: ${parts}`);
+    switch (kind) {
+      case _DXN.kind.TYPE:
+        if (parts.length > 2) {
+          throw new Error("Invalid DXN.kind.TYPE");
+        }
+        break;
+      case _DXN.kind.ECHO:
+        if (parts.length !== 2) {
+          throw new Error("Invalid DXN.kind.ECHO");
+        }
+        break;
+    }
+    this.#kind = kind;
+    this.#parts = parts;
+  }
   toString() {
-    return `dxn:${_class_private_field_get(this, _kind)}:${_class_private_field_get(this, _parts).join(":")}`;
+    return `dxn:${this.#kind}:${this.#parts.join(":")}`;
   }
   toJSON() {
     return this.toString();
@@ -407,13 +439,13 @@ var DXN = class _DXN {
   /**
   * Used by Node.js to get textual representation of this object when it's printed with a `console.log` statement.
   */
-  [_inspectCustom](depth, options, inspectFn) {
+  [inspectCustom](depth, options, inspectFn) {
     const printControlCode = (code) => {
       return `\x1B[${code}m`;
     };
     return printControlCode(inspectFn.colors.blueBright[0]) + this.toString() + printControlCode(inspectFn.colors.reset[0]);
   }
-  get [_devtoolsFormatter]() {
+  get [devtoolsFormatter]() {
     return {
       header: () => {
         return [
@@ -427,14 +459,14 @@ var DXN = class _DXN {
     };
   }
   get kind() {
-    return _class_private_field_get(this, _kind);
+    return this.#kind;
   }
   get parts() {
-    return _class_private_field_get(this, _parts);
+    return this.#parts;
   }
   // TODO(burdon): Should getters fail?
   get typename() {
-    invariant2(_class_private_field_get(this, _kind) === _DXN.kind.TYPE, void 0, {
+    invariant2(this.#kind === _DXN.kind.TYPE, void 0, {
       F: __dxlog_file2,
       L: 250,
       S: this,
@@ -443,22 +475,22 @@ var DXN = class _DXN {
         ""
       ]
     });
-    return _class_private_field_get(this, _parts)[0];
+    return this.#parts[0];
   }
   equals(other) {
     return _DXN.equals(this, other);
   }
   hasTypenameOf(typename) {
-    return _class_private_field_get(this, _kind) === _DXN.kind.TYPE && _class_private_field_get(this, _parts).length === 1 && _class_private_field_get(this, _parts)[0] === typename;
+    return this.#kind === _DXN.kind.TYPE && this.#parts.length === 1 && this.#parts[0] === typename;
   }
   isLocalObjectId() {
-    return _class_private_field_get(this, _kind) === _DXN.kind.ECHO && _class_private_field_get(this, _parts)[0] === LOCAL_SPACE_TAG && _class_private_field_get(this, _parts).length === 2;
+    return this.#kind === _DXN.kind.ECHO && this.#parts[0] === LOCAL_SPACE_TAG && this.#parts.length === 2;
   }
   asTypeDXN() {
     if (this.kind !== _DXN.kind.TYPE) {
       return void 0;
     }
-    const [type, version] = _class_private_field_get(this, _parts);
+    const [type, version] = this.#parts;
     return {
       // TODO(wittjosiah): Should be `typename` for consistency.
       type,
@@ -469,7 +501,7 @@ var DXN = class _DXN {
     if (this.kind !== _DXN.kind.ECHO) {
       return void 0;
     }
-    const [spaceId, echoId] = _class_private_field_get(this, _parts);
+    const [spaceId, echoId] = this.#parts;
     return {
       spaceId: spaceId === LOCAL_SPACE_TAG ? void 0 : spaceId,
       // TODO(burdon): objectId.
@@ -480,7 +512,7 @@ var DXN = class _DXN {
     if (this.kind !== _DXN.kind.QUEUE) {
       return void 0;
     }
-    const [subspaceTag, spaceId, queueId, objectId] = _class_private_field_get(this, _parts);
+    const [subspaceTag, spaceId, queueId, objectId] = this.#parts;
     if (typeof queueId !== "string") {
       return void 0;
     }
@@ -495,71 +527,12 @@ var DXN = class _DXN {
   * Produces a new DXN with the given parts appended.
   */
   extend(parts) {
-    return new _DXN(_class_private_field_get(this, _kind), [
-      ..._class_private_field_get(this, _parts),
+    return new _DXN(this.#kind, [
+      ...this.#parts,
       ...parts
     ]);
   }
-  constructor(kind, parts) {
-    _class_private_field_init(this, _kind, {
-      writable: true,
-      value: void 0
-    });
-    _class_private_field_init(this, _parts, {
-      writable: true,
-      value: void 0
-    });
-    assertArgument(parts.length > 0, "parts", `Invalid DXN: ${parts}`);
-    assertArgument(parts.every((part) => typeof part === "string" && part.length > 0 && part.indexOf(":") === -1), "parts", `Invalid DXN: ${parts}`);
-    switch (kind) {
-      case _DXN.kind.TYPE:
-        if (parts.length > 2) {
-          throw new Error("Invalid DXN.kind.TYPE");
-        }
-        break;
-      case _DXN.kind.ECHO:
-        if (parts.length !== 2) {
-          throw new Error("Invalid DXN.kind.ECHO");
-        }
-        break;
-    }
-    _class_private_field_set(this, _kind, kind);
-    _class_private_field_set(this, _parts, parts);
-  }
 };
-_define_property2(DXN, "Schema", Schema3.NonEmptyString.pipe(
-  Schema3.pattern(/^dxn:([^:]+):(?:[^:]+:?)+[^:]$/),
-  // TODO(dmaretskyi): To set the format we need to move the annotation IDs out of the echo-schema package.
-  // FormatAnnotation.set(FormatEnum.DXN),
-  Schema3.annotations({
-    title: "DXN",
-    description: "DXN URI",
-    examples: [
-      "dxn:type:example.com/type/MyType",
-      "dxn:echo:@:01J00J9B45YHYSGZQTQMSKMGJ6"
-    ]
-  })
-));
-_define_property2(DXN, "kind", Object.freeze({
-  /**
-   * dxn:type:<type_name>[:<version>]
-   */
-  TYPE: "type",
-  /**
-   * dxn:echo:<space_id>:<echo_id>
-   * dxn:echo:@:<echo_id>
-   */
-  // TODO(burdon): Rename to OBJECT? (BREAKING CHANGE to update "echo").
-  // TODO(burdon): Add separate Kind for space?
-  ECHO: "echo",
-  /**
-   * The subspace tag enables us to partition queues by usage within the context of a space.
-   * dxn:queue:<subspace_tag>:<space_id>:<queue_id>[:object_id]
-   * dxn:queue:data:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
-   * dxn:queue:trace:BA25QRC2FEWCSAMRP4RZL65LWJ7352CKE:01J00J9B45YHYSGZQTQMSKMGJ6
-   */
-  QUEUE: "queue"
-}));
 
 // src/identity-did.ts
 var import_base32_decode2 = __toESM(require_base32_decode(), 1);
@@ -615,27 +588,13 @@ var ENCODED_LENGTH2 = 42;
 var import_base32_decode3 = __toESM(require_base32_decode(), 1);
 import { devtoolsFormatter as devtoolsFormatter2, equalsSymbol, inspectCustom as inspectCustom2, truncateKey } from "@dxos/debug";
 import { invariant as invariant4 } from "@dxos/invariant";
-function _define_property3(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var __dxlog_file4 = "/__w/dxos/dxos/packages/common/keys/src/public-key.ts";
 var PUBLIC_KEY_LENGTH = 32;
 var SECRET_KEY_LENGTH = 64;
 var isLikeArrayBuffer = (value) => typeof value === "object" && value !== null && Object.getPrototypeOf(value).constructor.name === "ArrayBuffer";
-var _inspectCustom2 = inspectCustom2;
-var _devtoolsFormatter2 = devtoolsFormatter2;
-var _equalsSymbol = equalsSymbol;
 var PublicKey = class _PublicKey {
+  _value;
+  static ZERO = _PublicKey.from("00".repeat(PUBLIC_KEY_LENGTH));
   /**
   * Creates new instance of PublicKey automatically determining the input format.
   * @param source A Buffer, or Uint8Array, or hex encoded string, or something with an `asUint8Array` method on it
@@ -787,6 +746,12 @@ var PublicKey = class _PublicKey {
     });
     return new _PublicKey(new Uint8Array((0, import_base32_decode3.default)(encoded.slice(1), "RFC4648")));
   }
+  constructor(_value) {
+    this._value = _value;
+    if (!(_value instanceof Uint8Array)) {
+      throw new TypeError(`Expected Uint8Array, got: ${_value}`);
+    }
+  }
   toString() {
     return this.toHex();
   }
@@ -820,7 +785,7 @@ var PublicKey = class _PublicKey {
   /**
   * Used by Node.js to get textual representation of this object when it's printed with a `console.log` statement.
   */
-  [_inspectCustom2](depth, options, inspectFn) {
+  [inspectCustom2](depth, options, inspectFn) {
     if (!options.colors || typeof process.stdout.hasColors !== "function" || !process.stdout.hasColors()) {
       return `<PublicKey ${this.truncate()}>`;
     }
@@ -845,7 +810,7 @@ var PublicKey = class _PublicKey {
     const color = colors[this.getInsecureHash(colors.length)];
     return `PublicKey(${printControlCode(inspectFn.colors[color][0])}${this.truncate()}${printControlCode(inspectFn.colors.reset[0])})`;
   }
-  get [_devtoolsFormatter2]() {
+  get [devtoolsFormatter2]() {
     return {
       header: () => {
         const colors = [
@@ -898,25 +863,17 @@ var PublicKey = class _PublicKey {
     }
     let equal = true;
     for (let i = 0; i < this._value.length; i++) {
-      equal && (equal = this._value[i] === otherConverted._value[i]);
+      equal &&= this._value[i] === otherConverted._value[i];
     }
     return equal;
   }
-  [_equalsSymbol](other) {
+  [equalsSymbol](other) {
     if (!_PublicKey.isPublicKey(other)) {
       return false;
     }
     return this.equals(other);
   }
-  constructor(_value) {
-    _define_property3(this, "_value", void 0);
-    this._value = _value;
-    if (!(_value instanceof Uint8Array)) {
-      throw new TypeError(`Expected Uint8Array, got: ${_value}`);
-    }
-  }
 };
-_define_property3(PublicKey, "ZERO", PublicKey.from("00".repeat(PUBLIC_KEY_LENGTH)));
 export {
   DXN,
   DXN_ECHO_REGEXP,
@@ -927,6 +884,7 @@ export {
   PublicKey,
   QueueSubspaceTags,
   SECRET_KEY_LENGTH,
+  SimplePRNG,
   SpaceId
 };
 //# sourceMappingURL=index.mjs.map