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

package/dist/index.js

@@ -1,61 +1,37 @@
-import { isAbsolute, join } from 'node:path';
-import { ThymianBaseError, ThymianFormat, thymianHttpTransactionToString, } from '@thymian/core';
-import { generateSamplesForThymianFormat } from './generation/generate-samples-for-thymian-format.js';
-import { generatedTypesToString, generateTypesForThymianFormat, } from './hooks/generate-request-types.js';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { ThymianFormat, } from '@thymian/core';
+import { generateTypeSurface } from './generation/types/generate-type-surface.js';
+import { selfCheckSurface } from './generation/types/self-check-surface.js';
+import { readGenerated, rootExcludeNote, scaffoldTsconfig, surfaceAsFiles, writeGenerated, } from './generation/types/write-type-surface.js';
+import { hookConflictError, unexportedHooksError, unresolvedHooksError, } from './hooks/hook-diagnostics.js';
 import { HookRunner } from './hooks/hook-runner.js';
-import { requestSampleToRequestTemplate } from './request-sample-to-request-template.js';
+import { loadUserHooks, } from './hooks/load-user-hooks.js';
 import { RequestSampler } from './request-sampler.js';
-import { getPathTransactionId } from './samples-structure/get-path-transaction-id.js';
-import { readSamplesFromDir } from './samples-structure/read-samples-from-dir.js';
-import { writeSamplesToDir } from './samples-structure/write-samples-to-dir.js';
+import { resolveSamplerPaths } from './sampler-paths.js';
+import { TransactionCatalog } from './selectors/transaction-catalog.js';
 import { entryExists } from './utils.js';
-import { validateSamplerOutput, } from './validation/validate-sampler-output.js';
-const samplerValidateActionSchema = {
-    event: {
-        type: 'object',
-        required: ['format'],
-        properties: {
-            format: {},
-            forPath: { type: 'string' },
-        },
-    },
-    response: {
-        type: 'object',
-        required: ['samplePath', 'checkedArtifacts', 'failures'],
-        properties: {
-            samplePath: { type: 'string' },
-            checkedArtifacts: { type: 'integer' },
-            failures: {
-                type: 'array',
-                items: {
-                    type: 'object',
-                    required: ['type', 'path', 'message'],
-                    properties: {
-                        type: {
-                            type: 'string',
-                            enum: [
-                                'missing-artifact',
-                                'changed-artifact',
-                                'stale-root-metadata',
-                                'metadata-out-of-sync',
-                                'unexpected-artifact',
-                                'invalid-json',
-                            ],
-                        },
-                        path: { type: 'string' },
-                        message: { type: 'string' },
-                        expected: { type: 'string' },
-                        actual: { type: 'string' },
-                        changes: { type: 'array' },
-                    },
-                },
-            },
-        },
-    },
-};
+import { changedFiles, validateSampler, } from './validation/validate-sampler.js';
 export const samplePlugin = {
     name: '@thymian/plugin-sampler',
     version: '0.x',
+    actions: {
+        // What this plugin answers, what it asks for, and what it hands off. Kept
+        // in step with the `onAction` calls below; `provides` stays empty because
+        // the payload schemas would be hand-written duplicates of the types.
+        listensOn: [
+            'core.format',
+            'core.close',
+            'core.request.sample',
+            'http-testing.beforeRequest',
+            'http-testing.afterResponse',
+            'http-testing.authorize',
+            'sampler.show',
+            'sampler.init',
+            'sampler.sync',
+            'sampler.validate',
+        ],
+        emits: ['sampler.unknown-type'],
+    },
     options: {
         // ### for reference documentation ###
         title: 'Plugin Options',
@@ -69,130 +45,137 @@ export const samplePlugin = {
             },
         },
     },
