deepspace 0.8.2 → 0.9.0

package/dist/testing.d.ts

@@ -0,0 +1,115 @@
+import * as _playwright_test from '@playwright/test';
+import { BrowserContext, Page, Browser } from '@playwright/test';
+export { expect } from '@playwright/test';
+
+interface MultiplayerUser {
+    context: BrowserContext;
+    page: Page;
+    email: string;
+    name: string;
+    /** Test account user ID, if known from the accounts registry. */
+    userId?: string;
+}
+/**
+ * Fixture function signature. Pass either a count (`users(2)`) or an
+ * array of account names (`users(['Alice', 'Bob'])`). Returns one entry
+ * per requested user.
+ */
+type UsersFixture = (selector: number | string[], options?: {
+    label?: string;
+}) => Promise<MultiplayerUser[]>;
+interface MultiplayerFixtures {
+    users: UsersFixture;
+}
+declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & MultiplayerFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
+
+/**
+ * Account-credential plumbing for the testing module.
+ *
+ * Reads test accounts from `~/.deepspace/test-accounts.json` (the same
+ * file `deepspace test accounts create` writes). Each account has at
+ * minimum `{email, password}`; `name` and `label` are optional.
+ *
+ * Used by the multi-user Playwright fixture in `./fixtures.ts` and is
+ * also exported standalone in case suites want to do their own
+ * orchestration.
+ */
+interface TestAccount {
+    email: string;
+    password: string;
+    name?: string;
+    label?: string | null;
+    id?: string;
+    userId?: string;
+    createdAt?: number;
+}
+/**
+ * Load all test accounts the developer has created. Returns an empty
+ * array if the file doesn't exist yet.
+ */
+declare function loadAllTestAccounts(): TestAccount[];
+/**
+ * Pick `count` test accounts from the local registry, optionally
+ * filtered by `label`. Order-stable: sorted by `createdAt` ascending so
+ * the first test account you created is always the first one returned.
+ *
+ * Throws with a helpful message if not enough accounts exist.
+ */
+declare function pickTestAccounts(count: number, options?: {
+    label?: string;
+}): TestAccount[];
+/**
+ * Find a single account by name. Used by `users(['Alice', 'Bob'])`.
+ * Throws if not found.
+ */
+declare function findTestAccountByName(name: string): TestAccount;
+
+/**
+ * Per-account `storageState` cache for Playwright.
+ *
+ * Better Auth applies a per-IP rate limit on `/api/auth/sign-in/email`
+ * (~5 sign-ins / 60s / endpoint). A multiplayer suite that spins up
+ * 5+ users per spec would hit the limit and start failing in non-obvious
+ * ways. This module signs each account in *once*, persists the
+ * resulting browser cookies + storage to disk, and reuses the file on
+ * subsequent runs.
+ *
+ * Cache layout:
+ *   ~/.deepspace/playwright-states/<sha256(email)>.json
+ *
+ * Validity: a cached file is reused if Playwright successfully loads it
+ * AND the resulting context produces a non-anonymous session on the
+ * target app. If validation fails, we fall back to a fresh sign-in and
+ * overwrite the cache.
+ */
+
+interface EnsureStorageStateOptions {
+    /** Max age of a cached state file before we re-sign-in. Default 7 days. */
+    maxAgeMs?: number;
+    /** Force a fresh sign-in even if the cache is fresh. */
+    force?: boolean;
+}
+/**
+ * Ensure a Playwright `storageState` file exists for `account` and
+ * return its path. Signs in once if the cache is missing, stale, or
+ * `force: true`.
+ */
+declare function ensureStorageState(browser: Browser, account: {
+    email: string;
+    password: string;
+}, baseURL: string, options?: EnsureStorageStateOptions): Promise<string>;
+/**
+ * Convenience: open a fresh `BrowserContext` for `account` using the
+ * cached storage state (signing in if needed). The caller is responsible
+ * for closing the context.
+ */
+declare function newSignedInContext(browser: Browser, account: {
+    email: string;
+    password: string;
+}, baseURL: string, options?: EnsureStorageStateOptions): Promise<BrowserContext>;
+/** Read a cached storageState file (mostly for debugging). */
+declare function readCachedState(email: string): unknown | null;
+/** Where the cache for `email` lives. Useful for diagnostics. */
+declare function getStatePathForEmail(email: string): string;
+
+export { type EnsureStorageStateOptions, type MultiplayerUser, type TestAccount, type UsersFixture, ensureStorageState, findTestAccountByName, getStatePathForEmail, loadAllTestAccounts, newSignedInContext, pickTestAccounts, readCachedState, test };

package/dist/worker.d.ts

@@ -2603,10 +2603,11 @@ declare function parseQuotaLimit(raw: string | undefined, fallback: number): num
  */
 /** The singleton registry instance — one DO holds every app/route/collaborator. */
 declare const REGISTRY_INSTANCE = "v1:global";
