spacetimedb 2.5.0 → 2.6.0

package/src/sdk/logger.ts

@@ -1,134 +1,134 @@
-import { stringify as ssStringify } from 'safe-stable-stringify';
-import { u128ToHexString, u256ToHexString } from '../lib/util';
-export type LogLevel = 'info' | 'warn' | 'error' | 'debug' | 'trace';
-
-const LogLevelIdentifierIcon = {
-  component: '📦',
-  info: 'ℹ️',
-  warn: '⚠️',
-  error: '❌',
-  debug: '🐛',
-  trace: '🔍',
-};
-
-const LogStyle = {
-  component:
-    'color: #fff; background-color: #8D6FDD; padding: 2px 5px; border-radius: 3px;',
-  info: 'color: #fff; background-color: #007bff; padding: 2px 5px; border-radius: 3px;',
-  warn: 'color: #fff; background-color: #ffc107; padding: 2px 5px; border-radius: 3px;',
-  error:
-    'color: #fff; background-color: #dc3545; padding: 2px 5px; border-radius: 3px;',
-  debug:
-    'color: #fff; background-color: #28a745; padding: 2px 5px; border-radius: 3px;',
-  trace:
-    'color: #fff; background-color: #17a2b8; padding: 2px 5px; border-radius: 3px;',
-};
-
-const LogTextStyle = {
-  component: 'color: #8D6FDD;',
-  info: 'color: #007bff;',
-  warn: 'color: #ffc107;',
-  error: 'color: #dc3545;',
-  debug: 'color: #28a745;',
-  trace: 'color: #17a2b8;',
-};
-
-const LogLevelRank: Record<LogLevel, number> = {
-  error: 0,
-  warn: 1,
-  info: 2,
-  debug: 3,
-  trace: 4,
-};
-
-let globalLogLevel: LogLevel = 'info';
-
-export const setGlobalLogLevel = (level: LogLevel): void => {
-  globalLogLevel = level;
-};
-
-export const getGlobalLogLevel = (): LogLevel => globalLogLevel;
-
-const shouldLog = (level: LogLevel): boolean =>
-  LogLevelRank[level] <= LogLevelRank[globalLogLevel];
-
-// Lazy can be a function or the actual thing, so we can make verbose logs cheap when disabled.
-type Lazy<T> = T | (() => T);
-const resolveLazy = <T>(v: Lazy<T>): T =>
-  typeof v === 'function' ? (v as () => T)() : v;
-
-const toHex = (bytes: Uint8Array): string =>
-  Array.from(bytes)
-    .map(b => b.toString(16).padStart(2, '0'))
-    .join('');
-const ARRAY_TRUNCATION_THRESHOLD = 25;
-const ARRAY_PREVIEW_COUNT = 10;
-
-const SENSITIVE_KEYS = new Set([
-  'token',
-  'authToken',
-  'authorization',
-  'accessToken',
-  'refreshToken',
-]);
-
-export const stringify = (value: unknown): string | undefined =>
-  ssStringify(value, (key: string, current: unknown) => {
-    if (SENSITIVE_KEYS.has(key)) {
-      return '[REDACTED]';
-    }
-    if (
-      current &&
-      typeof current === 'object' &&
-      '__identity__' in current &&
-      typeof (current as { __identity__: unknown }).__identity__ === 'bigint'
-    ) {
-      return u256ToHexString(
-        (current as { __identity__: bigint }).__identity__
-      );
-    }
-    if (
-      current &&
-      typeof current === 'object' &&
-      '__connection_id__' in current &&
-      typeof (current as { __connection_id__: unknown }).__connection_id__ ===
-        'bigint'
-    ) {
-      return u128ToHexString(
-        (current as { __connection_id__: bigint }).__connection_id__
-      );
-    }
-    if (current instanceof Uint8Array) {
-      if (current.length < 25) {
-        return `0x${toHex(current)}`;
-      }
-      const head = current.subarray(0, 10);
-      return `Uint8Array(len=${current.length}, head=0x${toHex(head)})`;
-    }
-    if (
-      Array.isArray(current) &&
-      current.length >= ARRAY_TRUNCATION_THRESHOLD
-    ) {
-      const head = ssStringify(current.slice(0, ARRAY_PREVIEW_COUNT));
-      return `Array(len=${current.length}, head=${head ?? '[]'})`;
-    }
-    return current;
-  });
-
-export const stdbLogger = (
-  level: LogLevel,
-  message: Lazy<any>,
-  ...args: Lazy<any>
-): void => {
-  if (!shouldLog(level)) {
-    return;
-  }
-  const resolvedMessage = resolveLazy(message);
-  const resolvedArgs = args.map(resolveLazy);
-  console.log(
-    `%c${LogLevelIdentifierIcon[level]} ${level.toUpperCase()}%c ${resolvedMessage}`,
-    LogStyle[level],
-    LogTextStyle[level],
-    ...resolvedArgs
-  );
-};
+import { stringify as ssStringify } from 'safe-stable-stringify';
+import { u128ToHexString, u256ToHexString } from '../lib/util';
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug' | 'trace';
+
+const LogLevelIdentifierIcon = {
+  component: '📦',
+  info: 'ℹ️',
+  warn: '⚠️',
+  error: '❌',
+  debug: '🐛',
+  trace: '🔍',
+};
+
+const LogStyle = {
+  component:
+    'color: #fff; background-color: #8D6FDD; padding: 2px 5px; border-radius: 3px;',
+  info: 'color: #fff; background-color: #007bff; padding: 2px 5px; border-radius: 3px;',
+  warn: 'color: #fff; background-color: #ffc107; padding: 2px 5px; border-radius: 3px;',
+  error:
+    'color: #fff; background-color: #dc3545; padding: 2px 5px; border-radius: 3px;',
+  debug:
+    'color: #fff; background-color: #28a745; padding: 2px 5px; border-radius: 3px;',
+  trace:
+    'color: #fff; background-color: #17a2b8; padding: 2px 5px; border-radius: 3px;',
+};
+
+const LogTextStyle = {
+  component: 'color: #8D6FDD;',
+  info: 'color: #007bff;',
+  warn: 'color: #ffc107;',
+  error: 'color: #dc3545;',
+  debug: 'color: #28a745;',
+  trace: 'color: #17a2b8;',
+};
+
+const LogLevelRank: Record<LogLevel, number> = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3,
+  trace: 4,
+};
+
+let globalLogLevel: LogLevel = 'info';
+
+export const setGlobalLogLevel = (level: LogLevel): void => {
+  globalLogLevel = level;
+};
+
+export const getGlobalLogLevel = (): LogLevel => globalLogLevel;
+
+const shouldLog = (level: LogLevel): boolean =>
+  LogLevelRank[level] <= LogLevelRank[globalLogLevel];
+
+// Lazy can be a function or the actual thing, so we can make verbose logs cheap when disabled.
+type Lazy<T> = T | (() => T);
+const resolveLazy = <T>(v: Lazy<T>): T =>
+  typeof v === 'function' ? (v as () => T)() : v;
+
+const toHex = (bytes: Uint8Array): string =>
+  Array.from(bytes)
+    .map(b => b.toString(16).padStart(2, '0'))
+    .join('');
+const ARRAY_TRUNCATION_THRESHOLD = 25;
+const ARRAY_PREVIEW_COUNT = 10;
+
+const SENSITIVE_KEYS = new Set([
+  'token',
+  'authToken',
+  'authorization',
+  'accessToken',
+  'refreshToken',
+]);
+
+export const stringify = (value: unknown): string | undefined =>
+  ssStringify(value, (key: string, current: unknown) => {
+    if (SENSITIVE_KEYS.has(key)) {
+      return '[REDACTED]';
+    }
+    if (
+      current &&
+      typeof current === 'object' &&
+      '__identity__' in current &&
+      typeof (current as { __identity__: unknown }).__identity__ === 'bigint'
+    ) {
+      return u256ToHexString(
+        (current as { __identity__: bigint }).__identity__
+      );
+    }
+    if (
+      current &&
+      typeof current === 'object' &&
+      '__connection_id__' in current &&
+      typeof (current as { __connection_id__: unknown }).__connection_id__ ===
+        'bigint'
+    ) {
+      return u128ToHexString(
+        (current as { __connection_id__: bigint }).__connection_id__
+      );
+    }
+    if (current instanceof Uint8Array) {
+      if (current.length < 25) {
+        return `0x${toHex(current)}`;
+      }
+      const head = current.subarray(0, 10);
+      return `Uint8Array(len=${current.length}, head=0x${toHex(head)})`;
+    }
+    if (
+      Array.isArray(current) &&
+      current.length >= ARRAY_TRUNCATION_THRESHOLD
+    ) {
+      const head = ssStringify(current.slice(0, ARRAY_PREVIEW_COUNT));
+      return `Array(len=${current.length}, head=${head ?? '[]'})`;
+    }
+    return current;
+  });
+
+export const stdbLogger = (
+  level: LogLevel,
+  message: Lazy<any>,
+  ...args: Lazy<any>
+): void => {
+  if (!shouldLog(level)) {
+    return;
+  }
+  const resolvedMessage = resolveLazy(message);
+  const resolvedArgs = args.map(resolveLazy);
+  console.log(
+    `%c${LogLevelIdentifierIcon[level]} ${level.toUpperCase()}%c ${resolvedMessage}`,
+    LogStyle[level],
+    LogTextStyle[level],
+    ...resolvedArgs
+  );
+};

