@fougere/testing 0.3.0-alpha.0

package/dist/remotes.js.map

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

package/dist/sample.d.ts

@@ -0,0 +1,22 @@
+import { type SchemaView } from '@fougere/schema';
+/**
+ * A body a client could legitimately send, built from what the entity declares.
+ *
+ * The shape IS JSON Schema, so the value itself is not ours to invent — `json-schema-faker`
+ * honours `minLength`, `enum`, `format`, `pattern`, `items` and `required`. What is ours is
+ * WHICH fields belong in a body, and that is `inputFields`: the one reader of the boundary
+ * and lifecycle axes the façade and the form already stand on. Re-deriving "not primary,
+ * not stamped, not read-only" here would make this a second opinion on the axes.
+ */
+export interface SampleOptions {
+    /**
+     * Fixes what is generated. Defaults to a value derived from the entity name, so two
+     * runs agree and a failure is replayable — a body drawn afresh every time produces the
+     * test that fails once in twenty and cannot be reproduced.
+     */
+    seed?: number;
+}
+/** How to reproduce the last generated body, in the words that reproduce it. */
+export declare function replaySeed(): string;
+export declare function sampleInput(entity: SchemaView, given?: Record<string, unknown>, options?: SampleOptions): Record<string, unknown>;
+//# sourceMappingURL=sample.d.ts.map

package/dist/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../src/sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9F;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA8BD,gFAAgF;AAChF,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}

package/dist/sample.js

@@ -0,0 +1,61 @@
+import { inputFields, Role } from '@fougere/schema';
+import { generateSync } from 'json-schema-faker';
+/** Stable across runs and across machines: the entity name is the only input. */
+function seedOf(name) {
+    let hash = 0;
+    for (let i = 0; i < name.length; i++)
+        hash = (hash * 31 + name.charCodeAt(i)) | 0;
+    return Math.abs(hash) || 1;
+}
+/**
+ * A relation has no value of its own to invent — `ref(Author)` names a row that must
+ * exist, and a made-up id points at nothing. So it is REFUSED by name rather than
+ * omitted: a body silently missing a required reference is a body the judge rejects for
+ * a reason that has nothing to do with the test.
+ */
+function referencesIn(fields) {
+    return Object.entries(fields)
+        .filter(([, field]) => Role.of(field).isReference)
+        .map(([name]) => name);
+}
+/**
+ * The seed the last sample used, so a failure can say how to replay it.
+ *
+ * A stable seed nobody can read is a stable seed for nothing: the value has to reach the
+ * person looking at the red line. Held here rather than returned, so the signature stays
+ * the body a caller wanted.
+ */
+let lastSeed;
+/** How to reproduce the last generated body, in the words that reproduce it. */
+export function replaySeed() {
+    return lastSeed
+        ? `sampleInput(${lastSeed.entity}, {}, { seed: ${lastSeed.seed} })`
+        : 'nothing has been sampled yet';
+}
+export function sampleInput(entity, given = {}, options = {}) {
+    const fields = inputFields(entity.getFields());
+    const missing = referencesIn(fields).filter((name) => !(name in given));
+    if (missing.length > 0) {
+        throw new Error(`[sampleInput] ${missing.join(', ')} ${missing.length > 1 ? 'are references' : 'is a reference'} — `
+            + 'a generated id points at no row. Pass the ids: '
+            + `sampleInput(Entity, { ${missing.map((n) => `${n}: '…'`).join(', ')} }).`);
+    }
+    const seed = options.seed ?? seedOf(entity.name ?? 'anonymous');
+    lastSeed = { entity: entity.name ?? 'Entity', seed };
+    const body = {};
+    let nth = 0;
+    for (const [name, field] of Object.entries(fields)) {
+        if (name in given) {
+            body[name] = given[name];
+            continue;
+        }
+        // One seed per field, derived from one seed per entity: two fields of the same shape
+        // would otherwise carry the same value, and a test asserting on `title` would pass
+        // while reading `body`.
+        // A `Shape` IS a JSON Schema; the two packages declare the same concept and only
+        // disagree on `readonly`, which no value crosses.
+        body[name] = generateSync(field.shape, { seed: seed + nth++ });
+    }
+    return body;
+}
+//# sourceMappingURL=sample.js.map

