@lunora/server 1.0.0-alpha.209 → 1.0.0-alpha.210

package/dist/index.d.mts

@@ -2063,13 +2063,23 @@ interface HttpRoute {
  */
 declare const lastEventId: (request: Request) => string | undefined;
 /**
- * The public shape {@link sseEvent} returns and a `.stream()` handler yields to
- * attach an SSE `id:` to one chunk. Structural on purpose: the runtime brand
- * that makes it unambiguous stays internal.
+ * Module-unique brand marking a yielded chunk as an opt-in SSE frame that
+ * carries an event id. `Symbol.for` (not a fresh `Symbol()`) keeps the key
+ * stable even if this package is bundled twice into one worker, and the brand
+ * means a plain user chunk that happens to have `id`/`data` fields is NOT
+ * mistaken for a frame — {@link sseEvent} is the only way to opt in.
+ */
+declare const SSE_EVENT_BRAND: unique symbol;
+/**
+ * The shape {@link sseEvent} returns and a `.stream()` handler yields to attach an
+ * SSE `id:` to one chunk. The brand is REQUIRED: a plain `{ data, id }` object does
+ * not satisfy it, so a yield typed `SseEvent<T>` is always a frame the pump unwraps,
+ * and the chunk type codegen derives from it is the type that reaches the wire.
  */
 interface SseEvent<R> {
   readonly data: R;
   readonly id: string;
+  readonly [SSE_EVENT_BRAND]: true;
 }
 /**
  * Wrap a chunk so the SSE pump emits `id: <id>` immediately before its `data:`
@@ -3749,6 +3759,76 @@ declare const assertShapesDeclareReadPolicies: (shapes: Readonly<Record<string,
  * exposes a protected, policy-less table.
  */
 declare const composeShapeReadWhere: (registry: RlsReadRegistry, request: ShapeReadWhereRequest) => WhereInput;
+/**
+ * The per-socket handle a room handler receives. Mirrors the identity fields of
+ * a connection-lifecycle event and adds the room's own broadcast helper.
+ */
+interface RoomSocket<Message = unknown> {
+  /**
+   * Broadcast a typed `message` to EVERY socket in the room — the sender
+   * included, since the server handler is authoritative and its payload (not
+   * the client's raw send) is what members should see. A broadcast queued by
+   * `onJoin` goes to the members already in the room, not to the socket that
+   * is joining. The value is
+   * wire-encoded before it leaves the DO, so `bigint` / bytes survive.
+   *
+   * Synchronous and best-effort: local delivery happens inline and the
+   * cross-DO relay hop is fire-and-forget, matching `broadcastWhisper`.
+   */
+  broadcast: (message: Message) => void;
+  /** Stable per-socket id, the same one `onConnect` saw. */
+  readonly connectionId: string;
+  /** App-supplied connection context from the client `connect` envelope. */
+  readonly context?: Record<string, unknown>;
+  /** The shard this socket is bound to. */
+  readonly shardKey: string;
+  /** Verified user id resolved at upgrade, or `null` for an anonymous socket. */
+  readonly userId: null | string;
+}
+/** Handler for a socket joining a room. */
+type RoomJoinHandler<Message = unknown> = (context: MutationCtx, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Handler for a socket leaving a room. */
+type RoomLeaveHandler<Message = unknown> = (context: MutationCtx, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Handler for one typed message on a room; `message` is validated against the room's validator. */
+type RoomMessageHandler<Message> = (context: MutationCtx, message: Message, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Options for {@link defineRoom}. */
+interface DefineRoomOptions<Message extends Validator> {
+  /** The room's message validator. Every inbound message is parsed against it before `onMessage`. */
+  message: Message;
+  /** Room name; the wire topic is `room:<name>`. Must be non-empty. */
+  name: string;
+  /** Fired after a socket's join to the room topic is authorized and recorded. */
+  onJoin?: RoomJoinHandler<Infer<Message>>;
+  /** Fired when a socket leaves the room topic. Never authorization-gated. */
+  onLeave?: RoomLeaveHandler<Infer<Message>>;
+  /** Fired for each inbound message, with the message parsed against `message`. */
+  onMessage: RoomMessageHandler<Infer<Message>>;
+}
+/**
+ * A registered room — an internal mutation tagged with its `channel`, so codegen
+ * emits it into `LUNORA_FUNCTIONS` (path dispatch) and derives the generated
+ * `LUNORA_ROOMS` topic→path map the shard resolves a room topic through.
+ *
+ * `Message` is the room's message type, carried type-only (`__roomMessage` is
+ * never set at runtime). The generated room references read it back through
+ * {@link RoomMessageOf}, so a client's `connectRoom` is typed from the room itself.
+ */
+type RegisteredRoom<Message = unknown> = RegisteredFunction<Record<string, never>, void, "mutation"> & {
+  readonly __roomMessage?: Message;
+  readonly channel: {
+    readonly kind: "room";
+    readonly name: string;
+  };
+};
+/** The message type a {@link RegisteredRoom} carries. */
+type RoomMessageOf<Room> = Room extends RegisteredRoom<infer Message> ? Message : never;
+/**
+ * Declare a typed room. See the module docblock for the transport it rides, the
+ * dispatch model, and the authorization path.
+ * @throws {TypeError} when `name` is empty — an empty override would make the
+ * room topic collidable and the `LUNORA_ROOMS` map ambiguous.
+ */
+declare const defineRoom: <Message extends Validator>(options: DefineRoomOptions<Message>) => RegisteredRoom<Infer<Message>>;
 /**
  * `ctx.services` — typed Cloudflare service bindings to sibling Workers the app
  * declares in `lunora.config.*` `services` (plan 457). A service binding is a
@@ -4016,7 +4096,7 @@ type RegisteredWhisperAuthorizer = RegisteredFunction<Record<string, never>, boo
  */
 declare const onWhisper: (handler: WhisperAuthorizeHandler) => RegisteredWhisperAuthorizer;
 declare const VERSION = "0.0.0";
-export { DEFAULT_ACTION_CACHE_TTL_MS as ACTION_CACHE_DEFAULT_TTL_MS, ACTION_CACHE_TABLE, type ActionBuilder, type ActionCacheComponent, type ActionCacheContext, type ActionCacheDatabase, type ActionCacheFunctions, type ActionCtx, type AggregateIndexDefinition, type AggregateIndexOptions, type AggregateOp, type ArgsValidator, type Component, type ComponentFunctions, type CreateOptions, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_REDACTED_FIELDS as DOCUMENT_HISTORY_REDACTED_FIELDS, DOCUMENT_HISTORY_TABLE, type DataModelInit, type DeferredDeleteFlushResult, type DefineActionCacheOptions, type DefineComponentOptions, type DefineDocumentHistoryOptions, type DefineIdentityOptions, type DefineListArgsConfig, type DefinePluginOptions, type DefinePolicyInput, type DefinePresenceOptions, type DefineStorageRuleInput, type DocumentHistoryComponent, type DocumentHistoryEntry, type DocumentHistoryFunctions, type DurableObjectJurisdiction, type DurableStreamOptions, type EmptyArgs, type EnvAccessor, type EnvKeyFailure, type EnvShape, type ExposeConfig, type ExtendableSchema, type FacadeEntry, type FacadeWriterLike, type FunctionKind, type HttpActionCtx, type HttpActionHandler, type HttpMethod, type HttpRoute, type HttpRouteBuilder, type HttpRouteFactory, type HttpRouteHandlerOptions, type HttpRunners, type HttpStreamHandlerOptions, type IdentityContract, type IdentityRejectMode, type IdentityValidation, type IndexFieldsByTable, type InferArgs, type InferEnv, type InferIdentity, type InlineAggregateIndexOptions, type InlineRankIndexOptions, type InternalActionBuilder, type InternalMutationBuilder, type InternalQueryBuilder, type LifecycleEvent, type LifecycleHandler, type ListArgsSpec, type ListArgsValidators, type ListArgsValue, type ListFilterOperators, type ListOrderByEntry, type ListWhere, type LunoraBuilders, LunoraEnvError, type LunoraHttpApp, type LunoraHttpEnv, type LunoraRouteHandler, type ManyRelation, type MaskColumns, type MaskContext, type MaskFn, type MaskOptions, type MaskPolicies, type MaskRegistry, type MaskStrategy, type Middleware, type MiddlewareContext, type MiddlewareNext, type MigrationCtx, type MigrationDefinition, type MigrationDocument, type MigrationReader, type MigrationTransform, type ModuleConfig, type ModuleDefinition, type MutationBuilder, type MutationCtx, type MutatorDefinition, type OnDeleteAction, type OneRelation, type OrmLike, DEFAULT_TTL_MS as PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, type Permission, type PlatformAdminCheck, type Plugin, type Policy, type PrefixedTables, type PresenceComponent, type PresenceFunctions, type PresenceMember, type ProtectPublicOptions, type QueryBuilder, type QueryCtx, type RankIndexDefinition, type RankIndexOptions, type ReactorHandler, type ReactorOutcome, type ReactorSelect, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMigration, type RegisteredMutation, type RegisteredMutator, type RegisteredQuery, type RegisteredReactor, type RegisteredShape, type RegisteredStream, type RegisteredWhisperAuthorizer, type RelationBuilder, type RelationDefinition, type RelationThrough, type RlsOptions, type RlsReadRegistry, type Role, type Schema, type SchemaExtension, type ServiceBindingSpec, type ServiceFetcher, type ServiceRpc, type ShapeDefinition, type ShapeGuardDeclaration, type ShapeReadWhereRequest, type ShardInitEvent, type ShardInitHandler, type SseEvent, type StorageOperation, type StorageRule, type StorageRuleContext, type StorageRuleDecision, type StorageRulesOptions, type StorageServeAuthorizer, type StorageServeAuthzContext, type TableBuilder, type TableDefinition, type TerminalKind, type TriggerBuilder, type TriggerDefinition, type TypedDefinePolicyInput, VERSION, type VectorEmbedder, type VectorIndexDefinition, type VectorIndexOptions, type VectorMetric, type VectorizeOptions, type WhereInput, type WhisperAuthorizeHandler, type WhisperEvent, actionCacheExtension, allowAll, asBucketStorage, assertShapesDeclareReadPolicies, beginDeferredDeletes, beginDeferredSchedules, bindOrm, bindTableFacade, buildMaskRegistry, buildRlsReadRegistry, cacheKeyFor, clampLimit, composePluginMiddleware, composeShapeReadWhere, createPolicyDsl, createSecrets, createServices, defineActionCache, defineAggregateIndex, defineComponent, defineDocumentHistory, defineEnv, defineIdentity, defineIdentityGuard, defineListArgs, defineMigration, defineModule, defineMutator, definePermission, definePlugin, definePolicies, definePolicy, definePresence, defineRankIndex, defineRole, defineSchema, defineSchemaExtension, defineShape, defineStorageRule, defineStorageRules, defineTable, defineVectorIndex, deny, documentHistoryExtension, flushDeferredDeletes,
+export { DEFAULT_ACTION_CACHE_TTL_MS as ACTION_CACHE_DEFAULT_TTL_MS, ACTION_CACHE_TABLE, type ActionBuilder, type ActionCacheComponent, type ActionCacheContext, type ActionCacheDatabase, type ActionCacheFunctions, type ActionCtx, type AggregateIndexDefinition, type AggregateIndexOptions, type AggregateOp, type ArgsValidator, type Component, type ComponentFunctions, type CreateOptions, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_REDACTED_FIELDS as DOCUMENT_HISTORY_REDACTED_FIELDS, DOCUMENT_HISTORY_TABLE, type DataModelInit, type DeferredDeleteFlushResult, type DefineActionCacheOptions, type DefineComponentOptions, type DefineDocumentHistoryOptions, type DefineIdentityOptions, type DefineListArgsConfig, type DefinePluginOptions, type DefinePolicyInput, type DefinePresenceOptions, type DefineRoomOptions, type DefineStorageRuleInput, type DocumentHistoryComponent, type DocumentHistoryEntry, type DocumentHistoryFunctions, type DurableObjectJurisdiction, type DurableStreamOptions, type EmptyArgs, type EnvAccessor, type EnvKeyFailure, type EnvShape, type ExposeConfig, type ExtendableSchema, type FacadeEntry, type FacadeWriterLike, type FunctionKind, type HttpActionCtx, type HttpActionHandler, type HttpMethod, type HttpRoute, type HttpRouteBuilder, type HttpRouteFactory, type HttpRouteHandlerOptions, type HttpRunners, type HttpStreamHandlerOptions, type IdentityContract, type IdentityRejectMode, type IdentityValidation, type IndexFieldsByTable, type InferArgs, type InferEnv, type InferIdentity, type InlineAggregateIndexOptions, type InlineRankIndexOptions, type InternalActionBuilder, type InternalMutationBuilder, type InternalQueryBuilder, type LifecycleEvent, type LifecycleHandler, type ListArgsSpec, type ListArgsValidators, type ListArgsValue, type ListFilterOperators, type ListOrderByEntry, type ListWhere, type LunoraBuilders, LunoraEnvError, type LunoraHttpApp, type LunoraHttpEnv, type LunoraRouteHandler, type ManyRelation, type MaskColumns, type MaskContext, type MaskFn, type MaskOptions, type MaskPolicies, type MaskRegistry, type MaskStrategy, type Middleware, type MiddlewareContext, type MiddlewareNext, type MigrationCtx, type MigrationDefinition, type MigrationDocument, type MigrationReader, type MigrationTransform, type ModuleConfig, type ModuleDefinition, type MutationBuilder, type MutationCtx, type MutatorDefinition, type OnDeleteAction, type OneRelation, type OrmLike, DEFAULT_TTL_MS as PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, type Permission, type PlatformAdminCheck, type Plugin, type Policy, type PrefixedTables, type PresenceComponent, type PresenceFunctions, type PresenceMember, type ProtectPublicOptions, type QueryBuilder, type QueryCtx, type RankIndexDefinition, type RankIndexOptions, type ReactorHandler, type ReactorOutcome, type ReactorSelect, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMigration, type RegisteredMutation, type RegisteredMutator, type RegisteredQuery, type RegisteredReactor, type RegisteredRoom, type RegisteredShape, type RegisteredStream, type RegisteredWhisperAuthorizer, type RelationBuilder, type RelationDefinition, type RelationThrough, type RlsOptions, type RlsReadRegistry, type Role, type RoomJoinHandler, type RoomLeaveHandler, type RoomMessageHandler, type RoomMessageOf, type RoomSocket, type Schema, type SchemaExtension, type ServiceBindingSpec, type ServiceFetcher, type ServiceRpc, type ShapeDefinition, type ShapeGuardDeclaration, type ShapeReadWhereRequest, type ShardInitEvent, type ShardInitHandler, type SseEvent, type StorageOperation, type StorageRule, type StorageRuleContext, type StorageRuleDecision, type StorageRulesOptions, type StorageServeAuthorizer, type StorageServeAuthzContext, type TableBuilder, type TableDefinition, type TerminalKind, type TriggerBuilder, type TriggerDefinition, type TypedDefinePolicyInput, VERSION, type VectorEmbedder, type VectorIndexDefinition, type VectorIndexOptions, type VectorMetric, type VectorizeOptions, type WhereInput, type WhisperAuthorizeHandler, type WhisperEvent, actionCacheExtension, allowAll, asBucketStorage, assertShapesDeclareReadPolicies, beginDeferredDeletes, beginDeferredSchedules, bindOrm, bindTableFacade, buildMaskRegistry, buildRlsReadRegistry, cacheKeyFor, clampLimit, composePluginMiddleware, composeShapeReadWhere, createPolicyDsl, createSecrets, createServices, defineActionCache, defineAggregateIndex, defineComponent, defineDocumentHistory, defineEnv, defineIdentity, defineIdentityGuard, defineListArgs, defineMigration, defineModule, defineMutator, definePermission, definePlugin, definePolicies, definePolicy, definePresence, defineRankIndex, defineRole, defineRoom, defineSchema, defineSchemaExtension, defineShape, defineStorageRule, defineStorageRules, defineTable, defineVectorIndex, deny, documentHistoryExtension, flushDeferredDeletes,
 /**
  * True when `value` is safe to use as an HTTP header field-value: no CR, LF, or
  * NUL. Guards against response-header injection / `Headers`-construction throws

package/dist/index.d.ts

@@ -2063,13 +2063,23 @@ interface HttpRoute {
  */
 declare const lastEventId: (request: Request) => string | undefined;
 /**
- * The public shape {@link sseEvent} returns and a `.stream()` handler yields to
- * attach an SSE `id:` to one chunk. Structural on purpose: the runtime brand
- * that makes it unambiguous stays internal.
+ * Module-unique brand marking a yielded chunk as an opt-in SSE frame that
+ * carries an event id. `Symbol.for` (not a fresh `Symbol()`) keeps the key
+ * stable even if this package is bundled twice into one worker, and the brand
+ * means a plain user chunk that happens to have `id`/`data` fields is NOT
+ * mistaken for a frame — {@link sseEvent} is the only way to opt in.
+ */
+declare const SSE_EVENT_BRAND: unique symbol;
+/**
+ * The shape {@link sseEvent} returns and a `.stream()` handler yields to attach an
+ * SSE `id:` to one chunk. The brand is REQUIRED: a plain `{ data, id }` object does
+ * not satisfy it, so a yield typed `SseEvent<T>` is always a frame the pump unwraps,
+ * and the chunk type codegen derives from it is the type that reaches the wire.
  */
 interface SseEvent<R> {
   readonly data: R;
   readonly id: string;
+  readonly [SSE_EVENT_BRAND]: true;
 }
 /**
  * Wrap a chunk so the SSE pump emits `id: <id>` immediately before its `data:`
@@ -3749,6 +3759,76 @@ declare const assertShapesDeclareReadPolicies: (shapes: Readonly<Record<string,
  * exposes a protected, policy-less table.
  */
 declare const composeShapeReadWhere: (registry: RlsReadRegistry, request: ShapeReadWhereRequest) => WhereInput;
+/**
+ * The per-socket handle a room handler receives. Mirrors the identity fields of
+ * a connection-lifecycle event and adds the room's own broadcast helper.
+ */
+interface RoomSocket<Message = unknown> {
+  /**
+   * Broadcast a typed `message` to EVERY socket in the room — the sender
+   * included, since the server handler is authoritative and its payload (not
+   * the client's raw send) is what members should see. A broadcast queued by
+   * `onJoin` goes to the members already in the room, not to the socket that
+   * is joining. The value is
+   * wire-encoded before it leaves the DO, so `bigint` / bytes survive.
+   *
+   * Synchronous and best-effort: local delivery happens inline and the
+   * cross-DO relay hop is fire-and-forget, matching `broadcastWhisper`.
+   */
+  broadcast: (message: Message) => void;
+  /** Stable per-socket id, the same one `onConnect` saw. */
+  readonly connectionId: string;
+  /** App-supplied connection context from the client `connect` envelope. */
+  readonly context?: Record<string, unknown>;
+  /** The shard this socket is bound to. */
+  readonly shardKey: string;
+  /** Verified user id resolved at upgrade, or `null` for an anonymous socket. */
+  readonly userId: null | string;
+}
+/** Handler for a socket joining a room. */
+type RoomJoinHandler<Message = unknown> = (context: MutationCtx, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Handler for a socket leaving a room. */
+type RoomLeaveHandler<Message = unknown> = (context: MutationCtx, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Handler for one typed message on a room; `message` is validated against the room's validator. */
+type RoomMessageHandler<Message> = (context: MutationCtx, message: Message, socket: RoomSocket<Message>) => Promise<void> | void;
+/** Options for {@link defineRoom}. */
+interface DefineRoomOptions<Message extends Validator> {
+  /** The room's message validator. Every inbound message is parsed against it before `onMessage`. */
+  message: Message;
+  /** Room name; the wire topic is `room:<name>`. Must be non-empty. */
+  name: string;
+  /** Fired after a socket's join to the room topic is authorized and recorded. */
+  onJoin?: RoomJoinHandler<Infer<Message>>;
+  /** Fired when a socket leaves the room topic. Never authorization-gated. */
+  onLeave?: RoomLeaveHandler<Infer<Message>>;
+  /** Fired for each inbound message, with the message parsed against `message`. */
+  onMessage: RoomMessageHandler<Infer<Message>>;
+}
+/**
+ * A registered room — an internal mutation tagged with its `channel`, so codegen
+ * emits it into `LUNORA_FUNCTIONS` (path dispatch) and derives the generated
+ * `LUNORA_ROOMS` topic→path map the shard resolves a room topic through.
+ *
+ * `Message` is the room's message type, carried type-only (`__roomMessage` is
+ * never set at runtime). The generated room references read it back through
+ * {@link RoomMessageOf}, so a client's `connectRoom` is typed from the room itself.
+ */
+type RegisteredRoom<Message = unknown> = RegisteredFunction<Record<string, never>, void, "mutation"> & {
+  readonly __roomMessage?: Message;
+  readonly channel: {
+    readonly kind: "room";
+    readonly name: string;
+  };
+};
+/** The message type a {@link RegisteredRoom} carries. */
+type RoomMessageOf<Room> = Room extends RegisteredRoom<infer Message> ? Message : never;
+/**
+ * Declare a typed room. See the module docblock for the transport it rides, the
+ * dispatch model, and the authorization path.
+ * @throws {TypeError} when `name` is empty — an empty override would make the
+ * room topic collidable and the `LUNORA_ROOMS` map ambiguous.
+ */
+declare const defineRoom: <Message extends Validator>(options: DefineRoomOptions<Message>) => RegisteredRoom<Infer<Message>>;
 /**
  * `ctx.services` — typed Cloudflare service bindings to sibling Workers the app
  * declares in `lunora.config.*` `services` (plan 457). A service binding is a
@@ -4016,7 +4096,7 @@ type RegisteredWhisperAuthorizer = RegisteredFunction<Record<string, never>, boo
  */
 declare const onWhisper: (handler: WhisperAuthorizeHandler) => RegisteredWhisperAuthorizer;
 declare const VERSION = "0.0.0";
-export { DEFAULT_ACTION_CACHE_TTL_MS as ACTION_CACHE_DEFAULT_TTL_MS, ACTION_CACHE_TABLE, type ActionBuilder, type ActionCacheComponent, type ActionCacheContext, type ActionCacheDatabase, type ActionCacheFunctions, type ActionCtx, type AggregateIndexDefinition, type AggregateIndexOptions, type AggregateOp, type ArgsValidator, type Component, type ComponentFunctions, type CreateOptions, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_REDACTED_FIELDS as DOCUMENT_HISTORY_REDACTED_FIELDS, DOCUMENT_HISTORY_TABLE, type DataModelInit, type DeferredDeleteFlushResult, type DefineActionCacheOptions, type DefineComponentOptions, type DefineDocumentHistoryOptions, type DefineIdentityOptions, type DefineListArgsConfig, type DefinePluginOptions, type DefinePolicyInput, type DefinePresenceOptions, type DefineStorageRuleInput, type DocumentHistoryComponent, type DocumentHistoryEntry, type DocumentHistoryFunctions, type DurableObjectJurisdiction, type DurableStreamOptions, type EmptyArgs, type EnvAccessor, type EnvKeyFailure, type EnvShape, type ExposeConfig, type ExtendableSchema, type FacadeEntry, type FacadeWriterLike, type FunctionKind, type HttpActionCtx, type HttpActionHandler, type HttpMethod, type HttpRoute, type HttpRouteBuilder, type HttpRouteFactory, type HttpRouteHandlerOptions, type HttpRunners, type HttpStreamHandlerOptions, type IdentityContract, type IdentityRejectMode, type IdentityValidation, type IndexFieldsByTable, type InferArgs, type InferEnv, type InferIdentity, type InlineAggregateIndexOptions, type InlineRankIndexOptions, type InternalActionBuilder, type InternalMutationBuilder, type InternalQueryBuilder, type LifecycleEvent, type LifecycleHandler, type ListArgsSpec, type ListArgsValidators, type ListArgsValue, type ListFilterOperators, type ListOrderByEntry, type ListWhere, type LunoraBuilders, LunoraEnvError, type LunoraHttpApp, type LunoraHttpEnv, type LunoraRouteHandler, type ManyRelation, type MaskColumns, type MaskContext, type MaskFn, type MaskOptions, type MaskPolicies, type MaskRegistry, type MaskStrategy, type Middleware, type MiddlewareContext, type MiddlewareNext, type MigrationCtx, type MigrationDefinition, type MigrationDocument, type MigrationReader, type MigrationTransform, type ModuleConfig, type ModuleDefinition, type MutationBuilder, type MutationCtx, type MutatorDefinition, type OnDeleteAction, type OneRelation, type OrmLike, DEFAULT_TTL_MS as PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, type Permission, type PlatformAdminCheck, type Plugin, type Policy, type PrefixedTables, type PresenceComponent, type PresenceFunctions, type PresenceMember, type ProtectPublicOptions, type QueryBuilder, type QueryCtx, type RankIndexDefinition, type RankIndexOptions, type ReactorHandler, type ReactorOutcome, type ReactorSelect, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMigration, type RegisteredMutation, type RegisteredMutator, type RegisteredQuery, type RegisteredReactor, type RegisteredShape, type RegisteredStream, type RegisteredWhisperAuthorizer, type RelationBuilder, type RelationDefinition, type RelationThrough, type RlsOptions, type RlsReadRegistry, type Role, type Schema, type SchemaExtension, type ServiceBindingSpec, type ServiceFetcher, type ServiceRpc, type ShapeDefinition, type ShapeGuardDeclaration, type ShapeReadWhereRequest, type ShardInitEvent, type ShardInitHandler, type SseEvent, type StorageOperation, type StorageRule, type StorageRuleContext, type StorageRuleDecision, type StorageRulesOptions, type StorageServeAuthorizer, type StorageServeAuthzContext, type TableBuilder, type TableDefinition, type TerminalKind, type TriggerBuilder, type TriggerDefinition, type TypedDefinePolicyInput, VERSION, type VectorEmbedder, type VectorIndexDefinition, type VectorIndexOptions, type VectorMetric, type VectorizeOptions, type WhereInput, type WhisperAuthorizeHandler, type WhisperEvent, actionCacheExtension, allowAll, asBucketStorage, assertShapesDeclareReadPolicies, beginDeferredDeletes, beginDeferredSchedules, bindOrm, bindTableFacade, buildMaskRegistry, buildRlsReadRegistry, cacheKeyFor, clampLimit, composePluginMiddleware, composeShapeReadWhere, createPolicyDsl, createSecrets, createServices, defineActionCache, defineAggregateIndex, defineComponent, defineDocumentHistory, defineEnv, defineIdentity, defineIdentityGuard, defineListArgs, defineMigration, defineModule, defineMutator, definePermission, definePlugin, definePolicies, definePolicy, definePresence, defineRankIndex, defineRole, defineSchema, defineSchemaExtension, defineShape, defineStorageRule, defineStorageRules, defineTable, defineVectorIndex, deny, documentHistoryExtension, flushDeferredDeletes,
+export { DEFAULT_ACTION_CACHE_TTL_MS as ACTION_CACHE_DEFAULT_TTL_MS, ACTION_CACHE_TABLE, type ActionBuilder, type ActionCacheComponent, type ActionCacheContext, type ActionCacheDatabase, type ActionCacheFunctions, type ActionCtx, type AggregateIndexDefinition, type AggregateIndexOptions, type AggregateOp, type ArgsValidator, type Component, type ComponentFunctions, type CreateOptions, DEFAULT_LIMIT, DEFAULT_MAX_LIMIT, DEFAULT_REDACTED_FIELDS as DOCUMENT_HISTORY_REDACTED_FIELDS, DOCUMENT_HISTORY_TABLE, type DataModelInit, type DeferredDeleteFlushResult, type DefineActionCacheOptions, type DefineComponentOptions, type DefineDocumentHistoryOptions, type DefineIdentityOptions, type DefineListArgsConfig, type DefinePluginOptions, type DefinePolicyInput, type DefinePresenceOptions, type DefineRoomOptions, type DefineStorageRuleInput, type DocumentHistoryComponent, type DocumentHistoryEntry, type DocumentHistoryFunctions, type DurableObjectJurisdiction, type DurableStreamOptions, type EmptyArgs, type EnvAccessor, type EnvKeyFailure, type EnvShape, type ExposeConfig, type ExtendableSchema, type FacadeEntry, type FacadeWriterLike, type FunctionKind, type HttpActionCtx, type HttpActionHandler, type HttpMethod, type HttpRoute, type HttpRouteBuilder, type HttpRouteFactory, type HttpRouteHandlerOptions, type HttpRunners, type HttpStreamHandlerOptions, type IdentityContract, type IdentityRejectMode, type IdentityValidation, type IndexFieldsByTable, type InferArgs, type InferEnv, type InferIdentity, type InlineAggregateIndexOptions, type InlineRankIndexOptions, type InternalActionBuilder, type InternalMutationBuilder, type InternalQueryBuilder, type LifecycleEvent, type LifecycleHandler, type ListArgsSpec, type ListArgsValidators, type ListArgsValue, type ListFilterOperators, type ListOrderByEntry, type ListWhere, type LunoraBuilders, LunoraEnvError, type LunoraHttpApp, type LunoraHttpEnv, type LunoraRouteHandler, type ManyRelation, type MaskColumns, type MaskContext, type MaskFn, type MaskOptions, type MaskPolicies, type MaskRegistry, type MaskStrategy, type Middleware, type MiddlewareContext, type MiddlewareNext, type MigrationCtx, type MigrationDefinition, type MigrationDocument, type MigrationReader, type MigrationTransform, type ModuleConfig, type ModuleDefinition, type MutationBuilder, type MutationCtx, type MutatorDefinition, type OnDeleteAction, type OneRelation, type OrmLike, DEFAULT_TTL_MS as PRESENCE_DEFAULT_TTL_MS, PRESENCE_TABLE, type Permission, type PlatformAdminCheck, type Plugin, type Policy, type PrefixedTables, type PresenceComponent, type PresenceFunctions, type PresenceMember, type ProtectPublicOptions, type QueryBuilder, type QueryCtx, type RankIndexDefinition, type RankIndexOptions, type ReactorHandler, type ReactorOutcome, type ReactorSelect, type RegisteredAction, type RegisteredFunction, type RegisteredLifecycleHook, type RegisteredMigration, type RegisteredMutation, type RegisteredMutator, type RegisteredQuery, type RegisteredReactor, type RegisteredRoom, type RegisteredShape, type RegisteredStream, type RegisteredWhisperAuthorizer, type RelationBuilder, type RelationDefinition, type RelationThrough, type RlsOptions, type RlsReadRegistry, type Role, type RoomJoinHandler, type RoomLeaveHandler, type RoomMessageHandler, type RoomMessageOf, type RoomSocket, type Schema, type SchemaExtension, type ServiceBindingSpec, type ServiceFetcher, type ServiceRpc, type ShapeDefinition, type ShapeGuardDeclaration, type ShapeReadWhereRequest, type ShardInitEvent, type ShardInitHandler, type SseEvent, type StorageOperation, type StorageRule, type StorageRuleContext, type StorageRuleDecision, type StorageRulesOptions, type StorageServeAuthorizer, type StorageServeAuthzContext, type TableBuilder, type TableDefinition, type TerminalKind, type TriggerBuilder, type TriggerDefinition, type TypedDefinePolicyInput, VERSION, type VectorEmbedder, type VectorIndexDefinition, type VectorIndexOptions, type VectorMetric, type VectorizeOptions, type WhereInput, type WhisperAuthorizeHandler, type WhisperEvent, actionCacheExtension, allowAll, asBucketStorage, assertShapesDeclareReadPolicies, beginDeferredDeletes, beginDeferredSchedules, bindOrm, bindTableFacade, buildMaskRegistry, buildRlsReadRegistry, cacheKeyFor, clampLimit, composePluginMiddleware, composeShapeReadWhere, createPolicyDsl, createSecrets, createServices, defineActionCache, defineAggregateIndex, defineComponent, defineDocumentHistory, defineEnv, defineIdentity, defineIdentityGuard, defineListArgs, defineMigration, defineModule, defineMutator, definePermission, definePlugin, definePolicies, definePolicy, definePresence, defineRankIndex, defineRole, defineRoom, defineSchema, defineSchemaExtension, defineShape, defineStorageRule, defineStorageRules, defineTable, defineVectorIndex, deny, documentHistoryExtension, flushDeferredDeletes,
 /**
  * True when `value` is safe to use as an HTTP header field-value: no CR, LF, or
  * NUL. Guards against response-header injection / `Headers`-construction throws

package/dist/index.mjs

@@ -1 +1 @@
-import{ACTION_CACHE_DEFAULT_TTL_MS as t,ACTION_CACHE_TABLE as n,actionCacheExtension as i,cacheKeyFor as a,defineActionCache as f}from"./packem_shared/ACTION_CACHE_DEFAULT_TTL_MS-mmP-6BcT.mjs";import{initLunora as d}from"./packem_shared/initLunora-B-7Xs3Qq.mjs";import{isPerDispatchMiddleware as p,tagPerDispatchMiddleware as x}from"./packem_shared/isPerDispatchMiddleware-DDQPatSm.mjs";import{createSecrets as l}from"./packem_shared/createSecrets-D6rLB42U.mjs";import{beginDeferredDeletes as u,flushDeferredDeletes as h,withDeferredDeletes as S}from"./packem_shared/beginDeferredDeletes-DhwFBbvs.mjs";import{beginDeferredSchedules as T,withDeferredSchedules as g}from"./packem_shared/beginDeferredSchedules-C7QLYr6C.mjs";import{DOCUMENT_HISTORY_REDACTED_FIELDS as R,DOCUMENT_HISTORY_TABLE as I,defineDocumentHistory as _,documentHistoryExtension as L}from"./packem_shared/DOCUMENT_HISTORY_REDACTED_FIELDS-B5Zp-7SI.mjs";import{LunoraEnvError as M,defineEnv as P,redactSecrets as b}from"./packem_shared/LunoraEnvError-bkdMu_-N.mjs";import{bindOrm as F,bindTableFacade as O}from"./packem_shared/bindOrm-9fbLRbOb.mjs";import{httpAction as H,httpRoute as N,httpRouter as w,isSafeHeaderValue as U,lastEventId as k,sseEvent as B}from"./packem_shared/httpAction-D2S7bQzl.mjs";import{serveStorageObject as W}from"./packem_shared/serveStorageObject-aqBFrLyo.mjs";import{defineIdentity as Y}from"./packem_shared/defineIdentity-DwkNKwYa.mjs";import{default as J}from"./packem_shared/defineIdentityGuard-Bt8N65Zs.mjs";import{onConnect as Q,onDisconnect as X,onShardInit as q}from"./packem_shared/onConnect-BLRoOpv2.mjs";import{DEFAULT_LIMIT as Z,DEFAULT_MAX_LIMIT as $,clampLimit as ee,defineListArgs as re}from"./packem_shared/DEFAULT_LIMIT-pT_tV8R0.mjs";import{defineMigration as te}from"./packem_shared/defineMigration-CXOS0Bvq.mjs";import{defineModule as ie}from"./packem_shared/defineModule-OecXWM3U.mjs";import{defineMutator as fe}from"./packem_shared/defineMutator-B4ipDtDR.mjs";import{platformAdmin as de}from"./packem_shared/platformAdmin-kczXQme8.mjs";import{c as pe,d as xe,a as ce,b as le,e as Ee,f as ue,g as he,h as Se,i as De,j as Te,k as ge,m as Ae}from"./packem_shared/plugin-Bm9wIpiI.mjs";import{PRESENCE_DEFAULT_TTL_MS as Ie,PRESENCE_TABLE as _e,definePresence as Le,presenceExtension as Ce}from"./packem_shared/PRESENCE_DEFAULT_TTL_MS-DFpy5J8G.mjs";import{protectPublic as Pe}from"./packem_shared/protectPublic-Bi5_95aP.mjs";import{onQueryChange as ye}from"./packem_shared/onQueryChange-iuLzmyPs.mjs";import{createServices as Oe}from"./packem_shared/createServices-IJvoqi0e.mjs";import{defineShape as He}from"./packem_shared/defineShape-CwKm5KLp.mjs";import{onWhisper as we}from"./packem_shared/onWhisper-CfDbFLQh.mjs";import{LunoraError as ke}from"@lunora/errors";import{cronJobs as Ve}from"@lunora/scheduler";import{ValidationError as je,v as Ye}from"@lunora/values";import{allowAll as Je,deny as Ke,isDeny as Qe,toWhereInput as Xe}from"./packem_shared/allowAll-DkRAgItV.mjs";import{asBucketStorage as ze}from"./packem_shared/asBucketStorage-DoGYOjq3.mjs";import{assertShapesDeclareReadPolicies as $e,buildRlsReadRegistry as er,composeShapeReadWhere as rr}from"./packem_shared/assertShapesDeclareReadPolicies-Bg4Ter7Q.mjs";import{buildMaskRegistry as tr}from"./packem_shared/buildMaskRegistry-DpWMtalG.mjs";import{createPolicyDsl as ir,definePermission as ar,definePolicies as fr,definePolicy as sr,defineRole as dr}from"./packem_shared/createPolicyDsl-BZa6SqLJ.mjs";import{defineStorageRule as pr,defineStorageRules as xr}from"./packem_shared/defineStorageRule-Dv4nJE0H.mjs";import{mask as lr}from"./packem_shared/mask-D-jRCAhy.mjs";import{r as ur}from"./packem_shared/middleware-3ySZVrpt.mjs";import{storageRules as Sr}from"./packem_shared/storageRules-CBLioxF7.mjs";const e="0.0.0";export{t as ACTION_CACHE_DEFAULT_TTL_MS,n as ACTION_CACHE_TABLE,Z as DEFAULT_LIMIT,$ as DEFAULT_MAX_LIMIT,R as DOCUMENT_HISTORY_REDACTED_FIELDS,I as DOCUMENT_HISTORY_TABLE,M as LunoraEnvError,ke as LunoraError,Ie as PRESENCE_DEFAULT_TTL_MS,_e as PRESENCE_TABLE,e as VERSION,je as ValidationError,i as actionCacheExtension,Je as allowAll,ze as asBucketStorage,$e as assertShapesDeclareReadPolicies,u as beginDeferredDeletes,T as beginDeferredSchedules,F as bindOrm,O as bindTableFacade,tr as buildMaskRegistry,er as buildRlsReadRegistry,a as cacheKeyFor,ee as clampLimit,pe as composePluginMiddleware,rr as composeShapeReadWhere,ir as createPolicyDsl,l as createSecrets,Oe as createServices,Ve as cronJobs,f as defineActionCache,xe as defineAggregateIndex,ce as defineComponent,_ as defineDocumentHistory,P as defineEnv,Y as defineIdentity,J as defineIdentityGuard,re as defineListArgs,te as defineMigration,ie as defineModule,fe as defineMutator,ar as definePermission,le as definePlugin,fr as definePolicies,sr as definePolicy,Le as definePresence,Ee as defineRankIndex,dr as defineRole,ue as defineSchema,he as defineSchemaExtension,He as defineShape,pr as defineStorageRule,xr as defineStorageRules,Se as defineTable,De as defineVectorIndex,Ke as deny,L as documentHistoryExtension,h as flushDeferredDeletes,H as httpAction,N as httpRoute,w as httpRouter,Te as indexFieldsFromSchema,d as initLunora,ge as installPlugins,Qe as isDeny,p as isPerDispatchMiddleware,U as isSafeHeaderValue,k as lastEventId,lr as mask,Ae as mergeSchemaExtension,Q as onConnect,X as onDisconnect,ye as onQueryChange,q as onShardInit,we as onWhisper,de as platformAdmin,Ce as presenceExtension,Pe as protectPublic,b as redactSecrets,ur as rls,W as serveStorageObject,B as sseEvent,Sr as storageRules,x as tagPerDispatchMiddleware,Xe as toWhereInput,Ye as v,S as withDeferredDeletes,g as withDeferredSchedules};
+import{ACTION_CACHE_DEFAULT_TTL_MS as t,ACTION_CACHE_TABLE as n,actionCacheExtension as i,cacheKeyFor as f,defineActionCache as a}from"./packem_shared/ACTION_CACHE_DEFAULT_TTL_MS-mmP-6BcT.mjs";import{initLunora as d}from"./packem_shared/initLunora-B-7Xs3Qq.mjs";import{isPerDispatchMiddleware as p,tagPerDispatchMiddleware as x}from"./packem_shared/isPerDispatchMiddleware-DDQPatSm.mjs";import{createSecrets as l}from"./packem_shared/createSecrets-D6rLB42U.mjs";import{beginDeferredDeletes as u,flushDeferredDeletes as h,withDeferredDeletes as S}from"./packem_shared/beginDeferredDeletes-DhwFBbvs.mjs";import{beginDeferredSchedules as T,withDeferredSchedules as g}from"./packem_shared/beginDeferredSchedules-C7QLYr6C.mjs";import{DOCUMENT_HISTORY_REDACTED_FIELDS as A,DOCUMENT_HISTORY_TABLE as I,defineDocumentHistory as _,documentHistoryExtension as L}from"./packem_shared/DOCUMENT_HISTORY_REDACTED_FIELDS-B5Zp-7SI.mjs";import{LunoraEnvError as M,defineEnv as P,redactSecrets as b}from"./packem_shared/LunoraEnvError-bkdMu_-N.mjs";import{bindOrm as F,bindTableFacade as O}from"./packem_shared/bindOrm-9fbLRbOb.mjs";import{httpAction as H,httpRoute as N,httpRouter as w,isSafeHeaderValue as U,lastEventId as k,sseEvent as B}from"./packem_shared/httpAction-D2S7bQzl.mjs";import{serveStorageObject as W}from"./packem_shared/serveStorageObject-aqBFrLyo.mjs";import{defineIdentity as Y}from"./packem_shared/defineIdentity-DwkNKwYa.mjs";import{default as J}from"./packem_shared/defineIdentityGuard-Bt8N65Zs.mjs";import{onConnect as Q,onDisconnect as X,onShardInit as q}from"./packem_shared/onConnect-BLRoOpv2.mjs";import{DEFAULT_LIMIT as Z,DEFAULT_MAX_LIMIT as $,clampLimit as ee,defineListArgs as re}from"./packem_shared/DEFAULT_LIMIT-pT_tV8R0.mjs";import{defineMigration as te}from"./packem_shared/defineMigration-CXOS0Bvq.mjs";import{defineModule as ie}from"./packem_shared/defineModule-OecXWM3U.mjs";import{defineMutator as ae}from"./packem_shared/defineMutator-B4ipDtDR.mjs";import{platformAdmin as de}from"./packem_shared/platformAdmin-kczXQme8.mjs";import{c as pe,d as xe,a as ce,b as le,e as Ee,f as ue,g as he,h as Se,i as De,j as Te,k as ge,m as Re}from"./packem_shared/plugin-Bm9wIpiI.mjs";import{PRESENCE_DEFAULT_TTL_MS as Ie,PRESENCE_TABLE as _e,definePresence as Le,presenceExtension as Ce}from"./packem_shared/PRESENCE_DEFAULT_TTL_MS-DFpy5J8G.mjs";import{protectPublic as Pe}from"./packem_shared/protectPublic-Bi5_95aP.mjs";import{onQueryChange as ye}from"./packem_shared/onQueryChange-iuLzmyPs.mjs";import{defineRoom as Oe}from"./packem_shared/defineRoom-CoGi-xwm.mjs";import{createServices as He}from"./packem_shared/createServices-IJvoqi0e.mjs";import{defineShape as we}from"./packem_shared/defineShape-CwKm5KLp.mjs";import{onWhisper as ke}from"./packem_shared/onWhisper-CfDbFLQh.mjs";import{LunoraError as Ve}from"@lunora/errors";import{cronJobs as je}from"@lunora/scheduler";import{ValidationError as Ge,v as Je}from"@lunora/values";import{allowAll as Qe,deny as Xe,isDeny as qe,toWhereInput as ze}from"./packem_shared/allowAll-DkRAgItV.mjs";import{asBucketStorage as $e}from"./packem_shared/asBucketStorage-DoGYOjq3.mjs";import{assertShapesDeclareReadPolicies as rr,buildRlsReadRegistry as or,composeShapeReadWhere as tr}from"./packem_shared/assertShapesDeclareReadPolicies-Bg4Ter7Q.mjs";import{buildMaskRegistry as ir}from"./packem_shared/buildMaskRegistry-DpWMtalG.mjs";import{createPolicyDsl as ar,definePermission as sr,definePolicies as dr,definePolicy as mr,defineRole as pr}from"./packem_shared/createPolicyDsl-BZa6SqLJ.mjs";import{defineStorageRule as cr,defineStorageRules as lr}from"./packem_shared/defineStorageRule-Dv4nJE0H.mjs";import{mask as ur}from"./packem_shared/mask-D-jRCAhy.mjs";import{r as Sr}from"./packem_shared/middleware-3ySZVrpt.mjs";import{storageRules as Tr}from"./packem_shared/storageRules-CBLioxF7.mjs";const e="0.0.0";export{t as ACTION_CACHE_DEFAULT_TTL_MS,n as ACTION_CACHE_TABLE,Z as DEFAULT_LIMIT,$ as DEFAULT_MAX_LIMIT,A as DOCUMENT_HISTORY_REDACTED_FIELDS,I as DOCUMENT_HISTORY_TABLE,M as LunoraEnvError,Ve as LunoraError,Ie as PRESENCE_DEFAULT_TTL_MS,_e as PRESENCE_TABLE,e as VERSION,Ge as ValidationError,i as actionCacheExtension,Qe as allowAll,$e as asBucketStorage,rr as assertShapesDeclareReadPolicies,u as beginDeferredDeletes,T as beginDeferredSchedules,F as bindOrm,O as bindTableFacade,ir as buildMaskRegistry,or as buildRlsReadRegistry,f as cacheKeyFor,ee as clampLimit,pe as composePluginMiddleware,tr as composeShapeReadWhere,ar as createPolicyDsl,l as createSecrets,He as createServices,je as cronJobs,a as defineActionCache,xe as defineAggregateIndex,ce as defineComponent,_ as defineDocumentHistory,P as defineEnv,Y as defineIdentity,J as defineIdentityGuard,re as defineListArgs,te as defineMigration,ie as defineModule,ae as defineMutator,sr as definePermission,le as definePlugin,dr as definePolicies,mr as definePolicy,Le as definePresence,Ee as defineRankIndex,pr as defineRole,Oe as defineRoom,ue as defineSchema,he as defineSchemaExtension,we as defineShape,cr as defineStorageRule,lr as defineStorageRules,Se as defineTable,De as defineVectorIndex,Xe as deny,L as documentHistoryExtension,h as flushDeferredDeletes,H as httpAction,N as httpRoute,w as httpRouter,Te as indexFieldsFromSchema,d as initLunora,ge as installPlugins,qe as isDeny,p as isPerDispatchMiddleware,U as isSafeHeaderValue,k as lastEventId,ur as mask,Re as mergeSchemaExtension,Q as onConnect,X as onDisconnect,ye as onQueryChange,q as onShardInit,ke as onWhisper,de as platformAdmin,Ce as presenceExtension,Pe as protectPublic,b as redactSecrets,Sr as rls,W as serveStorageObject,B as sseEvent,Tr as storageRules,x as tagPerDispatchMiddleware,ze as toWhereInput,Je as v,S as withDeferredDeletes,g as withDeferredSchedules};

package/dist/packem_shared/defineRoom-CoGi-xwm.mjs

@@ -0,0 +1 @@
+import{parseValidatorMap as f}from"@lunora/values";const w=i=>{const{message:o,name:e,onJoin:r,onLeave:t,onMessage:m}=i;if(typeof e!="string"||e.length===0)throw new TypeError("defineRoom: `name` must be a non-empty string");return{args:{},handler:async(n,g)=>{const{kind:s,message:d,socket:a}=g;if(s==="join"){await r?.(n,a);return}if(s==="leave"){await t?.(n,a);return}const{message:p}=f({message:o},{message:d},"message");await m(n,p,a)},channel:{kind:"room",name:e},kind:"mutation",visibility:"internal"}};export{w as defineRoom};

package/dist/types.d.mts

@@ -936,6 +936,17 @@ interface ExposeConfig {
 }
 interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKind> {
   readonly args: A;
+  /**
+   * Set on a channel registration, which a socket reaches by its name rather
+   * than a lifecycle moment: a `defineRoom` (`kind: "room"`, with the room's name,
+   * WITHOUT the topic prefix). Codegen collects it into the generated
+   * `LUNORA_ROOMS` map (topic → function path) the DO resolves a room whisper
+   * topic through. Absent on every other registration.
+   */
+  readonly channel?: {
+    readonly kind: "room";
+    readonly name: string;
+  };
   /**
    * Set by the `.expose({ rest: true })` builder modifier. Marks the procedure
    * as published on the public REST surface (plan 167). Absent on procedures that
@@ -945,10 +956,11 @@ interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKi
   readonly handler: (context: unknown, args: InferArgs<A>) => Promise<R> | R;
   readonly kind: Kind;
   /**
-   * Set on connection-lifecycle hooks (`onConnect` / `onDisconnect`).
-   * Marks the function for the generated `LUNORA_LIFECYCLE_HOOKS` manifest so the
-   * DO dispatches it on socket connect/disconnect rather than via a client RPC.
-   * Absent on ordinary registrations.
+   * Set on connection-lifecycle hooks (`onConnect` / `onDisconnect`), and on the
+   * other four moments. Marks the function for the generated
+   * `LUNORA_LIFECYCLE_HOOKS` manifest so the DO dispatches it from the socket
+   * lifecycle rather than via a client RPC. Absent on ordinary registrations
+   * and on channel registrations (`channel`).
    */
   readonly lifecycle?: LifecycleEventKind;
   readonly visibility?: FunctionVisibility;
@@ -1059,7 +1071,9 @@ interface RunAction {
  * a watched read's result changed — see `onQueryChange`. `whisper` is per-TOPIC
  * and decides whether a socket may join or broadcast to one — see `onWhisper`
  * and {@link WhisperEvent}; unlike the other four it is a query, and its return
- * value is the verdict.
+ * value is the verdict. `room` is per-ROOM-MESSAGE and is a mutation: a
+ * `defineRoom` registration dispatched when a socket joins, leaves, or sends a
+ * typed message to the room's whisper topic.
  */
 type LifecycleEventKind = "connect" | "disconnect" | "init" | "reactor" | "whisper";
 /**

package/dist/types.d.ts

@@ -936,6 +936,17 @@ interface ExposeConfig {
 }
 interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKind> {
   readonly args: A;
+  /**
+   * Set on a channel registration, which a socket reaches by its name rather
+   * than a lifecycle moment: a `defineRoom` (`kind: "room"`, with the room's name,
+   * WITHOUT the topic prefix). Codegen collects it into the generated
+   * `LUNORA_ROOMS` map (topic → function path) the DO resolves a room whisper
+   * topic through. Absent on every other registration.
+   */
+  readonly channel?: {
+    readonly kind: "room";
+    readonly name: string;
+  };
   /**
    * Set by the `.expose({ rest: true })` builder modifier. Marks the procedure
    * as published on the public REST surface (plan 167). Absent on procedures that
@@ -945,10 +956,11 @@ interface RegisteredFunction<A extends ArgsValidator, R, Kind extends FunctionKi
   readonly handler: (context: unknown, args: InferArgs<A>) => Promise<R> | R;
   readonly kind: Kind;
   /**
-   * Set on connection-lifecycle hooks (`onConnect` / `onDisconnect`).
-   * Marks the function for the generated `LUNORA_LIFECYCLE_HOOKS` manifest so the
-   * DO dispatches it on socket connect/disconnect rather than via a client RPC.
-   * Absent on ordinary registrations.
+   * Set on connection-lifecycle hooks (`onConnect` / `onDisconnect`), and on the
+   * other four moments. Marks the function for the generated
+   * `LUNORA_LIFECYCLE_HOOKS` manifest so the DO dispatches it from the socket
+   * lifecycle rather than via a client RPC. Absent on ordinary registrations
+   * and on channel registrations (`channel`).
    */
   readonly lifecycle?: LifecycleEventKind;
   readonly visibility?: FunctionVisibility;
@@ -1059,7 +1071,9 @@ interface RunAction {
  * a watched read's result changed — see `onQueryChange`. `whisper` is per-TOPIC
  * and decides whether a socket may join or broadcast to one — see `onWhisper`
  * and {@link WhisperEvent}; unlike the other four it is a query, and its return
- * value is the verdict.
+ * value is the verdict. `room` is per-ROOM-MESSAGE and is a mutation: a
+ * `defineRoom` registration dispatched when a socket joins, leaves, or sends a
+ * typed message to the room's whisper topic.
  */
 type LifecycleEventKind = "connect" | "disconnect" | "init" | "reactor" | "whisper";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.209",
+  "version": "1.0.0-alpha.210",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",
@@ -71,8 +71,8 @@
   },
   "dependencies": {
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/scheduler": "1.0.0-alpha.130",
-    "@lunora/shard-engine": "1.0.0-alpha.132",
+    "@lunora/scheduler": "1.0.0-alpha.131",
+    "@lunora/shard-engine": "1.0.0-alpha.133",
     "@lunora/values": "1.0.0-alpha.67",
     "@lunora/wire": "1.0.0-alpha.1",
     "drizzle-orm": "^0.45.3",