@elaraai/e3-api-tests 1.0.84 → 1.0.86

package/README.md

@@ -47,19 +47,31 @@ The suites call as two callers:
 
 A server with no auth answers any token. One with auth needs both tokens signed or fetched, as `test/integration/src/api-compliance.spec.ts` signs them for the local server.
 
+A harness whose server answers requests in its own process, such as e3 running in a page, gives `fetch`. Every request of the suites then goes through it: the client's calls, the suites' own requests (`ctx.fetch`) and e3's platform functions. `test/integration/src/api-compliance-fetch.spec.ts` runs the suites through a `fetch` that forwards to the local server, while the global `fetch` refuses every request.
+
+A harness whose server runs no commands, such as e3 running in a page, sets `commands: false`. The suites' tasks are East, which every server runs, and their failing tasks fail in East: each is recorded `failed`, exit code 1, with its message in its stderr log. One case in `dataflowTests` runs a command, a custom task that exits 1. On a server that runs commands it expects that task `failed`, exit code 1; on one that runs none, recorded `error`, with a message saying the server runs no commands.
+
 ## Exports
 
 | Export | Description |
 |--------|-------------|
 | `TestSetup<T>` | Type for per-test context factory: `(t: TestContext) => Promise<T>` |
 | `createTestContext` | Create test context with helpers for setup/teardown |
-| `allApiTests` | Register all API test suites (repository, packages, workspaces, datasets, dataflow) |
+| `allApiTests` | Register every API test suite of `apiTestSuites`: repository, packages, workspaces, datasets, dataset pages, dataset transfer, dataflow, functions, records, keyed records, record deploys, package transfer and platform |
+| `apiTestSuites` | Every API test suite by name, in the order `allApiTests` registers them: for a harness that runs them in parts, and checks its parts name each once |
 | `allTests` | Register all tests including CLI tests (requires credentials env) |
 | `repositoryTests` | Repository CRUD tests |
 | `packageTests` | Package import/export tests |
 | `workspaceTests` | Workspace management tests |
 | `datasetTests` | Dataset read/write tests |
+| `datasetPageTests` | Paged dataset reads and key search |
+| `datasetTransferTests` | Dataset uploads and downloads through the transfer protocol |
 | `dataflowTests` | Dataflow execution tests |
+| `functionTests` | Function calls, one-shots and split calls, as an admin and as a reader |
+| `recordTests` | Record mutations |
+| `keyedRecordTests` | Keyed records: every write form, and their indexes |
+| `recordDeployTests` | Records across deploys: migrations |
+| `packageTransferTests` | Package imports and exports as jobs |
 | `platformTests` | Platform capability tests |
 | `cliTests` | CLI integration tests |
 | `transferTests` | Cross-repository transfer tests |

package/dist/src/assertions.d.ts

