@lunora/svelte 1.0.0-alpha.10 → 1.0.0-alpha.12

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { LunoraClient, User, ConnectionStatus, Preloaded, FunctionReference, ReturnOf, ArgsOf, MutationCallOptions, SubscriptionErrorCallback } from '@lunora/client';
-export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, Preloaded, ReturnOf } from '@lunora/client';
+import { LunoraClient, User, ConnectionStatus, Preloaded, FunctionReference, ReturnOf, ArgsOf, MutationCallOptions, MutatorHandle, SubscriptionErrorCallback } from '@lunora/client';
+export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, Preloaded, ReturnOf } from '@lunora/client';
 import { Readable } from 'svelte/store';
 import { PaginationStatus } from '@lunora/client/pagination';
 import { RateLimitStatus, RateLimitConfig } from '@lunora/ratelimit';
@@ -160,6 +160,37 @@ interface MutationHandle<F extends FunctionReference> {
 */
 declare function mutation<F extends FunctionReference>(function_: F): MutationHandle<F>;
 declare function mutation<F extends FunctionReference>(client: LunoraClient, function_: F): MutationHandle<F>;
+/**
+* The reactive handle returned by {@link mutator} — the Svelte counterpart to
+* `@lunora/react`'s `useMutator`, re-expressed as stores you read with `$`.
+* `error`/`isError`/`pending` are readable stores and `mutate` is an awaitable
+* that resolves once the write is persisted (or rejects).
+*/
+interface MutatorHandleStore<TArgs> {
+  /** The latest invocation's error, or `undefined`. */
+  error: Readable<Error | undefined>;
+  /** `true` when the latest invocation rejected. */
+  isError: Readable<boolean>;
+  /** Run the mutator; resolves once the write is persisted, rejects on failure. */
+  mutate: (args: TArgs) => Promise<void>;
+  /** `true` while ANY invocation from this handle is in flight (ref-counted, so overlapping calls compose). */
+  pending: Readable<boolean>;
+  /** Clear the latest `error` back to idle. */
+  reset: () => void;
+}
+/**
+* Ergonomic `{ mutate, pending, error, isError, reset }` wrapper over a bound
+* custom-mutator handle from `@lunora/db`'s `bindMutators` — the Svelte
+* equivalent of `@lunora/react`'s `useMutator`. The optimistic overlay and
+* server-authoritative push are owned by the bound handle (and TanStack DB's
+* optimistic-transaction layer rebases pending overlays on every sync tick);
+* this helper only surfaces store state for the in-flight/error lifecycle. Reads
+* stay on the existing TanStack `useLiveQuery`; no new query store is needed.
+*
+* `pending` is ref-counted across overlapping invocations of THIS handle, so it
+* clears only once every concurrent call has settled.
+*/
+declare const mutator: <TArgs = Record<string, unknown>>(handle: MutatorHandle<TArgs>) => MutatorHandleStore<TArgs>;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F extends FunctionReference> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -371,4 +402,4 @@ interface SubscriptionHandle<T> {
 */
 declare function subscription<F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: SubscriptionStoreOptions): SubscriptionHandle<ReturnOf<F>>;
 declare function subscription<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F> | "skip", options?: SubscriptionStoreOptions): SubscriptionHandle<ReturnOf<F>>;
-export { type AuthStore, type ConnectionStatusStore, type FlagContext, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type SubscriptionHandle, type SubscriptionStoreOptions, auth, connectionStatus, flag, flags, getLunoraClient, hydratePreloaded, infiniteQuery, mutation, paginatedQuery, presence, query, rateLimit, setLunoraClient, subscription };
+export { type AuthStore, type ConnectionStatusStore, type FlagContext, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type SubscriptionHandle, type SubscriptionStoreOptions, auth, connectionStatus, flag, flags, getLunoraClient, hydratePreloaded, infiniteQuery, mutation, mutator, paginatedQuery, presence, query, rateLimit, setLunoraClient, subscription };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { LunoraClient, User, ConnectionStatus, Preloaded, FunctionReference, ReturnOf, ArgsOf, MutationCallOptions, SubscriptionErrorCallback } from '@lunora/client';
-export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, Preloaded, ReturnOf } from '@lunora/client';
+import { LunoraClient, User, ConnectionStatus, Preloaded, FunctionReference, ReturnOf, ArgsOf, MutationCallOptions, MutatorHandle, SubscriptionErrorCallback } from '@lunora/client';
+export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, Preloaded, ReturnOf } from '@lunora/client';
 import { Readable } from 'svelte/store';
 import { PaginationStatus } from '@lunora/client/pagination';
 import { RateLimitStatus, RateLimitConfig } from '@lunora/ratelimit';
