npm - @rivetkit/framework-base - Versions diffs - 2.0.2 → 2.0.4-rc.1 - Mend

@rivetkit/framework-base 2.0.2 → 2.0.4-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -1,10 +1,85 @@
 # RivetKit Framework Base
-_Lightweight Libraries for Backends_
+_Library to build and scale stateful workloads_
-[Learn More →](https://github.com/rivet-gg/rivetkit)
+[Learn More →](https://github.com/rivet-dev/rivetkit)
-[Discord](https://rivet.gg/discord) — [Documentation](https://rivetkit.org) — [Issues](https://github.com/rivet-gg/rivetkit/issues)
+[Discord](https://rivet.dev/discord) — [Documentation](https://rivetkit.org) — [Issues](https://github.com/rivet-dev/rivetkit/issues)
+## Lifecycle
+### Mount
+```
+1. useActor(opts) called in React component
+2. getOrCreateActor(opts)
+   - hash opts to get key
+   - sync opts to store (create or update actor entry)
+   - if not in cache:
+       - create Derived (subscribes to store)
+       - create Effect (handles connection logic)
+       - add to cache with refCount=0
+   - return { mount, state }
+3. useEffect runs mount()
+   - cancel any pending cleanup timeout
+   - refCount++
+   - if refCount == 1:
+       - mount derived and effect
+       - if enabled and idle: call create() directly
+         (Effect only runs on state changes, not on mount)
+4. Effect triggers (on state changes)
+   - if disabled and connected: dispose connection, reset to idle
+   - if enabled and idle: call create()
+5. create()
+   - set connStatus = Connecting
+   - handle = client.getOrCreate(name, key)
+   - connection = handle.connect()
+   - subscribe to connection status/error events
+   - store handle and connection in store
+6. Connection established
+   - connStatus updates, Derived updates, React re-renders
+```
+### Unmount
+```
+1. Component unmounts
+2. useEffect cleanup runs
+3. refCount--
+4. if refCount == 0: setTimeout(cleanup, 0)
+5. When timeout fires:
+   - if refCount > 0: skip (was remounted)
+   - else: dispose connection, remove from store/cache
+```
+### React Strict Mode
+Why `setTimeout` matters:
+```
+- render
+- mount: refCount = 1
+- unmount: refCount = 0, schedule timeout
+- remount: refCount = 1, cancel timeout
+- timeout fires: refCount > 0, cleanup skipped
+```
+### Shared Actor
+Two components using the same actor opts:
+```
+- Component A mounts: refCount = 1, connection created
+- Component B mounts: refCount = 2, reuses connection
+- Component A unmounts: refCount = 1, no cleanup
+- Component B unmounts: refCount = 0, cleanup scheduled
+- Timeout fires: connection disposed, removed from cache
+```
 ## License

package/dist/mod.d.mts ADDED Viewed

@@ -0,0 +1,132 @@
+import { Derived, Store } from '@tanstack/store';
+import { Registry, AnyActorDefinition } from 'rivetkit';
+import { ExtractActorsFromRegistry, ActorHandle, ActorConn, ActorConnStatus, Client } from 'rivetkit/client';
+export { ActorConnStatus } from 'rivetkit/client';
+type AnyActorRegistry = Registry<any>;
+interface ActorStateReference<AD extends AnyActorDefinition> {
+    /**
+     * The unique identifier for the actor.
+     * This is a hash generated from the actor's options.
+     * It is used to identify the actor instance in the store.
+     * @internal
+     */
+    hash: string;
+    /**
+     * The state of the actor, derived from the store.
+     * This includes the actor's connection and handle.
+     */
+    handle: ActorHandle<AD> | null;
+    /**
+     * The connection to the actor.
+     * This is used to communicate with the actor in realtime.
+     */
+    connection: ActorConn<AD> | null;
+    /**
+     * The connection status of the actor.
+     */
+    connStatus: ActorConnStatus;
+    /**
+     * The error that occurred while trying to connect to the actor, if any.
+     */
+    error: Error | null;
+    /**
+     * Options for the actor, including its name, key, parameters, and whether it is enabled.
+     */
+    opts: {
+        name: keyof AD;
+        /**
+         * Unique key for the actor instance.
+         * This can be a string or an array of strings to create multiple instances.
+         * @example "abc" or ["abc", "def"]
+         */
+        key: string | string[];
+        /**
+         * Parameters for the actor.
+         * These are additional options that can be passed to the actor.
+         */
+        params?: Record<string, string>;
+        /** Region to create the actor in if it doesn't exist. */
+        createInRegion?: string;
+        /** Input data to pass to the actor. */
+        createWithInput?: unknown;
+        /**
+         * Whether the actor is enabled.
+         * Defaults to true.
+         */
+        enabled?: boolean;
+        /**
+         * If true, only gets the actor if it already exists. Does not create the actor.
+         * Throws an error if the actor is not found.
+         * Defaults to false.
+         */
+        noCreate?: boolean;
+    };
+}
+interface InternalRivetKitStore<Registry extends AnyActorRegistry, Actors extends ExtractActorsFromRegistry<Registry>> {
+    actors: Record<string, ActorStateReference<Actors>>;
+}
+/**
+ * Options for configuring a actor in RivetKit.
+ */
+interface ActorOptions<Registry extends AnyActorRegistry, ActorName extends keyof ExtractActorsFromRegistry<Registry>> {
+    /**
+     * Typesafe name of the actor.
+     * This should match the actor's name in the app's actor definitions.
+     * @example "chatRoom"
+     */
+    name: ActorName;
+    /**
+     * Unique key for the actor instance.
+     * This can be a string or an array of strings to create multiple instances.
+     * @example "abc" or ["abc", "def"]
+     */
+    key: string | string[];
+    /**
+     * Parameters for the actor.
+     */
+    params?: Registry[ExtractActorsFromRegistry<Registry>]["params"];
+    /** Region to create the actor in if it doesn't exist. */
+    createInRegion?: string;
+    /** Input data to pass to the actor. */
+    createWithInput?: unknown;
+    /**
+     * Whether the actor is enabled.
+     * Defaults to true.
+     */
+    enabled?: boolean;
+    /**
+     * If true, only gets the actor if it already exists. Does not create the actor.
+     * Throws an error if the actor is not found.
+     * Defaults to false.
+     */
+    noCreate?: boolean;
+}
+type ActorsStateDerived<Registry extends AnyActorRegistry, WorkerName extends keyof ExtractActorsFromRegistry<Registry>> = Derived<Omit<InternalRivetKitStore<Registry, ExtractActorsFromRegistry<Registry>>["actors"][string], "handle" | "connection"> & {
+    handle: ActorHandle<ExtractActorsFromRegistry<Registry>[WorkerName]> | null;
+    connection: ActorConn<ExtractActorsFromRegistry<Registry>[WorkerName]> | null;
+    /** @deprecated Use `connStatus === "connected"` instead */
+    isConnected: boolean;
+}>;
+type AnyActorOptions = ActorOptions<AnyActorRegistry, any>;
+interface CreateRivetKitOptions<Registry extends AnyActorRegistry> {
+    hashFunction?: (opts: ActorOptions<Registry, any>) => string;
+}
+declare function createRivetKit<Registry extends AnyActorRegistry, Actors extends ExtractActorsFromRegistry<Registry>>(client: Client<Registry>, createOpts?: CreateRivetKitOptions<Registry>): {
+    getOrCreateActor: <ActorName extends keyof Actors>(actorOpts: ActorOptions<Registry, ActorName>) => {
+        state: ActorsStateDerived<Registry, ActorName>;
+        key: string;
+        mount: () => () => void;
+        create: () => void;
+        refCount: number;
+        cleanupTimeout: ReturnType<typeof setTimeout> | null;
+    } | {
+        mount: () => () => void;
+        state: ActorsStateDerived<Registry, ActorName>;
+        key: string;
+    };
+    store: Store<InternalRivetKitStore<Registry, Actors>, (cb: InternalRivetKitStore<Registry, Actors>) => InternalRivetKitStore<Registry, Actors>>;
+};
+export { type ActorOptions, type ActorsStateDerived, type AnyActorOptions, type AnyActorRegistry, type CreateRivetKitOptions, createRivetKit };

package/dist/mod.d.ts CHANGED Viewed

@@ -1,7 +1,10 @@
-import { AnyActorDefinition, Registry } from '@rivetkit/core';
-import { ActorConn, ActorHandle, Client, ExtractActorsFromRegistry } from '@rivetkit/core/client';
-import { Derived, Store, Updater } from '@tanstack/store';
-export type AnyActorRegistry = Registry<any>;
+import { Derived, Store } from '@tanstack/store';
+import { Registry, AnyActorDefinition } from 'rivetkit';
+import { ExtractActorsFromRegistry, ActorHandle, ActorConn, ActorConnStatus, Client } from 'rivetkit/client';
+export { ActorConnStatus } from 'rivetkit/client';
+type AnyActorRegistry = Registry<any>;
 interface ActorStateReference<AD extends AnyActorDefinition> {
     /**
      * The unique identifier for the actor.
@@ -21,17 +24,9 @@ interface ActorStateReference<AD extends AnyActorDefinition> {
      */
     connection: ActorConn<AD> | null;
     /**
-     * Whether the actor is enabled.
-     */
-    isConnected?: boolean;
-    /**
-     * Whether the actor is currently connecting, indicating that a connection attempt is in progress.
+     * The connection status of the actor.
      */
-    isConnecting?: boolean;
-    /**
-     * Whether there was an error connecting to the actor.
-     */
-    isError?: boolean;
+    connStatus: ActorConnStatus;
     /**
      * The error that occurred while trying to connect to the actor, if any.
      */
@@ -61,6 +56,12 @@ interface ActorStateReference<AD extends AnyActorDefinition> {
          * Defaults to true.
          */
         enabled?: boolean;
+        /**
+         * If true, only gets the actor if it already exists. Does not create the actor.
+         * Throws an error if the actor is not found.
+         * Defaults to false.
+         */
+        noCreate?: boolean;
     };
 }
 interface InternalRivetKitStore<Registry extends AnyActorRegistry, Actors extends ExtractActorsFromRegistry<Registry>> {
@@ -69,7 +70,7 @@ interface InternalRivetKitStore<Registry extends AnyActorRegistry, Actors extend
 /**
  * Options for configuring a actor in RivetKit.
  */
-export interface ActorOptions<Registry extends AnyActorRegistry, ActorName extends keyof ExtractActorsFromRegistry<Registry>> {
+interface ActorOptions<Registry extends AnyActorRegistry, ActorName extends keyof ExtractActorsFromRegistry<Registry>> {
     /**
      * Typesafe name of the actor.
      * This should match the actor's name in the app's actor definitions.
@@ -95,24 +96,37 @@ export interface ActorOptions<Registry extends AnyActorRegistry, ActorName exten
      * Defaults to true.
      */
     enabled?: boolean;
+    /**
+     * If true, only gets the actor if it already exists. Does not create the actor.
+     * Throws an error if the actor is not found.
+     * Defaults to false.
+     */
+    noCreate?: boolean;
 }
-export type ActorsStateDerived<Registry extends AnyActorRegistry, WorkerName extends keyof ExtractActorsFromRegistry<Registry>> = Derived<Omit<InternalRivetKitStore<Registry, ExtractActorsFromRegistry<Registry>>["actors"][string], "handle" | "connection"> & {
+type ActorsStateDerived<Registry extends AnyActorRegistry, WorkerName extends keyof ExtractActorsFromRegistry<Registry>> = Derived<Omit<InternalRivetKitStore<Registry, ExtractActorsFromRegistry<Registry>>["actors"][string], "handle" | "connection"> & {
     handle: ActorHandle<ExtractActorsFromRegistry<Registry>[WorkerName]> | null;
     connection: ActorConn<ExtractActorsFromRegistry<Registry>[WorkerName]> | null;
+    /** @deprecated Use `connStatus === "connected"` instead */
+    isConnected: boolean;
 }>;
-export type AnyActorOptions = ActorOptions<AnyActorRegistry, any>;
-export interface CreateRivetKitOptions<Registry extends AnyActorRegistry> {
+type AnyActorOptions = ActorOptions<AnyActorRegistry, any>;
+interface CreateRivetKitOptions<Registry extends AnyActorRegistry> {
     hashFunction?: (opts: ActorOptions<Registry, any>) => string;
 }
-export declare function createRivetKit<Registry extends AnyActorRegistry, Actors extends ExtractActorsFromRegistry<Registry>, ActorNames extends keyof Actors>(client: Client<Registry>, opts?: CreateRivetKitOptions<Registry>): {
-    getOrCreateActor: <ActorName extends ActorNames>(opts: ActorOptions<Registry, ActorName>) => {
+declare function createRivetKit<Registry extends AnyActorRegistry, Actors extends ExtractActorsFromRegistry<Registry>>(client: Client<Registry>, createOpts?: CreateRivetKitOptions<Registry>): {
+    getOrCreateActor: <ActorName extends keyof Actors>(actorOpts: ActorOptions<Registry, ActorName>) => {
         state: ActorsStateDerived<Registry, ActorName>;
         key: string;
-        mount: () => void;
-        setState: (set: Updater<ActorStateReference<Actors>>) => void;
+        mount: () => () => void;
         create: () => void;
-        addEventListener?: (event: string, handler: (...args: any[]) => void) => void;
+        refCount: number;
+        cleanupTimeout: ReturnType<typeof setTimeout> | null;
+    } | {
+        mount: () => () => void;
+        state: ActorsStateDerived<Registry, ActorName>;
+        key: string;
     };
     store: Store<InternalRivetKitStore<Registry, Actors>, (cb: InternalRivetKitStore<Registry, Actors>) => InternalRivetKitStore<Registry, Actors>>;
 };
-export {};
+export { type ActorOptions, type ActorsStateDerived, type AnyActorOptions, type AnyActorRegistry, type CreateRivetKitOptions, createRivetKit };

package/dist/mod.js CHANGED Viewed

@@ -1,298 +1,241 @@
-const p = /* @__PURE__ */ new WeakMap(), S = /* @__PURE__ */ new WeakMap(), g = {
-  current: []
-};
-let b = !1;
-const v = /* @__PURE__ */ new Set(), k = /* @__PURE__ */ new Map();
-function C(i) {
-  const n = Array.from(i).sort((t, e) => t instanceof f && t.options.deps.includes(e) ? 1 : e instanceof f && e.options.deps.includes(t) ? -1 : 0);
-  for (const t of n) {
-    if (g.current.includes(t))
-      continue;
-    g.current.push(t), t.recompute();
-    const e = S.get(t);
-    if (e)
-      for (const s of e) {
-        const o = p.get(s);
-        o && C(o);
-      }
-  }
-}
-function F(i) {
-  i.listeners.forEach(
-    (n) => n({
-      prevVal: i.prevState,
-      currentVal: i.state
-    })
-  );
-}
-function O(i) {
-  i.listeners.forEach(
-    (n) => n({
-      prevVal: i.prevState,
-      currentVal: i.state
-    })
-  );
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/mod.ts
+var _store = require('@tanstack/store');
+var _fastdeepequal = require('fast-deep-equal'); var _fastdeepequal2 = _interopRequireDefault(_fastdeepequal);
+require('rivetkit/client');
+function createRivetKit(client, createOpts = {}) {
+  const store = new (0, _store.Store)({
+    actors: {}
+  });
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    getOrCreateActor: (actorOpts) => getOrCreateActor(client, createOpts, store, cache, actorOpts),
+    store
+  };
 }
-function G(i) {
-  if (v.add(i), !b)
-    try {
-      for (b = !0; v.size > 0; ) {
-        const n = Array.from(v);
-        v.clear();
-        for (const t of n) {
-          const e = k.get(t) ?? t.prevState;
-          t.prevState = e, F(t);
-        }
-        for (const t of n) {
-          const e = p.get(t);
-          e && (g.current.push(t), C(e));
-        }
-        for (const t of n) {
-          const e = p.get(t);
-          if (e)
-            for (const s of e)
-              O(s);
-        }
-      }
-    } finally {
-      b = !1, g.current = [], k.clear();
+function updateActor(store, key, updates) {
+  store.setState((prev) => ({
+    ...prev,
+    actors: {
+      ...prev.actors,
+      [key]: { ...prev.actors[key], ...updates }
     }
+  }));
 }
-function I(i) {
-  return typeof i == "function";
-}
-class m {
-  constructor(n, t) {
-    this.listeners = /* @__PURE__ */ new Set(), this.subscribe = (e) => {
-      var s, o;
-      this.listeners.add(e);
-      const h = (o = (s = this.options) == null ? void 0 : s.onSubscribe) == null ? void 0 : o.call(s, e, this);
-      return () => {
-        this.listeners.delete(e), h == null || h();
-      };
-    }, this.prevState = n, this.state = n, this.options = t;
-  }
-  setState(n) {
-    var t, e, s;
-    this.prevState = this.state, (t = this.options) != null && t.updateFn ? this.state = this.options.updateFn(this.prevState)(n) : I(n) ? this.state = n(this.prevState) : this.state = n, (s = (e = this.options) == null ? void 0 : e.onUpdate) == null || s.call(e), G(this);
-  }
-}
-class f {
-  constructor(n) {
-    this.listeners = /* @__PURE__ */ new Set(), this._subscriptions = [], this.lastSeenDepValues = [], this.getDepVals = () => {
-      const t = [], e = [];
-      for (const s of this.options.deps)
-        t.push(s.prevState), e.push(s.state);
-      return this.lastSeenDepValues = e, {
-        prevDepVals: t,
-        currDepVals: e,
-        prevVal: this.prevState ?? void 0
-      };
-    }, this.recompute = () => {
-      var t, e;
-      this.prevState = this.state;
-      const { prevDepVals: s, currDepVals: o, prevVal: h } = this.getDepVals();
-      this.state = this.options.fn({
-        prevDepVals: s,
-        currDepVals: o,
-        prevVal: h
-      }), (e = (t = this.options).onUpdate) == null || e.call(t);
-    }, this.checkIfRecalculationNeededDeeply = () => {
-      for (const o of this.options.deps)
-        o instanceof f && o.checkIfRecalculationNeededDeeply();
-      let t = !1;
-      const e = this.lastSeenDepValues, { currDepVals: s } = this.getDepVals();
-      for (let o = 0; o < s.length; o++)
-        if (s[o] !== e[o]) {
-          t = !0;
-          break;
+function getOrCreateActor(client, createOpts, store, cache, actorOpts) {
+  const hash = createOpts.hashFunction || defaultHashFunction;
+  const normalizedOpts = {
+    ...actorOpts,
+    enabled: _nullishCoalesce(actorOpts.enabled, () => ( true))
+  };
+  const key = hash(normalizedOpts);
+  const existing = store.state.actors[key];
+  if (!existing) {
+    store.setState((prev) => ({
+      ...prev,
+      actors: {
+        ...prev.actors,
+        [key]: {
+          hash: key,
+          connStatus: "idle",
+          connection: null,
+          handle: null,
+          error: null,
+          opts: normalizedOpts
         }
-      t && this.recompute();
-    }, this.mount = () => (this.registerOnGraph(), this.checkIfRecalculationNeededDeeply(), () => {
-      this.unregisterFromGraph();
-      for (const t of this._subscriptions)
-        t();
-    }), this.subscribe = (t) => {
-      var e, s;
-      this.listeners.add(t);
-      const o = (s = (e = this.options).onSubscribe) == null ? void 0 : s.call(e, t, this);
-      return () => {
-        this.listeners.delete(t), o == null || o();
-      };
-    }, this.options = n, this.state = n.fn({
-      prevDepVals: void 0,
-      prevVal: void 0,
-      currDepVals: this.getDepVals().currDepVals
-    });
-  }
-  registerOnGraph(n = this.options.deps) {
-    for (const t of n)
-      if (t instanceof f)
-        t.registerOnGraph(), this.registerOnGraph(t.options.deps);
-      else if (t instanceof m) {
-        let e = p.get(t);
-        e || (e = /* @__PURE__ */ new Set(), p.set(t, e)), e.add(this);
-        let s = S.get(this);
-        s || (s = /* @__PURE__ */ new Set(), S.set(this, s)), s.add(t);
-      }
-  }
-  unregisterFromGraph(n = this.options.deps) {
-    for (const t of n)
-      if (t instanceof f)
-        this.unregisterFromGraph(t.options.deps);
-      else if (t instanceof m) {
-        const e = p.get(t);
-        e && e.delete(this);
-        const s = S.get(this);
-        s && s.delete(t);
       }
+    }));
+  } else if (!optsEqual(existing.opts, normalizedOpts)) {
+    queueMicrotask(() => {
+      updateActor(store, key, { opts: normalizedOpts });
+    });
   }
-}
-class R {
-  constructor(n) {
-    const { eager: t, fn: e, ...s } = n;
-    this._derived = new f({
-      ...s,
-      fn: () => {
-      },
-      onUpdate() {
-        e();
-      }
-    }), t && e();
-  }
-  mount() {
-    return this._derived.mount();
+  const cached = cache.get(key);
+  if (cached) {
+    return {
+      ...cached,
+      state: cached.state
+    };
   }
-}
-function N(i, n = {}) {
-  const t = new m({
-    actors: {}
-  }), e = n.hashFunction || L, s = /* @__PURE__ */ new Map();
-  function o(h) {
-    const r = e(h), _ = s.get(r);
-    if (_)
+  const derived = new (0, _store.Derived)({
+    fn: ({ currDepVals: [store2] }) => {
+      const actor = store2.actors[key];
       return {
-        ..._,
-        state: _.state
+        ...actor,
+        /** @deprecated Use `connStatus === "connected"` instead */
+        isConnected: actor.connStatus === "connected"
       };
-    const d = new f({
-      fn: ({ currDepVals: [a] }) => a.actors[r],
-      deps: [t]
-    });
-    function V() {
-      async function a() {
-        const c = t.state.actors[r];
-        try {
-          const u = i.getOrCreate(
-            c.opts.name,
-            c.opts.key,
-            {
-              params: c.opts.params,
-              createInRegion: c.opts.createInRegion,
-              createWithInput: c.opts.createWithInput
-            }
-          ), l = u.connect();
-          await u.resolve(
-            /*{ signal: AbortSignal.timeout(0) }*/
-          ), t.setState((D) => ({
-            ...D,
-            actors: {
-              ...D.actors,
-              [r]: {
-                ...D.actors[r],
-                isConnected: !0,
-                isConnecting: !1,
-                handle: u,
-                connection: l,
-                isError: !1,
-                error: null
-              }
-            }
-          }));
-        } catch (u) {
-          t.setState((l) => ({
-            ...l,
-            actors: {
-              ...l.actors,
-              [r]: {
-                ...l.actors[r],
-                isError: !0,
-                isConnecting: !1,
-                error: u
-              }
-            }
-          }));
-        }
+    },
+    deps: [store]
+  });
+  const effect = new (0, _store.Effect)({
+    fn: () => {
+      const actor = store.state.actors[key];
+      if (!actor) {
+        throw new Error(
+          `Actor with key "${key}" not found in store. This indicates a bug in cleanup logic.`
+        );
       }
-      t.setState((c) => (c.actors[r].isConnecting = !0, c.actors[r].isError = !1, c.actors[r].error = null, a(), c));
-    }
-    const E = new R({
-      fn: () => {
-        const a = t.state.actors[r];
-        JSON.stringify(t.prevState.actors[r].opts) === JSON.stringify(t.state.actors[r].opts) && !a.isConnected && !a.isConnecting && !a.isError && a.opts.enabled && V();
-      },
-      deps: [d]
-    });
-    t.setState((a) => a.actors[r] ? a : {
-      ...a,
-      actors: {
-        ...a.actors,
-        [r]: {
-          hash: r,
-          isConnected: !1,
-          isConnecting: !1,
+      if (!actor.opts.enabled && actor.connection) {
+        actor.connection.dispose();
+        updateActor(store, key, {
           connection: null,
           handle: null,
-          isError: !1,
-          error: null,
-          opts: h
-        }
+          connStatus: "idle"
+        });
+        return;
+      }
+      if (actor.connStatus === "idle" && actor.opts.enabled) {
+        queueMicrotask(() => {
+          const currentActor = store.state.actors[key];
+          if (currentActor && currentActor.connStatus === "idle" && currentActor.opts.enabled) {
+            create(client, store, key);
+          }
+        });
+      }
+    },
+    deps: [derived]
+  });
+  let unsubscribeDerived = null;
+  let unsubscribeEffect = null;
+  const mount = () => {
+    const cached2 = cache.get(key);
+    if (!cached2) {
+      throw new Error(
+        `Actor with key "${key}" not found in cache. This indicates a bug in cleanup logic.`
+      );
+    }
+    if (cached2.cleanupTimeout !== null) {
+      clearTimeout(cached2.cleanupTimeout);
+      cached2.cleanupTimeout = null;
+    }
+    cached2.refCount++;
+    if (cached2.refCount === 1) {
+      unsubscribeDerived = derived.mount();
+      unsubscribeEffect = effect.mount();
+      const actor = store.state.actors[key];
+      if (actor && actor.opts.enabled && actor.connStatus === "idle") {
+        create(client, store, key);
+      }
+    }
+    return () => {
+      cached2.refCount--;
+      if (cached2.refCount === 0) {
+        cached2.cleanupTimeout = setTimeout(() => {
+          cached2.cleanupTimeout = null;
+          if (cached2.refCount > 0) return;
+          unsubscribeDerived == null ? void 0 : unsubscribeDerived();
+          unsubscribeEffect == null ? void 0 : unsubscribeEffect();
+          unsubscribeDerived = null;
+          unsubscribeEffect = null;
+          const actor = store.state.actors[key];
+          if (actor == null ? void 0 : actor.connection) {
+            actor.connection.dispose();
+          }
+          store.setState((prev) => {
+            const { [key]: _, ...rest } = prev.actors;
+            return { ...prev, actors: rest };
+          });
+          cache.delete(key);
+        }, 0);
+      }
+    };
+  };
+  cache.set(key, {
+    state: derived,
+    key,
+    mount,
+    create: create.bind(void 0, client, store, key),
+    refCount: 0,
+    cleanupTimeout: null
+  });
+  return {
+    mount,
+    state: derived,
+    key
+  };
+}
+function create(client, store, key) {
+  const actor = store.state.actors[key];
+  if (!actor) {
+    throw new Error(
+      `Actor with key "${key}" not found in store. This indicates a bug in cleanup logic.`
+    );
+  }
+  updateActor(store, key, {
+    connStatus: "connecting",
+    error: null
+  });
+  try {
+    const handle = actor.opts.noCreate ? client.get(
+      actor.opts.name,
+      actor.opts.key,
+      {
+        params: actor.opts.params
+      }
+    ) : client.getOrCreate(
+      actor.opts.name,
+      actor.opts.key,
+      {
+        params: actor.opts.params,
+        createInRegion: actor.opts.createInRegion,
+        createWithInput: actor.opts.createWithInput
       }
+    );
+    const connection = handle.connect();
+    updateActor(store, key, {
+      handle,
+      connection
     });
-    function w(a) {
-      t.setState((c) => {
-        const u = c.actors[r];
-        if (!u)
-          throw new Error(`Actor with key "${r}" does not exist.`);
-        let l;
-        return typeof a == "function" ? l = a(u) : l = a, {
-          ...c,
+    connection.onStatusChange((status) => {
+      store.setState((prev) => {
+        var _a;
+        const isActiveConnection = ((_a = prev.actors[key]) == null ? void 0 : _a.connection) === connection;
+        if (!isActiveConnection) return prev;
+        return {
+          ...prev,
           actors: {
-            ...c.actors,
-            [r]: l
+            ...prev.actors,
+            [key]: {
+              ...prev.actors[key],
+              connStatus: status,
+              // Only clear error when successfully connected
+              ...status === "connected" ? { error: null } : {}
+            }
           }
         };
       });
-    }
-    const y = () => {
-      const a = d.mount(), c = E.mount();
-      return () => {
-        a(), c();
-      };
-    };
-    return s.set(r, {
-      state: d,
-      key: r,
-      mount: y,
-      setState: w,
-      create: V,
-      addEventListener
-    }), {
-      mount: y,
-      setState: w,
-      state: d,
-      create: V,
-      key: r
-    };
+    });
+    connection.onError((error) => {
+      store.setState((prev) => {
+        var _a;
+        if (((_a = prev.actors[key]) == null ? void 0 : _a.connection) !== connection) return prev;
+        return {
+          ...prev,
+          actors: {
+            ...prev.actors,
+            [key]: {
+              ...prev.actors[key],
+              error
+            }
+          }
+        };
+      });
+    });
+  } catch (error) {
+    console.error("Failed to create actor connection", error);
+    updateActor(store, key, {
+      connStatus: "disconnected",
+      error
+    });
   }
-  return {
-    getOrCreateActor: o,
-    store: t
-  };
 }
-function L({ name: i, key: n, params: t }) {
-  return JSON.stringify({ name: i, key: n, params: t });
+function defaultHashFunction({ name, key, params, noCreate }) {
+  return JSON.stringify({ name, key, params, noCreate });
+}
+function optsEqual(a, b) {
+  return _fastdeepequal2.default.call(void 0, a, b);
 }
-export {
-  N as createRivetKit
-};
+exports.createRivetKit = createRivetKit;
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["/home/runner/work/rivet/rivet/rivetkit-typescript/packages/framework-base/dist/mod.js","../src/mod.ts"],"names":["store","cached"],"mappings":"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","file":"/home/runner/work/rivet/rivet/rivetkit-typescript/packages/framework-base/dist/mod.js","sourcesContent":[null,"import { Derived, Effect, Store } from \"@tanstack/store\";\nimport equal from \"fast-deep-equal\";\nimport type { AnyActorDefinition, Registry } from \"rivetkit\";\nimport {\n\ttype ActorConn,\n\ttype ActorConnStatus,\n\ttype ActorHandle,\n\ttype Client,\n\ttype ExtractActorsFromRegistry,\n} from \"rivetkit/client\";\n\nexport type AnyActorRegistry = Registry<any>;\n\nexport type { ActorConnStatus };\n\ninterface ActorStateReference<AD extends AnyActorDefinition> {\n\t/**\n\t * The unique identifier for the actor.\n\t * This is a hash generated from the actor's options.\n\t * It is used to identify the actor instance in the store.\n\t * @internal\n\t */\n\thash: string;\n\t/**\n\t * The state of the actor, derived from the store.\n\t * This includes the actor's connection and handle.\n\t */\n\thandle: ActorHandle<AD> | null;\n\t/**\n\t * The connection to the actor.\n\t * This is used to communicate with the actor in realtime.\n\t */\n\tconnection: ActorConn<AD> | null;\n\t/**\n\t * The connection status of the actor.\n\t */\n\tconnStatus: ActorConnStatus;\n\t/**\n\t * The error that occurred while trying to connect to the actor, if any.\n\t */\n\terror: Error | null;\n\t/**\n\t * Options for the actor, including its name, key, parameters, and whether it is enabled.\n\t */\n\topts: {\n\t\tname: keyof AD;\n\t\t/**\n\t\t * Unique key for the actor instance.\n\t\t * This can be a string or an array of strings to create multiple instances.\n\t\t * @example \"abc\" or [\"abc\", \"def\"]\n\t\t */\n\t\tkey: string | string[];\n\t\t/**\n\t\t * Parameters for the actor.\n\t\t * These are additional options that can be passed to the actor.\n\t\t */\n\t\tparams?: Record<string, string>;\n\t\t/** Region to create the actor in if it doesn't exist. */\n\t\tcreateInRegion?: string;\n\t\t/** Input data to pass to the actor. */\n\t\tcreateWithInput?: unknown;\n\t\t/**\n\t\t * Whether the actor is enabled.\n\t\t * Defaults to true.\n\t\t */\n\t\tenabled?: boolean;\n\t\t/**\n\t\t * If true, only gets the actor if it already exists. Does not create the actor.\n\t\t * Throws an error if the actor is not found.\n\t\t * Defaults to false.\n\t\t */\n\t\tnoCreate?: boolean;\n\t};\n}\n\ninterface InternalRivetKitStore<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> {\n\tactors: Record<string, ActorStateReference<Actors>>;\n}\n\n/**\n * Options for configuring a actor in RivetKit.\n */\nexport interface ActorOptions<\n\tRegistry extends AnyActorRegistry,\n\tActorName extends keyof ExtractActorsFromRegistry<Registry>,\n> {\n\t/**\n\t * Typesafe name of the actor.\n\t * This should match the actor's name in the app's actor definitions.\n\t * @example \"chatRoom\"\n\t */\n\tname: ActorName;\n\t/**\n\t * Unique key for the actor instance.\n\t * This can be a string or an array of strings to create multiple instances.\n\t * @example \"abc\" or [\"abc\", \"def\"]\n\t */\n\tkey: string | string[];\n\t/**\n\t * Parameters for the actor.\n\t */\n\tparams?: Registry[ExtractActorsFromRegistry<Registry>][\"params\"];\n\t/** Region to create the actor in if it doesn't exist. */\n\tcreateInRegion?: string;\n\t/** Input data to pass to the actor. */\n\tcreateWithInput?: unknown;\n\t/**\n\t * Whether the actor is enabled.\n\t * Defaults to true.\n\t */\n\tenabled?: boolean;\n\t/**\n\t * If true, only gets the actor if it already exists. Does not create the actor.\n\t * Throws an error if the actor is not found.\n\t * Defaults to false.\n\t */\n\tnoCreate?: boolean;\n}\n\nexport type ActorsStateDerived<\n\tRegistry extends AnyActorRegistry,\n\tWorkerName extends keyof ExtractActorsFromRegistry<Registry>,\n> = Derived<\n\tOmit<\n\t\tInternalRivetKitStore<\n\t\t\tRegistry,\n\t\t\tExtractActorsFromRegistry<Registry>\n\t\t>[\"actors\"][string],\n\t\t\"handle\" | \"connection\"\n\t> & {\n\t\thandle: ActorHandle<\n\t\t\tExtractActorsFromRegistry<Registry>[WorkerName]\n\t\t> | null;\n\t\tconnection: ActorConn<\n\t\t\tExtractActorsFromRegistry<Registry>[WorkerName]\n\t\t> | null;\n\t\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\t\tisConnected: boolean;\n\t}\n>;\n\nexport type AnyActorOptions = ActorOptions<AnyActorRegistry, any>;\n\nexport interface CreateRivetKitOptions<Registry extends AnyActorRegistry> {\n\thashFunction?: (opts: ActorOptions<Registry, any>) => string;\n}\n\ntype ComputedActorState<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = InternalRivetKitStore<Registry, Actors>[\"actors\"][string] & {\n\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\tisConnected: boolean;\n};\n\ntype ActorCache<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = Map<\n\tstring,\n\t{\n\t\tstate: Derived<ComputedActorState<Registry, Actors>>;\n\t\tkey: string;\n\t\tmount: () => () => void;\n\t\tcreate: () => void;\n\t\trefCount: number;\n\t\tcleanupTimeout: ReturnType<typeof setTimeout> | null;\n\t}\n>;\n\nexport function createRivetKit<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n>(client: Client<Registry>, createOpts: CreateRivetKitOptions<Registry> = {}) {\n\tconst store = new Store<InternalRivetKitStore<Registry, Actors>>({\n\t\tactors: {},\n\t});\n\n\tconst cache: ActorCache<Registry, Actors> = new Map();\n\n\treturn {\n\t\tgetOrCreateActor: <ActorName extends keyof Actors>(\n\t\t\tactorOpts: ActorOptions<Registry, ActorName>,\n\t\t) => getOrCreateActor(client, createOpts, store, cache, actorOpts),\n\t\tstore,\n\t};\n}\n\ntype ActorUpdates<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = Partial<InternalRivetKitStore<Registry, Actors>[\"actors\"][string]>;\n\nfunction updateActor<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n>(\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tkey: string,\n\tupdates: ActorUpdates<Registry, Actors>,\n) {\n\tstore.setState((prev) => ({\n\t\t...prev,\n\t\tactors: {\n\t\t\t...prev.actors,\n\t\t\t[key]: { ...prev.actors[key], ...updates },\n\t\t},\n\t}));\n}\n\n// See README.md for lifecycle documentation.\nfunction getOrCreateActor<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n\tActorName extends keyof Actors,\n>(\n\tclient: Client<Registry>,\n\tcreateOpts: CreateRivetKitOptions<Registry>,\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tcache: ActorCache<Registry, Actors>,\n\tactorOpts: ActorOptions<Registry, ActorName>,\n) {\n\tconst hash = createOpts.hashFunction || defaultHashFunction;\n\n\tconst normalizedOpts = {\n\t\t...actorOpts,\n\t\tenabled: actorOpts.enabled ?? true,\n\t};\n\n\tconst key = hash(normalizedOpts);\n\n\t// Sync opts to store on every call (even for cached entries)\n\t// Use queueMicrotask for updates to avoid \"Cannot update a component while rendering\" React error\n\tconst existing = store.state.actors[key];\n\tif (!existing) {\n\t\tstore.setState((prev) => ({\n\t\t\t...prev,\n\t\t\tactors: {\n\t\t\t\t...prev.actors,\n\t\t\t\t[key]: {\n\t\t\t\t\thash: key,\n\t\t\t\t\tconnStatus: \"idle\",\n\t\t\t\t\tconnection: null,\n\t\t\t\t\thandle: null,\n\t\t\t\t\terror: null,\n\t\t\t\t\topts: normalizedOpts,\n\t\t\t\t},\n\t\t\t},\n\t\t}));\n\t} else if (!optsEqual(existing.opts, normalizedOpts)) {\n\t\t// Defer opts update to avoid triggering re-render during render\n\t\tqueueMicrotask(() => {\n\t\t\tupdateActor(store, key, { opts: normalizedOpts });\n\t\t});\n\t}\n\n\tconst cached = cache.get(key);\n\tif (cached) {\n\t\treturn {\n\t\t\t...cached,\n\t\t\tstate: cached.state as ActorsStateDerived<Registry, ActorName>,\n\t\t};\n\t}\n\n\tconst derived = new Derived({\n\t\tfn: ({ currDepVals: [store] }) => {\n\t\t\tconst actor = store.actors[key];\n\t\t\treturn {\n\t\t\t\t...actor,\n\t\t\t\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\t\t\t\tisConnected: actor.connStatus === \"connected\",\n\t\t\t};\n\t\t},\n\t\tdeps: [store],\n\t});\n\n\t// Handle enabled/disabled state changes.\n\t// Initial connection is triggered directly in mount() since Effect\n\t// only runs on state changes, not on mount.\n\tconst effect = new Effect({\n\t\tfn: () => {\n\t\t\tconst actor = store.state.actors[key];\n\t\t\tif (!actor) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Actor with key \"${key}\" not found in store. This indicates a bug in cleanup logic.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Dispose connection if disabled\n\t\t\tif (!actor.opts.enabled && actor.connection) {\n\t\t\t\tactor.connection.dispose();\n\n\t\t\t\t// Reset state so re-enabling will reconnect\n\t\t\t\tupdateActor(store, key, {\n\t\t\t\t\tconnection: null,\n\t\t\t\t\thandle: null,\n\t\t\t\t\tconnStatus: \"idle\",\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Reconnect when re-enabled after being disabled\n\t\t\t// Defer to avoid \"Cannot update a component while rendering\" React error\n\t\t\tif (\n\t\t\t\tactor.connStatus === \"idle\" &&\n\t\t\t\tactor.opts.enabled\n\t\t\t) {\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// Re-check state after microtask in case it changed\n\t\t\t\t\tconst currentActor = store.state.actors[key];\n\t\t\t\t\tif (\n\t\t\t\t\t\tcurrentActor &&\n\t\t\t\t\t\tcurrentActor.connStatus === \"idle\" &&\n\t\t\t\t\t\tcurrentActor.opts.enabled\n\t\t\t\t\t) {\n\t\t\t\t\t\tcreate<Registry, Actors, ActorName>(client, store, key);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t\tdeps: [derived],\n\t});\n\n\t// Track subscriptions for ref counting\n\tlet unsubscribeDerived: (() => void) | null = null;\n\tlet unsubscribeEffect: (() => void) | null = null;\n\n\tconst mount = () => {\n\t\tconst cached = cache.get(key);\n\t\tif (!cached) {\n\t\t\tthrow new Error(\n\t\t\t\t`Actor with key \"${key}\" not found in cache. This indicates a bug in cleanup logic.`,\n\t\t\t);\n\t\t}\n\n\t\t// Cancel pending cleanup\n\t\tif (cached.cleanupTimeout !== null) {\n\t\t\tclearTimeout(cached.cleanupTimeout);\n\t\t\tcached.cleanupTimeout = null;\n\t\t}\n\n\t\t// Increment ref count\n\t\tcached.refCount++;\n\n\t\t// Mount derived/effect on first reference (or re-mount after cleanup)\n\t\tif (cached.refCount === 1) {\n\t\t\tunsubscribeDerived = derived.mount();\n\t\t\tunsubscribeEffect = effect.mount();\n\n\t\t\t// Effect doesn't run immediately on mount, only on state changes.\n\t\t\t// Trigger initial connection if actor is enabled and idle.\n\t\t\tconst actor = store.state.actors[key];\n\t\t\tif (\n\t\t\t\tactor &&\n\t\t\t\tactor.opts.enabled &&\n\t\t\t\tactor.connStatus === \"idle\"\n\t\t\t) {\n\t\t\t\tcreate<Registry, Actors, ActorName>(client, store, key);\n\t\t\t}\n\t\t}\n\n\t\treturn () => {\n\t\t\t// Decrement ref count\n\t\t\tcached.refCount--;\n\n\t\t\tif (cached.refCount === 0) {\n\t\t\t\t// Deferred cleanup prevents needless reconnection when:\n\t\t\t\t// - React Strict Mode's unmount/remount cycle\n\t\t\t\t// - useActor hook moves between components in the same render cycle\n\t\t\t\tcached.cleanupTimeout = setTimeout(() => {\n\t\t\t\t\tcached.cleanupTimeout = null;\n\t\t\t\t\tif (cached.refCount > 0) return;\n\n\t\t\t\t\t// Unsubscribe from derived/effect\n\t\t\t\t\tunsubscribeDerived?.();\n\t\t\t\t\tunsubscribeEffect?.();\n\t\t\t\t\tunsubscribeDerived = null;\n\t\t\t\t\tunsubscribeEffect = null;\n\n\t\t\t\t\t// Dispose connection\n\t\t\t\t\tconst actor = store.state.actors[key];\n\t\t\t\t\tif (actor?.connection) {\n\t\t\t\t\t\tactor.connection.dispose();\n\t\t\t\t\t}\n\n\t\t\t\t\t// Remove from store and cache\n\t\t\t\t\tstore.setState((prev) => {\n\t\t\t\t\t\tconst { [key]: _, ...rest } = prev.actors;\n\t\t\t\t\t\treturn { ...prev, actors: rest };\n\t\t\t\t\t});\n\t\t\t\t\tcache.delete(key);\n\t\t\t\t}, 0);\n\t\t\t}\n\t\t};\n\t};\n\n\tcache.set(key, {\n\t\tstate: derived,\n\t\tkey,\n\t\tmount,\n\t\tcreate: create.bind(undefined, client, store, key),\n\t\trefCount: 0,\n\t\tcleanupTimeout: null,\n\t});\n\n\treturn {\n\t\tmount,\n\t\tstate: derived as ActorsStateDerived<Registry, ActorName>,\n\t\tkey,\n\t};\n}\n\nfunction create<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n\tActorName extends keyof Actors,\n>(\n\tclient: Client<Registry>,\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tkey: string,\n) {\n\tconst actor = store.state.actors[key];\n\tif (!actor) {\n\t\tthrow new Error(\n\t\t\t`Actor with key \"${key}\" not found in store. This indicates a bug in cleanup logic.`,\n\t\t);\n\t}\n\n\t// Save actor to map\n\tupdateActor(store, key, {\n\t\tconnStatus: \"connecting\",\n\t\terror: null,\n\t});\n\n\ttry {\n\t\tconst handle = actor.opts.noCreate\n\t\t\t? client.get(\n\t\t\t\t\tactor.opts.name as string,\n\t\t\t\t\tactor.opts.key,\n\t\t\t\t\t{\n\t\t\t\t\t\tparams: actor.opts.params,\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t: client.getOrCreate(\n\t\t\t\t\tactor.opts.name as string,\n\t\t\t\t\tactor.opts.key,\n\t\t\t\t\t{\n\t\t\t\t\t\tparams: actor.opts.params,\n\t\t\t\t\t\tcreateInRegion: actor.opts.createInRegion,\n\t\t\t\t\t\tcreateWithInput: actor.opts.createWithInput,\n\t\t\t\t\t},\n\t\t\t\t);\n\n\t\tconst connection = handle.connect();\n\n\t\t// Store connection BEFORE registering callbacks to avoid race condition\n\t\t// where status change fires before connection is stored\n\t\tupdateActor(store, key, {\n\t\t\thandle: handle as ActorHandle<Actors[ActorName]>,\n\t\t\tconnection: connection as ActorConn<Actors[ActorName]>,\n\t\t});\n\n\t\t// Subscribe to connection state changes\n\t\tconnection.onStatusChange((status) => {\n\t\t\tstore.setState((prev) => {\n\t\t\t\t// Only update if this is still the active connection\n\t\t\t\tconst isActiveConnection = prev.actors[key]?.connection === connection;\n\t\t\t\tif (!isActiveConnection) return prev;\n\t\t\t\treturn {\n\t\t\t\t\t...prev,\n\t\t\t\t\tactors: {\n\t\t\t\t\t\t...prev.actors,\n\t\t\t\t\t\t[key]: {\n\t\t\t\t\t\t\t...prev.actors[key],\n\t\t\t\t\t\t\tconnStatus: status,\n\t\t\t\t\t\t\t// Only clear error when successfully connected\n\t\t\t\t\t\t\t...(status === \"connected\"\n\t\t\t\t\t\t\t\t? { error: null }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t});\n\t\t});\n\n\t\t// onError is followed by onClose which will set connStatus to Disconnected\n\t\tconnection.onError((error) => {\n\t\t\tstore.setState((prev) => {\n\t\t\t\t// Only update if this is still the active connection\n\t\t\t\tif (prev.actors[key]?.connection !== connection) return prev;\n\t\t\t\treturn {\n\t\t\t\t\t...prev,\n\t\t\t\t\tactors: {\n\t\t\t\t\t\t...prev.actors,\n\t\t\t\t\t\t[key]: {\n\t\t\t\t\t\t\t...prev.actors[key],\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t});\n\t\t});\n\t} catch (error) {\n\t\tconsole.error(\"Failed to create actor connection\", error);\n\t\t// Use Disconnected so Effect won't auto-retry\n\t\t// User must re-enable or take action to retry\n\t\tupdateActor(store, key, {\n\t\t\tconnStatus: \"disconnected\",\n\t\t\terror: error as Error,\n\t\t});\n\t}\n}\n\nfunction defaultHashFunction({ name, key, params, noCreate }: AnyActorOptions) {\n\treturn JSON.stringify({ name, key, params, noCreate });\n}\n\nfunction optsEqual(a: AnyActorOptions, b: AnyActorOptions) {\n\treturn equal(a, b);\n}\n"]}

package/dist/mod.mjs ADDED Viewed

@@ -0,0 +1,241 @@
+// src/mod.ts
+import { Derived, Effect, Store } from "@tanstack/store";
+import equal from "fast-deep-equal";
+import "rivetkit/client";
+function createRivetKit(client, createOpts = {}) {
+  const store = new Store({
+    actors: {}
+  });
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    getOrCreateActor: (actorOpts) => getOrCreateActor(client, createOpts, store, cache, actorOpts),
+    store
+  };
+}
+function updateActor(store, key, updates) {
+  store.setState((prev) => ({
+    ...prev,
+    actors: {
+      ...prev.actors,
+      [key]: { ...prev.actors[key], ...updates }
+    }
+  }));
+}
+function getOrCreateActor(client, createOpts, store, cache, actorOpts) {
+  const hash = createOpts.hashFunction || defaultHashFunction;
+  const normalizedOpts = {
+    ...actorOpts,
+    enabled: actorOpts.enabled ?? true
+  };
+  const key = hash(normalizedOpts);
+  const existing = store.state.actors[key];
+  if (!existing) {
+    store.setState((prev) => ({
+      ...prev,
+      actors: {
+        ...prev.actors,
+        [key]: {
+          hash: key,
+          connStatus: "idle",
+          connection: null,
+          handle: null,
+          error: null,
+          opts: normalizedOpts
+        }
+      }
+    }));
+  } else if (!optsEqual(existing.opts, normalizedOpts)) {
+    queueMicrotask(() => {
+      updateActor(store, key, { opts: normalizedOpts });
+    });
+  }
+  const cached = cache.get(key);
+  if (cached) {
+    return {
+      ...cached,
+      state: cached.state
+    };
+  }
+  const derived = new Derived({
+    fn: ({ currDepVals: [store2] }) => {
+      const actor = store2.actors[key];
+      return {
+        ...actor,
+        /** @deprecated Use `connStatus === "connected"` instead */
+        isConnected: actor.connStatus === "connected"
+      };
+    },
+    deps: [store]
+  });
+  const effect = new Effect({
+    fn: () => {
+      const actor = store.state.actors[key];
+      if (!actor) {
+        throw new Error(
+          `Actor with key "${key}" not found in store. This indicates a bug in cleanup logic.`
+        );
+      }
+      if (!actor.opts.enabled && actor.connection) {
+        actor.connection.dispose();
+        updateActor(store, key, {
+          connection: null,
+          handle: null,
+          connStatus: "idle"
+        });
+        return;
+      }
+      if (actor.connStatus === "idle" && actor.opts.enabled) {
+        queueMicrotask(() => {
+          const currentActor = store.state.actors[key];
+          if (currentActor && currentActor.connStatus === "idle" && currentActor.opts.enabled) {
+            create(client, store, key);
+          }
+        });
+      }
+    },
+    deps: [derived]
+  });
+  let unsubscribeDerived = null;
+  let unsubscribeEffect = null;
+  const mount = () => {
+    const cached2 = cache.get(key);
+    if (!cached2) {
+      throw new Error(
+        `Actor with key "${key}" not found in cache. This indicates a bug in cleanup logic.`
+      );
+    }
+    if (cached2.cleanupTimeout !== null) {
+      clearTimeout(cached2.cleanupTimeout);
+      cached2.cleanupTimeout = null;
+    }
+    cached2.refCount++;
+    if (cached2.refCount === 1) {
+      unsubscribeDerived = derived.mount();
+      unsubscribeEffect = effect.mount();
+      const actor = store.state.actors[key];
+      if (actor && actor.opts.enabled && actor.connStatus === "idle") {
+        create(client, store, key);
+      }
+    }
+    return () => {
+      cached2.refCount--;
+      if (cached2.refCount === 0) {
+        cached2.cleanupTimeout = setTimeout(() => {
+          cached2.cleanupTimeout = null;
+          if (cached2.refCount > 0) return;
+          unsubscribeDerived == null ? void 0 : unsubscribeDerived();
+          unsubscribeEffect == null ? void 0 : unsubscribeEffect();
+          unsubscribeDerived = null;
+          unsubscribeEffect = null;
+          const actor = store.state.actors[key];
+          if (actor == null ? void 0 : actor.connection) {
+            actor.connection.dispose();
+          }
+          store.setState((prev) => {
+            const { [key]: _, ...rest } = prev.actors;
+            return { ...prev, actors: rest };
+          });
+          cache.delete(key);
+        }, 0);
+      }
+    };
+  };
+  cache.set(key, {
+    state: derived,
+    key,
+    mount,
+    create: create.bind(void 0, client, store, key),
+    refCount: 0,
+    cleanupTimeout: null
+  });
+  return {
+    mount,
+    state: derived,
+    key
+  };
+}
+function create(client, store, key) {
+  const actor = store.state.actors[key];
+  if (!actor) {
+    throw new Error(
+      `Actor with key "${key}" not found in store. This indicates a bug in cleanup logic.`
+    );
+  }
+  updateActor(store, key, {
+    connStatus: "connecting",
+    error: null
+  });
+  try {
+    const handle = actor.opts.noCreate ? client.get(
+      actor.opts.name,
+      actor.opts.key,
+      {
+        params: actor.opts.params
+      }
+    ) : client.getOrCreate(
+      actor.opts.name,
+      actor.opts.key,
+      {
+        params: actor.opts.params,
+        createInRegion: actor.opts.createInRegion,
+        createWithInput: actor.opts.createWithInput
+      }
+    );
+    const connection = handle.connect();
+    updateActor(store, key, {
+      handle,
+      connection
+    });
+    connection.onStatusChange((status) => {
+      store.setState((prev) => {
+        var _a;
+        const isActiveConnection = ((_a = prev.actors[key]) == null ? void 0 : _a.connection) === connection;
+        if (!isActiveConnection) return prev;
+        return {
+          ...prev,
+          actors: {
+            ...prev.actors,
+            [key]: {
+              ...prev.actors[key],
+              connStatus: status,
+              // Only clear error when successfully connected
+              ...status === "connected" ? { error: null } : {}
+            }
+          }
+        };
+      });
+    });
+    connection.onError((error) => {
+      store.setState((prev) => {
+        var _a;
+        if (((_a = prev.actors[key]) == null ? void 0 : _a.connection) !== connection) return prev;
+        return {
+          ...prev,
+          actors: {
+            ...prev.actors,
+            [key]: {
+              ...prev.actors[key],
+              error
+            }
+          }
+        };
+      });
+    });
+  } catch (error) {
+    console.error("Failed to create actor connection", error);
+    updateActor(store, key, {
+      connStatus: "disconnected",
+      error
+    });
+  }
+}
+function defaultHashFunction({ name, key, params, noCreate }) {
+  return JSON.stringify({ name, key, params, noCreate });
+}
+function optsEqual(a, b) {
+  return equal(a, b);
+}
+export {
+  createRivetKit
+};
+//# sourceMappingURL=mod.mjs.map

package/dist/mod.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/mod.ts"],"sourcesContent":["import { Derived, Effect, Store } from \"@tanstack/store\";\nimport equal from \"fast-deep-equal\";\nimport type { AnyActorDefinition, Registry } from \"rivetkit\";\nimport {\n\ttype ActorConn,\n\ttype ActorConnStatus,\n\ttype ActorHandle,\n\ttype Client,\n\ttype ExtractActorsFromRegistry,\n} from \"rivetkit/client\";\n\nexport type AnyActorRegistry = Registry<any>;\n\nexport type { ActorConnStatus };\n\ninterface ActorStateReference<AD extends AnyActorDefinition> {\n\t/**\n\t * The unique identifier for the actor.\n\t * This is a hash generated from the actor's options.\n\t * It is used to identify the actor instance in the store.\n\t * @internal\n\t */\n\thash: string;\n\t/**\n\t * The state of the actor, derived from the store.\n\t * This includes the actor's connection and handle.\n\t */\n\thandle: ActorHandle<AD> | null;\n\t/**\n\t * The connection to the actor.\n\t * This is used to communicate with the actor in realtime.\n\t */\n\tconnection: ActorConn<AD> | null;\n\t/**\n\t * The connection status of the actor.\n\t */\n\tconnStatus: ActorConnStatus;\n\t/**\n\t * The error that occurred while trying to connect to the actor, if any.\n\t */\n\terror: Error | null;\n\t/**\n\t * Options for the actor, including its name, key, parameters, and whether it is enabled.\n\t */\n\topts: {\n\t\tname: keyof AD;\n\t\t/**\n\t\t * Unique key for the actor instance.\n\t\t * This can be a string or an array of strings to create multiple instances.\n\t\t * @example \"abc\" or [\"abc\", \"def\"]\n\t\t */\n\t\tkey: string | string[];\n\t\t/**\n\t\t * Parameters for the actor.\n\t\t * These are additional options that can be passed to the actor.\n\t\t */\n\t\tparams?: Record<string, string>;\n\t\t/** Region to create the actor in if it doesn't exist. */\n\t\tcreateInRegion?: string;\n\t\t/** Input data to pass to the actor. */\n\t\tcreateWithInput?: unknown;\n\t\t/**\n\t\t * Whether the actor is enabled.\n\t\t * Defaults to true.\n\t\t */\n\t\tenabled?: boolean;\n\t\t/**\n\t\t * If true, only gets the actor if it already exists. Does not create the actor.\n\t\t * Throws an error if the actor is not found.\n\t\t * Defaults to false.\n\t\t */\n\t\tnoCreate?: boolean;\n\t};\n}\n\ninterface InternalRivetKitStore<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> {\n\tactors: Record<string, ActorStateReference<Actors>>;\n}\n\n/**\n * Options for configuring a actor in RivetKit.\n */\nexport interface ActorOptions<\n\tRegistry extends AnyActorRegistry,\n\tActorName extends keyof ExtractActorsFromRegistry<Registry>,\n> {\n\t/**\n\t * Typesafe name of the actor.\n\t * This should match the actor's name in the app's actor definitions.\n\t * @example \"chatRoom\"\n\t */\n\tname: ActorName;\n\t/**\n\t * Unique key for the actor instance.\n\t * This can be a string or an array of strings to create multiple instances.\n\t * @example \"abc\" or [\"abc\", \"def\"]\n\t */\n\tkey: string | string[];\n\t/**\n\t * Parameters for the actor.\n\t */\n\tparams?: Registry[ExtractActorsFromRegistry<Registry>][\"params\"];\n\t/** Region to create the actor in if it doesn't exist. */\n\tcreateInRegion?: string;\n\t/** Input data to pass to the actor. */\n\tcreateWithInput?: unknown;\n\t/**\n\t * Whether the actor is enabled.\n\t * Defaults to true.\n\t */\n\tenabled?: boolean;\n\t/**\n\t * If true, only gets the actor if it already exists. Does not create the actor.\n\t * Throws an error if the actor is not found.\n\t * Defaults to false.\n\t */\n\tnoCreate?: boolean;\n}\n\nexport type ActorsStateDerived<\n\tRegistry extends AnyActorRegistry,\n\tWorkerName extends keyof ExtractActorsFromRegistry<Registry>,\n> = Derived<\n\tOmit<\n\t\tInternalRivetKitStore<\n\t\t\tRegistry,\n\t\t\tExtractActorsFromRegistry<Registry>\n\t\t>[\"actors\"][string],\n\t\t\"handle\" | \"connection\"\n\t> & {\n\t\thandle: ActorHandle<\n\t\t\tExtractActorsFromRegistry<Registry>[WorkerName]\n\t\t> | null;\n\t\tconnection: ActorConn<\n\t\t\tExtractActorsFromRegistry<Registry>[WorkerName]\n\t\t> | null;\n\t\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\t\tisConnected: boolean;\n\t}\n>;\n\nexport type AnyActorOptions = ActorOptions<AnyActorRegistry, any>;\n\nexport interface CreateRivetKitOptions<Registry extends AnyActorRegistry> {\n\thashFunction?: (opts: ActorOptions<Registry, any>) => string;\n}\n\ntype ComputedActorState<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = InternalRivetKitStore<Registry, Actors>[\"actors\"][string] & {\n\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\tisConnected: boolean;\n};\n\ntype ActorCache<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = Map<\n\tstring,\n\t{\n\t\tstate: Derived<ComputedActorState<Registry, Actors>>;\n\t\tkey: string;\n\t\tmount: () => () => void;\n\t\tcreate: () => void;\n\t\trefCount: number;\n\t\tcleanupTimeout: ReturnType<typeof setTimeout> | null;\n\t}\n>;\n\nexport function createRivetKit<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n>(client: Client<Registry>, createOpts: CreateRivetKitOptions<Registry> = {}) {\n\tconst store = new Store<InternalRivetKitStore<Registry, Actors>>({\n\t\tactors: {},\n\t});\n\n\tconst cache: ActorCache<Registry, Actors> = new Map();\n\n\treturn {\n\t\tgetOrCreateActor: <ActorName extends keyof Actors>(\n\t\t\tactorOpts: ActorOptions<Registry, ActorName>,\n\t\t) => getOrCreateActor(client, createOpts, store, cache, actorOpts),\n\t\tstore,\n\t};\n}\n\ntype ActorUpdates<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n> = Partial<InternalRivetKitStore<Registry, Actors>[\"actors\"][string]>;\n\nfunction updateActor<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n>(\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tkey: string,\n\tupdates: ActorUpdates<Registry, Actors>,\n) {\n\tstore.setState((prev) => ({\n\t\t...prev,\n\t\tactors: {\n\t\t\t...prev.actors,\n\t\t\t[key]: { ...prev.actors[key], ...updates },\n\t\t},\n\t}));\n}\n\n// See README.md for lifecycle documentation.\nfunction getOrCreateActor<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n\tActorName extends keyof Actors,\n>(\n\tclient: Client<Registry>,\n\tcreateOpts: CreateRivetKitOptions<Registry>,\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tcache: ActorCache<Registry, Actors>,\n\tactorOpts: ActorOptions<Registry, ActorName>,\n) {\n\tconst hash = createOpts.hashFunction || defaultHashFunction;\n\n\tconst normalizedOpts = {\n\t\t...actorOpts,\n\t\tenabled: actorOpts.enabled ?? true,\n\t};\n\n\tconst key = hash(normalizedOpts);\n\n\t// Sync opts to store on every call (even for cached entries)\n\t// Use queueMicrotask for updates to avoid \"Cannot update a component while rendering\" React error\n\tconst existing = store.state.actors[key];\n\tif (!existing) {\n\t\tstore.setState((prev) => ({\n\t\t\t...prev,\n\t\t\tactors: {\n\t\t\t\t...prev.actors,\n\t\t\t\t[key]: {\n\t\t\t\t\thash: key,\n\t\t\t\t\tconnStatus: \"idle\",\n\t\t\t\t\tconnection: null,\n\t\t\t\t\thandle: null,\n\t\t\t\t\terror: null,\n\t\t\t\t\topts: normalizedOpts,\n\t\t\t\t},\n\t\t\t},\n\t\t}));\n\t} else if (!optsEqual(existing.opts, normalizedOpts)) {\n\t\t// Defer opts update to avoid triggering re-render during render\n\t\tqueueMicrotask(() => {\n\t\t\tupdateActor(store, key, { opts: normalizedOpts });\n\t\t});\n\t}\n\n\tconst cached = cache.get(key);\n\tif (cached) {\n\t\treturn {\n\t\t\t...cached,\n\t\t\tstate: cached.state as ActorsStateDerived<Registry, ActorName>,\n\t\t};\n\t}\n\n\tconst derived = new Derived({\n\t\tfn: ({ currDepVals: [store] }) => {\n\t\t\tconst actor = store.actors[key];\n\t\t\treturn {\n\t\t\t\t...actor,\n\t\t\t\t/** @deprecated Use `connStatus === \"connected\"` instead */\n\t\t\t\tisConnected: actor.connStatus === \"connected\",\n\t\t\t};\n\t\t},\n\t\tdeps: [store],\n\t});\n\n\t// Handle enabled/disabled state changes.\n\t// Initial connection is triggered directly in mount() since Effect\n\t// only runs on state changes, not on mount.\n\tconst effect = new Effect({\n\t\tfn: () => {\n\t\t\tconst actor = store.state.actors[key];\n\t\t\tif (!actor) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Actor with key \"${key}\" not found in store. This indicates a bug in cleanup logic.`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Dispose connection if disabled\n\t\t\tif (!actor.opts.enabled && actor.connection) {\n\t\t\t\tactor.connection.dispose();\n\n\t\t\t\t// Reset state so re-enabling will reconnect\n\t\t\t\tupdateActor(store, key, {\n\t\t\t\t\tconnection: null,\n\t\t\t\t\thandle: null,\n\t\t\t\t\tconnStatus: \"idle\",\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Reconnect when re-enabled after being disabled\n\t\t\t// Defer to avoid \"Cannot update a component while rendering\" React error\n\t\t\tif (\n\t\t\t\tactor.connStatus === \"idle\" &&\n\t\t\t\tactor.opts.enabled\n\t\t\t) {\n\t\t\t\tqueueMicrotask(() => {\n\t\t\t\t\t// Re-check state after microtask in case it changed\n\t\t\t\t\tconst currentActor = store.state.actors[key];\n\t\t\t\t\tif (\n\t\t\t\t\t\tcurrentActor &&\n\t\t\t\t\t\tcurrentActor.connStatus === \"idle\" &&\n\t\t\t\t\t\tcurrentActor.opts.enabled\n\t\t\t\t\t) {\n\t\t\t\t\t\tcreate<Registry, Actors, ActorName>(client, store, key);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t\tdeps: [derived],\n\t});\n\n\t// Track subscriptions for ref counting\n\tlet unsubscribeDerived: (() => void) | null = null;\n\tlet unsubscribeEffect: (() => void) | null = null;\n\n\tconst mount = () => {\n\t\tconst cached = cache.get(key);\n\t\tif (!cached) {\n\t\t\tthrow new Error(\n\t\t\t\t`Actor with key \"${key}\" not found in cache. This indicates a bug in cleanup logic.`,\n\t\t\t);\n\t\t}\n\n\t\t// Cancel pending cleanup\n\t\tif (cached.cleanupTimeout !== null) {\n\t\t\tclearTimeout(cached.cleanupTimeout);\n\t\t\tcached.cleanupTimeout = null;\n\t\t}\n\n\t\t// Increment ref count\n\t\tcached.refCount++;\n\n\t\t// Mount derived/effect on first reference (or re-mount after cleanup)\n\t\tif (cached.refCount === 1) {\n\t\t\tunsubscribeDerived = derived.mount();\n\t\t\tunsubscribeEffect = effect.mount();\n\n\t\t\t// Effect doesn't run immediately on mount, only on state changes.\n\t\t\t// Trigger initial connection if actor is enabled and idle.\n\t\t\tconst actor = store.state.actors[key];\n\t\t\tif (\n\t\t\t\tactor &&\n\t\t\t\tactor.opts.enabled &&\n\t\t\t\tactor.connStatus === \"idle\"\n\t\t\t) {\n\t\t\t\tcreate<Registry, Actors, ActorName>(client, store, key);\n\t\t\t}\n\t\t}\n\n\t\treturn () => {\n\t\t\t// Decrement ref count\n\t\t\tcached.refCount--;\n\n\t\t\tif (cached.refCount === 0) {\n\t\t\t\t// Deferred cleanup prevents needless reconnection when:\n\t\t\t\t// - React Strict Mode's unmount/remount cycle\n\t\t\t\t// - useActor hook moves between components in the same render cycle\n\t\t\t\tcached.cleanupTimeout = setTimeout(() => {\n\t\t\t\t\tcached.cleanupTimeout = null;\n\t\t\t\t\tif (cached.refCount > 0) return;\n\n\t\t\t\t\t// Unsubscribe from derived/effect\n\t\t\t\t\tunsubscribeDerived?.();\n\t\t\t\t\tunsubscribeEffect?.();\n\t\t\t\t\tunsubscribeDerived = null;\n\t\t\t\t\tunsubscribeEffect = null;\n\n\t\t\t\t\t// Dispose connection\n\t\t\t\t\tconst actor = store.state.actors[key];\n\t\t\t\t\tif (actor?.connection) {\n\t\t\t\t\t\tactor.connection.dispose();\n\t\t\t\t\t}\n\n\t\t\t\t\t// Remove from store and cache\n\t\t\t\t\tstore.setState((prev) => {\n\t\t\t\t\t\tconst { [key]: _, ...rest } = prev.actors;\n\t\t\t\t\t\treturn { ...prev, actors: rest };\n\t\t\t\t\t});\n\t\t\t\t\tcache.delete(key);\n\t\t\t\t}, 0);\n\t\t\t}\n\t\t};\n\t};\n\n\tcache.set(key, {\n\t\tstate: derived,\n\t\tkey,\n\t\tmount,\n\t\tcreate: create.bind(undefined, client, store, key),\n\t\trefCount: 0,\n\t\tcleanupTimeout: null,\n\t});\n\n\treturn {\n\t\tmount,\n\t\tstate: derived as ActorsStateDerived<Registry, ActorName>,\n\t\tkey,\n\t};\n}\n\nfunction create<\n\tRegistry extends AnyActorRegistry,\n\tActors extends ExtractActorsFromRegistry<Registry>,\n\tActorName extends keyof Actors,\n>(\n\tclient: Client<Registry>,\n\tstore: Store<InternalRivetKitStore<Registry, Actors>>,\n\tkey: string,\n) {\n\tconst actor = store.state.actors[key];\n\tif (!actor) {\n\t\tthrow new Error(\n\t\t\t`Actor with key \"${key}\" not found in store. This indicates a bug in cleanup logic.`,\n\t\t);\n\t}\n\n\t// Save actor to map\n\tupdateActor(store, key, {\n\t\tconnStatus: \"connecting\",\n\t\terror: null,\n\t});\n\n\ttry {\n\t\tconst handle = actor.opts.noCreate\n\t\t\t? client.get(\n\t\t\t\t\tactor.opts.name as string,\n\t\t\t\t\tactor.opts.key,\n\t\t\t\t\t{\n\t\t\t\t\t\tparams: actor.opts.params,\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t: client.getOrCreate(\n\t\t\t\t\tactor.opts.name as string,\n\t\t\t\t\tactor.opts.key,\n\t\t\t\t\t{\n\t\t\t\t\t\tparams: actor.opts.params,\n\t\t\t\t\t\tcreateInRegion: actor.opts.createInRegion,\n\t\t\t\t\t\tcreateWithInput: actor.opts.createWithInput,\n\t\t\t\t\t},\n\t\t\t\t);\n\n\t\tconst connection = handle.connect();\n\n\t\t// Store connection BEFORE registering callbacks to avoid race condition\n\t\t// where status change fires before connection is stored\n\t\tupdateActor(store, key, {\n\t\t\thandle: handle as ActorHandle<Actors[ActorName]>,\n\t\t\tconnection: connection as ActorConn<Actors[ActorName]>,\n\t\t});\n\n\t\t// Subscribe to connection state changes\n\t\tconnection.onStatusChange((status) => {\n\t\t\tstore.setState((prev) => {\n\t\t\t\t// Only update if this is still the active connection\n\t\t\t\tconst isActiveConnection = prev.actors[key]?.connection === connection;\n\t\t\t\tif (!isActiveConnection) return prev;\n\t\t\t\treturn {\n\t\t\t\t\t...prev,\n\t\t\t\t\tactors: {\n\t\t\t\t\t\t...prev.actors,\n\t\t\t\t\t\t[key]: {\n\t\t\t\t\t\t\t...prev.actors[key],\n\t\t\t\t\t\t\tconnStatus: status,\n\t\t\t\t\t\t\t// Only clear error when successfully connected\n\t\t\t\t\t\t\t...(status === \"connected\"\n\t\t\t\t\t\t\t\t? { error: null }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t});\n\t\t});\n\n\t\t// onError is followed by onClose which will set connStatus to Disconnected\n\t\tconnection.onError((error) => {\n\t\t\tstore.setState((prev) => {\n\t\t\t\t// Only update if this is still the active connection\n\t\t\t\tif (prev.actors[key]?.connection !== connection) return prev;\n\t\t\t\treturn {\n\t\t\t\t\t...prev,\n\t\t\t\t\tactors: {\n\t\t\t\t\t\t...prev.actors,\n\t\t\t\t\t\t[key]: {\n\t\t\t\t\t\t\t...prev.actors[key],\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t});\n\t\t});\n\t} catch (error) {\n\t\tconsole.error(\"Failed to create actor connection\", error);\n\t\t// Use Disconnected so Effect won't auto-retry\n\t\t// User must re-enable or take action to retry\n\t\tupdateActor(store, key, {\n\t\t\tconnStatus: \"disconnected\",\n\t\t\terror: error as Error,\n\t\t});\n\t}\n}\n\nfunction defaultHashFunction({ name, key, params, noCreate }: AnyActorOptions) {\n\treturn JSON.stringify({ name, key, params, noCreate });\n}\n\nfunction optsEqual(a: AnyActorOptions, b: AnyActorOptions) {\n\treturn equal(a, b);\n}\n"],"mappings":"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","names":["store","cached"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,7 @@
 {
   "name": "@rivetkit/framework-base",
-  "version": "2.0.2",
+  "version": "2.0.4-rc.1",
+  "description": "Base framework utilities for RivetKit client integrations",
   "license": "Apache-2.0",
   "keywords": [
     "rivetkit",
@@ -9,8 +10,10 @@
     "utilities",
     "integration"
   ],
-  "sideEffects": false,
-  "type": "module",
+  "sideEffects": [
+    "./dist/chunk-*.js",
+    "./dist/chunk-*.cjs"
+  ],
   "files": [
     "dist",
     "package.json"
@@ -18,29 +21,27 @@
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/mod.d.ts",
-        "default": "./dist/mod.js"
+        "types": "./dist/mod.d.mts",
+        "default": "./dist/mod.mjs"
       },
       "require": {
-        "types": "./dist/mod.d.cts",
-        "default": "./dist/mod.cjs"
+        "types": "./dist/mod.d.ts",
+        "default": "./dist/mod.js"
       }
     }
   },
   "devDependencies": {
-    "typescript": "^5.5.2",
-    "vite": "^6.3.5",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.1.1"
+    "tsup": "^8.4.0",
+    "typescript": "^5.5.2"
   },
   "stableVersion": "0.8.0",
   "dependencies": {
     "@tanstack/store": "^0.7.1",
-    "@rivetkit/core": "2.0.2"
+    "fast-deep-equal": "^3.1.3",
+    "rivetkit": "2.0.4-rc.1"
   },
   "scripts": {
-    "dev": "vite build --watch",
-    "build": "tsc && vite build",
+    "build": "tsup src/mod.ts",
     "check-types": "tsc --noEmit"
   }
 }

package/dist/mod.cjs DELETED Viewed

@@ -1 +0,0 @@

- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=new WeakMap,S=new WeakMap,g={current:[]};let b=!1;const v=new Set,k=new Map;function C(i){const n=Array.from(i).sort((t,e)=>t instanceof f&&t.options.deps.includes(e)?1:e instanceof f&&e.options.deps.includes(t)?-1:0);for(const t of n){if(g.current.includes(t))continue;g.current.push(t),t.recompute();const e=S.get(t);if(e)for(const s of e){const o=p.get(s);o&&C(o)}}}function O(i){i.listeners.forEach(n=>n({prevVal:i.prevState,currentVal:i.state}))}function F(i){i.listeners.forEach(n=>n({prevVal:i.prevState,currentVal:i.state}))}function R(i){if(v.add(i),!b)try{for(b=!0;v.size>0;){const n=Array.from(v);v.clear();for(const t of n){const e=k.get(t)??t.prevState;t.prevState=e,O(t)}for(const t of n){const e=p.get(t);e&&(g.current.push(t),C(e))}for(const t of n){const e=p.get(t);if(e)for(const s of e)F(s)}}}finally{b=!1,g.current=[],k.clear()}}function G(i){return typeof i=="function"}class m{constructor(n,t){this.listeners=new Set,this.subscribe=e=>{var s,o;this.listeners.add(e);const h=(o=(s=this.options)==null?void 0:s.onSubscribe)==null?void 0:o.call(s,e,this);return()=>{this.listeners.delete(e),h==null||h()}},this.prevState=n,this.state=n,this.options=t}setState(n){var t,e,s;this.prevState=this.state,(t=this.options)!=null&&t.updateFn?this.state=this.options.updateFn(this.prevState)(n):G(n)?this.state=n(this.prevState):this.state=n,(s=(e=this.options)==null?void 0:e.onUpdate)==null||s.call(e),R(this)}}class f{constructor(n){this.listeners=new Set,this._subscriptions=[],this.lastSeenDepValues=[],this.getDepVals=()=>{const t=[],e=[];for(const s of this.options.deps)t.push(s.prevState),e.push(s.state);return this.lastSeenDepValues=e,{prevDepVals:t,currDepVals:e,prevVal:this.prevState??void 0}},this.recompute=()=>{var t,e;this.prevState=this.state;const{prevDepVals:s,currDepVals:o,prevVal:h}=this.getDepVals();this.state=this.options.fn({prevDepVals:s,currDepVals:o,prevVal:h}),(e=(t=this.options).onUpdate)==null||e.call(t)},this.checkIfRecalculationNeededDeeply=()=>{for(const o of this.options.deps)o instanceof f&&o.checkIfRecalculationNeededDeeply();let t=!1;const e=this.lastSeenDepValues,{currDepVals:s}=this.getDepVals();for(let o=0;o<s.length;o++)if(s[o]!==e[o]){t=!0;break}t&&this.recompute()},this.mount=()=>(this.registerOnGraph(),this.checkIfRecalculationNeededDeeply(),()=>{this.unregisterFromGraph();for(const t of this._subscriptions)t()}),this.subscribe=t=>{var e,s;this.listeners.add(t);const o=(s=(e=this.options).onSubscribe)==null?void 0:s.call(e,t,this);return()=>{this.listeners.delete(t),o==null||o()}},this.options=n,this.state=n.fn({prevDepVals:void 0,prevVal:void 0,currDepVals:this.getDepVals().currDepVals})}registerOnGraph(n=this.options.deps){for(const t of n)if(t instanceof f)t.registerOnGraph(),this.registerOnGraph(t.options.deps);else if(t instanceof m){let e=p.get(t);e||(e=new Set,p.set(t,e)),e.add(this);let s=S.get(this);s||(s=new Set,S.set(this,s)),s.add(t)}}unregisterFromGraph(n=this.options.deps){for(const t of n)if(t instanceof f)this.unregisterFromGraph(t.options.deps);else if(t instanceof m){const e=p.get(t);e&&e.delete(this);const s=S.get(this);s&&s.delete(t)}}}class I{constructor(n){const{eager:t,fn:e,...s}=n;this._derived=new f({...s,fn:()=>{},onUpdate(){e()}}),t&&e()}mount(){return this._derived.mount()}}function L(i,n={}){const t=new m({actors:{}}),e=n.hashFunction||N,s=new Map;function o(h){const r=e(h),_=s.get(r);if(_)return{..._,state:_.state};const d=new f({fn:({currDepVals:[a]})=>a.actors[r],deps:[t]});function V(){async function a(){const c=t.state.actors[r];try{const u=i.getOrCreate(c.opts.name,c.opts.key,{params:c.opts.params,createInRegion:c.opts.createInRegion,createWithInput:c.opts.createWithInput}),l=u.connect();await u.resolve(),t.setState(D=>({...D,actors:{...D.actors,[r]:{...D.actors[r],isConnected:!0,isConnecting:!1,handle:u,connection:l,isError:!1,error:null}}}))}catch(u){t.setState(l=>({...l,actors:{...l.actors,[r]:{...l.actors[r],isError:!0,isConnecting:!1,error:u}}}))}}t.setState(c=>(c.actors[r].isConnecting=!0,c.actors[r].isError=!1,c.actors[r].error=null,a(),c))}const E=new I({fn:()=>{const a=t.state.actors[r];JSON.stringify(t.prevState.actors[r].opts)===JSON.stringify(t.state.actors[r].opts)&&!a.isConnected&&!a.isConnecting&&!a.isError&&a.opts.enabled&&V()},deps:[d]});t.setState(a=>a.actors[r]?a:{...a,actors:{...a.actors,[r]:{hash:r,isConnected:!1,isConnecting:!1,connection:null,handle:null,isError:!1,error:null,opts:h}}});function y(a){t.setState(c=>{const u=c.actors[r];if(!u)throw new Error(`Actor with key "${r}" does not exist.`);let l;return typeof a=="function"?l=a(u):l=a,{...c,actors:{...c.actors,[r]:l}}})}const w=()=>{const a=d.mount(),c=E.mount();return()=>{a(),c()}};return s.set(r,{state:d,key:r,mount:w,setState:y,create:V,addEventListener}),{mount:w,setState:y,state:d,create:V,key:r}}return{getOrCreateActor:o,store:t}}function N({name:i,key:n,params:t}){return JSON.stringify({name:i,key:n,params:t})}exports.createRivetKit=L;