@dxos/keys 0.8.4-main.fd6878d → 0.8.4-main.fffef41

package/dist/types/src/object-id.d.ts

@@ -1,10 +1,37 @@
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 declare const ObjectIdSchema: Schema.refine<string, typeof Schema.String>;
 export type ObjectId = typeof ObjectIdSchema.Type;
 export interface ObjectIdClass extends Schema.SchemaClass<ObjectId, string> {
+    /**
+     * @returns true if the string is a valid ObjectId.
+     */
     isValid(id: string): id is ObjectId;
+    /**
+     * Creates an ObjectId from a string validating the format.
+     */
     make(id: string): ObjectId;
+    /**
+     * Generates a random ObjectId.
+     */
     random(): ObjectId;
+    /**
+     * WARNING: To be used only within tests.
+     *
+     * Disables randomness in ObjectId generation, causing the same sequence of IDs to be generated.
+     * Do not use in production code as this will cause data collisions.
+     * Place this at the top of the test file to ensure that the same sequence of IDs is generated.
+     *
+     * ```ts
+     * ObjectId.dangerouslyDisableRandomness();
+     *
+     * describe('suite', () => {
+     *   // ...
+     * });
+     * ```
+     *
+     * NOTE: The generated IDs depend on the order of ObjectId.random() calls, which might be affected by test order, scheduling, etc.
+     */
+    dangerouslyDisableRandomness(): void;
 }
 /**
  * Randomly generated unique identifier for an object.
@@ -12,5 +39,27 @@ export interface ObjectIdClass extends Schema.SchemaClass<ObjectId, string> {
  * Follows ULID spec.
  */
 export declare const ObjectId: ObjectIdClass;
+/**
+ * Simple Linear Congruential Generator (LCG) for pseudo-random number generation.
+ * Returns numbers in the range [0, 1) (0 inclusive, 1 exclusive).
+ */
+export declare class SimplePRNG {
+    #private;
+    /**
+     * Creates a new PRNG instance.
+     * @param seed - Initial seed value. If not provided, uses 0.
+     */
+    constructor(seed?: number);
+    /**
+     * Generates the next pseudo-random number in the range [0, 1).
+     * @returns A pseudo-random number between 0 (inclusive) and 1 (exclusive).
+     */
+    next(): number;
+    /**
+     * Resets the generator with a new seed.
+     * @param seed - New seed value.
+     */
+    reset(seed: number): void;
+}
 export {};
 //# sourceMappingURL=object-id.d.ts.map

package/dist/types/src/object-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-id.d.ts","sourceRoot":"","sources":["../../../src/object-id.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,QAAA,MAAM,cAAc,6CAGlB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC;IACzE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IACpC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,IAAI,QAAQ,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,aAatB,CAAC"}
+{"version":3,"file":"object-id.d.ts","sourceRoot":"","sources":["../../../src/object-id.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,QAAA,MAAM,cAAc,6CAGlB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAElD,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC;IACzE;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAEpC;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE3B;;OAEG;IACH,MAAM,IAAI,QAAQ,CAAC;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,4BAA4B,IAAI,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,aAqBtB,CAAC;AAYF;;;GAGG;AACH,qBAAa,UAAU;;IAQrB;;;OAGG;gBACS,IAAI,GAAE,MAAU;IAI5B;;;OAGG;IACH,IAAI,IAAI,MAAM;IAQd;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/types/src/prng.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Simple Linear Congruential Generator (LCG) for pseudo-random number generation.
+ * Returns numbers in the range [0, 1) (0 inclusive, 1 exclusive).
+ */
+export declare class SimplePRNG {
+    private _seed;
+    private static readonly _a;
+    private static readonly _c;
+    private static readonly _m;
+    /**
+     * Creates a new PRNG instance.
+     * @param seed - Initial seed value. If not provided, uses current timestamp.
+     */
+    constructor(seed?: number);
+    /**
+     * Generates the next pseudo-random number in the range [0, 1).
+     * @returns A pseudo-random number between 0 (inclusive) and 1 (exclusive).
+     */
+    next(): number;
+    /**
+     * Resets the generator with a new seed.
+     * @param seed - New seed value.
+     */
+    reset(seed: number): void;
+}
+/**
+ * Creates a simple PRNG function with optional seed.
+ * @param seed - Optional seed value.
+ * @returns A function that returns pseudo-random numbers in [0, 1).
+ */
+export declare const createPRNG: (seed?: number) => (() => number);
+//# sourceMappingURL=prng.d.ts.map

package/dist/types/src/prng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prng.d.ts","sourceRoot":"","sources":["../../../src/prng.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAS;IAGtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAW;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAc;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAmB;IAE7C;;;OAGG;gBACS,IAAI,CAAC,EAAE,MAAM;IAIzB;;;OAGG;IACH,IAAI,IAAI,MAAM;IAQd;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,CAAC,MAAM,MAAM,CAGvD,CAAC"}

package/dist/types/src/space-id.d.ts

@@ -1,4 +1,4 @@
-import { Schema } from 'effect';
+import * as Schema from 'effect/Schema';
 /**
  * A unique identifier for a space.
  * Space keys are generated by creating a keypair, and then taking the first 20 bytes of the SHA-256 hash of the public key and encoding them to multibase RFC4648 base-32 format (prefixed with B, see Multibase Table).

package/dist/types/src/space-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space-id.d.ts","sourceRoot":"","sources":["../../../src/space-id.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAiBhC;;;;GAIG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC;IAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,MAAM,EAAE,MAAM,OAAO,CAAC;CAoBvB,CAAC"}
+{"version":3,"file":"space-id.d.ts","sourceRoot":"","sources":["../../../src/space-id.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAiBxC;;;;GAIG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IACvC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,IAAI,OAAO,CAAC;IAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,MAAM,EAAE,MAAM,OAAO,CAAC;CAoBvB,CAAC"}