@radishbot/sdk 0.3.1 → 0.5.0

package/dist/module_bindings/add_log_reducer.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    flowId: import("spacetimedb").U64Builder;
+    level: import("spacetimedb").StringBuilder;
+    message: import("spacetimedb").StringBuilder;
+    data: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/add_logs_batch_reducer.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    flowId: import("spacetimedb").U64Builder;
+    entries: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/api_key_table.d.ts

@@ -0,0 +1,14 @@
+declare const _default: import("spacetimedb").RowBuilder<{
+    keyHash: import("spacetimedb").StringColumnBuilder<{
+        isPrimaryKey: true;
+        name: "key_hash";
+    }>;
+    label: import("spacetimedb").StringBuilder;
+    retentionDays: import("spacetimedb").U64ColumnBuilder<{
+        name: "retention_days";
+    }>;
+    createdAt: import("spacetimedb").TimestampColumnBuilder<{
+        name: "created_at";
+    }>;
+}>;
+export default _default;

package/dist/module_bindings/check_timeouts_reducer.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/create_root_flow_reducer.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    timeoutSeconds: import("spacetimedb").U64Builder;
+    exportToken: import("spacetimedb").StringBuilder;
+    release: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/create_sub_flow_reducer.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    parentFlowId: import("spacetimedb").U64Builder;
+    name: import("spacetimedb").StringBuilder;
+    timeoutSeconds: import("spacetimedb").U64Builder;
+    exportToken: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/error_group_table.d.ts

@@ -0,0 +1,24 @@
+declare const _default: import("spacetimedb").RowBuilder<{
+    id: import("spacetimedb").U64ColumnBuilder<{
+        isPrimaryKey: true;
+    }>;
+    keyHash: import("spacetimedb").StringColumnBuilder<{
+        name: "key_hash";
+    }>;
+    fingerprint: import("spacetimedb").StringBuilder;
+    message: import("spacetimedb").StringBuilder;
+    path: import("spacetimedb").StringBuilder;
+    release: import("spacetimedb").StringBuilder;
+    count: import("spacetimedb").U64Builder;
+    status: import("spacetimedb").StringBuilder;
+    firstSeenAt: import("spacetimedb").TimestampColumnBuilder<{
+        name: "first_seen_at";
+    }>;
+    lastSeenAt: import("spacetimedb").U64ColumnBuilder<{
+        name: "last_seen_at";
+    }>;
+    lastFlowId: import("spacetimedb").U64ColumnBuilder<{
+        name: "last_flow_id";
+    }>;
+}>;
+export default _default;

package/dist/module_bindings/finish_action_reducer.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    actionId: import("spacetimedb").U64Builder;
+    status: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/finish_flow_reducer.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    flowId: import("spacetimedb").U64Builder;
+    status: import("spacetimedb").StringBuilder;
+    errorMessage: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/flow_table.d.ts

@@ -0,0 +1,28 @@
+declare const _default: import("spacetimedb").RowBuilder<{
+    id: import("spacetimedb").U64ColumnBuilder<{
+        isPrimaryKey: true;
+    }>;
+    keyHash: import("spacetimedb").StringColumnBuilder<{
+        name: "key_hash";
+    }>;
+    parentFlowId: import("spacetimedb").U64ColumnBuilder<{
+        name: "parent_flow_id";
+    }>;
+    name: import("spacetimedb").StringBuilder;
+    path: import("spacetimedb").StringBuilder;
+    status: import("spacetimedb").StringBuilder;
+    release: import("spacetimedb").StringBuilder;
+    timeoutSeconds: import("spacetimedb").U64ColumnBuilder<{
+        name: "timeout_seconds";
+    }>;
+    createdAt: import("spacetimedb").TimestampColumnBuilder<{
+        name: "created_at";
+    }>;
+    finishedAt: import("spacetimedb").U64ColumnBuilder<{
+        name: "finished_at";
+    }>;
+    exportToken: import("spacetimedb").StringColumnBuilder<{
+        name: "export_token";
+    }>;
+}>;
+export default _default;

package/dist/module_bindings/log_entry_table.d.ts

@@ -0,0 +1,15 @@
+declare const _default: import("spacetimedb").RowBuilder<{
+    id: import("spacetimedb").U64ColumnBuilder<{
+        isPrimaryKey: true;
+    }>;
+    flowId: import("spacetimedb").U64ColumnBuilder<{
+        name: "flow_id";
+    }>;
+    level: import("spacetimedb").StringBuilder;
+    message: import("spacetimedb").StringBuilder;
+    data: import("spacetimedb").StringBuilder;
+    createdAt: import("spacetimedb").TimestampColumnBuilder<{
+        name: "created_at";
+    }>;
+}>;
+export default _default;

