@effect-app/infra 4.0.0-beta.20 → 4.0.0-beta.201

package/CHANGELOG.md

@@ -1,5 +1,1415 @@
 # @effect-app/infra
 
+## 4.0.0-beta.201
+
+### Patch Changes
+
+- d67d17a: Source middleware errors exclusively from the rpc middleware tag, and move command/stream invalidation wrap/unwrap entirely into the routing layer (server) and `apiClientFactory` (client). `InvalidationMiddleware` and `InvalidationMiddlewareLive` are removed.
+
+  ### Resource error schemas
+
+  Three sites that used to fold `RequestContextMap[*].error` into a request's own error schema now stop doing so:
+
+  - `makeRpcClient` / `makeRequestClass` — `failureSchema` is just `config.error` (still merged with the optional `generalErrors` parameter, which is the only remaining error mix on both type and runtime levels).
+  - `MiddlewareMaker.rpc()` — `error: options.error` only; the previous union with `rcm.config[*].error` is gone.
+  - Routing and `apiClientFactory.makeRpcGroupFromRequestsAndModuleName` — `Invalidation.makeCommandRpc` is called with `error: resource.error` (no widening with the composite middleware error union).
+
+  Middleware errors reach the client through the rpc's `middlewares[*].error` failure-union channel of `Rpc.exitSchema`, exposed by attaching the middleware tag to the rpc on both sides:
+
+  - **Server**: `makeRouter(middleware)` attaches the live composite tag (existing behavior).
+  - **Client**: new `middleware` option on `ClientForOptions` / `ApiClientFactory.makeFor(layer, { middleware })` attaches the same tag schema-only (no Live invoked). Threaded through `makeRpcGroupFromRequestsAndModuleName` to `RpcGroup.middleware(tag)`. Without it, stream rpcs (whose top-level `errorSchema` is forced to `Never` by effect-rpc) hit `SchemaError: Expected never | { _tag: "error", ... }` decoding middleware-thrown errors that bypass the in-stream `Stream.catch` wrap.
+
+  **Migration**: handlers that yield errors previously sourced from rcm (e.g. `yield* new UnauthorizedError()`) now require those errors to be declared explicitly on the resource — `Req.Query<T>()("...", fields, { success, error: UnauthorizedError })`. The handler error type no longer auto-includes the rcm union.
+
+  ### Invalidation wrap/unwrap
+
+  - `routing.ts` (server) provides a per-request `InvalidationSet` for commands, wraps the success value as `CommandResponseWithMetaData`, and converts handler-thrown failures into `CommandFailureWithMetaData` so accumulated invalidation keys reach the client on either path. Stream wrap (per-chunk envelope + final `done` chunk) was already in routing and is unchanged.
+  - `apiClientFactory.ts` (client) `unwrapCommand` strips both envelopes and forwards keys to `InvalidationKeysFromServer`.
+  - `InvalidationMiddleware` (the tag) and `InvalidationMiddlewareLive` (the layer) are **removed**. The middleware was the previous home of the wrap; with the wrap moved to routing/apiClientFactory, the middleware became a thin pass-through and is no longer needed. `DefaultGenericMiddlewares` and `DefaultGenericMiddlewaresLive` shrink accordingly — no migration needed for callers that used the defaults; callers that referenced `InvalidationMiddleware` / `InvalidationMiddlewareLive` directly should drop those imports.
+
+  Middleware-thrown errors are never wrapped: by definition the handler never ran, so there is nothing to invalidate. They flow raw on the Cause and the client decodes them via the middleware-tag failure-union channel described above.
+
+- Updated dependencies [d67d17a]
+  - effect-app@4.0.0-beta.201
+
+## 4.0.0-beta.200
+
+### Patch Changes
+
+- 0cff7c1: workaround middleware error issue
+- Updated dependencies [8f1cf6a]
+- Updated dependencies [0cff7c1]
+  - effect-app@4.0.0-beta.200
+
+## 4.0.0-beta.199
+
+### Patch Changes
+
+- de9fb83: Annotate Cosmos read spans with response size, resource count, and request charge.
+
+  `Cosmos.queryRaw`, `Cosmos.all`, `Cosmos.filter`, and `Cosmos.find` now set `db.cosmos.request_charge`, `db.cosmos.response_bytes`, and (where applicable) `db.cosmos.resource_count` on the active span. Bytes are sourced from `diagnostics.clientSideRequestStatistics.totalResponsePayloadLengthInBytes` — no payload stringification.
+
+  - effect-app@4.0.0-beta.199
+
+## 4.0.0-beta.198
+
+### Patch Changes
+
+- 32dbc54: fix stream type when no success specified
+- Updated dependencies [32dbc54]
+  - effect-app@4.0.0-beta.198
+
+## 4.0.0-beta.197
+
+### Minor Changes
+
+- 3dc0d2a: Add streaming as a `stream: true` config option on `Query` / `Command` instead of a separate request type.
+
+  `TaggedRequestFor` now exposes only `Query` and `Command` factories — the standalone `Stream` factory is removed. To produce a Stream of `success` values, pass `stream: true` in the request config. The request `type` field stays `"command" | "query"`; a new `stream: boolean` field carries the streaming flag (stripped from the stored handler config).
+
+  ```ts
+  // Query that streams results
+  Req.Query<T>()("Tag", {}, { stream: true, success: ... })
+
+  // Command that streams results
+  Req.Command<T>()("Tag", {}, { stream: true, success: ... })
+  ```
+
+  Vue client mapping (per-handler properties mirror the non-stream API — `.query`, `.fn`, `.mutate`):
+
+  - `query` + `stream: true` → exposes `.query` (read-only streaming, tracked Vue Query). Helper map key: `${name}Query`.
+  - `command` + `stream: true` → exposes `.fn` and `.mutate` (mutating streaming).
+  - Plain `query` / `command` unchanged.
+
+  Server routing dispatches via the new `stream` flag (`makeStreamRpc` for streaming commands/queries, `makeCommandRpc` / `Rpc.make` otherwise).
+
+  Also lifts the `Struct` / `TaggedStruct` and `Opaque` definitions in `effect-app/Schema` to use `S.Bottom` / `S.Opaque` directly, exposing `fields`, `mapFields`, and a `MakeIn` that allows `void` when all fields are optional. `TaggedRequestFor` request classes now use `Opaque(TaggedStruct(...))` instead of `TaggedClass`, and decoding/encoding services are derived from `success` / `error` rather than stored on the request.
+
+  **Migration**: replace `Req.Stream` with `Req.Query` or `Req.Command` and add `stream: true` to the config — `Query` for read-only streams, `Command` for mutating streams.
+
+### Patch Changes
+
+- Updated dependencies [3dc0d2a]
+  - effect-app@4.0.0-beta.197
+
+## 4.0.0-beta.196
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.196
+
+## 4.0.0-beta.195
+
+### Patch Changes
+
+- 774a9b3: `MiddlewareMaker.makeMiddlewareBasic` now derives each middleware's effective error from both the static `error` field on the tag AND the `rcm` config entry referenced by `dynamic.key`, rather than relying on the static field alone.
+
+  Middlewares declared with `dynamic: RequestContextMap.get("foo")` (instead of an explicit static `error: ...`) end up with `tag.error = Schema.Never` at runtime — `RpcMiddleware.Tag` defaults the static error to `Never` when not provided. The composite `MiddlewareMaker.Tag(...).middleware(...)` walked `make[*].error` to build its own error union, collapsing to `Union<Never, ...> ≡ Never`.
+
+  `Rpc.exitSchema` walks `rpc.middlewares[*].error` when building the wire-level failure union for every rpc kind. Empty-union meant middleware-thrown errors (`NotLoggedInError`, `UnauthorizedError`, etc.) never reached the wire schema. Query/command happened to work because their wire `errorSchema = resource.error` already covered the merge from `makeRpcClient`. Stream rpcs have `errorSchema` force-set to `Schema.Never` by effect-rpc, so the resource-level merge never reached the wire — middleware errors decoded as "Expected never, got X".
+
+  Per middleware, the new logic pushes both the static `_.error` (if non-`Never`) and `rcm[_.dynamic.key].error` (if non-`Never`) into the composite's failure union.
+
+- Updated dependencies [774a9b3]
+  - effect-app@4.0.0-beta.195
+
+## 4.0.0-beta.194
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.194
+
+## 4.0.0-beta.193
+
+### Patch Changes
+
+- 9569911: Stream resources accept `Effect.fail(...)` (and `Effect<Stream>`) from controller handlers — previously only `Stream.fail(...)` / a returned `Stream` worked. The router now lifts an Effect result to a Stream via `Stream.unwrap`, so failures from an `Effect` propagate as a failing Stream on the client, matching `Stream.fail(...)` behavior. Also removes the need for manual `.pipe(Stream.unwrap)` on generator handlers that return a `Stream`.
+  - effect-app@4.0.0-beta.193
+
+## 4.0.0-beta.192
+
+### Patch Changes
+
+- dba5779: namespaces
+  - effect-app@4.0.0-beta.192
+
+## 4.0.0-beta.191
+
+### Patch Changes
+
+- 50ce7e6: Replace typescript-eslint with oxlint-tsgolint for type-aware lint. Drop ESLint entirely from non-vue packages (cli, effect-app, infra) — they now use only `oxlint --type-aware`. Vue packages keep ESLint to run `@effect-app/no-await-effect` (no tsgolint equivalent) via `@typescript-eslint/parser` + `vue-eslint-parser`.
+- Updated dependencies [50ce7e6]
+  - effect-app@4.0.0-beta.191
+
+## 4.0.0-beta.190
+
+### Patch Changes
+
+- Updated dependencies [985176b]
+  - effect-app@4.0.0-beta.190
+
+## 4.0.0-beta.189
+
+### Patch Changes
+
+- ea32222: Update to effect 4.0.0-beta.60 and use native `Rpc.custom` constructors (`makeCommandRpc`, `makeStreamRpc`) for metadata-wrapped RPC schemas instead of manually wrapping/unwrapping schemas inline.
+- Updated dependencies [ea32222]
+  - effect-app@4.0.0-beta.189
+
+## 4.0.0-beta.188
+
+### Patch Changes
+
+- b2e438f: Remove Operations service and repo
+- Updated dependencies [b2e438f]
+  - effect-app@4.0.0-beta.188
+
+## 4.0.0-beta.187
+
+### Patch Changes
+
+- Updated dependencies [0d4e0b8]
+  - effect-app@4.0.0-beta.187
+
+## 4.0.0-beta.186
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.186
+
+## 4.0.0-beta.185
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.185
+
+## 4.0.0-beta.184
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.184
+
+## 4.0.0-beta.183
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.183
+
+## 4.0.0-beta.182
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.182
+
+## 4.0.0-beta.181
+
+### Patch Changes
+
+- Updated dependencies [583393f]
+  - effect-app@4.0.0-beta.181
+
+## 4.0.0-beta.180
+
+### Minor Changes
+
+- 7fa3045: V1/V2/V3: stream and command requests carry invalidation metadata
+
+  **V1** – stream final response includes metadata
+
+  - `Invalidation.StreamResponseChunk` wraps each stream item as `{ _tag: "value", value }` and appends `{ _tag: "done", metadata }` at the end carrying all accumulated invalidation keys.
+
+  **V2** – invalidation keys included in failures
+
+  - `Invalidation.CommandFailureWithMetaData` and `Invalidation.StreamFailureChunk` carry keys accumulated up to the point of failure, so clients can invalidate queries even when a command or stream errors.
+  - `InvalidationMiddlewareLive` wraps command failures; `routing.ts` wraps stream failures.
+  - `apiClientFactory.ts` unwraps both on the client side, forwarding keys before re-failing with the original error.
+
+  **V3** – mid-stream metadata chunks
+
+  - `Invalidation.StreamResponseChunk` now also includes `{ _tag: "metadata", metadata }` for mid-stream invalidation.
+  - After each emitted value, the server drains accumulated keys and emits a "metadata" chunk if any keys were collected since the last drain (bucket reset via `InvalidationSet.drain`).
+  - `apiClientFactory.ts` processes "metadata" chunks the same as "done" chunks, forwarding keys to `InvalidationKeysFromServer` immediately.
+  - `makeInvalidationKeysService` accepts an optional `onAdded` callback that fires after each key addition, enabling `mutate.ts` to trigger query invalidation mid-stream without waiting for the stream to complete.
+
+### Patch Changes
+
+- Updated dependencies [7fa3045]
+  - effect-app@4.0.0-beta.180
+
+## 4.0.0-beta.179
+
+### Patch Changes
+
+- Updated dependencies [828d264]
+  - effect-app@4.0.0-beta.179
+
+## 4.0.0-beta.178
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.178
+
+## 4.0.0-beta.177
+
+### Minor Changes
+
+- 89d8b3a: Add Effect RPC `Stream` support to the wrapper.
+
+  - New `Stream` request constructor on `TaggedRequestFor` parallel to `Query`/`Command`. Emits resources with `type: "stream"`.
+  - Server router (`@effect-app/infra` `routing.ts`) accepts stream resources whose handlers return a `Stream.Stream<A, E, R>` (or a function from input to one). Forwards `stream: true` to `Rpc.make` so `RpcSchema.Stream` wrapping is applied. Streams bypass `applyRequestTypeInterruptibility` and the `Effect.withSpan` wrapping (the RPC server adds its own span).
+  - Client (`apiClientFactory.ts`) detects stream resources, forwards `stream: true` when constructing `RpcGroup`, and exposes the per-request `handler` as a `Stream.Stream` (via `Stream.unwrap` over the `ManagedRuntime` context) instead of an `Effect`. `Invalidation.CommandResponseWithMetaData` continues to apply only to commands.
+  - New `RequestStreamHandler` / `RequestStreamHandlerWithInput` shapes in `clientFor.ts`; `RequestHandlers` dispatches on `type: "stream"`.
+
+### Patch Changes
+
+- Updated dependencies [89d8b3a]
+  - effect-app@4.0.0-beta.177
+
+## 4.0.0-beta.176
+
+### Patch Changes
+
+- pass options
+- Updated dependencies
+  - effect-app@4.0.0-beta.176
+
+## 4.0.0-beta.175
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.175
+
+## 4.0.0-beta.174
+
+### Minor Changes
+
+- 821468d: Add server-driven cache invalidation via RPC response headers.
+
+  - `effect-app/rpc`: new `Invalidation` module with `InvalidationKey` / `InvalidationKeys` schemas, `Invalidates` annotation (for declaring static invalidation on Rpc definitions), `InvalidationSet` reference (request-scoped accumulator), and `makeInvalidationSet` helper.
+  - `effect-app/middleware`: new `InvalidationMiddleware` RPC middleware tag; included in `DefaultGenericMiddlewares`.
+  - `effect-app/client`: new `InvalidationKeys` module with `InvalidationKeysFromServer` reference and `makeInvalidationKeysService` helper; `apiClientFactory` now taps HTTP responses to read the `x-invalidate` header and forward keys to `InvalidationKeysFromServer`.
+  - `@effect-app/infra`: new `InvalidationMiddlewareLive` RPC middleware implementation that owns the full lifecycle — creates a request-scoped `InvalidationSet` (backed by a `Ref`), pre-populates it from the `Invalidates` annotation, provides it to the handler, and after the handler completes registers an HTTP pre-response handler (via `appendPreResponseHandlerUnsafe`) to write the accumulated keys as an `x-invalidate` response header. No separate HTTP middleware is needed.
+  - `@effect-app/vue`: `invalidateQueries` / `useMutation` now reads server-provided invalidation keys from `InvalidationKeysFromServer` after each mutation and applies them alongside the client-side invalidation.
+
+### Patch Changes
+
+- Updated dependencies [821468d]
+  - effect-app@4.0.0-beta.174
+
+## 4.0.0-beta.173
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.173
+
+## 4.0.0-beta.172
+
+### Patch Changes
+
+- improve sentry
+  - effect-app@4.0.0-beta.172
+
+## 4.0.0-beta.171
+
+### Patch Changes
+
+- Updated dependencies [d71d976]
+  - effect-app@4.0.0-beta.171
+
+## 4.0.0-beta.170
+
+### Patch Changes
+
+- Updated dependencies [8f09f77]
+  - effect-app@4.0.0-beta.170
+
+## 4.0.0-beta.169
+
+### Patch Changes
+
+- Updated dependencies [8ae8b53]
+  - effect-app@4.0.0-beta.169
+
+## 4.0.0-beta.168
+
+### Patch Changes
+
+- Updated dependencies [178480a]
+  - effect-app@4.0.0-beta.168
+
+## 4.0.0-beta.167
+
+### Patch Changes
+
+- Updated dependencies [140e192]
+  - effect-app@4.0.0-beta.167
+
+## 4.0.0-beta.166
+
+### Patch Changes
+
+- Updated dependencies [dbcc53b]
+  - effect-app@4.0.0-beta.166
+
+## 4.0.0-beta.165
+
+### Patch Changes
+
+- Updated dependencies [f88ea34]
+  - effect-app@4.0.0-beta.165
+
+## 4.0.0-beta.164
+
+### Patch Changes
+
+- Updated dependencies [8cb3de4]
+  - effect-app@4.0.0-beta.164
+
+## 4.0.0-beta.163
+
+### Patch Changes
+
+- Updated dependencies [b952f19]
+  - effect-app@4.0.0-beta.163
+
+## 4.0.0-beta.162
+
+### Patch Changes
+
+- Updated dependencies [b52b424]
+  - effect-app@4.0.0-beta.162
+
+## 4.0.0-beta.161
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.161
+
+## 4.0.0-beta.160
+
+### Patch Changes
+
+- 505bfa9: Add concurrent decode helper APIs and migrate decode callsites to use them.
+
+  - Add `withDefaultParseOptions` and keep `DefaultParseOptions` centralized.
+  - Export `decodeEffectConcurrently` and `decodeUnknownEffectConcurrently` from Schema and SchemaParser modules.
+  - Update repository, queue, client, form, and CLI decode paths to use concurrent decode helpers.
+  - Keep schema constructors free of hardcoded parse concurrency overrides.
+
+- Updated dependencies [505bfa9]
+  - effect-app@4.0.0-beta.160
+
+## 4.0.0-beta.159
+
+### Patch Changes
+
+- c1e73de:
+- Updated dependencies [c1e73de]
+  - effect-app@4.0.0-beta.159
+
+## 4.0.0-beta.158
+
+### Patch Changes
+
+- Updated dependencies [3c1f52d]
+- Updated dependencies [6ae3050]
+  - effect-app@4.0.0-beta.158
+
+## 4.0.0-beta.157
+
+### Patch Changes
+
+- 6fff09c: unify encoded function for when you use encodedKeys
+- Updated dependencies [6fff09c]
+  - effect-app@4.0.0-beta.157
+
+## 4.0.0-beta.156
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.156
+
+## 4.0.0-beta.155
+
+### Patch Changes
+
+- Updated dependencies [c215db8]
+  - effect-app@4.0.0-beta.155
+
+## 4.0.0-beta.154
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.154
+
+## 4.0.0-beta.153
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.153
+
+## 4.0.0-beta.152
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.152
+
+## 4.0.0-beta.151
+
+### Patch Changes
+
+- 925214b: update packages
+  - effect-app@4.0.0-beta.151
+
+## 4.0.0-beta.150
+
+### Patch Changes
+
+- Updated dependencies [85a8275]
+  - effect-app@4.0.0-beta.150
+
+## 4.0.0-beta.149
+
+### Patch Changes
+
+- Updated dependencies [f317c5e]
+  - effect-app@4.0.0-beta.149
+
+## 4.0.0-beta.148
+
+### Patch Changes
+
+- Updated dependencies [199e9a5]
+  - effect-app@4.0.0-beta.148
+
+## 4.0.0-beta.147
+
+### Patch Changes
+
+- Updated dependencies [47e3742]
+  - effect-app@4.0.0-beta.147
+
+## 4.0.0-beta.146
+
+### Patch Changes
+
+- Updated dependencies [a4dff57]
+  - effect-app@4.0.0-beta.146
+
+## 4.0.0-beta.145
+
+### Patch Changes
+
+- Updated dependencies [12abb55]
+  - effect-app@4.0.0-beta.145
+
+## 4.0.0-beta.144
+
+### Patch Changes
+
+- d31253f: Refactor eligible schema classes and tagged classes to Opaque schemas, and migrate constructor call sites to use `.make` for those models.
+- Updated dependencies [11422f8]
+- Updated dependencies [d31253f]
+  - effect-app@4.0.0-beta.144
+
+## 4.0.0-beta.143
+
+### Patch Changes
+
+- Updated dependencies [79eb019]
+  - effect-app@4.0.0-beta.143
+
+## 4.0.0-beta.142
+
+### Patch Changes
+
+- Updated dependencies [3436d44]
+- Updated dependencies [025de47]
+  - effect-app@4.0.0-beta.142
+
+## 4.0.0-beta.141
+
+### Patch Changes
+
+- Updated dependencies [7c25dbb]
+  - effect-app@4.0.0-beta.141
+
+## 4.0.0-beta.140
+
+### Patch Changes
+
+- 1576688: Add configurable `fakeMailAddress` to `SendgridConfig`. Supports `{i}` placeholder for unique addresses, e.g. `"test+{i}@example.com"`.
+  - effect-app@4.0.0-beta.140
+
+## 4.0.0-beta.139
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.139
+
+## 4.0.0-beta.138
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.138
+
+## 4.0.0-beta.137
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.137
+
+## 4.0.0-beta.136
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.136
+
+## 4.0.0-beta.135
+
+### Patch Changes
+
+- Updated dependencies [c7bbc41]
+  - effect-app@4.0.0-beta.135
+
+## 4.0.0-beta.134
+
+### Patch Changes
+
+- eed57c6: Fix `R` inference in `OneDSL`, `OneDSLExt.modify` and `OneDSLExt.update`. The callback's effect type was annotated as `Effect<…, E, FixEnv<R, Evt, S1, S2>>`, which deadlocked inference of `R` (TS6 fell back to `never`, tsgo to `unknown`, leaking `unknown` into yielded effects in generator handlers). Now matches the existing `AllDSLExt` pattern: bare `R` in the callback, `FixEnv<R, …>` only in the return type.
+- Updated dependencies [9d3495e]
+- Updated dependencies [f353d48]
+  - effect-app@4.0.0-beta.134
+
+## 4.0.0-beta.133
+
+### Patch Changes
+
+- 2f862a4: Apply `toCodecJson` in `SQLModel.JsonFromString` so SQL JSON string fields use the proper JSON-safe codec at the encode/decode boundary (aligns with queue, event, and gist call sites).
+- c3299f7: update packages
+- Updated dependencies [c3299f7]
+  - effect-app@4.0.0-beta.133
+
+## 4.0.0-beta.132
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.132
+
+## 4.0.0-beta.131
+
+### Patch Changes
+
+- 4a7d95a: Use request-type RPC annotations to drive interruptibility and retry behavior, apply command uninterruptibility through the router wrapper path, and add an in-memory E2E test covering command vs query interruption behavior.
+  - effect-app@4.0.0-beta.131
+
+## 4.0.0-beta.130
+
+### Patch Changes
+
+- Updated dependencies [ea1bd46]
+  - effect-app@4.0.0-beta.130
+
+## 4.0.0-beta.129
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.129
+
+## 4.0.0-beta.128
+
+### Patch Changes
+
+- Updated dependencies [57db551]
+  - effect-app@4.0.0-beta.128
+
+## 4.0.0-beta.127
+
+### Patch Changes
+
+- 71a0719: Merge `batchPar` into `batch`, expose `concurrency` via an optional `BatchOptions` argument, and make `batch` dual (data-first + data-last).
+- 4bc3d05: Repository `save`, `remove`, and `removeById` now accept plain `ReadonlyArray` instead of `NonEmptyReadonlyArray`. Callers no longer need to narrow or guard for non-emptiness before invoking — empty inputs short-circuit to a no-op, making it ergonomic to pass through query results directly.
+  - effect-app@4.0.0-beta.127
+
+## 4.0.0-beta.126
+
+### Patch Changes
+
+- Updated dependencies [458bb1b]
+  - effect-app@4.0.0-beta.126
+
+## 4.0.0-beta.125
+
+### Patch Changes
+
+- 7191fc1: `removeById` now takes `id | NonEmptyReadonlyArray<id>` instead of a variadic rest, and the extended repo's `removeById` accepts a `batch` option to chunk large deletes — consistent with `save` and `remove`.
+  - effect-app@4.0.0-beta.125
+
+## 4.0.0-beta.124
+
+### Patch Changes
+
+- c9e0c44: cleanup auth
+- 256ae85: cleanup
+- Updated dependencies [256ae85]
+  - effect-app@4.0.0-beta.124
+
+## 4.0.0-beta.123
+
+### Patch Changes
+
+- Updated dependencies [14aba14]
+  - effect-app@4.0.0-beta.123
+
+## 4.0.0-beta.122
+
+### Patch Changes
+
+- 27bf9b6: Fix `Repository.query` environment typing to exclude schema context provided through `makeRepo` options.
+- e02a258: Add optional batching overloads for repository `save` and `remove` helpers.
+- f052d38: Replace `(...) => Effect.gen` with `Effect.fnUntraced` and convert select multi-step `pipe` chains to `Effect.gen` across infra.
+- Updated dependencies [f052d38]
+  - effect-app@4.0.0-beta.122
+
+## 4.0.0-beta.121
+
+### Patch Changes
+
+- 1015582: Fix `Q.project` field selection with `Schema.encodeKeys` by deriving selected fields from the encoded schema shape.
+- Updated dependencies [5ac46cb]
+  - effect-app@4.0.0-beta.121
+
+## 4.0.0-beta.120
+
+### Patch Changes
+
+- Updated dependencies [f21190c]
+  - effect-app@4.0.0-beta.120
+
+## 4.0.0-beta.119
+
+### Patch Changes
+
+- db7ba34: Filter SSE events stream by storeId namespace
+  - effect-app@4.0.0-beta.119
+
+## 4.0.0-beta.118
+
+### Patch Changes
+
+- Update effect packages to 4.0.0-beta.52
+- Updated dependencies [bd26832]
+- Updated dependencies [08d2e70]
+- Updated dependencies
+  - effect-app@4.0.0-beta.118
+
+## 4.0.0-beta.117
+
+### Patch Changes
+
+- 1d85785: Wrap store seed effects with `Effect.uninterruptible` to prevent interruption during seeding
+  - effect-app@4.0.0-beta.117
+
+## 4.0.0-beta.116
+
+### Patch Changes
+
+- 7d5cefc: SQL and Pg stores now scope seed migration records by namespace and table name in shared databases to avoid cross-namespace seed collisions.
+  - effect-app@4.0.0-beta.116
+
+## 4.0.0-beta.115
+
+### Patch Changes
+
+- fe2caba: SQL and Pg stores: use separate `_migrations` table for seed tracking instead of inserting a marker row into the data table, preventing it from appearing in `all`/`filter` queries.
+  - effect-app@4.0.0-beta.115
+
+## 4.0.0-beta.114
+
+### Patch Changes
+
+- 1ab3cf7: SQLite per-namespace adapter: use separate `_migrations` table for seed tracking instead of inserting a marker row into the data table, preventing it from appearing in `all`/`filter` queries.
+  - effect-app@4.0.0-beta.114
+
+## 4.0.0-beta.113
+
+### Minor Changes
+
+- ddc5492: Add RepositoryRegistry service that tracks all repositories by modelName, with `seedNamespace` to seed all registered repos in parallel and `entries` to inspect the registry.
+
+  Make non-primary namespace seeding explicit: Store and Repository now expose `seedNamespace` instead of auto-seeding on access. Primary namespace is still seeded eagerly on initialization.
+
+  SQL stores: table creation (`CREATE TABLE IF NOT EXISTS`) is now part of `seedNamespace` instead of running eagerly at store construction, ensuring tables for non-primary namespaces are only created when explicitly seeded.
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.113
+
+## 4.0.0-beta.112
+
+### Patch Changes
+
+- 8a4a6d2: fup
+  - effect-app@4.0.0-beta.112
+
+## 4.0.0-beta.111
+
+### Patch Changes
+
+- ca94edf: fix typo
+- Updated dependencies [ca94edf]
+  - effect-app@4.0.0-beta.111
+
+## 4.0.0-beta.110
+
+### Minor Changes
+
+- c313c07: Add per-namespace in-memory SQLite adapter via LayerMap. When `makeSqlClientLayer` option is provided to `SQLiteStoreLayer`, each namespace gets its own SQLite database instance managed by a `LayerMap`. Introduces `WithNsTransaction` service for namespace-aware SQL transactions, used by `makeSqlTransactionMiddleware`.
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.110
+
+## 4.0.0-beta.109
+
+### Patch Changes
+
+- 82f66f1: use uninterruptiple
+  - effect-app@4.0.0-beta.109
+
+## 4.0.0-beta.108
+
+### Patch Changes
+
+- Updated dependencies [3e46e7b]
+  - effect-app@4.0.0-beta.108
+
+## 4.0.0-beta.107
+
+### Patch Changes
+
+- 902ca1b: fix
+  - effect-app@4.0.0-beta.107
+
+## 4.0.0-beta.106
+
+### Patch Changes
+
+- f22a026: Use `Effect.cached` in `getOrCreateStoreEffect` for proper memoization of the resolver effect.
+  - effect-app@4.0.0-beta.106
+
+## 4.0.0-beta.105
+
+### Minor Changes
+
+- 3d732b1: Rewrite `withRequestResolverCache` to use official `RequestResolver.withCache`, creating a cached resolver per ContextMap via `getOrCreateStoreEffect` with semaphore-guarded initialization.
+
+### Patch Changes
+
+- 47e53f5: Fix `withRequestResolverCache` causing "RequestResolver did not complete request" errors by using the `preCheck` hook instead of handling cache in `runAll`. Cache hits for in-flight or completed requests are now handled before entries enter the batch, preventing uncompleted entries.
+- 5773159: Add `itemType` annotation to all repository spans
+  - effect-app@4.0.0-beta.105
+
+## 4.0.0-beta.104
+
+### Patch Changes
+
+- Updated dependencies [e944bca]
+  - effect-app@4.0.0-beta.104
+
+## 4.0.0-beta.103
+
+### Patch Changes
+
+- Updated dependencies [7119320]
+  - effect-app@4.0.0-beta.103
+
+## 4.0.0-beta.102
+
+### Patch Changes
+
+- 62627e9: Fix boolean handling in SQL SELECT and WHERE
+  - effect-app@4.0.0-beta.102
+
+## 4.0.0-beta.101
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.101
+
+## 4.0.0-beta.100
+
+### Patch Changes
+
+- 43611c7: enable cosmosdb large partition key hashes
+  - effect-app@4.0.0-beta.100
+
+## 4.0.0-beta.99
+
+### Patch Changes
+
+- 6a0e008: remove artificial Cosmos bulkSet delays
+  - effect-app@4.0.0-beta.99
+
+## 4.0.0-beta.98
+
+### Patch Changes
+
+- 5aed2e3: Add span to Cosmos `batchRemove` and include `namespace` attribute on all Cosmos store spans.
+  - effect-app@4.0.0-beta.98
+
+## 4.0.0-beta.97
+
+### Patch Changes
+
+- 3eb66e9: Fix CosmosDB store `filter` to trigger namespace seeding on first access. Previously, if `filter` was the first operation called on a namespace, seed data was never created.
+  - effect-app@4.0.0-beta.97
+
+## 4.0.0-beta.96
+
+### Patch Changes
+
+- Updated dependencies [5615e47]
+  - effect-app@4.0.0-beta.96
+
+## 4.0.0-beta.95
+
+### Patch Changes
+
+- 88838fb: Remove pick/omit customizations from Class/TaggedClass/Struct/TaggedStruct. Use `Struct.pick(X.fields, [...])` from `effect-app` instead.
+- Updated dependencies [88838fb]
+  - effect-app@4.0.0-beta.95
+
+## 4.0.0-beta.94
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.94
+
+## 4.0.0-beta.93
+
+### Patch Changes
+
+- 2d85646: fix SQL includes-any/all double-quoting values for SQLite (JSON.stringify only needed for Postgres jsonb)
+  - effect-app@4.0.0-beta.93
+
+## 4.0.0-beta.92
+
+### Patch Changes
+
+- b4ffee0: fix SQL whereEvery double-negation bug causing wrong query when operators like notIn are used (especially with empty arrays)
+  - effect-app@4.0.0-beta.92
+
+## 4.0.0-beta.91
+
+### Patch Changes
+
+- Updated dependencies [738b482]
+  - effect-app@4.0.0-beta.91
+
+## 4.0.0-beta.90
+
+### Patch Changes
+
+- d786b91: Fix SQL `whereSome`/`whereEvery` array relation queries using `EXISTS` with `json_each` (SQLite) / `jsonb_array_elements` (Pg).
+  - effect-app@4.0.0-beta.90
+
+## 4.0.0-beta.89
+
+### Patch Changes
+
+- 9a9e46c: Fix SQL select queries to read `_etag` from column instead of JSON data, preventing INSERT on update.
+  - effect-app@4.0.0-beta.89
+
+## 4.0.0-beta.88
+
+### Patch Changes
+
+- dfd5562: Fix SQL `IN`/`NOT IN` with null values to use `IS NULL`/`IS NOT NULL` instead of `IN (NULL, ...)`.
+  - effect-app@4.0.0-beta.88
+
+## 4.0.0-beta.87
+
+### Patch Changes
+
+- 5a709d1: Fix SQLite select query type coercion using `json_quote` and apply defaultValues in SQL WHERE clauses via `COALESCE`.
+  - effect-app@4.0.0-beta.87
+
+## 4.0.0-beta.86
+
+### Patch Changes
+
+- 70f1f27: Fix store seeding: break circular dependency where bulkSet re-entered seedNamespace, and add explicit seed markers to SQL/Pg stores using a dedicated `__seed__` namespace.
+  - effect-app@4.0.0-beta.86
+
+## 4.0.0-beta.85
+
+### Patch Changes
+
+- db285e9: Add per-namespace seeding to SQL (SQLite/PostgreSQL) and CosmosDB store adapters. Previously only the `primary` namespace was seeded at initialization; now each namespace is lazily seeded on first access using `Effect.cached` to guarantee at-most-once execution. Primary namespace continues to seed eagerly on initialization. CosmosDB uses namespace-specific marker documents for backward compatibility.
+  - effect-app@4.0.0-beta.85
+
+## 4.0.0-beta.84
+
+### Patch Changes
+
+- c80e781: Fix SQLite store namespace parameter ordering in filter queries. The `_namespace` placeholder was prepended to the WHERE clause but its value was appended to the end of the positional params array, causing it to bind to the wrong placeholder. PostgreSQL was unaffected (uses indexed `$N` placeholders).
+  - effect-app@4.0.0-beta.84
+
+## 4.0.0-beta.83
+
+### Patch Changes
+
+- d1fc90a: Strip `_etag` and `id` from the `data` JSON column in SQL store adapters (SQLite + PostgreSQL). These fields are already stored as dedicated columns and were redundantly duplicated inside the JSON blob. On read, `parseRow` now re-injects `id` from the row column. Backward compatible: existing rows with `_etag`/`id` in `data` continue to work as the column values take precedence.
+  - effect-app@4.0.0-beta.83
+
+## 4.0.0-beta.82
+
+### Minor Changes
+
+- 48f1457: Add storage namespace support to CosmosDB adapter via partition key prefixing. When `allowNamespace` is configured, the namespace from `storeId` is prepended to partition key values (e.g., `test-ns::primary`), isolating data per namespace within the same container.
+- 48f1457: Add storage namespace support to SQL adapters (SQLite and Postgres) via a `_namespace` column. When `allowNamespace` is configured, a `_namespace` column with composite primary key `(id, _namespace)` isolates data per namespace within the same table. New tables get the schema automatically; existing tables require manual migration.
+- 48f1457: Add SQL Store adapter for Effect SQL (SQLite + PostgreSQL). Table-per-repo with id/etag/data JSON columns, query DSL translation to SQL WHERE clauses, optimistic concurrency via etag.
+- 48f1457: Make `withSqlTransaction` in `setupRequest` configurable via `withTransaction` option (defaults to `false`). Add `requiresTransactionConfig` and `makeSqlTransactionMiddleware` for per-RPC transaction control as a dynamic middleware that requires `SqlClient` directly. Transactions are disabled by default; opt in with `withTransaction: true` or `requiresTransaction: true`.
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.82
+
+## 4.0.0-beta.81
+
+### Minor Changes
+
+- fd67f0b: Add `withRequestResolverCache` to scope RequestResolver cache to the ContextMap (request-scoped). Add `getOrCreateStore` to ContextMap for generic scoped storage.
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.81
+
+## 4.0.0-beta.80
+
+### Patch Changes
+
+- eaf0115: enforce local
+  - effect-app@4.0.0-beta.80
+
+## 4.0.0-beta.79
+
+### Patch Changes
+
+- d16845e: Remove `TaggedRequest` from `makeRpcClient`, now only `TaggedRequestFor` is returned. Remove all legacy `meta.moduleName` support — `id` and `moduleName` are now required on `Req` type. Remove `makeRpcGroup` (use `makeRpcGroupFromRequestsAndModuleName` instead).
+- Updated dependencies [d16845e]
+  - effect-app@4.0.0-beta.79
+
+## 4.0.0-beta.78
+
+### Minor Changes
+
+- 818e047: Router `matchFor` no longer requires `meta` property on resource when requests carry `moduleName` from `TaggedRequestFor`
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.78
+
+## 4.0.0-beta.77
+
+### Patch Changes
+
+- Updated dependencies [3613e87]
+  - effect-app@4.0.0-beta.77
+
+## 4.0.0-beta.76
+
+### Patch Changes
+
+- fac725d: update effect to latest beta
+- Updated dependencies [a5248a9]
+- Updated dependencies [fac725d]
+  - effect-app@4.0.0-beta.76
+
+## 4.0.0-beta.75
+
+### Patch Changes
+
+- Updated dependencies [24f0a5a]
+  - effect-app@4.0.0-beta.75
+
+## 4.0.0-beta.74
+
+### Patch Changes
+
+- Updated dependencies [54ec1ef]
+  - effect-app@4.0.0-beta.74
+
+## 4.0.0-beta.73
+
+### Patch Changes
+
+- b53c59e: fix signature
+  - effect-app@4.0.0-beta.73
+
+## 4.0.0-beta.72
+
+### Patch Changes
+
+- Updated dependencies [0541f0d]
+  - effect-app@4.0.0-beta.72
+
+## 4.0.0-beta.71
+
+### Patch Changes
+
+- beae3a0: Remove `withDefaultConstructor` wrapper, use `S.withConstructorDefault` directly with `Effect.succeed`/`Effect.sync`.
+- Updated dependencies [beae3a0]
+  - effect-app@4.0.0-beta.71
+
+## 4.0.0-beta.70
+
+### Patch Changes
+
+- fdb9cb3: cleanup
+  - effect-app@4.0.0-beta.70
+
+## 4.0.0-beta.69
+
+### Patch Changes
+
+- dc465e3: update to latest effect beta
+- Updated dependencies [dc465e3]
+  - effect-app@4.0.0-beta.69
+
+## 4.0.0-beta.68
+
+### Patch Changes
+
+- Updated dependencies [e6f2341]
+  - effect-app@4.0.0-beta.68
+
+## 4.0.0-beta.67
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.67
+
+## 4.0.0-beta.66
+
+### Patch Changes
+
+- Updated dependencies [edc52e4]
+  - effect-app@4.0.0-beta.66
+
+## 4.0.0-beta.65
+
+### Patch Changes
+
+- Updated dependencies [31739d7]
+- Updated dependencies [1f103b2]
+  - effect-app@4.0.0-beta.65
+
+## 4.0.0-beta.64
+
+### Patch Changes
+
+- Updated dependencies [c1a6fdc]
+  - effect-app@4.0.0-beta.64
+
+## 4.0.0-beta.63
+
+### Patch Changes
+
+- 1f9d7da: fix missing toCodecJson usages
+  - effect-app@4.0.0-beta.63
+
+## 4.0.0-beta.62
+
+### Patch Changes
+
+- Updated dependencies [0b21a02]
+  - effect-app@4.0.0-beta.62
+
+## 4.0.0-beta.61
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.61
+
+## 4.0.0-beta.60
+
+### Patch Changes
+
+- 29c39d2: Fix repository `find` with transformed id fields in tagged union schemas
+  - effect-app@4.0.0-beta.60
+
+## 4.0.0-beta.59
+
+### Patch Changes
+
+- cec026d: update packages
+- Updated dependencies [cec026d]
+  - effect-app@4.0.0-beta.59
+
+## 4.0.0-beta.58
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.58
+
+## 4.0.0-beta.57
+
+### Patch Changes
+
+- fbf47b8: Fix repository `find` with transformed id fields (e.g. composite ids using `decodeTo`)
+  - effect-app@4.0.0-beta.57
+
+## 4.0.0-beta.56
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.56
+
+## 4.0.0-beta.55
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.55
+
+## 4.0.0-beta.54
+
+### Patch Changes
+
+- d867272: the return of `Context`
+- Updated dependencies [d867272]
+  - effect-app@4.0.0-beta.54
+
+## 4.0.0-beta.53
+
+### Patch Changes
+
+- Updated dependencies [ee9694e]
+  - effect-app@4.0.0-beta.53
+
+## 4.0.0-beta.52
+
+### Patch Changes
+
+- Updated dependencies [6252808]
+  - effect-app@4.0.0-beta.52
+
+## 4.0.0-beta.51
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.51
+
+## 4.0.0-beta.50
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.50
+
+## 4.0.0-beta.49
+
+### Patch Changes
+
+- Updated dependencies [e585c9c]
+  - effect-app@4.0.0-beta.49
+
+## 4.0.0-beta.48
+
+### Patch Changes
+
+- Updated dependencies [0c88f78]
+  - effect-app@4.0.0-beta.48
+
+## 4.0.0-beta.47
+
+### Patch Changes
+
+- Updated dependencies [3365758]
+  - effect-app@4.0.0-beta.47
+
+## 4.0.0-beta.46
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.46
+
+## 4.0.0-beta.45
+
+### Patch Changes
+
+- 10b55ff: update packages
+- Updated dependencies [10b55ff]
+  - effect-app@4.0.0-beta.45
+
+## 4.0.0-beta.44
+
+### Patch Changes
+
+- a37aa38: Update to effect beta 43
+- Updated dependencies [a37aa38]
+  - effect-app@4.0.0-beta.44
+
+## 4.0.0-beta.43
+
+### Patch Changes
+
+- dab6992: no need for .lock.lock
+  - effect-app@4.0.0-beta.43
+
+## 4.0.0-beta.42
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.42
+
+## 4.0.0-beta.41
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.41
+
+## 4.0.0-beta.40
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.40
+
+## 4.0.0-beta.39
+
+### Patch Changes
+
+- Updated dependencies [10e90d5]
+  - effect-app@4.0.0-beta.39
+
+## 4.0.0-beta.38
+
+### Patch Changes
+
+- Updated dependencies [0b3e00e]
+  - effect-app@4.0.0-beta.38
+
+## 4.0.0-beta.37
+
+### Patch Changes
+
+- Updated dependencies [947fe20]
+  - effect-app@4.0.0-beta.37
+
+## 4.0.0-beta.36
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.36
+
+## 4.0.0-beta.35
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.35
+
+## 4.0.0-beta.34
+
+### Patch Changes
+
+- 8c645d5: update to latest effect
+- Updated dependencies [8c645d5]
+  - effect-app@4.0.0-beta.34
+
+## 4.0.0-beta.33
+
+### Patch Changes
+
+- 4b95009: use Finite instead of Number
+- Updated dependencies [4b95009]
+  - effect-app@4.0.0-beta.33
+
+## 4.0.0-beta.32
+
+### Patch Changes
+
+- Updated dependencies [01d862a]
+  - effect-app@4.0.0-beta.32
+
+## 4.0.0-beta.31
+
+### Patch Changes
+
+- Updated dependencies [6b6d601]
+  - effect-app@4.0.0-beta.31
+
+## 4.0.0-beta.30
+
+### Patch Changes
+
+- Updated dependencies [5ec1f45]
+  - effect-app@4.0.0-beta.30
+
+## 4.0.0-beta.29
+
+### Patch Changes
+
+- Updated dependencies [a899d46]
+  - effect-app@4.0.0-beta.29
+
+## 4.0.0-beta.28
+
+### Patch Changes
+
+- Updated dependencies [0099208]
+  - effect-app@4.0.0-beta.28
+
+## 4.0.0-beta.27
+
+### Patch Changes
+
+- 601a1ff: update effect to 4.0.0-beta.37 and drop the Schema Class disableValidation workaround now that the patched effect schema covers it
+- Updated dependencies [601a1ff]
+  - effect-app@4.0.0-beta.27
+
+## 4.0.0-beta.26
+
+### Patch Changes
+
+- Updated dependencies [4da28e2]
+  - effect-app@4.0.0-beta.26
+
+## 4.0.0-beta.25
+
+### Patch Changes
+
+- Updated dependencies [6282d4b]
+  - effect-app@4.0.0-beta.25
+
+## 4.0.0-beta.24
+
+### Patch Changes
+
+- Updated dependencies [32f71bf]
+  - effect-app@4.0.0-beta.24
+
+## 4.0.0-beta.23
+
+### Patch Changes
+
+- Updated dependencies [ea08a79]
+  - effect-app@4.0.0-beta.23
+
+## 4.0.0-beta.22
+
+### Patch Changes
+
+- effect-app@4.0.0-beta.22
+
+## 4.0.0-beta.21
+
+### Patch Changes
+
+- 75c72ee: update effect to 4.0.0-beta.36, adapt to Option<A> revert from A | undefined
+- Updated dependencies [0d349e7]
+- Updated dependencies [75c72ee]
+  - effect-app@4.0.0-beta.21
+
 ## 4.0.0-beta.20
 
 ### Patch Changes