@evolu/common 6.0.1-preview.29 → 6.0.1-preview.30

package/src/{RefCountedResourceManager.ts → Resources.ts}

@@ -4,10 +4,9 @@ import { PositiveInt } from "./Type.js";
 /**
  * A generic resource manager that handles reference counting and delayed
  * disposal of shared resources. Useful for managing expensive resources like
- * WebSocket connections, database connections, or file handles that need to be
- * shared among multiple consumers.
+ * WebSocket connections that need to be shared among multiple consumers.
  */
-export interface RefCountedResourceManager<
+export interface Resources<
   TResource extends Disposable,
   TResourceKey extends string,
   TResourceConfig,
@@ -73,7 +72,7 @@ export interface ConsumerNotFoundError<
   readonly resourceKey: TResourceKey;
 }
 
-export interface ResourceManagerConfig<
+export interface ResourcesConfig<
   TResource extends Disposable,
   TResourceKey extends string,
   TResourceConfig,
@@ -118,16 +117,16 @@ export interface ResourceManagerConfig<
 }
 
 /**
- * Creates a reference-counted resource manager.
+ * Creates {@link Resources}.
  *
- * This manager tracks which consumers are using which resources and maintains
- * reference counts to know when it's safe to dispose resources. Resources are
- * created on-demand and disposed with a configurable delay to avoid churn.
+ * This tracks which consumers are using which resources and maintains reference
+ * counts to know when it's safe to dispose resources. Resources are created
+ * on-demand and disposed with a configurable delay to avoid churn.
  *
  * ### Example Usage
  *
  * ```ts
- * // WebSocket connections manager
+ * // WebSocket connections
  * interface WebSocketConfig {
  *   readonly url: WebSocketUrl;
  * }
@@ -135,7 +134,7 @@ export interface ResourceManagerConfig<
  * type WebSocketUrl = string & Brand<"WebSocketUrl">;
  * type UserId = string & Brand<"UserId">;
  *
- * const wsManager = createRefCountedResourceManager<
+ * const webSockets = createResources<
  *   WebSocket,
  *   WebSocketUrl,
  *   WebSocketConfig,
@@ -149,16 +148,16 @@ export interface ResourceManagerConfig<
  * });
  *
  * // Add users to WebSocket connections
- * wsManager.addConsumer(user1, [
+ * webSockets.addConsumer(user1, [
  *   { url: "ws://server1.com" as WebSocketUrl },
  *   { url: "ws://server2.com" as WebSocketUrl },
  * ]);
- * wsManager.addConsumer(user2, [
+ * webSockets.addConsumer(user2, [
  *   { url: "ws://server1.com" as WebSocketUrl },
  * ]);
  *
  * // Remove users - server1 stays alive (user2 still using it)
- * wsManager.removeConsumer(user1, [
+ * webSockets.removeConsumer(user1, [
  *   { url: "ws://server1.com" as WebSocketUrl },
  *   { url: "ws://server2.com" as WebSocketUrl },
  * ]);
@@ -166,21 +165,21 @@ export interface ResourceManagerConfig<
  * // server2 gets disposed after delay, server1 stays alive
  * ```
  */
-export const createRefCountedResourceManager = <
+export const createResources = <
   TResource extends Disposable,
   TResourceKey extends string,
   TResourceConfig,
   TConsumer,
   TConsumerId extends string,
 >(
-  config: ResourceManagerConfig<
+  config: ResourcesConfig<
     TResource,
     TResourceKey,
     TResourceConfig,
     TConsumer,
     TConsumerId
   >,
-): RefCountedResourceManager<
+): Resources<
   TResource,
   TResourceKey,
   TResourceConfig,
@@ -189,7 +188,7 @@ export const createRefCountedResourceManager = <
 > => {
   let isDisposed = false;
 
-  const resources = new Map<TResourceKey, TResource>();
+  const resourcesMap = new Map<TResourceKey, TResource>();
   const consumerCounts = new Map<TResourceKey, Map<TConsumerId, PositiveInt>>();
   const consumers = new Map<TConsumerId, TConsumer>();
   const disposalTimeouts = new Map<
@@ -207,18 +206,18 @@ export const createRefCountedResourceManager = <
       disposalTimeouts.delete(key);
     }
 