package/dist/sample.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,49 @@
+/**
+ * What a test file's position states about its subject.
+ *
+ * The same reading the scan already performs on `entities/` and `handlers/`: a directory
+ * is a declaration. A file under `fronds/blog/tests/` says its subject is `blog`, so that
+ * frond is real and its neighbours are not — which is a TOPOLOGY, the very thing
+ * `remotes:` states in production, and not a mode of testing.
+ *
+ * The sub-directory below `tests/` carries nothing. A name like `it('refuses a payment')`
+ * is prose, and prose deciding how an app is wired is the hidden runtime the doctrine
+ * refuses; a path is a position, which a reader sees by looking at where the file sits.
+ */
+export interface Scope {
+    /** The project the app boots from — where `fronds/` and `fougere.config.ts` live. */
+    root: string;
+    /** The frond under test. Absent means every frond is real: several of them, together. */
+    frond?: string;
+}
+/**
+ * The frond a path sits in, or nothing.
+ *
+ * The LAST `fronds/` segment wins: a frond may hold a synced copy of a neighbour under
+ * `.fougere/remotes/`, and a test that ever lands beside one is about the inner frond.
+ */
+export declare function frondOf(path: string, frondsDir?: string): string | undefined;
+/**
+ * Where the project starts: the first ancestor holding a config or a `fronds/`.
+ *
+ * The config is probed FIRST, which is what lets the rest of this file ask it where fronds
+ * live: a project that renamed the directory still declares one, and only a project with
+ * no config at all is found by the convention.
+ */
+export declare function rootOf(path: string): string | undefined;
+/**
+ * The scope a test file declares by where it sits.
+ *
+ * Returns nothing when the file sits outside any project — a caller then states `root`
+ * itself, which is what this package's own tests do against their fixtures.
+ */
+export declare function scopeOf(path: string): Promise<Scope | undefined>;
+/**
+ * The path of the running test file, from vitest.
+ *
+ * Read rather than guessed: `expect.getState()` is vitest's own API. Handed in by the
+ * caller because this module is ESM and cannot `require`, and because a package that
+ * imports vitest at the top level stops being loadable outside a test run.
+ */
+export declare function scopeOfRun(testPath: string | undefined): Promise<Scope | undefined>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,KAAK;IACpB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmC,GAAG,MAAM,GAAG,SAAS,CAMxG;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASvD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAQtE;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAEzF"}

package/dist/scope.js