@@ -160,6 +160,37 @@ interface MutationHandle<F extends FunctionReference> {
 */
 declare function mutation<F extends FunctionReference>(function_: F): MutationHandle<F>;
 declare function mutation<F extends FunctionReference>(client: LunoraClient, function_: F): MutationHandle<F>;
+/**
+* The reactive handle returned by {@link mutator} — the Svelte counterpart to
+* `@lunora/react`'s `useMutator`, re-expressed as stores you read with `$`.
+* `error`/`isError`/`pending` are readable stores and `mutate` is an awaitable
+* that resolves once the write is persisted (or rejects).
+*/
+interface MutatorHandleStore<TArgs> {
+  /** The latest invocation's error, or `undefined`. */
+  error: Readable<Error | undefined>;
+  /** `true` when the latest invocation rejected. */
+  isError: Readable<boolean>;
+  /** Run the mutator; resolves once the write is persisted, rejects on failure. */
+  mutate: (args: TArgs) => Promise<void>;
+  /** `true` while ANY invocation from this handle is in flight (ref-counted, so overlapping calls compose). */
+  pending: Readable<boolean>;
+  /** Clear the latest `error` back to idle. */
+  reset: () => void;
+}
+/**
+* Ergonomic `{ mutate, pending, error, isError, reset }` wrapper over a bound
+* custom-mutator handle from `@lunora/db`'s `bindMutators` — the Svelte
+* equivalent of `@lunora/react`'s `useMutator`. The optimistic overlay and
+* server-authoritative push are owned by the bound handle (and TanStack DB's
+* optimistic-transaction layer rebases pending overlays on every sync tick);
+* this helper only surfaces store state for the in-flight/error lifecycle. Reads
+* stay on the existing TanStack `useLiveQuery`; no new query store is needed.
+*
+* `pending` is ref-counted across overlapping invocations of THIS handle, so it
+* clears only once every concurrent call has settled.
+*/
+declare const mutator: <TArgs = Record<string, unknown>>(handle: MutatorHandle<TArgs>) => MutatorHandleStore<TArgs>;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F extends FunctionReference> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -371,4 +402,4 @@ interface SubscriptionHandle<T> {
 */
 declare function subscription<F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: SubscriptionStoreOptions): SubscriptionHandle<ReturnOf<F>>;
 declare function subscription<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F> | "skip", options?: SubscriptionStoreOptions): SubscriptionHandle<ReturnOf<F>>;
-export { type AuthStore, type ConnectionStatusStore, type FlagContext, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type SubscriptionHandle, type SubscriptionStoreOptions, auth, connectionStatus, flag, flags, getLunoraClient, hydratePreloaded, infiniteQuery, mutation, paginatedQuery, presence, query, rateLimit, setLunoraClient, subscription };
+export { type AuthStore, type ConnectionStatusStore, type FlagContext, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type SubscriptionHandle, type SubscriptionStoreOptions, auth, connectionStatus, flag, flags, getLunoraClient, hydratePreloaded, infiniteQuery, mutation, mutator, paginatedQuery, presence, query, rateLimit, setLunoraClient, subscription };

package/dist/index.mjs

@@ -4,6 +4,7 @@ export { getLunoraClient, setLunoraClient } from './packem_shared/getLunoraClien
 export { flag, flags } from './packem_shared/flag-19nEeKPT.mjs';
 export { hydratePreloaded } from './packem_shared/hydratePreloaded-D5rUJdXy.mjs';
 export { mutation } from './packem_shared/mutation-CnDkAaLH.mjs';
+export { mutator } from './packem_shared/mutator-B5LchgMS.mjs';
 export { infiniteQuery, paginatedQuery } from './packem_shared/infiniteQuery-jPMQw8Vz.mjs';
 export { presence } from './packem_shared/presence-BQWixJ2T.mjs';
 export { query } from './packem_shared/query-D8Pct9Qe.mjs';

package/dist/packem_shared/mutator-B5LchgMS.mjs

@@ -0,0 +1,19 @@
+import { createMutatorRunner } from '@lunora/client';
+import { writable, derived } from 'svelte/store';
+
+const mutator = (handle) => {
+  const error = writable();
+  const pending = writable(false);
+  const isError = derived(error, ($error) => $error !== void 0);
+  const { mutate, reset } = createMutatorRunner(handle, {
+    setError: (value) => {
+      error.set(value);
+    },
+    setPending: (value) => {
+      pending.set(value);
+    }
+  });
+  return { error, isError, mutate, pending, reset };
+};
+
+export { mutator };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/svelte",
-  "version": "1.0.0-alpha.10",
+  "version": "1.0.0-alpha.12",
   "description": "Svelte adapter for Lunora — live stores, optimistic mutations, and reactive loaders",
   "keywords": [
     "cloudflare",
@@ -54,9 +54,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.4",
+    "@lunora/client": "1.0.0-alpha.6",
     "@lunora/ratelimit": "1.0.0-alpha.3",
-    "@lunora/runtime": "1.0.0-alpha.7"
+    "@lunora/runtime": "1.0.0-alpha.8"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"