-    if (!resources.has(key)) {
+    if (!resourcesMap.has(key)) {
       const resource = config.createResource(resourceConfig);
-      resources.set(key, resource);
+      resourcesMap.set(key, resource);
     }
   };
 
   const scheduleDisposal = (key: TResourceKey): void => {
     const timeout = setTimeout(() => {
-      const resource = resources.get(key);
+      const resource = resourcesMap.get(key);
       if (resource) {
         resource[Symbol.dispose]();
-        resources.delete(key);
+        resourcesMap.delete(key);
       }
       disposalTimeouts.delete(key);
     }, disposalDelay);
@@ -226,7 +225,7 @@ export const createRefCountedResourceManager = <
     disposalTimeouts.set(key, timeout);
   };
 
-  const manager: RefCountedResourceManager<
+  const resources: Resources<
     TResource,
     TResourceKey,
     TResourceConfig,
@@ -257,7 +256,7 @@ export const createRefCountedResourceManager = <
 
         // Call onConsumerAdded callback only when consumer is added for the first time (0 -> 1)
         if (currentCount === 0 && config.onConsumerAdded) {
-          const resource = resources.get(resourceKey);
+          const resource = resourcesMap.get(resourceKey);
           if (resource) {
             config.onConsumerAdded(consumer, resource, resourceKey);
           }
@@ -291,7 +290,7 @@ export const createRefCountedResourceManager = <
 
           // Call onConsumerRemoved callback only when consumer is completely removed (1 -> 0)
           if (config.onConsumerRemoved) {
-            const resource = resources.get(key);
+            const resource = resourcesMap.get(key);
             if (resource) {
               config.onConsumerRemoved(consumer, resource, key);
             }
@@ -306,7 +305,7 @@ export const createRefCountedResourceManager = <
         }
       }
 
-      if (!manager.hasConsumerAnyResource(consumer)) {
+      if (!resources.hasConsumerAnyResource(consumer)) {
         consumers.delete(consumerId);
       }
 
@@ -315,7 +314,7 @@ export const createRefCountedResourceManager = <
 
     getResource: (key) => {
       if (isDisposed) return null;
-      return resources.get(key) ?? null;
+      return resourcesMap.get(key) ?? null;
     },
 
     getConsumersForResource: (key) => {
@@ -339,7 +338,7 @@ export const createRefCountedResourceManager = <
       if (!consumer) return null;
 
       // Only return consumer if it's currently using any resources
-      if (!manager.hasConsumerAnyResource(consumer)) {
+      if (!resources.hasConsumerAnyResource(consumer)) {
         return null;
       }
 
@@ -355,14 +354,14 @@ export const createRefCountedResourceManager = <
       }
       disposalTimeouts.clear();
 
-      for (const resource of resources.values()) {
+      for (const resource of resourcesMap.values()) {
         resource[Symbol.dispose]();
       }
-      resources.clear();
+      resourcesMap.clear();
       consumerCounts.clear();
       consumers.clear();
     },
   };
 
-  return manager;
+  return resources;
 };

package/src/Result.ts

