@thymian/plugin-sampler 0.3.0-canary.20261007-e6cb8dc → 0.3.0-canary.20261007-cdbe1d3

package/dist/hooks/create-hook-utils.js

@@ -1,61 +1,46 @@
 import { randomBytes } from 'node:crypto';
-import { getContentType, } from '@thymian/core';
-import { serializeRequest } from '@thymian/core';
+import { readFileSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { getContentType, ThymianBaseError, } from '@thymian/core';
 import { FailError, SkipError } from './hook-errors.js';
 const charset = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-export function toHttpRequestTemplate(methodAndUrl, req) {
-    const [method, url] = methodAndUrl.split(' ');
-    if (!method || !url) {
-        throw new Error(`Invalid url format: ${url}. Expected format: <METHOD> <PATH>`);
+export function createHookUtils(context) {
+    const { dir, results } = context;
+    /**
+     * The request a setter writes into.
+     *
+     * A hook that has none is one that shapes nothing — the run-scoped pair. A
+     * setter there is a mistake worth naming rather than a silent no-op.
+     */
+    function request(setter) {
+        if (!context.request) {
+            throw new ThymianBaseError(`utils.${setter} needs a request to write into, and this hook has none.`, {
+                name: 'NoRequestToShapeError',
+                suggestions: [
+                    'beforeAll and afterAll run once per run rather than per transaction, so there is no request to shape there.',
+                ],
+            });
+        }
+        return context.request;
+    }
+    function filePath(path) {
+        return isAbsolute(path) ? path : resolve(dir, path);
     }
-    const urlInstance = new URL(url);
-    return {
-        authorize: false,
-        cookies: req.cookies ?? {},
-        headers: req.headers ?? {},
-        method,
-        origin: urlInstance.origin,
-        path: decodeURI(urlInstance.pathname),
-        pathParameters: req.path ?? {},
-        query: req.query ?? {},
-        body: req.body,
-    };
-}
-export function createHookUtils(format, runRequest, hookRunner, urlToTransactionId, results, logger) {
     return {
         assertionFailure(message, details = {}) {
-            results.push({
-                type: 'assertion-failure',
-                message,
-                ...details,
-            });
+            results.push({ type: 'assertion-failure', message, ...details });
         },
         assertionSuccess(message, assertion) {
-            results.push({
-                type: 'assertion-success',
-                message,
-                assertion,
-            });
+            results.push({ type: 'assertion-success', message, assertion });
         },
         info(message) {
-            results.push({
-                type: 'info',
-                message,
-            });
+            results.push({ type: 'info', message });
         },
         timeout(message, durationMs) {
-            results.push({
-                type: 'timeout',
-                message,
-                durationMs,
-            });
+            results.push({ type: 'timeout', message, durationMs });
         },
         warn(message, details) {
-            results.push({
-                type: 'warning',
-                message,
-                details,
-            });
+            results.push({ type: 'warning', message, details });
         },
         randomString(length = 10) {
             const bytes = randomBytes(length);
@@ -65,58 +50,46 @@ export function createHookUtils(format, runRequest, hookRunner, urlToTransaction
             }
             return result.join('');
         },
-        async request(url, args, _options = {}) {
-            if (typeof url !== 'string') {
-                throw new Error('Invalid url format.');
-            }
-            const options = {
-                runHooks: true,
-                ..._options,
-            };
-            const key = `${url}${options.forStatusCode ? `->${options.forStatusCode}` : ''}`;
-            const transactionId = urlToTransactionId[key];
-            if (!transactionId) {
-                throw new Error(`Could not find transaction ID for ${key}`);
-            }
-            const transaction = format.getThymianHttpTransactionById(transactionId);
-            let reqTemplate = toHttpRequestTemplate(url, args);
-            if (options.runHooks) {
-                logger.debug(`Running beforeEach hooks for ${key}.`);
-                const res = await hookRunner.beforeEachRequest({
-                    value: reqTemplate,
-                    ctx: transaction,
-                });
-                reqTemplate = res.result;
-            }
-            if (options.runHooks || options.authorize) {
-                logger.debug(`Running authorize hook for ${key}.`);
-                const res = await hookRunner.authorize({
-                    value: reqTemplate,
-                    ctx: transaction,
-                });
-                reqTemplate = res.result;
+        setHeader(name, value) {
+            request('setHeader').headers[name] = value;
+        },
+        setQuery(name, value) {
+            request('setQuery').query[name] = value;
+        },
+        setPathParam(name, value) {
+            request('setPathParam').pathParameters[name] = value;
+        },
+        setCookie(name, value) {
+            request('setCookie').cookies[name] = value;
+        },
+        setBody(body) {
+            request('setBody').body = body;
+        },
+        setAuthorize(authorize) {
+            request('setAuthorize').authorize = authorize;
+        },
+        readFile(path) {
+            return readFileSync(filePath(path));
+        },
+        readText(path, encoding = 'utf-8') {
+            return readFileSync(filePath(path), encoding);
+        },
+        readJson(path) {
+            return JSON.parse(readFileSync(filePath(path), 'utf-8'));
+        },
+        async request(selector, args = {}, options = {}) {
+            if (typeof selector !== 'string') {
+                throw new ThymianBaseError('utils.request takes a transaction selector as its first argument.', { name: 'MalformedSelectorError' });
             }
-            const req = serializeRequest({
-                requestTemplate: reqTemplate,
-                source: transaction,
-            });
-            let response = await runRequest(req);
-            if (options.runHooks) {
-                logger.debug(`Running afterEach hook for ${key}.`);
-                const resHookResult = await hookRunner.afterEachResponse({
-                    value: response,
-                    ctx: {
-                        requestTemplate: reqTemplate,
-                        request: req,
-                    },
+            if (!context.requestOther) {
+                throw new ThymianBaseError(`Cannot run a cross-endpoint request for "${selector}" from this hook.`, {
+                    name: 'NoNestedRequestError',
+                    suggestions: [
+                        'A defineSample hook runs before any request exists, so there is no pipeline for a nested request to run through. Seed from beforeAll or beforeEach instead.',
+                    ],
                 });
-                response = resHookResult.result;
             }
-            return {
-                body: parseResponseBody(response),
-                headers: response.headers,
-                statusCode: response.statusCode,
-            };
+            return (await context.requestOther(selector, args, options));
         },
         fail(msg) {
             throw new FailError(msg);
@@ -126,12 +99,17 @@ export function createHookUtils(format, runRequest, hookRunner, urlToTransaction
         },
     };
 }
+/**
+ * The body a hook sees, parsed when the response says it is JSON and left as
+ * the raw string when it does not.
+ */
 export function parseResponseBody(res) {
-    const ct = getContentType(res.headers);
+    const contentType = getContentType(res.headers);
     if (typeof res.body === 'string' &&
-        (ct.match(/^application\/json/i) || ct.match(/^.*\/.*\+json/i))) {
+        (/^application\/json/i.test(contentType) ||
+            /^.*\/.*\+json/i.test(contentType))) {
         return JSON.parse(res.body);
     }
-    return res;
+    return res.body;
 }
 //# sourceMappingURL=create-hook-utils.js.map

package/dist/hooks/create-hook-utils.js.map

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

package/dist/hooks/hook-api.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The module `@thymian/hooks` resolves to.
+ *
+ * The plugin's jiti instance aliases the bare specifier `@thymian/hooks` to this
+ * file's absolute path, which is what lets a hook file import runtime values in
+ * a workspace where `sampler init` was never run.
+ *
+ * Two consequences, both load-bearing:
+ *
+ * - **It must live under `src/`.** `package.json`'s `files: ["dist"]` is what
+ *   puts the built module in the published package; a module outside `src/`
+ *   never reaches `dist/`.
+ * - **Its runtime import graph must stay minimal.** jiti evaluates this file,
+ *   and everything it imports at runtime, in its own registry. That graph is
+ *   two leaf modules: `hook-registration.js` and `hook-errors.js`, neither of
+ *   which imports anything. Everything else here is `import type`, which is
+ *   erased — in particular `@thymian/core` is not on it, so a hook file
+ *   resolves with nothing installed alongside it.
+ *
+ * Callbacks are stored here, never invoked.
+ */
+import { UndeclaredResponseError } from './hook-errors.js';
+import { type HookCallback, type HookRegistration, type HookTarget } from './hook-registration.js';
+/**
+ * Re-exported so a hook can `catch` it. Letting it escape is equally valid —
+ * the transaction boundary catches it and skips the transaction, naming this
+ * seed and its actual status.
+ */
+export { UndeclaredResponseError };
+/** Shapes the generated request Sample of the targeted Transaction(s). */
+export declare function defineSample(target: HookTarget, callback: HookCallback): HookRegistration;
+/** Runs before each request of the targeted Transaction(s). */
+export declare function beforeEach(target: HookTarget, callback: HookCallback): HookRegistration;
+/** Runs after each response of the targeted Transaction(s). */
+export declare function afterEach(target: HookTarget, callback: HookCallback): HookRegistration;
+/**
+ * Supplies credentials. Two arities, one representation:
+ *
+ * - `authorize(callback)` — the **global** hook, stored as `target: undefined`.
+ * - `authorize(target, callback)` — **targeted**, and it wins over the global
+ *   one for the Transactions it covers.
+ */
+export declare function authorize(callback: HookCallback): HookRegistration;
+export declare function authorize(target: HookTarget, callback: HookCallback): HookRegistration;
+/** Runs once before the first request of the run. Carries no target. */
+export declare function beforeAll(callback: HookCallback): HookRegistration;
+/** Runs once when the run closes. Carries no target. */
+export declare function afterAll(callback: HookCallback): HookRegistration;
+//# sourceMappingURL=hook-api.d.ts.map

package/dist/hooks/hook-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-api.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAyBnC,0EAA0E;AAC1E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,gBAAgB,CAIlB;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,gBAAgB,CAIlB;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,gBAAgB,CAIlB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAAC;AACpE,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,GACrB,gBAAgB,CAAC;AAiDpB,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAIlE;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAIjE"}

package/dist/hooks/hook-api.js

@@ -0,0 +1,105 @@
+/**
+ * The module `@thymian/hooks` resolves to.
+ *
+ * The plugin's jiti instance aliases the bare specifier `@thymian/hooks` to this
+ * file's absolute path, which is what lets a hook file import runtime values in
+ * a workspace where `sampler init` was never run.
+ *
+ * Two consequences, both load-bearing:
+ *
+ * - **It must live under `src/`.** `package.json`'s `files: ["dist"]` is what
+ *   puts the built module in the published package; a module outside `src/`
+ *   never reaches `dist/`.
+ * - **Its runtime import graph must stay minimal.** jiti evaluates this file,
+ *   and everything it imports at runtime, in its own registry. That graph is
+ *   two leaf modules: `hook-registration.js` and `hook-errors.js`, neither of
+ *   which imports anything. Everything else here is `import type`, which is
+ *   erased — in particular `@thymian/core` is not on it, so a hook file
+ *   resolves with nothing installed alongside it.
+ *
+ * Callbacks are stored here, never invoked.
+ */
+import { UndeclaredResponseError } from './hook-errors.js';
+import { registerHook, } from './hook-registration.js';
+/**
+ * Re-exported so a hook can `catch` it. Letting it escape is equally valid —
+ * the transaction boundary catches it and skips the transaction, naming this
+ * seed and its actual status.
+ */
+export { UndeclaredResponseError };
+/**
+ * Rejects a missing or non-callable callback at the call site the user wrote.
+ *
+ * A one-argument `beforeEach(fn)` type-checks nowhere but runs fine in a plain
+ * `.js` hook file, and unchecked it would store `target: fn, callback:
+ * undefined` and then be reported as a target that matched nothing — naming a
+ * target the user never wrote instead of the argument they forgot.
+ *
+ * A plain `TypeError` rather than a `ThymianBaseError`: keeping `@thymian/core`
+ * off this module's runtime graph is what keeps `@thymian/hooks` resolvable from
+ * a hook file with nothing installed alongside it.
+ */
+function requireCallback(callback, signature) {
+    if (typeof callback !== 'function') {
+        throw new TypeError(`${signature} needs a function as its callback argument.`);
+    }
+}
+/** Shapes the generated request Sample of the targeted Transaction(s). */
+export function defineSample(target, callback) {
+    requireCallback(callback, 'defineSample(target, callback)');
+    return registerHook({ kind: 'defineSample', target, callback });
+}
+/** Runs before each request of the targeted Transaction(s). */
+export function beforeEach(target, callback) {
+    requireCallback(callback, 'beforeEach(target, callback)');
+    return registerHook({ kind: 'beforeEach', target, callback });
+}
+/** Runs after each response of the targeted Transaction(s). */
+export function afterEach(target, callback) {
+    requireCallback(callback, 'afterEach(target, callback)');
+    return registerHook({ kind: 'afterEach', target, callback });
+}
+export function authorize(...args) {
+    // Dispatch on **arity**, never on the type of the first argument. Typing the
+    // dispatch escalates scope silently in both directions: after a rename,
+    // `authorize(SELECTORS.login, fn)` leaves the first argument `undefined`,
+    // which is not a function — so a check on the first argument passes, the call
+    // falls through to the global form, and a hook aimed at one endpoint
+    // authorizes every Transaction in the API. In an authorization hook that is
+    // the wrong direction to fail.
+    if (args.length > 2) {
+        throw authorizeArityError();
+    }
+    if (args.length === 1) {
+        const [callback] = args;
+        if (typeof callback !== 'function') {
+            throw authorizeArityError();
+        }
+        return registerHook({ kind: 'authorize', target: undefined, callback });
+    }
+    const [target, callback] = args;
+    if (typeof callback !== 'function') {
+        throw authorizeArityError();
+    }
+    if (target === undefined || typeof target === 'function') {
+        throw new TypeError('authorize(target, callback) was called with no target. ' +
+            'Check that the selector you passed is defined, ' +
+            'or call authorize(callback) for the global hook.');
+    }
+    return registerHook({ kind: 'authorize', target, callback });
+}
+function authorizeArityError() {
+    return new TypeError('authorize(target, callback) needs a callback as its second argument. ' +
+        'Call authorize(callback) for the global hook.');
+}
+/** Runs once before the first request of the run. Carries no target. */
+export function beforeAll(callback) {
+    requireCallback(callback, 'beforeAll(callback)');
+    return registerHook({ kind: 'beforeAll', callback });
+}
+/** Runs once when the run closes. Carries no target. */
+export function afterAll(callback) {
+    requireCallback(callback, 'afterAll(callback)');
+    return registerHook({ kind: 'afterAll', callback });
+}
+//# sourceMappingURL=hook-api.js.map

package/dist/hooks/hook-api.js.map

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

package/dist/hooks/hook-diagnostics.d.ts

@@ -0,0 +1,45 @@
+import { ThymianBaseError } from '@thymian/core';
+/** What went wrong with one hook, and where. */
+export type HookDiagnostic = {
+    /** Hooks-dir-relative path of the file at fault, `/`-normalized. */
+    file: string;
+    /** The export the registration arrived on, when it is known. */
+    exportName?: string;
+    /** One sentence, lowercase, completing "…: <reason>". */
+    reason: string;
+    suggestions?: string[];
+};
+/**
+ * The run cannot start: at least one hook does not resolve.
+ *
+ * Every diagnostic is reported, not just the first — one broken hook must not
+ * hide the other nine — and each names its own file so the reader knows which
+ * line to edit. A dangling selector is never auto-rebound to a "close enough"
+ * Transaction, which is the whole point of anchoring a hook to a fully-qualified
+ * Selector.
+ */
+export declare function unresolvedHooksError(diagnostics: readonly HookDiagnostic[]): ThymianBaseError;
+/**
+ * Two hooks resolve but cannot both apply.
+ *
+ * Separate from {@link unresolvedHooksError} because the fault is different: the
+ * selector is fine and the file loaded: the pair of hooks is the problem, so the
+ * sentence has to say so rather than send the reader looking for a bad selector.
+ */
+export declare function hookConflictError(conflicts: readonly HookDiagnostic[]): ThymianBaseError;
+/**
+ * A hook was created but never exported.
+ *
+ * Separate from {@link unresolvedHooksError} because the fault is a different
+ * one and needs a different sentence: the selector resolves, the file loaded,
+ * and the hook is simply unreachable. Sending the reader to look at their
+ * selectors would be sending them to the one thing that is fine.
+ *
+ * This is an error rather than a warning because the outcome is silence. A hook
+ * that does not fire looks exactly like a hook that had nothing to do, so
+ * there is no run in which the author would rather find out later.
+ */
+export declare function unexportedHooksError(unexported: readonly HookDiagnostic[]): ThymianBaseError;
+/** A hook file could not be imported at all. */
+export declare function hookFileImportError(file: string, cause: unknown): ThymianBaseError;
+//# sourceMappingURL=hook-diagnostics.d.ts.map

package/dist/hooks/hook-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-diagnostics.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAUF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,SAAS,cAAc,EAAE,GACrC,gBAAgB,CAqBlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,gBAAgB,CAclB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,gBAAgB,CAclB;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,gBAAgB,CASlB"}

package/dist/hooks/hook-diagnostics.js

@@ -0,0 +1,80 @@
+import { ThymianBaseError } from '@thymian/core';
+function describe(diagnostic) {
+    const where = diagnostic.exportName
+        ? `${diagnostic.file} (export "${diagnostic.exportName}")`
+        : diagnostic.file;
+    return `${where}: ${diagnostic.reason}`;
+}
+/**
+ * The run cannot start: at least one hook does not resolve.
+ *
+ * Every diagnostic is reported, not just the first — one broken hook must not
+ * hide the other nine — and each names its own file so the reader knows which
+ * line to edit. A dangling selector is never auto-rebound to a "close enough"
+ * Transaction, which is the whole point of anchoring a hook to a fully-qualified
+ * Selector.
+ */
+export function unresolvedHooksError(diagnostics) {
+    // Hooks, not diagnostics: one hook with two vacuous globs draws two
+    // diagnostics, and reporting "2 hooks" for one hook is a lie the reader has
+    // to reconcile against the list below.
+    const count = new Set(diagnostics.map((diagnostic) => `${diagnostic.file}#${diagnostic.exportName ?? ''}`)).size;
+    return new ThymianBaseError(`${count} sampler ${count === 1 ? 'hook does' : 'hooks do'} not resolve against the loaded API description.`, {
+        name: 'UnresolvedHooksError',
+        ref: 'https://thymian.dev/references/errors/unresolved-hooks-error/',
+        suggestions: [
+            ...diagnostics.map(describe),
+            ...diagnostics.flatMap((diagnostic) => diagnostic.suggestions ?? []),
+        ],
+    });
+}
+/**
+ * Two hooks resolve but cannot both apply.
+ *
+ * Separate from {@link unresolvedHooksError} because the fault is different: the
+ * selector is fine and the file loaded: the pair of hooks is the problem, so the
+ * sentence has to say so rather than send the reader looking for a bad selector.
+ */
+export function hookConflictError(conflicts) {
+    const count = conflicts.length;
+    return new ThymianBaseError(`${count} sampler ${count === 1 ? 'hook conflicts' : 'hooks conflict'} with another hook on the same transaction.`, {
+        name: 'HookConflictError',
+        ref: 'https://thymian.dev/references/errors/hook-conflict-error/',
+        suggestions: [
+            ...conflicts.map(describe),
+            ...conflicts.flatMap((conflict) => conflict.suggestions ?? []),
+        ],
+    });
+}
+/**
+ * A hook was created but never exported.
+ *
+ * Separate from {@link unresolvedHooksError} because the fault is a different
+ * one and needs a different sentence: the selector resolves, the file loaded,
+ * and the hook is simply unreachable. Sending the reader to look at their
+ * selectors would be sending them to the one thing that is fine.
+ *
+ * This is an error rather than a warning because the outcome is silence. A hook
+ * that does not fire looks exactly like a hook that had nothing to do, so
+ * there is no run in which the author would rather find out later.
+ */
+export function unexportedHooksError(unexported) {
+    const count = unexported.length;
+    return new ThymianBaseError(`${count} sampler ${count === 1 ? 'hook is' : 'hooks are'} created but never exported, so nothing can reach ${count === 1 ? 'it' : 'them'}.`, {
+        name: 'UnexportedHooksError',
+        ref: 'https://thymian.dev/references/errors/unexported-hooks-error/',
+        suggestions: [
+            ...unexported.map(describe),
+            ...unexported.flatMap((diagnostic) => diagnostic.suggestions ?? []),
+        ],
+    });
+}
+/** A hook file could not be imported at all. */
+export function hookFileImportError(file, cause) {
+    return new ThymianBaseError(`The hook file "${file}" could not be imported.`, {
+        name: 'HookFileImportError',
+        ref: 'https://thymian.dev/references/errors/hook-file-import-error/',
+        cause,
+    });
+}
+//# sourceMappingURL=hook-diagnostics.js.map

package/dist/hooks/hook-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-diagnostics.js","sourceRoot":"","sources":["../../src/hooks/hook-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAajD,SAAS,QAAQ,CAAC,UAA0B;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU;QACjC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,aAAa,UAAU,CAAC,UAAU,IAAI;QAC1D,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;IAEpB,OAAO,GAAG,KAAK,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAsC;IAEtC,oEAAoE;IACpE,4EAA4E;IAC5E,uCAAuC;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,WAAW,CAAC,GAAG,CACb,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,UAAU,IAAI,EAAE,EAAE,CACpE,CACF,CAAC,IAAI,CAAC;IAEP,OAAO,IAAI,gBAAgB,CACzB,GAAG,KAAK,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,kDAAkD,EAC5G;QACE,IAAI,EAAE,sBAAsB;QAC5B,GAAG,EAAE,+DAA+D;QACpE,WAAW,EAAE;YACX,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC5B,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;SACrE;KACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAoC;IAEpC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC;IAE/B,OAAO,IAAI,gBAAgB,CACzB,GAAG,KAAK,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,6CAA6C,EAClH;QACE,IAAI,EAAE,mBAAmB;QACzB,GAAG,EAAE,4DAA4D;QACjE,WAAW,EAAE;YACX,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC1B,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;SAC/D;KACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAqC;IAErC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC;IAEhC,OAAO,IAAI,gBAAgB,CACzB,GAAG,KAAK,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,qDAAqD,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,EAC5I;QACE,IAAI,EAAE,sBAAsB;QAC5B,GAAG,EAAE,+DAA+D;QACpE,WAAW,EAAE;YACX,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC3B,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;SACpE;KACF,CACF,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,KAAc;IAEd,OAAO,IAAI,gBAAgB,CACzB,kBAAkB,IAAI,0BAA0B,EAChD;QACE,IAAI,EAAE,qBAAqB;QAC3B,GAAG,EAAE,+DAA+D;QACpE,KAAK;KACN,CACF,CAAC;AACJ,CAAC"}

package/dist/hooks/hook-errors.d.ts

@@ -2,4 +2,37 @@ export declare class SkipError extends Error {
 }
 export declare class FailError extends Error {
 }
+/**
+ * A cross-endpoint call was answered with a status the description never
+ * declares for that operation.
+ *
+ * `utils.request` answers a union of every **declared** response, so an
+ * undeclared one has no member to be. Throwing is what keeps that union
+ * truthful: the alternative is a value whose type is a lie, read by a hook that
+ * has no branch for it.
+ *
+ * A plain `Error` rather than a `ThymianBaseError`, deliberately: this class is
+ * re-exported from `@thymian/hooks`, whose runtime import graph must stay free
+ * of `@thymian/core` so a hook file resolves with nothing installed beside it.
+ * The sentence a user reads is composed at the transaction boundary, which is
+ * where the remediation lives.
+ */
+export declare class UndeclaredResponseError extends Error {
+    readonly selector: string;
+    readonly statusCode: number;
+    readonly headers: Record<string, string | string[] | undefined>;
+    readonly body: unknown;
+    /**
+     * `instanceof` by **shape**, not by identity.
+     *
+     * The hooks runtime is loaded through jiti, in its own module registry, so a
+     * hook file that imports `@thymian/hooks` gets a different evaluation of
+     * this module than the runner's — and its own class object. Identity
+     * comparison would then be false for the very error the runner threw, which
+     * makes the one documented way to react to an off-spec response silently
+     * never fire.
+     */
+    static [Symbol.hasInstance](value: unknown): boolean;
+    constructor(selector: string, statusCode: number, headers: Record<string, string | string[] | undefined>, body: unknown);
+}
 //# sourceMappingURL=hook-errors.d.ts.map

package/dist/hooks/hook-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-errors.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;CAAG;AAEvC,qBAAa,SAAU,SAAQ,KAAK;CAAG"}
+{"version":3,"file":"hook-errors.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;CAAG;AAEvC,qBAAa,SAAU,SAAQ,KAAK;CAAG;AAEvC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAsB9C,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,OAAO;IAxBxB;;;;;;;;;OASG;WACa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;gBAWlD,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,OAAO;CAQzB"}

package/dist/hooks/hook-errors.js

@@ -2,4 +2,50 @@ export class SkipError extends Error {
 }
 export class FailError extends Error {
 }
+/**
+ * A cross-endpoint call was answered with a status the description never
+ * declares for that operation.
+ *
+ * `utils.request` answers a union of every **declared** response, so an
+ * undeclared one has no member to be. Throwing is what keeps that union
+ * truthful: the alternative is a value whose type is a lie, read by a hook that
+ * has no branch for it.
+ *
+ * A plain `Error` rather than a `ThymianBaseError`, deliberately: this class is
+ * re-exported from `@thymian/hooks`, whose runtime import graph must stay free
+ * of `@thymian/core` so a hook file resolves with nothing installed beside it.
+ * The sentence a user reads is composed at the transaction boundary, which is
+ * where the remediation lives.
+ */
+export class UndeclaredResponseError extends Error {
+    selector;
+    statusCode;
+    headers;
+    body;
+    /**
+     * `instanceof` by **shape**, not by identity.
+     *
+     * The hooks runtime is loaded through jiti, in its own module registry, so a
+     * hook file that imports `@thymian/hooks` gets a different evaluation of
+     * this module than the runner's — and its own class object. Identity
+     * comparison would then be false for the very error the runner threw, which
+     * makes the one documented way to react to an off-spec response silently
+     * never fire.
+     */
+    static [Symbol.hasInstance](value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            value.name === 'UndeclaredResponseError' &&
+            'selector' in value &&
+            'statusCode' in value);
+    }
+    constructor(selector, statusCode, headers, body) {
+        super(`The seed "${selector}" was answered with ${statusCode}, which the specification does not declare for that operation.`);
+        this.selector = selector;
+        this.statusCode = statusCode;
+        this.headers = headers;
+        this.body = body;
+        this.name = 'UndeclaredResponseError';
+    }
+}
 //# sourceMappingURL=hook-errors.js.map

package/dist/hooks/hook-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-errors.js","sourceRoot":"","sources":["../../src/hooks/hook-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;CAAG;AAEvC,MAAM,OAAO,SAAU,SAAQ,KAAK;CAAG"}
+{"version":3,"file":"hook-errors.js","sourceRoot":"","sources":["../../src/hooks/hook-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;CAAG;AAEvC,MAAM,OAAO,SAAU,SAAQ,KAAK;CAAG;AAEvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAsBrC;IACA;IACA;IACA;IAxBX;;;;;;;;;OASG;IACH,MAAM,CAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAc;QACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACb,KAA4B,CAAC,IAAI,KAAK,yBAAyB;YAChE,UAAU,IAAI,KAAK;YACnB,YAAY,IAAI,KAAK,CACtB,CAAC;IACJ,CAAC;IAED,YACW,QAAgB,EAChB,UAAkB,EAClB,OAAsD,EACtD,IAAa;QAEtB,KAAK,CACH,aAAa,QAAQ,uBAAuB,UAAU,gEAAgE,CACvH,CAAC;QAPO,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAQ;QAClB,YAAO,GAAP,OAAO,CAA+C;QACtD,SAAI,GAAJ,IAAI,CAAS;QAMtB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}