@@ -0,0 +1,62 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, sep } from 'node:path';
+import { DEFAULT_CONVENTIONS, loadConfig, resolveConventions } from '@fougere/core/node';
+/**
+ * The frond a path sits in, or nothing.
+ *
+ * The LAST `fronds/` segment wins: a frond may hold a synced copy of a neighbour under
+ * `.fougere/remotes/`, and a test that ever lands beside one is about the inner frond.
+ */
+export function frondOf(path, frondsDir = DEFAULT_CONVENTIONS.fronds) {
+    const parts = path.split(sep);
+    const at = parts.lastIndexOf(frondsDir);
+    if (at === -1 || at + 1 >= parts.length)
+        return undefined;
+    const name = parts[at + 1];
+    return name && !name.endsWith('.ts') ? name : undefined;
+}
+/**
+ * Where the project starts: the first ancestor holding a config or a `fronds/`.
+ *
+ * The config is probed FIRST, which is what lets the rest of this file ask it where fronds
+ * live: a project that renamed the directory still declares one, and only a project with
+ * no config at all is found by the convention.
+ */
+export function rootOf(path) {
+    let at = dirname(path);
+    let previous = '';
+    while (at !== previous) {
+        if (existsSync(join(at, 'fougere.config.ts')) || existsSync(join(at, DEFAULT_CONVENTIONS.fronds)))
+            return at;
+        previous = at;
+        at = dirname(at);
+    }
+    return undefined;
+}
+/**
+ * The scope a test file declares by where it sits.
+ *
+ * Returns nothing when the file sits outside any project — a caller then states `root`
+ * itself, which is what this package's own tests do against their fixtures.
+ */
+export async function scopeOf(path) {
+    const root = rootOf(path);
+    if (!root)
+        return undefined;
+    // The root is known, so its config can say what the fronds directory is called before
+    // the position is read against it.
+    const { fronds } = resolveConventions((await loadConfig(root)).conventions);
+    const frond = frondOf(path, fronds);
+    return { root, ...(frond ? { frond } : {}) };
+}
+/**
+ * The path of the running test file, from vitest.
+ *
+ * Read rather than guessed: `expect.getState()` is vitest's own API. Handed in by the
+ * caller because this module is ESM and cannot `require`, and because a package that
+ * imports vitest at the top level stops being loadable outside a test run.
+ */
+export async function scopeOfRun(testPath) {
+    return testPath ? scopeOf(testPath) : undefined;
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAqBzF;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,SAAS,GAAW,mBAAmB,CAAC,MAAM;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAC7G,QAAQ,GAAG,EAAE,CAAC;QACd,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,sFAAsF;IACtF,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAA4B;IAC3D,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/stub.d.ts

@@ -0,0 +1,44 @@
+import { type Mock } from 'vitest';
+import type { App } from '@fougere/core';
+/** Anything a provider can be declared as: a class the container knows how to build. */
+export type Port = abstract new (...args: never[]) => unknown;
+/** The double handed in place of a port — one spy per method the port declares. */
+export type Stub<T> = {
+    [K in keyof T]: T[K] extends (...args: never[]) => unknown ? Mock : T[K];
+};
+/**
+ * The methods a port declares, read from the prototype chain at runtime.
+ *
+ * Not written by hand and not read from the AST: `ProviderEntry` keeps `ctor`, `deps` and
+ * `filePath` and never the methods, while the prototype has them all along. So a double
+ * carries exactly what the port carries and gains a method the day the port does — which
+ * is the failure `ports.test.ts` records, a `charge is not a function` from a stand-in
+ * that did not carry what its type promised.
+ *
+ * Walks the chain because a port may itself extend one; stops at `Object.prototype`,
+ * whose members belong to no port.
+ */
+export declare function methodsOf(port: Port): string[];
+/**
+ * A double for a port: every method present, every call recorded, nothing returned.
+ *
+ * What it RETURNS is not derivable and the value is the caller's to state — a service's
+ * return type is a bare TypeScript type, erased at runtime, with no declared fields for
+ * anything to build from. The same line the whole package sits on: what Fougere's
+ * vocabulary declares can be derived, arbitrary code cannot.
+ */
+export declare function stubOf<T>(port: Port): Stub<T>;
+/**
+ * Put doubles in front of ports, in every frond scope that answers under their name.
+ *
+ * After the boot rather than through `ports:`, because the container resolves lazily: a
+ * provider is built on first `resolve`, so a value registered before any call is the one
+ * a handler receives. `registerValue` also marks it as not the container's to dispose,
+ * which is right — the test made it.
+ *
+ * A port nobody answers under is REFUSED by name, for the reason `ports:` refuses a key
+ * that matched nothing: a double that silently stands in front of no one reads as a test
+ * that covered a case it never reached.
+ */
+export declare function installStubs(app: App, ports: Port[]): Map<Port, Stub<unknown>>;
+//# sourceMappingURL=stub.d.ts.map

package/dist/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../src/stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,wFAAwF;AACxF,MAAM,MAAM,IAAI,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;AAE9D,mFAAmF;AACnF,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEnG;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAY9C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAI7C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAiB9E"}

package/dist/stub.js

@@ -0,0 +1,71 @@
+import { vi } from 'vitest';
+/**
+ * The methods a port declares, read from the prototype chain at runtime.
+ *
+ * Not written by hand and not read from the AST: `ProviderEntry` keeps `ctor`, `deps` and
+ * `filePath` and never the methods, while the prototype has them all along. So a double
+ * carries exactly what the port carries and gains a method the day the port does — which
+ * is the failure `ports.test.ts` records, a `charge is not a function` from a stand-in
+ * that did not carry what its type promised.
+ *
+ * Walks the chain because a port may itself extend one; stops at `Object.prototype`,
+ * whose members belong to no port.
+ */
+export function methodsOf(port) {
+    const found = new Set();
+    let proto = port.prototype;
+    while (proto && proto !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(proto)) {
+            if (name === 'constructor')
+                continue;
+            const declared = Object.getOwnPropertyDescriptor(proto, name);
+            if (typeof declared?.value === 'function')
+                found.add(name);
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return [...found];
+}
+/**
+ * A double for a port: every method present, every call recorded, nothing returned.
+ *
+ * What it RETURNS is not derivable and the value is the caller's to state — a service's
+ * return type is a bare TypeScript type, erased at runtime, with no declared fields for
+ * anything to build from. The same line the whole package sits on: what Fougere's
+ * vocabulary declares can be derived, arbitrary code cannot.
+ */
+export function stubOf(port) {
+    const double = {};
+    for (const method of methodsOf(port))
+        double[method] = vi.fn();
+    return double;
+}
+/**
+ * Put doubles in front of ports, in every frond scope that answers under their name.
+ *
+ * After the boot rather than through `ports:`, because the container resolves lazily: a
+ * provider is built on first `resolve`, so a value registered before any call is the one
+ * a handler receives. `registerValue` also marks it as not the container's to dispose,
+ * which is right — the test made it.
+ *
+ * A port nobody answers under is REFUSED by name, for the reason `ports:` refuses a key
+ * that matched nothing: a double that silently stands in front of no one reads as a test
+ * that covered a case it never reached.
+ */
+export function installStubs(app, ports) {
+    const doubles = new Map();
+    const scopes = app.fronds.map((frond) => app.resolve(`frond:${frond.name}`));
+    for (const port of ports) {
+        const answering = scopes.filter((scope) => scope.has(port.name));
+        if (answering.length === 0) {
+            throw new Error(`[stub] ${port.name} — nothing answers under that name in any frond. `
+                + 'A port is a class a provider extends; a class nobody extends is an ordinary service.');
+        }
+        const double = stubOf(port);
+        for (const scope of answering)
+            scope.registerValue(port.name, double);
+        doubles.set(port, double);
+    }
+    return doubles;
+}
+//# sourceMappingURL=stub.js.map

package/dist/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../src/stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAa,MAAM,QAAQ,CAAC;AAUvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,KAAK,GAAkB,IAAI,CAAC,SAAmB,CAAC;IACpD,OAAO,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,KAAK,aAAa;gBAAE,SAAS;YACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC9D,IAAI,OAAO,QAAQ,EAAE,KAAK,KAAK,UAAU;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAI,IAAU;IAClC,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC/D,OAAO,MAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,KAAa;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAY,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAExF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,IAAI,mDAAmD;kBACpE,sFAAsF,CACzF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,SAAS;YAAE,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/sync.d.ts

@@ -0,0 +1,46 @@
+import { describe as describeSchema, type Change } from '@fougere/schema';
+import type { IdentityCard } from '@fougere/core';
+/** One entry of `.fougere/remotes.json`, written by `fougere sync`. */
+export interface SyncedRemote {
+    name: string;
+    url: string;
+    /** Where the synced classes were written. */
+    path: string;
+}
+/** What separates a consumer's synced copy from what the producer serves today. */
+export interface SyncDrift {
+    frond: string;
+    /** An entity the consumer holds that the producer no longer serves. */
+    gone: string[];
+    /** A shape that moved under a name the consumer still holds. */
+    moved: {
+        entity: string;
+        changes: Change[];
+    }[];
+}
+/** The remotes a project synced, read from the file `fougere sync` writes. */
+export declare function syncedRemotes(root: string): Promise<SyncedRemote[]>;
+/**
+ * The shapes a consumer holds for one remote frond.
+ *
+ * Rebuilt from the classes rather than read back: `fougere sync` writes entities and an
+ * index and does NOT keep the card it received. So the consumer's copy of the OPERATIONS
+ * has no local counterpart at all, and only the shapes can be compared — which is the
+ * narrower half, and the one that breaks a caller silently.
+ *
+ * Closing that would mean `sync` writing the card beside the classes; it is a change to
+ * the CLI, not to this file.
+ */
+export declare function heldShapes(remote: SyncedRemote): Promise<Map<string, ReturnType<typeof describeSchema>>>;
+/**
+ * What the consumer's copy no longer matches.
+ *
+ * Compared by the shape's own `title` — the entity's name as the descriptor carries it —
+ * rather than by the door's, because a door is addressed in lowercase (`post`) and a class
+ * is not (`Post`), and matching those two by hand is where a name convention gets copied
+ * a third time.
+ */
+export declare function syncDriftOf(held: Map<string, ReturnType<typeof describeSchema>>, card: IdentityCard, frond: string): SyncDrift;
+/** Whether the copy still matches. */
+export declare function inSync(drift: SyncDrift): boolean;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAQ,KAAK,MAAM,EAAmB,MAAM,iBAAiB,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CAChD;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CASzE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAW9G;AAYD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,EACpD,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,GACZ,SAAS,CAWX;AAED,sCAAsC;AACtC,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEhD"}

package/dist/sync.js

@@ -0,0 +1,79 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { describe as describeSchema, diff } from '@fougere/schema';
+/** The remotes a project synced, read from the file `fougere sync` writes. */
+export async function syncedRemotes(root) {
+    try {
+        const raw = await readFile(join(root, '.fougere', 'remotes.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        return Object.entries(parsed).map(([name, one]) => ({ name, ...one }));
+    }
+    catch {
+        // No file is the ordinary case: an app with no remote synced nothing.
+        return [];
+    }
+}
+/**
+ * The shapes a consumer holds for one remote frond.
+ *
+ * Rebuilt from the classes rather than read back: `fougere sync` writes entities and an
+ * index and does NOT keep the card it received. So the consumer's copy of the OPERATIONS
+ * has no local counterpart at all, and only the shapes can be compared — which is the
+ * narrower half, and the one that breaks a caller silently.
+ *
+ * Closing that would mean `sync` writing the card beside the classes; it is a change to
+ * the CLI, not to this file.
+ */
+export async function heldShapes(remote) {
+    const held = new Map();
+    const index = pathToFileURL(join(remote.path, 'index.ts')).href;
+    const module = await import(index);
+    for (const [name, exported] of Object.entries(module)) {
+        const entity = exported;
+        if (typeof entity !== 'function' || typeof entity.getFields !== 'function')
+            continue;
+        held.set(name, describeSchema(entity));
+    }
+    return held;
+}
+/** The shapes a card announces, by the name a door carries. */
+function servedShapes(card, frond) {
+    const served = new Map();
+    for (const one of card.fronds) {
+        if (one.name !== frond)
+            continue;
+        for (const door of one.doors)
+            if (door.schema)
+                served.set(door.schema.title ?? door.name, door.schema);
+    }
+    return served;
+}
+/**
+ * What the consumer's copy no longer matches.
+ *
+ * Compared by the shape's own `title` — the entity's name as the descriptor carries it —
+ * rather than by the door's, because a door is addressed in lowercase (`post`) and a class
+ * is not (`Post`), and matching those two by hand is where a name convention gets copied
+ * a third time.
+ */
+export function syncDriftOf(held, card, frond) {
+    const served = servedShapes(card, frond);
+    const drift = { frond, gone: [], moved: [] };
+    for (const [name, mine] of held) {
+        const theirs = served.get(name) ?? served.get(name.toLowerCase());
+        if (!theirs) {
+            drift.gone.push(name);
+            continue;
+        }
+        const moved = diff(mine, theirs);
+        if (moved.changes.length > 0)
+            drift.moved.push({ entity: name, changes: moved.changes });
+    }
+    return drift;
+}
+/** Whether the copy still matches. */
+export function inSync(drift) {
+    return drift.gone.length === 0 && drift.moved.length === 0;
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/vitest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The vitest configuration a Fougere project needs, so nobody has to discover it.
+ *
+ * One thing to know, and it is not obvious: `graphql` guards its types with `instanceOf`,
+ * so a schema built by one loaded copy is refused by another with *"from another module
+ * or realm"*. Under vitest a module is either transformed by Vite or externalized and
+ * loaded by node, and Pothos ending up on one side while `graphql()` sits on the other
+ * makes two copies of the same file. The alias pins the path, and the inlining makes the
+ * packages that touch it take that path — neither alone is enough, which is what made
+ * this cost an afternoon.
+ *
+ * An app that serves no GraphQL pays nothing for this: the alias resolves to whatever
+ * `graphql` the project has, and no `graphql` means the option is simply unused.
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import { fougereTest } from '@fougere/testing/vitest';
+ * export default fougereTest();
+ * ```
+ */
+export declare function fougereTest(overrides?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B5F"}

package/dist/vitest.js

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+/**
+ * The vitest configuration a Fougere project needs, so nobody has to discover it.
+ *
+ * One thing to know, and it is not obvious: `graphql` guards its types with `instanceOf`,
+ * so a schema built by one loaded copy is refused by another with *"from another module
+ * or realm"*. Under vitest a module is either transformed by Vite or externalized and
+ * loaded by node, and Pothos ending up on one side while `graphql()` sits on the other
+ * makes two copies of the same file. The alias pins the path, and the inlining makes the
+ * packages that touch it take that path — neither alone is enough, which is what made
+ * this cost an afternoon.
+ *
+ * An app that serves no GraphQL pays nothing for this: the alias resolves to whatever
+ * `graphql` the project has, and no `graphql` means the option is simply unused.
+ *
+ * ```ts
+ * // vitest.config.ts
+ * import { fougereTest } from '@fougere/testing/vitest';
+ * export default fougereTest();
+ * ```
+ */
+export function fougereTest(overrides = {}) {
+    const require = createRequire(import.meta.url);
+    let graphqlDir;
+    try {
+        graphqlDir = require.resolve('graphql').replace(/\/index\.js$/, '');
+    }
+    catch {
+        // No GraphQL in this project — nothing to pin.
+    }
+    const base = {
+        resolve: {
+            ...(graphqlDir ? { alias: { graphql: graphqlDir }, dedupe: ['graphql'] } : {}),
+        },
+        test: {
+            // Both spellings of where a test lives: beside the frond it is about, and above
+            // the fronds when it is about several of them.
+            include: ['tests/**/*.test.ts', 'fronds/*/tests/**/*.test.ts'],
+            server: { deps: { inline: [/@fougere\//, '@pothos/core'] } },
+        },
+    };
+    return {
+        ...base,
+        ...overrides,
+        resolve: { ...base.resolve, ...(overrides.resolve ?? {}) },
+        test: { ...base.test, ...(overrides.test ?? {}) },
+    };
+}
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,SAAS,GAA4B,EAAE;IACjE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,UAA8B,CAAC;IACnC,IAAI,CAAC;QACH,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;IAED,MAAM,IAAI,GAAG;QACX,OAAO,EAAE;YACP,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/E;QACD,IAAI,EAAE;YACJ,gFAAgF;YAChF,+CAA+C;YAC/C,OAAO,EAAE,CAAC,oBAAoB,EAAE,6BAA6B,CAAC;YAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,EAAE;SAC7D;KACF,CAAC;IAEF,OAAO;QACL,GAAG,IAAI;QACP,GAAG,SAAS;QACZ,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,OAAiB,IAAI,EAAE,CAAC,EAAE;QACpE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,IAAc,IAAI,EAAE,CAAC,EAAE;KAC5D,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@fougere/testing",
+  "version": "0.3.0-alpha.0",
+  "description": "Tests derived from the declaration — cases, stubs and a gradient of realities.",
+  "keywords": [
+    "fougere",
+    "typescript",
+    "framework",
+    "testing",
+    "json-schema"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/testing"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "import": "./dist/vitest.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "json-schema-faker": "^0.6.3",
+    "@fougere/container": "0.3.0-alpha.0",
+    "@fougere/defaults": "0.3.0-alpha.0",
+    "@fougere/schema": "0.3.0-alpha.0",
+    "@fougere/core": "0.3.0-alpha.0",
+    "@fougere/transport-http": "0.3.0-alpha.0",
+    "@fougere/app": "0.3.0-alpha.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vitest": ">=2",
+    "@fougere/adapter-graphql": "0.3.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    },
+    "@fougere/adapter-graphql": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "vitest": "^4.1.0",
+    "@fougere/adapter-graphql": "0.3.0-alpha.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}