deepspace 0.16.0 → 0.17.0

package/dist/index.d.ts

@@ -579,14 +579,12 @@ declare function getMessageType(data: Uint8Array): number;
  * Wire protocol constants.
  *
  * The JSON WebSocket protocol uses dotted string identifiers (e.g.
- * `"game.input"`) as the `type` discriminator. All message types are
+ * `"records.query"`) as the `type` discriminator. All message types are
  * grouped under a single `MSG` object so imports stay tidy:
  *
  *     import { MSG, dispatch, clientBuild } from 'deepspace'
  *
  *     dispatch<ServerMessage>(raw, {
- *       [MSG.GAME_STATE]: (p) => { ... },
- *       [MSG.GAME_TICK]:  (p) => { ... },
  *     })
  *
  * Each key's value is the on-wire string — grep-friendly, self-
@@ -615,14 +613,6 @@ declare const MSG: {
     readonly ACK: "records.ack";
     readonly LIST_SCHEMAS: "records.list_schemas";
     readonly RESUBSCRIBE: "records.resubscribe";
-    readonly GAME_STATE: "game.state";
-    readonly GAME_INPUT: "game.input";
-    readonly GAME_PLAYER_JOIN: "game.player_join";
-    readonly GAME_PLAYER_LEAVE: "game.player_leave";
-    readonly GAME_PLAYER_READY: "game.player_ready";
-    readonly GAME_START: "game.start";
-    readonly GAME_END: "game.end";
-    readonly GAME_TICK: "game.tick";
     readonly CANVAS_SHAPES: "canvas.shapes";
     readonly CANVAS_ADD: "canvas.add";
     readonly CANVAS_MOVE: "canvas.move";
@@ -711,7 +701,7 @@ declare const ROLE_ADMIN = "admin";
  * ---------------
  *
  * Some message types carry different payloads depending on who's sending.
- * `MSG.GAME_START`, for example, is `{}` when the client requests a start
+ * `MSG.RECORDS_RESUBSCRIBE`, for example, is `{}` when the client asks to
  * but `{ state, tick }` when the server broadcasts the start event.
  * `MSG.CANVAS_ADD` is a flat shape dict on the way in and a `{ shape }`
  * wrapper on the way out. Modelling these with one union would force
@@ -784,10 +774,7 @@ type ClientMessage = BaseMessage<typeof MSG.SUBSCRIBE, {
     collection: string;
     recordId: string;
     fieldName: string;
-}> | BaseMessage<typeof MSG.GAME_INPUT, {
-    action: string;
-    data: Record<string, unknown>;
-}> | BaseMessage<typeof MSG.GAME_PLAYER_READY, EmptyPayload> | BaseMessage<typeof MSG.GAME_START, EmptyPayload> | BaseMessage<typeof MSG.GAME_END, EmptyPayload> | BaseMessage<typeof MSG.CANVAS_ADD, unknown> | BaseMessage<typeof MSG.CANVAS_MOVE, {
+}> | BaseMessage<typeof MSG.CANVAS_ADD, unknown> | BaseMessage<typeof MSG.CANVAS_MOVE, {
     shapeId: string;
     x: number;
     y: number;
@@ -862,26 +849,6 @@ type ServerMessage = BaseMessage<typeof MSG.QUERY_RESULT, {
     recordId: string;
     fieldName: string;
     canWrite: boolean;
-}> | BaseMessage<typeof MSG.GAME_STATE, {
-    state: unknown;
-    tick: number;
-    players: unknown[];
-    running: boolean;
-}> | BaseMessage<typeof MSG.GAME_TICK, {
-    state: unknown;
-    tick: number;
-}> | BaseMessage<typeof MSG.GAME_START, {
-    state: unknown;
-    tick: number;
-}> | BaseMessage<typeof MSG.GAME_END, {
-    state: unknown;
-    tick: number;
-}> | BaseMessage<typeof MSG.GAME_PLAYER_JOIN, {
-    player: unknown;
-}> | BaseMessage<typeof MSG.GAME_PLAYER_LEAVE, {
-    userId: string;
-}> | BaseMessage<typeof MSG.GAME_PLAYER_READY, {
-    userId: string;
 }> | BaseMessage<typeof MSG.CANVAS_SHAPES, {
     shapes: unknown[];
     viewports: unknown[];
@@ -1007,25 +974,6 @@ declare const clientBuild: {
             readonly fieldName: string;
         };
     };
-    gameInput: (action: string, data?: Record<string, unknown>) => {
-        readonly type: "game.input";
-        readonly payload: {
-            readonly action: string;
-            readonly data: Record<string, unknown>;
-        };
-    };
-    gamePlayerReady: () => {
-        readonly type: "game.player_ready";
-        readonly payload: EmptyPayload;
-    };
-    gameStart: () => {
-        readonly type: "game.start";
-        readonly payload: EmptyPayload;
-    };
-    gameEnd: () => {
-        readonly type: "game.end";
-        readonly payload: EmptyPayload;
-    };
     canvasAdd: (shape: Record<string, unknown>) => {
         readonly type: "canvas.add";
         readonly payload: Record<string, unknown>;
@@ -1210,54 +1158,6 @@ declare const serverBuild: {
             readonly canWrite: boolean;
         };
     };
-    gameState: (state: unknown, tick: number, players: unknown[], running: boolean) => {
-        readonly type: "game.state";
-        readonly payload: {
-            readonly state: unknown;
-            readonly tick: number;
-            readonly players: unknown[];
-            readonly running: boolean;
-        };
-    };
-    gameTick: (state: unknown, tick: number) => {
-        readonly type: "game.tick";
-        readonly payload: {
-            readonly state: unknown;
-            readonly tick: number;
-        };
-    };
-    gameStart: (state: unknown, tick: number) => {
-        readonly type: "game.start";
-        readonly payload: {
-            readonly state: unknown;
-            readonly tick: number;
-        };
-    };
-    gameEnd: (state: unknown, tick: number) => {
-        readonly type: "game.end";
-        readonly payload: {
-            readonly state: unknown;
-            readonly tick: number;
-        };
-    };
-    gamePlayerJoin: (player: unknown) => {
-        readonly type: "game.player_join";
-        readonly payload: {
-            readonly player: unknown;
-        };
-    };
-    gamePlayerLeave: (userId: string) => {
-        readonly type: "game.player_leave";
-        readonly payload: {
-            readonly userId: string;
-        };
-    };
-    gamePlayerReady: (userId: string) => {
-        readonly type: "game.player_ready";
-        readonly payload: {
-            readonly userId: string;
-        };
-    };
     canvasShapes: (shapes: unknown[], viewports: unknown[]) => {
         readonly type: "canvas.shapes";
         readonly payload: {
@@ -1515,8 +1415,6 @@ interface HandlerContext {
     sendBinary(ws: WebSocket, data: Uint8Array): void;
 }
 
-/** First source migration required by the canonical app identity cutover. */
-declare const CANONICAL_APP_IDENTITY_MIGRATION_ID = "2026-08-canonical-app-identity-wire";
 /** Asset-layer misses became real 404s, and the worker owns the fallback. The
  *  config and the worker's fallback path have to move together. */
 declare const WORKER_OWNED_NOT_FOUND_MIGRATION_ID = "2026-08-worker-owned-not-found";
@@ -3349,57 +3247,6 @@ interface UseYjsRoomResult {
  */
 declare function useYjsRoom(docId: string, fieldName: string): UseYjsRoomResult;
 
-/**
- * useGameRoom — Connect to a GameRoom Durable Object.
- *
- * Opens a WebSocket to /ws/game/:roomId for real-time game state.
- *
- * @example
- * const { state, sendInput, players, connected } = useGameRoom('my-game')
- *
- * Implementation note: this hook uses the typed wire protocol helpers
- * (`clientBuild` for sends, `dispatch` for receives) from
- * `shared/protocol/messages`. Hand-rolled `switch (msg.type)` blocks and
- * raw `JSON.stringify({ type: MSG.X, payload: ... })` sends are a fast
- * route to the "silent drop" bug class when a payload shape drifts —
- * prefer the typed helpers instead.
- */
-interface GamePlayer {
-    userId: string;
-    userName: string;
-    ready: boolean;
-    connectedAt: string;
-    data: Record<string, unknown>;
-}
-interface UseGameRoomResult {
-    /** Current game state */
-    state: Record<string, unknown>;
-    /** Current tick number */
-    tick: number;
-    /** Connected players */
-    players: GamePlayer[];
-    /** Whether the game is currently running */
-    running: boolean;
-    /** Whether WebSocket is connected */
-    connected: boolean;
-    /**
-     * Whether this connection has write access. False for viewers /
-     * unauthenticated spectators — they receive state broadcasts but the
-     * send callbacks below no-op. UIs should disable input controls when
-     * false so spectators see why their actions don't take effect.
-     */
-    canWrite: boolean;
-    /** Send a game input (no-op for spectators) */
-    sendInput: (action: string, data?: Record<string, unknown>) => void;
-    /** Mark self as ready (no-op for spectators) */
-    setReady: () => void;
-    /** Request game start (no-op for spectators) */
-    startGame: () => void;
-    /** Request game end (no-op for spectators) */
-    endGame: () => void;
-}
-declare function useGameRoom(roomId: string): UseGameRoomResult;
-
 /**
  * useCanvas — Connect to a CanvasRoom Durable Object.
  *
@@ -4992,4 +4839,4 @@ declare const ACCOUNT_STORAGE_LIMIT_BYTES: {
 declare function storageLimitForTier(tier: string | null | undefined): number;
 declare function formatBytes(bytes: number): string;
 
-export { ACCOUNT_STORAGE_LIMIT_BYTES, APP_LOG_EVENT_KEYS, ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppMigrationIdsValidation, type AsyncResourceDefaults, type AsyncResourceState, type AsyncResourceStatus, AuthGate, type AuthGateProps, AuthOverlay, Awareness, type AwarenessState, type AwarenessStates, type BaseMessage, CANONICAL_APP_IDENTITY_MIGRATION_ID, type CanvasShapeClient, type Channel, type ChannelInvitation, type ChannelMember, type ChargeOnceOpts, type ChargeOnceResult, type ClientErrorKind, type ClientErrorReport, type ClientErrorReporterOptions, type ClientMessage, type CollectionSchema, type ConnectionAttachment, type ConnectionStatus, type ContentSegment, type ConversationObject, type CronHistoryEntry, type CronTaskState, DEEPSPACE_AGENT_PROFILES, DEEPSPACE_AI_DEFAULTS, DEEPSPACE_AI_MODELS, DEEPSPACE_MODEL_CATALOG_PROVENANCE, DEEPSPACE_THEME_PROPERTIES, DEFAULT_USER_COLORS, type DeepSpaceAIModel, type DeepSpaceAIModelId, type DeepSpaceAIProvider, type DeepSpaceAgentProfile, type DeepSpaceAgentProfileId, type DeepSpaceAgentSupport, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FileAttachment, type GamePlayer, type GroupedReaction, GuestBanner, type HandlerContext, type InboxEntry, type IntegrationResponse, type JobStatusView, type JobView, LOG_LEVELS, type LinkPreviewData, type LoadState, type LoadStateAuthInput, type LoadStateStatusInput, type LogLevel, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MemberRecord, type Message, type MessageHandlers, type MessageRecord, type MsgType, type PagedResourceFetchArgs, type PagedResourcePage, type PagedResourceState, type PagedResourceStatus, type PlanInfo, PlatformContext, type PlatformContextValue, PlatformProvider, type PlatformWSOptions, type PlatformWSResult, type PresencePeerClient, PricingTable, type PricingTablePlan, type PricingTablePrice, type ProductChargeOpts, type ProtocolMessage, type Purchase, type Query, type R2FileInfo, type R2Scope, type R2UploadResult, ROLES, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_CONFIG, ROLE_DEFAULT, type Reaction, type ReactionRecord, type ReadCursorRecord, type ReadReceipt, type RecordData, RecordProvider, type RecordProviderProps, RecordScope, type RequestOptions, type ResolvedDeepSpaceAgentModel, type Role, type RoomUser, type ScopeEntry, ScopeRegistryProvider, type ServerMessage, SignedIn, SignedOut, type SubscribeOpts, type SubscribeResult, type SubscriptionState, type SubscriptionStatus, type SyncResult, type UseAsyncResourceOptions, type UseAuthProfileReadyOptions, type UseAuthStatusOptions, type UseCanvasResult, type UseCheckoutOpts, type UseCronMonitorResult, type UseGameRoomResult, type UseJobsResult, type UsePagedResourceOptions, type UsePresenceRoomResult, type UseR2FilesReturn, type UseVoiceAgentOptions, type UseVoiceAgentResult, type UseYjsFieldResult, type UseYjsRoomResult, type UseYjsTextResult, type User, type UserCredits, type UserInfo, type UserKarma, type UserProfile, type ViewportClient, type VoiceStatus, type VoiceTranscriptEntry, WORKER_OWNED_NOT_FOUND_MIGRATION_ID, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatBytes, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getDeepSpaceAIModel, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, installClientErrorReporter, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, listDeepSpaceAgentModels, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, reportClientError, resetEnvironmentCache, resolveDeepSpaceAgentModel, serverBuild, shouldGroupMessages, signIn, signOut, storageLimitForTier, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthStatus, useAuthUser, useCanvas, useChannelMembers, useChannels, useCheckout, useCommunities, useConversation, useConversations, useCronMonitor, useDisplayName, useGameRoom, useInbox, useIsDarkTheme, useJobs, useMessages, useMutations, usePagedResource, usePlatform, usePlatformWS, usePosts, usePresence, usePresenceRoom, useQuery, useR2Files, useReactions, useReadReceipts, useRecordContext, useSession, useSubscription, useUser, useUserLookup, useUsers, useVoiceAgent, useYjsField, useYjsRoom, useYjsText, validateAppMigrationIds, writeVarUint, writeVarUint8Array };
+export { ACCOUNT_STORAGE_LIMIT_BYTES, APP_LOG_EVENT_KEYS, ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppMigrationIdsValidation, type AsyncResourceDefaults, type AsyncResourceState, type AsyncResourceStatus, AuthGate, type AuthGateProps, AuthOverlay, Awareness, type AwarenessState, type AwarenessStates, type BaseMessage, type CanvasShapeClient, type Channel, type ChannelInvitation, type ChannelMember, type ChargeOnceOpts, type ChargeOnceResult, type ClientErrorKind, type ClientErrorReport, type ClientErrorReporterOptions, type ClientMessage, type CollectionSchema, type ConnectionAttachment, type ConnectionStatus, type ContentSegment, type ConversationObject, type CronHistoryEntry, type CronTaskState, DEEPSPACE_AGENT_PROFILES, DEEPSPACE_AI_DEFAULTS, DEEPSPACE_AI_MODELS, DEEPSPACE_MODEL_CATALOG_PROVENANCE, DEEPSPACE_THEME_PROPERTIES, DEFAULT_USER_COLORS, type DeepSpaceAIModel, type DeepSpaceAIModelId, type DeepSpaceAIProvider, type DeepSpaceAgentProfile, type DeepSpaceAgentProfileId, type DeepSpaceAgentSupport, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FileAttachment, type GroupedReaction, GuestBanner, type HandlerContext, type InboxEntry, type IntegrationResponse, type JobStatusView, type JobView, LOG_LEVELS, type LinkPreviewData, type LoadState, type LoadStateAuthInput, type LoadStateStatusInput, type LogLevel, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MemberRecord, type Message, type MessageHandlers, type MessageRecord, type MsgType, type PagedResourceFetchArgs, type PagedResourcePage, type PagedResourceState, type PagedResourceStatus, type PlanInfo, PlatformContext, type PlatformContextValue, PlatformProvider, type PlatformWSOptions, type PlatformWSResult, type PresencePeerClient, PricingTable, type PricingTablePlan, type PricingTablePrice, type ProductChargeOpts, type ProtocolMessage, type Purchase, type Query, type R2FileInfo, type R2Scope, type R2UploadResult, ROLES, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_CONFIG, ROLE_DEFAULT, type Reaction, type ReactionRecord, type ReadCursorRecord, type ReadReceipt, type RecordData, RecordProvider, type RecordProviderProps, RecordScope, type RequestOptions, type ResolvedDeepSpaceAgentModel, type Role, type RoomUser, type ScopeEntry, ScopeRegistryProvider, type ServerMessage, SignedIn, SignedOut, type SubscribeOpts, type SubscribeResult, type SubscriptionState, type SubscriptionStatus, type SyncResult, type UseAsyncResourceOptions, type UseAuthProfileReadyOptions, type UseAuthStatusOptions, type UseCanvasResult, type UseCheckoutOpts, type UseCronMonitorResult, type UseJobsResult, type UsePagedResourceOptions, type UsePresenceRoomResult, type UseR2FilesReturn, type UseVoiceAgentOptions, type UseVoiceAgentResult, type UseYjsFieldResult, type UseYjsRoomResult, type UseYjsTextResult, type User, type UserCredits, type UserInfo, type UserKarma, type UserProfile, type ViewportClient, type VoiceStatus, type VoiceTranscriptEntry, WORKER_OWNED_NOT_FOUND_MIGRATION_ID, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatBytes, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getDeepSpaceAIModel, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, installClientErrorReporter, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, listDeepSpaceAgentModels, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, reportClientError, resetEnvironmentCache, resolveDeepSpaceAgentModel, serverBuild, shouldGroupMessages, signIn, signOut, storageLimitForTier, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthStatus, useAuthUser, useCanvas, useChannelMembers, useChannels, useCheckout, useCommunities, useConversation, useConversations, useCronMonitor, useDisplayName, useInbox, useIsDarkTheme, useJobs, useMessages, useMutations, usePagedResource, usePlatform, usePlatformWS, usePosts, usePresence, usePresenceRoom, useQuery, useR2Files, useReactions, useReadReceipts, useRecordContext, useSession, useSubscription, useUser, useUserLookup, useUsers, useVoiceAgent, useYjsField, useYjsRoom, useYjsText, validateAppMigrationIds, writeVarUint, writeVarUint8Array };