@confect/foldkit 10.0.0-next.20 → 10.0.0-next.22

package/CHANGELOG.md

@@ -1,12 +1,92 @@
 # @confect/foldkit
 
+## 10.0.0-next.22
+
+### Minor Changes
+
+- 6cc5834: Add experimental stream querying with reactive pagination, configurable middleware policies, and broader tracing.
+
+  ### Stream queries and pagination
+
+  Create composable Effect streams with `reader.table(...).stream(index, range?, order?)` and `QueryStream` from `@confect/server`. Merge, filter, map, join, deduplicate, narrow, and reverse queries without losing cursor pagination. Order keys and directions are checked by the type system. Joins support left-join placeholders through `onEmpty`, and effectful filters and maps support ordered concurrency. Reversing a distinct stream preserves its chosen representatives.
+
+  `QueryStream.paginate` resumes from indexed cursor bounds and supports pinned page ranges, automatic split recommendations, and `maximumRowsRead`/`maximumBytesRead` budgets that count underlying query-stream reads, including filtered documents. Byte counts are estimates. If a budget prevents safe progress or splitting, pagination fails with `ReadBudgetExceededError`; increase the budget or reduce the query's read requirements.
+
+  Use React's new `useStreamPaginatedQuery` for these queries:
+
+  ```ts
+  import { useStreamPaginatedQuery } from "@confect/react";
+
+  const { results, status, loadMore } = useStreamPaginatedQuery(
+    refs.public.notes.feed,
+    {},
+    {
+      initialNumItems: 10,
+      maximumRowsRead: 1000,
+      maximumBytesRead: 512 * 1024,
+    },
+  );
+  ```
+
+  The hook pins loaded pages to fixed ranges, splits oversized or budget-limited pages, and restarts pagination on invalid cursors. Foldkit's `PaginatedQuery` also supports stream queries and preserves page ranges when navigating back and forward, avoiding skipped or repeated documents as data changes.
+
+  Stream cursors expose their order-key values. Do not paginate publicly over sensitive indexed fields unless they are pinned with `eq`. All `QueryStream` APIs are experimental.
+
+  ### Middleware options
+
+  Declare a lazy `options` schema on `MiddlewareSpec.MiddlewareSpec`, then pass typed values with `.middleware(Policy, options)` on functions or groups. Options are validated without coercion during codegen and server registration; keep schemas and values client-safe because generated refs carry them.
+
+  The same policy can be attached repeatedly with non-equivalent options. Every attachment runs, with group policies before function policies. Equivalent options and duplicate policies without options are rejected. Register implementations against the same spec used for attachments.
+
+  ### Breaking changes
+
+  Middleware callbacks passed to `MiddlewareImpl.make` or `MiddlewareImpl.makeByFunctionType` receive invocation metadata under `invocation`. To migrate, nest destructuring of `name`, `functionType`, `functionVisibility`, and decoded `args`:
+
+  **Before:**
+
+  ```ts
+  (effect, { name, args }) => effect;
+  ```
+
+  **After:**
+
+  ```ts
+  (effect, { invocation: { name, args } }) => effect;
+  ```
+
+  Middleware with an options schema also receives `options` alongside `invocation`; middleware without one keeps its single-argument attachment API and receives only `{ invocation }`.
+
+  ### Fixes and tracing
+  - Preserve `ConvexError.data` when a handler throws a `ConvexError` inside an Effect instead of returning it as a typed failure.
+  - Add named tracing spans for JavaScript client calls, server function execution, database writes and pagination, `QueryStream.unique`/`QueryStream.paginate`, and `confect codegen`/`confect dev` code-generation passes.
+
+### Patch Changes
+
+- 9f4e2c0: Require `effect@^4.0.0-rc.113` across `@confect/*` and raise `@confect/server`'s optional `@effect/platform-node` peer to the same range. Upgrade Effect alongside Confect; existing Confect call sites are unchanged.
+
+  Effect's own APIs include breaking renames: use `Config.String` instead of `Config.string`, and `LanguageModel.LanguageModel` instead of `LanguageModel.Service` when annotating the result of `AiGatewayLanguageModel.make`. See the [Effect RC 113 release notes](https://github.com/Effect-TS/effect/releases/tag/effect%404.0.0-rc.113) for the complete migration guidance.
+
+- 90c80e9: Require `effect@^4.0.0-rc.115` across `@confect/*` and `@effect/platform-node@^4.0.0-rc.115` when using `@confect/server`'s optional Node integration. Upgrade these dependencies alongside Confect; existing Confect call sites are unchanged.
+- f721d2c: Remove spaces around em dashes and separator slashes in API documentation and `confect codegen` diagnostics.
+
+## 10.0.0-next.21
+
+### Major Changes
+
+- a6425c5: Raise the minimum supported Node.js version to 24.
+
+  ### Breaking Changes
+  - `engines.node` is now `>=24` on every `@confect/*` package, raised from `>=22`.
+
+  Node 22 has entered maintenance, so Confect now targets Node 24, the active LTS line. To migrate, move the Node version your project builds and runs on to 24 or later—on Node 22, installing `@confect/*` now fails your package manager's engine check. No API changes accompany the raise: code already running on Node 24 needs no edits.
+
 ## 10.0.0-next.20
 
 ## 10.0.0-next.19
 
 ### Minor Changes
 
-- c1087eb: Add `@confect/foldkit` — client-side bindings for [Foldkit](https://foldkit.dev) apps. The package maps Confect's client surface onto Foldkit's integration seams: `Client.layer` provides the scoped WebSocket client and pagination-session allocator through an application's `resources`, `Subscription.reactiveQuery` builds a subscription entry that opens, re-opens, and closes a reactive query as `Option`-wrapped args derived from the Model change, and `Command.query` / `Command.mutation` / `Command.action` build Command definitions whose args are the ref's args and whose Messages are declared with the same `messages` field Foldkit's own `Command.define` takes. Every failure is folded into a Message via the required `onError` handler, so Command and Subscription error channels stay `never` as Foldkit requires.
+- c1087eb: Add `@confect/foldkit`—client-side bindings for [Foldkit](https://foldkit.dev) apps. The package maps Confect's client surface onto Foldkit's integration seams: `Client.layer` provides the scoped WebSocket client and pagination-session allocator through an application's `resources`, `Subscription.reactiveQuery` builds a subscription entry that opens, re-opens, and closes a reactive query as `Option`-wrapped args derived from the Model change, and `Command.query`/`Command.mutation`/`Command.action` build Command definitions whose args are the ref's args and whose Messages are declared with the same `messages` field Foldkit's own `Command.define` takes. Every failure is folded into a Message via the required `onError` handler, so Command and Subscription error channels stay `never` as Foldkit requires.
 
   ```ts
   import * as Confect from "@confect/foldkit";
@@ -36,7 +116,7 @@
   }));
   ```
 
-  The Command factories accept Foldkit's `interrupt` option — `true` keys invocations by the Command name, `{ keyFields, toKey }` by a part derived from the ref's args — and the returned definition gains the `Interrupt` constructor for stopping in-flight invocations. Factory-built definitions instantiate Foldkit's own definition interfaces, so they are accepted wherever Foldkit accepts a Command definition — including Story/Scene `Command.resolve` and `expectExact` matchers. `Command.queryEffect`, `Command.mutationEffect`, and `Command.actionEffect` return execute bodies for hand-written `Command.define` calls (custom args schemas, multi-call Commands), and `Subscription.reactiveQueryStream` is the `dependenciesToStream` escape hatch for hand-written subscription entries.
+  The Command factories accept Foldkit's `interrupt` option—`true` keys invocations by the Command name, `{ keyFields, toKey }` by a part derived from the ref's args—and the returned definition gains the `Interrupt` constructor for stopping in-flight invocations. Factory-built definitions instantiate Foldkit's own definition interfaces, so they are accepted wherever Foldkit accepts a Command definition—including Story/Scene `Command.resolve` and `expectExact` matchers. `Command.queryEffect`, `Command.mutationEffect`, and `Command.actionEffect` return execute bodies for hand-written `Command.define` calls (custom args schemas, multi-call Commands), and `Subscription.reactiveQueryStream` is the `dependenciesToStream` escape hatch for hand-written subscription entries.
 
   `PaginatedQuery` navigates a paginated query one page at a time over Convex's cursor pagination. `PaginatedQuery.make(ref)` returns the Model and settlement schemas. Its states use Foldkit `AsyncData`'s vocabulary and semantics: `Idle`, `Loading`, `Refreshing`, `Success`, `Failure`, and `Stale`. Failed settlements preserve the complete error contract: declared function and middleware errors are wrapped as `FunctionError`, Convex's invalid-cursor pseudo-error is normalized to the new `@confect/core/PaginationError.InvalidCursor`, and `WebSocketClientError` and `SchemaError` are carried directly. `settle` accepts a request-bound `Result`, turns a failed refresh into `Stale`, automatically resets an invalid cursor, and ignores successes or failures from superseded requests. All machine operations (`init`, `reinitialize`, `reset`, `close`, `next`, `prev`, and `first`) remain pure.
 

package/dist/Command.d.ts

@@ -11,11 +11,10 @@ import * as Client from "./Client";
  */
 export type Error<Ref_ extends Ref.AnyConfect> = Ref.Error<Ref_> | Client.WebSocketClientError | Schema.SchemaError;
 /**
- * Maps a Confect function's outcome into the app's Messages. Every failure —
- * the ref's typed error, a transport error, or a codec error — arrives via
+ * Maps a Confect function's outcome into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via
  * `onError`, so the resulting Command's error channel is `never`, as Foldkit
  * requires. Follow Foldkit's naming convention: past-tense facts like
- * `SucceededSaveNote` / `FailedSaveNote`.
+ * `SucceededSaveNote`/`FailedSaveNote`.
  */
 export interface Handlers<Ref_ extends Ref.AnyConfect, SuccessMessage, ErrorMessage> {
     readonly onSuccess: (returns: Ref.Returns<Ref_>) => SuccessMessage;
@@ -35,20 +34,20 @@ type SchemaArgs<Ref_ extends Ref.AnyConfect> = Schema.Schema.Type<Schema.Struct<
  * ref-derived call signature (args optional when the ref declares none)
  * intersected with Foldkit's own `CommandDefinitionWithArgs`, which supplies
  * the `CommandDefinitionTypeId` brand and makes the definition assignable
- * wherever Foldkit accepts one — including Story/Scene `Command.resolve`
+ * wherever Foldkit accepts one—including Story/Scene `Command.resolve`
  * and `expectExact` matchers. Call it from `update` to construct a Command
  * instance; nothing runs until the Foldkit runtime executes it.
  */
 export type Definition<Name extends string, Ref_ extends Ref.AnyConfect, Message> = ((...args: Ref.OptionalArgs<Ref_>) => Instance<Name, Ref_, Message>) & FoldkitCommand.CommandDefinitionWithArgs<Name, Ref.ArgsSchema<Ref_>["fields"], Effect.Effect<Message, never, Client.Client>>;
 /**
- * Makes a factory-built Command interruptible — Foldkit's `InterruptOption`
+ * Makes a factory-built Command interruptible—Foldkit's `InterruptOption`
  * applied to the ref's args. `true` keys every invocation by the Command
- * name — right when at most one invocation is meaningfully in flight; a
+ * name—right when at most one invocation is meaningfully in flight; a
  * `KeyedInterrupt` derives the key part from the ref's args, so concurrent
  * invocations can be targeted independently.
  *
  * Interrupting stops the client-side Effect and guarantees the invocation's
- * result Messages never dispatch — it does not cancel the Convex function on
+ * result Messages never dispatch—it does not cancel the Convex function on
  * the server, which runs to completion once the call is on the wire.
  */
 export type InterruptOption<Ref_ extends Ref.AnyConfect, KeyField extends keyof SchemaArgs<Ref_> & string = keyof SchemaArgs<Ref_> & string> = FoldkitCommand.InterruptOption<SchemaArgs<Ref_>, KeyField>;
@@ -58,7 +57,7 @@ export type InterruptOption<Ref_ extends Ref.AnyConfect, KeyField extends keyof
  */
 export type KeyedInterrupt<Ref_ extends Ref.AnyConfect, KeyField extends keyof SchemaArgs<Ref_> & string> = Exclude<InterruptOption<Ref_, KeyField>, true>;
 /**
- * An interruptible Command definition whose key is the Command name — the
+ * An interruptible Command definition whose key is the Command name—the
  * ref-derived call signature intersected with Foldkit's
  * `Interruptible.DefinitionWithArgsNameKeyed`, which supplies the brand and
  * the `Interrupt` constructor.
@@ -68,7 +67,7 @@ export type InterruptibleDefinition<Name extends string, Ref_ extends Ref.AnyCon
 }>) & FoldkitCommand.Interruptible.DefinitionWithArgsNameKeyed<Name, Ref.ArgsSchema<Ref_>["fields"], Effect.Effect<Message, never, Client.Client>>;
 /**
  * An interruptible Command definition whose key is derived from the ref's
- * args — the ref-derived call signature intersected with Foldkit's
+ * args—the ref-derived call signature intersected with Foldkit's
  * `Interruptible.DefinitionWithArgs`, which supplies the brand and the
  * key-args-taking `Interrupt` constructor.
  */
@@ -76,18 +75,18 @@ export type KeyedInterruptibleDefinition<Name extends string, Ref_ extends Ref.A
     key: string;
 }>) & FoldkitCommand.Interruptible.DefinitionWithArgs<Name, Ref.ArgsSchema<Ref_>["fields"], Pick<SchemaArgs<Ref_>, KeyField>, Effect.Effect<Message, never, Client.Client>>;
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. Reach for these when the factory below doesn't fit:
  * a custom args schema, `interrupt`, or a Command that makes several calls.
  */
 export declare const queryEffect: <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(ref: Query, handlers: Handlers<Query, SuccessMessage, ErrorMessage>) => (...args: Ref.OptionalArgs<Query>) => Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client>;
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. See `queryEffect`.
  */
 export declare const mutationEffect: <Mutation extends Ref.AnyConfectPublicMutation, SuccessMessage, ErrorMessage>(ref: Mutation, handlers: Handlers<Mutation, SuccessMessage, ErrorMessage>) => (...args: Ref.OptionalArgs<Mutation>) => Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client>;
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. See `queryEffect`.
  */
 export declare const actionEffect: <Action extends Ref.AnyConfectPublicAction, SuccessMessage, ErrorMessage>(ref: Action, handlers: Handlers<Action, SuccessMessage, ErrorMessage>) => (...args: Ref.OptionalArgs<Action>) => Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client>;
@@ -129,7 +128,7 @@ declare const makeFactory: <BoundRef extends Ref.AnyConfect>(effectHelper: <Ref_
  * ```
  *
  * Pass `interrupt` to make invocations interruptible via the returned
- * definition's `Interrupt` constructor — `true` keys them by the Command
+ * definition's `Interrupt` constructor—`true` keys them by the Command
  * name, `{ keyFields, toKey }` by a part derived from the ref's args:
  *
  * ```ts

package/dist/Command.d.ts.map

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

package/dist/Command.js

@@ -17,18 +17,18 @@ const run = (handlers, invoke) => Effect.flatMap(Client, invoke).pipe(Effect.mat
 	onFailure: handlers.onError
 }));
 /**
-* An execute body for a hand-written `Command.define` — every failure already
+* An execute body for a hand-written `Command.define`—every failure already
 * folded into a Message. Reach for these when the factory below doesn't fit:
 * a custom args schema, `interrupt`, or a Command that makes several calls.
 */
 const queryEffect = (ref, handlers) => (...args) => run(handlers, (client) => client.query(ref, ...args));
 /**
-* An execute body for a hand-written `Command.define` — every failure already
+* An execute body for a hand-written `Command.define`—every failure already
 * folded into a Message. See `queryEffect`.
 */
 const mutationEffect = (ref, handlers) => (...args) => run(handlers, (client) => client.mutation(ref, ...args));
 /**
-* An execute body for a hand-written `Command.define` — every failure already
+* An execute body for a hand-written `Command.define`—every failure already
 * folded into a Message. See `queryEffect`.
 */
 const actionEffect = (ref, handlers) => (...args) => run(handlers, (client) => client.action(ref, ...args));