package/src/sdk/message_types.ts

@@ -1,46 +1,46 @@
-import type { TableUpdate } from './table_cache.ts';
-import type { UntypedTableDef } from '../lib/table.ts';
-import type { ReducerOutcome } from './client_api/types';
-
-export type TransactionUpdateMessage = {
-  tag: 'TransactionUpdate';
-  tableUpdates: TableUpdate<UntypedTableDef>[];
-};
-
-export type SubscribeAppliedMessage = {
-  tag: 'SubscribeApplied';
-  querySetId: number;
-  tableUpdates: TableUpdate<UntypedTableDef>[];
-};
-
-export type UnsubscribeAppliedMessage = {
-  tag: 'UnsubscribeApplied';
-  querySetId: number;
-  tableUpdates: TableUpdate<UntypedTableDef>[];
-};
-
-export type SubscriptionError = {
-  tag: 'SubscriptionError';
-  querySetId: number;
-  error: string;
-};
-
-export type ReducerResultMessage = {
-  tag: 'ReducerResult';
-  requestId: number;
-  result: ReducerOutcome;
-};
-
-export type ProcedureResultMessage = {
-  tag: 'ProcedureResult';
-  requestId: number;
-  result: { tag: 'Ok'; value: Uint8Array } | { tag: 'Err'; value: string };
-};
-
-export type Message =
-  | TransactionUpdateMessage
-  | SubscribeAppliedMessage
-  | UnsubscribeAppliedMessage
-  | SubscriptionError
-  | ReducerResultMessage
-  | ProcedureResultMessage;
+import type { TableUpdate } from './table_cache.ts';
+import type { UntypedTableDef } from '../lib/table.ts';
+import type { ReducerOutcome } from './client_api/types';
+
+export type TransactionUpdateMessage = {
+  tag: 'TransactionUpdate';
+  tableUpdates: TableUpdate<UntypedTableDef>[];
+};
+
+export type SubscribeAppliedMessage = {
+  tag: 'SubscribeApplied';
+  querySetId: number;
+  tableUpdates: TableUpdate<UntypedTableDef>[];
+};
+
+export type UnsubscribeAppliedMessage = {
+  tag: 'UnsubscribeApplied';
+  querySetId: number;
+  tableUpdates: TableUpdate<UntypedTableDef>[];
+};
+
+export type SubscriptionError = {
+  tag: 'SubscriptionError';
+  querySetId: number;
+  error: string;
+};
+
+export type ReducerResultMessage = {
+  tag: 'ReducerResult';
+  requestId: number;
+  result: ReducerOutcome;
+};
+
+export type ProcedureResultMessage = {
+  tag: 'ProcedureResult';
+  requestId: number;
+  result: { tag: 'Ok'; value: Uint8Array } | { tag: 'Err'; value: string };
+};
+
+export type Message =
+  | TransactionUpdateMessage
+  | SubscribeAppliedMessage
+  | UnsubscribeAppliedMessage
+  | SubscriptionError
+  | ReducerResultMessage
+  | ProcedureResultMessage;

