deepspace 0.4.4 → 0.5.0

package/dist/server.d.ts

@@ -488,10 +488,10 @@ interface CronContext {
         query(collection: string, opts?: {
             where?: Record<string, unknown>;
             limit?: number;
-        }): Promise<any[]>;
-        create(collection: string, data: Record<string, unknown>): Promise<any>;
-        update(collection: string, recordId: string, data: Record<string, unknown>): Promise<any>;
-        delete(collection: string, recordId: string): Promise<any>;
+        }): Promise<unknown[]>;
+        create(collection: string, data: Record<string, unknown>): Promise<unknown>;
+        update(collection: string, recordId: string, data: Record<string, unknown>): Promise<unknown>;
+        delete(collection: string, recordId: string): Promise<unknown>;
     };
     /**
      * Call a platform integration endpoint (e.g. "openai/chat-completion",
@@ -499,7 +499,7 @@ interface CronContext {
      * APP_OWNER_JWT the rest of the SDK uses for server-side billed calls.
      */
     integrations: {
-        call(endpoint: string, params?: Record<string, unknown>): Promise<any>;
+        call(endpoint: string, params?: Record<string, unknown>): Promise<unknown>;
     };
     /** App owner's user ID */
     ownerUserId: string;
@@ -1390,7 +1390,7 @@ declare abstract class BaseRoom<E = Record<string, unknown>> {
     fetch(request: Request): Promise<Response>;
     private handleWebSocketUpgrade;
     webSocketMessage(ws: WebSocket, message: ArrayBuffer | string): Promise<void>;
-    webSocketClose(ws: WebSocket, code: number, reason: string): Promise<void>;
+    webSocketClose(ws: WebSocket, _code: number, _reason: string): Promise<void>;
     webSocketError(ws: WebSocket, error: unknown): Promise<void>;
     alarm(): Promise<void>;
     /**
@@ -1398,7 +1398,7 @@ declare abstract class BaseRoom<E = Record<string, unknown>> {
      * Return an augmented attachment to serialize on the WebSocket,
      * or void to use the default attachment.
      */
-    protected onConnect(ws: WebSocket, user: UserAttachment): UserAttachment | void | Promise<UserAttachment | void>;
+    protected onConnect(_ws: WebSocket, _user: UserAttachment): UserAttachment | void | Promise<UserAttachment | void>;
     /**
      * Called for each parsed JSON message.
      */
@@ -1413,7 +1413,7 @@ declare abstract class BaseRoom<E = Record<string, unknown>> {
     /**
      * Called when a WebSocket disconnects.
      */
-    protected onDisconnect(ws: WebSocket, user: UserAttachment): void | Promise<void>;
+    protected onDisconnect(_ws: WebSocket, _user: UserAttachment): void | Promise<void>;
     /**
      * Called for HTTP requests that are NOT WebSocket upgrades.
      */
@@ -1670,7 +1670,6 @@ declare class SchemaRegistry {
     registerTrusted(schema: CollectionSchema): void;
     get(name: string): CollectionSchema | undefined;
     has(name: string): boolean;
-    hasTrusted(name: string): boolean;
     all(): CollectionSchema[];
     names(): string[];
 }
@@ -1742,6 +1741,12 @@ declare class RecordRoom<E = Record<string, unknown>> extends BaseRoom<E> {
     private ownerUserId;
     /** True until the first fetch() completes — detects hibernation wake-up */
     private freshConstruct;
+    /**
+     * Per-connection `[DO Perf]` timing logs are noisy on every hot path, so
+     * they're gated behind a `DEEPSPACE_DO_PERF` env binding (set it to any
+     * truthy value on the worker to opt in). Off by default.
+     */
+    private get perfLogEnabled();
     constructor(state: DurableObjectState, env: unknown, schemas?: CollectionSchema[], config?: RecordRoomConfig);
     private getPermissionContext;
     fetch(request: Request): Promise<Response>;
@@ -1754,12 +1759,13 @@ declare class RecordRoom<E = Record<string, unknown>> extends BaseRoom<E> {
     private ensureCollectionTable;
     private ensureAllCollectionTables;
     protected onConnect(ws: WebSocket, user: UserAttachment): Promise<ConnectionAttachment>;
-    protected onMessage(ws: WebSocket, user: UserAttachment, msg: {
-        type: string;
-        [key: string]: unknown;
-    }): Promise<void>;
-    protected onBinaryMessage(ws: WebSocket, user: UserAttachment, data: ArrayBuffer): Promise<void>;
-    protected onDisconnect(ws: WebSocket, user: UserAttachment): void;
+    /**
+     * Required to satisfy BaseRoom's abstract contract, but never invoked:
+     * RecordRoom overrides `webSocketMessage`/`webSocketClose` directly (below),
+     * so the BaseRoom dispatch path that would call this never runs. All real
+     * message handling lives in `handleRecordMessage`.
+     */
+    protected onMessage(): void;
     webSocketMessage(ws: WebSocket, message: ArrayBuffer | string): Promise<void>;
     webSocketClose(ws: WebSocket, code: number, reason: string): Promise<void>;
     webSocketError(ws: WebSocket, error: unknown): Promise<void>;
@@ -1803,12 +1809,12 @@ declare class YjsRoom<E = Record<string, unknown>> extends BaseRoom<E> {
     private getDoc;
     private persistDoc;
     protected onConnect(ws: WebSocket, user: UserAttachment): YjsAttachment;
-    protected onMessage(ws: WebSocket, user: UserAttachment, message: {
+    protected onMessage(_ws: WebSocket, _user: UserAttachment, _message: {
         type: string;
         [key: string]: unknown;
     }): void;
     protected onBinaryMessage(ws: WebSocket, user: UserAttachment, data: ArrayBuffer): void;
-    protected onDisconnect(ws: WebSocket, user: UserAttachment): void;
+    protected onDisconnect(ws: WebSocket, _user: UserAttachment): void;
     private handleSync;
     private handleAwareness;
     private readAwarenessUpdates;
@@ -1890,13 +1896,13 @@ declare abstract class GameRoom<E = Record<string, unknown>> extends BaseRoom<E>
      */
     protected abstract onTick(state: Record<string, unknown>, inputs: GameInput[], tick: number): Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined>;
     /** Called when a player connects */
-    protected onPlayerJoin(player: Player): void;
+    protected onPlayerJoin(_player: Player): void;
     /** Called when a player disconnects */
-    protected onPlayerLeave(player: Player): void;
+    protected onPlayerLeave(_player: Player): void;
     /** Called when the game starts */
     protected onGameStart(): void;
     /** Called when the game ends */
-    protected onGameEnd(finalState: Record<string, unknown>): void;
+    protected onGameEnd(_finalState: Record<string, unknown>): void;
     /**
      * Called once when the DO first hydrates persisted state from storage.
      * Receives the parsed state blob as it was written by a previous build.
@@ -2096,49 +2102,6 @@ declare abstract class CronRoom<E = Record<string, unknown>> extends BaseRoom<E>
     protected abstract onTask(taskName: string): void | Promise<void>;
 }
 
-interface SecretMetadata {
-    name: string;
-    version: number;
-    createdAt: string;
-    updatedAt: string;
-    updatedBy: string | null;
-}
-declare class SecretsRoom<E extends {
-    APP_SECRETS_KEY?: string;
-} = {
-    APP_SECRETS_KEY?: string;
-}> extends BaseRoom<E> {
-    private initialized;
-    protected onMessage(_ws: WebSocket, _user: UserAttachment, _message: {
-        type: string;
-    }): void;
-    fetch(request: Request): Promise<Response>;
-    protected onRequest(request: Request): Promise<Response>;
-    list(): Promise<SecretMetadata[]>;
-    pull(): Promise<Record<string, string>>;
-    patch(body: {
-        set?: Record<string, string>;
-        delete?: string[];
-        updatedBy?: string;
-    }): Promise<{
-        version: number;
-        secrets: SecretMetadata[];
-    }>;
-    replace(body: {
-        secrets?: Record<string, string>;
-        updatedBy?: string;
-    }): Promise<{
-        version: number;
-        secrets: SecretMetadata[];
-    }>;
-    private transaction;
-    private migrateLegacyProductionSecrets;
-    private ensureInitialized;
-    private requireKey;
-    private storeVersion;
-    private bumpStoreVersion;
-}
-
 /**
  * JobRoom — Per-app durable background-job execution Durable Object.
  *
@@ -2440,7 +2403,7 @@ declare const ALLOWED_BINDING_TYPES: Set<string>;
  *
  * Includes:
  *   - Static-asset + service bindings the platform sets up automatically.
- *   - SDK-managed env (auth, identity, owner JWT, app-secret encryption root).
+ *   - SDK-managed env (auth, identity, owner JWT).
  *   - The auto-attached cost-tracking AE dataset (`USAGE_EVENTS`).
  *
  * DO binding names (RECORD_ROOMS, YJS_ROOMS, etc.) are NOT in this set
@@ -3048,8 +3011,7 @@ interface VerifiedAuth {
     userId: string;
     claims: JwtClaims;
 }
-interface VerifyResult extends VerifiedAuth {
-}
+type VerifyResult = VerifiedAuth;
 interface TokenDebugInfo {
     iss?: string | null;
     aud?: string | string[] | null;
@@ -3956,47 +3918,6 @@ declare function createDeepSpaceAuth(config: DeepSpaceAuthConfig): better_auth.A
 }>;
 type DeepSpaceAuth = ReturnType<typeof createDeepSpaceAuth>;
 
-interface SecretsEnv {
-    SECRETS_ROOMS?: DurableObjectNamespace;
-    APP_SECRETS_KEY?: string;
-    APP_SECRETS_LOCAL_FALLBACK?: string;
-}
-interface SecretRefreshResult {
-    changed: boolean;
-    version: number;
-}
-interface WithFreshSecretsContext {
-    secrets: SecretsClient;
-    attempt: number;
-    refreshed: boolean;
-}
-interface WithFreshSecretsOptions {
-    /**
-     * By default the operation retries only when a forced refresh observes a
-     * changed secret version after an auth-like failure. Set this for idempotent
-     * operations that should retry after a successful refresh even when the
-     * version is unchanged.
-     */
-    retryWhenUnchanged?: boolean;
-}
-interface SecretsClient {
-    get(name: string): Promise<string | undefined>;
-    require(name: string): Promise<string>;
-    getMany(names: string[]): Promise<Record<string, string | undefined>>;
-    preload(names: string[]): Promise<void>;
-    refresh(options?: {
-        force?: boolean;
-    }): Promise<SecretRefreshResult>;
-    checkForUpdates(): Promise<SecretRefreshResult>;
-    invalidate(): void;
-    withFreshSecrets<T>(operation: (ctx: WithFreshSecretsContext) => Promise<T>, options?: WithFreshSecretsOptions): Promise<T>;
-}
-interface CreateSecretsOptions {
-    refreshIntervalMs?: number;
-    now?: () => number;
-}
-declare function createSecrets(env: SecretsEnv, options?: CreateSecretsOptions): SecretsClient;
-
 /**
  * Subscription primitives shared between client (useSubscription hook) and
  * server (requireSubscription helper). Pulled into a shared module so the
@@ -4150,4 +4071,4 @@ declare class RefundError extends Error {
     constructor(message: string, status: number);
 }
 
-export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_NAME_RULES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CONVERSATION_SCHEMAS, COST_RATES, CancelSubscriptionError, type CancelSubscriptionOpts, type CancelSubscriptionResult, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConvMemberData, type ConvMessageData, type ConvReactionData, type ConvReadCursorData, type ConvVoteData, type ConversationStateData, type CreateSecretsOptions, type CronContext, type CronExecution, CronRoom, type CronRoomConfig, type CronTask, type CustomBinding, type CustomBindingManifest, DEFAULT_CONTEXT_CONFIG, DEFAULT_DO_MANIFEST, DEFAULT_QUERY_LIMIT, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, type DebugApiContext, type DeepSpaceAIEnv, type DeepSpaceAIOptions, type DeepSpaceAuth, type DeepSpaceAuthConfig, type DirectoryCommunityData, type DirectoryConversationData, type DirectoryMembershipData, type DirectoryPostData, type DoMigrationDirective, type DoMigrationPlan, type ExistingDOBinding, GLOBAL_DO_TYPES, GLOBAL_DO_TYPE_NAMES, type GameInput, GameRoom, type GameRoomConfig, type GetActionData, type GlobalDOType, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, MESSAGES_SCHEMA, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlanInfo, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, type RecordContext, RecordRoom, type RecordRoomConfig, RefundError, type RefundOpts, type RefundResult, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, SYSTEM_COLLECTION_SCHEMAS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotOptions, type ScreenshotResult, type SecretMetadata, type SecretRefreshResult, type SecretsClient, type SecretsEnv, SecretsRoom, type SharedConnection, type StoredRecord, SubscriptionAuthError, type SubscriptionContext, type SubscriptionRead, SubscriptionRequiredError, type SubscriptionStatus, type Summarizer, type TokenDebugInfo, type ToolResult, type ToolSchema, type ToolsApiContext, USERS_COLUMNS, type User, type UserAttachment, type UserContext, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, type WithFreshSecretsContext, type WithFreshSecretsOptions, type YjsContext, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, broadcastChange, broadcastYjsUpdate, buildCronContext, buildTableSelect, buildUiParts, canCreate, canDelete, canRead, canUpdate, cancelSubscription, capToolResultSize, captureScreenshot, checkFieldPermissions, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDeepSpaceAI, createDeepSpaceAuth, createScopedR2Handler, createSecrets, dataToColumnValues, decodeJwtPayload, deleteChatCascade, deleteRecord, enqueueJob, executeQuery, getAllUsers, getChat, getGlobalDOSchemas, getGlobalDOType, getOrCreateYjsDoc, getRecord, getRolePermissions, getSubscription, getUser, getYjsDocKey, handleApiRequest, handleDelete, handlePut, handleSetRole, handleSubscribe, handleToolsRequest, handleUnsubscribe, handleUserList, handleUserUpdate, handleYjsBinaryMessage, handleYjsJoin, handleYjsLeave, isAutoProvision, isOwner, lintSchema, loadMessages, makeDefaultSummarizer, meterAi, meterUsage, meterVectorize, noopPermissionContext, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, putRecord, readRecord, recordMatchesSubscription, refundInvoice, registerUser, requireSubscription, resolveAppName, resolveColumn, rowToData, runMigrations, saveYjsDoc, timingSafeEqualHex, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema };
+export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_NAME_RULES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CONVERSATION_SCHEMAS, COST_RATES, CancelSubscriptionError, type CancelSubscriptionOpts, type CancelSubscriptionResult, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConvMemberData, type ConvMessageData, type ConvReactionData, type ConvReadCursorData, type ConvVoteData, type ConversationStateData, type CronContext, type CronExecution, CronRoom, type CronRoomConfig, type CronTask, type CustomBinding, type CustomBindingManifest, DEFAULT_CONTEXT_CONFIG, DEFAULT_DO_MANIFEST, DEFAULT_QUERY_LIMIT, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, type DebugApiContext, type DeepSpaceAIEnv, type DeepSpaceAIOptions, type DeepSpaceAuth, type DeepSpaceAuthConfig, type DirectoryCommunityData, type DirectoryConversationData, type DirectoryMembershipData, type DirectoryPostData, type DoMigrationDirective, type DoMigrationPlan, type ExistingDOBinding, GLOBAL_DO_TYPES, GLOBAL_DO_TYPE_NAMES, type GameInput, GameRoom, type GameRoomConfig, type GetActionData, type GlobalDOType, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, MESSAGES_SCHEMA, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlanInfo, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, type RecordContext, RecordRoom, type RecordRoomConfig, RefundError, type RefundOpts, type RefundResult, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, SYSTEM_COLLECTION_SCHEMAS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotOptions, type ScreenshotResult, type SharedConnection, type StoredRecord, SubscriptionAuthError, type SubscriptionContext, type SubscriptionRead, SubscriptionRequiredError, type SubscriptionStatus, type Summarizer, type TokenDebugInfo, type ToolResult, type ToolSchema, type ToolsApiContext, USERS_COLUMNS, type User, type UserAttachment, type UserContext, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, type YjsContext, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, broadcastChange, broadcastYjsUpdate, buildCronContext, buildTableSelect, buildUiParts, canCreate, canDelete, canRead, canUpdate, cancelSubscription, capToolResultSize, captureScreenshot, checkFieldPermissions, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDeepSpaceAI, createDeepSpaceAuth, createScopedR2Handler, dataToColumnValues, decodeJwtPayload, deleteChatCascade, deleteRecord, enqueueJob, executeQuery, getAllUsers, getChat, getGlobalDOSchemas, getGlobalDOType, getOrCreateYjsDoc, getRecord, getRolePermissions, getSubscription, getUser, getYjsDocKey, handleApiRequest, handleDelete, handlePut, handleSetRole, handleSubscribe, handleToolsRequest, handleUnsubscribe, handleUserList, handleUserUpdate, handleYjsBinaryMessage, handleYjsJoin, handleYjsLeave, isAutoProvision, isOwner, lintSchema, loadMessages, makeDefaultSummarizer, meterAi, meterUsage, meterVectorize, noopPermissionContext, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, putRecord, readRecord, recordMatchesSubscription, refundInvoice, registerUser, requireSubscription, resolveAppName, resolveColumn, rowToData, runMigrations, saveYjsDoc, timingSafeEqualHex, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema };