@lunora/client 1.0.0-alpha.11 → 1.0.0-alpha.110

package/LICENSE.md

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/README.md

@@ -34,7 +34,7 @@
 
 ---
 
-The framework-agnostic browser/edge SDK for Lunora. It runs RPC over HTTP and real-time deltas over a single multiplexed WebSocket, with optimistic updates, an offline mutation queue, and decorrelated-jitter reconnect built in. It is the lowest-level user-facing entry point that every framework adapter (React, Vue, Svelte, Solid) layers on top of.
+The framework-agnostic browser/edge SDK for Lunora. It runs RPC over HTTP and real-time deltas over a single multiplexed WebSocket, with optimistic updates, an offline mutation queue, and exponential-backoff-with-jitter reconnect built in. It is the lowest-level user-facing entry point that every framework adapter (React, Vue, Svelte, Solid) layers on top of.
 
 Part of the [Lunora](https://github.com/anolilab/lunora) framework — a type-safe, real-time backend on Cloudflare Workers + Durable Objects with a Vite-first DX.
 
@@ -63,8 +63,21 @@ const client = new LunoraClient({ url: "https://app.acme.test" });
 // One-shot query (HTTP, carries the D1 bookmark for read-your-writes).
 const messages = await client.query(api.messages.list, { room: "general" });
 
-// Mutation with an optimistic update applied to matching subscribers.
-await client.mutation(api.messages.send, { body: "hi" }, { optimistic: (current = []) => [...current, { body: "hi", pending: true }] });
+// Mutation with an optimistic update. `optimisticUpdate` names the query it
+// patches — a write and the queries it affects are different functions, and only
+// you know which. (The per-call `optimistic` shortcut patches the subscription
+// registered under the mutation's OWN reference and args, nothing else.)
+await client.mutation(
+    api.messages.send,
+    { room: "general", body: "hi" },
+    {
+        optimisticUpdate: (store, args) => {
+            const current = store.getQuery(api.messages.list, { room: args.room }) ?? [];
+
+            store.setQuery(api.messages.list, { room: args.room }, [...current, { body: args.body, pending: true }]);
+        },
+    },
+);
 
 // Live subscription over WS — returns an unsubscribe function.
 const unsubscribe = client.subscribe(api.messages.list, { room: "general" }, (next) => {

package/dist/auth/index.d.mts

@@ -1,20 +1,44 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-Dm1BYq19.mjs";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-qVBwKXE1.mjs";
+import '@lunora/errors';
+import "../packem_shared/function-reference.d-Br_hsKje.mjs";
 import '@lunora/runtime';
+/**
+ * Resolved authentication state. See the contract table in this module's header
+ * — the states are not interchangeable, and `unreachable` is the one that exists
+ * only so "the server said no session" and "we could not ask" stop colliding.
+ */
+type AuthStatus = "authenticated" | "loading" | "unauthenticated" | "unreachable";
+/**
+ * Whether a gate should render its authenticated branch.
+ *
+ * Both `authenticated` and `unreachable` qualify: the credential is held in
+ * either case, and only the identity round-trip differs.
+ */
+declare const isAuthenticatedStatus: (status: AuthStatus) => boolean;
+/** Whether a gate should render its loading branch — the first resolve only. */
+declare const isLoadingStatus: (status: AuthStatus) => boolean;
 interface IdentityStore {
-  /** Read the current resolved user, or `null` when signed out / not yet resolved. */
+  /** The current {@link AuthStatus} — what a gate branches on. */
+  getStatus: () => AuthStatus;
+  /**
+   * The last resolved user, or `null`. `null` does NOT mean signed out on its
+   * own: read `getStatus` for that. A user resolved before the endpoint
+   * went unreachable is retained, so the UI keeps rendering the identity it
+   * last knew instead of blanking.
+   */
   getUser: () => User | null;
   /**
-  * Subscribe to identity changes. `onChange` is called whenever the user or
-  * token changes. Returns an unsubscribe handle.
-  */
+   * Subscribe to identity changes. `onChange` is called whenever the user or
+   * the status changes. Returns an unsubscribe handle.
+   */
   subscribe: (onChange: () => void) => () => void;
 }
 /**
-* Return the per-client identity store, creating it on first access.
-*
-* The store is cached via a `WeakMap` so it is GC'd when the client is dropped,
-* and creation is idempotent — calling this multiple times with the same client
-* returns the same store, keeping the single-fetch / fan-out invariant.
-*/
+ * Return the per-client identity store, creating it on first access.
+ *
+ * The store is cached via a `WeakMap` so it is GC'd when the client is dropped,
+ * and creation is idempotent — calling this multiple times with the same client
+ * returns the same store, keeping the single-fetch / fan-out invariant.
+ */
 declare const getIdentityStore: (client: LunoraClient) => IdentityStore;
-export { type IdentityStore, getIdentityStore };
+export { type AuthStatus, type IdentityStore, getIdentityStore, isAuthenticatedStatus, isLoadingStatus };

package/dist/auth/index.d.ts

@@ -1,20 +1,44 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-Dm1BYq19.js";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-CGR-MObo.js";
+import '@lunora/errors';
+import "../packem_shared/function-reference.d-Br_hsKje.js";
 import '@lunora/runtime';
+/**
+ * Resolved authentication state. See the contract table in this module's header
+ * — the states are not interchangeable, and `unreachable` is the one that exists
+ * only so "the server said no session" and "we could not ask" stop colliding.
+ */
+type AuthStatus = "authenticated" | "loading" | "unauthenticated" | "unreachable";
+/**
+ * Whether a gate should render its authenticated branch.
+ *
+ * Both `authenticated` and `unreachable` qualify: the credential is held in
+ * either case, and only the identity round-trip differs.
+ */
+declare const isAuthenticatedStatus: (status: AuthStatus) => boolean;
+/** Whether a gate should render its loading branch — the first resolve only. */
+declare const isLoadingStatus: (status: AuthStatus) => boolean;
 interface IdentityStore {
-  /** Read the current resolved user, or `null` when signed out / not yet resolved. */
+  /** The current {@link AuthStatus} — what a gate branches on. */
+  getStatus: () => AuthStatus;
+  /**
+   * The last resolved user, or `null`. `null` does NOT mean signed out on its
+   * own: read `getStatus` for that. A user resolved before the endpoint
+   * went unreachable is retained, so the UI keeps rendering the identity it
+   * last knew instead of blanking.
+   */
   getUser: () => User | null;
   /**
-  * Subscribe to identity changes. `onChange` is called whenever the user or
-  * token changes. Returns an unsubscribe handle.
-  */
+   * Subscribe to identity changes. `onChange` is called whenever the user or
+   * the status changes. Returns an unsubscribe handle.
+   */
   subscribe: (onChange: () => void) => () => void;
 }
 /**
-* Return the per-client identity store, creating it on first access.
-*
-* The store is cached via a `WeakMap` so it is GC'd when the client is dropped,
-* and creation is idempotent — calling this multiple times with the same client
-* returns the same store, keeping the single-fetch / fan-out invariant.
-*/
+ * Return the per-client identity store, creating it on first access.
+ *
+ * The store is cached via a `WeakMap` so it is GC'd when the client is dropped,
+ * and creation is idempotent — calling this multiple times with the same client
+ * returns the same store, keeping the single-fetch / fan-out invariant.
+ */
 declare const getIdentityStore: (client: LunoraClient) => IdentityStore;
-export { type IdentityStore, getIdentityStore };
+export { type AuthStatus, type IdentityStore, getIdentityStore, isAuthenticatedStatus, isLoadingStatus };

package/dist/auth/index.mjs

@@ -1,60 +1 @@
-const stores = /* @__PURE__ */ new WeakMap();
-const createIdentityStore = (client) => {
-  const listeners = /* @__PURE__ */ new Set();
-  let user = null;
-  let started = false;
-  const notify = () => {
-    for (const listener of listeners) {
-      listener();
-    }
-  };
-  let generation = 0;
-  const setUser = (next) => {
-    if (user !== next) {
-      user = next;
-      notify();
-    }
-  };
-  const refresh = () => {
-    generation += 1;
-    const current = generation;
-    if (client.getAuthToken() === null) {
-      setUser(null);
-      return;
-    }
-    client.getCurrentUser().then((next) => {
-      if (current === generation) {
-        setUser(next);
-      }
-      return void 0;
-    }).catch(() => {
-      if (current === generation) {
-        setUser(null);
-      }
-    });
-  };
-  client.onAuthTokenChange(refresh);
-  return {
-    getUser: () => user,
-    subscribe: (onChange) => {
-      listeners.add(onChange);
-      if (!started) {
-        started = true;
-        refresh();
-      }
-      return () => {
-        listeners.delete(onChange);
-      };
-    }
-  };
-};
-const getIdentityStore = (client) => {
-  let store = stores.get(client);
-  if (!store) {
-    store = createIdentityStore(client);
-    stores.set(client, store);
-  }
-  return store;
-};
-
-export { getIdentityStore };
+const f=t=>t==="authenticated"||t==="unreachable",g=t=>t==="loading",l=new WeakMap,h=t=>{const n=new Set;let a=null,r=t.getAuthToken()===null?"unauthenticated":"loading",i=!1;const d=()=>{for(const e of n)e()};let o=0;const s=(e,u)=>{(r!==e||a!==u)&&(r=e,a=u,d())},c=()=>{o+=1;const e=o;if(t.getAuthToken()===null){s("unauthenticated",null);return}s(a===null?"loading":"authenticated",a),t.getCurrentUser().then(u=>{e===o&&s(u===null?"unauthenticated":"authenticated",u)}).catch(()=>{e===o&&s("unreachable",a)})};return t.onAuthTokenChange(c),t.onConnectionStatus(e=>{e==="connected"&&r==="unreachable"&&c()}),{getStatus:()=>r,getUser:()=>a,subscribe:e=>(n.add(e),i||(i=!0,c()),()=>{n.delete(e)})}},S=t=>{let n=l.get(t);return n||(n=h(t),l.set(t,n)),n};export{S as getIdentityStore,f as isAuthenticatedStatus,g as isLoadingStatus};