deepspace 0.6.2 → 0.7.0

package/dist/index.d.ts

@@ -4641,4 +4641,127 @@ interface UseCheckoutReturn {
 }
 declare function useCheckout(opts?: UseCheckoutOpts): UseCheckoutReturn;
 
-export { ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, 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 ClientMessage, type CollectionSchema, type ConnectionAttachment, type ConnectionStatus, type ContentSegment, type ConversationObject, type CronHistoryEntry, type CronTaskState, DEEPSPACE_THEME_PROPERTIES, DEFAULT_USER_COLORS, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FetchUserProfile, type FileAttachment, type GamePlayer, type GroupedReaction, GuestBanner, type HandlerContext, type InboxEntry, type IntegrationResponse, type JobStatusView, type JobView, type LinkPreviewData, type LoadState, type LoadStateAuthInput, type LoadStateStatusInput, 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 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 UseAuthReadyOptions, 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, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, resetEnvironmentCache, serverBuild, shouldGroupMessages, signIn, signOut, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthReady, 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, writeVarUint, writeVarUint8Array };
+/**
+ * Client-side error reporter (opt-in) — the browser half of client-side error
+ * reporting.
+ *
+ *   // src/main.tsx (or your root)
+ *   import { installClientErrorReporter } from 'deepspace'
+ *   installClientErrorReporter()
+ *
+ * Hooks `window` 'error' + 'unhandledrejection' and forwards each to the app's
+ * own Worker (see `registerClientErrorRoute` in 'deepspace/worker'), where it
+ * lands in Workers Logs and shows up in `deepspace logs` tagged CLIENT.
+ *
+ * Best-effort by contract: it dedupes, caps how many it sends per page load,
+ * and NEVER throws — a broken reporter must not break the app it watches.
+ */
+interface ClientErrorReporterOptions {
+    /** Override the ingestion path (default `/_deepspace/client-errors`). */
+    endpoint?: string;
+    /** Max reports sent per page load — a runaway loop can't flood (default 50). */
+    maxReports?: number;
+}
+/**
+ * Install global handlers that forward uncaught browser errors to the app's
+ * Worker. No-op outside a browser. Returns an uninstall function.
+ */
+declare function installClientErrorReporter(options?: ClientErrorReporterOptions): () => void;
+/**
+ * Manually report a caught error — e.g. from a React error boundary's
+ * `componentDidCatch`. No-op outside a browser; never throws. Unlike the
+ * auto-installed handlers this has no client-side dedupe/cap — it relies on the
+ * ingestion route's per-isolate throttle — so call it from boundaries (which
+ * unmount rather than loop), not a hot path.
+ */
+declare function reportClientError(error: unknown, options?: ClientErrorReporterOptions & {
+    componentStack?: string;
+}): void;
+
+type ClientErrorKind = 'error' | 'unhandledrejection' | 'react';
+/** A sanitized, capped browser-error report — the wire + log-line payload. */
+interface ClientErrorReport {
+    kind: ClientErrorKind;
+    message: string;
+    name?: string;
+    stack?: string;
+    /** Page URL where it fired (href or the script filename). */
+    url?: string;
+    line?: number;
+    col?: number;
+}
+
+/**
+ * `deepspace logs` wire DTO — the single source of truth for the whitelisted
+ * shape the platform telemetry reader emits and every consumer reads.
+ *
+ * The producer is `platform/deploy-worker/src/lib/workers-logs.ts` (which
+ * rebuilds each event field-by-field from a raw Cloudflare row — see the
+ * security invariant there). The consumers are the CLI tail
+ * (`cli/commands/logs.ts`), the dashboard Logs panel
+ * (`apps/dashboard/src/lib/types.ts`), and the e2e whitelist assertion
+ * (`tests/e2e/tests/logs.spec.ts`). This module used to be hand-mirrored in
+ * all four places; `source` was added to three of them and missed in the
+ * e2e whitelist, so it now lives here once and they import it.
+ *
+ * Isomorphic — no DOM, no Hono, no platform types — so it re-exports cleanly
+ * from both `deepspace` (client) and `deepspace/worker` and is safe to import
+ * from the private deploy-worker.
+ */
+declare const LOG_LEVELS: readonly ["debug", "log", "info", "warn", "error"];
+type LogLevel = (typeof LOG_LEVELS)[number];
+/** One log / request / exception event, rebuilt field-by-field from a CF row. */
+interface AppLogEvent {
+    /** `$metadata.id` — unique per event; the client's dedupe key. */
+    id: string;
+    /** Unix ms. */
+    timestamp: number;
+    level: LogLevel;
+    eventType: 'log' | 'request' | 'exception' | 'other';
+    message: string;
+    /**
+     * Present (= `'client'`) only for a browser-forwarded error the app's own
+     * Worker re-logged via `registerClientErrorRoute`. Absent means the log was
+     * emitted server-side — there is no explicit `'server'` value, so consumers
+     * branch on `source === 'client'`, never on a truthy/other check.
+     */
+    source?: 'client';
+    /** Invocation outcome (`ok`, `exception`, `exceededCpu`, …) when present. */
+    outcome?: string;
+    request?: {
+        method: string;
+        path: string;
+        status?: number;
+    };
+    exception?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+}
+interface AppLogsResponse {
+    /** Ascending by timestamp (CF returns newest-first; the reader flips). */
+    events: AppLogEvent[];
+    /** Max event timestamp in ms — pass back as `since` to poll; null when empty. */
+    cursor: number | null;
+    /** True when the window returned `limit` events (older events were cut). */
+    truncated: boolean;
+    pollIntervalMs: number;
+}
+/**
+ * Runtime tuple of every key a whitelisted `AppLogEvent` may carry — the
+ * canonical whitelist the e2e suite mirrors when asserting no event leaks a key
+ * outside this set. The two type-level assertions below fail compilation if
+ * this tuple and the `AppLogEvent` interface disagree in either direction, so
+ * adding an interface field forces a matching key here.
+ *
+ * NOTE: the e2e spec keeps its OWN copy of this set (it can't import the SDK —
+ * `@deepspace/e2e` has no `deepspace` dependency), kept in step by a comment,
+ * not by these compile-time guards. So this tuple hardens the code copies
+ * (deploy-worker/CLI/dashboard, which import it), while the e2e mirror remains a
+ * knowingly-accepted duplicate.
+ */
+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 { APP_LOG_EVENT_KEYS, ASYNC_RESOURCE_DEFAULTS, type AdHocChargeOpts, type AiStreamAction, type AiStreamChunk, type AppLogEvent, type AppLogEventKey, type AppLogsResponse, 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_THEME_PROPERTIES, DEFAULT_USER_COLORS, DeepSpaceAuthProvider, type DeepSpaceThemeConfig, DeepSpaceThemeProvider, type DeepSpaceThemeProviderProps, type DeriveLoadStateInput, ENV, type Environment, type FetchUserProfile, 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 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 UseAuthReadyOptions, 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, type WriteError, applyDeepSpaceTheme, applyUIThemeTokens, authClient, canAutoLoadPagedResource, clampPagedResourceItems, clearAuthToken, clearDeepSpaceTheme, clientBuild, createDecoder, createEncoder, decodeAiStreamChunk, deriveLoadState, detectEnvironment, dispatch, encode, encodeAwarenessMessage, encodeSyncStep1, encodeSyncStep2, encodeUpdate, formatFileSize, formatFullTimestamp, formatMessageTime, getApiUrl, getAuthToken, getAuthUrl, getConversationDisplayName, getConversationParticipantIds, getEnvironmentConfig, getMessageType, getPagedResourceCooldownMs, getPlatformWorkerUrl, getThreadCounts, getUserColor, groupReactionsForMessage, handleAwarenessMessage, handleSyncMessage, hasContent, installClientErrorReporter, integration, isAsyncResourceSlow, isDMConversation, isDarkColor, isImageFile, isLocalDev, isProduction, parseMessageMetadata, parseSseLine, readThemeFromDOM, readVarUint, readVarUint8Array, reportClientError, resetEnvironmentCache, serverBuild, shouldGroupMessages, signIn, signOut, toConnectionStatus, toUint8Array, useAsyncResource, useAuth, useAuthProfileReady, useAuthReady, 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, writeVarUint, writeVarUint8Array };