-    actions: {
-        provides: {
-            'sampler.init': {
-                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                // @ts-expect-error
-                event: {
-                    type: 'object',
-                    required: ['contentType', 'schema'],
-                    properties: {
-                        contentType: { type: 'string' },
-                        schema: {},
-                    },
-                },
-                // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-                // @ts-expect-error
-                response: {
-                    type: 'object',
-                    required: ['contentType', 'schema'],
-                    properties: {
-                        contentType: { type: 'string' },
-                        schema: {},
-                    },
-                },
-            },
-            // The strict `JSONSchemaType<T>` target can't be satisfied by this
-            // hand-written `as const` schema (readonly literals + a deliberately
-            // loose `format: {}`, which ajv validates at runtime). Suppress the
-            // structural check the same way `sampler.init` does above, for parity.
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-expect-error
-            'sampler.validate': samplerValidateActionSchema,
-        },
-    },
     plugin: async (emitter, logger, options) => {
-        let basePath = join(options.cwd, '.thymian', 'samples');
-        if (options.path) {
-            basePath = isAbsolute(options.path)
-                ? options.path
-                : join(options.cwd, options.path);
-        }
-        let format;
-        let samples;
-        const requestSampler = new RequestSampler(basePath);
-        const hookRunner = new HookRunner(basePath, async (request) => {
-            return await emitter.emitAction('core.request.dispatch', {
-                request,
-            }, {
-                strategy: 'first',
-            });
-        }, logger);
-        async function initializeSamplerAndHookRunner(format) {
-            samples = (await entryExists(basePath))
-                ? await readSamplesFromDir(basePath)
-                : undefined;
-            await requestSampler.init(samples);
-            await hookRunner.init(format, samples);
+        const paths = resolveSamplerPaths(options.cwd, options.path);
+        const requestSampler = new RequestSampler();
+        const hookRunner = new HookRunner(logger, {
+            sampleRequest: async (transaction) => await requestSampler.sampleForTransaction(transaction, emitter),
+            dispatch: async (request) => await emitter.emitAction('core.request.dispatch', { request }, { strategy: 'first' }),
+        });
+        let catalog = TransactionCatalog.fromThymianFormat(new ThymianFormat());
+        let unresolvedHooks;
+        /**
+         * Refuse to start a run while a hook does not resolve.
+         *
+         * Checked here rather than when the format arrives, because a dangling
+         * Selector must stop a *run* and not every command: `sampler validate` has
+         * to survive long enough to report all of them, and `sampler show` and
+         * `sampler sync` are not runs. This is the earliest run-only point — the
+         * first request the tester asks the sampler to generate — so nothing is
+         * sent before the diagnostic.
+         */
+        function assertHooksResolve() {
+            if (!unresolvedHooks) {
+                return;
+            }
+            if (unresolvedHooks.diagnostics.length > 0) {
+                throw unresolvedHooksError(unresolvedHooks.diagnostics);
+            }
+            if (unresolvedHooks.conflicts.length > 0) {
+                throw hookConflictError(unresolvedHooks.conflicts);
+            }
+            if (unresolvedHooks.unexported.length > 0) {
+                throw unexportedHooksError(unresolvedHooks.unexported);
+            }
         }
-        emitter.onAction('core.format', async (f, ctx) => {
-            format = ThymianFormat.import(f);
-            await initializeSamplerAndHookRunner(format);
+        emitter.onAction('core.format', async (serialized, ctx) => {
+            const format = ThymianFormat.import(serialized);
+            // Before the projection, so an ambiguous description fails at catalog
+            // build rather than after generating samples nobody can address.
+            catalog = TransactionCatalog.fromThymianFormat(format);
+            const hooks = await loadUserHooks(paths.hooksDir, catalog);
+            // Recorded, not thrown. A hook that does not resolve must fail the *run*
+            // — see `assertHooksResolve` — but `sampler validate` exists to report
+            // every such hook at once, and it cannot report anything if publishing
+            // the format is what kills it.
+            unresolvedHooks = hooks;
+            for (const warning of hooks.warnings) {
+                logger.warn(warning);
+            }
+            // The same non-breaking signal `validate` gives, at the point a run would
+            // otherwise proceed silently against types that no longer describe the
+            // API. Only when something is committed: with no `generated/` there is
+            // nothing to be behind.
+            // Gated on the level that would print it. Answering "are the committed
+            // types behind?" means regenerating the whole surface —
+            // json-schema-to-typescript plus prettier, per schema per transaction —
+            // and that ran before the first request of every `test`, `lint` and
+            // `sampler check`, to decide whether to emit one line nobody sees at the
+            // default level. `validate` and `sync --check` are the gates that report
+            // drift; this is only a breadcrumb for someone already reading debug
+            // output, so it costs nothing when nobody is.
+            if (logger.level === 'debug' || logger.level === 'trace') {
+                const committed = await readGenerated(paths);
+                if (Object.keys(committed).length > 0) {
+                    const stale = changedFiles(committed, await generateTypeSurface(catalog));
+                    if (stale.length > 0) {
+                        logger.debug(`The committed sampler types are behind this API description (${stale.join(', ')}).`);
+                    }
+                }
+            }
+            hookRunner.load(format, catalog, hooks);
+            // After the hooks, because the sampler asks the runner to shape each
+            // draft with its `defineSample` hook.
+            await requestSampler.load(format, emitter, hookRunner.shapeSample);
+            logger.debug(`Catalogued ${catalog.size} transactions, projected their request samples and loaded ${hooks.files.length} hook file(s) from ${paths.hooksDir}.`);
             ctx.reply();
         });
-        emitter.onAction('sampler.path-from-transaction', ({ transactionId }, ctx) => {
-            if (!samples) {
-                throw new ThymianBaseError('No samples are loaded.', {
-                    name: 'SamplesNotLoadedError',
-                    ref: 'https://thymian.dev/references/errors/samples-not-loaded-error/',
-                });
+        emitter.onAction('sampler.init', async (_event, ctx) => {
+            await mkdir(paths.hooksDir, { recursive: true });
+            const surface = await generateTypeSurface(catalog);
+            // Refuse to write a surface that does not compile on its own — the
+            // self-check gate, before anything lands on disk.
+            await selfCheckSurface(surface);
+            await writeGenerated(paths, surface);
+            // Scaffolded once and user-owned from then on: an existing one is kept
+            // even if it no longer matches what this version would write.
+            const hadTsconfig = await entryExists(paths.tsconfigPath);
+            if (!hadTsconfig) {
+                await writeFile(paths.tsconfigPath, scaffoldTsconfig(), 'utf-8');
             }
-            ctx.reply(getPathTransactionId(transactionId, basePath, samples));
-        });
-        emitter.onAction('sampler.init', async ({ format, overwrite }, ctx) => {
-            const parsedFormat = ThymianFormat.import(format);
-            const samples = await generateSamplesForThymianFormat(parsedFormat, emitter);
-            logger.debug('Generated samples for thymian format.');
-            const generatedTypes = await generateTypesForThymianFormat(parsedFormat);
-            logger.debug('Generated types for thymian format.');
-            await writeSamplesToDir(samples, generatedTypes.keyToTransactionId, {
-                path: basePath,
-                mode: typeof overwrite === 'boolean' ? 'overwrite' : 'failIfExist',
-                typeArtifacts: {
-                    typesContent: generatedTypesToString(generatedTypes),
-                },
+            ctx.reply({
+                root: paths.root,
+                generated: Object.keys(surfaceAsFiles(surface)).sort(),
+                tsconfig: hadTsconfig ? 'kept' : 'written',
+                rootExcludeNote: rootExcludeNote(paths, options.cwd),
             });
-            logger.debug(`Wrote samples at ${basePath}`);
-            ctx.reply();
         });
-        emitter.onAction('sampler.validate', async ({ format, forPath }, ctx) => {
-            const parsedFormat = ThymianFormat.import(format);
-            ctx.reply(await validateSamplerOutput({
-                format: parsedFormat,
-                emitter,
-                samplePath: basePath,
-                forPath,
-            }));
+        emitter.onAction('sampler.sync', async ({ check }, ctx) => {
+            const surface = await generateTypeSurface(catalog);
+            // The self-check gate, ahead of both the `--check` report and the
+            // write: a fresh surface is produced either way.
+            await selfCheckSurface(surface);
+            const changed = changedFiles(await readGenerated(paths), surface);
+            if (check) {
+                // Writes nothing, by contract: a CI gate that fixed the thing it was
+                // checking would pass on the second run for the wrong reason.
+                ctx.reply({ changed, wrote: false });
+                return;
+            }
+            await mkdir(paths.hooksDir, { recursive: true });
+            // Never the tsconfig: it is scaffolded once by `init` and the author's
+            // from then on.
+            const rewritten = await writeGenerated(paths, surface);
+            ctx.reply({ changed, wrote: true, rewritten });
+        });
+        emitter.onAction('sampler.validate', async (_event, ctx) => {
+            // The hooks this run already loaded, so `validate` does not evaluate
+            // every hook file a second time.
+            ctx.reply(await validateSampler(paths, catalog, unresolvedHooks));
+        });
+        emitter.onAction('sampler.show', async ({ selector }, ctx) => {
+            const transaction = catalog.resolve(selector);
+            ctx.reply({
+                selector,
+                request: await requestSampler.sampleForTransaction(transaction, emitter),
+            });
         });
         emitter.onAction('core.request.sample', async ({ transaction }, ctx) => {
-            if (!format) {
-                throw new ThymianBaseError('Format is not loaded.', {
-                    name: 'FormatNotLoadedError',
-                    ref: 'https://thymian.dev/references/errors/format-not-loaded-error/',
-                });
-            }
-            const sample = requestSampler.sampleForTransaction(transaction.transactionId);
-            if (!sample) {
-                const currentFormatVersion = format.toHash();
-                if (currentFormatVersion !== requestSampler.version()) {
-                    throw new ThymianBaseError(`Cannot sample for transaction "${thymianHttpTransactionToString(transaction.thymianReq, transaction.thymianRes)}", because it based on version "${currentFormatVersion}" but the loaded samples are based on version "${requestSampler.version()}".`, {
-                        name: 'VersionMismatchError',
-                        suggestions: [
-                            `The loaded samples were generated at ${requestSampler.timestamp()}. Did you forget to regenerate the samples?`,
-                            '$ thymian sampler init',
-                        ],
-                        ref: 'https://thymian.dev/guides/samples/update-samples',
-                    });
-                }
-                throw new ThymianBaseError(`Cannot sample for transaction ${thymianHttpTransactionToString(transaction.thymianReq, transaction.thymianRes)} with transaction ID ${transaction.transactionId}`, {
-                    name: 'TransactionSampleNotFoundError',
-                    ref: 'https://thymian.dev/references/errors/transaction-sample-not-found-error/',
-                });
-            }
-            ctx.reply(requestSampleToRequestTemplate(sample));
+            assertHooksResolve();
+            ctx.reply(await requestSampler.sampleForTransaction(transaction, emitter));
         });
         emitter.onAction('http-testing.beforeRequest', async (hook, ctx) => {
+            assertHooksResolve();
             ctx.reply(await hookRunner.beforeEachRequest(hook));
         });
         emitter.onAction('http-testing.afterResponse', async (hook, ctx) => {
@@ -201,6 +184,10 @@ export const samplePlugin = {
         emitter.onAction('http-testing.authorize', async (hook, ctx) => {
             ctx.reply(await hookRunner.authorize(hook));
         });
+        emitter.onAction('core.close', async (_event, ctx) => {
+            await hookRunner.close();
+            ctx.reply();
+        });
     },
 };
 export default samplePlugin;

package/dist/index.js.map

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

package/dist/request-sampler.d.ts

@@ -1,15 +1,44 @@
-import type { HttpRequestSample } from './http-request-sample.js';
-import { type SamplesNode, type SamplesStructure } from './samples-structure/samples-tree-structure.js';
-export declare function readSamplesNodesFromTree(tree: SamplesStructure): Map<string, SamplesNode>;
+import { type HttpRequestTemplate, type ThymianEmitter, ThymianFormat, type ThymianHttpTransaction } from '@thymian/core';
+/**
+ * Shapes the request a Transaction will send, at generation time. The
+ * `defineSample` hook, seen from here.
+ */
+export type SampleShaper = (draft: HttpRequestTemplate, transactionId: string) => Promise<void>;
+/**
+ * The sampler's answer to "what request should this transaction send?".
+ *
+ * Holds the in-memory projection of the currently loaded format and nothing
+ * else. There is no version, no timestamp and no baseline to compare against,
+ * because there is no artifact that could disagree with the format: {@link load}
+ * throws the previous projection away and rebuilds it.
+ */
 export declare class RequestSampler {
-    private readonly basePath;
-    constructor(basePath: string, samples?: SamplesStructure);
     private samples;
-    private initialized;
-    private sampleNodes;
-    version(): string;
-    timestamp(): string;
-    init(samples?: SamplesStructure): Promise<void>;
-    sampleForTransaction(transactionId: string): HttpRequestSample | undefined;
+    private format;
+    private shape;
+    /**
+     * Project `format` in full, replacing any previous projection.
+     *
+     * `shape` is applied per reply rather than baked into the projection, which is
+     * where the pipeline puts it — "generate base sample, then `defineSample`" —
+     * and it is also what keeps a `defineSample` hook from running for
+     * Transactions nobody asks about.
+     */
+    load(format: ThymianFormat, emitter: ThymianEmitter, shape?: SampleShaper): Promise<void>;
+    /**
+     * The request for one transaction, as a value the caller owns.
+     *
+     * Every reply is a fresh deep copy. Hooks mutate the request in place, and an
+     * inline content source hands its value out by reference, so returning the
+     * projection itself let a `beforeEach` header land in what `sampler show`
+     * printed afterwards — the projection is a projection of the description, and
+     * nothing a run does may write back into it.
+     *
+     * A transaction the projection has not seen is generated on the spot rather
+     * than reported as missing: generation is a pure function of the transaction,
+     * so an unprojected transaction is one nobody has asked for yet, not evidence
+     * that something on disk is out of date.
+     */
+    sampleForTransaction(transaction: ThymianHttpTransaction, emitter: ThymianEmitter): Promise<HttpRequestTemplate>;
 }
 //# sourceMappingURL=request-sampler.d.ts.map

package/dist/request-sampler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-sampler.d.ts","sourceRoot":"","sources":["../src/request-sampler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,+CAA+C,CAAC;AAIvD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,GACrB,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAY1B;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM,EACjC,OAAO,CAAC,EAAE,gBAAgB;IAS5B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuC;IAE1D,OAAO,IAAI,MAAM;IAIjB,SAAS,IAAI,MAAM;IAeb,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;CA+B3E"}
+{"version":3,"file":"request-sampler.d.ts","sourceRoot":"","sources":["../src/request-sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,aAAa,EACb,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AAMvB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,KAAK,CAA2B;IAExC;;;;;;;OAOG;IACG,IAAI,CACR,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CACxB,WAAW,EAAE,sBAAsB,EACnC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC;CAmBhC"}

package/dist/request-sampler.js

@@ -1,82 +1,57 @@
-import { ThymianBaseError } from '@thymian/core';
-import { readSamplesFromDir } from './samples-structure/read-samples-from-dir.js';
-import { nodeIsType, } from './samples-structure/samples-tree-structure.js';
-import { traverse } from './samples-structure/traverse.js';
-import { entryExists } from './utils.js';
-export function readSamplesNodesFromTree(tree) {
-    const result = new Map();
-    traverse(tree, null, (node, ctx) => {
-        if (nodeIsType(node, 'samples')) {
-            result.set(node.meta.sourceTransaction, node);
-        }
-        return ctx;
-    });
-    return result;
-}
+import { ThymianFormat, } from '@thymian/core';
+import { generateRequestSampleForTransaction } from './generation/generate-request-sample.js';
+import { requestSampleToRequestTemplate } from './request-sample-to-request-template.js';
+/**
+ * The sampler's answer to "what request should this transaction send?".
+ *
+ * Holds the in-memory projection of the currently loaded format and nothing
+ * else. There is no version, no timestamp and no baseline to compare against,
+ * because there is no artifact that could disagree with the format: {@link load}
+ * throws the previous projection away and rebuilds it.
+ */
 export class RequestSampler {
-    basePath;
-    constructor(basePath, samples) {
-        this.basePath = basePath;
-        if (samples) {
-            this.sampleNodes = readSamplesNodesFromTree(samples);
-            this.samples = samples;
-            this.initialized = true;
-        }
-    }
-    samples;
-    initialized = false;
-    sampleNodes = new Map();
-    version() {
-        return this.samples.meta.version;
-    }
-    timestamp() {
-        try {
-            return new Date(this.samples.meta.timestamp).toISOString();
-        }
-        catch (e) {
-            throw new ThymianBaseError(`Invalid timestamp in samples meta: ${this.samples.meta.timestamp}`, {
-                name: 'InvalidSampleTimestampError',
-                ref: 'https://thymian.dev/references/errors/invalid-sample-timestamp-error/',
-                cause: e,
-            });
-        }
-    }
-    async init(samples) {
-        if (this.initialized) {
-            return;
-        }
-        if (!(await entryExists(this.basePath))) {
-            return;
+    samples = new Map();
+    format = new ThymianFormat();
+    shape;
+    /**
+     * Project `format` in full, replacing any previous projection.
+     *
+     * `shape` is applied per reply rather than baked into the projection, which is
+     * where the pipeline puts it — "generate base sample, then `defineSample`" —
+     * and it is also what keeps a `defineSample` hook from running for
+     * Transactions nobody asks about.
+     */
+    async load(format, emitter, shape) {
+        this.format = format;
+        this.shape = shape;
+        this.samples = new Map();
+        for (const transaction of format.getThymianHttpTransactions()) {
+            this.samples.set(transaction.transactionId, await generateRequestSampleForTransaction(format, transaction, emitter));
         }
-        this.samples = samples ?? (await readSamplesFromDir(this.basePath));
-        this.sampleNodes = readSamplesNodesFromTree(this.samples);
-        this.initialized = true;
     }
-    sampleForTransaction(transactionId) {
-        if (!this.initialized) {
-            throw new ThymianBaseError('Cannot sample for transaction before @thymian/plugin-sampler was initialized.', {
-                suggestions: ['Did you run "thymian sampler init"?'],
-                name: 'SamplerNotInitializedError',
-            });
-        }
-        const node = this.sampleNodes.get(transactionId);
-        if (!node) {
-            return;
-        }
-        const { samplingStrategy } = node.meta;
-        const samples = node.children
-            .filter((child) => nodeIsType(child, 'requests'))
-            .flatMap((child) => child.value);
-        if (samplingStrategy.type === 'random') {
-            const randomIndex = Math.floor(Math.random() * samples.length);
-            return samples[randomIndex];
-        }
-        else if (samplingStrategy.type === 'fixed') {
-            return samples[0];
-        }
-        else {
-            throw new Error(`Unsupported sampling strategy ${samplingStrategy}`);
-        }
+    /**
+     * The request for one transaction, as a value the caller owns.
+     *
+     * Every reply is a fresh deep copy. Hooks mutate the request in place, and an
+     * inline content source hands its value out by reference, so returning the
+     * projection itself let a `beforeEach` header land in what `sampler show`
+     * printed afterwards — the projection is a projection of the description, and
+     * nothing a run does may write back into it.
+     *
+     * A transaction the projection has not seen is generated on the spot rather
+     * than reported as missing: generation is a pure function of the transaction,
+     * so an unprojected transaction is one nobody has asked for yet, not evidence
+     * that something on disk is out of date.
+     */
+    async sampleForTransaction(transaction, emitter) {
+        let sample = this.samples.get(transaction.transactionId);
+        if (!sample) {
+            sample = await generateRequestSampleForTransaction(this.format, transaction, emitter);
+            this.samples.set(transaction.transactionId, sample);
+        }
+        const draft = structuredClone(requestSampleToRequestTemplate(sample));
+        await this.shape?.(draft, transaction.transactionId);
+        return draft;
     }
 }
 //# sourceMappingURL=request-sampler.js.map

package/dist/request-sampler.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-sampler.js","sourceRoot":"","sources":["../src/request-sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EACL,UAAU,GAGX,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,wBAAwB,CACtC,IAAsB;IAEtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE9C,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,IAAI,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,cAAc;IAEN;IADnB,YACmB,QAAgB,EACjC,OAA0B;QADT,aAAQ,GAAR,QAAQ,CAAQ;QAGjC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,OAAO,CAAoB;IAC3B,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,GAA6B,IAAI,GAAG,EAAE,CAAC;IAE1D,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,SAAS;QACP,IAAI,CAAC;YACH,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,gBAAgB,CACxB,sCAAsC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EACnE;gBACE,IAAI,EAAE,6BAA6B;gBACnC,GAAG,EAAE,uEAAuE;gBAC5E,KAAK,EAAE,CAAC;aACT,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA0B;QACnC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEpE,IAAI,CAAC,WAAW,GAAG,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,oBAAoB,CAAC,aAAqB;QACxC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,gBAAgB,CACxB,+EAA+E,EAC/E;gBACE,WAAW,EAAE,CAAC,qCAAqC,CAAC;gBACpD,IAAI,EAAE,4BAA4B;aACnC,CACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ;aAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;aAChD,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,gBAAgB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,gBAAgB,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7C,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,iCAAiC,gBAAgB,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"request-sampler.js","sourceRoot":"","sources":["../src/request-sampler.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,GAEd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mCAAmC,EAAE,MAAM,yCAAyC,CAAC;AAE9F,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAWzF;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAmC,IAAI,GAAG,EAAE,CAAC;IACpD,MAAM,GAAkB,IAAI,aAAa,EAAE,CAAC;IAC5C,KAAK,CAA2B;IAExC;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,MAAqB,EACrB,OAAuB,EACvB,KAAoB;QAEpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QAEzB,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,0BAA0B,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,WAAW,CAAC,aAAa,EACzB,MAAM,mCAAmC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,oBAAoB,CACxB,WAAmC,EACnC,OAAuB;QAEvB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,MAAM,mCAAmC,CAChD,IAAI,CAAC,MAAM,EACX,WAAW,EACX,OAAO,CACR,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,KAAK,GAAG,eAAe,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC;QAEtE,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;QAErD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}