unfazed 0.5.0 → 0.6.1

package/dist/remote/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/remote/values.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * How the `unfazed` CLI backend turns the inspection API's display data back\n * into what Workflow SDK's tooling reads from a World.\n *\n * The app's inspection route hydrates every payload inside the app and sends\n * it as display text (`JSON.stringify` of the hydrated value, cut at the\n * route's caps). The CLI and the web UI expect a World to hand them serialized\n * data, which they hydrate themselves: a `Uint8Array` with a 4-byte format\n * prefix, `devl` followed by devalue text. So each value is parsed back from\n * its display text and re-encoded as `devl` + devalue, which every Workflow\n * SDK reader hydrates to the same plain value. A value that was cut, or that\n * the app could not hydrate, becomes a string that says so.\n *\n * Pure functions, no dependencies.\n */\nimport type { WorkflowError, WorkflowStreamChunk, WorkflowValue } from \"./documents.js\";\n\nconst encoder = new TextEncoder();\nconst DEVALUE_PREFIX = encoder.encode(\"devl\");\n\n/** devalue's marker for `undefined`. */\nconst DEVALUE_UNDEFINED = -1;\n\n/**\n * devalue's `stringify` for the values JSON can hold (what `JSON.parse`\n * returns, plus `undefined`): a flat array whose first entry is the root,\n * where an object or array refers to its members by index. Strings,\n * numbers, booleans and `null` sit in the array as themselves, so the\n * encoding never produces devalue's typed tuples (`[\"Date\", …]`), and every\n * reviver set reads it the same way.\n */\nexport function devalueStringify(value: unknown): string {\n  if (value === undefined) return String(DEVALUE_UNDEFINED);\n  const values: unknown[] = [];\n  const add = (item: unknown): number => {\n    if (item === undefined) return DEVALUE_UNDEFINED;\n    const index = values.length;\n    values.push(null);\n    if (Array.isArray(item)) {\n      values[index] = item.map(add);\n    } else if (item !== null && typeof item === \"object\") {\n      const flat: Record<string, number> = {};\n      for (const [key, member] of Object.entries(item as Record<string, unknown>)) flat[key] = add(member);\n      values[index] = flat;\n    } else if (typeof item === \"number\" && !Number.isFinite(item)) {\n      values[index] = null;\n    } else {\n      values[index] = item;\n    }\n    return index;\n  };\n  add(value);\n  return JSON.stringify(values);\n}\n\n/** `value` as Workflow SDK serialized data: `devl` + devalue text. */\nexport function serialize(value: unknown): Uint8Array {\n  const body = encoder.encode(devalueStringify(value));\n  const out = new Uint8Array(DEVALUE_PREFIX.length + body.length);\n  out.set(DEVALUE_PREFIX, 0);\n  out.set(body, DEVALUE_PREFIX.length);\n  return out;\n}\n\n/**\n * One stream frame as Workflow SDK's stream writer writes it: a 4-byte\n * big-endian length, then the serialized value. `getDeserializeStream()`\n * (what `workflow inspect stream` and the web UI read streams with) turns\n * each frame back into the value.\n */\nexport function frame(value: unknown): Uint8Array {\n  const payload = serialize(value);\n  const out = new Uint8Array(4 + payload.length);\n  new DataView(out.buffer).setUint32(0, payload.length, false);\n  out.set(payload, 4);\n  return out;\n}\n\n/** What a payload cut at the inspection route's cap ends with. */\nexport function truncationNote(bytes: number): string {\n  return ` … [truncated by unfazed inspection: ${bytes} bytes in full]`;\n}\n\n/** What a payload the app could not hydrate reads as. */\nexport function unreadable(reason: string): string {\n  return `[unreadable payload: ${reason}]`;\n}\n\n/**\n * The value behind a `WorkflowValue`: its display JSON parsed back, a string\n * marked as cut when the route cut it (the cut text is not valid JSON), or a\n * string with the reason when the app could not hydrate it.\n */\nexport function displayValue(value: WorkflowValue): unknown {\n  if (value.error) return unreadable(value.text);\n  if (value.truncated) return value.text + truncationNote(value.bytes);\n  try {\n    return JSON.parse(value.text);\n  } catch {\n    return value.text;\n  }\n}\n\n/** A `WorkflowValue` as serialized data, or `undefined` for an absent payload. */\nexport function serializedValue(value: WorkflowValue | null | undefined): Uint8Array | undefined {\n  return value ? serialize(displayValue(value)) : undefined;\n}\n\n/** A run or step error as Workflow SDK's `StructuredError`. */\nexport function structuredError(error: WorkflowError): { message: string; stack?: string; code?: string } {\n  return {\n    message: error.truncated ? `${error.message} … [truncated by unfazed inspection]` : error.message,\n    ...(error.stack !== null ? { stack: error.stack } : {}),\n    ...(error.code !== null ? { code: error.code } : {}),\n  };\n}\n\n/**\n * The value of one stream chunk: `json` chunks (what `getWritable()` writes)\n * parsed back, `utf8` chunks as their text, `base64` chunks (bytes that are\n * not UTF-8) as `{ $bytes, base64 }`, the route's display form for bytes.\n */\nexport function chunkValue(chunk: WorkflowStreamChunk): unknown {\n  const note = chunk.truncated ? ` … [truncated by unfazed inspection: chunk of ${chunk.bytes} bytes]` : \"\";\n  if (chunk.encoding === \"base64\") {\n    return { $bytes: chunk.bytes, base64: chunk.text, ...(chunk.truncated ? { truncated: true } : {}) };\n  }\n  if (chunk.encoding === \"json\" && !chunk.truncated) {\n    try {\n      return JSON.parse(chunk.text);\n    } catch {\n      return chunk.text;\n    }\n  }\n  return chunk.text + note;\n}\n\n/** An RFC 3339 time as a `Date`, or `undefined`. */\nexport function toDate(value: string | null | undefined): Date | undefined {\n  if (value === null || value === undefined || value === \"\") return undefined;\n  const date = new Date(value);\n  return Number.isNaN(date.getTime()) ? undefined : date;\n}\n\n/** Event data fields the World types as dates; the route sends them as RFC 3339 text. */\nconst EVENT_DATE_FIELDS = [\"resumeAt\", \"retryAfter\", \"tokenRetentionUntil\"];\n\n/** An event's `info` as `eventData`, its date fields as `Date`s. */\nexport function eventData(info: Record<string, unknown> | null | undefined): Record<string, unknown> {\n  const out: Record<string, unknown> = { ...(info ?? {}) };\n  for (const field of EVENT_DATE_FIELDS) {\n    const date = typeof out[field] === \"string\" ? toDate(out[field] as string) : undefined;\n    if (date) out[field] = date;\n  }\n  return out;\n}\n\n/**\n * The payload field of each event type, as `getEventDataRefFields()` in\n * `@workflow/world` lists them: where `events.get` puts the event's data.\n */\nexport const EVENT_PAYLOAD_FIELDS: Readonly<Record<string, string>> = {\n  run_created: \"input\",\n  run_started: \"input\",\n  run_completed: \"output\",\n  run_failed: \"error\",\n  step_created: \"input\",\n  step_started: \"input\",\n  step_completed: \"result\",\n  step_failed: \"error\",\n  step_retrying: \"error\",\n  hook_created: \"metadata\",\n  hook_received: \"payload\",\n};\n"]}

