@w6w/sdk 0.2.1 → 0.4.0

package/dist/src/console/schedules.d.ts

@@ -0,0 +1,127 @@
+/**
+ * `client.console.schedules.*` — per-workflow schedules, relocated from the
+ * studio's own API client.
+ *
+ * **Studio-internal, not the published partner contract.** This namespace
+ * lives under the `console` subpath export (`@w6w/sdk/console`), excluded from
+ * `endpoints.json` and from the root barrel (`mod.ts`) — see `docs/console.md`
+ * and HITL-1 in this task's contract. `@w6w/sdk`'s instance-state mechanism
+ * pin still applies here exactly as it does to every other namespace
+ * (`docs/implementation.md` §MECHANISM PIN — instance state, never globals):
+ * this class holds no state of its own beyond the injected host, so two
+ * clients in one process never share a credential.
+ *
+ * **`GET /schedules` (list) is deliberately not modeled here.** Studio's
+ * `api/client.ts` never wrapped it (zero client-side coverage) — see this
+ * task's contract Requirement and `plan.md`'s FINDINGS DISPOSITION for the
+ * full reasoning.
+ *
+ * Schedules are addressed by `workflowId` alone, never by a project or account
+ * scope, so `SchedulesHost` needs only the transport, no client configuration —
+ * mirrors `VarsHost` in `../vars.ts`, not `DocumentsHost`.
+ *
+ * **`get`'s 404→`null` behavior is a deliberate, pinned deviation from every
+ * other "get" method in this package** (`documents.get`, `vars.get`, … all
+ * throw `ApiError` on 404). It is relocated verbatim from
+ * `packages/studio/src/api/client.ts:535-542`, which catches ANY 404
+ * (regardless of the server's error `code`) and resolves `null` instead of
+ * throwing. The server sends two different codes for "no schedule to show" —
+ * `unknown_workflow` and `no_schedule` (`admin/schedules.ts:82,85`) — and this
+ * method does not discriminate between them, only the HTTP status: any other
+ * status (400, 500, …) still throws, unchanged.
+ *
+ * @module
+ */
+import { type HttpResponse, type RequestOptions } from "../http.ts";
+/**
+ * The slice of `W6wClient` this namespace needs: the transport, and nothing
+ * else. Structural rather than a concrete client type, so the namespace stays
+ * independently constructible in a test and this module never imports the
+ * client back — mirrors `VarsHost` in `../vars.ts`.
+ */
+export interface SchedulesHost {
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/**
+ * A workflow's schedule. Field-for-field per
+ * `packages/studio/src/api/types.ts:368-375` — this module does not redesign
+ * the shape, only gives it a second home.
+ */
+export interface Schedule {
+    workflowId: string;
+    cron: string;
+    enabled: boolean;
+    variables: Record<string, unknown>;
+    nextRunAt: string;
+    lastRunAt: string | null;
+}
+/**
+ * The body of `schedules.upsert`.
+ *
+ * Create-or-update — there is no distinct "create" and "update" on this
+ * domain, mirroring `POST /workflows/:id/schedule`'s own create-or-update
+ * semantics (`admin/schedules.ts:32-77`, `200` either way, no distinct `201`).
+ */
+export interface ScheduleUpsertInput {
+    /** A standard 5-field cron expression. `400 invalid_cron` if malformed. */
+    cron: string;
+    /** Omitted, the server applies its own default. */
+    enabled?: boolean;
+    /** Variables bound into the scheduled run. Omitted, the server applies its own default. */
+    variables?: Record<string, unknown>;
+}
+/**
+ * The `console.schedules` namespace on a `W6wClient`.
+ *
+ * @example
+ * ```ts
+ * const schedule = await client.console.schedules.get("wf_1");
+ * if (schedule === null) {
+ *   await client.console.schedules.upsert("wf_1", { cron: "0 * * * *" });
+ * }
+ * await client.console.schedules.delete("wf_1");
+ * ```
+ */
+export declare class SchedulesApi {
+    #private;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host: SchedulesHost);
+    /**
+     * Fetch a workflow's schedule.
+     *
+     * **Resolves `null` on a 404, of any code — it does not throw.** This is a
+     * deliberate deviation from every other "get" method in this package, pinned
+     * exactly from `client.ts:535-542`: see this module's header. Any other
+     * error status (400, 500, …) still throws.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @returns The schedule, or `null` when there is none to show.
+     * @throws {ApiError} On any non-404 non-2xx.
+     */
+    get(workflowId: string): Promise<Schedule | null>;
+    /**
+     * Create or overwrite a workflow's schedule.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param body - The schedule to set; forwarded as-is.
+     * @returns The resulting schedule (the server answers `200`, create-or-update alike).
+     * @throws {ApiError} `404 unknown_workflow`; `400 invalid_body`/`invalid_cron`.
+     */
+    upsert(workflowId: string, body: ScheduleUpsertInput): Promise<Schedule>;
+    /**
+     * Delete a workflow's schedule.
+     *
+     * Returns nothing: the server's `{ok: true}` carries no information a caller
+     * can use. Unlike `get`, this method does NOT catch a 404 — deleting a
+     * schedule that does not exist is `404 unknown_workflow`, not a silent
+     * success.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @throws {ApiError} `404 unknown_workflow` when there is no such workflow.
+     */
+    delete(workflowId: string): Promise<void>;
+}
+//# sourceMappingURL=schedules.d.ts.map

package/dist/src/console/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../../src/console/schedules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAQ,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAI1E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;;IAGvB;;OAEG;gBACS,IAAI,EAAE,aAAa;IAI/B;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAavD;;;;;;;OAOG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAS9E;;;;;;;;;;OAUG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhD"}

package/dist/src/console/schedules.js

@@ -0,0 +1,118 @@
+/**
+ * `client.console.schedules.*` — per-workflow schedules, relocated from the
+ * studio's own API client.
+ *
+ * **Studio-internal, not the published partner contract.** This namespace
+ * lives under the `console` subpath export (`@w6w/sdk/console`), excluded from
+ * `endpoints.json` and from the root barrel (`mod.ts`) — see `docs/console.md`
+ * and HITL-1 in this task's contract. `@w6w/sdk`'s instance-state mechanism
+ * pin still applies here exactly as it does to every other namespace
+ * (`docs/implementation.md` §MECHANISM PIN — instance state, never globals):
+ * this class holds no state of its own beyond the injected host, so two
+ * clients in one process never share a credential.
+ *
+ * **`GET /schedules` (list) is deliberately not modeled here.** Studio's
+ * `api/client.ts` never wrapped it (zero client-side coverage) — see this
+ * task's contract Requirement and `plan.md`'s FINDINGS DISPOSITION for the
+ * full reasoning.
+ *
+ * Schedules are addressed by `workflowId` alone, never by a project or account
+ * scope, so `SchedulesHost` needs only the transport, no client configuration —
+ * mirrors `VarsHost` in `../vars.ts`, not `DocumentsHost`.
+ *
+ * **`get`'s 404→`null` behavior is a deliberate, pinned deviation from every
+ * other "get" method in this package** (`documents.get`, `vars.get`, … all
+ * throw `ApiError` on 404). It is relocated verbatim from
+ * `packages/studio/src/api/client.ts:535-542`, which catches ANY 404
+ * (regardless of the server's error `code`) and resolves `null` instead of
+ * throwing. The server sends two different codes for "no schedule to show" —
+ * `unknown_workflow` and `no_schedule` (`admin/schedules.ts:82,85`) — and this
+ * method does not discriminate between them, only the HTTP status: any other
+ * status (400, 500, …) still throws, unchanged.
+ *
+ * @module
+ */
+import { path } from "../http.js";
+import { ApiError } from "../errors.js";
+import { unwrap } from "../types.js";
+/**
+ * The `console.schedules` namespace on a `W6wClient`.
+ *
+ * @example
+ * ```ts
+ * const schedule = await client.console.schedules.get("wf_1");
+ * if (schedule === null) {
+ *   await client.console.schedules.upsert("wf_1", { cron: "0 * * * *" });
+ * }
+ * await client.console.schedules.delete("wf_1");
+ * ```
+ */
+export class SchedulesApi {
+    #host;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host) {
+        this.#host = host;
+    }
+    /**
+     * Fetch a workflow's schedule.
+     *
+     * **Resolves `null` on a 404, of any code — it does not throw.** This is a
+     * deliberate deviation from every other "get" method in this package, pinned
+     * exactly from `client.ts:535-542`: see this module's header. Any other
+     * error status (400, 500, …) still throws.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @returns The schedule, or `null` when there is none to show.
+     * @throws {ApiError} On any non-404 non-2xx.
+     */
+    async get(workflowId) {
+        try {
+            const res = await this.#host.request({
+                method: "GET",
+                path: path `/workflows/${workflowId}/schedule`,
+            });
+            return unwrap(res, "schedule");
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+    /**
+     * Create or overwrite a workflow's schedule.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param body - The schedule to set; forwarded as-is.
+     * @returns The resulting schedule (the server answers `200`, create-or-update alike).
+     * @throws {ApiError} `404 unknown_workflow`; `400 invalid_body`/`invalid_cron`.
+     */
+    async upsert(workflowId, body) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/workflows/${workflowId}/schedule`,
+            body,
+        });
+        return unwrap(res, "schedule");
+    }
+    /**
+     * Delete a workflow's schedule.
+     *
+     * Returns nothing: the server's `{ok: true}` carries no information a caller
+     * can use. Unlike `get`, this method does NOT catch a 404 — deleting a
+     * schedule that does not exist is `404 unknown_workflow`, not a silent
+     * success.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @throws {ApiError} `404 unknown_workflow` when there is no such workflow.
+     */
+    async delete(workflowId) {
+        await this.#host.request({
+            method: "DELETE",
+            path: path `/workflows/${workflowId}/schedule`,
+        });
+    }
+}
+//# sourceMappingURL=schedules.js.map

package/dist/src/console/schedules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.js","sourceRoot":"","sources":["../../../src/console/schedules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAqB,IAAI,EAAuB,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2CrC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACd,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,UAAkB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;gBAC5C,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,WAAW;aAC9C,CAAC,CAAC;YACH,OAAO,MAAM,CAAW,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAAyB;QACxD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,WAAW;YAC7C,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAW,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAChC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,WAAW;SAC9C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/console/step-tests.d.ts

@@ -0,0 +1,159 @@
+/**
+ * `client.console.stepTests.*` — reusable, workflow-step-scoped test
+ * fixtures for a step's resolved incoming state (`input`) and its params
+ * (`with`), plus their run-log, relocated from the studio's own API client.
+ *
+ * **Studio-internal, not the published partner contract.** This namespace
+ * lives under the `console` subpath export (`@w6w/sdk/console`), excluded from
+ * `endpoints.json` and from the root barrel (`mod.ts`) — see `docs/console.md`
+ * and HITL-1 in this task's contract. `@w6w/sdk`'s instance-state mechanism
+ * pin still applies here exactly as it does to every other namespace
+ * (`docs/implementation.md` §MECHANISM PIN — instance state, never globals):
+ * this class holds no state of its own beyond the injected host, so two
+ * clients in one process never share a credential.
+ *
+ * Three methods relocate from the studio's own `// Saved per-step tests`
+ * comment block (`packages/studio/src/api/client.ts:317-351` on the studio
+ * base tree) — field-for-field, not redesigned. Method names here are
+ * SHORTENED versus `client.ts`'s flat names (`saveStepTest` → `save`,
+ * `listStepTests` → `list`, `recordStepTestRun` → `recordRun`), mirroring
+ * `console.connections.listForApp`/`console.workflows.get`'s own convention:
+ * the domain prefix (`console.stepTests.*`) already disambiguates.
+ *
+ * **`PATCH`/`DELETE /workflows/:workflowId/steps/:stepId/tests/:id` also
+ * exist server-side but have ZERO client-side coverage anywhere (studio or
+ * `@w6w/ui`) — deliberately NOT wrapped here.** Same disposition prior
+ * console domains already established for their own orphan routes
+ * (HITL-4's philosophy applied one step further).
+ *
+ * **`recordRun` returns the REAL created row, not `void`.** Studio's current
+ * `client.ts` discards it to `void` (`.then(() => {})`) only so its `api`
+ * object stays assignable to `@w6w/ui`'s `W6wApi.recordStepTestRun` (typed
+ * `Promise<void>`, `packages/ui/src/provider.tsx:211-221`) — that is
+ * STUDIO's constraint, not the SDK's. Mirrors `./saved-tests.ts`'s
+ * `recordTestRun` exactly; the void-discard happens at studio's own repo
+ * layer (`src/repos/step-tests.ts`, a later task), not here.
+ *
+ * None of these methods take a `project` scoping parameter — step tests
+ * carry no `?project=`, the server scopes by workflow/tenant — so
+ * `StepTestsHost` needs only the transport, mirroring `ConnectionsHost`, not
+ * `DocumentsHost`.
+ *
+ * @module
+ */
+import { type HttpResponse, type RequestOptions } from "../http.ts";
+/**
+ * The slice of `W6wClient` this namespace needs: the transport, and nothing
+ * else. Structural rather than a concrete client type, so the namespace stays
+ * independently constructible in a test and this module never imports the
+ * client back — mirrors `ConnectionsHost` in `./connections.ts`.
+ */
+export interface StepTestsHost {
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/**
+ * A saved per-step test fixture — a reusable, project-owned named capture of
+ * a workflow step's resolved incoming state (`input`) and its params
+ * (`with`), keyed by `(workflowId, stepId)`. Mirrors the connection-scoped
+ * `SavedTest`, re-keyed to a workflow step. `lastRun*` denormalizes the most
+ * recent run.
+ */
+export interface StepTest {
+    id: string;
+    workflowId: string;
+    stepId: string;
+    name: string | null;
+    input: Record<string, unknown>;
+    with: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    lastRunAt?: string | null;
+    lastRunStatus?: string | null;
+    lastRunError?: unknown;
+    lastRunOutput?: unknown;
+}
+/** The real row `recordRun` creates (mirrors the server's `StepTestRun`). */
+export interface StepTestRun {
+    id: string;
+    stepTestId: string | null;
+    workflowId: string;
+    stepId: string;
+    status: string;
+    input: unknown;
+    output: unknown;
+    error: unknown;
+    createdAt: string;
+}
+/**
+ * The `console.stepTests` namespace on a `W6wClient`.
+ *
+ * @example
+ * ```ts
+ * const fixture = await client.console.stepTests.save("wf_1", "nd_1", {
+ *   input: { foo: "bar" },
+ *   with: { to: "a@b.com" },
+ * });
+ * const fixtures = await client.console.stepTests.list("wf_1", "nd_1");
+ * const run = await client.console.stepTests.recordRun("wf_1", "nd_1", {
+ *   stepTestId: fixture.id,
+ *   status: "succeeded",
+ *   output: { ok: true },
+ * });
+ * ```
+ */
+export declare class StepTestsApi {
+    #private;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host: StepTestsHost);
+    /**
+     * Save a step-test fixture.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @param body - Optional `name`, plus `input`/`with`, forwarded verbatim.
+     * @returns The created step test, unwrapped from the `stepTest` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_name`/`invalid_input`/`invalid_with`;
+     * `404 unknown_workflow`.
+     */
+    save(workflowId: string, stepId: string, body: {
+        name?: string;
+        input: Record<string, unknown>;
+        with: Record<string, unknown>;
+    }): Promise<StepTest>;
+    /**
+     * List a step's saved test fixtures.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @returns The step tests, unwrapped from the `stepTests` envelope.
+     */
+    list(workflowId: string, stepId: string): Promise<StepTest[]>;
+    /**
+     * Record the outcome of a step-test run. Appends a `step_test_runs` row
+     * (and a best-effort `run_log` ledger row) server-side; when `stepTestId`
+     * is present, the fixture's `lastRun*` fields are updated too.
+     *
+     * Returns the REAL created row — see this module's header. Does NOT
+     * discard to `void`; a caller wanting the studio-facade `void` shape
+     * adapts it themselves.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @param body - `stepTestId` (optional), `status`, and optional
+     * `input`/`output`/`error`, forwarded verbatim.
+     * @returns The created `StepTestRun`, unwrapped from the `run` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_body`/`invalid_status`. No `404` — the
+     * route never checks the workflow/step exist before writing.
+     */
+    recordRun(workflowId: string, stepId: string, body: {
+        stepTestId?: string | null;
+        status: string;
+        input?: unknown;
+        output?: unknown;
+        error?: unknown;
+    }): Promise<StepTestRun>;
+}
+//# sourceMappingURL=step-tests.d.ts.map

package/dist/src/console/step-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tests.d.ts","sourceRoot":"","sources":["../../../src/console/step-tests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAQ,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1E;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;;IAGvB;;OAEG;gBACS,IAAI,EAAE,aAAa;IAI/B;;;;;;;;;OASG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACrF,OAAO,CAAC,QAAQ,CAAC;IASpB;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQnE;;;;;;;;;;;;;;;;OAgBG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GACA,OAAO,CAAC,WAAW,CAAC;CAQxB"}

package/dist/src/console/step-tests.js

@@ -0,0 +1,129 @@
+/**
+ * `client.console.stepTests.*` — reusable, workflow-step-scoped test
+ * fixtures for a step's resolved incoming state (`input`) and its params
+ * (`with`), plus their run-log, relocated from the studio's own API client.
+ *
+ * **Studio-internal, not the published partner contract.** This namespace
+ * lives under the `console` subpath export (`@w6w/sdk/console`), excluded from
+ * `endpoints.json` and from the root barrel (`mod.ts`) — see `docs/console.md`
+ * and HITL-1 in this task's contract. `@w6w/sdk`'s instance-state mechanism
+ * pin still applies here exactly as it does to every other namespace
+ * (`docs/implementation.md` §MECHANISM PIN — instance state, never globals):
+ * this class holds no state of its own beyond the injected host, so two
+ * clients in one process never share a credential.
+ *
+ * Three methods relocate from the studio's own `// Saved per-step tests`
+ * comment block (`packages/studio/src/api/client.ts:317-351` on the studio
+ * base tree) — field-for-field, not redesigned. Method names here are
+ * SHORTENED versus `client.ts`'s flat names (`saveStepTest` → `save`,
+ * `listStepTests` → `list`, `recordStepTestRun` → `recordRun`), mirroring
+ * `console.connections.listForApp`/`console.workflows.get`'s own convention:
+ * the domain prefix (`console.stepTests.*`) already disambiguates.
+ *
+ * **`PATCH`/`DELETE /workflows/:workflowId/steps/:stepId/tests/:id` also
+ * exist server-side but have ZERO client-side coverage anywhere (studio or
+ * `@w6w/ui`) — deliberately NOT wrapped here.** Same disposition prior
+ * console domains already established for their own orphan routes
+ * (HITL-4's philosophy applied one step further).
+ *
+ * **`recordRun` returns the REAL created row, not `void`.** Studio's current
+ * `client.ts` discards it to `void` (`.then(() => {})`) only so its `api`
+ * object stays assignable to `@w6w/ui`'s `W6wApi.recordStepTestRun` (typed
+ * `Promise<void>`, `packages/ui/src/provider.tsx:211-221`) — that is
+ * STUDIO's constraint, not the SDK's. Mirrors `./saved-tests.ts`'s
+ * `recordTestRun` exactly; the void-discard happens at studio's own repo
+ * layer (`src/repos/step-tests.ts`, a later task), not here.
+ *
+ * None of these methods take a `project` scoping parameter — step tests
+ * carry no `?project=`, the server scopes by workflow/tenant — so
+ * `StepTestsHost` needs only the transport, mirroring `ConnectionsHost`, not
+ * `DocumentsHost`.
+ *
+ * @module
+ */
+import { path } from "../http.js";
+import { unwrap } from "../types.js";
+/**
+ * The `console.stepTests` namespace on a `W6wClient`.
+ *
+ * @example
+ * ```ts
+ * const fixture = await client.console.stepTests.save("wf_1", "nd_1", {
+ *   input: { foo: "bar" },
+ *   with: { to: "a@b.com" },
+ * });
+ * const fixtures = await client.console.stepTests.list("wf_1", "nd_1");
+ * const run = await client.console.stepTests.recordRun("wf_1", "nd_1", {
+ *   stepTestId: fixture.id,
+ *   status: "succeeded",
+ *   output: { ok: true },
+ * });
+ * ```
+ */
+export class StepTestsApi {
+    #host;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host) {
+        this.#host = host;
+    }
+    /**
+     * Save a step-test fixture.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @param body - Optional `name`, plus `input`/`with`, forwarded verbatim.
+     * @returns The created step test, unwrapped from the `stepTest` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_name`/`invalid_input`/`invalid_with`;
+     * `404 unknown_workflow`.
+     */
+    async save(workflowId, stepId, body) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/workflows/${workflowId}/steps/${stepId}/tests`,
+            body,
+        });
+        return unwrap(res, "stepTest");
+    }
+    /**
+     * List a step's saved test fixtures.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @returns The step tests, unwrapped from the `stepTests` envelope.
+     */
+    async list(workflowId, stepId) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/workflows/${workflowId}/steps/${stepId}/tests`,
+        });
+        return unwrap(res, "stepTests");
+    }
+    /**
+     * Record the outcome of a step-test run. Appends a `step_test_runs` row
+     * (and a best-effort `run_log` ledger row) server-side; when `stepTestId`
+     * is present, the fixture's `lastRun*` fields are updated too.
+     *
+     * Returns the REAL created row — see this module's header. Does NOT
+     * discard to `void`; a caller wanting the studio-facade `void` shape
+     * adapts it themselves.
+     *
+     * @param workflowId - The `wf_…` id.
+     * @param stepId - The step's id within that workflow.
+     * @param body - `stepTestId` (optional), `status`, and optional
+     * `input`/`output`/`error`, forwarded verbatim.
+     * @returns The created `StepTestRun`, unwrapped from the `run` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_body`/`invalid_status`. No `404` — the
+     * route never checks the workflow/step exist before writing.
+     */
+    async recordRun(workflowId, stepId, body) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/workflows/${workflowId}/steps/${stepId}/test-runs`,
+            body,
+        });
+        return unwrap(res, "run");
+    }
+}
+//# sourceMappingURL=step-tests.js.map

package/dist/src/console/step-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-tests.js","sourceRoot":"","sources":["../../../src/console/step-tests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAqB,IAAI,EAAuB,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgDrC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAY;IACd,KAAK,CAAgB;IAE9B;;OAEG;IACH,YAAY,IAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,UAAkB,EAClB,MAAc,EACd,IAAsF;QAEtF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,UAAU,MAAM,QAAQ;YAC1D,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAW,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,MAAc;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,UAAU,MAAM,QAAQ;SAC3D,CAAC,CAAC;QACH,OAAO,MAAM,CAAa,GAAG,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,SAAS,CACb,UAAkB,EAClB,MAAc,EACd,IAMC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,cAAc,UAAU,UAAU,MAAM,YAAY;YAC9D,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAc,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;CACF"}