@@ -287,7 +287,7 @@
  *
  * ```ts
  * for (const query of [
- *   sql`drop table evolu_owner;`,
+ *   sql`drop table evolu_config;`,
  *   sql`drop table evolu_message;`,
  * ]) {
  *   const result = deps.sqlite.exec(query);

package/src/Skiplist.ts

@@ -25,7 +25,7 @@ export const createSkiplistLevel =
         while (deps.random.next() <= probability && level < maxLevel) {
           level += 1;
         }
-        return level as PositiveInt;
+        return PositiveInt.orThrow(level);
       },
     };
   };

package/src/Task.ts

@@ -577,7 +577,7 @@ export const retry = <T, E>(
       }
 
       // Wait before retry
-      const delayResult = await wait(delay as NonNegativeInt)(context);
+      const delayResult = await wait(NonNegativeInt.orThrow(delay))(context);
       if (!delayResult.ok) {
         // If delay was aborted, return AbortError (will be handled by toTask)
         return delayResult;
@@ -770,7 +770,7 @@ export interface Mutex extends Disposable {
  * ```
  */
 export const createMutex = (): Mutex => {
-  const mutex = createSemaphore(1 as PositiveInt);
+  const mutex = createSemaphore(PositiveInt.orThrow(1));
 
   return {
     withLock: mutex.withPermit,

package/src/Time.ts

@@ -207,5 +207,5 @@ export const durationToNonNegativeInt = (
     total += value * units[unit as keyof typeof units];
   }
 
-  return total as NonNegativeInt;
+  return NonNegativeInt.orThrow(total);
 };

package/src/index.ts

@@ -4,7 +4,7 @@ export * from "./BigInt.js";
 export * from "./Brand.js";
 export * from "./Buffer.js";
 export * from "./Cache.js";
-export * from "./CallbackRegistry.js";
+export * from "./Callbacks.js";
 export * from "./Console.js";
 export * from "./Crypto.js";
 export * from "./Eq.js";
@@ -20,6 +20,7 @@ export * from "./Order.js";
 export * from "./Platform.js";
 export * from "./Random.js";
 export * from "./Ref.js";
+export * from "./Resources.js";
 export * from "./Result.js";
 export * from "./Sqlite.js";
 export * from "./Store.js";

package/dist/src/CallbackRegistry.d.ts

@@ -1,53 +0,0 @@
-import { Brand } from "./Brand.js";
-import { RandomBytesDep } from "./Crypto.js";
-import { Id } from "./Type.js";
-/**
- * A registry for one-time callback functions.
- *
- * Stores callbacks with unique IDs and executes them once with an optional
- * argument. Executed callbacks are automatically removed from the registry.
- *
- * This is useful for correlating asynchronous operations across boundaries
- * where callback functions cannot be passed directly (e.g., web workers).
- *
- * The `execute` method intentionally does not use try-catch or {@link Result}
- * because it's the callback's responsibility to handle its own errors. The
- * registry is just a correlation mechanism and should not interfere with error
- * handling or debugging by masking the original error location.
- *
- * ### Example
- *
- * ```ts
- * // No-argument callbacks
- * const registry = createCallbackRegistry(deps);
- * const id = registry.register(() => console.log("called"));
- * registry.execute(id);
- *
- * // With argument callbacks
- * const stringRegistry = createCallbackRegistry<string>(deps);
- * const id = stringRegistry.register((value) => {
- *   console.log(value);
- * });
- * stringRegistry.execute(id, "hello");
- *
- * // Promise.withResolvers pattern
- * const promiseRegistry = createCallbackRegistry<string>(deps);
- * const { promise, resolve } = Promise.withResolvers<string>();
- * const id = promiseRegistry.register(resolve);
- * promiseRegistry.execute(id, "resolved value");
- * await promise; // "resolved value"
- * ```
- *
- * @template T - The type of argument passed to callbacks (defaults to undefined
- *   for no-argument callbacks)
- */
-export interface CallbackRegistry<T = undefined> {
-    /** Registers a callback function and returns a unique ID. */
-    readonly register: (callback: (arg: T) => void) => CallbackId;
-    /** Executes and removes a callback associated with the given ID. */
-    readonly execute: T extends undefined ? (id: CallbackId) => undefined : (id: CallbackId, arg: T) => undefined;
-}
-export type CallbackId = Id & Brand<"Callback">;
-/** Creates a new {@link CallbackRegistry} for one-time callback functions. */
-export declare const createCallbackRegistry: <T = undefined>(deps: RandomBytesDep) => CallbackRegistry<T>;
-//# sourceMappingURL=CallbackRegistry.d.ts.map

package/dist/src/CallbackRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CallbackRegistry.d.ts","sourceRoot":"","sources":["../../src/CallbackRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAY,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,SAAS;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,UAAU,CAAC;IAE9D,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,SAAS,GACjC,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,GAC7B,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;CAC3C;AAED,MAAM,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;AAEhD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,GAAI,CAAC,GAAG,SAAS,EAClD,MAAM,cAAc,KACnB,gBAAgB,CAAC,CAAC,CAuBpB,CAAC"}

package/dist/src/CallbackRegistry.js

@@ -1,25 +0,0 @@
-import { createId } from "./Type.js";
-/** Creates a new {@link CallbackRegistry} for one-time callback functions. */
-export const createCallbackRegistry = (deps) => {
-    const callbackMap = new Map();
-    return {
-        register: (callback) => {
-            const id = createId(deps);
-            callbackMap.set(id, callback);
-            return id;
-        },
-        execute: (id, ...args) => {
-            const callback = callbackMap.get(id);
-            if (callback) {
-                callbackMap.delete(id);
-                if (args.length === 0) {
-                    // Called without argument (undefined case)
-                    callback();
-                }
-                else {
-                    callback(args[0]);
-                }
-            }
-        },
-    };
-};

package/dist/src/RefCountedResourceManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RefCountedResourceManager.d.ts","sourceRoot":"","sources":["../../src/RefCountedResourceManager.ts"],"names":[],"mappings":"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"}