@radishbot/sdk 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radishbot/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/index.ts

@@ -1,6 +1,6 @@
-import { SdkConnection } from './connection';
+import { SdkConnection } from "./connection";
 
-export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+export type LogLevel = "info" | "warn" | "error" | "debug";
 
 // ── Console capture ──────────────────────────────────────────
 
@@ -15,26 +15,32 @@ const _origConsole = {
 const _flowStack: Flow[] = [];
 
 function _patchConsole() {
-  const capture = (level: LogLevel) => (...args: unknown[]) => {
-    const flow = _flowStack[_flowStack.length - 1];
-    if (flow) {
-      const msg = args.map(a => {
-        if (typeof a === 'string') return a;
-        if (a instanceof Error) return a.message;
-        try { return JSON.stringify(a); } catch { return String(a); }
-      }).join(' ');
-      const data = args.length <= 1 ? undefined
-        : args.length === 2 ? args[1]
-        : args.slice(1);
-      flow.log(msg, data, level);
-    }
-    _origConsole[level === 'info' ? 'log' : level](...args);
-  };
-  console.log = capture('info');
-  console.info = capture('info');
-  console.warn = capture('warn');
-  console.error = capture('error');
-  console.debug = capture('debug');
+  const capture =
+    (level: LogLevel) =>
+    (...args: unknown[]) => {
+      const flow = _flowStack[_flowStack.length - 1];
+      if (flow) {
+        const msg = args
+          .map((a) => {
+            if (typeof a === "string") return a;
+            if (a instanceof Error) return a.message;
+            try {
+              return JSON.stringify(a);
+            } catch {
+              return String(a);
+            }
+          })
+          .join(" ");
+        const data = args.length <= 1 ? undefined : args.length === 2 ? args[1] : args.slice(1);
+        flow.log(msg, data, level);
+      }
+      _origConsole[level === "info" ? "log" : level](...args);
+    };
+  console.log = capture("info");
+  console.info = capture("info");
+  console.warn = capture("warn");
+  console.error = capture("error");
+  console.debug = capture("debug");
 }
 
 function _restoreConsole() {
@@ -46,7 +52,7 @@ function _restoreConsole() {
 }
 
 function serialize(value: unknown): string {
-  if (value === undefined || value === null) return '{}';
+  if (value === undefined || value === null) return "{}";
   if (value instanceof Error)
     return JSON.stringify({
       name: value.name,
@@ -54,9 +60,7 @@ function serialize(value: unknown): string {
       stack: value.stack,
     });
   try {
-    return JSON.stringify(value, (_key, v) =>
-      typeof v === 'bigint' ? v.toString() : v
-    );
+    return JSON.stringify(value, (_key, v) => (typeof v === "bigint" ? v.toString() : v));
   } catch {
     return JSON.stringify({ value: String(value) });
   }
@@ -65,17 +69,17 @@ function serialize(value: unknown): string {
 async function hashKey(secretKey: string): Promise<string> {
   const encoder = new TextEncoder();
   const data = encoder.encode(secretKey);
-  const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+  const hashBuffer = await crypto.subtle.digest("SHA-256", data);
   const hashArray = Array.from(new Uint8Array(hashBuffer));
-  return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+  return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
 }
 
 function generateToken(): string {
   const bytes = new Uint8Array(16);
   crypto.getRandomValues(bytes);
   return Array.from(bytes)
-    .map((b) => b.toString(16).padStart(2, '0'))
-    .join('');
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
 }
 
 export class Flow {
@@ -92,6 +96,7 @@ export class Flow {
   private _parentId: bigint;
   private _name: string;
   private _timeoutSeconds: bigint;
+  private _release: string;
 
   /** @internal */
   constructor(
@@ -99,13 +104,15 @@ export class Flow {
     keyHash: string,
     parentId: bigint,
     name: string,
-    timeoutSeconds: number
+    timeoutSeconds: number,
+    release: string = "",
   ) {
     this._sdk = sdk;
     this._keyHash = keyHash;
     this._parentId = parentId;
     this._name = name;
-    this._timeoutSeconds = (!timeoutSeconds || timeoutSeconds === Infinity) ? 0n : BigInt(timeoutSeconds);
+    this._timeoutSeconds = !timeoutSeconds || timeoutSeconds === Infinity ? 0n : BigInt(timeoutSeconds);
+    this._release = release;
     this._exportToken = generateToken();
     this._ready = new Promise<void>((resolve) => {
       this._resolveReady = resolve;
@@ -121,8 +128,8 @@ export class Flow {
 
     if (this._parentId === 0n) {
       const id = await this._sdk.createFlowAndResolveId(
-        () => conn.reducers.createRootFlow({ keyHash, timeoutSeconds, exportToken }),
-        exportToken
+        () => conn.reducers.createRootFlow({ keyHash, timeoutSeconds, exportToken, release: this._release }),
+        exportToken,
       );
       this._id = id;
     } else {
@@ -137,7 +144,7 @@ export class Flow {
             timeoutSeconds,
             exportToken,
           }),
-        exportToken
+        exportToken,
       );
       this._id = id;
     }
@@ -147,7 +154,7 @@ export class Flow {
   }
 
   /** Log a message with optional data */
-  log(message: string, data?: unknown, level: LogLevel = 'info'): this {
+  log(message: string, data?: unknown, level: LogLevel = "info"): this {
     if (this._finished) {
       console.warn(`[radish] Cannot log to finished flow`);
       return this;
@@ -155,28 +162,28 @@ export class Flow {
     this._pendingLogs.push({
       level,
       message,
-      data: data !== undefined ? serialize(data) : '{}',
+      data: data !== undefined ? serialize(data) : "{}",
     });
     this._scheduleFlush();
     return this;
   }
 
   info(message: string, data?: unknown): this {
-    return this.log(message, data, 'info');
+    return this.log(message, data, "info");
   }
   warn(message: string, data?: unknown): this {
-    return this.log(message, data, 'warn');
+    return this.log(message, data, "warn");
   }
   error(message: string, data?: unknown): this {
-    return this.log(message, data, 'error');
+    return this.log(message, data, "error");
   }
   debug(message: string, data?: unknown): this {
-    return this.log(message, data, 'debug');
+    return this.log(message, data, "debug");
   }
 
   /** Create a sub-action. Returns immediately — creation runs in background. */
   action(name: string, timeoutSeconds = 100): Flow {
-    const child = new Flow(this._sdk, this._keyHash, 0n, name, timeoutSeconds);
+    const child = new Flow(this._sdk, this._keyHash, 0n, name, timeoutSeconds, this._release);
     this._ready.then(() => {
       (child as any)._parentId = this._id!;
       child._create();
@@ -215,14 +222,16 @@ export class Flow {
     this._sdk.conn.reducers.finishFlow({
       keyHash: this._keyHash,
       flowId: this._id!,
-      status: 'finished',
+      status: "finished",
+      errorMessage: "",
     });
   }
 
   /** Finish this flow with error status */
   async finishWithError(err?: Error | string): Promise<void> {
+    const errorMessage = err ? (typeof err === "string" ? err : err.message) : "";
     if (err) {
-      this.error(typeof err === 'string' ? err : err.message, err);
+      this.error(errorMessage, err);
     }
     await this._ready;
     this._drain();
@@ -230,7 +239,8 @@ export class Flow {
     this._sdk.conn.reducers.finishFlow({
       keyHash: this._keyHash,
       flowId: this._id!,
-      status: 'error',
+      status: "error",
+      errorMessage,
     });
   }
 
@@ -290,6 +300,14 @@ export interface RLOptions {
   dbName?: string;
   label?: string;
   defaultTimeout?: number;
+  release?: string;
+  retention?: string;
+}
+
+function parseRetention(retention: string): number {
+  const match = retention.match(/^(\d+)d$/);
+  if (!match) throw new Error('Invalid retention format. Use e.g. "30d"');
+  return parseInt(match[1], 10);
 }
 
 /**
@@ -315,20 +333,23 @@ export interface RLOptions {
  */
 export async function RL(secretKey: string, options: RLOptions = {}): Promise<Flow> {
   const {
-    host = 'wss://maincloud.spacetimedb.com',
-    dbName = 'radish-log',
-    label = '',
+    host = "wss://maincloud.spacetimedb.com",
+    dbName = "radish-log",
+    label = "",
     defaultTimeout = 100,
+    release = "",
+    retention = "30d",
   } = options;
 
+  const retentionDays = parseRetention(retention);
   const keyHash = await hashKey(secretKey);
   const sdk = new SdkConnection(host, dbName);
   sdk.setKeyHash(keyHash);
   await sdk.connect();
 
-  // Register key (idempotent — server rejects dupes)
+  // Register key (idempotent — updates retention if changed)
   try {
-    sdk.conn.reducers.registerKey({ keyHash, label });
+    sdk.conn.reducers.registerKey({ keyHash, label, retentionDays: BigInt(retentionDays) });
   } catch {
     // Already registered
   }
@@ -341,29 +362,25 @@ export async function RL(secretKey: string, options: RLOptions = {}): Promise<Fl
   }
 
   // Root flow — creation runs in background, logs queue until ready
-  const root = new Flow(sdk, keyHash, 0n, '/', 0);
+  const root = new Flow(sdk, keyHash, 0n, "/", 0, release);
   root._create(); // fire-and-forget — resolves _ready when server assigns ID
   return root;
 }
 
 /** Restore a flow from an exported ID string */
-export async function restoreFlow(
-  secretKey: string,
-  exportedId: string,
-  options: RLOptions = {}
-): Promise<Flow> {
-  const { host = 'wss://maincloud.spacetimedb.com', dbName = 'radish-log' } = options;
+export async function restoreFlow(secretKey: string, exportedId: string, options: RLOptions = {}): Promise<Flow> {
+  const { host = "wss://maincloud.spacetimedb.com", dbName = "radish-log" } = options;
 
   const parsed = JSON.parse(exportedId);
   const keyHash = await hashKey(secretKey);
   if (keyHash !== parsed.keyHash) {
-    throw new Error('Secret key does not match the flow owner');
+    throw new Error("Secret key does not match the flow owner");
   }
 
   const sdk = new SdkConnection(host, dbName);
   await sdk.connect();
 
-  const flow = new Flow(sdk, keyHash, 0n, 'restored', 100);
+  const flow = new Flow(sdk, keyHash, 0n, "restored", 100);
   (flow as any)._id = BigInt(parsed.flowId);
   (flow as any)._exportToken = parsed.exportToken;
   (flow as any)._resolveReady();
@@ -375,9 +392,9 @@ export function generateKey(): string {
   const bytes = new Uint8Array(32);
   crypto.getRandomValues(bytes);
   return (
-    'rl_' +
+    "rl_" +
     Array.from(bytes)
-      .map((b) => b.toString(16).padStart(2, '0'))
-      .join('')
+      .map((b) => b.toString(16).padStart(2, "0"))
+      .join("")
   );
 }

package/src/module_bindings/api_key_table.ts

@@ -13,5 +13,6 @@ import {
 export default __t.row({
   keyHash: __t.string().primaryKey().name("key_hash"),
   label: __t.string(),
+  retentionDays: __t.u64().name("retention_days"),
   createdAt: __t.timestamp().name("created_at"),
 });

package/src/module_bindings/create_root_flow_reducer.ts

@@ -14,4 +14,5 @@ export default {
   keyHash: __t.string(),
   timeoutSeconds: __t.u64(),
   exportToken: __t.string(),
+  release: __t.string(),
 };

package/src/module_bindings/error_group_table.ts

@@ -0,0 +1,25 @@
+// THIS FILE IS AUTOMATICALLY GENERATED BY SPACETIMEDB. EDITS TO THIS FILE
+// WILL NOT BE SAVED. MODIFY TABLES IN YOUR MODULE SOURCE CODE INSTEAD.
+
+/* eslint-disable */
+/* tslint:disable */
+import {
+  TypeBuilder as __TypeBuilder,
+  t as __t,
+  type AlgebraicTypeType as __AlgebraicTypeType,
+  type Infer as __Infer,
+} from "spacetimedb";
+
+export default __t.row({
+  id: __t.u64().primaryKey(),
+  keyHash: __t.string().name("key_hash"),
+  fingerprint: __t.string(),
+  message: __t.string(),
+  path: __t.string(),
+  release: __t.string(),
+  count: __t.u64(),
+  status: __t.string(),
+  firstSeenAt: __t.timestamp().name("first_seen_at"),
+  lastSeenAt: __t.u64().name("last_seen_at"),
+  lastFlowId: __t.u64().name("last_flow_id"),
+});

package/src/module_bindings/finish_flow_reducer.ts

@@ -14,4 +14,5 @@ export default {
   keyHash: __t.string(),
   flowId: __t.u64(),
   status: __t.string(),
+  errorMessage: __t.string(),
 };

package/src/module_bindings/flow_table.ts

@@ -17,6 +17,7 @@ export default __t.row({
   name: __t.string(),
   path: __t.string(),
   status: __t.string(),
+  release: __t.string(),
   timeoutSeconds: __t.u64().name("timeout_seconds"),
   createdAt: __t.timestamp().name("created_at"),
   finishedAt: __t.u64().name("finished_at"),

package/src/module_bindings/index.ts

@@ -43,12 +43,14 @@ import FinishActionReducer from "./finish_action_reducer";
 import FinishFlowReducer from "./finish_flow_reducer";
 import RegisterKeyReducer from "./register_key_reducer";
 import StartActionReducer from "./start_action_reducer";
+import UpdateErrorGroupStatusReducer from "./update_error_group_status_reducer";
 
 // Import all procedure arg schemas
 
 // Import all table schema definitions
 import ActionRow from "./action_table";
 import ApiKeyRow from "./api_key_table";
+import ErrorGroupRow from "./error_group_table";
 import FlowRow from "./flow_table";
 import LogEntryRow from "./log_entry_table";
 
@@ -78,6 +80,21 @@ const tablesSchema = __schema({
       { name: 'api_key_key_hash_key', constraint: 'unique', columns: ['keyHash'] },
     ],
   }, ApiKeyRow),
+  errorGroup: __table({
+    name: 'error_group',
+    indexes: [
+      { name: 'fingerprint', algorithm: 'btree', columns: [
+        'fingerprint',
+      ] },
+      { name: 'id', algorithm: 'btree', columns: [
+        'id',
+      ] },
+    ],
+    constraints: [
+      { name: 'error_group_fingerprint_key', constraint: 'unique', columns: ['fingerprint'] },
+      { name: 'error_group_id_key', constraint: 'unique', columns: ['id'] },
+    ],
+  }, ErrorGroupRow),
   flow: __table({
     name: 'flow',
     indexes: [
@@ -117,6 +134,7 @@ const reducersSchema = __reducers(
   __reducerSchema("finish_flow", FinishFlowReducer),
   __reducerSchema("register_key", RegisterKeyReducer),
   __reducerSchema("start_action", StartActionReducer),
+  __reducerSchema("update_error_group_status", UpdateErrorGroupStatusReducer),
 );
 
 /** The schema information for all procedures in this module. This is defined the same way as the procedures would have been defined in the server. */

package/src/module_bindings/register_key_reducer.ts

@@ -13,4 +13,5 @@ import {
 export default {
   keyHash: __t.string(),
   label: __t.string(),
+  retentionDays: __t.u64(),
 };

package/src/module_bindings/types/reducers.ts

@@ -15,6 +15,7 @@ import FinishActionReducer from "../finish_action_reducer";
 import FinishFlowReducer from "../finish_flow_reducer";
 import RegisterKeyReducer from "../register_key_reducer";
 import StartActionReducer from "../start_action_reducer";
+import UpdateErrorGroupStatusReducer from "../update_error_group_status_reducer";
 
 export type AddLogParams = __Infer<typeof AddLogReducer>;
 export type AddLogsBatchParams = __Infer<typeof AddLogsBatchReducer>;
@@ -25,4 +26,5 @@ export type FinishActionParams = __Infer<typeof FinishActionReducer>;
 export type FinishFlowParams = __Infer<typeof FinishFlowReducer>;
 export type RegisterKeyParams = __Infer<typeof RegisterKeyReducer>;
 export type StartActionParams = __Infer<typeof StartActionReducer>;
+export type UpdateErrorGroupStatusParams = __Infer<typeof UpdateErrorGroupStatusReducer>;
 

package/src/module_bindings/types.ts

@@ -23,10 +23,26 @@ export type Action = __Infer<typeof Action>;
 export const ApiKey = __t.object("ApiKey", {
   keyHash: __t.string(),
   label: __t.string(),
+  retentionDays: __t.u64(),
   createdAt: __t.timestamp(),
 });
 export type ApiKey = __Infer<typeof ApiKey>;
 
+export const ErrorGroup = __t.object("ErrorGroup", {
+  id: __t.u64(),
+  keyHash: __t.string(),
+  fingerprint: __t.string(),
+  message: __t.string(),
+  path: __t.string(),
+  release: __t.string(),
+  count: __t.u64(),
+  status: __t.string(),
+  firstSeenAt: __t.timestamp(),
+  lastSeenAt: __t.u64(),
+  lastFlowId: __t.u64(),
+});
+export type ErrorGroup = __Infer<typeof ErrorGroup>;
+
 export const Flow = __t.object("Flow", {
   id: __t.u64(),
   keyHash: __t.string(),
@@ -34,6 +50,7 @@ export const Flow = __t.object("Flow", {
   name: __t.string(),
   path: __t.string(),
   status: __t.string(),
+  release: __t.string(),
   timeoutSeconds: __t.u64(),
   createdAt: __t.timestamp(),
   finishedAt: __t.u64(),
@@ -41,6 +58,12 @@ export const Flow = __t.object("Flow", {
 });
 export type Flow = __Infer<typeof Flow>;
 
+export const GcJob = __t.object("GcJob", {
+  scheduledId: __t.u64(),
+  scheduledAt: __t.scheduleAt(),
+});
+export type GcJob = __Infer<typeof GcJob>;
+
 export const LogEntry = __t.object("LogEntry", {
   id: __t.u64(),
   flowId: __t.u64(),

package/src/module_bindings/update_error_group_status_reducer.ts

@@ -0,0 +1,17 @@
+// THIS FILE IS AUTOMATICALLY GENERATED BY SPACETIMEDB. EDITS TO THIS FILE
+// WILL NOT BE SAVED. MODIFY TABLES IN YOUR MODULE SOURCE CODE INSTEAD.
+
+/* eslint-disable */
+/* tslint:disable */
+import {
+  TypeBuilder as __TypeBuilder,
+  t as __t,
+  type AlgebraicTypeType as __AlgebraicTypeType,
+  type Infer as __Infer,
+} from "spacetimedb";
+
+export default {
+  keyHash: __t.string(),
+  errorGroupId: __t.u64(),
+  status: __t.string(),
+};