@w6w/sdk 0.3.0 → 0.5.0

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

@@ -0,0 +1,149 @@
+/**
+ * `client.console.reliability.*` — the account-scoped reliability board,
+ * 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.
+ *
+ * One operation: `list`, `GET /reliability/services`. Unlike `documents`/
+ * `vars`, the server's response carries **no envelope key** — the
+ * `ReliabilityServices`-shaped object IS the top-level response body
+ * (verified against `packages/server/packages/api/admin/reliability.ts:407-432`,
+ * which answers `c.json(board)`) — so `list` returns `res.body` directly and
+ * never calls this package's `unwrap()` helper.
+ *
+ * @module
+ */
+import type { HttpResponse, 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 ReliabilityHost {
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/**
+ * The four states a service (or one of its days) can be in — the RFC's
+ * `HealthReport.state` union (`core/rfcs/healthcheck.md`). There is no fifth
+ * state: a service the account made no calls to is `unknown`, never `ok`.
+ */
+export type ReliabilityState = "ok" | "degraded" | "down" | "unknown";
+/** The error mix the server counts per service and per day. Names are wire-pinned. */
+export interface ReliabilityErrorMix {
+    e4xx: number;
+    e429: number;
+    eAuth: number;
+    e5xx: number;
+}
+/** One calendar day of one service's uptime strip. */
+export interface ReliabilityUptimeDay {
+    day: string;
+    state: ReliabilityState;
+    calls: number;
+    errors: ReliabilityErrorMix;
+}
+/** The vendor's own verdict for one service. See `ReliabilityService.vendorStatus`. */
+export interface ReliabilityVendorStatus {
+    state: ReliabilityState;
+    /** The deciding check's own words, rendered verbatim. Null when all clear. */
+    message: string | null;
+    checkedAt: string;
+    /** Keys of the checks behind a non-`ok` verdict. Empty when `ok`. */
+    attributedTo: string[];
+}
+/** One row of the service board — a single external service the account calls. */
+export interface ReliabilityService {
+    appId: string;
+    displayName: string;
+    state: ReliabilityState;
+    hasDeclaredHealth: boolean;
+    calls: number;
+    errors: ReliabilityErrorMix;
+    /** Null when the window holds no timed calls (the board renders "—"). */
+    p95Ms: number | null;
+    openAdvisories: number;
+    /** Non-null while an outage is still open. */
+    ongoingOutageId: string | null;
+    /** Null when the account has never called this service. Drives the server's
+     * recency ordering (`?limit=N`) — the client never re-sorts by it. */
+    lastCallAt: string | null;
+    /**
+     * Gap-free, exactly `window.days` entries, ONE PER CALENDAR DAY, OLDEST FIRST —
+     * including days with no data (`state: "unknown"`, `calls: 0`). The client
+     * never synthesises a missing day and never re-sorts: if entries are missing or
+     * out of order that is a server bug to report, not to paper over.
+     */
+    uptime: ReliabilityUptimeDay[];
+    /**
+     * What the VENDOR publishes about itself, from the app's declared public
+     * health check (Slack's `status.slack.com`, SendGrid's status page, …).
+     *
+     * A SECOND, INDEPENDENT signal — never a restatement of `state` above, which
+     * is strictly "did your calls succeed". Your credential can be revoked while
+     * the vendor is green, and the vendor can be down in a window where you made
+     * no calls at all, so the board shows both and folds neither into the other.
+     *
+     * `null` means the app publishes no public check — a different fact from
+     * `state: "unknown"` ("it publishes one and we could not read it"), and the
+     * board renders them differently.
+     */
+    vendorStatus: ReliabilityVendorStatus | null;
+}
+/**
+ * Account-scoped reliability board (server `GET /reliability/services?days=…`,
+ * T4.1.1). A free-form fetch seam, so this shape mirrors the server envelope
+ * field for field — the field names below are PINNED by
+ * `contracts/T4.1.1.contract.md` and must not be renamed on either side. This
+ * relocates that pin from `packages/studio/src/api/client.ts:212-295` rather
+ * than redesigning it.
+ */
+export interface ReliabilityServices {
+    account: string;
+    window: {
+        from: string;
+        to: string;
+        days: number;
+    };
+    /** The server's own wording for what "uptime" measures here — displayed verbatim. */
+    uptimeMeans: string;
+    definition: {
+        id: string;
+        version: string;
+        source: string;
+    };
+    services: ReliabilityService[];
+}
+/**
+ * The `console.reliability` namespace on a `W6WClient`.
+ *
+ * @example
+ * ```ts
+ * const board = await client.console.reliability.list(30, 5);
+ * ```
+ */
+export declare class ReliabilityApi {
+    #private;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host: ReliabilityHost);
+    /**
+     * Fetch the account-scoped reliability board.
+     *
+     * @param days - The window size in days. Omitted, the server applies its own default.
+     * @param limit - Cap on the number of services returned, most-recently-called first. Omitted, no cap.
+     * @returns The board, exactly as the server sent it — no envelope key to peel.
+     * @throws {ApiError} On any non-2xx.
+     */
+    list(days?: number, limit?: number): Promise<ReliabilityServices>;
+}
+//# sourceMappingURL=reliability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.d.ts","sourceRoot":"","sources":["../../../src/console/reliability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtE,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,uFAAuF;AACvF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,gBAAgB,CAAC;IACxB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;0EACsE;IACtE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B;;;;;;;;;;;;OAYG;IACH,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;;IAGzB;;OAEG;gBACS,IAAI,EAAE,eAAe;IAIjC;;;;;;;OAOG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQxE"}

package/dist/src/console/reliability.js

@@ -0,0 +1,56 @@
+/**
+ * `client.console.reliability.*` — the account-scoped reliability board,
+ * 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.
+ *
+ * One operation: `list`, `GET /reliability/services`. Unlike `documents`/
+ * `vars`, the server's response carries **no envelope key** — the
+ * `ReliabilityServices`-shaped object IS the top-level response body
+ * (verified against `packages/server/packages/api/admin/reliability.ts:407-432`,
+ * which answers `c.json(board)`) — so `list` returns `res.body` directly and
+ * never calls this package's `unwrap()` helper.
+ *
+ * @module
+ */
+/**
+ * The `console.reliability` namespace on a `W6WClient`.
+ *
+ * @example
+ * ```ts
+ * const board = await client.console.reliability.list(30, 5);
+ * ```
+ */
+export class ReliabilityApi {
+    #host;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host) {
+        this.#host = host;
+    }
+    /**
+     * Fetch the account-scoped reliability board.
+     *
+     * @param days - The window size in days. Omitted, the server applies its own default.
+     * @param limit - Cap on the number of services returned, most-recently-called first. Omitted, no cap.
+     * @returns The board, exactly as the server sent it — no envelope key to peel.
+     * @throws {ApiError} On any non-2xx.
+     */
+    async list(days, limit) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: "/reliability/services",
+            query: { days, limit },
+        });
+        return res.body;
+    }
+}
+//# sourceMappingURL=reliability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reliability.js","sourceRoot":"","sources":["../../../src/console/reliability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAwGH;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAChB,KAAK,CAAkB;IAEhC;;OAEG;IACH,YAAY,IAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,IAAa,EAAE,KAAc;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB;YACxD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;SACvB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;CACF"}

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