package/dist/module_bindings/register_key_reducer.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    label: import("spacetimedb").StringBuilder;
+    retentionDays: import("spacetimedb").U64Builder;
+};
+export default _default;

package/dist/module_bindings/start_action_reducer.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    flowId: import("spacetimedb").U64Builder;
+    name: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/dist/module_bindings/types/procedures.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/module_bindings/types/reducers.d.ts

@@ -0,0 +1,21 @@
+import { type Infer as __Infer } from "spacetimedb";
+import AddLogReducer from "../add_log_reducer";
+import AddLogsBatchReducer from "../add_logs_batch_reducer";
+import CheckTimeoutsReducer from "../check_timeouts_reducer";
+import CreateRootFlowReducer from "../create_root_flow_reducer";
+import CreateSubFlowReducer from "../create_sub_flow_reducer";
+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>;
+export type CheckTimeoutsParams = __Infer<typeof CheckTimeoutsReducer>;
+export type CreateRootFlowParams = __Infer<typeof CreateRootFlowReducer>;
+export type CreateSubFlowParams = __Infer<typeof CreateSubFlowReducer>;
+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/dist/module_bindings/types.d.ts

@@ -0,0 +1,59 @@
+import { type Infer as __Infer } from "spacetimedb";
+export declare const Action: import("spacetimedb").ProductBuilder<{
+    id: import("spacetimedb").U64Builder;
+    flowId: import("spacetimedb").U64Builder;
+    name: import("spacetimedb").StringBuilder;
+    status: import("spacetimedb").StringBuilder;
+    createdAt: import("spacetimedb").TimestampBuilder;
+    finishedAt: import("spacetimedb").U64Builder;
+}>;
+export type Action = __Infer<typeof Action>;
+export declare const ApiKey: import("spacetimedb").ProductBuilder<{
+    keyHash: import("spacetimedb").StringBuilder;
+    label: import("spacetimedb").StringBuilder;
+    retentionDays: import("spacetimedb").U64Builder;
+    createdAt: import("spacetimedb").TimestampBuilder;
+}>;
+export type ApiKey = __Infer<typeof ApiKey>;
+export declare const ErrorGroup: import("spacetimedb").ProductBuilder<{
+    id: import("spacetimedb").U64Builder;
+    keyHash: import("spacetimedb").StringBuilder;
+    fingerprint: import("spacetimedb").StringBuilder;
+    message: import("spacetimedb").StringBuilder;
+    path: import("spacetimedb").StringBuilder;
+    release: import("spacetimedb").StringBuilder;
+    count: import("spacetimedb").U64Builder;
+    status: import("spacetimedb").StringBuilder;
+    firstSeenAt: import("spacetimedb").TimestampBuilder;
+    lastSeenAt: import("spacetimedb").U64Builder;
+    lastFlowId: import("spacetimedb").U64Builder;
+}>;
+export type ErrorGroup = __Infer<typeof ErrorGroup>;
+export declare const Flow: import("spacetimedb").ProductBuilder<{
+    id: import("spacetimedb").U64Builder;
+    keyHash: import("spacetimedb").StringBuilder;
+    parentFlowId: import("spacetimedb").U64Builder;
+    name: import("spacetimedb").StringBuilder;
+    path: import("spacetimedb").StringBuilder;
+    status: import("spacetimedb").StringBuilder;
+    release: import("spacetimedb").StringBuilder;
+    timeoutSeconds: import("spacetimedb").U64Builder;
+    createdAt: import("spacetimedb").TimestampBuilder;
+    finishedAt: import("spacetimedb").U64Builder;
+    exportToken: import("spacetimedb").StringBuilder;
+}>;
+export type Flow = __Infer<typeof Flow>;
+export declare const GcJob: import("spacetimedb").ProductBuilder<{
+    scheduledId: import("spacetimedb").U64Builder;
+    scheduledAt: import("spacetimedb").ScheduleAtBuilder;
+}>;
+export type GcJob = __Infer<typeof GcJob>;
+export declare const LogEntry: import("spacetimedb").ProductBuilder<{
+    id: import("spacetimedb").U64Builder;
+    flowId: import("spacetimedb").U64Builder;
+    level: import("spacetimedb").StringBuilder;
+    message: import("spacetimedb").StringBuilder;
+    data: import("spacetimedb").StringBuilder;
+    createdAt: import("spacetimedb").TimestampBuilder;
+}>;
+export type LogEntry = __Infer<typeof LogEntry>;