package/src/sdk/procedures.ts

@@ -1,83 +1,83 @@
-import type { ParamsObj } from '../lib/reducers';
-import type { Infer, InferTypeOfRow, TypeBuilder } from '../lib/type_builders';
-import type { CamelCase } from '../lib/type_util';
-import { coerceParams, toCamelCase, type CoerceParams } from '../lib/util';
-import type { UntypedRemoteModule } from './spacetime_module';
-
-// Utility: detect 'any'
-type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
-
-// Loose shape that allows all three families even when key names are unknown
-type ProceduresViewLoose = {
-  // call: camelCase(name)
-  [k: string]: (params: any) => Promise<any>;
-};
-
-export type ProceduresView<RemoteModule> = IfAny<
-  RemoteModule,
-  ProceduresViewLoose,
-  RemoteModule extends UntypedRemoteModule
-    ? // x: camelCase(name)
-      {
-        [K in RemoteModule['procedures'][number] as K['accessorName']]: (
-          params: InferTypeOfRow<K['params']>
-        ) => Promise<Infer<K['returnType']>>;
-      }
-    : never
->;
-
-export type UntypedProcedureDef = {
-  name: string;
-  accessorName: string;
-  params: CoerceParams<ParamsObj>;
-  returnType: TypeBuilder<any, any>;
-};
-
-export type UntypedProceduresDef = {
-  procedures: readonly UntypedProcedureDef[];
-};
-
-export function procedures<const H extends readonly UntypedProcedureDef[]>(
-  ...handles: H
-): { procedures: H };
-
-export function procedures<const H extends readonly UntypedProcedureDef[]>(
-  handles: H
-): { procedures: H };
-
-export function procedures<const H extends readonly UntypedProcedureDef[]>(
-  ...args: [H] | H
-): { procedures: H } {
-  const procedures = (
-    args.length === 1 && Array.isArray(args[0]) ? args[0] : args
-  ) as H;
-  return { procedures };
-}
-
-type ProcedureDef<
-  Name extends string,
-  Params extends ParamsObj,
-  ReturnType extends TypeBuilder<any, any>,
-> = {
-  name: Name;
-  accessorName: CamelCase<Name>;
-  params: CoerceParams<Params>;
-  returnType: ReturnType;
-};
-
-export function procedureSchema<
-  ProcedureName extends string,
-  Params extends ParamsObj,
-  ReturnType extends TypeBuilder<any, any>,
->(
-  name: ProcedureName,
-  params: Params,
-  returnType: ReturnType
-): ProcedureDef<ProcedureName, Params, ReturnType> {
-  return {
-    name,
-    accessorName: toCamelCase(name),
-    params: coerceParams(params),
-    returnType,
-  };
-}
+import type { ParamsObj } from '../lib/reducers';
+import type { Infer, InferTypeOfRow, TypeBuilder } from '../lib/type_builders';
+import type { CamelCase } from '../lib/type_util';
+import { coerceParams, toCamelCase, type CoerceParams } from '../lib/util';
+import type { UntypedRemoteModule } from './spacetime_module';
+
+// Utility: detect 'any'
+type IfAny<T, Y, N> = 0 extends 1 & T ? Y : N;
+
+// Loose shape that allows all three families even when key names are unknown
+type ProceduresViewLoose = {
+  // call: camelCase(name)
+  [k: string]: (params: any) => Promise<any>;
+};
+
+export type ProceduresView<RemoteModule> = IfAny<
+  RemoteModule,
+  ProceduresViewLoose,
+  RemoteModule extends UntypedRemoteModule
+    ? // x: camelCase(name)
+      {
+        [K in RemoteModule['procedures'][number] as K['accessorName']]: (
+          params: InferTypeOfRow<K['params']>
+        ) => Promise<Infer<K['returnType']>>;
+      }
+    : never
+>;
+
+export type UntypedProcedureDef = {
+  name: string;
+  accessorName: string;
+  params: CoerceParams<ParamsObj>;
+  returnType: TypeBuilder<any, any>;
+};
+
+export type UntypedProceduresDef = {
+  procedures: readonly UntypedProcedureDef[];
+};
+
+export function procedures<const H extends readonly UntypedProcedureDef[]>(
+  ...handles: H
+): { procedures: H };
+
+export function procedures<const H extends readonly UntypedProcedureDef[]>(
+  handles: H
+): { procedures: H };
+
+export function procedures<const H extends readonly UntypedProcedureDef[]>(
+  ...args: [H] | H
+): { procedures: H } {
+  const procedures = (
+    args.length === 1 && Array.isArray(args[0]) ? args[0] : args
+  ) as H;
+  return { procedures };
+}
+
+type ProcedureDef<
+  Name extends string,
+  Params extends ParamsObj,
+  ReturnType extends TypeBuilder<any, any>,
+> = {
+  name: Name;
+  accessorName: CamelCase<Name>;
+  params: CoerceParams<Params>;
+  returnType: ReturnType;
+};
+
+export function procedureSchema<
+  ProcedureName extends string,
+  Params extends ParamsObj,
+  ReturnType extends TypeBuilder<any, any>,
+>(
+  name: ProcedureName,
+  params: Params,
+  returnType: ReturnType
+): ProcedureDef<ProcedureName, Params, ReturnType> {
+  return {
+    name,
+    accessorName: toCamelCase(name),
+    params: coerceParams(params),
+    returnType,
+  };
+}