@@ -0,0 +1,198 @@
+/**
+ * `client.console.savedTests.*` — reusable, connection-scoped named test
+ * inputs for an app action, plus the tester's 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.
+ *
+ * Six methods relocate from the studio's own `// Saved tests` comment block
+ * (`packages/studio/src/api/client.ts:259-315` on the studio base tree) —
+ * field-for-field, not redesigned.
+ *
+ * **`recordTestRun` 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.recordTestRun`
+ * (typed `Promise<void>`, `packages/ui/src/provider.tsx:168-177`) — that is
+ * STUDIO's constraint, not the SDK's. Mirrors T2.2.1's `deleteApp` precedent:
+ * a "complete client" returns genuinely informative data and discards only
+ * boilerplate (`delete` below discards the true-boilerplate `{ok:true}`).
+ * The void-discard for `recordTestRun` happens at studio's own repo layer
+ * (`src/repos/saved-tests.ts`, a later task), not here.
+ *
+ * None of these methods take a `project` scoping parameter — saved tests
+ * carry no `?project=`, the server scopes by connection/tenant — so
+ * `SavedTestsHost` 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 SavedTestsHost {
+    /** Perform one request. */
+    request<T>(options: RequestOptions): Promise<HttpResponse<T>>;
+}
+/**
+ * A saved test — a named set of input values for an app action, scoped to a
+ * connection. Lets a caller re-run an action with a remembered payload.
+ */
+export interface SavedTest {
+    id: string;
+    connectionId: string;
+    appId: string;
+    actionKey: string;
+    name: string;
+    values: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    /** When this saved test was last run (ISO), or null/undefined if never run. */
+    lastRunAt?: string | null;
+    /** Whether the most recent run succeeded, or null/undefined if never run. */
+    lastRunOk?: boolean | null;
+    /** Short headline for the most recent run's outcome, or null/undefined if never run. */
+    lastRunSummary?: string | null;
+}
+/**
+ * One row from a connection's `run_log`-backed test-run history (thin — NOT
+ * the full `SavedTestRun` create response; the full `result` payload stays
+ * server-side).
+ */
+export interface TestRunSummary {
+    id: string;
+    actionKey: string;
+    ok: boolean;
+    summary: string | null;
+    occurredAt: string;
+}
+/** The real row `recordTestRun` creates (mirrors the server's `SavedTestRun`). */
+export interface SavedTestRun {
+    id: string;
+    savedTestId: string | null;
+    connectionId: string;
+    appId: string;
+    actionKey: string;
+    ok: boolean;
+    summary: string | null;
+    result: unknown;
+    createdAt: string;
+}
+/**
+ * The `console.savedTests` namespace on a `W6WClient`.
+ *
+ * @example
+ * ```ts
+ * const tests = await client.console.savedTests.list("conn_1");
+ * const created = await client.console.savedTests.create("conn_1", {
+ *   actionKey: "send",
+ *   name: "Happy path",
+ *   values: { to: "a@b.com" },
+ * });
+ * const run = await client.console.savedTests.recordTestRun("conn_1", {
+ *   savedTestId: created.id,
+ *   actionKey: "send",
+ *   ok: true,
+ * });
+ * await client.console.savedTests.delete("conn_1", created.id);
+ * ```
+ */
+export declare class SavedTestsApi {
+    #private;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host: SavedTestsHost);
+    /**
+     * List a connection's saved tests.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @returns The saved tests, unwrapped from the `savedTests` envelope.
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    list(connectionId: string): Promise<SavedTest[]>;
+    /**
+     * Create a saved test for a connection.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param body - `actionKey` and `name` (unique per connection), plus the
+     * `values` payload to remember — forwarded verbatim.
+     * @returns The created saved test, unwrapped from the `savedTest` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_name`/`invalid_action_key`/`invalid_values`;
+     * `404 unknown_connection`; `409 duplicate_saved_test`.
+     */
+    create(connectionId: string, body: {
+        actionKey: string;
+        name: string;
+        values: Record<string, unknown>;
+    }): Promise<SavedTest>;
+    /**
+     * Update a saved test: rename it and/or replace its `values`.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param id - The saved test's id.
+     * @param patch - `name` and/or `values`, forwarded verbatim.
+     * @returns The updated saved test, unwrapped from the `savedTest` envelope.
+     * @throws {ApiError} `400 invalid_name`/`invalid_values`; `404 unknown_saved_test`;
+     * `409 duplicate_saved_test`.
+     */
+    update(connectionId: string, id: string, patch: {
+        name?: string;
+        values?: Record<string, unknown>;
+    }): Promise<SavedTest>;
+    /**
+     * Delete a saved test.
+     *
+     * Returns nothing: the server's `{ok: true}` carries no information a
+     * caller can use — true boilerplate, unlike {@linkcode recordTestRun}
+     * below, which preserves its real row.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param id - The saved test's id.
+     * @throws {ApiError} `404 unknown_saved_test` when there is no such id.
+     */
+    delete(connectionId: string, id: string): Promise<void>;
+    /**
+     * Record the outcome of an action-test run against a connection. Appends a
+     * run-log row server-side; when `savedTestId` is present, the saved test'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 connectionId - The `conn_…` id.
+     * @param body - `savedTestId` (optional), `actionKey`, `ok`, and optional
+     * `summary`/`result`, forwarded verbatim.
+     * @returns The created `SavedTestRun`, unwrapped from the `run` envelope (the server answers `201`).
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    recordTestRun(connectionId: string, body: {
+        savedTestId?: string | null;
+        actionKey: string;
+        ok: boolean;
+        summary?: string;
+        result?: unknown;
+    }): Promise<SavedTestRun>;
+    /**
+     * Run history for a connection from the unified `run_log` ledger — thin
+     * rows; the full `result` payload from {@linkcode recordTestRun} stays
+     * server-side.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @returns The runs, most-recent-first, unwrapped from the `runs` envelope.
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    listTestRuns(connectionId: string): Promise<TestRunSummary[]>;
+}
+//# sourceMappingURL=saved-tests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"saved-tests.d.ts","sourceRoot":"","sources":["../../../src/console/saved-tests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAQ,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;;IAGxB;;OAEG;gBACS,IAAI,EAAE,cAAc;IAIhC;;;;;;OAMG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQtD;;;;;;;;;OASG;IACG,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACzE,OAAO,CAAC,SAAS,CAAC;IASrB;;;;;;;;;OASG;IACG,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACzD,OAAO,CAAC,SAAS,CAAC;IASrB;;;;;;;;;;OAUG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;QACJ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,EAAE,EAAE,OAAO,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GACA,OAAO,CAAC,YAAY,CAAC;IASxB;;;;;;;;OAQG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAOpE"}

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

@@ -0,0 +1,172 @@
+/**
+ * `client.console.savedTests.*` — reusable, connection-scoped named test
+ * inputs for an app action, plus the tester's 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.
+ *
+ * Six methods relocate from the studio's own `// Saved tests` comment block
+ * (`packages/studio/src/api/client.ts:259-315` on the studio base tree) —
+ * field-for-field, not redesigned.
+ *
+ * **`recordTestRun` 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.recordTestRun`
+ * (typed `Promise<void>`, `packages/ui/src/provider.tsx:168-177`) — that is
+ * STUDIO's constraint, not the SDK's. Mirrors T2.2.1's `deleteApp` precedent:
+ * a "complete client" returns genuinely informative data and discards only
+ * boilerplate (`delete` below discards the true-boilerplate `{ok:true}`).
+ * The void-discard for `recordTestRun` happens at studio's own repo layer
+ * (`src/repos/saved-tests.ts`, a later task), not here.
+ *
+ * None of these methods take a `project` scoping parameter — saved tests
+ * carry no `?project=`, the server scopes by connection/tenant — so
+ * `SavedTestsHost` needs only the transport, mirroring `ConnectionsHost`, not
+ * `DocumentsHost`.
+ *
+ * @module
+ */
+import { path } from "../http.js";
+import { unwrap } from "../types.js";
+/**
+ * The `console.savedTests` namespace on a `W6WClient`.
+ *
+ * @example
+ * ```ts
+ * const tests = await client.console.savedTests.list("conn_1");
+ * const created = await client.console.savedTests.create("conn_1", {
+ *   actionKey: "send",
+ *   name: "Happy path",
+ *   values: { to: "a@b.com" },
+ * });
+ * const run = await client.console.savedTests.recordTestRun("conn_1", {
+ *   savedTestId: created.id,
+ *   actionKey: "send",
+ *   ok: true,
+ * });
+ * await client.console.savedTests.delete("conn_1", created.id);
+ * ```
+ */
+export class SavedTestsApi {
+    #host;
+    /**
+     * @param host - The client this namespace issues requests through.
+     */
+    constructor(host) {
+        this.#host = host;
+    }
+    /**
+     * List a connection's saved tests.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @returns The saved tests, unwrapped from the `savedTests` envelope.
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    async list(connectionId) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/connections/${connectionId}/saved-tests`,
+        });
+        return unwrap(res, "savedTests");
+    }
+    /**
+     * Create a saved test for a connection.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param body - `actionKey` and `name` (unique per connection), plus the
+     * `values` payload to remember — forwarded verbatim.
+     * @returns The created saved test, unwrapped from the `savedTest` envelope (the server answers `201`).
+     * @throws {ApiError} `400 invalid_name`/`invalid_action_key`/`invalid_values`;
+     * `404 unknown_connection`; `409 duplicate_saved_test`.
+     */
+    async create(connectionId, body) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/connections/${connectionId}/saved-tests`,
+            body,
+        });
+        return unwrap(res, "savedTest");
+    }
+    /**
+     * Update a saved test: rename it and/or replace its `values`.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param id - The saved test's id.
+     * @param patch - `name` and/or `values`, forwarded verbatim.
+     * @returns The updated saved test, unwrapped from the `savedTest` envelope.
+     * @throws {ApiError} `400 invalid_name`/`invalid_values`; `404 unknown_saved_test`;
+     * `409 duplicate_saved_test`.
+     */
+    async update(connectionId, id, patch) {
+        const res = await this.#host.request({
+            method: "PATCH",
+            path: path `/connections/${connectionId}/saved-tests/${id}`,
+            body: patch,
+        });
+        return unwrap(res, "savedTest");
+    }
+    /**
+     * Delete a saved test.
+     *
+     * Returns nothing: the server's `{ok: true}` carries no information a
+     * caller can use — true boilerplate, unlike {@linkcode recordTestRun}
+     * below, which preserves its real row.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @param id - The saved test's id.
+     * @throws {ApiError} `404 unknown_saved_test` when there is no such id.
+     */
+    async delete(connectionId, id) {
+        await this.#host.request({
+            method: "DELETE",
+            path: path `/connections/${connectionId}/saved-tests/${id}`,
+        });
+    }
+    /**
+     * Record the outcome of an action-test run against a connection. Appends a
+     * run-log row server-side; when `savedTestId` is present, the saved test'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 connectionId - The `conn_…` id.
+     * @param body - `savedTestId` (optional), `actionKey`, `ok`, and optional
+     * `summary`/`result`, forwarded verbatim.
+     * @returns The created `SavedTestRun`, unwrapped from the `run` envelope (the server answers `201`).
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    async recordTestRun(connectionId, body) {
+        const res = await this.#host.request({
+            method: "POST",
+            path: path `/connections/${connectionId}/test-runs`,
+            body,
+        });
+        return unwrap(res, "run");
+    }
+    /**
+     * Run history for a connection from the unified `run_log` ledger — thin
+     * rows; the full `result` payload from {@linkcode recordTestRun} stays
+     * server-side.
+     *
+     * @param connectionId - The `conn_…` id.
+     * @returns The runs, most-recent-first, unwrapped from the `runs` envelope.
+     * @throws {ApiError} `404 unknown_connection` when there is no such connection.
+     */
+    async listTestRuns(connectionId) {
+        const res = await this.#host.request({
+            method: "GET",
+            path: path `/connections/${connectionId}/test-runs`,
+        });
+        return unwrap(res, "runs");
+    }
+}
+//# sourceMappingURL=saved-tests.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"saved-tests.js","sourceRoot":"","sources":["../../../src/console/saved-tests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAqB,IAAI,EAAuB,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA4DrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAa;IACf,KAAK,CAAiB;IAE/B;;OAEG;IACH,YAAY,IAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,YAAoB;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,cAAc;SACrD,CAAC,CAAC;QACH,OAAO,MAAM,CAAc,GAAG,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,IAA0E;QAE1E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,cAAc;YACpD,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAY,GAAG,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,EAAU,EACV,KAA0D;QAE1D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,gBAAgB,EAAE,EAAE;YAC1D,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,OAAO,MAAM,CAAY,GAAG,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,YAAoB,EAAE,EAAU;QAC3C,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAChC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,gBAAgB,EAAE,EAAE;SAC3D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,IAMC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,YAAY;YAClD,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAe,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,YAAoB;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAA,gBAAgB,YAAY,YAAY;SACnD,CAAC,CAAC;QACH,OAAO,MAAM,CAAmB,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF"}