package/dist/module_bindings/update_error_group_status_reducer.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    keyHash: import("spacetimedb").StringBuilder;
+    errorGroupId: import("spacetimedb").U64Builder;
+    status: import("spacetimedb").StringBuilder;
+};
+export default _default;

package/package.json

@@ -1,20 +1,27 @@
 {
   "name": "@radishbot/sdk",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
   },
   "bin": {
     "radish": "./src/cli.ts"
   },
   "files": [
     "src",
+    "dist",
     "README.md"
   ],
   "scripts": {
+    "build": "bun build ./src/index.ts --outdir dist --target node --format esm --external spacetimedb --external ws",
+    "prepublishOnly": "bun run build",
     "cli": "bun run ./src/cli.ts"
   },
   "dependencies": {

package/src/cli.ts

@@ -185,19 +185,27 @@ function cmdList(flows: any[]) {
   }
 
   const hasRelease = roots.some((f) => f.release && f.release !== "");
+  const hasRunId = roots.some((f) => f.runId && f.runId !== "");
 
   console.log(`${c.bold}Flows${c.reset} ${c.dim}(${roots.length} total)${c.reset}\n`);
-  if (hasRelease) {
-    console.log(
-      `${c.dim}  ${"ID".padEnd(8)} ${"STATUS".padEnd(10)} ${"RELEASE".padEnd(10)} ${"DURATION".padEnd(10)} CREATED${c.reset}`,
-    );
-    console.log(
-      `${c.dim}  ${"─".repeat(8)} ${"─".repeat(10)} ${"─".repeat(10)} ${"─".repeat(10)} ${"─".repeat(24)}${c.reset}`,
-    );
-  } else {
-    console.log(`${c.dim}  ${"ID".padEnd(8)} ${"STATUS".padEnd(10)} ${"DURATION".padEnd(10)} CREATED${c.reset}`);
-    console.log(`${c.dim}  ${"─".repeat(8)} ${"─".repeat(10)} ${"─".repeat(10)} ${"─".repeat(24)}${c.reset}`);
-  }
+  const cols = [
+    "ID".padEnd(8),
+    "STATUS".padEnd(10),
+    ...(hasRunId ? ["RUN".padEnd(18)] : []),
+    ...(hasRelease ? ["RELEASE".padEnd(10)] : []),
+    "DURATION".padEnd(10),
+    "CREATED",
+  ];
+  const divs = [
+    "─".repeat(8),
+    "─".repeat(10),
+    ...(hasRunId ? ["─".repeat(18)] : []),
+    ...(hasRelease ? ["─".repeat(10)] : []),
+    "─".repeat(10),
+    "─".repeat(24),
+  ];
+  console.log(`${c.dim}  ${cols.join(" ")}${c.reset}`);
+  console.log(`${c.dim}  ${divs.join(" ")}${c.reset}`);
 
   for (const f of roots.slice(0, 30)) {
     const id = f.id.toString().padEnd(8);
@@ -205,8 +213,11 @@ function cmdList(flows: any[]) {
     const status = padRight(f.status, 10);
     const dur = f.finishedAt !== 0n ? padRight(fmtDuration(f.createdAt, f.finishedAt), 10) : padRight("—", 10);
     const time = fmtDateTime(f.createdAt);
+    const runIdCol = hasRunId ? padRight(f.runId ? f.runId.slice(0, 16) : "—", 18) : "";
     const release = hasRelease ? padRight(f.release || "—", 10) + " " : "";
-    console.log(`  ${c.dim}${id}${c.reset} ${sc}${status}${c.reset} ${release}${dur} ${c.dim}${time}${c.reset}`);
+    console.log(
+      `  ${c.dim}${id}${c.reset} ${sc}${status}${c.reset} ${hasRunId ? runIdCol + " " : ""}${release}${dur} ${c.dim}${time}${c.reset}`,
+    );
   }
 
   if (roots.length > 30) {
@@ -225,6 +236,9 @@ function cmdShow(flowId: bigint, allFlows: any[], allLogs: any[]) {
   const sc = statusColor(flow.status);
   const releaseTag = flow.release ? `  ${c.dim}(${flow.release})${c.reset}` : "";
   console.log(`${c.bold}Flow #${flow.id}${c.reset}  ${sc}${flow.status}${c.reset}${releaseTag}`);
+  if (flow.runId) {
+    console.log(`${c.dim}Run: ${flow.runId}${c.reset}`);
+  }
   console.log(`${c.dim}Created: ${fmtDateTime(flow.createdAt)}${c.reset}`);
   if (flow.finishedAt !== 0n) {
     console.log(`${c.dim}Duration: ${fmtDuration(flow.createdAt, flow.finishedAt)}${c.reset}`);

package/src/index.ts

@@ -97,6 +97,7 @@ export class Flow {
   private _name: string;
   private _timeoutSeconds: bigint;
   private _release: string;
+  private _runId: string;
 
   /** @internal */
   constructor(
@@ -106,6 +107,7 @@ export class Flow {
     name: string,
     timeoutSeconds: number,
     release: string = "",
+    runId: string = "",
   ) {
     this._sdk = sdk;
     this._keyHash = keyHash;
@@ -113,6 +115,7 @@ export class Flow {
     this._name = name;
     this._timeoutSeconds = !timeoutSeconds || timeoutSeconds === Infinity ? 0n : BigInt(timeoutSeconds);
     this._release = release;
+    this._runId = runId;
     this._exportToken = generateToken();
     this._ready = new Promise<void>((resolve) => {
       this._resolveReady = resolve;
@@ -128,7 +131,14 @@ export class Flow {
 
     if (this._parentId === 0n) {
       const id = await this._sdk.createFlowAndResolveId(
-        () => conn.reducers.createRootFlow({ keyHash, timeoutSeconds, exportToken, release: this._release }),
+        () =>
+          conn.reducers.createRootFlow({
+            keyHash,
+            runId: this._runId,
+            timeoutSeconds,
+            exportToken,
+            release: this._release,
+          }),
         exportToken,
       );
       this._id = id;
@@ -191,7 +201,7 @@ export class Flow {
 
   /** 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, this._release);
+    const child = new Flow(this._sdk, this._keyHash, 0n, name, timeoutSeconds, this._release, this._runId);
     this._ready.then(() => {
       (child as any)._parentId = this._id!;
       child._create();
@@ -252,6 +262,11 @@ export class Flow {
     });
   }
 
+  /** Get the run ID for this flow (pass to subprocesses via env, args, etc.) */
+  get runId(): string {
+    return this._runId;
+  }
+
   /** Export this flow's handle for restoration in another context */
   async exportID(): Promise<string> {
     await this._ready;
@@ -259,6 +274,7 @@ export class Flow {
       flowId: this._id!.toString(),
       exportToken: this._exportToken,
       keyHash: this._keyHash,
+      runId: this._runId,
     });
   }
 
@@ -323,6 +339,8 @@ export interface RLOptions {
   defaultTimeout?: number;
   release?: string;
   retention?: string;
+  /** Run ID — groups flows across processes. Auto-generated if not provided. */
+  runId?: string;
 }
 
 function parseRetention(retention: string): number {
@@ -360,6 +378,7 @@ export async function RL(secretKey: string, options: RLOptions = {}): Promise<Fl
     defaultTimeout = 100,
     release = "",
     retention = "30d",
+    runId = generateRunId(),
   } = options;
 
   const retentionDays = parseRetention(retention);
@@ -387,7 +406,7 @@ 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, release);
+  const root = new Flow(sdk, keyHash, 0n, "/", 0, release, runId);
   root._create(); // fire-and-forget — resolves _ready when server assigns ID
   return root;
 }
@@ -405,7 +424,7 @@ export async function restoreFlow(secretKey: string, exportedId: string, options
   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, "", parsed.runId || "");
   (flow as any)._id = BigInt(parsed.flowId);
   (flow as any)._exportToken = parsed.exportToken;
   (flow as any)._resolveReady();
@@ -423,3 +442,12 @@ export function generateKey(): string {
       .join("")
   );
 }
+
+/** Generate a random run ID (pass to subprocesses to link flows) */
+export function generateRunId(): string {
+  const bytes = new Uint8Array(8);
+  crypto.getRandomValues(bytes);
+  return Array.from(bytes)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+}

package/src/module_bindings/create_root_flow_reducer.ts

@@ -12,6 +12,7 @@ import {
 
 export default {
   keyHash: __t.string(),
+  runId: __t.string(),
   timeoutSeconds: __t.u64(),
   exportToken: __t.string(),
   release: __t.string(),

package/src/module_bindings/flow_table.ts

@@ -13,6 +13,7 @@ import {
 export default __t.row({
   id: __t.u64().primaryKey(),
   keyHash: __t.string().name("key_hash"),
+  runId: __t.string().name("run_id"),
   parentFlowId: __t.u64().name("parent_flow_id"),
   name: __t.string(),
   path: __t.string(),

package/src/module_bindings/types.ts

@@ -46,6 +46,7 @@ export type ErrorGroup = __Infer<typeof ErrorGroup>;
 export const Flow = __t.object("Flow", {
   id: __t.u64(),
   keyHash: __t.string(),
+  runId: __t.string(),
   parentFlowId: __t.u64(),
   name: __t.string(),
   path: __t.string(),