package/src/sdk/reducer_event.ts

@@ -1,20 +1,20 @@
-import { Timestamp } from '../';
-import type { ReducerOutcome } from './client_api/types';
-import type { ReducerEventInfo } from './reducers.ts';
-
-export type ReducerEvent<Reducer extends ReducerEventInfo> = {
-  /**
-   * The time when the reducer started running.
-   *
-   * @internal This is a number and not Date, as JSON.stringify with date in it gives number, but JSON.parse of the same string does not give date. TO avoid
-   * confusion in typing we'll keep it a number
-   */
-  timestamp: Timestamp;
-
-  /**
-   * The reducer outcome, including optional return value and updates.
-   */
-  outcome: ReducerOutcome;
-
-  reducer: Reducer;
-};
+import { Timestamp } from '../';
+import type { ReducerOutcome } from './client_api/types';
+import type { ReducerEventInfo } from './reducers.ts';
+
+export type ReducerEvent<Reducer extends ReducerEventInfo> = {
+  /**
+   * The time when the reducer started running.
+   *
+   * @internal This is a number and not Date, as JSON.stringify with date in it gives number, but JSON.parse of the same string does not give date. TO avoid
+   * confusion in typing we'll keep it a number
+   */
+  timestamp: Timestamp;
+
+  /**
+   * The reducer outcome, including optional return value and updates.
+   */
+  outcome: ReducerOutcome;
+
+  reducer: Reducer;
+};

package/src/sdk/reducer_handle.ts

@@ -1,12 +1,12 @@
-export type ReducerHandle<ReducerName extends string> = {
-  /** Phantom reducer name */
-  readonly reducerName?: ReducerName;
-};
-
-export type ReducerNamesFromReducers<R> = R extends object
-  ? {
-      [K in keyof R]: R[K] extends ReducerHandle<infer ReducerName>
-        ? ReducerName
-        : never;
-    }[keyof R]
-  : never;
+export type ReducerHandle<ReducerName extends string> = {
+  /** Phantom reducer name */
+  readonly reducerName?: ReducerName;
+};
+
+export type ReducerNamesFromReducers<R> = R extends object
+  ? {
+      [K in keyof R]: R[K] extends ReducerHandle<infer ReducerName>
+        ? ReducerName
+        : never;
+    }[keyof R]
+  : never;