package/dist/remote/world.d.ts

@@ -0,0 +1,50 @@
+import { type FetchLike } from "../client.js";
+export interface RemoteWorldOptions {
+    /** The app's alias. Default: `UNFZ_APP`, else the `alias` (or single `apps[]` entry) of `unfazed.json` in `cwd`. */
+    alias?: string;
+    /** Bearer token. Default: `UNFZ_API_TOKEN`, else the stored login of `npx unfazed login`. */
+    token?: string;
+    /** Full GraphQL endpoint. Default: `UNFZ_API_URL`, else https://unfazed.dev/query. */
+    endpoint?: string;
+    /** Where the defaults above (and the stored login's location) are read from. Default: `process.env`. */
+    env?: Record<string, string | undefined>;
+    /** Directory whose `unfazed.json` names the app. Default: the current directory. */
+    cwd?: string;
+    /** Per-request timeout in ms. Default 60 000 (a relay may include the app's cold start). */
+    timeoutMs?: number;
+    /**
+     * How long `streams.get` waits between reads of a stream still being
+     * written, at most: it starts at 1 s and doubles up to this. Default 5 000.
+     */
+    streamPollMs?: number;
+    /** Injection point for tests. */
+    fetch?: FetchLike;
+}
+/**
+ * The World `createWorld()` from `unfazed` returns: Workflow SDK's `World`
+ * interface over the inspection API. Typed loosely here so the root entry's
+ * declarations need no `@workflow/world`; cast to its `World` when you call
+ * it from code.
+ */
+export interface RemoteWorld {
+    /** The app it reads. */
+    readonly alias: string;
+    readonly specVersion: number;
+    readonly runs: object;
+    readonly steps: object;
+    readonly events: object;
+    readonly hooks: object;
+    readonly streams: object;
+    close(): Promise<void>;
+}
+/**
+ * `SPEC_VERSION_CURRENT` of the `@workflow/world` this backend was written
+ * against (a test keeps the two equal). Informational: this World creates
+ * and replays nothing.
+ */
+export declare const REMOTE_SPEC_VERSION = 8;
+/**
+ * Creates the CLI backend's World for one app. Throws when there is no token
+ * or no app to read, saying what to set.
+ */
+export declare function createRemoteWorld(options?: RemoteWorldOptions): RemoteWorld;