@@ -80,7 +80,7 @@ const makeFactory = (effectHelper) => {
 * ```
 *
 * Pass `interrupt` to make invocations interruptible via the returned
-* definition's `Interrupt` constructor — `true` keys them by the Command
+* definition's `Interrupt` constructor—`true` keys them by the Command
 * name, `{ keyFields, toKey }` by a part derived from the ref's args:
 *
 * ```ts

package/dist/Command.js.map

@@ -1 +1 @@
-{"version":3,"file":"Command.js","names":["Client.Client"],"sources":["../src/Command.ts"],"sourcesContent":["import type * as Ref from \"@confect/core/Ref\";\nimport * as Effect from \"effect/Effect\";\nimport * as Match from \"effect/Match\";\nimport type * as Schema from \"effect/Schema\";\nimport * as FoldkitCommand from \"foldkit/command\";\nimport * as Client from \"./Client\";\n\n/**\n * Everything a Command against `Ref_` can fail with before it is folded into\n * an `onError` Message: the ref's typed error (if it declares an `error`\n * schema), a transport-level `WebSocketClientError`, or a `SchemaError` from\n * encoding args or decoding returns.\n */\nexport type Error<Ref_ extends Ref.AnyConfect> =\n  | Ref.Error<Ref_>\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\n/**\n * Maps a Confect function's outcome into the app's Messages. Every failure —\n * the ref's typed error, a transport error, or a codec error — arrives via\n * `onError`, so the resulting Command's error channel is `never`, as Foldkit\n * requires. Follow Foldkit's naming convention: past-tense facts like\n * `SucceededSaveNote` / `FailedSaveNote`.\n */\nexport interface Handlers<\n  Ref_ extends Ref.AnyConfect,\n  SuccessMessage,\n  ErrorMessage,\n> {\n  readonly onSuccess: (returns: Ref.Returns<Ref_>) => SuccessMessage;\n  readonly onError: (error: Error<Ref_>) => ErrorMessage;\n}\n\n/**\n * The Command instance a definition call constructs.\n */\ntype Instance<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = Readonly<{\n  name: Name;\n  args: Ref.Args<Ref_>;\n  effect: Effect.Effect<Message, never, Client.Client>;\n}>;\n\ntype SchemaArgs<Ref_ extends Ref.AnyConfect> = Schema.Schema.Type<\n  Schema.Struct<Ref.ArgsSchema<Ref_>[\"fields\"]>\n>;\n\n/**\n * A Foldkit Command definition whose args are the ref's args: our\n * ref-derived call signature (args optional when the ref declares none)\n * intersected with Foldkit's own `CommandDefinitionWithArgs`, which supplies\n * the `CommandDefinitionTypeId` brand and makes the definition assignable\n * wherever Foldkit accepts one — including Story/Scene `Command.resolve`\n * and `expectExact` matchers. Call it from `update` to construct a Command\n * instance; nothing runs until the Foldkit runtime executes it.\n */\nexport type Definition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = ((...args: Ref.OptionalArgs<Ref_>) => Instance<Name, Ref_, Message>) &\n  FoldkitCommand.CommandDefinitionWithArgs<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\n/**\n * Makes a factory-built Command interruptible — Foldkit's `InterruptOption`\n * applied to the ref's args. `true` keys every invocation by the Command\n * name — right when at most one invocation is meaningfully in flight; a\n * `KeyedInterrupt` derives the key part from the ref's args, so concurrent\n * invocations can be targeted independently.\n *\n * Interrupting stops the client-side Effect and guarantees the invocation's\n * result Messages never dispatch — it does not cancel the Convex function on\n * the server, which runs to completion once the call is on the wire.\n */\nexport type InterruptOption<\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string = keyof SchemaArgs<Ref_> &\n    string,\n> = FoldkitCommand.InterruptOption<SchemaArgs<Ref_>, KeyField>;\n\n/**\n * The keyed arm of `InterruptOption`: `keyFields` declares the args the\n * `Interrupt` constructor requires; `toKey` derives the key part from them.\n */\nexport type KeyedInterrupt<\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n> = Exclude<InterruptOption<Ref_, KeyField>, true>;\n\n/**\n * An interruptible Command definition whose key is the Command name — the\n * ref-derived call signature intersected with Foldkit's\n * `Interruptible.DefinitionWithArgsNameKeyed`, which supplies the brand and\n * the `Interrupt` constructor.\n */\nexport type InterruptibleDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = ((\n  ...args: Ref.OptionalArgs<Ref_>\n) => Instance<Name, Ref_, Message> & Readonly<{ key: string }>) &\n  FoldkitCommand.Interruptible.DefinitionWithArgsNameKeyed<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\n/**\n * An interruptible Command definition whose key is derived from the ref's\n * args — the ref-derived call signature intersected with Foldkit's\n * `Interruptible.DefinitionWithArgs`, which supplies the brand and the\n * key-args-taking `Interrupt` constructor.\n */\nexport type KeyedInterruptibleDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n  Message,\n> = ((\n  ...args: Ref.OptionalArgs<Ref_>\n) => Instance<Name, Ref_, Message> & Readonly<{ key: string }>) &\n  FoldkitCommand.Interruptible.DefinitionWithArgs<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Pick<SchemaArgs<Ref_>, KeyField>,\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\nconst run = <Ref_ extends Ref.AnyConfect, SuccessMessage, ErrorMessage>(\n  handlers: Handlers<Ref_, SuccessMessage, ErrorMessage>,\n  invoke: (\n    client: Client.Client,\n  ) => Effect.Effect<Ref.Returns<Ref_>, Error<Ref_>>,\n): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n  Effect.flatMap(Client.Client, invoke).pipe(\n    Effect.match({\n      onSuccess: handlers.onSuccess,\n      onFailure: handlers.onError,\n    }),\n  );\n\n/**\n * An execute body for a hand-written `Command.define` — every failure already\n * folded into a Message. Reach for these when the factory below doesn't fit:\n * a custom args schema, `interrupt`, or a Command that makes several calls.\n */\nexport const queryEffect =\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    handlers: Handlers<Query, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Query>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.query(ref, ...args));\n\n/**\n * An execute body for a hand-written `Command.define` — every failure already\n * folded into a Message. See `queryEffect`.\n */\nexport const mutationEffect =\n  <Mutation extends Ref.AnyConfectPublicMutation, SuccessMessage, ErrorMessage>(\n    ref: Mutation,\n    handlers: Handlers<Mutation, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Mutation>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.mutation(ref, ...args));\n\n/**\n * An execute body for a hand-written `Command.define` — every failure already\n * folded into a Message. See `queryEffect`.\n */\nexport const actionEffect =\n  <Action extends Ref.AnyConfectPublicAction, SuccessMessage, ErrorMessage>(\n    ref: Action,\n    handlers: Handlers<Action, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Action>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.action(ref, ...args));\n\ntype RunWithArgs<Ref_ extends Ref.AnyConfect, Message> = (\n  ...args: Ref.OptionalArgs<Ref_>\n) => Effect.Effect<Message, never, Client.Client>;\n\nfunction makeDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  SuccessMessage,\n  ErrorMessage,\n  KeyField extends keyof SchemaArgs<Ref_> & string = keyof SchemaArgs<Ref_> &\n    string,\n>(\n  name: Name,\n  ref: Ref_,\n  messages: ReadonlyArray<Schema.Top>,\n  runWithArgs: RunWithArgs<Ref_, SuccessMessage | ErrorMessage>,\n  interrupt?: InterruptOption<Ref_, KeyField>,\n): Definition<Name, Ref_, SuccessMessage | ErrorMessage> {\n  type Fields = Ref.ArgsSchema<Ref_>[\"fields\"];\n  type FoldkitArgs = SchemaArgs<Ref_>;\n\n  const fields: Fields = ref.args.fields;\n  const execute = (args: FoldkitArgs | undefined) =>\n    runWithArgs(\n      ...((args === undefined ? [] : [args]) as Ref.OptionalArgs<Ref_>),\n    );\n\n  return Match.value(interrupt).pipe(\n    Match.withReturnType<\n      Definition<Name, Ref_, SuccessMessage | ErrorMessage>\n    >(),\n    Match.when(\n      undefined,\n      () =>\n        FoldkitCommand.define(name, {\n          args: fields,\n          messages,\n          execute,\n        }) as Definition<Name, Ref_, SuccessMessage | ErrorMessage>,\n    ),\n    Match.when(\n      true,\n      (nameKeyedInterrupt) =>\n        FoldkitCommand.define(name, {\n          args: fields,\n          messages,\n          interrupt: nameKeyedInterrupt,\n          execute,\n        }) as InterruptibleDefinition<\n          Name,\n          Ref_,\n          SuccessMessage | ErrorMessage\n        >,\n    ),\n    Match.when(Match.defined, (keyedInterrupt) => {\n      const definition: FoldkitCommand.CommandDefinitionWithArgs<\n        Name,\n        Fields,\n        ReturnType<typeof execute>\n      > = FoldkitCommand.define(name, {\n        args: fields,\n        messages,\n        interrupt: keyedInterrupt,\n        execute,\n      });\n      return definition as Definition<\n        Name,\n        Ref_,\n        SuccessMessage | ErrorMessage\n      >;\n    }),\n    Match.exhaustive,\n  );\n}\n\ntype FactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = Handlers<Ref_, SuccessMessage, ErrorMessage> & {\n  readonly messages: Messages;\n};\n\ntype KeyedFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt: KeyedInterrupt<Ref_, KeyField>;\n};\n\ntype NameKeyedFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt: true;\n};\n\ntype StandardFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt?: never;\n};\n\n/**\n * Builds the overload set for one ref kind. Each arm preserves whether\n * `interrupt` is absent, `true`, or args-keyed all the way to\n * `makeDefinition`.\n */\nconst makeFactory = <BoundRef extends Ref.AnyConfect>(\n  effectHelper: <Ref_ extends BoundRef, SuccessMessage, ErrorMessage>(\n    ref: Ref_,\n    handlers: Handlers<Ref_, SuccessMessage, ErrorMessage>,\n  ) => RunWithArgs<Ref_, SuccessMessage | ErrorMessage>,\n) => {\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n    KeyField extends keyof SchemaArgs<Ref_> & string,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: KeyedFactoryConfig<\n      Ref_,\n      Messages,\n      SuccessMessage,\n      ErrorMessage,\n      KeyField\n    >,\n  ): KeyedInterruptibleDefinition<\n    Name,\n    Ref_,\n    KeyField,\n    SuccessMessage | ErrorMessage\n  >;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: NameKeyedFactoryConfig<\n      Ref_,\n      Messages,\n      SuccessMessage,\n      ErrorMessage\n    >,\n  ): InterruptibleDefinition<Name, Ref_, SuccessMessage | ErrorMessage>;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: StandardFactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage>,\n  ): Definition<Name, Ref_, SuccessMessage | ErrorMessage>;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    SuccessMessage,\n    ErrorMessage,\n    KeyField extends keyof SchemaArgs<Ref_> & string,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: FactoryConfig<\n      Ref_,\n      ReadonlyArray<Schema.Top>,\n      SuccessMessage,\n      ErrorMessage\n    > & {\n      readonly interrupt?: InterruptOption<Ref_, KeyField>;\n    },\n  ): Definition<Name, Ref_, SuccessMessage | ErrorMessage> {\n    const runWithArgs = effectHelper(ref, config);\n    return Match.value(config.interrupt).pipe(\n      Match.withReturnType<\n        Definition<Name, Ref_, SuccessMessage | ErrorMessage>\n      >(),\n      Match.when(undefined, () =>\n        makeDefinition(name, ref, config.messages, runWithArgs),\n      ),\n      Match.when(true, (interrupt) =>\n        makeDefinition(name, ref, config.messages, runWithArgs, interrupt),\n      ),\n      Match.when(Match.defined, (interrupt) =>\n        makeDefinition(name, ref, config.messages, runWithArgs, interrupt),\n      ),\n      Match.exhaustive,\n    );\n  }\n\n  return factory;\n};\n\n/**\n * A Foldkit Command definition for a Confect query whose Command args are the\n * ref's args:\n *\n * ```ts\n * const FetchNote = Command.query(\"FetchNote\", refs.public.notes.get, {\n *   messages: [SucceededGetNote, FailedGetNote],\n *   onSuccess: (note) => SucceededGetNote({ note }),\n *   onError: (error) => FailedGetNote({ message: String(error) }),\n * })\n * // In update:\n * // [model, [FetchNote({ noteId })]]\n * ```\n *\n * Pass `interrupt` to make invocations interruptible via the returned\n * definition's `Interrupt` constructor — `true` keys them by the Command\n * name, `{ keyFields, toKey }` by a part derived from the ref's args:\n *\n * ```ts\n * const SaveDraft = Command.mutation(\"SaveDraft\", refs.public.notes.insert, {\n *   messages: [SucceededSaveDraft, FailedSaveDraft],\n *   onSuccess: (noteId) => SucceededSaveDraft({ noteId }),\n *   onError: (error) => FailedSaveDraft({ message: String(error) }),\n *   interrupt: true,\n * })\n * // In update:\n * // [model, [SaveDraft.Interrupt((outcome) => CompletedCancelSaveDraft({ outcome }))]]\n * ```\n */\nexport const query: ReturnType<typeof makeFactory<Ref.AnyConfectPublicQuery>> =\n  makeFactory(queryEffect);\n\n/**\n * A Foldkit Command definition for a Confect mutation whose Command args are\n * the ref's args. See `query`.\n */\nexport const mutation: ReturnType<\n  typeof makeFactory<Ref.AnyConfectPublicMutation>\n> = makeFactory(mutationEffect);\n\n/**\n * A Foldkit Command definition for a Confect action whose Command args are\n * the ref's args. See `query`.\n */\nexport const action: ReturnType<\n  typeof makeFactory<Ref.AnyConfectPublicAction>\n> = makeFactory(actionEffect);\n"],"mappings":";;;;;;;;;;;;;;AAyIA,MAAM,OACJ,UACA,WAIA,OAAO,QAAQA,QAAe,MAAM,CAAC,CAAC,KACpC,OAAO,MAAM;CACX,WAAW,SAAS;CACpB,WAAW,SAAS;AACtB,CAAC,CACH;;;;;;AAOF,MAAa,eAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,MAAM,KAAK,GAAG,IAAI,CAAC;;;;;AAMxD,MAAa,kBAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,SAAS,KAAK,GAAG,IAAI,CAAC;;;;;AAM3D,MAAa,gBAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,OAAO,KAAK,GAAG,IAAI,CAAC;AAMzD,SAAS,eAQP,MACA,KACA,UACA,aACA,WACuD;CAIvD,MAAM,SAAiB,IAAI,KAAK;CAChC,MAAM,WAAW,SACf,YACE,GAAK,SAAS,KAAA,IAAY,CAAC,IAAI,CAAC,IAAI,CACtC;CAEF,OAAO,MAAM,MAAM,SAAS,CAAC,CAAC,KAC5B,MAAM,eAEJ,GACF,MAAM,KACJ,KAAA,SAEE,eAAe,OAAO,MAAM;EAC1B,MAAM;EACN;EACA;CACF,CAAC,CACL,GACA,MAAM,KACJ,OACC,uBACC,eAAe,OAAO,MAAM;EAC1B,MAAM;EACN;EACA,WAAW;EACX;CACF,CAAC,CAKL,GACA,MAAM,KAAK,MAAM,UAAU,mBAAmB;EAW5C,OANI,eAAe,OAAO,MAAM;GAC9B,MAAM;GACN;GACA,WAAW;GACX;EACF,CACgB;CAKlB,CAAC,GACD,MAAM,UACR;AACF;;;;;;AA4CA,MAAM,eACJ,iBAIG;CAmDH,SAAS,QAOP,MACA,KACA,QAQuD;EACvD,MAAM,cAAc,aAAa,KAAK,MAAM;EAC5C,OAAO,MAAM,MAAM,OAAO,SAAS,CAAC,CAAC,KACnC,MAAM,eAEJ,GACF,MAAM,KAAK,KAAA,SACT,eAAe,MAAM,KAAK,OAAO,UAAU,WAAW,CACxD,GACA,MAAM,KAAK,OAAO,cAChB,eAAe,MAAM,KAAK,OAAO,UAAU,aAAa,SAAS,CACnE,GACA,MAAM,KAAK,MAAM,UAAU,cACzB,eAAe,MAAM,KAAK,OAAO,UAAU,aAAa,SAAS,CACnE,GACA,MAAM,UACR;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,QACX,YAAY,WAAW;;;;;AAMzB,MAAa,WAET,YAAY,cAAc;;;;;AAM9B,MAAa,SAET,YAAY,YAAY"}
+{"version":3,"file":"Command.js","names":["Client.Client"],"sources":["../src/Command.ts"],"sourcesContent":["import type * as Ref from \"@confect/core/Ref\";\nimport * as Effect from \"effect/Effect\";\nimport * as Match from \"effect/Match\";\nimport type * as Schema from \"effect/Schema\";\nimport * as FoldkitCommand from \"foldkit/command\";\nimport * as Client from \"./Client\";\n\n/**\n * Everything a Command against `Ref_` can fail with before it is folded into\n * an `onError` Message: the ref's typed error (if it declares an `error`\n * schema), a transport-level `WebSocketClientError`, or a `SchemaError` from\n * encoding args or decoding returns.\n */\nexport type Error<Ref_ extends Ref.AnyConfect> =\n  | Ref.Error<Ref_>\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\n/**\n * Maps a Confect function's outcome into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via\n * `onError`, so the resulting Command's error channel is `never`, as Foldkit\n * requires. Follow Foldkit's naming convention: past-tense facts like\n * `SucceededSaveNote`/`FailedSaveNote`.\n */\nexport interface Handlers<\n  Ref_ extends Ref.AnyConfect,\n  SuccessMessage,\n  ErrorMessage,\n> {\n  readonly onSuccess: (returns: Ref.Returns<Ref_>) => SuccessMessage;\n  readonly onError: (error: Error<Ref_>) => ErrorMessage;\n}\n\n/**\n * The Command instance a definition call constructs.\n */\ntype Instance<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = Readonly<{\n  name: Name;\n  args: Ref.Args<Ref_>;\n  effect: Effect.Effect<Message, never, Client.Client>;\n}>;\n\ntype SchemaArgs<Ref_ extends Ref.AnyConfect> = Schema.Schema.Type<\n  Schema.Struct<Ref.ArgsSchema<Ref_>[\"fields\"]>\n>;\n\n/**\n * A Foldkit Command definition whose args are the ref's args: our\n * ref-derived call signature (args optional when the ref declares none)\n * intersected with Foldkit's own `CommandDefinitionWithArgs`, which supplies\n * the `CommandDefinitionTypeId` brand and makes the definition assignable\n * wherever Foldkit accepts one—including Story/Scene `Command.resolve`\n * and `expectExact` matchers. Call it from `update` to construct a Command\n * instance; nothing runs until the Foldkit runtime executes it.\n */\nexport type Definition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = ((...args: Ref.OptionalArgs<Ref_>) => Instance<Name, Ref_, Message>) &\n  FoldkitCommand.CommandDefinitionWithArgs<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\n/**\n * Makes a factory-built Command interruptible—Foldkit's `InterruptOption`\n * applied to the ref's args. `true` keys every invocation by the Command\n * name—right when at most one invocation is meaningfully in flight; a\n * `KeyedInterrupt` derives the key part from the ref's args, so concurrent\n * invocations can be targeted independently.\n *\n * Interrupting stops the client-side Effect and guarantees the invocation's\n * result Messages never dispatch—it does not cancel the Convex function on\n * the server, which runs to completion once the call is on the wire.\n */\nexport type InterruptOption<\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string = keyof SchemaArgs<Ref_> &\n    string,\n> = FoldkitCommand.InterruptOption<SchemaArgs<Ref_>, KeyField>;\n\n/**\n * The keyed arm of `InterruptOption`: `keyFields` declares the args the\n * `Interrupt` constructor requires; `toKey` derives the key part from them.\n */\nexport type KeyedInterrupt<\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n> = Exclude<InterruptOption<Ref_, KeyField>, true>;\n\n/**\n * An interruptible Command definition whose key is the Command name—the\n * ref-derived call signature intersected with Foldkit's\n * `Interruptible.DefinitionWithArgsNameKeyed`, which supplies the brand and\n * the `Interrupt` constructor.\n */\nexport type InterruptibleDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  Message,\n> = ((\n  ...args: Ref.OptionalArgs<Ref_>\n) => Instance<Name, Ref_, Message> & Readonly<{ key: string }>) &\n  FoldkitCommand.Interruptible.DefinitionWithArgsNameKeyed<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\n/**\n * An interruptible Command definition whose key is derived from the ref's\n * args—the ref-derived call signature intersected with Foldkit's\n * `Interruptible.DefinitionWithArgs`, which supplies the brand and the\n * key-args-taking `Interrupt` constructor.\n */\nexport type KeyedInterruptibleDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n  Message,\n> = ((\n  ...args: Ref.OptionalArgs<Ref_>\n) => Instance<Name, Ref_, Message> & Readonly<{ key: string }>) &\n  FoldkitCommand.Interruptible.DefinitionWithArgs<\n    Name,\n    Ref.ArgsSchema<Ref_>[\"fields\"],\n    Pick<SchemaArgs<Ref_>, KeyField>,\n    Effect.Effect<Message, never, Client.Client>\n  >;\n\nconst run = <Ref_ extends Ref.AnyConfect, SuccessMessage, ErrorMessage>(\n  handlers: Handlers<Ref_, SuccessMessage, ErrorMessage>,\n  invoke: (\n    client: Client.Client,\n  ) => Effect.Effect<Ref.Returns<Ref_>, Error<Ref_>>,\n): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n  Effect.flatMap(Client.Client, invoke).pipe(\n    Effect.match({\n      onSuccess: handlers.onSuccess,\n      onFailure: handlers.onError,\n    }),\n  );\n\n/**\n * An execute body for a hand-written `Command.define`—every failure already\n * folded into a Message. Reach for these when the factory below doesn't fit:\n * a custom args schema, `interrupt`, or a Command that makes several calls.\n */\nexport const queryEffect =\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    handlers: Handlers<Query, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Query>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.query(ref, ...args));\n\n/**\n * An execute body for a hand-written `Command.define`—every failure already\n * folded into a Message. See `queryEffect`.\n */\nexport const mutationEffect =\n  <Mutation extends Ref.AnyConfectPublicMutation, SuccessMessage, ErrorMessage>(\n    ref: Mutation,\n    handlers: Handlers<Mutation, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Mutation>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.mutation(ref, ...args));\n\n/**\n * An execute body for a hand-written `Command.define`—every failure already\n * folded into a Message. See `queryEffect`.\n */\nexport const actionEffect =\n  <Action extends Ref.AnyConfectPublicAction, SuccessMessage, ErrorMessage>(\n    ref: Action,\n    handlers: Handlers<Action, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Action>\n  ): Effect.Effect<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    run(handlers, (client) => client.action(ref, ...args));\n\ntype RunWithArgs<Ref_ extends Ref.AnyConfect, Message> = (\n  ...args: Ref.OptionalArgs<Ref_>\n) => Effect.Effect<Message, never, Client.Client>;\n\nfunction makeDefinition<\n  Name extends string,\n  Ref_ extends Ref.AnyConfect,\n  SuccessMessage,\n  ErrorMessage,\n  KeyField extends keyof SchemaArgs<Ref_> & string = keyof SchemaArgs<Ref_> &\n    string,\n>(\n  name: Name,\n  ref: Ref_,\n  messages: ReadonlyArray<Schema.Top>,\n  runWithArgs: RunWithArgs<Ref_, SuccessMessage | ErrorMessage>,\n  interrupt?: InterruptOption<Ref_, KeyField>,\n): Definition<Name, Ref_, SuccessMessage | ErrorMessage> {\n  type Fields = Ref.ArgsSchema<Ref_>[\"fields\"];\n  type FoldkitArgs = SchemaArgs<Ref_>;\n\n  const fields: Fields = ref.args.fields;\n  const execute = (args: FoldkitArgs | undefined) =>\n    runWithArgs(\n      ...((args === undefined ? [] : [args]) as Ref.OptionalArgs<Ref_>),\n    );\n\n  return Match.value(interrupt).pipe(\n    Match.withReturnType<\n      Definition<Name, Ref_, SuccessMessage | ErrorMessage>\n    >(),\n    Match.when(\n      undefined,\n      () =>\n        FoldkitCommand.define(name, {\n          args: fields,\n          messages,\n          execute,\n        }) as Definition<Name, Ref_, SuccessMessage | ErrorMessage>,\n    ),\n    Match.when(\n      true,\n      (nameKeyedInterrupt) =>\n        FoldkitCommand.define(name, {\n          args: fields,\n          messages,\n          interrupt: nameKeyedInterrupt,\n          execute,\n        }) as InterruptibleDefinition<\n          Name,\n          Ref_,\n          SuccessMessage | ErrorMessage\n        >,\n    ),\n    Match.when(Match.defined, (keyedInterrupt) => {\n      const definition: FoldkitCommand.CommandDefinitionWithArgs<\n        Name,\n        Fields,\n        ReturnType<typeof execute>\n      > = FoldkitCommand.define(name, {\n        args: fields,\n        messages,\n        interrupt: keyedInterrupt,\n        execute,\n      });\n      return definition as Definition<\n        Name,\n        Ref_,\n        SuccessMessage | ErrorMessage\n      >;\n    }),\n    Match.exhaustive,\n  );\n}\n\ntype FactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = Handlers<Ref_, SuccessMessage, ErrorMessage> & {\n  readonly messages: Messages;\n};\n\ntype KeyedFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n  KeyField extends keyof SchemaArgs<Ref_> & string,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt: KeyedInterrupt<Ref_, KeyField>;\n};\n\ntype NameKeyedFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt: true;\n};\n\ntype StandardFactoryConfig<\n  Ref_ extends Ref.AnyConfect,\n  Messages extends ReadonlyArray<Schema.Top>,\n  SuccessMessage,\n  ErrorMessage,\n> = FactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage> & {\n  readonly interrupt?: never;\n};\n\n/**\n * Builds the overload set for one ref kind. Each arm preserves whether\n * `interrupt` is absent, `true`, or args-keyed all the way to\n * `makeDefinition`.\n */\nconst makeFactory = <BoundRef extends Ref.AnyConfect>(\n  effectHelper: <Ref_ extends BoundRef, SuccessMessage, ErrorMessage>(\n    ref: Ref_,\n    handlers: Handlers<Ref_, SuccessMessage, ErrorMessage>,\n  ) => RunWithArgs<Ref_, SuccessMessage | ErrorMessage>,\n) => {\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n    KeyField extends keyof SchemaArgs<Ref_> & string,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: KeyedFactoryConfig<\n      Ref_,\n      Messages,\n      SuccessMessage,\n      ErrorMessage,\n      KeyField\n    >,\n  ): KeyedInterruptibleDefinition<\n    Name,\n    Ref_,\n    KeyField,\n    SuccessMessage | ErrorMessage\n  >;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: NameKeyedFactoryConfig<\n      Ref_,\n      Messages,\n      SuccessMessage,\n      ErrorMessage\n    >,\n  ): InterruptibleDefinition<Name, Ref_, SuccessMessage | ErrorMessage>;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    const Messages extends ReadonlyArray<Schema.Top>,\n    SuccessMessage extends Schema.Schema.Type<Messages[number]>,\n    ErrorMessage extends Schema.Schema.Type<Messages[number]>,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: StandardFactoryConfig<Ref_, Messages, SuccessMessage, ErrorMessage>,\n  ): Definition<Name, Ref_, SuccessMessage | ErrorMessage>;\n  function factory<\n    const Name extends string,\n    Ref_ extends BoundRef,\n    SuccessMessage,\n    ErrorMessage,\n    KeyField extends keyof SchemaArgs<Ref_> & string,\n  >(\n    name: Name,\n    ref: Ref_,\n    config: FactoryConfig<\n      Ref_,\n      ReadonlyArray<Schema.Top>,\n      SuccessMessage,\n      ErrorMessage\n    > & {\n      readonly interrupt?: InterruptOption<Ref_, KeyField>;\n    },\n  ): Definition<Name, Ref_, SuccessMessage | ErrorMessage> {\n    const runWithArgs = effectHelper(ref, config);\n    return Match.value(config.interrupt).pipe(\n      Match.withReturnType<\n        Definition<Name, Ref_, SuccessMessage | ErrorMessage>\n      >(),\n      Match.when(undefined, () =>\n        makeDefinition(name, ref, config.messages, runWithArgs),\n      ),\n      Match.when(true, (interrupt) =>\n        makeDefinition(name, ref, config.messages, runWithArgs, interrupt),\n      ),\n      Match.when(Match.defined, (interrupt) =>\n        makeDefinition(name, ref, config.messages, runWithArgs, interrupt),\n      ),\n      Match.exhaustive,\n    );\n  }\n\n  return factory;\n};\n\n/**\n * A Foldkit Command definition for a Confect query whose Command args are the\n * ref's args:\n *\n * ```ts\n * const FetchNote = Command.query(\"FetchNote\", refs.public.notes.get, {\n *   messages: [SucceededGetNote, FailedGetNote],\n *   onSuccess: (note) => SucceededGetNote({ note }),\n *   onError: (error) => FailedGetNote({ message: String(error) }),\n * })\n * // In update:\n * // [model, [FetchNote({ noteId })]]\n * ```\n *\n * Pass `interrupt` to make invocations interruptible via the returned\n * definition's `Interrupt` constructor—`true` keys them by the Command\n * name, `{ keyFields, toKey }` by a part derived from the ref's args:\n *\n * ```ts\n * const SaveDraft = Command.mutation(\"SaveDraft\", refs.public.notes.insert, {\n *   messages: [SucceededSaveDraft, FailedSaveDraft],\n *   onSuccess: (noteId) => SucceededSaveDraft({ noteId }),\n *   onError: (error) => FailedSaveDraft({ message: String(error) }),\n *   interrupt: true,\n * })\n * // In update:\n * // [model, [SaveDraft.Interrupt((outcome) => CompletedCancelSaveDraft({ outcome }))]]\n * ```\n */\nexport const query: ReturnType<typeof makeFactory<Ref.AnyConfectPublicQuery>> =\n  makeFactory(queryEffect);\n\n/**\n * A Foldkit Command definition for a Confect mutation whose Command args are\n * the ref's args. See `query`.\n */\nexport const mutation: ReturnType<\n  typeof makeFactory<Ref.AnyConfectPublicMutation>\n> = makeFactory(mutationEffect);\n\n/**\n * A Foldkit Command definition for a Confect action whose Command args are\n * the ref's args. See `query`.\n */\nexport const action: ReturnType<\n  typeof makeFactory<Ref.AnyConfectPublicAction>\n> = makeFactory(actionEffect);\n"],"mappings":";;;;;;;;;;;;;;AAwIA,MAAM,OACJ,UACA,WAIA,OAAO,QAAQA,QAAe,MAAM,CAAC,CAAC,KACpC,OAAO,MAAM;CACX,WAAW,SAAS;CACpB,WAAW,SAAS;AACtB,CAAC,CACH;;;;;;AAOF,MAAa,eAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,MAAM,KAAK,GAAG,IAAI,CAAC;;;;;AAMxD,MAAa,kBAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,SAAS,KAAK,GAAG,IAAI,CAAC;;;;;AAM3D,MAAa,gBAET,KACA,cAGA,GAAG,SAEH,IAAI,WAAW,WAAW,OAAO,OAAO,KAAK,GAAG,IAAI,CAAC;AAMzD,SAAS,eAQP,MACA,KACA,UACA,aACA,WACuD;CAIvD,MAAM,SAAiB,IAAI,KAAK;CAChC,MAAM,WAAW,SACf,YACE,GAAK,SAAS,KAAA,IAAY,CAAC,IAAI,CAAC,IAAI,CACtC;CAEF,OAAO,MAAM,MAAM,SAAS,CAAC,CAAC,KAC5B,MAAM,eAEJ,GACF,MAAM,KACJ,KAAA,SAEE,eAAe,OAAO,MAAM;EAC1B,MAAM;EACN;EACA;CACF,CAAC,CACL,GACA,MAAM,KACJ,OACC,uBACC,eAAe,OAAO,MAAM;EAC1B,MAAM;EACN;EACA,WAAW;EACX;CACF,CAAC,CAKL,GACA,MAAM,KAAK,MAAM,UAAU,mBAAmB;EAW5C,OANI,eAAe,OAAO,MAAM;GAC9B,MAAM;GACN;GACA,WAAW;GACX;EACF,CACgB;CAKlB,CAAC,GACD,MAAM,UACR;AACF;;;;;;AA4CA,MAAM,eACJ,iBAIG;CAmDH,SAAS,QAOP,MACA,KACA,QAQuD;EACvD,MAAM,cAAc,aAAa,KAAK,MAAM;EAC5C,OAAO,MAAM,MAAM,OAAO,SAAS,CAAC,CAAC,KACnC,MAAM,eAEJ,GACF,MAAM,KAAK,KAAA,SACT,eAAe,MAAM,KAAK,OAAO,UAAU,WAAW,CACxD,GACA,MAAM,KAAK,OAAO,cAChB,eAAe,MAAM,KAAK,OAAO,UAAU,aAAa,SAAS,CACnE,GACA,MAAM,KAAK,MAAM,UAAU,cACzB,eAAe,MAAM,KAAK,OAAO,UAAU,aAAa,SAAS,CACnE,GACA,MAAM,UACR;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,QACX,YAAY,WAAW;;;;;AAMzB,MAAa,WAET,YAAY,cAAc;;;;;AAM9B,MAAa,SAET,YAAY,YAAY"}

package/dist/PaginatedQuery.d.ts

@@ -163,7 +163,17 @@ export declare const allocateRequest: <UserArgs_>(request: SubscriptionRequest<U
 export declare const close: <Item_, UserArgs_, Error_>(state: Active<Item_, UserArgs_, Error_>) => Idle;
 /** Start a fresh pagination session at page one while retaining visible data. */
 export declare const reset: <Item_, UserArgs_, Error_>(state: Active<Item_, UserArgs_, Error_>) => Active<Item_, UserArgs_, Error_>;
-/** Navigate to the next page, retaining the current page while it loads. */
+/**
+ * Navigate to the next page, retaining the current page while it loads.
+ *
+ * The page being left is pushed onto the stack *pinned* to the range it
+ * displayed—its cursor to its continuation cursor—so `prev` reloads
+ * exactly that range rather than the first `initialNumItems` documents
+ * after its cursor, however the data has moved meanwhile. Convex's own
+ * pagination keeps that range in its query journal; stream-paginated
+ * queries have no journal, so the pin is what keeps consecutive pages
+ * gap-free and duplicate-free for them.
+ */
 export declare const next: <Item_, UserArgs_, Error_>(state: Active<Item_, UserArgs_, Error_>) => Option.Option<Active<Item_, UserArgs_, Error_>>;
 /** Navigate to the previous page, retaining the current page while it loads. */
 export declare const prev: <Item_, UserArgs_, Error_>(state: Active<Item_, UserArgs_, Error_>) => Option.Option<Active<Item_, UserArgs_, Error_>>;

package/dist/PaginatedQuery.d.ts.map

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

package/dist/PaginatedQuery.js

@@ -223,20 +223,36 @@ const reset = (state) => ({
 	prevStack: [],
 	phase: pendingPhase(phaseData(state.phase), "Reset")
 });
-/** Navigate to the next page, retaining the current page while it loads. */
-const next = (state) => Match.value(state.phase).pipe(Match.withReturnType(), Match.tag("Success", ({ data }) => Match.value(data.isDone).pipe(Match.withReturnType(), Match.when(true, () => Option.none()), Match.when(false, () => Option.some({
-	...state,
-	requestId: state.requestId + 1,
-	current: {
-		cursor: Option.getOrElse(data.descriptor.endCursor, () => data.continueCursor),
-		endCursor: Option.none()
-	},
-	prevStack: [...state.prevStack, data.descriptor],
-	phase: Phase.Refreshing({
-		data,
-		direction: "Next"
-	})
-})), Match.exhaustive)), Match.tag("Loading", "Refreshing", "Failure", "Stale", () => Option.none()), Match.exhaustive);
+/**
+* Navigate to the next page, retaining the current page while it loads.
+*
+* The page being left is pushed onto the stack *pinned* to the range it
+* displayed—its cursor to its continuation cursor—so `prev` reloads
+* exactly that range rather than the first `initialNumItems` documents
+* after its cursor, however the data has moved meanwhile. Convex's own
+* pagination keeps that range in its query journal; stream-paginated
+* queries have no journal, so the pin is what keeps consecutive pages
+* gap-free and duplicate-free for them.
+*/
+const next = (state) => Match.value(state.phase).pipe(Match.withReturnType(), Match.tag("Success", ({ data }) => Match.value(data.isDone).pipe(Match.withReturnType(), Match.when(true, () => Option.none()), Match.when(false, () => {
+	const end = Option.getOrElse(data.descriptor.endCursor, () => data.continueCursor);
+	return Option.some({
+		...state,
+		requestId: state.requestId + 1,
+		current: {
+			cursor: end,
+			endCursor: Option.none()
+		},
+		prevStack: [...state.prevStack, {
+			cursor: data.descriptor.cursor,
+			endCursor: Option.some(end)
+		}],
+		phase: Phase.Refreshing({
+			data,
+			direction: "Next"
+		})
+	});
+}), Match.exhaustive)), Match.tag("Loading", "Refreshing", "Failure", "Stale", () => Option.none()), Match.exhaustive);
 /** Navigate to the previous page, retaining the current page while it loads. */
 const prev = (state) => Match.value(state.phase).pipe(Match.withReturnType(), Match.tag("Success", ({ data }) => {
 	const current = state.prevStack.at(-1);

package/dist/PaginatedQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"PaginatedQuery.js","names":["Client.WebSocketClientError"],"sources":["../src/PaginatedQuery.ts"],"sourcesContent":["import * as MiddlewareSpec from \"@confect/core/MiddlewareSpec\";\nimport * as PaginationError from \"@confect/core/PaginationError\";\nimport * as Ref from \"@confect/core/Ref\";\nimport * as Data from \"effect/Data\";\nimport * as Function from \"effect/Function\";\nimport * as Match from \"effect/Match\";\nimport * as Option from \"effect/Option\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport * as SchemaGetter from \"effect/SchemaGetter\";\nimport * as SchemaIssue from \"effect/SchemaIssue\";\nimport * as Client from \"./Client\";\n\n/** Identifies the cursor range fetched for one page. */\nexport interface PageDescriptor {\n  readonly cursor: string | null;\n  readonly endCursor: Option.Option<string>;\n}\n\nexport const PageDescriptor = Schema.Struct({\n  cursor: Schema.Union([Schema.String, Schema.Null]),\n  endCursor: Schema.Option(Schema.String),\n});\n\n/** Options that remain fixed for one pagination session. */\nexport interface Options {\n  readonly initialNumItems: number;\n  readonly maximumRowsRead?: number;\n  readonly maximumBytesRead?: number;\n}\n\nconst PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));\nconst NonNegativeInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));\n\nexport const Options = Schema.Struct({\n  initialNumItems: PositiveInt,\n  maximumRowsRead: Schema.optionalKey(PositiveInt),\n  maximumBytesRead: Schema.optionalKey(PositiveInt),\n});\n\n/** Why the machine is fetching its current target. */\nexport type Direction =\n  | \"Initial\"\n  | \"Next\"\n  | \"Previous\"\n  | \"First\"\n  | \"Split\"\n  | \"Reset\";\n\n/** A complete page that can remain on screen while another page is fetched. */\nexport interface Page<Item_> {\n  readonly descriptor: PageDescriptor;\n  readonly number: number;\n  readonly items: ReadonlyArray<Item_>;\n  readonly continueCursor: string;\n  readonly isDone: boolean;\n}\n\nexport type Loading = Data.TaggedEnum<{\n  Loading: { readonly direction: Direction };\n}>;\n\nexport type Refreshing<Item_> = Data.TaggedEnum<{\n  Refreshing: { readonly data: Page<Item_>; readonly direction: Direction };\n}>;\n\nexport type Success<Item_> = Data.TaggedEnum<{\n  Success: { readonly data: Page<Item_> };\n}>;\n\nexport type Failure<Error_> = Data.TaggedEnum<{\n  Failure: { readonly error: Error_ };\n}>;\n\nexport type Stale<Item_, Error_> = Data.TaggedEnum<{\n  Stale: { readonly data: Page<Item_>; readonly error: Error_ };\n}>;\n\nexport type Phase<Item_, Error_> =\n  | Loading\n  | Refreshing<Item_>\n  | Success<Item_>\n  | Failure<Error_>\n  | Stale<Item_, Error_>;\n\ninterface PhaseDefinition extends Data.TaggedEnum.WithGenerics<2> {\n  readonly taggedEnum: Phase<this[\"A\"], this[\"B\"]>;\n}\n\nconst Phase = Data.taggedEnum<PhaseDefinition>();\n\n/** A closed machine that retains its generation for stale-result rejection. */\nexport type Idle = Data.TaggedEnum<{\n  Idle: { readonly generation: number };\n}>;\n\n/** A live cursor-pagination session. */\nexport type Active<Item_, UserArgs_, Error_> = Data.TaggedEnum<{\n  Active: {\n    readonly generation: number;\n    readonly args: UserArgs_;\n    readonly options: Options;\n    readonly paginationId: Option.Option<number>;\n    readonly requestId: number;\n    readonly current: PageDescriptor;\n    readonly prevStack: ReadonlyArray<PageDescriptor>;\n    readonly phase: Phase<Item_, Error_>;\n  };\n}>;\n\n/** A schema-backed cursor-pagination machine. */\nexport type State<Item_, UserArgs_, Error_> =\n  | Idle\n  | Active<Item_, UserArgs_, Error_>;\n\ninterface StateDefinition extends Data.TaggedEnum.WithGenerics<3> {\n  readonly taggedEnum: State<this[\"A\"], this[\"B\"], this[\"C\"]>;\n}\n\nconst State = Data.taggedEnum<StateDefinition>();\n\n/** The logical request from which a subscription allocates a session id. */\nexport interface SubscriptionRequest<UserArgs_> {\n  readonly generation: number;\n  readonly args: UserArgs_;\n  readonly options: Options;\n  readonly paginationId: Option.Option<number>;\n  readonly requestId: number;\n  readonly descriptor: PageDescriptor;\n}\n\n/** The complete identity and arguments of a subscribed page request. */\nexport interface Request<UserArgs_> {\n  readonly generation: number;\n  readonly args: UserArgs_;\n  readonly options: Options;\n  readonly paginationId: number;\n  readonly requestId: number;\n  readonly descriptor: PageDescriptor;\n}\n\n/** The successful payload returned by a Convex paginated query. */\nexport interface PageResult<Item_> {\n  readonly page: ReadonlyArray<Item_>;\n  readonly isDone: boolean;\n  readonly continueCursor: string;\n  readonly splitCursor?: string | null;\n  readonly pageStatus?: \"SplitRecommended\" | \"SplitRequired\" | null;\n}\n\n/**\n * One correlated subscription outcome. Both success and failure travel\n * through this value so `settle` can mirror `AsyncData.settle`.\n */\nexport interface Settlement<Item_, UserArgs_, Error_> {\n  readonly request: Request<UserArgs_>;\n  readonly result: Result.Result<PageResult<Item_>, Error_>;\n}\n\nexport type Item<Query extends Ref.AnyConfectPublicPaginatedQuery> =\n  Ref.Returns<Query>[\"page\"][number];\n\nexport type UserArgs<Query extends Ref.AnyConfectPublicPaginatedQuery> = Omit<\n  Ref.Args<Query>,\n  \"paginationOpts\"\n>;\n\ntype TaggedFunctionError<Error_> = Data.TaggedEnum<{\n  FunctionError: { readonly error: Error_ };\n}>;\n\ninterface FunctionErrorDefinition extends Data.TaggedEnum.WithGenerics<1> {\n  readonly taggedEnum: TaggedFunctionError<this[\"A\"]>;\n}\n\n/** Constructs a declared function or middleware failure envelope. */\nexport const FunctionError =\n  Data.taggedEnum<FunctionErrorDefinition>().FunctionError;\n\n/** A declared function or middleware failure, kept distinct from client errors. */\nexport type FunctionError<Query extends Ref.AnyConfectPublicPaginatedQuery> = [\n  Ref.Error<Query>,\n] extends [never]\n  ? never\n  : TaggedFunctionError<Ref.Error<Query>>;\n\n/** Every failure a paginated query subscription can settle with. */\nexport type Error<Query extends Ref.AnyConfectPublicPaginatedQuery> =\n  | FunctionError<Query>\n  | PaginationError.InvalidCursor\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\nexport { InvalidCursor } from \"@confect/core/PaginationError\";\n\ntype MachineState<Query extends Ref.AnyConfectPublicPaginatedQuery> = State<\n  Item<Query>,\n  UserArgs<Query>,\n  Error<Query>\n>;\n\ntype MachineActive<Query extends Ref.AnyConfectPublicPaginatedQuery> = Active<\n  Item<Query>,\n  UserArgs<Query>,\n  Error<Query>\n>;\n\n/** The schema-and-constructor bundle returned by `make`. */\nexport interface PaginatedQuery<\n  Query extends Ref.AnyConfectPublicPaginatedQuery,\n> {\n  readonly ref: Query;\n  readonly schema: Schema.Codec<MachineState<Query>, unknown>;\n  readonly idle: Idle;\n  readonly subscriptionRequestSchema: Schema.Codec<\n    SubscriptionRequest<UserArgs<Query>>,\n    unknown\n  >;\n  readonly requestSchema: Schema.Codec<Request<UserArgs<Query>>, unknown>;\n  readonly settlement: Schema.Codec<\n    Settlement<Item<Query>, UserArgs<Query>, Error<Query>>,\n    unknown\n  >;\n  readonly init: keyof UserArgs<Query> extends never\n    ? (state: Idle, options: Options) => MachineActive<Query>\n    : (\n        state: Idle,\n        args: UserArgs<Query>,\n        options: Options,\n      ) => MachineActive<Query>;\n  readonly reinitialize: keyof UserArgs<Query> extends never\n    ? (state: MachineActive<Query>, options?: Options) => MachineActive<Query>\n    : (\n        state: MachineActive<Query>,\n        args: UserArgs<Query>,\n        options?: Options,\n      ) => MachineActive<Query>;\n}\n\nexport type Any = PaginatedQuery<Ref.AnyConfectPublicPaginatedQuery>;\n\nconst firstDescriptor = (): PageDescriptor => ({\n  cursor: null,\n  endCursor: Option.none(),\n});\n\nconst decodeOptions = Schema.decodeUnknownSync(Options);\n\nconst initialState = <Item_, UserArgs_, Error_>(\n  generation: number,\n  args: UserArgs_,\n  options: Options,\n): Active<Item_, UserArgs_, Error_> =>\n  State.Active<Item_, UserArgs_, Error_>({\n    generation,\n    args,\n    options: decodeOptions(options),\n    paginationId: Option.none(),\n    requestId: 1,\n    current: firstDescriptor(),\n    prevStack: [],\n    phase: Phase.Loading<Item_, Error_>({ direction: \"Initial\" }),\n  });\n\nconst missingPaginatedProvenanceError = (ref: Ref.AnyConfect) =>\n  new globalThis.Error(\n    `Paginated query ref \"${Ref.getConvexFunctionName(ref)}\" was not built ` +\n      \"with `FunctionSpec.publicPaginatedQuery`. `PaginatedQuery.make` \" +\n      \"requires the user-args and item schemas that constructor stores.\",\n  );\n\nconst paginatedKindOrThrow = (ref: Ref.AnyConfectPublicPaginatedQuery) =>\n  Match.value(ref.kind).pipe(\n    Match.tag(\"Paginated\", (kind) => kind),\n    Match.tag(\"Standard\", () => {\n      throw missingPaginatedProvenanceError(ref);\n    }),\n    Match.exhaustive,\n  );\n\nconst SchemaErrorJson = Schema.TaggedStruct(\"SchemaError\", {\n  message: Schema.String,\n});\n\nconst SerializableSchemaError = Schema.instanceOf(Schema.SchemaError, {\n  toCodecJson: () =>\n    Schema.link<Schema.SchemaError>()(SchemaErrorJson, {\n      decode: SchemaGetter.transform(\n        ({ message }) =>\n          new Schema.SchemaError(new SchemaIssue.InvalidValue({ message })),\n      ),\n      encode: SchemaGetter.transform((error) =>\n        SchemaErrorJson.make({ message: error.message }),\n      ),\n    }),\n});\n\n/** Builds a page machine from a paginated ref. */\nexport const make = <Query extends Ref.AnyConfectPublicPaginatedQuery>(\n  ref: Query,\n): PaginatedQuery<Query> => {\n  const kind = paginatedKindOrThrow(ref);\n  const hasUserArgs = globalThis.Object.keys(kind.userArgs.fields).length > 0;\n  const functionErrorSchemas = [\n    ...(\"error\" in ref && ref.error !== undefined ? [ref.error] : []),\n    ...MiddlewareSpec.errorSchemas(ref.middlewareSpecs),\n  ];\n  const errorSchema = Schema.Union([\n    PaginationError.InvalidCursor,\n    Client.WebSocketClientError,\n    SerializableSchemaError,\n    ...(functionErrorSchemas.length === 0\n      ? []\n      : [\n          Schema.TaggedStruct(\"FunctionError\", {\n            error:\n              functionErrorSchemas.length === 1\n                ? functionErrorSchemas[0]!\n                : Schema.Union(functionErrorSchemas),\n          }),\n        ]),\n  ]) as Schema.Codec<Error<Query>, unknown>;\n  const directions = Schema.Literals([\n    \"Initial\",\n    \"Next\",\n    \"Previous\",\n    \"First\",\n    \"Split\",\n    \"Reset\",\n  ]);\n  const page = Schema.Struct({\n    descriptor: PageDescriptor,\n    number: PositiveInt,\n    items: kind.page,\n    continueCursor: Schema.String,\n    isDone: Schema.Boolean,\n  });\n  const phase = Schema.TaggedUnion({\n    Loading: { direction: directions },\n    Refreshing: { data: page, direction: directions },\n    Success: { data: page },\n    Failure: { error: errorSchema },\n    Stale: { data: page, error: errorSchema },\n  });\n  const subscriptionRequestSchema: PaginatedQuery<Query>[\"subscriptionRequestSchema\"] =\n    Schema.Struct({\n      generation: PositiveInt,\n      args: kind.userArgs,\n      options: Options,\n      paginationId: Schema.Option(PositiveInt),\n      requestId: PositiveInt,\n      descriptor: PageDescriptor,\n    });\n  const requestSchema: PaginatedQuery<Query>[\"requestSchema\"] = Schema.Struct({\n    generation: PositiveInt,\n    args: kind.userArgs,\n    options: Options,\n    paginationId: PositiveInt,\n    requestId: PositiveInt,\n    descriptor: PageDescriptor,\n  });\n  const pageResult = Schema.Struct({\n    page: kind.page,\n    isDone: Schema.Boolean,\n    continueCursor: Schema.String,\n    splitCursor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),\n    pageStatus: Schema.optionalKey(\n      Schema.Union([\n        Schema.Literal(\"SplitRecommended\"),\n        Schema.Literal(\"SplitRequired\"),\n        Schema.Null,\n      ]),\n    ),\n  });\n  const schema: PaginatedQuery<Query>[\"schema\"] = Schema.TaggedUnion({\n    Idle: { generation: NonNegativeInt },\n    Active: {\n      generation: PositiveInt,\n      args: kind.userArgs,\n      options: Options,\n      paginationId: Schema.Option(PositiveInt),\n      requestId: PositiveInt,\n      current: PageDescriptor,\n      prevStack: Schema.Array(PageDescriptor),\n      phase,\n    },\n  });\n  const settlement: PaginatedQuery<Query>[\"settlement\"] = Schema.Struct({\n    request: requestSchema,\n    result: Schema.Result(pageResult, errorSchema),\n  });\n\n  const init: PaginatedQuery<Query>[\"init\"] = (\n    state: Idle,\n    argsOrOptions: UserArgs<Query> | Options,\n    options?: Options,\n  ): MachineActive<Query> =>\n    Match.value(options).pipe(\n      Match.withReturnType<MachineActive<Query>>(),\n      Match.when(undefined, () =>\n        initialState(\n          state.generation + 1,\n          {} as UserArgs<Query>,\n          argsOrOptions as Options,\n        ),\n      ),\n      Match.when(Match.defined, (definedOptions) =>\n        initialState(\n          state.generation + 1,\n          argsOrOptions as UserArgs<Query>,\n          definedOptions,\n        ),\n      ),\n      Match.exhaustive,\n    );\n\n  const reinitialize: PaginatedQuery<Query>[\"reinitialize\"] = (\n    state: MachineActive<Query>,\n    argsOrOptions?: UserArgs<Query> | Options,\n    options?: Options,\n  ): MachineActive<Query> =>\n    Match.value(options).pipe(\n      Match.withReturnType<MachineActive<Query>>(),\n      Match.when(Match.defined, (definedOptions) =>\n        initialState(\n          state.generation + 1,\n          argsOrOptions as UserArgs<Query>,\n          definedOptions,\n        ),\n      ),\n      Match.when(undefined, () =>\n        Match.value(argsOrOptions).pipe(\n          Match.withReturnType<MachineActive<Query>>(),\n          Match.when(undefined, () =>\n            initialState(state.generation + 1, state.args, state.options),\n          ),\n          Match.when(Match.defined, (definedArgsOrOptions) =>\n            Match.value(hasUserArgs).pipe(\n              Match.withReturnType<MachineActive<Query>>(),\n              Match.when(true, () =>\n                initialState(\n                  state.generation + 1,\n                  definedArgsOrOptions as UserArgs<Query>,\n                  state.options,\n                ),\n              ),\n              Match.when(false, () =>\n                initialState(\n                  state.generation + 1,\n                  state.args,\n                  definedArgsOrOptions as Options,\n                ),\n              ),\n              Match.exhaustive,\n            ),\n          ),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    );\n\n  return {\n    ref,\n    schema,\n    idle: State.Idle({ generation: 0 }),\n    subscriptionRequestSchema,\n    requestSchema,\n    settlement,\n    init,\n    reinitialize,\n  };\n};\n\nconst descriptorEquals = (a: PageDescriptor, b: PageDescriptor): boolean =>\n  a.cursor === b.cursor &&\n  Option.match(a.endCursor, {\n    onNone: () => Option.isNone(b.endCursor),\n    onSome: (aEnd) =>\n      Option.match(b.endCursor, {\n        onNone: () => false,\n        onSome: (bEnd) => aEnd === bEnd,\n      }),\n  });\n\n/** Returns the logical request currently driving the subscription. */\nexport const getSubscriptionRequest = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): SubscriptionRequest<UserArgs_> => ({\n  generation: state.generation,\n  args: state.args,\n  options: state.options,\n  paginationId: state.paginationId,\n  requestId: state.requestId,\n  descriptor: state.current,\n});\n\n/** Attaches the client-allocated pagination id to a logical request. */\nexport const allocateRequest = <UserArgs_>(\n  request: SubscriptionRequest<UserArgs_>,\n  paginationId: number,\n): Request<UserArgs_> => ({\n  ...request,\n  paginationId,\n});\n\nconst phaseData = <Item_, Error_>(\n  phase: Phase<Item_, Error_>,\n): Option.Option<Page<Item_>> =>\n  Match.value(phase).pipe(\n    Match.withReturnType<Option.Option<Page<Item_>>>(),\n    Match.tag(\"Refreshing\", \"Success\", \"Stale\", (dataPhase) =>\n      Option.some(dataPhase.data),\n    ),\n    Match.tag(\"Loading\", \"Failure\", () => Option.none()),\n    Match.exhaustive,\n  );\n\nconst pendingPhase = <Item_>(\n  data: Option.Option<Page<Item_>>,\n  direction: Direction,\n): Loading | Refreshing<Item_> =>\n  Option.match(data, {\n    onNone: () => Phase.Loading<Item_, never>({ direction }),\n    onSome: (page) => Phase.Refreshing<Item_, never>({ data: page, direction }),\n  });\n\n/** Close the subscription while retaining its generation tombstone. */\nexport const close = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Idle => State.Idle({ generation: state.generation });\n\n/** Start a fresh pagination session at page one while retaining visible data. */\nexport const reset = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Active<Item_, UserArgs_, Error_> => ({\n  ...state,\n  generation: state.generation + 1,\n  paginationId: Option.none(),\n  requestId: 1,\n  current: firstDescriptor(),\n  prevStack: [],\n  phase: pendingPhase(phaseData(state.phase), \"Reset\"),\n});\n\n/** Navigate to the next page, retaining the current page while it loads. */\nexport const next = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(state.phase).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.tag(\"Success\", ({ data }) =>\n      Match.value(data.isDone).pipe(\n        Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n        Match.when(true, () => Option.none()),\n        Match.when(false, () =>\n          Option.some({\n            ...state,\n            requestId: state.requestId + 1,\n            current: {\n              cursor: Option.getOrElse(\n                data.descriptor.endCursor,\n                () => data.continueCursor,\n              ),\n              endCursor: Option.none(),\n            },\n            prevStack: [...state.prevStack, data.descriptor],\n            phase: Phase.Refreshing<Item_, Error_>({\n              data,\n              direction: \"Next\",\n            }),\n          }),\n        ),\n        Match.exhaustive,\n      ),\n    ),\n    Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => Option.none()),\n    Match.exhaustive,\n  );\n\n/** Navigate to the previous page, retaining the current page while it loads. */\nexport const prev = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(state.phase).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.tag(\"Success\", ({ data }) => {\n      const current = state.prevStack.at(-1);\n      return Match.value(current).pipe(\n        Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n        Match.when(undefined, () => Option.none()),\n        Match.when(Match.defined, (previous) =>\n          Option.some({\n            ...state,\n            requestId: state.requestId + 1,\n            current: previous,\n            prevStack: state.prevStack.slice(0, -1),\n            phase: Phase.Refreshing<Item_, Error_>({\n              data,\n              direction: \"Previous\",\n            }),\n          }),\n        ),\n        Match.exhaustive,\n      );\n    }),\n    Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => Option.none()),\n    Match.exhaustive,\n  );\n\n/** Navigate to page one without invalidating the current pagination session. */\nexport const first = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(\n    state.prevStack.length === 0 &&\n      descriptorEquals(state.current, firstDescriptor()),\n  ).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.when(true, () => Option.none()),\n    Match.when(false, () =>\n      Option.some({\n        ...state,\n        requestId: state.requestId + 1,\n        current: firstDescriptor(),\n        prevStack: [],\n        phase: pendingPhase(phaseData(state.phase), \"First\"),\n      }),\n    ),\n    Match.exhaustive,\n  );\n\n/** Whether a request still names the machine's live pagination session/page. */\nexport const isCurrentRequest = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n  candidate: Request<UserArgs_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", (active) =>\n      Match.value(active.paginationId).pipe(\n        Match.tag(\"None\", () =>\n          Match.value(\n            active.generation === candidate.generation &&\n              active.requestId === candidate.requestId &&\n              descriptorEquals(active.current, candidate.descriptor),\n          ).pipe(\n            Match.when(true, () => true),\n            Match.when(false, () => false),\n            Match.exhaustive,\n          ),\n        ),\n        Match.tag(\n          \"Some\",\n          ({ value }) =>\n            active.generation === candidate.generation &&\n            value === candidate.paginationId &&\n            active.requestId === candidate.requestId &&\n            descriptorEquals(active.current, candidate.descriptor),\n        ),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nconst pageFromResult = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  result: PageResult<Item_>,\n): Page<Item_> => ({\n  descriptor: state.current,\n  number: state.prevStack.length + 1,\n  items: result.page,\n  continueCursor: result.continueCursor,\n  isDone: result.isDone,\n});\n\nconst settleSuccess = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  result: PageResult<Item_>,\n): Active<Item_, UserArgs_, Error_> => {\n  const splitCursor = result.splitCursor;\n  const splitSignaled = Match.value(result.pageStatus).pipe(\n    Match.whenOr(\"SplitRecommended\", \"SplitRequired\", () => true),\n    Match.whenOr(null, undefined, () => false),\n    Match.exhaustive,\n  );\n  const shouldSplit =\n    typeof splitCursor === \"string\" &&\n    (splitSignaled || result.page.length > 2 * state.options.initialNumItems);\n  const shouldRetreat =\n    result.page.length === 0 && result.isDone && state.prevStack.length > 0;\n\n  return Match.value(shouldSplit).pipe(\n    Match.withReturnType<Active<Item_, UserArgs_, Error_>>(),\n    Match.when(true, () => {\n      const deliveredPage = pageFromResult(state, result);\n      const previous = Match.value(result.pageStatus).pipe(\n        Match.withReturnType<Option.Option<Page<Item_>>>(),\n        Match.when(\"SplitRequired\", () => phaseData(state.phase)),\n        Match.whenOr(\"SplitRecommended\", null, undefined, () =>\n          Option.some(deliveredPage),\n        ),\n        Match.exhaustive,\n      );\n      return {\n        ...state,\n        requestId: state.requestId + 1,\n        current: {\n          cursor: state.current.cursor,\n          endCursor: Option.fromNullishOr(splitCursor),\n        },\n        phase: pendingPhase(previous, \"Split\"),\n      };\n    }),\n    Match.when(false, () =>\n      Match.value(shouldRetreat).pipe(\n        Match.withReturnType<Active<Item_, UserArgs_, Error_>>(),\n        Match.when(true, () => ({\n          ...state,\n          requestId: state.requestId + 1,\n          current: state.prevStack[state.prevStack.length - 1],\n          prevStack: state.prevStack.slice(0, -1),\n          phase: pendingPhase(phaseData(state.phase), \"Previous\"),\n        })),\n        Match.when(false, () => ({\n          ...state,\n          phase: Phase.Success<Item_, Error_>({\n            data: pageFromResult(state, result),\n          }),\n        })),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n};\n\nconst settleFailure = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  error: Error_,\n): Active<Item_, UserArgs_, Error_> => ({\n  ...state,\n  phase: Option.match(phaseData(state.phase), {\n    onNone: () => Phase.Failure<Item_, Error_>({ error }),\n    onSome: (data) => Phase.Stale<Item_, Error_>({ error, data }),\n  }),\n});\n\n/**\n * Fold a correlated `Result` into the machine. Like `AsyncData.settle`, a\n * success becomes `Success`; a failure becomes `Stale` when a page is held,\n * otherwise `Failure`. Outcomes from superseded requests and outcomes that\n * arrive after the subscription closed are ignored.\n */\nexport const settle: {\n  <Item_, UserArgs_, Error_>(\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): (\n    state: State<Item_, UserArgs_, Error_>,\n  ) => State<Item_, UserArgs_, Error_>;\n  <Item_, UserArgs_, Error_>(\n    state: State<Item_, UserArgs_, Error_>,\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): State<Item_, UserArgs_, Error_>;\n} = Function.dual(\n  2,\n  <Item_, UserArgs_, Error_>(\n    state: State<Item_, UserArgs_, Error_>,\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): State<Item_, UserArgs_, Error_> =>\n    Match.value(state).pipe(\n      Match.withReturnType<State<Item_, UserArgs_, Error_>>(),\n      Match.tag(\"Idle\", () => state),\n      Match.tag(\"Active\", (active) =>\n        Match.value(isCurrentRequest(active, settlement.request)).pipe(\n          Match.when(false, () => active),\n          Match.when(true, () => {\n            const allocated = {\n              ...active,\n              paginationId: Option.some(settlement.request.paginationId),\n            };\n            return Result.match(settlement.result, {\n              onSuccess: (result) => settleSuccess(allocated, result),\n              onFailure: (error) =>\n                Match.value(error).pipe(\n                  Match.when(\n                    Match.instanceOf(PaginationError.InvalidCursor),\n                    () => reset(allocated),\n                  ),\n                  Match.orElse((other) => settleFailure(allocated, other)),\n                ),\n            });\n          }),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    ),\n);\n\n/** The complete page currently available to render. */\nexport const getPage = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<Page<Item_>> =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => Option.none()),\n    Match.tag(\"Active\", ({ phase }) => phaseData(phase)),\n    Match.exhaustive,\n  );\n\n/** The items currently available to render. */\nexport const getItems = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<ReadonlyArray<Item_>> =>\n  Option.map(getPage(state), (page) => page.items);\n\n/** The error from the most recent failed request, if any. */\nexport const getError = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<Error_> =>\n  Match.value(state).pipe(\n    Match.withReturnType<Option.Option<Error_>>(),\n    Match.tag(\"Idle\", () => Option.none()),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.withReturnType<Option.Option<Error_>>(),\n        Match.tag(\"Failure\", \"Stale\", ({ error }) => Option.some(error)),\n        Match.tag(\"Loading\", \"Refreshing\", \"Success\", () => Option.none()),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\n/** The 1-indexed page number currently targeted by the subscription. */\nexport const targetPageNumber = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): number => state.prevStack.length + 1;\n\nexport const hasPage = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean => Option.isSome(getPage(state));\n\nexport const hasError = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean => Option.isSome(getError(state));\n\nexport const isFirst = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ prevStack }) => prevStack.length === 0),\n    Match.exhaustive,\n  );\n\nexport const isLast = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", ({ data }) => data.isDone),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\ntype WithPhase<State_, Phase_> = Omit<State_, \"phase\"> & {\n  readonly phase: Phase_;\n};\n\nexport const isIdle = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is Idle => state._tag === \"Idle\";\n\nexport const isLoading = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Loading> =>\n  state._tag === \"Active\" && state.phase._tag === \"Loading\";\n\nexport const isRefreshing = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Refreshing<Item_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Refreshing\";\n\nexport const isSuccess = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Success<Item_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Success\";\n\nexport const isFailure = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Failure<Error_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Failure\";\n\nexport const isStale = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Stale<Item_, Error_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Stale\";\n\nexport const isPending = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Loading\", \"Refreshing\", () => true),\n        Match.tag(\"Success\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nexport const canNext = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", ({ data }) => !data.isDone),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nexport const canPrev = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase, prevStack }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", () => prevStack.length > 0),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\n/** Pattern-match exhaustively on the machine's AsyncData-style state. */\nexport const match: {\n  <Item_, Error_, A, B, C, D, E, F>(handlers: {\n    readonly onIdle: (idle: Idle) => A;\n    readonly onLoading: (loading: Loading) => B;\n    readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n    readonly onFailure: (failure: Failure<Error_>) => D;\n    readonly onStale: (stale: Stale<Item_, Error_>) => E;\n    readonly onSuccess: (success: Success<Item_>) => F;\n  }): <UserArgs_>(\n    state: State<Item_, UserArgs_, Error_>,\n  ) => A | B | C | D | E | F;\n  <Item_, UserArgs_, Error_, A, B, C, D, E, F>(\n    state: State<Item_, UserArgs_, Error_>,\n    handlers: {\n      readonly onIdle: (idle: Idle) => A;\n      readonly onLoading: (loading: Loading) => B;\n      readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n      readonly onFailure: (failure: Failure<Error_>) => D;\n      readonly onStale: (stale: Stale<Item_, Error_>) => E;\n      readonly onSuccess: (success: Success<Item_>) => F;\n    },\n  ): A | B | C | D | E | F;\n} = Function.dual(\n  2,\n  <Item_, UserArgs_, Error_, A, B, C, D, E, F>(\n    state: State<Item_, UserArgs_, Error_>,\n    handlers: {\n      readonly onIdle: (idle: Idle) => A;\n      readonly onLoading: (loading: Loading) => B;\n      readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n      readonly onFailure: (failure: Failure<Error_>) => D;\n      readonly onStale: (stale: Stale<Item_, Error_>) => E;\n      readonly onSuccess: (success: Success<Item_>) => F;\n    },\n  ): A | B | C | D | E | F =>\n    Match.value(state).pipe(\n      Match.tag(\"Idle\", handlers.onIdle),\n      Match.tag(\"Active\", ({ phase }) =>\n        Match.value(phase).pipe(\n          Match.tag(\"Loading\", handlers.onLoading),\n          Match.tag(\"Refreshing\", handlers.onRefreshing),\n          Match.tag(\"Failure\", handlers.onFailure),\n          Match.tag(\"Stale\", handlers.onStale),\n          Match.tag(\"Success\", handlers.onSuccess),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    ) as A | B | C | D | E | F,\n);\n"],"mappings":"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"}
+{"version":3,"file":"PaginatedQuery.js","names":["Client.WebSocketClientError"],"sources":["../src/PaginatedQuery.ts"],"sourcesContent":["import * as MiddlewareSpec from \"@confect/core/MiddlewareSpec\";\nimport * as PaginationError from \"@confect/core/PaginationError\";\nimport * as Ref from \"@confect/core/Ref\";\nimport * as Data from \"effect/Data\";\nimport * as Function from \"effect/Function\";\nimport * as Match from \"effect/Match\";\nimport * as Option from \"effect/Option\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport * as SchemaGetter from \"effect/SchemaGetter\";\nimport * as SchemaIssue from \"effect/SchemaIssue\";\nimport * as Client from \"./Client\";\n\n/** Identifies the cursor range fetched for one page. */\nexport interface PageDescriptor {\n  readonly cursor: string | null;\n  readonly endCursor: Option.Option<string>;\n}\n\nexport const PageDescriptor = Schema.Struct({\n  cursor: Schema.Union([Schema.String, Schema.Null]),\n  endCursor: Schema.Option(Schema.String),\n});\n\n/** Options that remain fixed for one pagination session. */\nexport interface Options {\n  readonly initialNumItems: number;\n  readonly maximumRowsRead?: number;\n  readonly maximumBytesRead?: number;\n}\n\nconst PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));\nconst NonNegativeInt = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));\n\nexport const Options = Schema.Struct({\n  initialNumItems: PositiveInt,\n  maximumRowsRead: Schema.optionalKey(PositiveInt),\n  maximumBytesRead: Schema.optionalKey(PositiveInt),\n});\n\n/** Why the machine is fetching its current target. */\nexport type Direction =\n  | \"Initial\"\n  | \"Next\"\n  | \"Previous\"\n  | \"First\"\n  | \"Split\"\n  | \"Reset\";\n\n/** A complete page that can remain on screen while another page is fetched. */\nexport interface Page<Item_> {\n  readonly descriptor: PageDescriptor;\n  readonly number: number;\n  readonly items: ReadonlyArray<Item_>;\n  readonly continueCursor: string;\n  readonly isDone: boolean;\n}\n\nexport type Loading = Data.TaggedEnum<{\n  Loading: { readonly direction: Direction };\n}>;\n\nexport type Refreshing<Item_> = Data.TaggedEnum<{\n  Refreshing: { readonly data: Page<Item_>; readonly direction: Direction };\n}>;\n\nexport type Success<Item_> = Data.TaggedEnum<{\n  Success: { readonly data: Page<Item_> };\n}>;\n\nexport type Failure<Error_> = Data.TaggedEnum<{\n  Failure: { readonly error: Error_ };\n}>;\n\nexport type Stale<Item_, Error_> = Data.TaggedEnum<{\n  Stale: { readonly data: Page<Item_>; readonly error: Error_ };\n}>;\n\nexport type Phase<Item_, Error_> =\n  | Loading\n  | Refreshing<Item_>\n  | Success<Item_>\n  | Failure<Error_>\n  | Stale<Item_, Error_>;\n\ninterface PhaseDefinition extends Data.TaggedEnum.WithGenerics<2> {\n  readonly taggedEnum: Phase<this[\"A\"], this[\"B\"]>;\n}\n\nconst Phase = Data.taggedEnum<PhaseDefinition>();\n\n/** A closed machine that retains its generation for stale-result rejection. */\nexport type Idle = Data.TaggedEnum<{\n  Idle: { readonly generation: number };\n}>;\n\n/** A live cursor-pagination session. */\nexport type Active<Item_, UserArgs_, Error_> = Data.TaggedEnum<{\n  Active: {\n    readonly generation: number;\n    readonly args: UserArgs_;\n    readonly options: Options;\n    readonly paginationId: Option.Option<number>;\n    readonly requestId: number;\n    readonly current: PageDescriptor;\n    readonly prevStack: ReadonlyArray<PageDescriptor>;\n    readonly phase: Phase<Item_, Error_>;\n  };\n}>;\n\n/** A schema-backed cursor-pagination machine. */\nexport type State<Item_, UserArgs_, Error_> =\n  | Idle\n  | Active<Item_, UserArgs_, Error_>;\n\ninterface StateDefinition extends Data.TaggedEnum.WithGenerics<3> {\n  readonly taggedEnum: State<this[\"A\"], this[\"B\"], this[\"C\"]>;\n}\n\nconst State = Data.taggedEnum<StateDefinition>();\n\n/** The logical request from which a subscription allocates a session id. */\nexport interface SubscriptionRequest<UserArgs_> {\n  readonly generation: number;\n  readonly args: UserArgs_;\n  readonly options: Options;\n  readonly paginationId: Option.Option<number>;\n  readonly requestId: number;\n  readonly descriptor: PageDescriptor;\n}\n\n/** The complete identity and arguments of a subscribed page request. */\nexport interface Request<UserArgs_> {\n  readonly generation: number;\n  readonly args: UserArgs_;\n  readonly options: Options;\n  readonly paginationId: number;\n  readonly requestId: number;\n  readonly descriptor: PageDescriptor;\n}\n\n/** The successful payload returned by a Convex paginated query. */\nexport interface PageResult<Item_> {\n  readonly page: ReadonlyArray<Item_>;\n  readonly isDone: boolean;\n  readonly continueCursor: string;\n  readonly splitCursor?: string | null;\n  readonly pageStatus?: \"SplitRecommended\" | \"SplitRequired\" | null;\n}\n\n/**\n * One correlated subscription outcome. Both success and failure travel\n * through this value so `settle` can mirror `AsyncData.settle`.\n */\nexport interface Settlement<Item_, UserArgs_, Error_> {\n  readonly request: Request<UserArgs_>;\n  readonly result: Result.Result<PageResult<Item_>, Error_>;\n}\n\nexport type Item<Query extends Ref.AnyConfectPublicPaginatedQuery> =\n  Ref.Returns<Query>[\"page\"][number];\n\nexport type UserArgs<Query extends Ref.AnyConfectPublicPaginatedQuery> = Omit<\n  Ref.Args<Query>,\n  \"paginationOpts\"\n>;\n\ntype TaggedFunctionError<Error_> = Data.TaggedEnum<{\n  FunctionError: { readonly error: Error_ };\n}>;\n\ninterface FunctionErrorDefinition extends Data.TaggedEnum.WithGenerics<1> {\n  readonly taggedEnum: TaggedFunctionError<this[\"A\"]>;\n}\n\n/** Constructs a declared function or middleware failure envelope. */\nexport const FunctionError =\n  Data.taggedEnum<FunctionErrorDefinition>().FunctionError;\n\n/** A declared function or middleware failure, kept distinct from client errors. */\nexport type FunctionError<Query extends Ref.AnyConfectPublicPaginatedQuery> = [\n  Ref.Error<Query>,\n] extends [never]\n  ? never\n  : TaggedFunctionError<Ref.Error<Query>>;\n\n/** Every failure a paginated query subscription can settle with. */\nexport type Error<Query extends Ref.AnyConfectPublicPaginatedQuery> =\n  | FunctionError<Query>\n  | PaginationError.InvalidCursor\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\nexport { InvalidCursor } from \"@confect/core/PaginationError\";\n\ntype MachineState<Query extends Ref.AnyConfectPublicPaginatedQuery> = State<\n  Item<Query>,\n  UserArgs<Query>,\n  Error<Query>\n>;\n\ntype MachineActive<Query extends Ref.AnyConfectPublicPaginatedQuery> = Active<\n  Item<Query>,\n  UserArgs<Query>,\n  Error<Query>\n>;\n\n/** The schema-and-constructor bundle returned by `make`. */\nexport interface PaginatedQuery<\n  Query extends Ref.AnyConfectPublicPaginatedQuery,\n> {\n  readonly ref: Query;\n  readonly schema: Schema.Codec<MachineState<Query>, unknown>;\n  readonly idle: Idle;\n  readonly subscriptionRequestSchema: Schema.Codec<\n    SubscriptionRequest<UserArgs<Query>>,\n    unknown\n  >;\n  readonly requestSchema: Schema.Codec<Request<UserArgs<Query>>, unknown>;\n  readonly settlement: Schema.Codec<\n    Settlement<Item<Query>, UserArgs<Query>, Error<Query>>,\n    unknown\n  >;\n  readonly init: keyof UserArgs<Query> extends never\n    ? (state: Idle, options: Options) => MachineActive<Query>\n    : (\n        state: Idle,\n        args: UserArgs<Query>,\n        options: Options,\n      ) => MachineActive<Query>;\n  readonly reinitialize: keyof UserArgs<Query> extends never\n    ? (state: MachineActive<Query>, options?: Options) => MachineActive<Query>\n    : (\n        state: MachineActive<Query>,\n        args: UserArgs<Query>,\n        options?: Options,\n      ) => MachineActive<Query>;\n}\n\nexport type Any = PaginatedQuery<Ref.AnyConfectPublicPaginatedQuery>;\n\nconst firstDescriptor = (): PageDescriptor => ({\n  cursor: null,\n  endCursor: Option.none(),\n});\n\nconst decodeOptions = Schema.decodeUnknownSync(Options);\n\nconst initialState = <Item_, UserArgs_, Error_>(\n  generation: number,\n  args: UserArgs_,\n  options: Options,\n): Active<Item_, UserArgs_, Error_> =>\n  State.Active<Item_, UserArgs_, Error_>({\n    generation,\n    args,\n    options: decodeOptions(options),\n    paginationId: Option.none(),\n    requestId: 1,\n    current: firstDescriptor(),\n    prevStack: [],\n    phase: Phase.Loading<Item_, Error_>({ direction: \"Initial\" }),\n  });\n\nconst missingPaginatedProvenanceError = (ref: Ref.AnyConfect) =>\n  new globalThis.Error(\n    `Paginated query ref \"${Ref.getConvexFunctionName(ref)}\" was not built ` +\n      \"with `FunctionSpec.publicPaginatedQuery`. `PaginatedQuery.make` \" +\n      \"requires the user-args and item schemas that constructor stores.\",\n  );\n\nconst paginatedKindOrThrow = (ref: Ref.AnyConfectPublicPaginatedQuery) =>\n  Match.value(ref.kind).pipe(\n    Match.tag(\"Paginated\", (kind) => kind),\n    Match.tag(\"Standard\", () => {\n      throw missingPaginatedProvenanceError(ref);\n    }),\n    Match.exhaustive,\n  );\n\nconst SchemaErrorJson = Schema.TaggedStruct(\"SchemaError\", {\n  message: Schema.String,\n});\n\nconst SerializableSchemaError = Schema.instanceOf(Schema.SchemaError, {\n  toCodecJson: () =>\n    Schema.link<Schema.SchemaError>()(SchemaErrorJson, {\n      decode: SchemaGetter.transform(\n        ({ message }) =>\n          new Schema.SchemaError(new SchemaIssue.InvalidValue({ message })),\n      ),\n      encode: SchemaGetter.transform((error) =>\n        SchemaErrorJson.make({ message: error.message }),\n      ),\n    }),\n});\n\n/** Builds a page machine from a paginated ref. */\nexport const make = <Query extends Ref.AnyConfectPublicPaginatedQuery>(\n  ref: Query,\n): PaginatedQuery<Query> => {\n  const kind = paginatedKindOrThrow(ref);\n  const hasUserArgs = globalThis.Object.keys(kind.userArgs.fields).length > 0;\n  const functionErrorSchemas = [\n    ...(\"error\" in ref && ref.error !== undefined ? [ref.error] : []),\n    ...MiddlewareSpec.errorSchemas(ref.middlewareSpecs),\n  ];\n  const errorSchema = Schema.Union([\n    PaginationError.InvalidCursor,\n    Client.WebSocketClientError,\n    SerializableSchemaError,\n    ...(functionErrorSchemas.length === 0\n      ? []\n      : [\n          Schema.TaggedStruct(\"FunctionError\", {\n            error:\n              functionErrorSchemas.length === 1\n                ? functionErrorSchemas[0]!\n                : Schema.Union(functionErrorSchemas),\n          }),\n        ]),\n  ]) as Schema.Codec<Error<Query>, unknown>;\n  const directions = Schema.Literals([\n    \"Initial\",\n    \"Next\",\n    \"Previous\",\n    \"First\",\n    \"Split\",\n    \"Reset\",\n  ]);\n  const page = Schema.Struct({\n    descriptor: PageDescriptor,\n    number: PositiveInt,\n    items: kind.page,\n    continueCursor: Schema.String,\n    isDone: Schema.Boolean,\n  });\n  const phase = Schema.TaggedUnion({\n    Loading: { direction: directions },\n    Refreshing: { data: page, direction: directions },\n    Success: { data: page },\n    Failure: { error: errorSchema },\n    Stale: { data: page, error: errorSchema },\n  });\n  const subscriptionRequestSchema: PaginatedQuery<Query>[\"subscriptionRequestSchema\"] =\n    Schema.Struct({\n      generation: PositiveInt,\n      args: kind.userArgs,\n      options: Options,\n      paginationId: Schema.Option(PositiveInt),\n      requestId: PositiveInt,\n      descriptor: PageDescriptor,\n    });\n  const requestSchema: PaginatedQuery<Query>[\"requestSchema\"] = Schema.Struct({\n    generation: PositiveInt,\n    args: kind.userArgs,\n    options: Options,\n    paginationId: PositiveInt,\n    requestId: PositiveInt,\n    descriptor: PageDescriptor,\n  });\n  const pageResult = Schema.Struct({\n    page: kind.page,\n    isDone: Schema.Boolean,\n    continueCursor: Schema.String,\n    splitCursor: Schema.optionalKey(Schema.Union([Schema.String, Schema.Null])),\n    pageStatus: Schema.optionalKey(\n      Schema.Union([\n        Schema.Literal(\"SplitRecommended\"),\n        Schema.Literal(\"SplitRequired\"),\n        Schema.Null,\n      ]),\n    ),\n  });\n  const schema: PaginatedQuery<Query>[\"schema\"] = Schema.TaggedUnion({\n    Idle: { generation: NonNegativeInt },\n    Active: {\n      generation: PositiveInt,\n      args: kind.userArgs,\n      options: Options,\n      paginationId: Schema.Option(PositiveInt),\n      requestId: PositiveInt,\n      current: PageDescriptor,\n      prevStack: Schema.Array(PageDescriptor),\n      phase,\n    },\n  });\n  const settlement: PaginatedQuery<Query>[\"settlement\"] = Schema.Struct({\n    request: requestSchema,\n    result: Schema.Result(pageResult, errorSchema),\n  });\n\n  const init: PaginatedQuery<Query>[\"init\"] = (\n    state: Idle,\n    argsOrOptions: UserArgs<Query> | Options,\n    options?: Options,\n  ): MachineActive<Query> =>\n    Match.value(options).pipe(\n      Match.withReturnType<MachineActive<Query>>(),\n      Match.when(undefined, () =>\n        initialState(\n          state.generation + 1,\n          {} as UserArgs<Query>,\n          argsOrOptions as Options,\n        ),\n      ),\n      Match.when(Match.defined, (definedOptions) =>\n        initialState(\n          state.generation + 1,\n          argsOrOptions as UserArgs<Query>,\n          definedOptions,\n        ),\n      ),\n      Match.exhaustive,\n    );\n\n  const reinitialize: PaginatedQuery<Query>[\"reinitialize\"] = (\n    state: MachineActive<Query>,\n    argsOrOptions?: UserArgs<Query> | Options,\n    options?: Options,\n  ): MachineActive<Query> =>\n    Match.value(options).pipe(\n      Match.withReturnType<MachineActive<Query>>(),\n      Match.when(Match.defined, (definedOptions) =>\n        initialState(\n          state.generation + 1,\n          argsOrOptions as UserArgs<Query>,\n          definedOptions,\n        ),\n      ),\n      Match.when(undefined, () =>\n        Match.value(argsOrOptions).pipe(\n          Match.withReturnType<MachineActive<Query>>(),\n          Match.when(undefined, () =>\n            initialState(state.generation + 1, state.args, state.options),\n          ),\n          Match.when(Match.defined, (definedArgsOrOptions) =>\n            Match.value(hasUserArgs).pipe(\n              Match.withReturnType<MachineActive<Query>>(),\n              Match.when(true, () =>\n                initialState(\n                  state.generation + 1,\n                  definedArgsOrOptions as UserArgs<Query>,\n                  state.options,\n                ),\n              ),\n              Match.when(false, () =>\n                initialState(\n                  state.generation + 1,\n                  state.args,\n                  definedArgsOrOptions as Options,\n                ),\n              ),\n              Match.exhaustive,\n            ),\n          ),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    );\n\n  return {\n    ref,\n    schema,\n    idle: State.Idle({ generation: 0 }),\n    subscriptionRequestSchema,\n    requestSchema,\n    settlement,\n    init,\n    reinitialize,\n  };\n};\n\nconst descriptorEquals = (a: PageDescriptor, b: PageDescriptor): boolean =>\n  a.cursor === b.cursor &&\n  Option.match(a.endCursor, {\n    onNone: () => Option.isNone(b.endCursor),\n    onSome: (aEnd) =>\n      Option.match(b.endCursor, {\n        onNone: () => false,\n        onSome: (bEnd) => aEnd === bEnd,\n      }),\n  });\n\n/** Returns the logical request currently driving the subscription. */\nexport const getSubscriptionRequest = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): SubscriptionRequest<UserArgs_> => ({\n  generation: state.generation,\n  args: state.args,\n  options: state.options,\n  paginationId: state.paginationId,\n  requestId: state.requestId,\n  descriptor: state.current,\n});\n\n/** Attaches the client-allocated pagination id to a logical request. */\nexport const allocateRequest = <UserArgs_>(\n  request: SubscriptionRequest<UserArgs_>,\n  paginationId: number,\n): Request<UserArgs_> => ({\n  ...request,\n  paginationId,\n});\n\nconst phaseData = <Item_, Error_>(\n  phase: Phase<Item_, Error_>,\n): Option.Option<Page<Item_>> =>\n  Match.value(phase).pipe(\n    Match.withReturnType<Option.Option<Page<Item_>>>(),\n    Match.tag(\"Refreshing\", \"Success\", \"Stale\", (dataPhase) =>\n      Option.some(dataPhase.data),\n    ),\n    Match.tag(\"Loading\", \"Failure\", () => Option.none()),\n    Match.exhaustive,\n  );\n\nconst pendingPhase = <Item_>(\n  data: Option.Option<Page<Item_>>,\n  direction: Direction,\n): Loading | Refreshing<Item_> =>\n  Option.match(data, {\n    onNone: () => Phase.Loading<Item_, never>({ direction }),\n    onSome: (page) => Phase.Refreshing<Item_, never>({ data: page, direction }),\n  });\n\n/** Close the subscription while retaining its generation tombstone. */\nexport const close = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Idle => State.Idle({ generation: state.generation });\n\n/** Start a fresh pagination session at page one while retaining visible data. */\nexport const reset = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Active<Item_, UserArgs_, Error_> => ({\n  ...state,\n  generation: state.generation + 1,\n  paginationId: Option.none(),\n  requestId: 1,\n  current: firstDescriptor(),\n  prevStack: [],\n  phase: pendingPhase(phaseData(state.phase), \"Reset\"),\n});\n\n/**\n * Navigate to the next page, retaining the current page while it loads.\n *\n * The page being left is pushed onto the stack *pinned* to the range it\n * displayed—its cursor to its continuation cursor—so `prev` reloads\n * exactly that range rather than the first `initialNumItems` documents\n * after its cursor, however the data has moved meanwhile. Convex's own\n * pagination keeps that range in its query journal; stream-paginated\n * queries have no journal, so the pin is what keeps consecutive pages\n * gap-free and duplicate-free for them.\n */\nexport const next = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(state.phase).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.tag(\"Success\", ({ data }) =>\n      Match.value(data.isDone).pipe(\n        Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n        Match.when(true, () => Option.none()),\n        Match.when(false, () => {\n          const end = Option.getOrElse(\n            data.descriptor.endCursor,\n            () => data.continueCursor,\n          );\n          return Option.some({\n            ...state,\n            requestId: state.requestId + 1,\n            current: { cursor: end, endCursor: Option.none() },\n            prevStack: [\n              ...state.prevStack,\n              { cursor: data.descriptor.cursor, endCursor: Option.some(end) },\n            ],\n            phase: Phase.Refreshing<Item_, Error_>({\n              data,\n              direction: \"Next\",\n            }),\n          });\n        }),\n        Match.exhaustive,\n      ),\n    ),\n    Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => Option.none()),\n    Match.exhaustive,\n  );\n\n/** Navigate to the previous page, retaining the current page while it loads. */\nexport const prev = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(state.phase).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.tag(\"Success\", ({ data }) => {\n      const current = state.prevStack.at(-1);\n      return Match.value(current).pipe(\n        Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n        Match.when(undefined, () => Option.none()),\n        Match.when(Match.defined, (previous) =>\n          Option.some({\n            ...state,\n            requestId: state.requestId + 1,\n            current: previous,\n            prevStack: state.prevStack.slice(0, -1),\n            phase: Phase.Refreshing<Item_, Error_>({\n              data,\n              direction: \"Previous\",\n            }),\n          }),\n        ),\n        Match.exhaustive,\n      );\n    }),\n    Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => Option.none()),\n    Match.exhaustive,\n  );\n\n/** Navigate to page one without invalidating the current pagination session. */\nexport const first = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): Option.Option<Active<Item_, UserArgs_, Error_>> =>\n  Match.value(\n    state.prevStack.length === 0 &&\n      descriptorEquals(state.current, firstDescriptor()),\n  ).pipe(\n    Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),\n    Match.when(true, () => Option.none()),\n    Match.when(false, () =>\n      Option.some({\n        ...state,\n        requestId: state.requestId + 1,\n        current: firstDescriptor(),\n        prevStack: [],\n        phase: pendingPhase(phaseData(state.phase), \"First\"),\n      }),\n    ),\n    Match.exhaustive,\n  );\n\n/** Whether a request still names the machine's live pagination session/page. */\nexport const isCurrentRequest = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n  candidate: Request<UserArgs_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", (active) =>\n      Match.value(active.paginationId).pipe(\n        Match.tag(\"None\", () =>\n          Match.value(\n            active.generation === candidate.generation &&\n              active.requestId === candidate.requestId &&\n              descriptorEquals(active.current, candidate.descriptor),\n          ).pipe(\n            Match.when(true, () => true),\n            Match.when(false, () => false),\n            Match.exhaustive,\n          ),\n        ),\n        Match.tag(\n          \"Some\",\n          ({ value }) =>\n            active.generation === candidate.generation &&\n            value === candidate.paginationId &&\n            active.requestId === candidate.requestId &&\n            descriptorEquals(active.current, candidate.descriptor),\n        ),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nconst pageFromResult = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  result: PageResult<Item_>,\n): Page<Item_> => ({\n  descriptor: state.current,\n  number: state.prevStack.length + 1,\n  items: result.page,\n  continueCursor: result.continueCursor,\n  isDone: result.isDone,\n});\n\nconst settleSuccess = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  result: PageResult<Item_>,\n): Active<Item_, UserArgs_, Error_> => {\n  const splitCursor = result.splitCursor;\n  const splitSignaled = Match.value(result.pageStatus).pipe(\n    Match.whenOr(\"SplitRecommended\", \"SplitRequired\", () => true),\n    Match.whenOr(null, undefined, () => false),\n    Match.exhaustive,\n  );\n  const shouldSplit =\n    typeof splitCursor === \"string\" &&\n    (splitSignaled || result.page.length > 2 * state.options.initialNumItems);\n  const shouldRetreat =\n    result.page.length === 0 && result.isDone && state.prevStack.length > 0;\n\n  return Match.value(shouldSplit).pipe(\n    Match.withReturnType<Active<Item_, UserArgs_, Error_>>(),\n    Match.when(true, () => {\n      const deliveredPage = pageFromResult(state, result);\n      const previous = Match.value(result.pageStatus).pipe(\n        Match.withReturnType<Option.Option<Page<Item_>>>(),\n        Match.when(\"SplitRequired\", () => phaseData(state.phase)),\n        Match.whenOr(\"SplitRecommended\", null, undefined, () =>\n          Option.some(deliveredPage),\n        ),\n        Match.exhaustive,\n      );\n      return {\n        ...state,\n        requestId: state.requestId + 1,\n        current: {\n          cursor: state.current.cursor,\n          endCursor: Option.fromNullishOr(splitCursor),\n        },\n        phase: pendingPhase(previous, \"Split\"),\n      };\n    }),\n    Match.when(false, () =>\n      Match.value(shouldRetreat).pipe(\n        Match.withReturnType<Active<Item_, UserArgs_, Error_>>(),\n        Match.when(true, () => ({\n          ...state,\n          requestId: state.requestId + 1,\n          current: state.prevStack[state.prevStack.length - 1],\n          prevStack: state.prevStack.slice(0, -1),\n          phase: pendingPhase(phaseData(state.phase), \"Previous\"),\n        })),\n        Match.when(false, () => ({\n          ...state,\n          phase: Phase.Success<Item_, Error_>({\n            data: pageFromResult(state, result),\n          }),\n        })),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n};\n\nconst settleFailure = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n  error: Error_,\n): Active<Item_, UserArgs_, Error_> => ({\n  ...state,\n  phase: Option.match(phaseData(state.phase), {\n    onNone: () => Phase.Failure<Item_, Error_>({ error }),\n    onSome: (data) => Phase.Stale<Item_, Error_>({ error, data }),\n  }),\n});\n\n/**\n * Fold a correlated `Result` into the machine. Like `AsyncData.settle`, a\n * success becomes `Success`; a failure becomes `Stale` when a page is held,\n * otherwise `Failure`. Outcomes from superseded requests and outcomes that\n * arrive after the subscription closed are ignored.\n */\nexport const settle: {\n  <Item_, UserArgs_, Error_>(\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): (\n    state: State<Item_, UserArgs_, Error_>,\n  ) => State<Item_, UserArgs_, Error_>;\n  <Item_, UserArgs_, Error_>(\n    state: State<Item_, UserArgs_, Error_>,\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): State<Item_, UserArgs_, Error_>;\n} = Function.dual(\n  2,\n  <Item_, UserArgs_, Error_>(\n    state: State<Item_, UserArgs_, Error_>,\n    settlement: Settlement<Item_, UserArgs_, Error_>,\n  ): State<Item_, UserArgs_, Error_> =>\n    Match.value(state).pipe(\n      Match.withReturnType<State<Item_, UserArgs_, Error_>>(),\n      Match.tag(\"Idle\", () => state),\n      Match.tag(\"Active\", (active) =>\n        Match.value(isCurrentRequest(active, settlement.request)).pipe(\n          Match.when(false, () => active),\n          Match.when(true, () => {\n            const allocated = {\n              ...active,\n              paginationId: Option.some(settlement.request.paginationId),\n            };\n            return Result.match(settlement.result, {\n              onSuccess: (result) => settleSuccess(allocated, result),\n              onFailure: (error) =>\n                Match.value(error).pipe(\n                  Match.when(\n                    Match.instanceOf(PaginationError.InvalidCursor),\n                    () => reset(allocated),\n                  ),\n                  Match.orElse((other) => settleFailure(allocated, other)),\n                ),\n            });\n          }),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    ),\n);\n\n/** The complete page currently available to render. */\nexport const getPage = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<Page<Item_>> =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => Option.none()),\n    Match.tag(\"Active\", ({ phase }) => phaseData(phase)),\n    Match.exhaustive,\n  );\n\n/** The items currently available to render. */\nexport const getItems = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<ReadonlyArray<Item_>> =>\n  Option.map(getPage(state), (page) => page.items);\n\n/** The error from the most recent failed request, if any. */\nexport const getError = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): Option.Option<Error_> =>\n  Match.value(state).pipe(\n    Match.withReturnType<Option.Option<Error_>>(),\n    Match.tag(\"Idle\", () => Option.none()),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.withReturnType<Option.Option<Error_>>(),\n        Match.tag(\"Failure\", \"Stale\", ({ error }) => Option.some(error)),\n        Match.tag(\"Loading\", \"Refreshing\", \"Success\", () => Option.none()),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\n/** The 1-indexed page number currently targeted by the subscription. */\nexport const targetPageNumber = <Item_, UserArgs_, Error_>(\n  state: Active<Item_, UserArgs_, Error_>,\n): number => state.prevStack.length + 1;\n\nexport const hasPage = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean => Option.isSome(getPage(state));\n\nexport const hasError = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean => Option.isSome(getError(state));\n\nexport const isFirst = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ prevStack }) => prevStack.length === 0),\n    Match.exhaustive,\n  );\n\nexport const isLast = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", ({ data }) => data.isDone),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\ntype WithPhase<State_, Phase_> = Omit<State_, \"phase\"> & {\n  readonly phase: Phase_;\n};\n\nexport const isIdle = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is Idle => state._tag === \"Idle\";\n\nexport const isLoading = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Loading> =>\n  state._tag === \"Active\" && state.phase._tag === \"Loading\";\n\nexport const isRefreshing = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Refreshing<Item_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Refreshing\";\n\nexport const isSuccess = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Success<Item_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Success\";\n\nexport const isFailure = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Failure<Error_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Failure\";\n\nexport const isStale = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): state is WithPhase<Active<Item_, UserArgs_, Error_>, Stale<Item_, Error_>> =>\n  state._tag === \"Active\" && state.phase._tag === \"Stale\";\n\nexport const isPending = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Loading\", \"Refreshing\", () => true),\n        Match.tag(\"Success\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nexport const canNext = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", ({ data }) => !data.isDone),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\nexport const canPrev = <Item_, UserArgs_, Error_>(\n  state: State<Item_, UserArgs_, Error_>,\n): boolean =>\n  Match.value(state).pipe(\n    Match.tag(\"Idle\", () => false),\n    Match.tag(\"Active\", ({ phase, prevStack }) =>\n      Match.value(phase).pipe(\n        Match.tag(\"Success\", () => prevStack.length > 0),\n        Match.tag(\"Loading\", \"Refreshing\", \"Failure\", \"Stale\", () => false),\n        Match.exhaustive,\n      ),\n    ),\n    Match.exhaustive,\n  );\n\n/** Pattern-match exhaustively on the machine's AsyncData-style state. */\nexport const match: {\n  <Item_, Error_, A, B, C, D, E, F>(handlers: {\n    readonly onIdle: (idle: Idle) => A;\n    readonly onLoading: (loading: Loading) => B;\n    readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n    readonly onFailure: (failure: Failure<Error_>) => D;\n    readonly onStale: (stale: Stale<Item_, Error_>) => E;\n    readonly onSuccess: (success: Success<Item_>) => F;\n  }): <UserArgs_>(\n    state: State<Item_, UserArgs_, Error_>,\n  ) => A | B | C | D | E | F;\n  <Item_, UserArgs_, Error_, A, B, C, D, E, F>(\n    state: State<Item_, UserArgs_, Error_>,\n    handlers: {\n      readonly onIdle: (idle: Idle) => A;\n      readonly onLoading: (loading: Loading) => B;\n      readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n      readonly onFailure: (failure: Failure<Error_>) => D;\n      readonly onStale: (stale: Stale<Item_, Error_>) => E;\n      readonly onSuccess: (success: Success<Item_>) => F;\n    },\n  ): A | B | C | D | E | F;\n} = Function.dual(\n  2,\n  <Item_, UserArgs_, Error_, A, B, C, D, E, F>(\n    state: State<Item_, UserArgs_, Error_>,\n    handlers: {\n      readonly onIdle: (idle: Idle) => A;\n      readonly onLoading: (loading: Loading) => B;\n      readonly onRefreshing: (refreshing: Refreshing<Item_>) => C;\n      readonly onFailure: (failure: Failure<Error_>) => D;\n      readonly onStale: (stale: Stale<Item_, Error_>) => E;\n      readonly onSuccess: (success: Success<Item_>) => F;\n    },\n  ): A | B | C | D | E | F =>\n    Match.value(state).pipe(\n      Match.tag(\"Idle\", handlers.onIdle),\n      Match.tag(\"Active\", ({ phase }) =>\n        Match.value(phase).pipe(\n          Match.tag(\"Loading\", handlers.onLoading),\n          Match.tag(\"Refreshing\", handlers.onRefreshing),\n          Match.tag(\"Failure\", handlers.onFailure),\n          Match.tag(\"Stale\", handlers.onStale),\n          Match.tag(\"Success\", handlers.onSuccess),\n          Match.exhaustive,\n        ),\n      ),\n      Match.exhaustive,\n    ) as A | B | C | D | E | F,\n);\n"],"mappings":"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"}

package/dist/Subscription.d.ts

@@ -22,8 +22,7 @@ export interface Dependencies<Query extends Ref.AnyConfectPublicQuery> {
     readonly args: Option.Option<Ref.Args<Query>>;
 }
 /**
- * Maps a reactive query's emissions into the app's Messages. Every failure —
- * the ref's typed error, a transport error, or a codec error — arrives via
+ * Maps a reactive query's emissions into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via
  * `onError`, so the resulting stream's error channel is `never`, as Foldkit
  * requires.
  */

package/dist/Subscription.d.ts.map

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

package/dist/Subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"Subscription.js","names":["Client.WebSocketClientError","PaginatedQuery.FunctionError","PaginatedQuery.getSubscriptionRequest","Client.Client","PaginatedQuery.allocateRequest"],"sources":["../src/Subscription.ts"],"sourcesContent":["import * as PaginationError from \"@confect/core/PaginationError\";\nimport type * as Ref from \"@confect/core/Ref\";\nimport * as Effect from \"effect/Effect\";\nimport type * as Equivalence from \"effect/Equivalence\";\nimport * as Match from \"effect/Match\";\nimport * as Option from \"effect/Option\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport * as Stream from \"effect/Stream\";\nimport type * as FoldkitSubscription from \"foldkit/subscription\";\nimport * as PaginatedQuery from \"./PaginatedQuery\";\nimport * as Client from \"./Client\";\n\n/**\n * Everything a reactive query subscription against `Query` can fail with: the\n * ref's typed error (if it declares an `error` schema), a transport-level\n * `WebSocketClientError`, or a `SchemaError` from encoding args or decoding\n * returns.\n */\nexport type Error<Query extends Ref.AnyConfectPublicQuery> =\n  | Ref.Error<Query>\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\nconst paginatedError = <Query extends Ref.AnyConfectPublicPaginatedQuery>(\n  error: Error<Query>,\n): PaginatedQuery.Error<Query> =>\n  Match.value(error).pipe(\n    Match.when(Schema.isSchemaError, (schemaError) => schemaError),\n    Match.when(Match.instanceOf(Client.WebSocketClientError), (clientError) =>\n      PaginationError.fromConvexQueryError(clientError.cause).pipe(\n        Option.getOrElse(() => clientError),\n      ),\n    ),\n    Match.when(Match.any, (functionError) =>\n      PaginationError.fromConvexErrorData(functionError).pipe(\n        Option.getOrElse(() =>\n          PaginatedQuery.FunctionError({ error: functionError }),\n        ),\n      ),\n    ),\n    Match.exhaustive,\n  ) as PaginatedQuery.Error<Query>;\n\n/**\n * The dependency record of a `reactiveQuery` entry. `None` means the\n * subscription is closed; a change from one `Some` to another tears the\n * server subscription down and reopens it with the new args.\n */\nexport interface Dependencies<Query extends Ref.AnyConfectPublicQuery> {\n  readonly args: Option.Option<Ref.Args<Query>>;\n}\n\n/**\n * Maps a reactive query's emissions into the app's Messages. Every failure —\n * the ref's typed error, a transport error, or a codec error — arrives via\n * `onError`, so the resulting stream's error channel is `never`, as Foldkit\n * requires.\n */\nexport interface Handlers<\n  Query extends Ref.AnyConfectPublicQuery,\n  SuccessMessage,\n  ErrorMessage,\n> {\n  readonly onSuccess: (returns: Ref.Returns<Query>) => SuccessMessage;\n  readonly onError: (error: Error<Query>) => ErrorMessage;\n}\n\n/**\n * The `args` extractor is required whenever the query declares args; queries\n * without args may omit it, in which case the subscription is always open.\n */\ntype ArgsConfig<Query extends Ref.AnyConfectPublicQuery, Model> = {\n  readonly args?: (model: Model) => Option.Option<Ref.Args<Query>>;\n} & (keyof Ref.Args<Query> extends never\n  ? unknown\n  : {\n      readonly args: (model: Model) => Option.Option<Ref.Args<Query>>;\n    });\n\n/**\n * A `dependenciesToStream` body for a hand-written subscription entry: runs\n * the ref as a reactive query against the `Client` resource and maps\n * every emission and every failure into a Message. Query failures are values,\n * so the subscription remains live and can later emit a successful result.\n *\n * Prefer `reactiveQuery`, which builds the whole entry; reach for this when\n * you need control over the entry's dependencies (custom gating, extra\n * dependencies).\n */\nexport const reactiveQueryStream =\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    handlers: Handlers<Query, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Query>\n  ): Stream.Stream<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    Client.Client.pipe(\n      Effect.map((client) => client.reactiveQueryResult(ref, ...args)),\n      Stream.unwrap,\n      Stream.map(\n        Result.match({\n          onSuccess: handlers.onSuccess,\n          onFailure: handlers.onError,\n        }),\n      ),\n    );\n\n/**\n * A complete Foldkit subscription entry for a Confect reactive query. The\n * leading thunk fixes the `Model` type (TypeScript cannot partially infer\n * type arguments), so the `args` extractor's parameter is already typed.\n * Pass the result as an entry value to `Subscription.make`:\n *\n * ```ts\n * import * as Confect from \"@confect/foldkit\"\n * import * as Subscription from \"foldkit/subscription\"\n *\n * const subscriptions = Subscription.make<\n *   Model,\n *   Message,\n *   Confect.Client.Client\n * >()(() => ({\n *   note: Confect.Subscription.reactiveQuery<Model>()(refs.public.notes.get, {\n *     args: (model) => Option.map(model.noteId, (noteId) => ({ noteId })),\n *     onSuccess: (note) => SucceededGetNote({ note }),\n *     onError: (error) => FailedGetNote({ message: String(error) }),\n *   }),\n * }))\n * ```\n *\n * The entry's dependencies are the query args wrapped in `Option`: `None`\n * closes the subscription, a change from one `Some` to another unsubscribes\n * and resubscribes with the new args, and structurally equal args leave the\n * subscription running (equivalence is derived from the ref's args schema).\n * Queries without args may omit `args`, leaving the subscription always open.\n */\nexport const reactiveQuery =\n  <Model>() =>\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    config: Handlers<Query, SuccessMessage, ErrorMessage> &\n      ArgsConfig<Query, Model>,\n  ): FoldkitSubscription.EntryWithoutKeepAlive<\n    Model,\n    SuccessMessage | ErrorMessage,\n    Dependencies<Query>,\n    Client.Client\n  > => {\n    const modelToArgs = config.args;\n\n    return {\n      dependenciesSchema: Schema.Struct({\n        args: Schema.Option(ref.args),\n      }),\n      modelToDependencies: (model) => ({\n        args:\n          modelToArgs === undefined\n            ? Option.some({} as Ref.Args<Query>)\n            : modelToArgs(model),\n      }),\n      dependenciesToStream: ({ args }) =>\n        Option.match(args, {\n          onNone: () => Stream.empty,\n          onSome: (someArgs) => reactiveQueryStream(ref, config)(someArgs),\n        }),\n    };\n  };\n\n/**\n * A complete Foldkit subscription entry that keeps exactly one live reactive\n * page subscription in sync with a `PaginatedQuery` machine in the Model.\n * The machine state is the single source of truth: navigation and\n * split-pinning change the derived args, while `Idle` closes the subscription.\n * Pagination ids are allocated here and installed by the first settlement.\n *\n * The leading thunk fixes the `Model` type (TypeScript cannot partially\n * infer type arguments), so the `state` extractor's parameter is already\n * typed:\n *\n * ```ts\n * import * as Confect from \"@confect/foldkit\"\n * import * as Subscription from \"foldkit/subscription\"\n *\n * const subscriptions = Subscription.make<\n *   Model,\n *   Message,\n *   Confect.Client.Client\n * >()(() => ({\n *   notesPage: Confect.Subscription.paginatedQuery<Model>()(Notes, {\n *     state: (model) => model.notes,\n *     onSettled: (settlement) => SettledGetNotesPage({ settlement }),\n *   }),\n * }))\n * ```\n *\n * Pass the settlement to `PaginatedQuery.settle` in `update`. The request\n * identity is included in both success and failure Messages, so superseded\n * outcomes cannot settle a newer page or pagination session. Query failures\n * do not close the Convex subscription; a later result can recover naturally.\n */\ntype DependenciesSchema<Dependencies_> = Schema.Schema<Dependencies_> & {\n  readonly fields: Schema.Struct.Fields;\n};\n\ntype EntryWithKeepAlive<Model, Message, Dependencies_, Services> = {\n  readonly dependenciesSchema: DependenciesSchema<Dependencies_>;\n  readonly modelToDependencies: (model: Model) => Dependencies_;\n  readonly keepAliveEquivalence: Equivalence.Equivalence<Dependencies_>;\n  readonly dependenciesToStream: (\n    dependencies: Dependencies_,\n    readDependencies: () => Dependencies_,\n  ) => Stream.Stream<Message, never, Services>;\n};\n\nexport const paginatedQuery =\n  <Model>() =>\n  <\n    PaginatedQueryRef extends Ref.AnyConfectPublicPaginatedQuery,\n    SettledMessage,\n  >(\n    machine: PaginatedQuery.PaginatedQuery<PaginatedQueryRef>,\n    config: {\n      readonly state: (\n        model: Model,\n      ) => PaginatedQuery.State<\n        PaginatedQuery.Item<PaginatedQueryRef>,\n        PaginatedQuery.UserArgs<PaginatedQueryRef>,\n        PaginatedQuery.Error<PaginatedQueryRef>\n      >;\n      readonly onSettled: (\n        settlement: PaginatedQuery.Settlement<\n          PaginatedQuery.Item<PaginatedQueryRef>,\n          PaginatedQuery.UserArgs<PaginatedQueryRef>,\n          PaginatedQuery.Error<PaginatedQueryRef>\n        >,\n      ) => SettledMessage;\n    },\n  ): EntryWithKeepAlive<\n    Model,\n    SettledMessage,\n    {\n      readonly request: Option.Option<\n        PaginatedQuery.SubscriptionRequest<\n          PaginatedQuery.UserArgs<PaginatedQueryRef>\n        >\n      >;\n    },\n    Client.Client\n  > => {\n    const ref = machine.ref;\n    const composedArgsSchema = ref.args;\n    const requestEquivalence = Schema.toEquivalence(\n      machine.subscriptionRequestSchema,\n    );\n    const optionalRequestEquivalence = Option.makeEquivalence<\n      PaginatedQuery.SubscriptionRequest<\n        PaginatedQuery.UserArgs<PaginatedQueryRef>\n      >\n    >((left, right) =>\n      requestEquivalence(\n        { ...left, paginationId: Option.none() },\n        { ...right, paginationId: Option.none() },\n      ),\n    );\n\n    return {\n      dependenciesSchema: Schema.Struct({\n        request: Schema.Option(machine.subscriptionRequestSchema),\n      }),\n      modelToDependencies: (model) => ({\n        request: Match.value(config.state(model)).pipe(\n          Match.tag(\"Idle\", () => Option.none()),\n          Match.tag(\"Active\", (state) =>\n            Option.some(PaginatedQuery.getSubscriptionRequest(state)),\n          ),\n          Match.exhaustive,\n        ),\n      }),\n      keepAliveEquivalence: (left, right) =>\n        optionalRequestEquivalence(left.request, right.request),\n      dependenciesToStream: ({\n        request,\n      }): Stream.Stream<SettledMessage, never, Client.Client> =>\n        Option.match(request, {\n          onNone: () => Stream.empty,\n          onSome: (subscriptionRequest) =>\n            Stream.unwrap(\n              Effect.gen(function* () {\n                const client = yield* Client.Client;\n                const paginationId = yield* client.resolvePaginationId(\n                  subscriptionRequest.paginationId,\n                );\n                const allocatedRequest = PaginatedQuery.allocateRequest(\n                  subscriptionRequest,\n                  paginationId,\n                );\n                const { descriptor, options } = allocatedRequest;\n                const composedArgs = composedArgsSchema.make({\n                  ...allocatedRequest.args,\n                  paginationOpts: {\n                    numItems: options.initialNumItems,\n                    cursor: descriptor.cursor,\n                    id: paginationId,\n                    ...Match.value(options.maximumRowsRead).pipe(\n                      Match.when(undefined, () => ({})),\n                      Match.when(Match.defined, (maximumRowsRead) => ({\n                        maximumRowsRead,\n                      })),\n                      Match.exhaustive,\n                    ),\n                    ...Match.value(options.maximumBytesRead).pipe(\n                      Match.when(undefined, () => ({})),\n                      Match.when(Match.defined, (maximumBytesRead) => ({\n                        maximumBytesRead,\n                      })),\n                      Match.exhaustive,\n                    ),\n                    ...Option.match(descriptor.endCursor, {\n                      onNone: () => ({}),\n                      onSome: (endCursor) => ({ endCursor }),\n                    }),\n                  },\n                });\n                return client.reactiveQueryResult(ref, composedArgs).pipe(\n                  Stream.map((result) =>\n                    config.onSettled({\n                      request: allocatedRequest,\n                      result: Result.mapError(result, paginatedError),\n                    }),\n                  ),\n                );\n              }),\n            ),\n        }),\n    };\n  };\n"],"mappings":"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"}
+{"version":3,"file":"Subscription.js","names":["Client.WebSocketClientError","PaginatedQuery.FunctionError","PaginatedQuery.getSubscriptionRequest","Client.Client","PaginatedQuery.allocateRequest"],"sources":["../src/Subscription.ts"],"sourcesContent":["import * as PaginationError from \"@confect/core/PaginationError\";\nimport type * as Ref from \"@confect/core/Ref\";\nimport * as Effect from \"effect/Effect\";\nimport type * as Equivalence from \"effect/Equivalence\";\nimport * as Match from \"effect/Match\";\nimport * as Option from \"effect/Option\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport * as Stream from \"effect/Stream\";\nimport type * as FoldkitSubscription from \"foldkit/subscription\";\nimport * as PaginatedQuery from \"./PaginatedQuery\";\nimport * as Client from \"./Client\";\n\n/**\n * Everything a reactive query subscription against `Query` can fail with: the\n * ref's typed error (if it declares an `error` schema), a transport-level\n * `WebSocketClientError`, or a `SchemaError` from encoding args or decoding\n * returns.\n */\nexport type Error<Query extends Ref.AnyConfectPublicQuery> =\n  | Ref.Error<Query>\n  | Client.WebSocketClientError\n  | Schema.SchemaError;\n\nconst paginatedError = <Query extends Ref.AnyConfectPublicPaginatedQuery>(\n  error: Error<Query>,\n): PaginatedQuery.Error<Query> =>\n  Match.value(error).pipe(\n    Match.when(Schema.isSchemaError, (schemaError) => schemaError),\n    Match.when(Match.instanceOf(Client.WebSocketClientError), (clientError) =>\n      PaginationError.fromConvexQueryError(clientError.cause).pipe(\n        Option.getOrElse(() => clientError),\n      ),\n    ),\n    Match.when(Match.any, (functionError) =>\n      PaginationError.fromConvexErrorData(functionError).pipe(\n        Option.getOrElse(() =>\n          PaginatedQuery.FunctionError({ error: functionError }),\n        ),\n      ),\n    ),\n    Match.exhaustive,\n  ) as PaginatedQuery.Error<Query>;\n\n/**\n * The dependency record of a `reactiveQuery` entry. `None` means the\n * subscription is closed; a change from one `Some` to another tears the\n * server subscription down and reopens it with the new args.\n */\nexport interface Dependencies<Query extends Ref.AnyConfectPublicQuery> {\n  readonly args: Option.Option<Ref.Args<Query>>;\n}\n\n/**\n * Maps a reactive query's emissions into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via\n * `onError`, so the resulting stream's error channel is `never`, as Foldkit\n * requires.\n */\nexport interface Handlers<\n  Query extends Ref.AnyConfectPublicQuery,\n  SuccessMessage,\n  ErrorMessage,\n> {\n  readonly onSuccess: (returns: Ref.Returns<Query>) => SuccessMessage;\n  readonly onError: (error: Error<Query>) => ErrorMessage;\n}\n\n/**\n * The `args` extractor is required whenever the query declares args; queries\n * without args may omit it, in which case the subscription is always open.\n */\ntype ArgsConfig<Query extends Ref.AnyConfectPublicQuery, Model> = {\n  readonly args?: (model: Model) => Option.Option<Ref.Args<Query>>;\n} & (keyof Ref.Args<Query> extends never\n  ? unknown\n  : {\n      readonly args: (model: Model) => Option.Option<Ref.Args<Query>>;\n    });\n\n/**\n * A `dependenciesToStream` body for a hand-written subscription entry: runs\n * the ref as a reactive query against the `Client` resource and maps\n * every emission and every failure into a Message. Query failures are values,\n * so the subscription remains live and can later emit a successful result.\n *\n * Prefer `reactiveQuery`, which builds the whole entry; reach for this when\n * you need control over the entry's dependencies (custom gating, extra\n * dependencies).\n */\nexport const reactiveQueryStream =\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    handlers: Handlers<Query, SuccessMessage, ErrorMessage>,\n  ) =>\n  (\n    ...args: Ref.OptionalArgs<Query>\n  ): Stream.Stream<SuccessMessage | ErrorMessage, never, Client.Client> =>\n    Client.Client.pipe(\n      Effect.map((client) => client.reactiveQueryResult(ref, ...args)),\n      Stream.unwrap,\n      Stream.map(\n        Result.match({\n          onSuccess: handlers.onSuccess,\n          onFailure: handlers.onError,\n        }),\n      ),\n    );\n\n/**\n * A complete Foldkit subscription entry for a Confect reactive query. The\n * leading thunk fixes the `Model` type (TypeScript cannot partially infer\n * type arguments), so the `args` extractor's parameter is already typed.\n * Pass the result as an entry value to `Subscription.make`:\n *\n * ```ts\n * import * as Confect from \"@confect/foldkit\"\n * import * as Subscription from \"foldkit/subscription\"\n *\n * const subscriptions = Subscription.make<\n *   Model,\n *   Message,\n *   Confect.Client.Client\n * >()(() => ({\n *   note: Confect.Subscription.reactiveQuery<Model>()(refs.public.notes.get, {\n *     args: (model) => Option.map(model.noteId, (noteId) => ({ noteId })),\n *     onSuccess: (note) => SucceededGetNote({ note }),\n *     onError: (error) => FailedGetNote({ message: String(error) }),\n *   }),\n * }))\n * ```\n *\n * The entry's dependencies are the query args wrapped in `Option`: `None`\n * closes the subscription, a change from one `Some` to another unsubscribes\n * and resubscribes with the new args, and structurally equal args leave the\n * subscription running (equivalence is derived from the ref's args schema).\n * Queries without args may omit `args`, leaving the subscription always open.\n */\nexport const reactiveQuery =\n  <Model>() =>\n  <Query extends Ref.AnyConfectPublicQuery, SuccessMessage, ErrorMessage>(\n    ref: Query,\n    config: Handlers<Query, SuccessMessage, ErrorMessage> &\n      ArgsConfig<Query, Model>,\n  ): FoldkitSubscription.EntryWithoutKeepAlive<\n    Model,\n    SuccessMessage | ErrorMessage,\n    Dependencies<Query>,\n    Client.Client\n  > => {\n    const modelToArgs = config.args;\n\n    return {\n      dependenciesSchema: Schema.Struct({\n        args: Schema.Option(ref.args),\n      }),\n      modelToDependencies: (model) => ({\n        args:\n          modelToArgs === undefined\n            ? Option.some({} as Ref.Args<Query>)\n            : modelToArgs(model),\n      }),\n      dependenciesToStream: ({ args }) =>\n        Option.match(args, {\n          onNone: () => Stream.empty,\n          onSome: (someArgs) => reactiveQueryStream(ref, config)(someArgs),\n        }),\n    };\n  };\n\n/**\n * A complete Foldkit subscription entry that keeps exactly one live reactive\n * page subscription in sync with a `PaginatedQuery` machine in the Model.\n * The machine state is the single source of truth: navigation and\n * split-pinning change the derived args, while `Idle` closes the subscription.\n * Pagination ids are allocated here and installed by the first settlement.\n *\n * The leading thunk fixes the `Model` type (TypeScript cannot partially\n * infer type arguments), so the `state` extractor's parameter is already\n * typed:\n *\n * ```ts\n * import * as Confect from \"@confect/foldkit\"\n * import * as Subscription from \"foldkit/subscription\"\n *\n * const subscriptions = Subscription.make<\n *   Model,\n *   Message,\n *   Confect.Client.Client\n * >()(() => ({\n *   notesPage: Confect.Subscription.paginatedQuery<Model>()(Notes, {\n *     state: (model) => model.notes,\n *     onSettled: (settlement) => SettledGetNotesPage({ settlement }),\n *   }),\n * }))\n * ```\n *\n * Pass the settlement to `PaginatedQuery.settle` in `update`. The request\n * identity is included in both success and failure Messages, so superseded\n * outcomes cannot settle a newer page or pagination session. Query failures\n * do not close the Convex subscription; a later result can recover naturally.\n */\ntype DependenciesSchema<Dependencies_> = Schema.Schema<Dependencies_> & {\n  readonly fields: Schema.Struct.Fields;\n};\n\ntype EntryWithKeepAlive<Model, Message, Dependencies_, Services> = {\n  readonly dependenciesSchema: DependenciesSchema<Dependencies_>;\n  readonly modelToDependencies: (model: Model) => Dependencies_;\n  readonly keepAliveEquivalence: Equivalence.Equivalence<Dependencies_>;\n  readonly dependenciesToStream: (\n    dependencies: Dependencies_,\n    readDependencies: () => Dependencies_,\n  ) => Stream.Stream<Message, never, Services>;\n};\n\nexport const paginatedQuery =\n  <Model>() =>\n  <\n    PaginatedQueryRef extends Ref.AnyConfectPublicPaginatedQuery,\n    SettledMessage,\n  >(\n    machine: PaginatedQuery.PaginatedQuery<PaginatedQueryRef>,\n    config: {\n      readonly state: (\n        model: Model,\n      ) => PaginatedQuery.State<\n        PaginatedQuery.Item<PaginatedQueryRef>,\n        PaginatedQuery.UserArgs<PaginatedQueryRef>,\n        PaginatedQuery.Error<PaginatedQueryRef>\n      >;\n      readonly onSettled: (\n        settlement: PaginatedQuery.Settlement<\n          PaginatedQuery.Item<PaginatedQueryRef>,\n          PaginatedQuery.UserArgs<PaginatedQueryRef>,\n          PaginatedQuery.Error<PaginatedQueryRef>\n        >,\n      ) => SettledMessage;\n    },\n  ): EntryWithKeepAlive<\n    Model,\n    SettledMessage,\n    {\n      readonly request: Option.Option<\n        PaginatedQuery.SubscriptionRequest<\n          PaginatedQuery.UserArgs<PaginatedQueryRef>\n        >\n      >;\n    },\n    Client.Client\n  > => {\n    const ref = machine.ref;\n    const composedArgsSchema = ref.args;\n    const requestEquivalence = Schema.toEquivalence(\n      machine.subscriptionRequestSchema,\n    );\n    const optionalRequestEquivalence = Option.makeEquivalence<\n      PaginatedQuery.SubscriptionRequest<\n        PaginatedQuery.UserArgs<PaginatedQueryRef>\n      >\n    >((left, right) =>\n      requestEquivalence(\n        { ...left, paginationId: Option.none() },\n        { ...right, paginationId: Option.none() },\n      ),\n    );\n\n    return {\n      dependenciesSchema: Schema.Struct({\n        request: Schema.Option(machine.subscriptionRequestSchema),\n      }),\n      modelToDependencies: (model) => ({\n        request: Match.value(config.state(model)).pipe(\n          Match.tag(\"Idle\", () => Option.none()),\n          Match.tag(\"Active\", (state) =>\n            Option.some(PaginatedQuery.getSubscriptionRequest(state)),\n          ),\n          Match.exhaustive,\n        ),\n      }),\n      keepAliveEquivalence: (left, right) =>\n        optionalRequestEquivalence(left.request, right.request),\n      dependenciesToStream: ({\n        request,\n      }): Stream.Stream<SettledMessage, never, Client.Client> =>\n        Option.match(request, {\n          onNone: () => Stream.empty,\n          onSome: (subscriptionRequest) =>\n            Stream.unwrap(\n              Effect.gen(function* () {\n                const client = yield* Client.Client;\n                const paginationId = yield* client.resolvePaginationId(\n                  subscriptionRequest.paginationId,\n                );\n                const allocatedRequest = PaginatedQuery.allocateRequest(\n                  subscriptionRequest,\n                  paginationId,\n                );\n                const { descriptor, options } = allocatedRequest;\n                const composedArgs = composedArgsSchema.make({\n                  ...allocatedRequest.args,\n                  paginationOpts: {\n                    numItems: options.initialNumItems,\n                    cursor: descriptor.cursor,\n                    id: paginationId,\n                    ...Match.value(options.maximumRowsRead).pipe(\n                      Match.when(undefined, () => ({})),\n                      Match.when(Match.defined, (maximumRowsRead) => ({\n                        maximumRowsRead,\n                      })),\n                      Match.exhaustive,\n                    ),\n                    ...Match.value(options.maximumBytesRead).pipe(\n                      Match.when(undefined, () => ({})),\n                      Match.when(Match.defined, (maximumBytesRead) => ({\n                        maximumBytesRead,\n                      })),\n                      Match.exhaustive,\n                    ),\n                    ...Option.match(descriptor.endCursor, {\n                      onNone: () => ({}),\n                      onSome: (endCursor) => ({ endCursor }),\n                    }),\n                  },\n                });\n                return client.reactiveQueryResult(ref, composedArgs).pipe(\n                  Stream.map((result) =>\n                    config.onSettled({\n                      request: allocatedRequest,\n                      result: Result.mapError(result, paginatedError),\n                    }),\n                  ),\n                );\n              }),\n            ),\n        }),\n    };\n  };\n"],"mappings":"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"}

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@confect/foldkit",
   "description": "Client-side bindings for Foldkit apps",
-  "version": "10.0.0-next.20",
+  "version": "10.0.0-next.22",
   "author": "RJ Dellecese",
   "bugs": {
     "url": "https://github.com/rjdellecese/confect/issues"
   },
   "devDependencies": {
-    "@effect/vitest": "4.0.0-rc.112",
-    "@types/node": "22.20.1",
+    "@effect/vitest": "4.0.0-rc.115",
+    "@types/node": "24.13.3",
     "convex": "1.45.0",
-    "effect": "4.0.0-rc.112",
+    "effect": "4.0.0-rc.115",
     "foldkit": "0.148.1",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
     "unrun": "0.3.1",
-    "vitest": "4.1.10"
+    "vitest": "5.0.0"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
   },
   "exports": {
     ".": {
@@ -50,10 +50,10 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "peerDependencies": {
-    "effect": "^4.0.0-rc.112",
-    "foldkit": "^0.148.0",
-    "@confect/core": "^10.0.0-next.20",
-    "@confect/js": "^10.0.0-next.20"
+    "@confect/core": "^10.0.0-next.22",
+    "@confect/js": "^10.0.0-next.22",
+    "effect": "^4.0.0-rc.115",
+    "foldkit": "^0.148.0"
   },
   "repository": {
     "type": "git",

package/src/Command.ts

@@ -17,11 +17,10 @@ export type Error<Ref_ extends Ref.AnyConfect> =
   | Schema.SchemaError;
 
 /**
- * Maps a Confect function's outcome into the app's Messages. Every failure —
- * the ref's typed error, a transport error, or a codec error — arrives via
+ * Maps a Confect function's outcome into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via
  * `onError`, so the resulting Command's error channel is `never`, as Foldkit
  * requires. Follow Foldkit's naming convention: past-tense facts like
- * `SucceededSaveNote` / `FailedSaveNote`.
+ * `SucceededSaveNote`/`FailedSaveNote`.
  */
 export interface Handlers<
   Ref_ extends Ref.AnyConfect,
@@ -54,7 +53,7 @@ type SchemaArgs<Ref_ extends Ref.AnyConfect> = Schema.Schema.Type<
  * ref-derived call signature (args optional when the ref declares none)
  * intersected with Foldkit's own `CommandDefinitionWithArgs`, which supplies
  * the `CommandDefinitionTypeId` brand and makes the definition assignable
- * wherever Foldkit accepts one — including Story/Scene `Command.resolve`
+ * wherever Foldkit accepts one—including Story/Scene `Command.resolve`
  * and `expectExact` matchers. Call it from `update` to construct a Command
  * instance; nothing runs until the Foldkit runtime executes it.
  */
@@ -70,14 +69,14 @@ export type Definition<
   >;
 
 /**
- * Makes a factory-built Command interruptible — Foldkit's `InterruptOption`
+ * Makes a factory-built Command interruptible—Foldkit's `InterruptOption`
  * applied to the ref's args. `true` keys every invocation by the Command
- * name — right when at most one invocation is meaningfully in flight; a
+ * name—right when at most one invocation is meaningfully in flight; a
  * `KeyedInterrupt` derives the key part from the ref's args, so concurrent
  * invocations can be targeted independently.
  *
  * Interrupting stops the client-side Effect and guarantees the invocation's
- * result Messages never dispatch — it does not cancel the Convex function on
+ * result Messages never dispatch—it does not cancel the Convex function on
  * the server, which runs to completion once the call is on the wire.
  */
 export type InterruptOption<
@@ -96,7 +95,7 @@ export type KeyedInterrupt<
 > = Exclude<InterruptOption<Ref_, KeyField>, true>;
 
 /**
- * An interruptible Command definition whose key is the Command name — the
+ * An interruptible Command definition whose key is the Command name—the
  * ref-derived call signature intersected with Foldkit's
  * `Interruptible.DefinitionWithArgsNameKeyed`, which supplies the brand and
  * the `Interrupt` constructor.
@@ -116,7 +115,7 @@ export type InterruptibleDefinition<
 
 /**
  * An interruptible Command definition whose key is derived from the ref's
- * args — the ref-derived call signature intersected with Foldkit's
+ * args—the ref-derived call signature intersected with Foldkit's
  * `Interruptible.DefinitionWithArgs`, which supplies the brand and the
  * key-args-taking `Interrupt` constructor.
  */
@@ -149,7 +148,7 @@ const run = <Ref_ extends Ref.AnyConfect, SuccessMessage, ErrorMessage>(
   );
 
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. Reach for these when the factory below doesn't fit:
  * a custom args schema, `interrupt`, or a Command that makes several calls.
  */
@@ -164,7 +163,7 @@ export const queryEffect =
     run(handlers, (client) => client.query(ref, ...args));
 
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. See `queryEffect`.
  */
 export const mutationEffect =
@@ -178,7 +177,7 @@ export const mutationEffect =
     run(handlers, (client) => client.mutation(ref, ...args));
 
 /**
- * An execute body for a hand-written `Command.define` — every failure already
+ * An execute body for a hand-written `Command.define`—every failure already
  * folded into a Message. See `queryEffect`.
  */
 export const actionEffect =
@@ -418,7 +417,7 @@ const makeFactory = <BoundRef extends Ref.AnyConfect>(
  * ```
  *
  * Pass `interrupt` to make invocations interruptible via the returned
- * definition's `Interrupt` constructor — `true` keys them by the Command
+ * definition's `Interrupt` constructor—`true` keys them by the Command
  * name, `{ keyFields, toKey }` by a part derived from the ref's args:
  *
  * ```ts

package/src/PaginatedQuery.ts

@@ -543,7 +543,17 @@ export const reset = <Item_, UserArgs_, Error_>(
   phase: pendingPhase(phaseData(state.phase), "Reset"),
 });
 
-/** Navigate to the next page, retaining the current page while it loads. */
+/**
+ * Navigate to the next page, retaining the current page while it loads.
+ *
+ * The page being left is pushed onto the stack *pinned* to the range it
+ * displayed—its cursor to its continuation cursor—so `prev` reloads
+ * exactly that range rather than the first `initialNumItems` documents
+ * after its cursor, however the data has moved meanwhile. Convex's own
+ * pagination keeps that range in its query journal; stream-paginated
+ * queries have no journal, so the pin is what keeps consecutive pages
+ * gap-free and duplicate-free for them.
+ */
 export const next = <Item_, UserArgs_, Error_>(
   state: Active<Item_, UserArgs_, Error_>,
 ): Option.Option<Active<Item_, UserArgs_, Error_>> =>
@@ -553,24 +563,25 @@ export const next = <Item_, UserArgs_, Error_>(
       Match.value(data.isDone).pipe(
         Match.withReturnType<Option.Option<Active<Item_, UserArgs_, Error_>>>(),
         Match.when(true, () => Option.none()),
-        Match.when(false, () =>
-          Option.some({
+        Match.when(false, () => {
+          const end = Option.getOrElse(
+            data.descriptor.endCursor,
+            () => data.continueCursor,
+          );
+          return Option.some({
             ...state,
             requestId: state.requestId + 1,
-            current: {
-              cursor: Option.getOrElse(
-                data.descriptor.endCursor,
-                () => data.continueCursor,
-              ),
-              endCursor: Option.none(),
-            },
-            prevStack: [...state.prevStack, data.descriptor],
+            current: { cursor: end, endCursor: Option.none() },
+            prevStack: [
+              ...state.prevStack,
+              { cursor: data.descriptor.cursor, endCursor: Option.some(end) },
+            ],
             phase: Phase.Refreshing<Item_, Error_>({
               data,
               direction: "Next",
             }),
-          }),
-        ),
+          });
+        }),
         Match.exhaustive,
       ),
     ),

package/src/Subscription.ts

@@ -52,8 +52,7 @@ export interface Dependencies<Query extends Ref.AnyConfectPublicQuery> {
 }
 
 /**
- * Maps a reactive query's emissions into the app's Messages. Every failure —
- * the ref's typed error, a transport error, or a codec error — arrives via
+ * Maps a reactive query's emissions into the app's Messages. Every failure—the ref's typed error, a transport error, or a codec error—arrives via
  * `onError`, so the resulting stream's error channel is `never`, as Foldkit
  * requires.
  */