-/** App id shape: a ULID-minted `app_…` id, or a legacy name-as-id. */
+/** Public app ids have one canonical ULID-minted shape. */
 declare const APP_ID_RE: RegExp;
-/** ONLY a ULID-minted id — surfaces that must not accept a legacy name. */
 declare const STRICT_APP_ID_RE: RegExp;
+/** Internal physical locators survive identity migration and are not public ids. */
+declare const RESOURCE_ID_RE: RegExp;
 declare class RegistryClientError extends Error {
     readonly code: string;
     readonly status: number;
@@ -3364,6 +3365,7 @@ declare function appendMessage(stub: DurableObjectStub, msg: {
 interface MeteringEnv {
     USAGE_EVENTS?: AnalyticsEngineDataset;
     OWNER_USER_ID?: string;
+    DEEPSPACE_RESOURCE_ID?: string;
     APP_NAME?: string;
 }
 /**
@@ -4880,4 +4882,4 @@ interface AppLogsResponse {
 declare const APP_LOG_EVENT_KEYS: readonly ["id", "timestamp", "level", "eventType", "message", "source", "outcome", "request", "exception"];
 type AppLogEventKey = (typeof APP_LOG_EVENT_KEYS)[number];
 
-export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_ID_RE, APP_LOG_EVENT_KEYS, APP_NAME_RULES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, Awareness, type AwarenessState, type AwarenessStates, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, type BaseMessage, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CLIENT_LOG_MARKER, CONVERSATION_SCHEMAS, COST_RATES, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type ClientErrorKind, type ClientErrorReport, type ClientMessage, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConnectionAttachment, 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, DEPLOYED_APPS_DEFAULTS, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, 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 HandlerContext, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, LOG_LEVELS, type LogLevel, MESSAGES_SCHEMA, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MessageHandlers, type MsgType, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type ProtocolMessage, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, REGISTRY_INSTANCE, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_DEFAULT, RecordRoom, type RecordRoomConfig, RegistryClientError, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, STRICT_APP_ID_RE, SYSTEM_COLLECTIONS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotResult, type ServerMessage, type SharedConnection, type StoredRecord, type Summarizer, type SyncResult, TEST_ACCOUNT_EMAIL_SUFFIX, type TokenDebugInfo, type ToolResult, type ToolSchema, USERS_COLUMNS, type User, type UserAttachment, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, buildCronContext, buildTableSelect, buildUiParts, callRegistry, canCreate, canDelete, canRead, canUpdate, capToolResultSize, captureScreenshot, checkFieldPermissions, clientBuild, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDecoder, createDeepSpaceAI, createDeepSpaceAuth, createEncoder, createScopedR2Handler, dataToColumnValues, decodeJwtPayload, deleteChatCascade, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, enqueueJob, getChat, getGlobalDOSchemas, getGlobalDOType, getMessageType, getRolePermissions, handleAwarenessMessage, handleClientErrorReport, handleSyncMessage, hasContent, isAutoProvision, isOwner, isTestAccountClaims, isTestAccountEmail, isTestAccountTier, lintSchema, loadMessages, makeDefaultSummarizer, matchOrigin, meterAi, meterUsage, meterVectorize, noopPermissionContext, parseQuotaLimit, platformCorsPatterns, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, readVarUint, readVarUint8Array, registerClientErrorRoute, registryErrorJson, registryStub, resolveAppName, resolveColumn, rowToData, runMigrations, serverBuild, timingSafeEqualHex, timingSafeEqualStrings, toUint8Array, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema, writeVarUint, writeVarUint8Array };
+export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_ID_RE, APP_LOG_EVENT_KEYS, APP_NAME_RULES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, Awareness, type AwarenessState, type AwarenessStates, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, type BaseMessage, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CLIENT_LOG_MARKER, CONVERSATION_SCHEMAS, COST_RATES, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type ClientErrorKind, type ClientErrorReport, type ClientMessage, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConnectionAttachment, 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, DEPLOYED_APPS_DEFAULTS, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, 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 HandlerContext, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, LOG_LEVELS, type LogLevel, MESSAGES_SCHEMA, MSG, MSG_AWARENESS, MSG_SYNC, MSG_SYNC_STEP1, MSG_SYNC_STEP2, MSG_SYNC_UPDATE, MSG_YJS_AWARENESS, MSG_YJS_SYNC, type MessageHandlers, type MsgType, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type ProtocolMessage, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, REGISTRY_INSTANCE, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, RESOURCE_ID_RE, ROLE_ADMIN, ROLE_ANONYMOUS, ROLE_DEFAULT, RecordRoom, type RecordRoomConfig, RegistryClientError, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, STRICT_APP_ID_RE, SYSTEM_COLLECTIONS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotResult, type ServerMessage, type SharedConnection, type StoredRecord, type Summarizer, type SyncResult, TEST_ACCOUNT_EMAIL_SUFFIX, type TokenDebugInfo, type ToolResult, type ToolSchema, USERS_COLUMNS, type User, type UserAttachment, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, buildCronContext, buildTableSelect, buildUiParts, callRegistry, canCreate, canDelete, canRead, canUpdate, capToolResultSize, captureScreenshot, checkFieldPermissions, clientBuild, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDecoder, createDeepSpaceAI, createDeepSpaceAuth, createEncoder, createScopedR2Handler, dataToColumnValues, decodeJwtPayload, deleteChatCascade, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, enqueueJob, getChat, getGlobalDOSchemas, getGlobalDOType, getMessageType, getRolePermissions, handleAwarenessMessage, handleClientErrorReport, handleSyncMessage, hasContent, isAutoProvision, isOwner, isTestAccountClaims, isTestAccountEmail, isTestAccountTier, lintSchema, loadMessages, makeDefaultSummarizer, matchOrigin, meterAi, meterUsage, meterVectorize, noopPermissionContext, parseQuotaLimit, platformCorsPatterns, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, readVarUint, readVarUint8Array, registerClientErrorRoute, registryErrorJson, registryStub, resolveAppName, resolveColumn, rowToData, runMigrations, serverBuild, timingSafeEqualHex, timingSafeEqualStrings, toUint8Array, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema, writeVarUint, writeVarUint8Array };

package/dist/worker.js

@@ -5108,6 +5108,8 @@ var RESERVED_BINDING_NAMES = /* @__PURE__ */ new Set([
   "ASSETS",
   "PLATFORM_WORKER",
   "API_WORKER",
+  "DEEPSPACE_APP_ID",
+  "DEEPSPACE_RESOURCE_ID",
   "APP_NAME",
   "OWNER_USER_ID",
   "AUTH_JWT_PUBLIC_KEY",
@@ -5125,7 +5127,9 @@ function validateBindingManifest(manifest) {
   const seenNames = /* @__PURE__ */ new Set();
   for (const entry of manifest) {
     if (!entry || typeof entry !== "object") {
-      errors.push({ reason: `Entry must be an object (got ${entry === null ? "null" : typeof entry})` });
+      errors.push({
+        reason: `Entry must be an object (got ${entry === null ? "null" : typeof entry})`
+      });
       continue;
     }
     const e = entry;
@@ -5174,7 +5178,8 @@ function requiredFieldError(b) {
     case "r2_bucket":
       return b.bucket_name ? null : `r2_bucket binding "${b.name}" missing bucket_name (or "auto")`;
     case "kv_namespace": {
-      if (!b.namespace_id) return `kv_namespace binding "${b.name}" missing namespace_id (or "auto")`;
+      if (!b.namespace_id)
+        return `kv_namespace binding "${b.name}" missing namespace_id (or "auto")`;
       if (b.namespace_id === AUTO_PROVISION_SENTINEL && !b.title) {
         return `kv_namespace binding "${b.name}" with namespace_id="auto" requires "title"`;
       }
@@ -5979,8 +5984,9 @@ function parseQuotaLimit(raw, fallback) {
 
 // src/server/utils/registry-client.ts
 var REGISTRY_INSTANCE = "v1:global";
-var APP_ID_RE = /^(app_[0-9A-HJKMNP-TV-Z]{26}|[a-z0-9][a-z0-9_-]{0,63})$/;
-var STRICT_APP_ID_RE = /^app_[0-9A-HJKMNP-TV-Z]{26}$/;
+var APP_ID_RE = /^app_[0-9A-HJKMNP-TV-Z]{26}$/;
+var STRICT_APP_ID_RE = APP_ID_RE;
+var RESOURCE_ID_RE = /^(app_[0-9A-HJKMNP-TV-Z]{26}|[a-z0-9][a-z0-9_-]{0,63})$/;
 var RegistryClientError = class extends Error {
   constructor(message, code, status) {
     super(message);
@@ -7034,7 +7040,12 @@ function meterUsage(env, kind, fields = {}) {
   try {
     ds.writeDataPoint({
       indexes: [env.OWNER_USER_ID ?? "unknown"],
-      blobs: [env.APP_NAME ?? "unknown", kind, fields.id ?? "", fields.op ?? ""],
+      blobs: [
+        env.DEEPSPACE_RESOURCE_ID ?? env.APP_NAME ?? "unknown",
+        kind,
+        fields.id ?? "",
+        fields.op ?? ""
+      ],
       doubles: [fields.units ?? 0, fields.count ?? 0]
     });
     return true;
@@ -7591,6 +7602,7 @@ export {
   REGISTRY_INSTANCE,
   RESERVED_BINDING_NAMES,
   RESERVED_COLLECTION_NAMES,
+  RESOURCE_ID_RE,
   ROLE_ADMIN,
   ROLE_ANONYMOUS,
   ROLE_DEFAULT,