@fitzzero/quickdraw-core 5.0.0-rc.1 → 5.0.0-rc.2

package/README.md

@@ -1153,6 +1153,7 @@ export function TaskDetail({ id }: { readonly id: string }) {
   if (isRemoved) {
     return <p>This task was deleted.</p>;
   }
+  // notes reach Admins only (the contract's fields), so its type is optional: guard it
   return (
     <div>
       <h1>{task?.title}</h1>
@@ -1166,6 +1167,10 @@ export function TaskDetail({ id }: { readonly id: string }) {
 }
 ```
 
+- A field the contract's `fields` map tiers (`notes` here) is optional in
+  every row type a reader gets (`useEntity`, collection items, `"entity"`
+  outputs, `EntityOf`, `ItemOf`), because a reader below its level receives
+  the row without it. Handlers still return the full row.
 - A mutation whose input has `id` and whose output is `"entity"` is
   optimistic by default: its input's fields show over the cached row and its
   collection items from the moment it is sent, are dropped if it fails, and
@@ -2514,7 +2519,9 @@ contracts from the method maps, `defineService` from the service classes,
 the typed client for the hooks, and a report of everything left to decide.
 [`MIGRATION.md`](../../MIGRATION.md) explains each step, the access mapping and
 the defaults that changed; [`UPGRADE-PROMPT.md`](../../UPGRADE-PROMPT.md) is the
-procedure for an agent.
+procedure for an agent. Both ship with the codemod, at
+`node_modules/@fitzzero/quickdraw-codemod/MIGRATION.md` and
+`node_modules/@fitzzero/quickdraw-codemod/UPGRADE-PROMPT.md`.
 
 ```bash
 bunx @fitzzero/quickdraw-codemod@next v5 .

package/dist/{admin-DufEkep0.d.ts → admin-Bl71J4IG.d.ts}

@@ -1,4 +1,4 @@
-import { e as StandardSchemaWithJSON, x as SortDirection, d as StandardSchemaV1, I as InferInput, c as InferOutput, L as RowSchema, Q as QueryDef, P as ProjectionList, p as MutationDef, A as AccessLevel, G as AnyContract, ak as MethodName } from './infer-CEfvP0_I.js';
+import { e as StandardSchemaWithJSON, x as SortDirection, d as StandardSchemaV1, I as InferInput, c as InferOutput, L as RowSchema, Q as QueryDef, P as ProjectionList, p as MutationDef, A as AccessLevel, G as AnyContract, al as MethodName } from './infer-Cwq49ME5.js';
 
 /** A schema a kit generates: validation, and its JSON Schema. */
 type KitSchema<Input, Output = Input> = StandardSchemaWithJSON<Input, Output>;

package/dist/{auth-5yi_rUSM.d.ts → auth-DyCIKmTQ.d.ts}

@@ -1,7 +1,7 @@
 import { IncomingHttpHeaders, IncomingMessage } from 'node:http';
 import { Socket } from 'socket.io';
-import { A as AccessLevel } from './infer-CEfvP0_I.js';
-import { P as Principal, M as MaybePromise } from './types-CIq6xwng.js';
+import { A as AccessLevel } from './infer-Cwq49ME5.js';
+import { P as Principal, M as MaybePromise } from './types-BDmssndG.js';
 
 /** A principal's service-wide grants by service name: `{ taskService: "Admin" }`. */
 type ServiceGrants = Readonly<Record<string, AccessLevel>>;

package/dist/{caller-JNTbbD37.d.ts → caller-Cx5wuao-.d.ts}

@@ -1,7 +1,7 @@
-import { ad as Version, a5 as Revision } from './envelope-CR2A9lrd.js';
+import { ad as Version, a5 as Revision } from './envelope-CoiZY9KU.js';
 import { L as Logger } from './logger-BY28acW-.js';
-import { A as AccessLevel, G as AnyContract, w as CollectionWhere, O as OrderBy, k as MethodKind, d as StandardSchemaV1, ac as EventName, ad as EventPayloadOf, a6 as ChannelName, a7 as ChannelPayloadOf, at as StreamName, ah as IsScopedStream, as as StreamItemOf, aa as ContractMap, ak as MethodName, ag as InputOf, am as OutputOf } from './infer-CEfvP0_I.js';
-import { P as Principal, Q as QuickdrawTypes, M as MaybePromise, c as PrincipalOf, a as McpContext, T as Transport, C as ContextExtensionOf, b as McpContextOf, D as DbOf } from './types-CIq6xwng.js';
+import { A as AccessLevel, G as AnyContract, w as CollectionWhere, O as OrderBy, k as MethodKind, d as StandardSchemaV1, ac as EventName, ad as EventPayloadOf, a6 as ChannelName, a7 as ChannelPayloadOf, av as StreamName, ai as IsScopedStream, au as StreamItemOf, aa as ContractMap, al as MethodName, ah as InputOf, an as OutputOf } from './infer-Cwq49ME5.js';
+import { P as Principal, Q as QuickdrawTypes, M as MaybePromise, c as PrincipalOf, a as McpContext, T as Transport, C as ContextExtensionOf, b as McpContextOf, D as DbOf } from './types-BDmssndG.js';
 
 /** What a development warning is about. */
 type DevWarningKind = "n-plus-one" | "unbounded-read" | "oversized-response" | "nested-write" | "ambient-write" | "batch-read" | "batch-create-many" | "repeated-call";

package/dist/{chunk-ONVWF4IM.js → chunk-DXTJNJM5.js}

@@ -11,7 +11,7 @@ import {
   collectionTopic,
   isAuthenticationRefused,
   isProtocolMismatch
-} from "./chunk-4QNDKNDK.js";
+} from "./chunk-SSDLYYQV.js";
 import {
   DEFAULT_COLLECTION_MAX_LIMIT,
   isScopedStream
@@ -4847,4 +4847,4 @@ export {
   QuickdrawProvider,
   useQuickdraw
 };
-//# sourceMappingURL=chunk-ONVWF4IM.js.map
+//# sourceMappingURL=chunk-DXTJNJM5.js.map

package/dist/{chunk-EQ2LW5C5.js → chunk-I2OMV4AD.js}

@@ -74,7 +74,7 @@ import {
   streamRoom,
   topicRoom,
   userRoom
-} from "./chunk-4QNDKNDK.js";
+} from "./chunk-SSDLYYQV.js";
 import {
   hasJsonSchema
 } from "./chunk-47AEXVDM.js";
@@ -8293,4 +8293,4 @@ export {
   watchAdapterClients,
   createServer
 };
-//# sourceMappingURL=chunk-EQ2LW5C5.js.map
+//# sourceMappingURL=chunk-I2OMV4AD.js.map

package/dist/{chunk-4QNDKNDK.js → chunk-SSDLYYQV.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-V3KNCTXJ.js";
 
 // src/version.ts
-var QUICKDRAW_VERSION = "5.0.0-rc.1";
+var QUICKDRAW_VERSION = "5.0.0-rc.2";
 
 // src/contract/names.ts
 function entityRoom(service, id, level) {
@@ -114,4 +114,4 @@ export {
   MAX_SUBSCRIBE_IDS,
   MAX_SCOPE_LENGTH
 };
-//# sourceMappingURL=chunk-4QNDKNDK.js.map
+//# sourceMappingURL=chunk-SSDLYYQV.js.map

package/dist/{chunk-4QNDKNDK.js.map → chunk-SSDLYYQV.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/version.ts","../src/contract/names.ts","../src/protocol/version.ts"],"sourcesContent":["/** The published version of `@fitzzero/quickdraw-core`. Kept in step with package.json. */\nexport const QUICKDRAW_VERSION = \"5.0.0-rc.1\";\n","// Room and event names for protocol v5 (RFC 0003 sections 6, 7 and 8). Ported\n// from the 4.1 room helpers (`legacy-src/shared/types.ts:364-405`), which were\n// plain template strings so shared code could name a room without holding a\n// service instance. The 5.0 rooms live under a `qd:` prefix so they never\n// collide with an app's own rooms; the per-user room keeps its 4.1 name.\n\nimport type { AccessLevel } from \"./access\";\n\n/**\n * The room for one entity at one access tier: `qd:e:{service}:{id}@{level}`.\n * A subscriber joins the room for its own level, so a frame is built once and\n * stripped once per occupied tier.\n */\nexport function entityRoom(service: string, id: string, level: AccessLevel): string {\n  return `qd:e:${service}:${id}@${level}`;\n}\n\n/** The room for one scope of a collection: `qd:c:{service}:{collection}:{scope}`. */\nexport function collectionRoom(service: string, collection: string, scope: string): string {\n  return `qd:c:${service}:${collection}:${scope}`;\n}\n\n/** The room for a watched topic of a service: `qd:t:{service}:{topic}`. */\nexport function topicRoom(service: string, topic: string): string {\n  return `qd:t:${service}:${topic}`;\n}\n\n/**\n * The change topic of a whole service (RFC 0003 section 11.3): every flush\n * that changes one of its rows or collection scopes signals it.\n */\nexport const SERVICE_TOPIC = \"service\";\n\n/** The change topic of one scope of a collection: `{collection}:{scope}` (RFC 0003 section 11.3). */\nexport function collectionTopic(collection: string, scope: string): string {\n  return `${collection}:${scope}`;\n}\n\n/**\n * The room of a stream's feed (RFC 0003 section 12.5):\n * `qd:s:{service}:{stream}:{scope}` for one scope of a scoped stream, and\n * `qd:s:{service}:{stream}` for a global stream. Stream names hold no colon.\n */\nexport function streamRoom(service: string, stream: string, scope?: string): string {\n  return scope === undefined ? `qd:s:${service}:${stream}` : `qd:s:${service}:${stream}:${scope}`;\n}\n\n/** The room every authenticated socket of a user joins: `user:{userId}`, as in 4.1. */\nexport function userRoom(userId: string): string {\n  return `user:${userId}`;\n}\n\n/**\n * The prefixes of the rooms the framework manages: entity, collection, topic\n * and stream rooms (`qd:`) and user rooms (`user:`). `ctx.rooms.join` refuses\n * them; a socket enters those rooms only through their authorized paths.\n */\nexport const RESERVED_ROOM_PREFIXES: readonly string[] = Object.freeze([\"qd:\", \"user:\"]);\n\n/**\n * The reserved prefix `room` starts with (`qd:` or `user:`), or `undefined`\n * when an app room may have that name.\n */\nexport function reservedRoomPrefix(room: string): string | undefined {\n  return RESERVED_ROOM_PREFIXES.find((prefix) => room.startsWith(prefix));\n}\n\n/** Events a client sends to the server (RFC 0003 section 8.2). */\nexport const CLIENT_EVENTS = Object.freeze({\n  /** A method call: `{ id, s, m, i, v? }`, answered by ack. */\n  call: \"qd:call\",\n  /** Cancels an in-flight call: `{ id }`. */\n  cancel: \"qd:cancel\",\n  /** Subscribes to entities by id, with the revisions held. */\n  sub: \"qd:sub\",\n  /** Unsubscribes from entities. */\n  unsub: \"qd:unsub\",\n  /** Subscribes to a collection scope, or resumes it from a revision. */\n  collectionSub: \"qd:col:sub\",\n  /** Unsubscribes from a collection scope. */\n  collectionUnsub: \"qd:col:unsub\",\n  /** Loads collection items by id. */\n  collectionItems: \"qd:col:items\",\n  /** Joins a watched topic: `{ s, topic }`. */\n  watch: \"qd:watch\",\n  /** Leaves a watched topic. */\n  unwatch: \"qd:unwatch\",\n  /** Subscribes to a stream and receives its seed. */\n  streamSub: \"qd:stream:sub\",\n  /** Unsubscribes from a stream. */\n  streamUnsub: \"qd:stream:unsub\",\n  /** A fire-and-forget channel message, sent volatile: `[s, channel, payload]`. */\n  channel: \"qd:ch\",\n} as const);\n\n/** Events the server sends to a client (RFC 0003 section 8.3). */\nexport const SERVER_EVENTS = Object.freeze({\n  /** The handshake reply: `{ protocol, server, limits, features, userId, serviceAccess }`. */\n  hello: \"qd:hello\",\n  /** Entity frames: full update, patch or removal. */\n  entity: \"qd:e\",\n  /** Collection deltas, batched per flush. */\n  collection: \"qd:c\",\n  /** A watched topic changed; the client invalidates its queries. */\n  changed: \"qd:changed\",\n  /** Access to a subscription was revoked. */\n  revoked: \"qd:revoked\",\n  /** Stream items. */\n  stream: \"qd:stream\",\n  /** Typed custom room events declared in a contract's `events`. */\n  event: \"qd:event\",\n  /** Who is in an app room the socket is in: the list on joining, then each user who joins or leaves. */\n  presence: \"qd:presence\",\n  /** Reconnect within a jitter window. */\n  rotate: \"qd:rotate\",\n  /** The user's service grants changed. */\n  access: \"qd:access\",\n} as const);\n\n/** The name of an event a client sends. */\nexport type ClientEventName = (typeof CLIENT_EVENTS)[keyof typeof CLIENT_EVENTS];\n\n/** The name of an event the server sends. */\nexport type ServerEventName = (typeof SERVER_EVENTS)[keyof typeof SERVER_EVENTS];\n","// The protocol version and the connection handshake (RFC 0003 section 8.1).\n// A v5 client connects with `auth: { token, qd: { protocol: 5, client } }`.\n// The server answers with `qd:hello`, or refuses a client that names another\n// protocol with `PROTOCOL_MISMATCH` in the `connect_error` data, and one whose\n// authentication failed with `UNAUTHENTICATED` there. A client that sends no\n// `auth.qd` is a 4.x client, which only the legacy shim serves (section 8.5).\n// There is no capability negotiation: the version decides.\n\nimport type { AccessLevel } from \"../contract/access\";\nimport { isRecord } from \"./guards\";\n\n/** The wire protocol this package speaks. */\nexport const PROTOCOL_VERSION = 5;\n\n/** `auth.qd`: what a v5 client sends when it connects. */\nexport interface QdHandshake {\n  /** The protocol the client speaks. The server refuses any but its own. */\n  readonly protocol: number;\n  /** The client package's version, for logs. */\n  readonly client: string;\n}\n\n/** The Socket.IO `auth` a v5 client connects with. */\nexport interface HandshakeAuth {\n  /** The session token the server's `authenticate` reads. */\n  readonly token?: string;\n  /** The protocol the client speaks. A client without it is a 4.x client (RFC 0003 section 8.5). */\n  readonly qd: QdHandshake;\n}\n\n/**\n * True when `value` has the shape of `auth.qd`, whatever protocol it names.\n * Compare `protocol` with {@link PROTOCOL_VERSION} to decide whether to serve it.\n */\nexport function isQdHandshake(value: unknown): value is QdHandshake {\n  return isRecord(value) && Number.isInteger(value.protocol) && typeof value.client === \"string\";\n}\n\n/** The code in the `connect_error` data of a connection refused for its protocol. */\nexport const PROTOCOL_MISMATCH = \"PROTOCOL_MISMATCH\";\n\n/**\n * The `data` of the error a server refuses a connection with when the client\n * speaks another protocol, or none. It is not an `ErrorCode`: no call failed.\n */\nexport interface ProtocolMismatch {\n  readonly code: typeof PROTOCOL_MISMATCH;\n  /** The protocol the server speaks. */\n  readonly expected: number;\n}\n\n/** True when a `connect_error`'s `data` says the server speaks another protocol. */\nexport function isProtocolMismatch(value: unknown): value is ProtocolMismatch {\n  return isRecord(value) && value.code === PROTOCOL_MISMATCH && Number.isInteger(value.expected);\n}\n\n/**\n * The `data` of the error a server refuses a connection with when\n * authenticating it failed: the app's `authenticate` threw, so the\n * credentials are bad or could not be checked. A client tells it apart from\n * {@link ProtocolMismatch} by `code`; reconnecting needs other credentials.\n */\nexport interface AuthenticationRefused {\n  readonly code: \"UNAUTHENTICATED\";\n}\n\n/** True when a `connect_error`'s `data` says authenticating the connection failed. */\nexport function isAuthenticationRefused(value: unknown): value is AuthenticationRefused {\n  return isRecord(value) && value.code === \"UNAUTHENTICATED\";\n}\n\n/** The most ids one `qd:sub` may name (RFC 0003 section 6), as `qd:hello` announces it. */\nexport const MAX_SUBSCRIBE_IDS = 500;\n\n/** The longest collection scope value or change topic a frame may name, in characters. */\nexport const MAX_SCOPE_LENGTH = 256;\n\n/**\n * Each socket's lane of subscription events (`qd:sub`, `qd:col:sub`,\n * `qd:col:items`, `qd:watch`; RFC 0003 section 8.2), as `qd:hello` announces it.\n */\nexport interface HelloSubscriptionLimits {\n  /** Subscription events one socket may have running at once. */\n  readonly maxInFlight: number;\n  /** Subscription events one socket may have waiting; past that one fails with `RATE_LIMITED`. */\n  readonly maxQueued: number;\n}\n\n/** The limits a server announces in `qd:hello`, so a client can stay inside them. */\nexport interface HelloLimits {\n  /** Queries one socket may have running at once; more wait in a queue (RFC 0003 section 9). */\n  readonly maxInFlightQueries: number;\n  /** Queries one socket may have waiting; past that a query fails with `RATE_LIMITED`. */\n  readonly maxQueuedQueries: number;\n  /** Ids one `qd:sub` may name (RFC 0003 section 6). */\n  readonly maxSubscribeIds: number;\n  /**\n   * A call's default time limit in milliseconds, after which it fails with\n   * `TIMEOUT`. A v5 client waits this long plus 2 s for an answer, so a slow\n   * call ends with the server's `TIMEOUT` rather than its own.\n   */\n  readonly callTimeoutMs: number;\n  /** The socket's lane of subscription events. */\n  readonly subscriptions: HelloSubscriptionLimits;\n}\n\n/**\n * `qd:hello`: the server's answer to a v5 handshake, sent once per\n * connection, after the socket's listeners are in place. It says who the\n * socket acts for, so a client knows its user without another call.\n */\nexport interface HelloFrame {\n  /** The protocol the server speaks. */\n  readonly protocol: typeof PROTOCOL_VERSION;\n  /** The server package's version. */\n  readonly server: string;\n  /** What a client must stay within. */\n  readonly limits: HelloLimits;\n  /** Names of optional server features that are on. Informational only. */\n  readonly features: readonly string[];\n  /** The user the socket acts for, or `null` when it is anonymous. */\n  readonly userId: string | null;\n  /**\n   * The principal's service-wide grants when the socket connected, by\n   * service name: `{ taskService: \"Admin\" }`. Empty for an anonymous socket\n   * or a principal without grants. Later changes arrive as `qd:access`.\n   */\n  readonly serviceAccess: Readonly<Record<string, AccessLevel>>;\n}\n"],"mappings":";;;;;AACO,IAAM,oBAAoB;;;ACY1B,SAAS,WAAW,SAAiB,IAAY,OAA4B;AAClF,SAAO,QAAQ,OAAO,IAAI,EAAE,IAAI,KAAK;AACvC;AAGO,SAAS,eAAe,SAAiB,YAAoB,OAAuB;AACzF,SAAO,QAAQ,OAAO,IAAI,UAAU,IAAI,KAAK;AAC/C;AAGO,SAAS,UAAU,SAAiB,OAAuB;AAChE,SAAO,QAAQ,OAAO,IAAI,KAAK;AACjC;AAMO,IAAM,gBAAgB;AAGtB,SAAS,gBAAgB,YAAoB,OAAuB;AACzE,SAAO,GAAG,UAAU,IAAI,KAAK;AAC/B;AAOO,SAAS,WAAW,SAAiB,QAAgB,OAAwB;AAClF,SAAO,UAAU,SAAY,QAAQ,OAAO,IAAI,MAAM,KAAK,QAAQ,OAAO,IAAI,MAAM,IAAI,KAAK;AAC/F;AAGO,SAAS,SAAS,QAAwB;AAC/C,SAAO,QAAQ,MAAM;AACvB;AAOO,IAAM,yBAA4C,OAAO,OAAO,CAAC,OAAO,OAAO,CAAC;AAMhF,SAAS,mBAAmB,MAAkC;AACnE,SAAO,uBAAuB,KAAK,CAAC,WAAW,KAAK,WAAW,MAAM,CAAC;AACxE;AAGO,IAAM,gBAAgB,OAAO,OAAO;AAAA;AAAA,EAEzC,MAAM;AAAA;AAAA,EAEN,QAAQ;AAAA;AAAA,EAER,KAAK;AAAA;AAAA,EAEL,OAAO;AAAA;AAAA,EAEP,eAAe;AAAA;AAAA,EAEf,iBAAiB;AAAA;AAAA,EAEjB,iBAAiB;AAAA;AAAA,EAEjB,OAAO;AAAA;AAAA,EAEP,SAAS;AAAA;AAAA,EAET,WAAW;AAAA;AAAA,EAEX,aAAa;AAAA;AAAA,EAEb,SAAS;AACX,CAAU;AAGH,IAAM,gBAAgB,OAAO,OAAO;AAAA;AAAA,EAEzC,OAAO;AAAA;AAAA,EAEP,QAAQ;AAAA;AAAA,EAER,YAAY;AAAA;AAAA,EAEZ,SAAS;AAAA;AAAA,EAET,SAAS;AAAA;AAAA,EAET,QAAQ;AAAA;AAAA,EAER,OAAO;AAAA;AAAA,EAEP,UAAU;AAAA;AAAA,EAEV,QAAQ;AAAA;AAAA,EAER,QAAQ;AACV,CAAU;;;ACzGH,IAAM,mBAAmB;AAsBzB,SAAS,cAAc,OAAsC;AAClE,SAAO,SAAS,KAAK,KAAK,OAAO,UAAU,MAAM,QAAQ,KAAK,OAAO,MAAM,WAAW;AACxF;AAGO,IAAM,oBAAoB;AAa1B,SAAS,mBAAmB,OAA2C;AAC5E,SAAO,SAAS,KAAK,KAAK,MAAM,SAAS,qBAAqB,OAAO,UAAU,MAAM,QAAQ;AAC/F;AAaO,SAAS,wBAAwB,OAAgD;AACtF,SAAO,SAAS,KAAK,KAAK,MAAM,SAAS;AAC3C;AAGO,IAAM,oBAAoB;AAG1B,IAAM,mBAAmB;","names":[]}
+{"version":3,"sources":["../src/version.ts","../src/contract/names.ts","../src/protocol/version.ts"],"sourcesContent":["/** The published version of `@fitzzero/quickdraw-core`. Kept in step with package.json. */\nexport const QUICKDRAW_VERSION = \"5.0.0-rc.2\";\n","// Room and event names for protocol v5 (RFC 0003 sections 6, 7 and 8). Ported\n// from the 4.1 room helpers (`legacy-src/shared/types.ts:364-405`), which were\n// plain template strings so shared code could name a room without holding a\n// service instance. The 5.0 rooms live under a `qd:` prefix so they never\n// collide with an app's own rooms; the per-user room keeps its 4.1 name.\n\nimport type { AccessLevel } from \"./access\";\n\n/**\n * The room for one entity at one access tier: `qd:e:{service}:{id}@{level}`.\n * A subscriber joins the room for its own level, so a frame is built once and\n * stripped once per occupied tier.\n */\nexport function entityRoom(service: string, id: string, level: AccessLevel): string {\n  return `qd:e:${service}:${id}@${level}`;\n}\n\n/** The room for one scope of a collection: `qd:c:{service}:{collection}:{scope}`. */\nexport function collectionRoom(service: string, collection: string, scope: string): string {\n  return `qd:c:${service}:${collection}:${scope}`;\n}\n\n/** The room for a watched topic of a service: `qd:t:{service}:{topic}`. */\nexport function topicRoom(service: string, topic: string): string {\n  return `qd:t:${service}:${topic}`;\n}\n\n/**\n * The change topic of a whole service (RFC 0003 section 11.3): every flush\n * that changes one of its rows or collection scopes signals it.\n */\nexport const SERVICE_TOPIC = \"service\";\n\n/** The change topic of one scope of a collection: `{collection}:{scope}` (RFC 0003 section 11.3). */\nexport function collectionTopic(collection: string, scope: string): string {\n  return `${collection}:${scope}`;\n}\n\n/**\n * The room of a stream's feed (RFC 0003 section 12.5):\n * `qd:s:{service}:{stream}:{scope}` for one scope of a scoped stream, and\n * `qd:s:{service}:{stream}` for a global stream. Stream names hold no colon.\n */\nexport function streamRoom(service: string, stream: string, scope?: string): string {\n  return scope === undefined ? `qd:s:${service}:${stream}` : `qd:s:${service}:${stream}:${scope}`;\n}\n\n/** The room every authenticated socket of a user joins: `user:{userId}`, as in 4.1. */\nexport function userRoom(userId: string): string {\n  return `user:${userId}`;\n}\n\n/**\n * The prefixes of the rooms the framework manages: entity, collection, topic\n * and stream rooms (`qd:`) and user rooms (`user:`). `ctx.rooms.join` refuses\n * them; a socket enters those rooms only through their authorized paths.\n */\nexport const RESERVED_ROOM_PREFIXES: readonly string[] = Object.freeze([\"qd:\", \"user:\"]);\n\n/**\n * The reserved prefix `room` starts with (`qd:` or `user:`), or `undefined`\n * when an app room may have that name.\n */\nexport function reservedRoomPrefix(room: string): string | undefined {\n  return RESERVED_ROOM_PREFIXES.find((prefix) => room.startsWith(prefix));\n}\n\n/** Events a client sends to the server (RFC 0003 section 8.2). */\nexport const CLIENT_EVENTS = Object.freeze({\n  /** A method call: `{ id, s, m, i, v? }`, answered by ack. */\n  call: \"qd:call\",\n  /** Cancels an in-flight call: `{ id }`. */\n  cancel: \"qd:cancel\",\n  /** Subscribes to entities by id, with the revisions held. */\n  sub: \"qd:sub\",\n  /** Unsubscribes from entities. */\n  unsub: \"qd:unsub\",\n  /** Subscribes to a collection scope, or resumes it from a revision. */\n  collectionSub: \"qd:col:sub\",\n  /** Unsubscribes from a collection scope. */\n  collectionUnsub: \"qd:col:unsub\",\n  /** Loads collection items by id. */\n  collectionItems: \"qd:col:items\",\n  /** Joins a watched topic: `{ s, topic }`. */\n  watch: \"qd:watch\",\n  /** Leaves a watched topic. */\n  unwatch: \"qd:unwatch\",\n  /** Subscribes to a stream and receives its seed. */\n  streamSub: \"qd:stream:sub\",\n  /** Unsubscribes from a stream. */\n  streamUnsub: \"qd:stream:unsub\",\n  /** A fire-and-forget channel message, sent volatile: `[s, channel, payload]`. */\n  channel: \"qd:ch\",\n} as const);\n\n/** Events the server sends to a client (RFC 0003 section 8.3). */\nexport const SERVER_EVENTS = Object.freeze({\n  /** The handshake reply: `{ protocol, server, limits, features, userId, serviceAccess }`. */\n  hello: \"qd:hello\",\n  /** Entity frames: full update, patch or removal. */\n  entity: \"qd:e\",\n  /** Collection deltas, batched per flush. */\n  collection: \"qd:c\",\n  /** A watched topic changed; the client invalidates its queries. */\n  changed: \"qd:changed\",\n  /** Access to a subscription was revoked. */\n  revoked: \"qd:revoked\",\n  /** Stream items. */\n  stream: \"qd:stream\",\n  /** Typed custom room events declared in a contract's `events`. */\n  event: \"qd:event\",\n  /** Who is in an app room the socket is in: the list on joining, then each user who joins or leaves. */\n  presence: \"qd:presence\",\n  /** Reconnect within a jitter window. */\n  rotate: \"qd:rotate\",\n  /** The user's service grants changed. */\n  access: \"qd:access\",\n} as const);\n\n/** The name of an event a client sends. */\nexport type ClientEventName = (typeof CLIENT_EVENTS)[keyof typeof CLIENT_EVENTS];\n\n/** The name of an event the server sends. */\nexport type ServerEventName = (typeof SERVER_EVENTS)[keyof typeof SERVER_EVENTS];\n","// The protocol version and the connection handshake (RFC 0003 section 8.1).\n// A v5 client connects with `auth: { token, qd: { protocol: 5, client } }`.\n// The server answers with `qd:hello`, or refuses a client that names another\n// protocol with `PROTOCOL_MISMATCH` in the `connect_error` data, and one whose\n// authentication failed with `UNAUTHENTICATED` there. A client that sends no\n// `auth.qd` is a 4.x client, which only the legacy shim serves (section 8.5).\n// There is no capability negotiation: the version decides.\n\nimport type { AccessLevel } from \"../contract/access\";\nimport { isRecord } from \"./guards\";\n\n/** The wire protocol this package speaks. */\nexport const PROTOCOL_VERSION = 5;\n\n/** `auth.qd`: what a v5 client sends when it connects. */\nexport interface QdHandshake {\n  /** The protocol the client speaks. The server refuses any but its own. */\n  readonly protocol: number;\n  /** The client package's version, for logs. */\n  readonly client: string;\n}\n\n/** The Socket.IO `auth` a v5 client connects with. */\nexport interface HandshakeAuth {\n  /** The session token the server's `authenticate` reads. */\n  readonly token?: string;\n  /** The protocol the client speaks. A client without it is a 4.x client (RFC 0003 section 8.5). */\n  readonly qd: QdHandshake;\n}\n\n/**\n * True when `value` has the shape of `auth.qd`, whatever protocol it names.\n * Compare `protocol` with {@link PROTOCOL_VERSION} to decide whether to serve it.\n */\nexport function isQdHandshake(value: unknown): value is QdHandshake {\n  return isRecord(value) && Number.isInteger(value.protocol) && typeof value.client === \"string\";\n}\n\n/** The code in the `connect_error` data of a connection refused for its protocol. */\nexport const PROTOCOL_MISMATCH = \"PROTOCOL_MISMATCH\";\n\n/**\n * The `data` of the error a server refuses a connection with when the client\n * speaks another protocol, or none. It is not an `ErrorCode`: no call failed.\n */\nexport interface ProtocolMismatch {\n  readonly code: typeof PROTOCOL_MISMATCH;\n  /** The protocol the server speaks. */\n  readonly expected: number;\n}\n\n/** True when a `connect_error`'s `data` says the server speaks another protocol. */\nexport function isProtocolMismatch(value: unknown): value is ProtocolMismatch {\n  return isRecord(value) && value.code === PROTOCOL_MISMATCH && Number.isInteger(value.expected);\n}\n\n/**\n * The `data` of the error a server refuses a connection with when\n * authenticating it failed: the app's `authenticate` threw, so the\n * credentials are bad or could not be checked. A client tells it apart from\n * {@link ProtocolMismatch} by `code`; reconnecting needs other credentials.\n */\nexport interface AuthenticationRefused {\n  readonly code: \"UNAUTHENTICATED\";\n}\n\n/** True when a `connect_error`'s `data` says authenticating the connection failed. */\nexport function isAuthenticationRefused(value: unknown): value is AuthenticationRefused {\n  return isRecord(value) && value.code === \"UNAUTHENTICATED\";\n}\n\n/** The most ids one `qd:sub` may name (RFC 0003 section 6), as `qd:hello` announces it. */\nexport const MAX_SUBSCRIBE_IDS = 500;\n\n/** The longest collection scope value or change topic a frame may name, in characters. */\nexport const MAX_SCOPE_LENGTH = 256;\n\n/**\n * Each socket's lane of subscription events (`qd:sub`, `qd:col:sub`,\n * `qd:col:items`, `qd:watch`; RFC 0003 section 8.2), as `qd:hello` announces it.\n */\nexport interface HelloSubscriptionLimits {\n  /** Subscription events one socket may have running at once. */\n  readonly maxInFlight: number;\n  /** Subscription events one socket may have waiting; past that one fails with `RATE_LIMITED`. */\n  readonly maxQueued: number;\n}\n\n/** The limits a server announces in `qd:hello`, so a client can stay inside them. */\nexport interface HelloLimits {\n  /** Queries one socket may have running at once; more wait in a queue (RFC 0003 section 9). */\n  readonly maxInFlightQueries: number;\n  /** Queries one socket may have waiting; past that a query fails with `RATE_LIMITED`. */\n  readonly maxQueuedQueries: number;\n  /** Ids one `qd:sub` may name (RFC 0003 section 6). */\n  readonly maxSubscribeIds: number;\n  /**\n   * A call's default time limit in milliseconds, after which it fails with\n   * `TIMEOUT`. A v5 client waits this long plus 2 s for an answer, so a slow\n   * call ends with the server's `TIMEOUT` rather than its own.\n   */\n  readonly callTimeoutMs: number;\n  /** The socket's lane of subscription events. */\n  readonly subscriptions: HelloSubscriptionLimits;\n}\n\n/**\n * `qd:hello`: the server's answer to a v5 handshake, sent once per\n * connection, after the socket's listeners are in place. It says who the\n * socket acts for, so a client knows its user without another call.\n */\nexport interface HelloFrame {\n  /** The protocol the server speaks. */\n  readonly protocol: typeof PROTOCOL_VERSION;\n  /** The server package's version. */\n  readonly server: string;\n  /** What a client must stay within. */\n  readonly limits: HelloLimits;\n  /** Names of optional server features that are on. Informational only. */\n  readonly features: readonly string[];\n  /** The user the socket acts for, or `null` when it is anonymous. */\n  readonly userId: string | null;\n  /**\n   * The principal's service-wide grants when the socket connected, by\n   * service name: `{ taskService: \"Admin\" }`. Empty for an anonymous socket\n   * or a principal without grants. Later changes arrive as `qd:access`.\n   */\n  readonly serviceAccess: Readonly<Record<string, AccessLevel>>;\n}\n"],"mappings":";;;;;AACO,IAAM,oBAAoB;;;ACY1B,SAAS,WAAW,SAAiB,IAAY,OAA4B;AAClF,SAAO,QAAQ,OAAO,IAAI,EAAE,IAAI,KAAK;AACvC;AAGO,SAAS,eAAe,SAAiB,YAAoB,OAAuB;AACzF,SAAO,QAAQ,OAAO,IAAI,UAAU,IAAI,KAAK;AAC/C;AAGO,SAAS,UAAU,SAAiB,OAAuB;AAChE,SAAO,QAAQ,OAAO,IAAI,KAAK;AACjC;AAMO,IAAM,gBAAgB;AAGtB,SAAS,gBAAgB,YAAoB,OAAuB;AACzE,SAAO,GAAG,UAAU,IAAI,KAAK;AAC/B;AAOO,SAAS,WAAW,SAAiB,QAAgB,OAAwB;AAClF,SAAO,UAAU,SAAY,QAAQ,OAAO,IAAI,MAAM,KAAK,QAAQ,OAAO,IAAI,MAAM,IAAI,KAAK;AAC/F;AAGO,SAAS,SAAS,QAAwB;AAC/C,SAAO,QAAQ,MAAM;AACvB;AAOO,IAAM,yBAA4C,OAAO,OAAO,CAAC,OAAO,OAAO,CAAC;AAMhF,SAAS,mBAAmB,MAAkC;AACnE,SAAO,uBAAuB,KAAK,CAAC,WAAW,KAAK,WAAW,MAAM,CAAC;AACxE;AAGO,IAAM,gBAAgB,OAAO,OAAO;AAAA;AAAA,EAEzC,MAAM;AAAA;AAAA,EAEN,QAAQ;AAAA;AAAA,EAER,KAAK;AAAA;AAAA,EAEL,OAAO;AAAA;AAAA,EAEP,eAAe;AAAA;AAAA,EAEf,iBAAiB;AAAA;AAAA,EAEjB,iBAAiB;AAAA;AAAA,EAEjB,OAAO;AAAA;AAAA,EAEP,SAAS;AAAA;AAAA,EAET,WAAW;AAAA;AAAA,EAEX,aAAa;AAAA;AAAA,EAEb,SAAS;AACX,CAAU;AAGH,IAAM,gBAAgB,OAAO,OAAO;AAAA;AAAA,EAEzC,OAAO;AAAA;AAAA,EAEP,QAAQ;AAAA;AAAA,EAER,YAAY;AAAA;AAAA,EAEZ,SAAS;AAAA;AAAA,EAET,SAAS;AAAA;AAAA,EAET,QAAQ;AAAA;AAAA,EAER,OAAO;AAAA;AAAA,EAEP,UAAU;AAAA;AAAA,EAEV,QAAQ;AAAA;AAAA,EAER,QAAQ;AACV,CAAU;;;ACzGH,IAAM,mBAAmB;AAsBzB,SAAS,cAAc,OAAsC;AAClE,SAAO,SAAS,KAAK,KAAK,OAAO,UAAU,MAAM,QAAQ,KAAK,OAAO,MAAM,WAAW;AACxF;AAGO,IAAM,oBAAoB;AAa1B,SAAS,mBAAmB,OAA2C;AAC5E,SAAO,SAAS,KAAK,KAAK,MAAM,SAAS,qBAAqB,OAAO,UAAU,MAAM,QAAQ;AAC/F;AAaO,SAAS,wBAAwB,OAAgD;AACtF,SAAO,SAAS,KAAK,KAAK,MAAM,SAAS;AAC3C;AAGO,IAAM,oBAAoB;AAG1B,IAAM,mBAAmB;","names":[]}

package/dist/client/index.d.ts

@@ -1,10 +1,10 @@
 export { BreadcrumbItem, JWTPayload, NavItem, ServerCallOptions, ServerCaller, ServerCallerHeaders, ServerCallerOptions, ServerMethod, ServerMutation, ServerQuery, buildBreadcrumbs, createServerCaller, findNavItemByHref, findParentNavItem, formatCurrency, formatDate, formatDateTime, formatNumber, formatPercent, parseJWTPayload, routeRequiresAuth, truncate } from '../utils/index.js';
 import { C as CollectionQueryKey } from '../keys-CqKkljVN.js';
 export { E as EntityQueryKey, K as KEY_ROOT, b as MethodKeyPrefix, M as MethodQueryKey, S as ServiceKeyPrefix, c as collectionKey, e as entityKey, m as methodKey, a as methodKeyPrefix, s as serviceKeyPrefix } from '../keys-CqKkljVN.js';
-import { d as QuickdrawConnection, c as QuickdrawClient, e as QuickdrawConnectionOptions, f as ConnectionAuth, g as ConnectionStatus, h as ConnectionRefusal } from '../clientTypes-B9eYqDO1.js';
-export { A as AdminMembers, B as BackoffKind, m as BackoffWindows, a as ChannelMember, C as CollectionMember, j as ConnectionState, D as DEFAULT_BACKOFF_MS, n as DEFAULT_SUBSCRIPTION_LANE, E as EntityMembers, b as EventMember, P as GlobalStreamMember, J as JoinWait, L as LaneCallback, u as LiveMembers, M as MethodMember, a2 as MethodMutationOptions, a3 as MethodQueryOptions, v as MutationCallOptions, w as MutationMember, x as MutationVariables, O as OptimisticCache, y as OptimisticCacheOf, r as OptimisticUpdate, s as OverlayStore, t as OverlayView, z as QueryCallOptions, F as QueryMember, Q as QuickdrawInvalidate, k as QuickdrawSocket, R as RealtimeMembers, V as ScopedStreamMember, _ as SearchMember, $ as SearchMemberOf, G as ServiceClient, l as SocketClientOptions, S as StreamMember, o as SubscriptionEvent, p as SubscriptionLane, T as TopicWatch, W as UseChannelResult, U as UseCollectionOptions, H as UseCollectionResult, I as UseEntitiesResult, K as UseEntityOptions, N as UseEntityResult, X as UseEventOptions, a0 as UseSearchOptions, a1 as UseSearchResult, Y as UseStreamOptions, Z as UseStreamResult, i as createQuickdrawConnection, q as overlaysOf } from '../clientTypes-B9eYqDO1.js';
-import { k as MethodKind, O as OrderBy, C as CollectionDef, aa as ContractMap, A as AccessLevel } from '../infer-CEfvP0_I.js';
-import { ad as Version, y as CallSuccess, w as CallNotModified, n as ProtocolMismatch, a5 as Revision, F as CollectionDelta, G as CollectionFrame, a7 as RevokeReason, k as HelloFrame } from '../envelope-CR2A9lrd.js';
+import { d as QuickdrawConnection, c as QuickdrawClient, e as QuickdrawConnectionOptions, f as ConnectionAuth, g as ConnectionStatus, h as ConnectionRefusal } from '../clientTypes-B62bWHua.js';
+export { A as AdminMembers, B as BackoffKind, m as BackoffWindows, a as ChannelMember, C as CollectionMember, j as ConnectionState, D as DEFAULT_BACKOFF_MS, n as DEFAULT_SUBSCRIPTION_LANE, E as EntityMembers, b as EventMember, P as GlobalStreamMember, J as JoinWait, L as LaneCallback, u as LiveMembers, M as MethodMember, a2 as MethodMutationOptions, a3 as MethodQueryOptions, v as MutationCallOptions, w as MutationMember, x as MutationVariables, O as OptimisticCache, y as OptimisticCacheOf, r as OptimisticUpdate, s as OverlayStore, t as OverlayView, z as QueryCallOptions, F as QueryMember, Q as QuickdrawInvalidate, k as QuickdrawSocket, R as RealtimeMembers, V as ScopedStreamMember, _ as SearchMember, $ as SearchMemberOf, G as ServiceClient, l as SocketClientOptions, S as StreamMember, o as SubscriptionEvent, p as SubscriptionLane, T as TopicWatch, W as UseChannelResult, U as UseCollectionOptions, H as UseCollectionResult, I as UseEntitiesResult, K as UseEntityOptions, N as UseEntityResult, X as UseEventOptions, a0 as UseSearchOptions, a1 as UseSearchResult, Y as UseStreamOptions, Z as UseStreamResult, i as createQuickdrawConnection, q as overlaysOf } from '../clientTypes-B62bWHua.js';
+import { k as MethodKind, O as OrderBy, C as CollectionDef, aa as ContractMap, A as AccessLevel } from '../infer-Cwq49ME5.js';
+import { ad as Version, y as CallSuccess, w as CallNotModified, n as ProtocolMismatch, a5 as Revision, F as CollectionDelta, G as CollectionFrame, a7 as RevokeReason, k as HelloFrame } from '../envelope-CoiZY9KU.js';
 import { QueryClient, QueryKey, Query } from '@tanstack/react-query';
 import { Q as QuickdrawError } from '../errors-S-bxEIBC.js';
 import * as React from 'react';

package/dist/client/index.js

@@ -32,9 +32,9 @@ import {
   useAdminServices,
   useLiveData,
   useQuickdraw
-} from "../chunk-ONVWF4IM.js";
+} from "../chunk-DXTJNJM5.js";
 import "../chunk-K35VD4CQ.js";
-import "../chunk-4QNDKNDK.js";
+import "../chunk-SSDLYYQV.js";
 import "../chunk-UJQJM7EG.js";
 import "../chunk-47AEXVDM.js";
 import "../chunk-Z2LZ7IZ7.js";

package/dist/{clientTypes-B9eYqDO1.d.ts → clientTypes-B62bWHua.d.ts}

@@ -1,5 +1,5 @@
-import { C as CLIENT_EVENTS, a9 as ServerToClientEvents, E as ClientToServerEvents, B as ChangedFrame, n as ProtocolMismatch, k as HelloFrame, A as AuthenticationRefused, a5 as Revision } from './envelope-CR2A9lrd.js';
-import { k as MethodKind, G as AnyContract, at as StreamName, ah as IsScopedStream, as as StreamItemOf, a6 as ChannelName, a5 as ChannelInputOf, ac as EventName, ad as EventPayloadOf, ak as MethodName, al as MethodOf, am as OutputOf, ag as InputOf, aa as ContractMap, aj as KindOf, ab as EntityOf, a8 as CollectionName, ai as ItemOf, aq as ScopeOf, au as ViewName, af as IndexRowOf } from './infer-CEfvP0_I.js';
+import { C as CLIENT_EVENTS, a9 as ServerToClientEvents, E as ClientToServerEvents, B as ChangedFrame, n as ProtocolMismatch, k as HelloFrame, A as AuthenticationRefused, a5 as Revision } from './envelope-CoiZY9KU.js';
+import { k as MethodKind, G as AnyContract, av as StreamName, ai as IsScopedStream, au as StreamItemOf, a6 as ChannelName, a5 as ChannelInputOf, ac as EventName, ad as EventPayloadOf, al as MethodName, am as MethodOf, an as OutputOf, ah as InputOf, aa as ContractMap, ak as KindOf, ab as EntityOf, a8 as CollectionName, aj as ItemOf, as as ScopeOf, aw as ViewName, ag as IndexRowOf } from './infer-Cwq49ME5.js';
 import { ManagerOptions, SocketOptions, Socket } from 'socket.io-client';
 import { QueryClient, UseMutationOptions, UseQueryOptions, UseQueryResult, UseMutationResult, QueryKey } from '@tanstack/react-query';
 import { Q as QuickdrawError } from './errors-S-bxEIBC.js';

package/dist/{createServer-301BCb6c.d.ts → createServer-P61KBWro.d.ts}

@@ -1,12 +1,12 @@
 import { IncomingMessage, ServerResponse, Server as Server$1 } from 'node:http';
-import { a as DispatcherOptions, H as HttpRouter, b as HttpTransportOptions, P as PrincipalOfServices, D as Dispatcher } from './http-DC1RmIgu.js';
-import { P as Principal } from './types-CIq6xwng.js';
-import { p as AppRooms, q as StreamSubscriptions, A as AnyService } from './caller-JNTbbD37.js';
+import { a as DispatcherOptions, H as HttpRouter, b as HttpTransportOptions, P as PrincipalOfServices, D as Dispatcher } from './http-89lENH2D.js';
+import { P as Principal } from './types-BDmssndG.js';
+import { p as AppRooms, q as StreamSubscriptions, A as AnyService } from './caller-Cx5wuao-.js';
 import { Server, DefaultEventsMap, Socket, ServerOptions as ServerOptions$1 } from 'socket.io';
-import { S as ServerAuth, a as ServiceGrants } from './auth-5yi_rUSM.js';
+import { S as ServerAuth, a as ServiceGrants } from './auth-DyCIKmTQ.js';
 import { L as Logger } from './logger-BY28acW-.js';
-import { g as PROTOCOL_VERSION } from './envelope-CR2A9lrd.js';
-import { A as AccessLevel } from './infer-CEfvP0_I.js';
+import { g as PROTOCOL_VERSION } from './envelope-CoiZY9KU.js';
+import { A as AccessLevel } from './infer-Cwq49ME5.js';
 
 /** One live collection subscription, as `socket.data.collections[room]` records it. */
 interface ScopeSubscription {

package/dist/{createTestApp-BPi72usy.d.ts → createTestApp-BBm3TakW.d.ts}

@@ -1,8 +1,8 @@
-import { f as ServerEventName, a9 as ServerToClientEvents, k as HelloFrame } from './envelope-CR2A9lrd.js';
-import { A as AnyService, i as Caller } from './caller-JNTbbD37.js';
-import { S as ServerOptions, Q as QuickdrawServer } from './createServer-301BCb6c.js';
-import { P as PrincipalOfServices, C as ContractOfServices } from './http-DC1RmIgu.js';
-import { C as CallRecord } from './metrics-B1dXpOQc.js';
+import { f as ServerEventName, a9 as ServerToClientEvents, k as HelloFrame } from './envelope-CoiZY9KU.js';
+import { A as AnyService, i as Caller } from './caller-Cx5wuao-.js';
+import { S as ServerOptions, Q as QuickdrawServer } from './createServer-P61KBWro.js';
+import { P as PrincipalOfServices, C as ContractOfServices } from './http-89lENH2D.js';
+import { C as CallRecord } from './metrics-Ny1dFbyY.js';
 import { Socket } from 'socket.io-client';
 
 /** The payload of a v5 server event, by its name. */

package/dist/{envelope-CR2A9lrd.d.ts → envelope-CoiZY9KU.d.ts}

@@ -1,4 +1,4 @@
-import { A as AccessLevel } from './infer-CEfvP0_I.js';
+import { A as AccessLevel } from './infer-Cwq49ME5.js';
 import { W as WireError } from './errors-S-bxEIBC.js';
 
 /**

package/dist/{http-DC1RmIgu.d.ts → http-89lENH2D.d.ts}

@@ -1,12 +1,12 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { L as Logger } from './logger-BY28acW-.js';
-import { G as AnyContract, A as AccessLevel } from './infer-CEfvP0_I.js';
-import { P as Principal, T as Transport, a as McpContext, D as DbOf, c as PrincipalOf, M as MaybePromise } from './types-CIq6xwng.js';
-import { A as AnyService, j as ServiceMethod, R as RowLevels, k as AccessFilter, i as Caller, l as RunContext, P as Presence, m as StreamHandle, n as AnyContext, S as StorageAdapter, U as UnitOfWorkFactory, d as FlushSink, o as AccessEngine } from './caller-JNTbbD37.js';
-import { ad as Version, x as CallReply } from './envelope-CR2A9lrd.js';
+import { G as AnyContract, A as AccessLevel } from './infer-Cwq49ME5.js';
+import { P as Principal, T as Transport, a as McpContext, D as DbOf, c as PrincipalOf, M as MaybePromise } from './types-BDmssndG.js';
+import { A as AnyService, j as ServiceMethod, R as RowLevels, k as AccessFilter, i as Caller, l as RunContext, P as Presence, m as StreamHandle, n as AnyContext, S as StorageAdapter, U as UnitOfWorkFactory, d as FlushSink, o as AccessEngine } from './caller-Cx5wuao-.js';
+import { ad as Version, x as CallReply } from './envelope-CoiZY9KU.js';
 import { Q as QuickdrawError } from './errors-S-bxEIBC.js';
-import { C as CallRecord } from './metrics-B1dXpOQc.js';
-import { S as ServerAuth } from './auth-5yi_rUSM.js';
+import { C as CallRecord } from './metrics-Ny1dFbyY.js';
+import { S as ServerAuth } from './auth-DyCIKmTQ.js';
 
 /** How one call ended. The dispatcher's `call` resolves with it and never rejects. */
 type DispatchResult = {

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export { a as ACE, b as ACL, A as AccessLevel, G as AnyContract, U as CHANNEL_DEFAULT_RATE, _ as ChannelDef, a5 as ChannelInputOf, a6 as ChannelName, a7 as ChannelPayloadOf, $ as ChannelRequires, C as CollectionDef, a8 as CollectionName, a9 as CollectionOf, w as CollectionWhere, H as Contract, J as ContractDefinition, aa as ContractMap, D as DEFAULT_COLLECTION_LIMIT, s as DEFAULT_COLLECTION_MAX_LIMIT, ab as EntityOf, E as EntityProjection, a0 as EventDef, ac as EventName, ad as EventPayloadOf, X as GLOBAL_STREAM, ae as IndexFieldOf, K as IndexRow, af as IndexRowOf, I as InferInput, c as InferOutput, ag as InputOf, ah as IsScopedStream, ai as ItemOf, aj as KindOf, M as MethodDef, k as MethodKind, ak as MethodName, al as MethodOf, o as MethodOutput, p as MutationDef, N as NullableProjection, O as OrderBy, am as OutputOf, an as ParsedInputOf, a1 as PayloadSelector, P as ProjectionList, ao as ProjectionName, ap as ProjectionOf, r as ProjectionRef, Q as QueryDef, R as ReservedMethodName, a2 as RoomSelector, L as RowSchema, Y as STREAM_MAX_SEED, aq as ScopeOf, ar as ServiceNameOf, x as SortDirection, S as StandardJSONSchemaV1, d as StandardSchemaV1, e as StandardSchemaWithJSON, f as StandardTypedV1, a3 as StreamAccess, a4 as StreamDef, as as StreamItemOf, at as StreamName, T as TODO_SCHEMA_VENDOR, g as TodoSchemaOptions, V as ValidationIssue, j as ValidationResult, y as ViaScope, au as ViewName, B as ViewPredicate, z as Viewer, W as Watch, F as defineContract, h as hasJsonSchema, Z as isScopedStream, i as isStandardSchema, l as listOf, m as mutation, n as nullable, q as query, t as todoSchema, v as validate, u as via } from './infer-CEfvP0_I.js';
+export { a as ACE, b as ACL, A as AccessLevel, G as AnyContract, U as CHANNEL_DEFAULT_RATE, _ as ChannelDef, a5 as ChannelInputOf, a6 as ChannelName, a7 as ChannelPayloadOf, $ as ChannelRequires, C as CollectionDef, a8 as CollectionName, a9 as CollectionOf, w as CollectionWhere, H as Contract, J as ContractDefinition, aa as ContractMap, D as DEFAULT_COLLECTION_LIMIT, s as DEFAULT_COLLECTION_MAX_LIMIT, ab as EntityOf, E as EntityProjection, a0 as EventDef, ac as EventName, ad as EventPayloadOf, ae as FullProjectionOf, X as GLOBAL_STREAM, af as IndexFieldOf, K as IndexRow, ag as IndexRowOf, I as InferInput, c as InferOutput, ah as InputOf, ai as IsScopedStream, aj as ItemOf, ak as KindOf, M as MethodDef, k as MethodKind, al as MethodName, am as MethodOf, o as MethodOutput, p as MutationDef, N as NullableProjection, O as OrderBy, an as OutputOf, ao as ParsedInputOf, a1 as PayloadSelector, P as ProjectionList, ap as ProjectionName, aq as ProjectionOf, r as ProjectionRef, Q as QueryDef, ar as ReceivedRow, R as ReservedMethodName, a2 as RoomSelector, L as RowSchema, Y as STREAM_MAX_SEED, as as ScopeOf, at as ServiceNameOf, x as SortDirection, S as StandardJSONSchemaV1, d as StandardSchemaV1, e as StandardSchemaWithJSON, f as StandardTypedV1, a3 as StreamAccess, a4 as StreamDef, au as StreamItemOf, av as StreamName, T as TODO_SCHEMA_VENDOR, g as TodoSchemaOptions, V as ValidationIssue, j as ValidationResult, y as ViaScope, aw as ViewName, B as ViewPredicate, z as Viewer, W as Watch, F as defineContract, h as hasJsonSchema, Z as isScopedStream, i as isStandardSchema, l as listOf, m as mutation, n as nullable, q as query, t as todoSchema, v as validate, u as via } from './infer-Cwq49ME5.js';
 export { L as Logger, c as consoleLogger } from './logger-BY28acW-.js';
-export { a1 as ADMIN_DEFAULT_PAGE_SIZE, Y as ADMIN_FIELD_TYPES, a2 as ADMIN_MAX_PAGE, a3 as ADMIN_MAX_PAGE_SIZE, A as ADMIN_METHODS, Z as ADMIN_NEVER_WRITABLE, E as AdminContractOptions, G as AdminCreateDef, a4 as AdminCreateInput, a5 as AdminCreateQuery, a6 as AdminData, H as AdminDeleteDef, _ as AdminFieldConfig, $ as AdminFieldType, J as AdminGetDef, K as AdminListDef, a7 as AdminListInput, a8 as AdminListQuery, M as AdminMetaDef, a9 as AdminMetaInput, O as AdminMethodName, P as AdminMethods, Q as AdminMethodsOf, aa as AdminNeverWritable, ab as AdminPage, T as AdminReemitDef, a0 as AdminServiceMeta, ac as AdminSubscribers, U as AdminSubscribersDef, V as AdminTag, X as AdminUpdateDef, ad as AdminUpdateInput, ae as AdminUpdateQuery, B as BulkPatch, t as BulkResult, s as CRUD_MAX_IDS, C as CRUD_METHODS, a as CrudBulkDelete, b as CrudBulkUpdate, d as CrudContractOptions, e as CrudCreate, f as CrudDelete, g as CrudGet, h as CrudGetMany, i as CrudInputOptions, j as CrudList, k as CrudListOptions, l as CrudMethodName, m as CrudMethods, n as CrudReorder, o as CrudReorderOptions, p as CrudTag, q as CrudToggle, r as CrudUpdate, F as FilterValue, I as IdInput, u as IdsInput, ag as KitSchema, v as LIST_DEFAULT_LIMIT, w as LIST_MAX_LIMIT, L as ListInput, x as ListPage, y as ListQuery, z as ListSort, N as NumberFieldOf, R as ReorderInput, S as ScalarFieldOf, af as SubscriberLevel, W as WithId, D as admin, c as crud } from './admin-DufEkep0.js';
-export { A as AclMethodName, I as InviteByNameInput, z as InviteByNameQuery, B as InviteInput, C as InviteQuery, L as LeaveInput, D as ListMembersInput, E as ListMembersQuery, F as Member, G as MemberInput, M as MembersMethodName, H as MembersPage, y as SHARE_LEVELS, d as SHARING_METHODS, S as SearchContractOptions, a as SearchDef, b as SearchMethods, c as SearchTag, J as SetRoleInput, K as ShareByNameInput, N as ShareByNameQuery, O as ShareInput, P as ShareLevel, f as SharingByNameMethod, g as SharingContractOptions, h as SharingDefOf, i as SharingInvite, j as SharingInviteByName, k as SharingLeave, l as SharingListMembers, m as SharingListShares, n as SharingMethodName, o as SharingMethods, p as SharingMode, q as SharingRemove, r as SharingSetLevel, t as SharingSetRole, u as SharingShare, v as SharingShareByName, w as SharingTag, x as SharingUnshare, T as TextFieldOf, U as UnshareInput, Q as UserLookupInput, s as search, e as sharing } from './sharing-B5-5Q_wT.js';
+export { a1 as ADMIN_DEFAULT_PAGE_SIZE, Y as ADMIN_FIELD_TYPES, a2 as ADMIN_MAX_PAGE, a3 as ADMIN_MAX_PAGE_SIZE, A as ADMIN_METHODS, Z as ADMIN_NEVER_WRITABLE, E as AdminContractOptions, G as AdminCreateDef, a4 as AdminCreateInput, a5 as AdminCreateQuery, a6 as AdminData, H as AdminDeleteDef, _ as AdminFieldConfig, $ as AdminFieldType, J as AdminGetDef, K as AdminListDef, a7 as AdminListInput, a8 as AdminListQuery, M as AdminMetaDef, a9 as AdminMetaInput, O as AdminMethodName, P as AdminMethods, Q as AdminMethodsOf, aa as AdminNeverWritable, ab as AdminPage, T as AdminReemitDef, a0 as AdminServiceMeta, ac as AdminSubscribers, U as AdminSubscribersDef, V as AdminTag, X as AdminUpdateDef, ad as AdminUpdateInput, ae as AdminUpdateQuery, B as BulkPatch, t as BulkResult, s as CRUD_MAX_IDS, C as CRUD_METHODS, a as CrudBulkDelete, b as CrudBulkUpdate, d as CrudContractOptions, e as CrudCreate, f as CrudDelete, g as CrudGet, h as CrudGetMany, i as CrudInputOptions, j as CrudList, k as CrudListOptions, l as CrudMethodName, m as CrudMethods, n as CrudReorder, o as CrudReorderOptions, p as CrudTag, q as CrudToggle, r as CrudUpdate, F as FilterValue, I as IdInput, u as IdsInput, ag as KitSchema, v as LIST_DEFAULT_LIMIT, w as LIST_MAX_LIMIT, L as ListInput, x as ListPage, y as ListQuery, z as ListSort, N as NumberFieldOf, R as ReorderInput, S as ScalarFieldOf, af as SubscriberLevel, W as WithId, D as admin, c as crud } from './admin-Bl71J4IG.js';
+export { A as AclMethodName, I as InviteByNameInput, z as InviteByNameQuery, B as InviteInput, C as InviteQuery, L as LeaveInput, D as ListMembersInput, E as ListMembersQuery, F as Member, G as MemberInput, M as MembersMethodName, H as MembersPage, y as SHARE_LEVELS, d as SHARING_METHODS, S as SearchContractOptions, a as SearchDef, b as SearchMethods, c as SearchTag, J as SetRoleInput, K as ShareByNameInput, N as ShareByNameQuery, O as ShareInput, P as ShareLevel, f as SharingByNameMethod, g as SharingContractOptions, h as SharingDefOf, i as SharingInvite, j as SharingInviteByName, k as SharingLeave, l as SharingListMembers, m as SharingListShares, n as SharingMethodName, o as SharingMethods, p as SharingMode, q as SharingRemove, r as SharingSetLevel, t as SharingSetRole, u as SharingShare, v as SharingShareByName, w as SharingTag, x as SharingUnshare, T as TextFieldOf, U as UnshareInput, Q as UserLookupInput, s as search, e as sharing } from './sharing-BHyufgVl.js';
 export { S as SEARCH_DEFAULT_LIMIT, a as SEARCH_DEFAULT_MIN_LENGTH, b as SEARCH_MAX_LIMIT, c as SEARCH_MAX_QUERY_LENGTH, d as SearchInput, e as SearchPage, f as SearchQuery } from './searchSchemas-CBgKRa1b.js';
-export { q as AccessFrame, A as AuthenticationRefused, C as CLIENT_EVENTS, r as CallEnvelope, v as CallId, w as CallNotModified, x as CallReply, y as CallSuccess, z as CancelFrame, B as ChangedFrame, D as ChannelFrame, d as ClientEventName, E as ClientToServerEvents, F as CollectionDelta, G as CollectionFrame, I as CollectionItemsReply, J as CollectionItemsRequest, K as CollectionResumed, L as CollectionScopeRef, M as CollectionSnapshot, N as CollectionSubscribe, O as CollectionSubscribeReply, T as EntityFrame, U as EntityNotModified, V as EntityPatch, W as EntityRemove, X as EntityResult, Y as EntityRow, Z as EntitySubscribe, _ as EntitySubscribeReply, $ as EntityUnsubscribe, a0 as EntityUpdate, a1 as EventFrame, a2 as Failure, H as HandshakeAuth, k as HelloFrame, l as HelloLimits, m as HelloSubscriptionLimits, a3 as Ok, P as PROTOCOL_MISMATCH, g as PROTOCOL_VERSION, a4 as PresenceFrame, n as ProtocolMismatch, Q as QdHandshake, R as RESERVED_ROOM_PREFIXES, a5 as Revision, a7 as RevokeReason, a6 as RevokedFrame, a8 as RotateFrame, S as SERVER_EVENTS, a as SERVICE_TOPIC, f as ServerEventName, a9 as ServerToClientEvents, aa as StreamFrame, ab as StreamSubscribe, ac as StreamSubscribeReply, ad as Version, ae as WatchFrame, af as WireIndexRow, c as collectionRoom, b as collectionTopic, e as entityRoom, i as isAuthenticationRefused, o as isCallEnvelope, p as isCancel, h as isProtocolMismatch, j as isQdHandshake, s as streamRoom, t as topicRoom, u as userRoom } from './envelope-CR2A9lrd.js';
+export { q as AccessFrame, A as AuthenticationRefused, C as CLIENT_EVENTS, r as CallEnvelope, v as CallId, w as CallNotModified, x as CallReply, y as CallSuccess, z as CancelFrame, B as ChangedFrame, D as ChannelFrame, d as ClientEventName, E as ClientToServerEvents, F as CollectionDelta, G as CollectionFrame, I as CollectionItemsReply, J as CollectionItemsRequest, K as CollectionResumed, L as CollectionScopeRef, M as CollectionSnapshot, N as CollectionSubscribe, O as CollectionSubscribeReply, T as EntityFrame, U as EntityNotModified, V as EntityPatch, W as EntityRemove, X as EntityResult, Y as EntityRow, Z as EntitySubscribe, _ as EntitySubscribeReply, $ as EntityUnsubscribe, a0 as EntityUpdate, a1 as EventFrame, a2 as Failure, H as HandshakeAuth, k as HelloFrame, l as HelloLimits, m as HelloSubscriptionLimits, a3 as Ok, P as PROTOCOL_MISMATCH, g as PROTOCOL_VERSION, a4 as PresenceFrame, n as ProtocolMismatch, Q as QdHandshake, R as RESERVED_ROOM_PREFIXES, a5 as Revision, a7 as RevokeReason, a6 as RevokedFrame, a8 as RotateFrame, S as SERVER_EVENTS, a as SERVICE_TOPIC, f as ServerEventName, a9 as ServerToClientEvents, aa as StreamFrame, ab as StreamSubscribe, ac as StreamSubscribeReply, ad as Version, ae as WatchFrame, af as WireIndexRow, c as collectionRoom, b as collectionTopic, e as entityRoom, i as isAuthenticationRefused, o as isCallEnvelope, p as isCancel, h as isProtocolMismatch, j as isQdHandshake, s as streamRoom, t as topicRoom, u as userRoom } from './envelope-CoiZY9KU.js';
 export { E as ERROR_CODES, a as ErrorCode, Q as QuickdrawError, R as RateLimitedErrorData, V as ValidationErrorData, W as WireError, b as WireIssue, f as fromWire, h as httpStatus, i as isErrorCode, t as toWire } from './errors-S-bxEIBC.js';
 
 /** The published version of `@fitzzero/quickdraw-core`. Kept in step with package.json. */
-declare const QUICKDRAW_VERSION = "5.0.0-rc.1";
+declare const QUICKDRAW_VERSION = "5.0.0-rc.2";
 
 export { QUICKDRAW_VERSION };

package/dist/index.js

@@ -50,7 +50,7 @@ import {
   streamRoom,
   topicRoom,
   userRoom
-} from "./chunk-4QNDKNDK.js";
+} from "./chunk-SSDLYYQV.js";
 import {
   CHANNEL_DEFAULT_RATE,
   DEFAULT_COLLECTION_LIMIT,

package/dist/{infer-CEfvP0_I.d.ts → infer-Cwq49ME5.d.ts}

@@ -742,12 +742,42 @@ type ContractMap = {
 };
 /** The service name of a contract. */
 type ServiceNameOf<C extends AnyContract> = C["name"];
-/** The full entity row of a contract, or `never` for a contract without an entity. */
-type EntityOf<C extends AnyContract> = C["entity"] extends StandardSchemaV1 ? InferOutput<C["entity"]> : never;
 /** `"entity"` (when the contract has one) plus the names of its projections. */
 type ProjectionName<C extends AnyContract> = (C["entity"] extends StandardSchemaV1 ? "entity" : never) | (keyof C["projections"] & string);
-/** The row type of a projection; `"entity"` is the full entity. */
-type ProjectionOf<C extends AnyContract, P extends ProjectionName<C>> = P extends "entity" ? EntityOf<C> : P extends keyof C["projections"] ? InferOutput<C["projections"][P]> : never;
+/**
+ * The full row of a projection, every key present: its schema's output
+ * (`"entity"` is the entity's). The server builds this row and strips each
+ * reader's tiers from it; a handler returns it (`HandlerOutputOf`).
+ */
+type FullProjectionOf<C extends AnyContract, P extends ProjectionName<C>> = P extends "entity" ? C["entity"] extends StandardSchemaV1 ? InferOutput<C["entity"]> : never : P extends keyof C["projections"] ? InferOutput<C["projections"][P]> : never;
+/** `T` with its properties listed in one object type, for readable hovers and errors. */
+type Flatten<T> = {
+    [K in keyof T]: T[K];
+};
+/** `Row` with the keys in `Tiered` optional; any other key, and a row with none of them, unchanged. */
+type OptionalKeys<Row, Tiered extends PropertyKey> = Row extends object ? [Extract<keyof Row, Tiered>] extends [never] ? Row : Flatten<{
+    [K in keyof Row as K extends Tiered ? never : K]: Row[K];
+} & {
+    [K in keyof Row as K extends Tiered ? K : never]?: Row[K];
+}> : Row;
+/**
+ * `Row`, a row of contract `C`, as a reader receives it: each key the
+ * contract's `fields` map tiers is optional, since a reader below its level
+ * receives the row without it.
+ */
+type ReceivedRow<C extends AnyContract, Row> = OptionalKeys<Row, keyof C["fields"]>;
+/**
+ * The entity row of a contract as a reader receives it (`useEntity`,
+ * `"entity"` outputs): a field the contract's `fields` map tiers is
+ * optional. `never` for a contract without an entity.
+ */
+type EntityOf<C extends AnyContract> = C["entity"] extends StandardSchemaV1 ? ReceivedRow<C, InferOutput<C["entity"]>> : never;
+/**
+ * The row type of a projection as a reader receives it; `"entity"` is the
+ * entity. A field the contract's `fields` map tiers is optional
+ * (`FullProjectionOf` has it).
+ */
+type ProjectionOf<C extends AnyContract, P extends ProjectionName<C>> = ReceivedRow<C, FullProjectionOf<C, P>>;
 /** The names of a contract's methods. */
 type MethodName<C extends AnyContract> = keyof C["methods"] & string;
 /** One method's declaration: `kind`, `input`, `output` and `watch`. */
@@ -765,7 +795,10 @@ type OutputOf<C extends AnyContract, M extends MethodName<C>> = ResolveOutput<C,
 type CollectionName<C extends AnyContract> = keyof C["collections"] & string;
 /** One collection's declaration. */
 type CollectionOf<C extends AnyContract, K extends CollectionName<C>> = C["collections"][K];
-/** The item type of a collection: the row of the projection it declares as `item`. */
+/**
+ * The item type of a collection: the row of the projection it declares as
+ * `item`, as a reader receives it (a tiered field is optional).
+ */
 type ItemOf<C extends AnyContract, K extends CollectionName<C>> = CollectionOf<C, K>["item"] extends ProjectionName<C> ? ProjectionOf<C, CollectionOf<C, K>["item"]> : never;
 /**
  * The value that identifies one scope of a collection: the type of its scope
@@ -774,8 +807,13 @@ type ItemOf<C extends AnyContract, K extends CollectionName<C>> = CollectionOf<C
 type ScopeOf<C extends AnyContract, K extends CollectionName<C>> = CollectionOf<C, K>["scope"] extends keyof EntityOf<C> ? NonNullable<EntityOf<C>[CollectionOf<C, K>["scope"]]> : string;
 /** The index fields of a collection, or `never` when it declares no index. */
 type IndexFieldOf<C extends AnyContract, K extends CollectionName<C>> = CollectionOf<C, K>["index"] extends readonly (infer Field extends string)[] ? Field : never;
-/** One index row of a collection: `id` plus its index fields. What a view predicate reads. */
-type IndexRowOf<C extends AnyContract, K extends CollectionName<C>> = IndexRow<ItemOf<C, K>, IndexFieldOf<C, K>>;
+/**
+ * One index row of a collection: `id` plus its index fields. What a view
+ * predicate reads. Every subscriber receives every index field (a collection
+ * refuses one its `fields` tier hides at the collection's access), so a
+ * tiered index field is not optional here.
+ */
+type IndexRowOf<C extends AnyContract, K extends CollectionName<C>> = IndexRow<CollectionOf<C, K>["item"] extends ProjectionName<C> ? FullProjectionOf<C, CollectionOf<C, K>["item"]> : never, IndexFieldOf<C, K>>;
 /** The names of a collection's views. */
 type ViewName<C extends AnyContract, K extends CollectionName<C>> = keyof NonNullable<CollectionOf<C, K>["views"]> & string;
 /** The names of a contract's streams. */
@@ -800,4 +838,4 @@ type ChannelInputOf<C extends AnyContract, K extends ChannelName<C>> = InferInpu
 /** The payload type of a custom event: what `ctx.rooms.emit` takes and `useEvent` receives. */
 type EventPayloadOf<C extends AnyContract, K extends EventName<C>> = InferOutput<C["events"][K]["payload"]>;
 
-export { type ChannelRequires as $, type AccessLevel as A, type ViewPredicate as B, type CollectionDef as C, DEFAULT_COLLECTION_LIMIT as D, type EntityProjection as E, defineContract as F, type AnyContract as G, type Contract as H, type InferInput as I, type ContractDefinition as J, type IndexRow as K, type RowSchema as L, type MethodDef as M, type NullableProjection as N, type OrderBy as O, type ProjectionList as P, type QueryDef as Q, type ReservedMethodName as R, StandardJSONSchemaV1 as S, TODO_SCHEMA_VENDOR as T, CHANNEL_DEFAULT_RATE as U, type ValidationIssue as V, type Watch as W, GLOBAL_STREAM as X, STREAM_MAX_SEED as Y, isScopedStream as Z, type ChannelDef as _, type ACE as a, type EventDef as a0, type PayloadSelector as a1, type RoomSelector as a2, type StreamAccess as a3, type StreamDef as a4, type ChannelInputOf as a5, type ChannelName as a6, type ChannelPayloadOf as a7, type CollectionName as a8, type CollectionOf as a9, type ContractMap as aa, type EntityOf as ab, type EventName as ac, type EventPayloadOf as ad, type IndexFieldOf as ae, type IndexRowOf as af, type InputOf as ag, type IsScopedStream as ah, type ItemOf as ai, type KindOf as aj, type MethodName as ak, type MethodOf as al, type OutputOf as am, type ParsedInputOf as an, type ProjectionName as ao, type ProjectionOf as ap, type ScopeOf as aq, type ServiceNameOf as ar, type StreamItemOf as as, type StreamName as at, type ViewName as au, type ACL as b, type InferOutput as c, StandardSchemaV1 as d, type StandardSchemaWithJSON as e, StandardTypedV1 as f, type TodoSchemaOptions as g, hasJsonSchema as h, isStandardSchema as i, type ValidationResult as j, type MethodKind as k, listOf as l, mutation as m, nullable as n, type MethodOutput as o, type MutationDef as p, query as q, type ProjectionRef as r, DEFAULT_COLLECTION_MAX_LIMIT as s, todoSchema as t, via as u, validate as v, type CollectionWhere as w, type SortDirection as x, type ViaScope as y, type Viewer as z };
+export { type ChannelRequires as $, type AccessLevel as A, type ViewPredicate as B, type CollectionDef as C, DEFAULT_COLLECTION_LIMIT as D, type EntityProjection as E, defineContract as F, type AnyContract as G, type Contract as H, type InferInput as I, type ContractDefinition as J, type IndexRow as K, type RowSchema as L, type MethodDef as M, type NullableProjection as N, type OrderBy as O, type ProjectionList as P, type QueryDef as Q, type ReservedMethodName as R, StandardJSONSchemaV1 as S, TODO_SCHEMA_VENDOR as T, CHANNEL_DEFAULT_RATE as U, type ValidationIssue as V, type Watch as W, GLOBAL_STREAM as X, STREAM_MAX_SEED as Y, isScopedStream as Z, type ChannelDef as _, type ACE as a, type EventDef as a0, type PayloadSelector as a1, type RoomSelector as a2, type StreamAccess as a3, type StreamDef as a4, type ChannelInputOf as a5, type ChannelName as a6, type ChannelPayloadOf as a7, type CollectionName as a8, type CollectionOf as a9, type ContractMap as aa, type EntityOf as ab, type EventName as ac, type EventPayloadOf as ad, type FullProjectionOf as ae, type IndexFieldOf as af, type IndexRowOf as ag, type InputOf as ah, type IsScopedStream as ai, type ItemOf as aj, type KindOf as ak, type MethodName as al, type MethodOf as am, type OutputOf as an, type ParsedInputOf as ao, type ProjectionName as ap, type ProjectionOf as aq, type ReceivedRow as ar, type ScopeOf as as, type ServiceNameOf as at, type StreamItemOf as au, type StreamName as av, type ViewName as aw, type ACL as b, type InferOutput as c, StandardSchemaV1 as d, type StandardSchemaWithJSON as e, StandardTypedV1 as f, type TodoSchemaOptions as g, hasJsonSchema as h, isStandardSchema as i, type ValidationResult as j, type MethodKind as k, listOf as l, mutation as m, nullable as n, type MethodOutput as o, type MutationDef as p, query as q, type ProjectionRef as r, DEFAULT_COLLECTION_MAX_LIMIT as s, todoSchema as t, via as u, validate as v, type CollectionWhere as w, type SortDirection as x, type ViaScope as y, type Viewer as z };

package/dist/{metrics-B1dXpOQc.d.ts → metrics-Ny1dFbyY.d.ts}

@@ -1,6 +1,6 @@
-import { k as MethodKind } from './infer-CEfvP0_I.js';
+import { k as MethodKind } from './infer-Cwq49ME5.js';
 import { a as ErrorCode } from './errors-S-bxEIBC.js';
-import { T as Transport } from './types-CIq6xwng.js';
+import { T as Transport } from './types-BDmssndG.js';
 
 /** How a call ended: `"ok"`, `"not-modified"`, or the error code it failed with. */
 type CallOutcome = "ok" | "not-modified" | ErrorCode;

package/dist/prisma/index.d.ts

@@ -1,9 +1,9 @@
 import { L as Logger } from '../logger-BY28acW-.js';
-export { C as CountArgs, F as FindManyArgs, c as StatementCount, S as StorageAdapter, a as StorageRow, b as StorageWhere, s as storageOf } from '../caller-JNTbbD37.js';
-import '../envelope-CR2A9lrd.js';
-import '../infer-CEfvP0_I.js';
+export { C as CountArgs, F as FindManyArgs, c as StatementCount, S as StorageAdapter, a as StorageRow, b as StorageWhere, s as storageOf } from '../caller-Cx5wuao-.js';
+import '../envelope-CoiZY9KU.js';
+import '../infer-Cwq49ME5.js';
 import '../errors-S-bxEIBC.js';
-import '../types-CIq6xwng.js';
+import '../types-BDmssndG.js';
 
 /** Options of {@link trackPrisma}. */
 interface TrackPrismaOptions {

package/dist/server/auth/index.d.ts

@@ -1,8 +1,8 @@
 import { L as Logger } from '../../logger-BY28acW-.js';
 import { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';
-import { M as MaybePromise, P as Principal } from '../../types-CIq6xwng.js';
-import { b as AuthenticateRequest } from '../../auth-5yi_rUSM.js';
-import '../../infer-CEfvP0_I.js';
+import { M as MaybePromise, P as Principal } from '../../types-BDmssndG.js';
+import { b as AuthenticateRequest } from '../../auth-DyCIKmTQ.js';
+import '../../infer-Cwq49ME5.js';
 import 'socket.io';
 
 /**

package/dist/server/index.d.ts

@@ -1,17 +1,17 @@
-import { G as AnyContract, ao as ProjectionName, ap as ProjectionOf, a8 as CollectionName, ak as MethodName, d as StandardSchemaV1, c as InferOutput, N as NullableProjection, P as ProjectionList, al as MethodOf, an as ParsedInputOf, aj as KindOf, A as AccessLevel, ab as EntityOf } from '../infer-CEfvP0_I.js';
-import { M as ModelName, r as PolicyFor, t as RowForms, u as AccessFor, H as HandlerContext, v as ModelColumn, w as WatchAccess, x as PublicAccess, y as HandlerArgs, z as CustomAccess, B as ShareMode, E as ChannelOptions, G as ChannelsRequired, f as Service, I as BaseContext, J as CallerFor, l as RunContext, m as StreamHandle, P as Presence, K as AccessPolicy, L as AnyAccessPolicy, N as PolicyColumns, O as PolicyForeign, Q as PolicyTools, k as AccessFilter, T as RowAccess, o as AccessEngine, b as StorageWhere } from '../caller-JNTbbD37.js';
-export { av as ANY_FIELD, an as AccessForm, ao as AccessRequest, V as AffectsLink, n as AnyContext, A as AnyService, p as AppRooms, ap as AuthenticatedAccess, ad as CallOptions, i as Caller, a5 as ChannelAccess, a6 as ChannelContext, a7 as ChannelHandler, a8 as ChannelImplementation, a0 as CollectionScope, a2 as ContextRooms, a3 as ContextServices, C as CountArgs, $ as DEFAULT_BULK_THRESHOLD, g as DevWarning, D as DevWarningError, h as DevWarningKind, aq as EntryAccess, F as FindManyArgs, e as FlushInfo, d as FlushSink, ag as ForeignColumns, ah as ForeignColumnsOf, ar as IdKeyOf, as as IdSelector, ai as MembershipRead, ae as MethodCaller, az as N_PLUS_ONE_STATEMENTS, aj as ParentLink, ak as PolicyKind, al as PolicyReads, X as ProjectedOutput, Y as Projection, am as RowLevel, R as RowLevels, at as ScopeAccess, au as ServiceAccess, af as ServiceCaller, a9 as ServiceChannel, a1 as ServiceCollection, j as ServiceMethod, aa as ServiceStream, c as StatementCount, S as StorageAdapter, a as StorageRow, ab as StreamPushArgs, ac as StreamPushManyArgs, q as StreamSubscriptions, Z as TierGroup, _ as Tiers, a4 as TouchOptions, aw as UnitOfWork, U as UnitOfWorkFactory, ax as UnitOfWorkScope, W as WriteRecord, ay as formatDevWarning, s as storageOf } from '../caller-JNTbbD37.js';
-import { S as ServerOptions, Q as QuickdrawServer } from '../createServer-301BCb6c.js';
-export { C as ClusterClient, t as ClusterOptions, D as DEFAULT_STALL_INTERVAL_MS, e as DEFAULT_STALL_MAX_MS, f as DEFAULT_STALL_THRESHOLD_MS, p as DisconnectUserOptions, E as EntitySubscription, a as EntitySubscriptions, H as HttpApp, I as IoRedisLike, M as MIN_STALL_INTERVAL_MS, m as QuickdrawIo, n as QuickdrawServerSocket, o as QuickdrawSocketData, x as RateLimitOptions, y as RateLimiter, R as RotateOptions, g as STALL_RESOLUTION_MS, b as ScopeSubscription, c as ScopeSubscriptions, l as ServerOnlyOptions, h as SlowMethod, q as SocketCors, r as SocketOptions, s as SocketRateLimitOptions, i as StallReport, j as StallWatchdogOptions, T as TopicWatch, d as TopicWatches, v as applyRateLimitMiddleware, u as createRateLimiter, k as createServer, w as createTieredRateLimiter } from '../createServer-301BCb6c.js';
-import { ad as Version } from '../envelope-CR2A9lrd.js';
-import { Q as QuickdrawTypes, D as DbOf, c as PrincipalOf, M as MaybePromise, b as McpContextOf, C as ContextExtensionOf, P as Principal } from '../types-CIq6xwng.js';
-export { a as McpContext, T as Transport } from '../types-CIq6xwng.js';
-import { a as DispatcherOptions, D as Dispatcher, c as DispatcherCollections } from '../http-DC1RmIgu.js';
-export { o as AccessChange, p as AccessChangeListener, A as AccessOptions, d as ChangeLogOptions, C as ContractOfServices, j as DEFAULT_LIMITS, f as DbOfServices, h as DispatchRequest, i as DispatchResult, n as DispatcherAccess, k as DispatcherLimits, s as HttpMiddleware, H as HttpRouter, u as HttpRouterOptions, b as HttpTransportOptions, L as LimitsOptions, l as PipelineOptions, P as PrincipalOfServices, R as RegisteredMethod, g as Registry, S as SharedData, m as SubscriptionLimits, T as TrackingOptions, V as VersionRequest, q as VersionSource, e as createDispatcher, r as createHttpRouter, t as toCallReply } from '../http-DC1RmIgu.js';
-import { l as CrudMethodName, d as CrudContractOptions, S as ScalarFieldOf, N as NumberFieldOf, m as CrudMethods, Q as AdminMethodsOf, _ as AdminFieldConfig, E as AdminContractOptions, P as AdminMethods } from '../admin-DufEkep0.js';
-import { S as SearchContractOptions, T as TextFieldOf, b as SearchMethods, n as SharingMethodName, f as SharingByNameMethod, g as SharingContractOptions, o as SharingMethods } from '../sharing-B5-5Q_wT.js';
-export { a as CallOutcome, C as CallRecord } from '../metrics-B1dXpOQc.js';
-export { b as AuthenticateRequest, A as AuthenticateResult, H as HttpAuthenticateRequest, S as ServerAuth, c as ServiceAccessSource, a as ServiceGrants, d as SocketAuthenticateRequest, r as recordSocketSession } from '../auth-5yi_rUSM.js';
+import { G as AnyContract, ap as ProjectionName, ae as FullProjectionOf, a8 as CollectionName, al as MethodName, d as StandardSchemaV1, c as InferOutput, N as NullableProjection, P as ProjectionList, am as MethodOf, ao as ParsedInputOf, ak as KindOf, A as AccessLevel, ab as EntityOf } from '../infer-Cwq49ME5.js';
+import { M as ModelName, r as PolicyFor, t as RowForms, u as AccessFor, H as HandlerContext, v as ModelColumn, w as WatchAccess, x as PublicAccess, y as HandlerArgs, z as CustomAccess, B as ShareMode, E as ChannelOptions, G as ChannelsRequired, f as Service, I as BaseContext, J as CallerFor, l as RunContext, m as StreamHandle, P as Presence, K as AccessPolicy, L as AnyAccessPolicy, N as PolicyColumns, O as PolicyForeign, Q as PolicyTools, k as AccessFilter, T as RowAccess, o as AccessEngine, b as StorageWhere } from '../caller-Cx5wuao-.js';
+export { av as ANY_FIELD, an as AccessForm, ao as AccessRequest, V as AffectsLink, n as AnyContext, A as AnyService, p as AppRooms, ap as AuthenticatedAccess, ad as CallOptions, i as Caller, a5 as ChannelAccess, a6 as ChannelContext, a7 as ChannelHandler, a8 as ChannelImplementation, a0 as CollectionScope, a2 as ContextRooms, a3 as ContextServices, C as CountArgs, $ as DEFAULT_BULK_THRESHOLD, g as DevWarning, D as DevWarningError, h as DevWarningKind, aq as EntryAccess, F as FindManyArgs, e as FlushInfo, d as FlushSink, ag as ForeignColumns, ah as ForeignColumnsOf, ar as IdKeyOf, as as IdSelector, ai as MembershipRead, ae as MethodCaller, az as N_PLUS_ONE_STATEMENTS, aj as ParentLink, ak as PolicyKind, al as PolicyReads, X as ProjectedOutput, Y as Projection, am as RowLevel, R as RowLevels, at as ScopeAccess, au as ServiceAccess, af as ServiceCaller, a9 as ServiceChannel, a1 as ServiceCollection, j as ServiceMethod, aa as ServiceStream, c as StatementCount, S as StorageAdapter, a as StorageRow, ab as StreamPushArgs, ac as StreamPushManyArgs, q as StreamSubscriptions, Z as TierGroup, _ as Tiers, a4 as TouchOptions, aw as UnitOfWork, U as UnitOfWorkFactory, ax as UnitOfWorkScope, W as WriteRecord, ay as formatDevWarning, s as storageOf } from '../caller-Cx5wuao-.js';
+import { S as ServerOptions, Q as QuickdrawServer } from '../createServer-P61KBWro.js';
+export { C as ClusterClient, t as ClusterOptions, D as DEFAULT_STALL_INTERVAL_MS, e as DEFAULT_STALL_MAX_MS, f as DEFAULT_STALL_THRESHOLD_MS, p as DisconnectUserOptions, E as EntitySubscription, a as EntitySubscriptions, H as HttpApp, I as IoRedisLike, M as MIN_STALL_INTERVAL_MS, m as QuickdrawIo, n as QuickdrawServerSocket, o as QuickdrawSocketData, x as RateLimitOptions, y as RateLimiter, R as RotateOptions, g as STALL_RESOLUTION_MS, b as ScopeSubscription, c as ScopeSubscriptions, l as ServerOnlyOptions, h as SlowMethod, q as SocketCors, r as SocketOptions, s as SocketRateLimitOptions, i as StallReport, j as StallWatchdogOptions, T as TopicWatch, d as TopicWatches, v as applyRateLimitMiddleware, u as createRateLimiter, k as createServer, w as createTieredRateLimiter } from '../createServer-P61KBWro.js';
+import { ad as Version } from '../envelope-CoiZY9KU.js';
+import { Q as QuickdrawTypes, D as DbOf, c as PrincipalOf, M as MaybePromise, b as McpContextOf, C as ContextExtensionOf, P as Principal } from '../types-BDmssndG.js';
+export { a as McpContext, T as Transport } from '../types-BDmssndG.js';
+import { a as DispatcherOptions, D as Dispatcher, c as DispatcherCollections } from '../http-89lENH2D.js';
+export { o as AccessChange, p as AccessChangeListener, A as AccessOptions, d as ChangeLogOptions, C as ContractOfServices, j as DEFAULT_LIMITS, f as DbOfServices, h as DispatchRequest, i as DispatchResult, n as DispatcherAccess, k as DispatcherLimits, s as HttpMiddleware, H as HttpRouter, u as HttpRouterOptions, b as HttpTransportOptions, L as LimitsOptions, l as PipelineOptions, P as PrincipalOfServices, R as RegisteredMethod, g as Registry, S as SharedData, m as SubscriptionLimits, T as TrackingOptions, V as VersionRequest, q as VersionSource, e as createDispatcher, r as createHttpRouter, t as toCallReply } from '../http-89lENH2D.js';
+import { l as CrudMethodName, d as CrudContractOptions, S as ScalarFieldOf, N as NumberFieldOf, m as CrudMethods, Q as AdminMethodsOf, _ as AdminFieldConfig, E as AdminContractOptions, P as AdminMethods } from '../admin-Bl71J4IG.js';
+import { S as SearchContractOptions, T as TextFieldOf, b as SearchMethods, n as SharingMethodName, f as SharingByNameMethod, g as SharingContractOptions, o as SharingMethods } from '../sharing-BHyufgVl.js';
+export { a as CallOutcome, C as CallRecord } from '../metrics-Ny1dFbyY.js';
+export { b as AuthenticateRequest, A as AuthenticateResult, H as HttpAuthenticateRequest, S as ServerAuth, c as ServiceAccessSource, a as ServiceGrants, d as SocketAuthenticateRequest, r as recordSocketSession } from '../auth-DyCIKmTQ.js';
 import { Server } from 'socket.io';
 import { L as Logger } from '../logger-BY28acW-.js';
 import 'node:http';
@@ -39,15 +39,29 @@ type LegacyReply = {
     readonly code: number;
 };
 
+/**
+ * A JSON column's value as a database client types it: structurally
+ * Prisma's `JsonValue` (and its `InputJsonValue` objects and arrays). A row
+ * may hold one wherever the wire has an object or an array (`RowFor`); the
+ * method's output schema checks its shape outside production.
+ */
+type JsonColumnValue = string | number | boolean | null | {
+    readonly [key: string]: JsonColumnValue | undefined;
+} | readonly JsonColumnValue[];
 /**
  * A row of a projection as a handler may return it: the database row. Where
  * the projection has a string, a `Date` is accepted too, at any depth (the
- * framework sends its ISO string); and the row may carry more columns than
- * the projection names (the framework sends only the projection's keys).
+ * framework sends its ISO string); where it has an object or an array, a
+ * JSON column's value (`JsonColumnValue`: a Prisma `Json` column is typed
+ * `JsonValue` whatever it holds); and the row may carry more columns than the
+ * projection names (the framework sends only the projection's keys). A
+ * string, number or boolean column is checked as the wire types it.
  */
 type RowFor<Wire> = Wire extends string ? Wire | Date : Wire extends readonly (infer Item)[] ? readonly RowFor<Item>[] : Wire extends object ? {
-    readonly [Key in keyof Wire]: RowFor<Wire[Key]>;
+    readonly [Key in keyof Wire]: ColumnFor<Wire[Key]>;
 } : Wire;
+/** One column of a row (`RowFor`): an object or an array may also be a JSON column's value. */
+type ColumnFor<Wire> = Wire extends string ? Wire | Date : Wire extends object ? RowFor<Wire> | JsonColumnValue : Wire;
 /**
  * One projection's entry in `defineService`'s `project` option (RFC 0003
  * section 6).
@@ -75,14 +89,18 @@ interface ProjectionOption<Wire = unknown> {
 }
 /** The `project` option checked against the contract: a name that is not a projection becomes an error message. */
 type ProjectCheck<C extends AnyContract, Proj> = {
-    readonly [Name in keyof Proj]: Name extends ProjectionName<C> ? ProjectionOption<ProjectionOf<C, Name>> : `defineService: "${Name & string}" is not a projection of ${C["name"]}`;
+    readonly [Name in keyof Proj]: Name extends ProjectionName<C> ? ProjectionOption<FullProjectionOf<C, Name>> : `defineService: "${Name & string}" is not a projection of ${C["name"]}`;
 };
 /** `[row]` when projection `Name` has a `map` taking `row`, otherwise `[]`. */
 type MappedRow<Proj, Name> = Name extends keyof Proj ? Proj[Name] extends {
     readonly map: (row: infer Row) => unknown;
 } ? [[Row] extends [never] ? unknown : Row] : [] : [];
-/** What a handler returns for one row of projection `Name`: what its `map` takes, or the database row. */
-type HandlerRow<C extends AnyContract, Name extends ProjectionName<C>, Proj> = MappedRow<Proj, Name> extends [infer Row] ? Row : RowFor<ProjectionOf<C, Name>>;
+/**
+ * What a handler returns for one row of projection `Name`: what its `map`
+ * takes, or the database row of the full projection (tiered fields too: the
+ * framework strips them per reader).
+ */
+type HandlerRow<C extends AnyContract, Name extends ProjectionName<C>, Proj> = MappedRow<Proj, Name> extends [infer Row] ? Row : RowFor<FullProjectionOf<C, Name>>;
 type HandlerResult<C extends AnyContract, Output, Proj> = Output extends StandardSchemaV1 ? InferOutput<Output> : Output extends NullableProjection<infer Name extends ProjectionName<C>> ? HandlerRow<C, Name, Proj> | null : Output extends ProjectionList<infer Name extends ProjectionName<C>> ? readonly HandlerRow<C, Name, Proj>[] : Output extends ProjectionName<C> ? HandlerRow<C, Output, Proj> : never;
 /**
  * What method `M`'s handler returns: its output schema's type, or, for a
@@ -1308,4 +1326,4 @@ declare function decryptIfEncrypted(value: string): string;
 /** Safe wrapper that returns `null` instead of throwing on invalid/stale ciphertext. */
 declare function tryDecrypt(ciphertext: string, logger?: Logger): string | null;
 
-export { ADMIN_HIDDEN_FIELDS, AccessEngine, AccessFilter, AccessFor, type AccessMap, AccessPolicy, type AdminAccess, type AdminContract, type AdminDefaultAccess, type AdminFieldOf, type AdminFieldOverride, type AdminHandlersOptions, type AdminImplementations, type AffectsOption, AnyAccessPolicy, BaseContext, type BasicAccessEngineOptions, CHANNEL_ABUSE_MULTIPLIER, CHANNEL_ABUSE_WINDOW_MS, CallerFor, ChannelOptions, ChannelsRequired, type CollectionOption, type CollectionOptions, type CollectionsRequired, ContextExtensionOf, type ContextFactory, type CrudAccess, type CrudCreateOf, type CrudHandlersOptions, type CrudImplementations, type CrudKindOf, type CrudMethodsOf, type CrudPrepare, CustomAccess, DbOf, type DefineService, Dispatcher, DispatcherCollections, DispatcherOptions, type EnvValidationResult, HandlerArgs, HandlerContext, type HandlerOutputOf, type HandlerRow, INDEX_MAX_ROWS, type InheritOptions, type InitArgs, type InitOptions, type JsonAclOptions, type KitContext, type KitHandler, type KitHandlerArgs, type LegacyReply, MAX_APP_ROOMS, MAX_ITEM_IDS, MAX_STREAMS_PER_SOCKET, MaybePromise, McpContextOf, type MembersOptions, type MethodAccess, type MethodImplementation, ModelColumn, ModelName, type NextOrdinalOptions, ORDINAL_STEP, PRESENCE_MAX_LAST_SEEN, PolicyFor, PolicyTools, Presence, Principal, type PrincipalFor, PrincipalOf, type ProjectCheck, type ProjectionOption, PublicAccess, type Quickdraw, QuickdrawServer, QuickdrawTypes, RESUME_MAX_AGE_MS, RESUME_MAX_DELTAS, type RedisAdapterOptions, type RedisAdapterResult, type ResolverOptions, RowAccess, type RowFor, RowForms, type RowFormsOf, RunContext, STREAM_MAX_SCOPES, type SearchAccess, type SearchContract, type SearchHandlersOptions, type SearchIdsOptions, type SearchImplementations, type SearchMethodsOf, type SearchStrategy, type SearchStrategyContext, ServerOptions, Service, type ServiceDefinition, ShareMode, type SharingAccess, type SharingByNameOf, type SharingChange, type SharingChangeKind, type SharingContract, type SharingDefaultAccess, type SharingHandlersOptions, type SharingImplementations, type SharingKindOf, type SharingMethodsOf, type SharingOnChange, type SharingOptionsArgs, type SharingResolveUser, type SharingUserLookup, StorageWhere, StreamHandle, type ValidateEnvOptions, WatchAccess, admin, anyOf, checkEnv, createBasicAccessEngine, crud, custom, decrypt, decryptIfEncrypted, displayNameOf, encrypt, inherit, initQuickdraw, isEncrypted, isRedisAdapterAvailable, jsonAcl, labelOf, meetsLevel, members, nextOrdinal, owner, requireEnv, requireRow, resolver, search, serviceGrant, setupRedisAdapter, sharing, tryDecrypt, validateEnv };
+export { ADMIN_HIDDEN_FIELDS, AccessEngine, AccessFilter, AccessFor, type AccessMap, AccessPolicy, type AdminAccess, type AdminContract, type AdminDefaultAccess, type AdminFieldOf, type AdminFieldOverride, type AdminHandlersOptions, type AdminImplementations, type AffectsOption, AnyAccessPolicy, BaseContext, type BasicAccessEngineOptions, CHANNEL_ABUSE_MULTIPLIER, CHANNEL_ABUSE_WINDOW_MS, CallerFor, ChannelOptions, ChannelsRequired, type CollectionOption, type CollectionOptions, type CollectionsRequired, ContextExtensionOf, type ContextFactory, type CrudAccess, type CrudCreateOf, type CrudHandlersOptions, type CrudImplementations, type CrudKindOf, type CrudMethodsOf, type CrudPrepare, CustomAccess, DbOf, type DefineService, Dispatcher, DispatcherCollections, DispatcherOptions, type EnvValidationResult, HandlerArgs, HandlerContext, type HandlerOutputOf, type HandlerRow, INDEX_MAX_ROWS, type InheritOptions, type InitArgs, type InitOptions, type JsonAclOptions, type JsonColumnValue, type KitContext, type KitHandler, type KitHandlerArgs, type LegacyReply, MAX_APP_ROOMS, MAX_ITEM_IDS, MAX_STREAMS_PER_SOCKET, MaybePromise, McpContextOf, type MembersOptions, type MethodAccess, type MethodImplementation, ModelColumn, ModelName, type NextOrdinalOptions, ORDINAL_STEP, PRESENCE_MAX_LAST_SEEN, PolicyFor, PolicyTools, Presence, Principal, type PrincipalFor, PrincipalOf, type ProjectCheck, type ProjectionOption, PublicAccess, type Quickdraw, QuickdrawServer, QuickdrawTypes, RESUME_MAX_AGE_MS, RESUME_MAX_DELTAS, type RedisAdapterOptions, type RedisAdapterResult, type ResolverOptions, RowAccess, type RowFor, RowForms, type RowFormsOf, RunContext, STREAM_MAX_SCOPES, type SearchAccess, type SearchContract, type SearchHandlersOptions, type SearchIdsOptions, type SearchImplementations, type SearchMethodsOf, type SearchStrategy, type SearchStrategyContext, ServerOptions, Service, type ServiceDefinition, ShareMode, type SharingAccess, type SharingByNameOf, type SharingChange, type SharingChangeKind, type SharingContract, type SharingDefaultAccess, type SharingHandlersOptions, type SharingImplementations, type SharingKindOf, type SharingMethodsOf, type SharingOnChange, type SharingOptionsArgs, type SharingResolveUser, type SharingUserLookup, StorageWhere, StreamHandle, type ValidateEnvOptions, WatchAccess, admin, anyOf, checkEnv, createBasicAccessEngine, crud, custom, decrypt, decryptIfEncrypted, displayNameOf, encrypt, inherit, initQuickdraw, isEncrypted, isRedisAdapterAvailable, jsonAcl, labelOf, meetsLevel, members, nextOrdinal, owner, requireEnv, requireRow, resolver, search, serviceGrant, setupRedisAdapter, sharing, tryDecrypt, validateEnv };

package/dist/server/index.js

@@ -55,7 +55,7 @@ import {
   serviceGrant,
   strip,
   watchAdapterClients
-} from "../chunk-EQ2LW5C5.js";
+} from "../chunk-I2OMV4AD.js";
 import {
   DevWarningError,
   N_PLUS_ONE_STATEMENTS,
@@ -101,7 +101,7 @@ import {
 import {
   entityRoom,
   reservedRoomPrefix
-} from "../chunk-4QNDKNDK.js";
+} from "../chunk-SSDLYYQV.js";
 import {
   CHANNEL_DEFAULT_RATE,
   DEFAULT_COLLECTION_LIMIT,

package/dist/server/mcp/index.d.ts

@@ -1,14 +1,14 @@
-import { A as AnyService, i as Caller } from '../../caller-JNTbbD37.js';
+import { A as AnyService, i as Caller } from '../../caller-Cx5wuao-.js';
 import { IncomingHttpHeaders, IncomingMessage } from 'node:http';
-import { ak as MethodName, d as StandardSchemaV1, c as InferOutput } from '../../infer-CEfvP0_I.js';
+import { al as MethodName, d as StandardSchemaV1, c as InferOutput } from '../../infer-Cwq49ME5.js';
 import { Q as QuickdrawError, a as ErrorCode } from '../../errors-S-bxEIBC.js';
-import { P as PrincipalOfServices, C as ContractOfServices, D as Dispatcher, H as HttpRouter } from '../../http-DC1RmIgu.js';
-import { a as McpContext, b as McpContextOf, M as MaybePromise } from '../../types-CIq6xwng.js';
+import { P as PrincipalOfServices, C as ContractOfServices, D as Dispatcher, H as HttpRouter } from '../../http-89lENH2D.js';
+import { a as McpContext, b as McpContextOf, M as MaybePromise } from '../../types-BDmssndG.js';
 import { L as Logger } from '../../logger-BY28acW-.js';
-import { A as AuthenticateResult } from '../../auth-5yi_rUSM.js';
+import { A as AuthenticateResult } from '../../auth-DyCIKmTQ.js';
 import { Readable, Writable } from 'node:stream';
-import '../../envelope-CR2A9lrd.js';
-import '../../metrics-B1dXpOQc.js';
+import '../../envelope-CoiZY9KU.js';
+import '../../metrics-Ny1dFbyY.js';
 import 'socket.io';
 
 /** The JSON Schema of a tool's arguments. MCP requires an object schema. */

package/dist/server/otel.d.ts

@@ -1,8 +1,8 @@
 import { Meter, Tracer } from '@opentelemetry/api';
-import { C as CallRecord } from '../metrics-B1dXpOQc.js';
-import '../infer-CEfvP0_I.js';
+import { C as CallRecord } from '../metrics-Ny1dFbyY.js';
+import '../infer-Cwq49ME5.js';
 import '../errors-S-bxEIBC.js';
-import '../types-CIq6xwng.js';
+import '../types-BDmssndG.js';
 
 /** Options of {@link otelOnCall}: a meter, a tracer, or both. */
 interface OtelOnCallOptions {

package/dist/{sharing-B5-5Q_wT.d.ts → sharing-BHyufgVl.d.ts}

@@ -1,5 +1,5 @@
-import { L as RowSchema, d as StandardSchemaV1, c as InferOutput, Q as QueryDef, A as AccessLevel, p as MutationDef, b as ACL } from './infer-CEfvP0_I.js';
-import { ag as KitSchema, I as IdInput } from './admin-DufEkep0.js';
+import { L as RowSchema, d as StandardSchemaV1, c as InferOutput, Q as QueryDef, A as AccessLevel, p as MutationDef, b as ACL } from './infer-Cwq49ME5.js';
+import { ag as KitSchema, I as IdInput } from './admin-Bl71J4IG.js';
 import { d as SearchInput, f as SearchQuery, e as SearchPage } from './searchSchemas-CBgKRa1b.js';
 
 /** Type-only: marks a method the search kit made. Never set. */

package/dist/testing/client.d.ts

@@ -1,24 +1,24 @@
 import { QueryClient } from '@tanstack/react-query';
 import { RenderResult } from '@testing-library/react';
 import * as React from 'react';
-import { M as MethodMember, E as EntityMembers, C as CollectionMember, S as StreamMember, a as ChannelMember, b as EventMember, Q as QuickdrawInvalidate, c as QuickdrawClient, d as QuickdrawConnection } from '../clientTypes-B9eYqDO1.js';
-import { aa as ContractMap, G as AnyContract, ak as MethodName, ag as InputOf, am as OutputOf, ab as EntityOf, a8 as CollectionName, aq as ScopeOf, ai as ItemOf, at as StreamName, ah as IsScopedStream, as as StreamItemOf, a6 as ChannelName, a5 as ChannelInputOf, ac as EventName, ad as EventPayloadOf } from '../infer-CEfvP0_I.js';
-import { P as PrincipalOfServices } from '../http-DC1RmIgu.js';
-import { A as AnyService } from '../caller-JNTbbD37.js';
-import { T as TestApp } from '../createTestApp-BPi72usy.js';
-import { Q as AdminMethodsOf } from '../admin-DufEkep0.js';
+import { M as MethodMember, E as EntityMembers, C as CollectionMember, S as StreamMember, a as ChannelMember, b as EventMember, Q as QuickdrawInvalidate, c as QuickdrawClient, d as QuickdrawConnection } from '../clientTypes-B62bWHua.js';
+import { aa as ContractMap, G as AnyContract, al as MethodName, ah as InputOf, an as OutputOf, ab as EntityOf, a8 as CollectionName, as as ScopeOf, aj as ItemOf, av as StreamName, ai as IsScopedStream, au as StreamItemOf, a6 as ChannelName, a5 as ChannelInputOf, ac as EventName, ad as EventPayloadOf } from '../infer-Cwq49ME5.js';
+import { P as PrincipalOfServices } from '../http-89lENH2D.js';
+import { A as AnyService } from '../caller-Cx5wuao-.js';
+import { T as TestApp } from '../createTestApp-BBm3TakW.js';
+import { Q as AdminMethodsOf } from '../admin-Bl71J4IG.js';
 import { Q as QuickdrawError } from '../errors-S-bxEIBC.js';
-import '../envelope-CR2A9lrd.js';
+import '../envelope-CoiZY9KU.js';
 import 'socket.io-client';
 import '../keys-CqKkljVN.js';
 import '../searchSchemas-CBgKRa1b.js';
 import 'node:http';
 import '../logger-BY28acW-.js';
-import '../types-CIq6xwng.js';
-import '../metrics-B1dXpOQc.js';
-import '../auth-5yi_rUSM.js';
+import '../types-BDmssndG.js';
+import '../metrics-Ny1dFbyY.js';
+import '../auth-DyCIKmTQ.js';
 import 'socket.io';
-import '../createServer-301BCb6c.js';
+import '../createServer-P61KBWro.js';
 
 /**
  * How a mocked method answers. Until one of the `mock*` setters runs, every

package/dist/testing/client.js

@@ -11,9 +11,9 @@ import {
   searchTargetOf,
   streamMaxOf,
   viewPredicate
-} from "../chunk-ONVWF4IM.js";
+} from "../chunk-DXTJNJM5.js";
 import "../chunk-K35VD4CQ.js";
-import "../chunk-4QNDKNDK.js";
+import "../chunk-SSDLYYQV.js";
 import {
   isScopedStream
 } from "../chunk-UJQJM7EG.js";

package/dist/testing/index.d.ts

@@ -1,18 +1,18 @@
-import { T as TestApp } from '../createTestApp-BPi72usy.js';
-export { F as FrameMatch, d as FrameQuery, e as FrameRecorder, R as RecordedFrame, S as ServerFrameOf, a as TestAppOptions, b as TestConnection, c as createTestApp, f as emitWithAck, w as waitForEvent } from '../createTestApp-BPi72usy.js';
-import { d as FlushSink, W as WriteRecord, e as FlushInfo, A as AnyService, f as Service } from '../caller-JNTbbD37.js';
-export { g as DevWarning, D as DevWarningError, h as DevWarningKind } from '../caller-JNTbbD37.js';
-import { G as AnyContract, ak as MethodName, ag as InputOf } from '../infer-CEfvP0_I.js';
+import { T as TestApp } from '../createTestApp-BBm3TakW.js';
+export { F as FrameMatch, d as FrameQuery, e as FrameRecorder, R as RecordedFrame, S as ServerFrameOf, a as TestAppOptions, b as TestConnection, c as createTestApp, f as emitWithAck, w as waitForEvent } from '../createTestApp-BBm3TakW.js';
+import { d as FlushSink, W as WriteRecord, e as FlushInfo, A as AnyService, f as Service } from '../caller-Cx5wuao-.js';
+export { g as DevWarning, D as DevWarningError, h as DevWarningKind } from '../caller-Cx5wuao-.js';
+import { G as AnyContract, al as MethodName, ah as InputOf } from '../infer-Cwq49ME5.js';
 import { a as ErrorCode } from '../errors-S-bxEIBC.js';
-import { P as PrincipalOfServices } from '../http-DC1RmIgu.js';
-import { Q as QuickdrawTypes } from '../types-CIq6xwng.js';
-import '../envelope-CR2A9lrd.js';
-import '../createServer-301BCb6c.js';
+import { P as PrincipalOfServices } from '../http-89lENH2D.js';
+import { Q as QuickdrawTypes } from '../types-BDmssndG.js';
+import '../envelope-CoiZY9KU.js';
+import '../createServer-P61KBWro.js';
 import 'node:http';
 import 'socket.io';
-import '../auth-5yi_rUSM.js';
+import '../auth-DyCIKmTQ.js';
 import '../logger-BY28acW-.js';
-import '../metrics-B1dXpOQc.js';
+import '../metrics-Ny1dFbyY.js';
 import 'socket.io-client';
 
 /** One flush a recording sink received. */

package/dist/testing/index.js

@@ -4,7 +4,7 @@ import {
 import {
   createServer,
   runtimeOf
-} from "../chunk-EQ2LW5C5.js";
+} from "../chunk-I2OMV4AD.js";
 import {
   DevWarningError,
   STRICT_WARNINGS
@@ -25,7 +25,7 @@ import {
 import {
   PROTOCOL_VERSION,
   QUICKDRAW_VERSION
-} from "../chunk-4QNDKNDK.js";
+} from "../chunk-SSDLYYQV.js";
 import "../chunk-47AEXVDM.js";
 import {
   utf8ByteLength

package/dist/{types-CIq6xwng.d.ts → types-BDmssndG.d.ts}

@@ -1,4 +1,4 @@
-import { A as AccessLevel, aa as ContractMap } from './infer-CEfvP0_I.js';
+import { A as AccessLevel, aa as ContractMap } from './infer-Cwq49ME5.js';
 
 /**
  * Who is calling. A transport authenticates the connection or request and

package/dist/utils/index.d.ts

@@ -1,7 +1,7 @@
 import { M as MethodQueryKey } from '../keys-CqKkljVN.js';
 export { C as CollectionQueryKey, E as EntityQueryKey, K as KEY_ROOT, b as MethodKeyPrefix, S as ServiceKeyPrefix, c as collectionKey, e as entityKey, m as methodKey, a as methodKeyPrefix, s as serviceKeyPrefix } from '../keys-CqKkljVN.js';
 import { QueryClient } from '@tanstack/react-query';
-import { aa as ContractMap, ak as MethodName, G as AnyContract, aj as KindOf, ag as InputOf, am as OutputOf } from '../infer-CEfvP0_I.js';
+import { aa as ContractMap, al as MethodName, G as AnyContract, ak as KindOf, ah as InputOf, an as OutputOf } from '../infer-Cwq49ME5.js';
 
 /**
  * Format a currency value for display.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitzzero/quickdraw-core",
-  "version": "5.0.0-rc.1",
+  "version": "5.0.0-rc.2",
   "description": "Fast fullstack patterns for real-time applications with Socket.io and TanStack Query",
   "keywords": [
     "fullstack",
@@ -17,7 +17,7 @@
     "directory": "packages/core"
   },
   "bin": {
-    "quickdraw-docs": "./dist/cli/quickdraw-docs.js"
+    "quickdraw-docs": "dist/cli/quickdraw-docs.js"
   },
   "files": [
     "dist"