@@ -2,6 +2,21 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
+/**
+ * Names no workspace can have, each with why, as a refusal says it: a lock's
+ * name (`main#dataflow`, the lock a run of main's dataflow holds), the
+ * characters that join a lock's parts, and one a file name cannot hold.
+ */
+export declare const MALFORMED_WORKSPACE_NAMES: readonly [readonly ["main#dataflow", string], readonly ["a#b", string], readonly ["a~b", string], readonly ["bad:name", "holds \":\", which a file name cannot"]];
+/**
+ * Checks an error is the API's refusal of `name` as no workspace's:
+ * `invalid_name`, whose details name the kind, the name and why.
+ *
+ * @param name - The name refused
+ * @param why - Why, as the refusal's message ends
+ * @returns An `assert.rejects` validator
+ */
+export declare function refusedAsWorkspaceName(name: string, why: string): (err: unknown) => true;
 /** A single task entry in a dataflow result (subset we read for diagnostics). */
 interface TaskResultLike {
     name: string;

package/dist/src/assertions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/assertions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,iFAAiF;AACjF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iEAAiE;AACjE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAcD,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAO1F"}
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/assertions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,mKAK5B,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAYxF;AAED,iFAAiF;AACjF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iEAAiE;AACjE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAcD,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAMzE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAO1F"}

package/dist/src/assertions.js

@@ -3,7 +3,8 @@
  * Licensed under BSL 1.1. See LICENSE for details.
  */
 /**
- * Diagnostic assertions for dataflow execution results.
+ * Assertions the suites share: of a dataflow's result, and of the API's
+ * refusal of a name no workspace can have.
  *
  * A bare `assert.strictEqual(result.success, true)` collapses a rich
  * failure — a task that exited non-zero, a runner that failed to spawn,
@@ -12,8 +13,50 @@
  * `.ref` rename-over-open can transiently fail). These helpers fold the
  * per-task diagnostics already carried in `result.tasks` into the
  * assertion message so the next failure is actionable instead of opaque.
+ *
+ * Every route of a workspace refuses a name no workspace can have before it
+ * takes a lock, as `invalid_name` of a workspace: a lock's name may hold the
+ * `#` and `~` that join its parts, so a route that took a lock first would
+ * refuse such a name as a lock's, if at all.
  */
 import assert from 'node:assert/strict';
+import { equalFor, isValueOf, printFor } from '@elaraai/east';
+import { InvalidNameErrorType } from '@elaraai/e3-types';
+import { ApiError } from '@elaraai/e3-api-client';
+/** Why no workspace's name may hold `c`: it joins the parts of a lock's name. */
+const joinsLockNames = (c) => `holds ${JSON.stringify(c)}, which joins the parts of a lock's name`;
+/**
+ * Names no workspace can have, each with why, as a refusal says it: a lock's
+ * name (`main#dataflow`, the lock a run of main's dataflow holds), the
+ * characters that join a lock's parts, and one a file name cannot hold.
+ */
+export const MALFORMED_WORKSPACE_NAMES = [
+    ['main#dataflow', joinsLockNames('#')],
+    ['a#b', joinsLockNames('#')],
+    ['a~b', joinsLockNames('~')],
+    ['bad:name', `holds ":", which a file name cannot`],
+];
+/**
+ * Checks an error is the API's refusal of `name` as no workspace's:
+ * `invalid_name`, whose details name the kind, the name and why.
+ *
+ * @param name - The name refused
+ * @param why - Why, as the refusal's message ends
+ * @returns An `assert.rejects` validator
+ */
+export function refusedAsWorkspaceName(name, why) {
+    return (err) => {
+        assert.ok(err instanceof ApiError, `${name}: expected ApiError, got ${err}`);
+        assert.strictEqual(err.code, 'invalid_name');
+        assert.ok(isValueOf(err.details, InvalidNameErrorType), `${name}: the refusal names the name and why`);
+        const said = err.details;
+        const expected = {
+            kind: 'workspace', name, message: `the workspace name ${JSON.stringify(name)} ${why}`,
+        };
+        assert.ok(equalFor(InvalidNameErrorType)(said, expected), `${name}: refused as ${printFor(InvalidNameErrorType)(said)}`);
+        return true;
+    };
+}
 /** Render one task's terminal state, surfacing exit code / error message. */
 function describeTask(task) {
     const { type, value } = task.state;

package/dist/src/assertions.js.map

@@ -1 +1 @@
-{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/assertions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAoBxC,6EAA6E;AAC7E,SAAS,YAAY,CAAC,IAAoB;IACxC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IACnC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QACnF,MAAM,GAAG,oBAAoB,MAAM,CAAE,KAA+B,CAAC,QAAQ,CAAC,GAAG,CAAC;IACpF,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACxF,MAAM,GAAG,UAAU,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;AACxE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAC/D,MAAM,MAAM,GACV,YAAY,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,MAAM,GAAG;QACtD,UAAU,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA0B,EAAE,OAAgB;IAClF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,EACd,IAAI,EACJ,GAAG,MAAM,gDAAgD,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAC1F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/assertions.ts"],"names":[],"mappings":"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"}

package/dist/src/context.d.ts

@@ -22,6 +22,29 @@ export interface TestConfig {
     repoName?: string;
     /** Whether to clean up created resources (default: true) */
     cleanup?: boolean;
+    /**
+     * The `fetch` every request of the suites goes through: the client calls
+     * (`RequestOptions.fetch`), the suites' own requests ({@link TestContext.fetch})
+     * and e3's platform functions. Absent, the global `fetch`.
+     *
+     * @remarks
+     * A harness whose server answers requests in the process itself — e3
+     * running in a page — gives the `fetch` that reaches it.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Whether the server runs commands, such as a custom task's (default true).
+     * The dataflow suite's one command case runs a custom task whose command
+     * fails: a server that runs commands records it `failed`, exit code 1, and
+     * one that runs none records it `error`, with a message saying the server
+     * runs no commands.
+     *
+     * @remarks
+     * Every other task the suites run is East, which every server runs, their
+     * failing tasks included. A harness whose server runs no commands — e3
+     * running in a page — sets it false.
+     */
+    commands?: boolean;
 }
 /**
  * Context provided to each test suite.
@@ -38,6 +61,12 @@ export interface TestContext {
     /** Get request options with a reader's token for this repository
      *  ({@link TestConfig.getReaderToken}) */
     readerOpts: () => Promise<RequestOptions>;
+    /** The `fetch` a suite's own requests go through: {@link TestConfig.fetch},
+     *  or the global `fetch` when the harness gives none. */
+    fetch: typeof globalThis.fetch;
+    /** Whether the server runs commands: {@link TestConfig.commands}, or true
+     *  when the harness does not say. */
+    commands: boolean;
     /** Create a test package and return path to zip file */
     createPackage: (name: string, version: string) => Promise<string>;
     /** Import a package from a zip file */

package/dist/src/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AAqB5E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,UAAU,CAAC;IAEnB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpC;8CAC0C;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1C,wDAAwD;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAElE,uCAAuC;IACvC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,yBAAyB;IACzB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,sCAAsC;IACtC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,kCAAkC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAgCD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAuHhF"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AAsB5E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAElD,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,MAAM,EAAE,UAAU,CAAC;IAEnB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpC;8CAC0C;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAE1C;6DACyD;IACzD,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAE/B;yCACqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAElE,uCAAuC;IACvC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,yBAAyB;IACzB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,sCAAsC;IACtC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,kCAAkC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAgCD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA8HhF"}

package/dist/src/context.js

@@ -8,7 +8,7 @@
 import { mkdtempSync, rmSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { tmpdir } from 'node:os';
-import { ApiError, repoCreate, repoRemove, packageImport, workspaceCreate, workspaceDeploy, workspaceList, workspaceRemove, dataflowCancel, } from '@elaraai/e3-api-client';
+import { ApiError, requestFetch, repoCreate, repoRemove, packageImport, workspaceCreate, workspaceDeploy, workspaceList, workspaceRemove, dataflowCancel, } from '@elaraai/e3-api-client';
 import { createPackageZip } from './fixtures.js';
 /**
  * How long cleanup waits for a cancelled dataflow to release its workspace
@@ -57,10 +57,12 @@ export async function createTestContext(config) {
     let createdRepo = false;
     // Determine repo name - use provided or generate unique one
     const repoName = config.repoName ?? `test-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    /** Request options for a caller's token, through the harness's `fetch`. */
+    const requestOptions = (token) => (config.fetch === undefined ? { token } : { token, fetch: config.fetch });
     // Create repo if not using an existing one
     if (!config.repoName) {
         const token = await config.getToken();
-        await repoCreate(config.baseUrl, repoName, { token });
+        await repoCreate(config.baseUrl, repoName, requestOptions(token));
         createdRepo = true;
     }
     /**
@@ -94,8 +96,10 @@ export async function createTestContext(config) {
         config,
         repoName,
         tempDir,
-        opts: async () => ({ token: await config.getToken() }),
-        readerOpts: async () => ({ token: await config.getReaderToken(repoName) }),
+        opts: async () => requestOptions(await config.getToken()),
+        readerOpts: async () => requestOptions(await config.getReaderToken(repoName)),
+        fetch: (input, init) => requestFetch(config)(input, init),
+        commands: config.commands ?? true,
         createPackage: async (name, version) => {
             const zipPath = await createPackageZip(tempDir, name, version);
             return zipPath;
@@ -103,24 +107,23 @@ export async function createTestContext(config) {
         importPackage: async (zipPath) => {
             const token = await config.getToken();
             const packageZip = readFileSync(zipPath);
-            const result = await packageImport(config.baseUrl, repoName, packageZip, { token });
+            const result = await packageImport(config.baseUrl, repoName, packageZip, requestOptions(token));
             createdPackages.push({ name: result.name, version: result.version });
         },
         createWorkspace: async (name) => {
             const token = await config.getToken();
-            await workspaceCreate(config.baseUrl, repoName, name, { token });
+            await workspaceCreate(config.baseUrl, repoName, name, requestOptions(token));
             createdWorkspaces.push(name);
         },
         deployPackage: async (workspace, pkgRef) => {
             const token = await config.getToken();
-            await workspaceDeploy(config.baseUrl, repoName, workspace, pkgRef, { token });
+            await workspaceDeploy(config.baseUrl, repoName, workspace, pkgRef, requestOptions(token));
         },
         cleanup: async () => {
             if (config.cleanup === false) {
                 return;
             }
-            const token = await config.getToken();
-            const opts = { token };
+            const opts = requestOptions(await config.getToken());
             try {
                 if (createdRepo) {
                     // Cancel running dataflows and delete all workspaces (required before repo deletion)

package/dist/src/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"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"}

package/dist/src/fixtures.d.ts

@@ -191,12 +191,38 @@ export declare function createStringPackageZip(tempDir: string, name: string, ve
  * @returns Path to the created zip file
  */
 export declare function createDiamondPackageZip(tempDir: string, name: string, version: string): Promise<string>;
+/**
+ * Create a package whose task writes known lines to its stdout.
+ *
+ * Creates a package with:
+ * - Input: "lines" (Integer, default 3)
+ * - Task: "log" - writes `line 0` … `line <lines - 1>` to stdout, a line
+ *   each, and returns how many it wrote
+ *
+ * With the default input its stdout log is {@link LOGGED_LINES}, every
+ * server's alike, which a read of the log by offset and limit is checked
+ * against.
+ *
+ * @param tempDir - Directory to write the zip file
+ * @param name - Package name
+ * @param version - Package version
+ * @returns Path to the created zip file
+ */
+export declare function createLoggingPackageZip(tempDir: string, name: string, version: string): Promise<string>;
+/** The stdout log of {@link createLoggingPackageZip}'s task, run on its
+ *  default input. */
+export declare const LOGGED_LINES = "line 0\nline 1\nline 2\n";
 /**
  * Create a package with a task that always fails.
  *
  * Creates a package with:
  * - Input: "value" (String, default "test")
- * - Task: "failing" - exits with code 1
+ * - Task: "failing" - fails in East as it runs, with the message "failing
+ *   fails, given test"
+ *
+ * The failure is the East body's own, so every server runs it, one that runs
+ * no commands included. A server records it as the runner protocol does: the
+ * task `failed`, exit code 1, with the message in its stderr log.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name
@@ -204,6 +230,23 @@ export declare function createDiamondPackageZip(tempDir: string, name: string, v
  * @returns Path to the created zip file
  */
 export declare function createFailingPackageZip(tempDir: string, name: string, version: string): Promise<string>;
+/**
+ * Create a package whose task runs a command, which fails.
+ *
+ * Creates a package with:
+ * - Input: "value" (String, default "test")
+ * - Task: "command" - a custom task whose command is `exit 1`
+ *
+ * The suites' one command task. A server that runs commands records it
+ * `failed`, exit code 1; one that runs none records it `error`, saying it runs
+ * no commands (`TestConfig.commands`).
+ *
+ * @param tempDir - Directory to write the zip file
+ * @param name - Package name
+ * @param version - Package version
+ * @returns Path to the created zip file
+ */
+export declare function createCommandPackageZip(tempDir: string, name: string, version: string): Promise<string>;
 /**
  * Create a package with a slow task for testing concurrency/cancellation.
  *
@@ -226,10 +269,12 @@ export declare function createSlowPackageZip(tempDir: string, name: string, vers
  * - Input: "b" (Integer, default 4)
  * - Task: "succeed_a" - returns a + b (succeeds)
  * - Task: "succeed_b" - returns a * b (succeeds)
- * - Task: "fail_c" - exits with code 1 (always fails)
+ * - Task: "fail_c" - fails in East as it runs, with the message "fail_c fails,
+ *   given 3" (always fails)
  *
  * All tasks are independent — dispatched in the same Map iteration.
- * Stresses apply-results serialization with mixed success/failure.
+ * Stresses apply-results serialization with mixed success/failure. Every task
+ * is East, so every server runs them.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name
@@ -244,10 +289,12 @@ export declare function createParallelMixedPackageZip(tempDir: string, name: str
  * - Input: "a" (Integer, default 10)
  * - Input: "b" (Integer, default 5)
  * - Task: "left" - returns a + b (succeeds)
- * - Task: "right" - exits with code 1 (always fails)
+ * - Task: "right" - fails in East as it runs, with the message "right fails,
+ *   given 10" (always fails)
  * - Task: "merge" - depends on left.output + right.output (should be skipped)
  *
  * Tests that merge is properly skipped and the dataflow completes without stalling.
+ * Every task is East, so every server runs them.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name

package/dist/src/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/fixtures.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/src/fixtures.js

@@ -12,7 +12,7 @@ import { mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import e3 from '@elaraai/e3';
 import { ArrayType, DictType, FunctionType, IntegerType, NullType, StringType, StructType, East, variant } from '@elaraai/east';
-import { Time } from '@elaraai/east-node-std';
+import { Console, Time } from '@elaraai/east-node-std';
 /**
  * Create a simple compute package for testing.
  *
@@ -313,12 +313,53 @@ export async function createDiamondPackageZip(tempDir, name, version) {
     await e3.export(pkg, zipPath);
     return zipPath;
 }
+/**
+ * Create a package whose task writes known lines to its stdout.
+ *
+ * Creates a package with:
+ * - Input: "lines" (Integer, default 3)
+ * - Task: "log" - writes `line 0` … `line <lines - 1>` to stdout, a line
+ *   each, and returns how many it wrote
+ *
+ * With the default input its stdout log is {@link LOGGED_LINES}, every
+ * server's alike, which a read of the log by offset and limit is checked
+ * against.
+ *
+ * @param tempDir - Directory to write the zip file
+ * @param name - Package name
+ * @param version - Package version
+ * @returns Path to the created zip file
+ */
+export async function createLoggingPackageZip(tempDir, name, version) {
+    mkdirSync(tempDir, { recursive: true });
+    const lines = e3.input('lines', IntegerType, variant('value', 3n));
+    const task = e3.task('log', [lines], East.function([IntegerType], IntegerType, ($, n) => {
+        const i = $.let(0n);
+        $.while(East.less(i, n), ($) => {
+            $(Console.log(East.str `line ${i}`));
+            $.assign(i, i.add(1n));
+        });
+        return n;
+    }));
+    const pkg = e3.package(name, version, task);
+    const zipPath = join(tempDir, `${name}-${version}.zip`);
+    await e3.export(pkg, zipPath);
+    return zipPath;
+}
+/** The stdout log of {@link createLoggingPackageZip}'s task, run on its
+ *  default input. */
+export const LOGGED_LINES = 'line 0\nline 1\nline 2\n';
 /**
  * Create a package with a task that always fails.
  *
  * Creates a package with:
  * - Input: "value" (String, default "test")
- * - Task: "failing" - exits with code 1
+ * - Task: "failing" - fails in East as it runs, with the message "failing
+ *   fails, given test"
+ *
+ * The failure is the East body's own, so every server runs it, one that runs
+ * no commands included. A server records it as the runner protocol does: the
+ * task `failed`, exit code 1, with the message in its stderr log.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name
@@ -328,7 +369,32 @@ export async function createDiamondPackageZip(tempDir, name, version) {
 export async function createFailingPackageZip(tempDir, name, version) {
     mkdirSync(tempDir, { recursive: true });
     const input = e3.input('value', StringType, variant('value', 'test'));
-    const task = e3.customTask('failing', [input], StringType, ($, _inputs, _output) => East.str `exit 1`);
+    const task = e3.task('failing', [input], East.function([StringType], StringType, ($, value) => $.error(East.str `failing fails, given ${value}`)));
+    const pkg = e3.package(name, version, task);
+    const zipPath = join(tempDir, `${name}-${version}.zip`);
+    await e3.export(pkg, zipPath);
+    return zipPath;
+}
+/**
+ * Create a package whose task runs a command, which fails.
+ *
+ * Creates a package with:
+ * - Input: "value" (String, default "test")
+ * - Task: "command" - a custom task whose command is `exit 1`
+ *
+ * The suites' one command task. A server that runs commands records it
+ * `failed`, exit code 1; one that runs none records it `error`, saying it runs
+ * no commands (`TestConfig.commands`).
+ *
+ * @param tempDir - Directory to write the zip file
+ * @param name - Package name
+ * @param version - Package version
+ * @returns Path to the created zip file
+ */
+export async function createCommandPackageZip(tempDir, name, version) {
+    mkdirSync(tempDir, { recursive: true });
+    const input = e3.input('value', StringType, variant('value', 'test'));
+    const task = e3.customTask('command', [input], StringType, ($, _inputs, _output) => East.str `exit 1`);
     const pkg = e3.package(name, version, task);
     const zipPath = join(tempDir, `${name}-${version}.zip`);
     await e3.export(pkg, zipPath);
@@ -367,10 +433,12 @@ export async function createSlowPackageZip(tempDir, name, version, sleepSeconds
  * - Input: "b" (Integer, default 4)
  * - Task: "succeed_a" - returns a + b (succeeds)
  * - Task: "succeed_b" - returns a * b (succeeds)
- * - Task: "fail_c" - exits with code 1 (always fails)
+ * - Task: "fail_c" - fails in East as it runs, with the message "fail_c fails,
+ *   given 3" (always fails)
  *
  * All tasks are independent — dispatched in the same Map iteration.
- * Stresses apply-results serialization with mixed success/failure.
+ * Stresses apply-results serialization with mixed success/failure. Every task
+ * is East, so every server runs them.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name
@@ -383,7 +451,7 @@ export async function createParallelMixedPackageZip(tempDir, name, version) {
     const inputB = e3.input('b', IntegerType, variant('value', 4n));
     const succeedA = e3.task('succeed_a', [inputA, inputB], East.function([IntegerType, IntegerType], IntegerType, ($, a, b) => a.add(b)));
     const succeedB = e3.task('succeed_b', [inputA, inputB], East.function([IntegerType, IntegerType], IntegerType, ($, a, b) => a.multiply(b)));
-    const failC = e3.customTask('fail_c', [inputA], StringType, ($, _inputs, _output) => East.str `exit 1`);
+    const failC = e3.task('fail_c', [inputA], East.function([IntegerType], StringType, ($, a) => $.error(East.str `fail_c fails, given ${a}`)));
     const pkg = e3.package(name, version, succeedA, succeedB, failC);
     const zipPath = join(tempDir, `${name}-${version}.zip`);
     await e3.export(pkg, zipPath);
@@ -396,10 +464,12 @@ export async function createParallelMixedPackageZip(tempDir, name, version) {
  * - Input: "a" (Integer, default 10)
  * - Input: "b" (Integer, default 5)
  * - Task: "left" - returns a + b (succeeds)
- * - Task: "right" - exits with code 1 (always fails)
+ * - Task: "right" - fails in East as it runs, with the message "right fails,
+ *   given 10" (always fails)
  * - Task: "merge" - depends on left.output + right.output (should be skipped)
  *
  * Tests that merge is properly skipped and the dataflow completes without stalling.
+ * Every task is East, so every server runs them.
  *
  * @param tempDir - Directory to write the zip file
  * @param name - Package name
@@ -411,7 +481,7 @@ export async function createFailingDiamondPackageZip(tempDir, name, version) {
     const inputA = e3.input('a', IntegerType, variant('value', 10n));
     const inputB = e3.input('b', IntegerType, variant('value', 5n));
     const leftTask = e3.task('left', [inputA, inputB], East.function([IntegerType, IntegerType], IntegerType, ($, a, b) => a.add(b)));
-    const rightTask = e3.customTask('right', [inputA], IntegerType, ($, _inputs, _output) => East.str `exit 1`);
+    const rightTask = e3.task('right', [inputA], East.function([IntegerType], IntegerType, ($, a) => $.error(East.str `right fails, given ${a}`)));
     const mergeTask = e3.task('merge', [leftTask.output, rightTask.output], East.function([IntegerType, IntegerType], IntegerType, ($, a, b) => a.add(b)));
     const pkg = e3.package(name, version, mergeTask);
     const zipPath = join(tempDir, `${name}-${version}.zip`);