package/dist/index.js

@@ -6031,7 +6031,152 @@ function useCheckout(opts) {
     refresh
   };
 }
+
+// src/shared/client-errors.ts
+var CLIENT_ERROR_PATH = "/_deepspace/client-errors";
+var CLIENT_ERROR_CAPS = {
+  message: 1024,
+  stack: 4096,
+  name: 256,
+  url: 512
+};
+function capText(value, max) {
+  if (typeof value !== "string") return void 0;
+  return value.length > max ? value.slice(0, max) : value;
+}
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function normalizeClientErrorReport(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const o = raw;
+  const kind = o.kind === "unhandledrejection" || o.kind === "react" ? o.kind : "error";
+  const message = capText(o.message, CLIENT_ERROR_CAPS.message) ?? "";
+  const name = capText(o.name, CLIENT_ERROR_CAPS.name);
+  const stack = capText(o.stack, CLIENT_ERROR_CAPS.stack);
+  const url = capText(o.url, CLIENT_ERROR_CAPS.url);
+  const line = finiteNumber(o.line);
+  const col = finiteNumber(o.col);
+  if (!message && !stack) return null;
+  const report = { kind, message: message || (name ?? "Error") };
+  if (name) report.name = name;
+  if (stack) report.stack = stack;
+  if (url) report.url = url;
+  if (line !== void 0) report.line = line;
+  if (col !== void 0) report.col = col;
+  return report;
+}
+
+// src/client/errors.ts
+function stripQuery(u) {
+  if (!u) return void 0;
+  try {
+    const parsed = new URL(u, window.location?.href);
+    return parsed.origin + parsed.pathname;
+  } catch {
+    return void 0;
+  }
+}
+function post(endpoint, report) {
+  try {
+    void fetch(endpoint, {
+      method: "POST",
+      keepalive: true,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(report)
+    }).catch(() => {
+    });
+  } catch {
+  }
+}
+var installed = false;
+function installClientErrorReporter(options = {}) {
+  if (typeof window === "undefined" || installed) return () => {
+  };
+  installed = true;
+  const endpoint = options.endpoint ?? CLIENT_ERROR_PATH;
+  const maxReports = options.maxReports ?? 50;
+  const seen = /* @__PURE__ */ new Set();
+  let sent = 0;
+  const send = (raw) => {
+    const report = normalizeClientErrorReport(raw);
+    if (!report) return;
+    const key = `${report.kind}:${report.name ?? ""}:${report.message}`;
+    if (seen.has(key)) return;
+    if (sent >= maxReports) return;
+    seen.add(key);
+    sent += 1;
+    post(endpoint, report);
+  };
+  const onError = (event) => {
+    try {
+      const err = event.error;
+      send({
+        kind: "error",
+        name: err?.name,
+        message: err?.message ?? event.message,
+        stack: err?.stack,
+        url: stripQuery(event.filename || window.location?.href),
+        line: event.lineno,
+        col: event.colno
+      });
+    } catch {
+    }
+  };
+  const onRejection = (event) => {
+    try {
+      const reason = event.reason;
+      const isError = reason instanceof Error;
+      send({
+        kind: "unhandledrejection",
+        name: isError ? reason.name : void 0,
+        message: isError ? reason.message : String(reason),
+        stack: isError ? reason.stack : void 0,
+        url: stripQuery(window.location?.href)
+      });
+    } catch {
+    }
+  };
+  window.addEventListener("error", onError);
+  window.addEventListener("unhandledrejection", onRejection);
+  return () => {
+    window.removeEventListener("error", onError);
+    window.removeEventListener("unhandledrejection", onRejection);
+    installed = false;
+  };
+}
+function reportClientError(error, options = {}) {
+  if (typeof window === "undefined") return;
+  try {
+    const isError = error instanceof Error;
+    const report = normalizeClientErrorReport({
+      kind: "react",
+      name: isError ? error.name : void 0,
+      message: isError ? error.message : String(error),
+      stack: (isError ? error.stack : void 0) ?? options.componentStack,
+      url: stripQuery(window.location?.href)
+    });
+    if (!report) return;
+    post(options.endpoint ?? CLIENT_ERROR_PATH, report);
+  } catch {
+  }
+}
+
+// src/shared/log-events.ts
+var LOG_LEVELS = ["debug", "log", "info", "warn", "error"];
+var APP_LOG_EVENT_KEYS = [
+  "id",
+  "timestamp",
+  "level",
+  "eventType",
+  "message",
+  "source",
+  "outcome",
+  "request",
+  "exception"
+];
 export {
+  APP_LOG_EVENT_KEYS,
   ASYNC_RESOURCE_DEFAULTS,
   AuthGate,
   AuthOverlay,
@@ -6042,6 +6187,7 @@ export {
   DeepSpaceThemeProvider,
   ENV,
   GuestBanner,
+  LOG_LEVELS,
   MSG,
   MSG_AWARENESS,
   MSG_SYNC,
@@ -6100,6 +6246,7 @@ export {
   handleAwarenessMessage,
   handleSyncMessage,
   hasContent,
+  installClientErrorReporter,
   integration,
   isAsyncResourceSlow,
   isDMConversation,
@@ -6112,6 +6259,7 @@ export {
   readThemeFromDOM,
   readVarUint,
   readVarUint8Array,
+  reportClientError,
   resetEnvironmentCache,
   serverBuild,
   shouldGroupMessages,