@cosmicdrift/kumiko-framework 0.367.0 → 0.369.0

package/dist/testing/e2e-generator.d.ts

@@ -1,49 +1,5 @@
-import type * as z from "zod";
-import { type Registry } from "../engine/index.js";
-export type E2ETestSpec = {
-    readonly kind: "list-renders";
-    readonly screenQn: string;
-    readonly title: string;
-    readonly urlPath: string;
-} | {
-    readonly kind: "list-has-fixture-row";
-    readonly screenQn: string;
-    readonly title: string;
-    readonly urlPath: string;
-    readonly writeHandlerQn: string;
-    readonly fixture: Readonly<Record<string, unknown>>;
-    readonly identifyingValue: string;
-} | {
-    readonly kind: "edit-validates-required";
-    readonly screenQn: string;
-    readonly title: string;
-    readonly urlPath: string;
-    readonly requiredFields: readonly string[];
-} | {
-    readonly kind: "edit-save-persists";
-    readonly screenQn: string;
-    readonly title: string;
-    readonly urlPath: string;
-    readonly listUrlPath?: string;
-    readonly fills: readonly EditFillOp[];
-    readonly identifyingValue: string;
-    readonly identifyingField: string;
-};
-export type EditFillOp = {
-    readonly kind: "fill";
-    readonly field: string;
-    readonly value: string;
-} | {
-    readonly kind: "check";
-    readonly field: string;
-    readonly value: boolean;
-} | {
-    readonly kind: "select";
-    readonly field: string;
-    readonly value: string;
-};
-export type E2EGeneratorOptions = {
-    readonly tenantPlaceholder?: string;
-};
-export declare function generateE2ESpec(registry: Registry, options?: E2EGeneratorOptions): readonly E2ETestSpec[];
-export declare function generateZodFixture(schema: z.ZodTypeAny): unknown;
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers/e2e-generator`. Run
+ * `bun kumiko-upgrade --apply` to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers/e2e-generator";

package/dist/testing/e2e-generator.js

@@ -1,382 +1,5 @@
-// @runtime tooling
-//
-// E2E-Generator — leitet strukturierte TestSpecs aus der Registry ab.
-//
-// Grundidee: jede r.screen(...) ist eine testbare Oberfläche. Der Generator
-// iteriert getAllScreens() und baut pro Screen einen Satz TestSpecs (vier
-// Kinds, einer pro "was muss mindestens funktionieren"). Die Specs sind
-// JSON-serialisierbar — Consumer (Sample/Package-e2e) schreiben sie via
-// bun-Script als JSON auf Platte, und ein Playwright-globalSetup triggert
-// das vor jedem Run. Der eigentliche Playwright-Runner liest die JSON und
-// iteriert mit kind-spezifischen Handlern gegen den echten Renderer.
-//
-// Vorteil des 2-Prozess-Modells: die framework-runtime (Registry, drizzle,
-// ioredis-types etc.) lädt NIE im Playwright-Worker. Würde sie das, kollidierte
-// sie mit Playwrights Object.prototype-Symbolen ($$jest-matchers-object) und
-// der Worker würde beim spec-import crashen.
-//
-// Zwei Stufen, jede einzeln testbar:
-//   1. generateE2ESpec(registry)   — Registry → TestSpec[]
-//   2. generateZodFixture(schema)  — ZodType  → plausibler Value
-//
-// Stufe 2 ist intentionally minimal (Strategy a aus dem Plan): string/number/
-// boolean/date/enum/uuid + ZodOptional/ZodDefault-Unwrap. Alles andere wirft
-// "not supported yet" — wir füllen nach, wenn ein echter Caller es braucht.
-// Fake-komplexe-Werte würden nur False-Green-Tests produzieren.
-import { isFieldsEditSection, normalizeEditField, normalizeListColumn, parseQn, qn, sectionFieldSpecs, toKebab, } from "../engine/index.js";
-// --- Stufe 1: Spec-Ableitung aus der Registry ---
-export function generateE2ESpec(registry, options = {}) {
-    const tenant = options.tenantPlaceholder ?? "{tenant}";
-    const specs = [];
-    for (const [screenQn, screen] of registry.getAllScreens()) {
-        if (screen.type === "custom")
-            continue; // keine generische Annahme möglich
-        // actionForm: kein generischer E2E-Spec — Author-defined Handler
-        // braucht Author-defined Test-Daten, die der Generator nicht kennt.
-        if (screen.type === "actionForm")
-            continue;
-        // secretMint: same reasoning — author-defined write handler, no generic spec.
-        if (screen.type === "secretMint")
-            continue;
-        // configEdit: dito — die Werte werden über config:write:set
-        // pro Field geschrieben, ohne CRUD-Zustand zu generieren wäre der
-        // Spec wertlos. Branding/SMTP/etc. sind Author-spezifisch.
-        if (screen.type === "configEdit")
-            continue;
-        // secretsEdit: dito — writes go through secrets:write:set with
-        // plaintext values the generator has no author-defined test data for.
-        if (screen.type === "secretsEdit")
-            continue;
-        // projectionList: query-getrieben, Author-spezifische Projection —
-        // kein generischer CRUD-Spec ableitbar (wie actionForm/configEdit).
-        if (screen.type === "projectionList")
-            continue;
-        // projectionDetail: dito — read-only single-row inspector, kein CRUD-Zustand.
-        if (screen.type === "projectionDetail")
-            continue;
-        // dashboard: panel-getrieben (Stat/Chart/List-Queries) — dito, keine
-        // generische CRUD-Annahme möglich.
-        if (screen.type === "dashboard")
-            continue;
-        const { scope: feature, name: short } = parseQn(screenQn);
-        const urlPath = `/t/${tenant}/${feature}/${short}`;
-        const title = `${feature}/${short}`;
-        if (screen.type === "entityList") {
-            specs.push(...buildListSpecs(screen, screenQn, title, urlPath, registry));
-        }
-        else {
-            specs.push(...buildEditSpecs(screen, screenQn, title, urlPath, registry, tenant));
-        }
-    }
-    return specs;
-}
-function buildListSpecs(screen, screenQn, title, urlPath, registry) {
-    const out = [{ kind: "list-renders", screenQn, title, urlPath }];
-    const entity = registry.getEntity(screen.entity);
-    if (!entity)
-        return out;
-    const writeHandlerQn = findCreateHandlerQn(registry, screen.entity);
-    if (!writeHandlerQn)
-        return out;
-    const fixture = buildEntityFixture(entity);
-    const identifyingValue = pickIdentifyingValue(fixture, screen, entity);
-    if (identifyingValue === undefined)
-        return out;
-    out.push({
-        kind: "list-has-fixture-row",
-        screenQn,
-        title,
-        urlPath,
-        writeHandlerQn,
-        fixture,
-        identifyingValue,
-    });
-    return out;
-}
-function buildEditSpecs(screen, screenQn, title, urlPath, registry, tenant) {
-    const out = [];
-    const entity = registry.getEntity(screen.entity);
-    if (!entity)
-        return out;
-    const requiredFields = collectRequiredEditFields(screen, entity);
-    if (requiredFields.length > 0) {
-        out.push({ kind: "edit-validates-required", screenQn, title, urlPath, requiredFields });
-    }
-    const fixture = buildEntityFixture(entity);
-    const listScreen = findListScreenForEntity(registry, screen.entity);
-    const listUrlPath = listScreen ? buildScreenUrlPath(listScreen.qn, tenant) : undefined;
-    const identifying = pickIdentifyingForEdit(fixture, screen, entity, listScreen?.def);
-    if (identifying) {
-        const fills = buildEditFillOps(screen, entity, fixture);
-        out.push({
-            kind: "edit-save-persists",
-            screenQn,
-            title,
-            urlPath,
-            listUrlPath,
-            fills,
-            identifyingValue: identifying.value,
-            identifyingField: identifying.field,
-        });
-    }
-    return out;
-}
-function buildScreenUrlPath(qn, tenant) {
-    const { scope, name } = parseQn(qn);
-    return `/t/${tenant}/${scope}/${name}`;
-}
-function findCreateHandlerQn(registry, entityName) {
-    // feature.writeHandlers ist mit Short-Names gekeyt ("task:create"), der
-    // Registry-Lookup braucht die qualified Form ("tasks:write:task:create").
-    // Wir qualifizieren via qn() + toKebab wie die Registry selbst — das ist
-    // der Vertrag aus qualified-name.ts.
-    for (const feature of registry.features.values()) {
-        for (const shortName of Object.keys(feature.writeHandlers ?? {})) {
-            if (!shortName.endsWith(":create"))
-                continue;
-            const qualified = qn(toKebab(feature.name), "write", toKebab(shortName));
-            if (registry.getHandlerEntity(qualified) === entityName)
-                return qualified;
-        }
-    }
-    return undefined;
-}
-function findListScreenForEntity(registry, entityName) {
-    for (const [qn, screen] of registry.getAllScreens()) {
-        if (screen.type === "entityList" && screen.entity === entityName) {
-            return { qn, def: screen };
-        }
-    }
-    return undefined;
-}
-function collectRequiredEditFields(screen, entity) {
-    const out = [];
-    for (const section of screen.layout.sections) {
-        if (!isFieldsEditSection(section))
-            continue;
-        for (const rawField of sectionFieldSpecs(section)) {
-            const { field } = normalizeEditField(rawField);
-            const def = entity.fields[field];
-            if (def && "required" in def && def.required === true) {
-                out.push(field);
-            }
-        }
-    }
-    return out;
-}
-function pickIdentifyingValue(fixture, screen, entity) {
-    // Erste Text-Spalte mit Fixture-Wert — das ist die visuell zuverlässigste
-    // Identifikation in einer generischen Tabelle.
-    for (const raw of screen.columns) {
-        const { field } = normalizeListColumn(raw);
-        if (entity.fields[field]?.type !== "text")
-            continue;
-        const v = fixture[field];
-        if (typeof v === "string" && v.length > 0)
-            return v;
-    }
-    return undefined;
-}
-function buildEditFillOps(screen, entity, fixture) {
-    // Laufe die Layout-Reihenfolge — das Resultat spiegelt, was ein User
-    // tatsächlich ausfüllt. Per Field-Typ entscheiden wir die Interaktions-
-    // form; Felder ohne Fixture-Wert (file/image/…) werden übersprungen.
-    const ops = [];
-    for (const section of screen.layout.sections) {
-        if (!isFieldsEditSection(section))
-            continue;
-        for (const raw of sectionFieldSpecs(section)) {
-            const { field } = normalizeEditField(raw);
-            const def = entity.fields[field];
-            if (!def)
-                continue;
-            const v = fixture[field];
-            if (v === undefined)
-                continue;
-            switch (def.type) {
-                case "boolean":
-                    if (typeof v === "boolean")
-                        ops.push({ kind: "check", field, value: v });
-                    break;
-                case "select":
-                    if (typeof v === "string")
-                        ops.push({ kind: "select", field, value: v });
-                    break;
-                case "text":
-                case "longText":
-                case "number":
-                case "date":
-                case "tz":
-                    // date: ein Text-Input, akzeptiert getippte ISO-Werte direkt.
-                    ops.push({ kind: "fill", field, value: String(v) });
-                    break;
-                // embedded/money/timestamp/locatedTimestamp/file/image/files/images:
-                // keine generische Interaktion. timestamp rendert seit #369 zwei
-                // Inputs (Datum + Uhrzeit), die ein einzelnes .fill() nicht bedienen
-                // kann — der Test-Autor liefert einen Hand-Override oder überspringt.
-                default:
-                    break;
-            }
-        }
-    }
-    return ops;
-}
-function pickIdentifyingForEdit(fixture, editScreen, entity, listScreen) {
-    // Bevorzugt ein Feld das im List-Screen als Column auftaucht — sonst ist
-    // die "taucht in Liste auf"-Assertion nicht durchführbar.
-    const columns = listScreen
-        ? new Set(listScreen.columns.map((c) => normalizeListColumn(c).field))
-        : undefined;
-    for (const section of editScreen.layout.sections) {
-        if (!isFieldsEditSection(section))
-            continue;
-        for (const rawField of sectionFieldSpecs(section)) {
-            const { field } = normalizeEditField(rawField);
-            if (entity.fields[field]?.type !== "text")
-                continue;
-            if (columns && !columns.has(field))
-                continue;
-            const v = fixture[field];
-            if (typeof v === "string" && v.length > 0)
-                return { field, value: v };
-        }
-    }
-    return undefined;
-}
-function readZodInternals(schema) {
-    return schema._def;
-}
-export function generateZodFixture(schema) {
-    const def = readZodInternals(schema);
-    const typeName = def?.type;
-    switch (typeName) {
-        case "optional":
-        case "nullable":
-        case "default": {
-            if (!def?.innerType)
-                throw new Error(`zod ${typeName} without innerType`);
-            return generateZodFixture(def.innerType);
-        }
-        case "string":
-            return fixtureString(def?.format);
-        case "number":
-            return 1;
-        case "boolean":
-            return true;
-        case "enum": {
-            const first = def?.entries ? Object.values(def.entries)[0] : undefined;
-            return first ?? "";
-        }
-        case "date":
-            return new Date("2026-01-01T00:00:00Z");
-        case "pipe": {
-            if (!def?.out)
-                throw new Error("zod pipe without out");
-            return generateZodFixture(def.out);
-        }
-        default:
-            throw new Error(`generateZodFixture: not supported yet: ${typeName ?? "<unknown>"}`);
-    }
-}
-function fixtureString(format) {
-    if (format === "email")
-        return "e2e@example.com";
-    if (format === "url")
-        return "https://example.com";
-    if (format === "uuid" || format === "guid")
-        return "00000000-0000-4000-8000-000000000000";
-    if (format === "datetime" || format === "date")
-        return "2026-01-01T00:00:00Z";
-    return "e2e-fixture";
-}
-// --- Fixture aus FieldDefinition (für Stufe 1 statt Zod-Schema) ---
-//
-// Bewusstes Duplicate zu generateZodFixture. Die beiden haben unterschiedliche
-// Aufgaben:
-//   generateZodFixture   — public, generisch, weiß nur Zod-Primitives
-//   buildEntityFixture   — intern, Kumiko-Domain, weiß über file-skip,
-//                          embedded-Shape, money/tz-Objekte und nutzt den
-//                          Feldnamen für lesbare Prefixes ("e2e-email@...")
-//
-// Ein Zusammenziehen über buildInsertSchema + generateZodFixture würde entweder
-// den Feldnamen-Hint verlieren (alle email-Fixtures bekämen denselben Wert —
-// Unique-Constraints wären inkonsistent) oder einen hint-Parameter in die
-// public API von generateZodFixture drücken, den externe Caller nie brauchen.
-function buildEntityFixture(entity) {
-    const out = {};
-    for (const [name, field] of Object.entries(entity.fields)) {
-        const value = fieldToFixture(name, field);
-        if (value !== undefined)
-            out[name] = value;
-    }
-    return out;
-}
-function fieldToFixture(name, field) {
-    switch (field.type) {
-        case "text": {
-            if (field.format === "email")
-                return `e2e-${name}@example.com`;
-            if (field.format === "url")
-                return "https://example.com";
-            return `e2e ${name}`;
-        }
-        case "longText":
-            // longText hat keine format-Optionen — generic placeholder reicht.
-            return `e2e ${name} (long-form content)`;
-        case "boolean":
-            return true;
-        case "select": {
-            const conditional = new Set(field.conditionalOptions?.flatMap((rule) => rule.options));
-            return (field.default ??
-                field.options.find((option) => !conditional.has(option)) ??
-                field.options[0] ??
-                "");
-        }
-        case "multiSelect": {
-            const first = field.options[0];
-            return first ? [first] : [];
-        }
-        case "number":
-            return 1;
-        case "money":
-            return { amount: 1, currency: "EUR" };
-        case "date":
-            return "2026-01-01";
-        case "timestamp":
-            return field.locatedBy !== undefined ? "2026-01-01T00:00:00" : "2026-01-01T00:00:00Z";
-        case "tz":
-            return "Europe/Berlin";
-        case "locatedTimestamp":
-            return { at: "2026-01-01T00:00:00", tz: "Europe/Berlin" };
-        case "embedded": {
-            const sub = {};
-            for (const [subName, subDef] of Object.entries(field.schema)) {
-                sub[subName] =
-                    subDef.type === "text"
-                        ? `e2e ${subName}`
-                        : subDef.type === "number" || subDef.type === "decimal"
-                            ? 1
-                            : subDef.type === "money"
-                                ? 100
-                                : subDef.type === "boolean"
-                                    ? true
-                                    : "2026-01-01";
-            }
-            return field.multiple === true ? [sub] : sub;
-        }
-        case "jsonb":
-            // Free-form jsonb — e2e-generator returns empty-object.
-            return {};
-        case "file":
-        case "image":
-        case "files":
-        case "images":
-            // File-Upload-Fixture ist noch nicht generisch: Playwright müsste
-            // Dateiinhalte mitliefern, und die Write-API verlangt bereits ge-
-            // uploadete fileRef-UUIDs. Lässt sich nachziehen, sobald Sample die
-            // Pfade klärt (M4).
-            return undefined;
-        default:
-            return undefined;
-    }
-}
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers/e2e-generator`. Run
+ * `bun kumiko-upgrade --apply` to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers/e2e-generator";

package/dist/testing/handler-context.d.ts

@@ -1,4 +1,5 @@
-import type { HandlerContext, SessionUser } from "../engine/types/index.js";
-export declare function bridgeStub(opts?: {
-    readonly user?: SessionUser;
-}): Pick<HandlerContext, "query" | "queryAs" | "write" | "writeAs" | "appendEvent" | "unsafeAppendEvent" | "tryAppendEvent" | "fetchForWriting" | "loadAggregate" | "archiveStream" | "restoreStream" | "isStreamArchived" | "snapshotAggregate" | "loadAggregateWithSnapshot" | "queryProjection" | "resolveAuthClaims" | "resolveActiveMembership" | "queryAsMember" | "hasFeature" | "metrics" | "metricsFor" | "tracer" | "tz" | "locale" | "user">;
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-framework/engine`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export { bridgeStub } from "../engine/bridge-stub.js";

package/dist/testing/handler-context.js

@@ -1,69 +1,5 @@
-// @runtime runtime
-//
-// bridgeStub hands back a HandlerContext shape with throw-on-use bridge
-// methods (ctx.query/write/loadAggregate/...). Used by both test code AND
-// production services (delivery-service uses it to run cross-feature notify
-// calls without a real dispatcher). Hence the runtime classification despite
-// living under `testing/` — no vitest imports, no test side-effects.
-import { createAnonymousUser } from "../engine/system-user.js";
-import { DEFAULT_LOCALE } from "../i18n/request-locale.js";
-import { createNoopMetricsHandle, getFallbackTracer } from "../observability/index.js";
-import { createTzContext } from "../time/index.js";
-// Test/service helper: cross-feature bridge methods that throw on use.
-//
-// Production code always receives a full HandlerContext from the Dispatcher's
-// buildHandlerContext (with real query/write closures). Some internal services
-// and tests construct a mini-context manually (typically just `{ db, registry }`)
-// to invoke a single handler. Those call sites don't use ctx.query/write —
-// the stubs make the TypeScript shape match while still failing loudly if
-// anything downstream accidentally reaches for them.
-//
-// Use: `{ db, registry, ...bridgeStub() }`
-const notAvailable = (what) => async () => {
-    throw new Error(`ctx.${what} not available in this context — use the dispatcher, not a stubbed handler context`);
-};
-// Noop observability — hand back the shared fallback tracer so ctx.tracer has
-// a valid Tracer shape. No allocations per call.
-const noopTracer = getFallbackTracer();
-export function bridgeStub(opts) {
-    // ctx.user is a convenience alias for event.user (see HandlerContext
-    // docs). Caller code expects the field; bridgeStub hands back a stub with
-    // anonymous default values when no user is passed explicitly. Test code
-    // that cares about identity passes its own SessionUser here and gets it
-    // back on ctx.
-    const stubUser = opts?.user ??
-        createAnonymousUser("00000000-0000-0000-0000-000000000000"); // @cast-boundary engine-bridge
-    return {
-        user: stubUser,
-        query: notAvailable("query"), // @cast-boundary engine-bridge
-        queryAs: notAvailable("queryAs"),
-        write: notAvailable("write"),
-        writeAs: notAvailable("writeAs"),
-        appendEvent: notAvailable("appendEvent"),
-        unsafeAppendEvent: notAvailable("unsafeAppendEvent"),
-        tryAppendEvent: notAvailable("tryAppendEvent"),
-        fetchForWriting: notAvailable("fetchForWriting"),
-        loadAggregate: notAvailable("loadAggregate"),
-        archiveStream: notAvailable("archiveStream"),
-        restoreStream: notAvailable("restoreStream"),
-        isStreamArchived: notAvailable("isStreamArchived"),
-        snapshotAggregate: notAvailable("snapshotAggregate"),
-        loadAggregateWithSnapshot: notAvailable("loadAggregateWithSnapshot"),
-        queryProjection: notAvailable("queryProjection"),
-        resolveAuthClaims: notAvailable("resolveAuthClaims"),
-        resolveActiveMembership: notAvailable("resolveActiveMembership"),
-        queryAsMember: notAvailable("queryAsMember"),
-        // Stub defaults to always-enabled — matches the dispatcher's behaviour
-        // when no effectiveFeatures resolver is wired (tests without toggles).
-        hasFeature: async () => true,
-        metrics: createNoopMetricsHandle(),
-        metricsFor: () => createNoopMetricsHandle(),
-        tracer: noopTracer,
-        // Real TzContext, not notAvailable — test code uses ctx.tz routinely,
-        // it isn't a "bridge" concept. Defaults to UTC.
-        tz: createTzContext(),
-        // Same reasoning as tz above — ctx.locale is always-present, not a
-        // bridge method. Defaults to DEFAULT_LOCALE.
-        locale: DEFAULT_LOCALE,
-    };
-}
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-framework/engine`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export { bridgeStub } from "../engine/bridge-stub.js";

package/dist/testing/index.d.ts

@@ -1,26 +1,10 @@
-export { resetBlindIndexKeyForTests } from "../crypto/blind-index.js";
-export { resetEventPiiCatalogForTests } from "../crypto/event-pii.js";
-export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.js";
-export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.js";
-export { rolesOf } from "./access-assertions.js";
-export { expectError, expectSuccess } from "./assertions.js";
-export { withBootValidatorFixture } from "./boot-validator-fixture.js";
-export { captureClosedConnectionError } from "./closed-connection-error.js";
-export { type ClearableTable, clearTables, resetTestTables } from "./db-cleanup.js";
-export { type E2EGeneratorOptions, type E2ETestSpec, type EditFillOp, generateE2ESpec, generateZodFixture, } from "./e2e-generator.js";
-export { expectErrorIncludes } from "./expect-error.js";
-export { describeFileProviderContract } from "./file-provider-contract.js";
-export { bridgeStub } from "./handler-context.js";
-export { getSetCookieRaw, getSetCookies, getSetCookieValue, type ParsedSetCookie, } from "./http-cookies.js";
-export { createLateBoundHolder, type LateBoundHolder } from "./late-bound.js";
-export { createManualClock, type ManualClock } from "./manual-clock.js";
-export { buildMultipartBody, patchFileInstanceofForBunTest } from "./multipart-helper.js";
-export { createMutableMasterKeyProvider, createTestEnvelopeCipher, createTestMasterKeyProvider, type MutableMasterKeyProvider, } from "./mutable-master-key-provider.js";
-export { createRecordingProvider, type RecordingProvider, } from "./observability-recorder.js";
-export { isRealProviderRun, REAL_PROVIDERS_ENV, requireRealProviders } from "./real-providers.js";
-export { deleteRows, seedRow, seedRows, updateRows } from "./seed.js";
-export { sharedItemEntity, sharedItemTable, sharedUserEntity, sharedUserTable, sharedWidgetEntity, sharedWidgetTable, } from "./shared-entities.js";
-export { sleep } from "./utils.js";
-export { waitFor } from "./wait-for.js";
-export { withoutAmbientTemporal } from "./without-ambient-temporal.js";
-export { zipWithEntries } from "./zip-fixture.js";
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers";
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-framework/engine`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export { bridgeStub } from "../engine/bridge-stub.js";

package/dist/testing/index.js

@@ -1,34 +1,10 @@
-// Test assertions and domain test fixtures. Production code (dev-server, bin/)
-// must import nothing from this subpath — the stack builders live in
-// `@cosmicdrift/kumiko-framework/stack`.
-// The four cache/injection resets stay in their own modules (they close over
-// module-private state) and are only re-exported here — they are out of /crypto
-// and /db as of #1631. A production call to resetPiiSubjectKmsForTests() silently
-// switches the PII layer off, and subject-annotated fields are written in
-// plaintext from then on: no error, no log.
-export { resetBlindIndexKeyForTests } from "../crypto/blind-index.js";
-export { resetEventPiiCatalogForTests } from "../crypto/event-pii.js";
-export { resetPiiSubjectKmsForTests } from "../crypto/pii-field-encryption.js";
-export { resetEntityFieldEncryptionCacheForTests } from "../db/entity-field-encryption.js";
-export { rolesOf } from "./access-assertions.js";
-export { expectError, expectSuccess } from "./assertions.js";
-export { withBootValidatorFixture } from "./boot-validator-fixture.js";
-export { captureClosedConnectionError } from "./closed-connection-error.js";
-export { clearTables, resetTestTables } from "./db-cleanup.js";
-export { generateE2ESpec, generateZodFixture, } from "./e2e-generator.js";
-export { expectErrorIncludes } from "./expect-error.js";
-export { describeFileProviderContract } from "./file-provider-contract.js";
-export { bridgeStub } from "./handler-context.js";
-export { getSetCookieRaw, getSetCookies, getSetCookieValue, } from "./http-cookies.js";
-export { createLateBoundHolder } from "./late-bound.js";
-export { createManualClock } from "./manual-clock.js";
-export { buildMultipartBody, patchFileInstanceofForBunTest } from "./multipart-helper.js";
-export { createMutableMasterKeyProvider, createTestEnvelopeCipher, createTestMasterKeyProvider, } from "./mutable-master-key-provider.js";
-export { createRecordingProvider, } from "./observability-recorder.js";
-export { isRealProviderRun, REAL_PROVIDERS_ENV, requireRealProviders } from "./real-providers.js";
-export { deleteRows, seedRow, seedRows, updateRows } from "./seed.js";
-export { sharedItemEntity, sharedItemTable, sharedUserEntity, sharedUserTable, sharedWidgetEntity, sharedWidgetTable, } from "./shared-entities.js";
-export { sleep } from "./utils.js";
-export { waitFor } from "./wait-for.js";
-export { withoutAmbientTemporal } from "./without-ambient-temporal.js";
-export { zipWithEntries } from "./zip-fixture.js";
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers";
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-framework/engine`. Run `bun kumiko-upgrade --apply`
+ * to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export { bridgeStub } from "../engine/bridge-stub.js";

package/dist/testing/real-providers.d.ts

@@ -1,3 +1,5 @@
-export declare const REAL_PROVIDERS_ENV = "KUMIKO_REAL_PROVIDERS";
-export declare function isRealProviderRun(env?: Readonly<Record<string, string | undefined>>): boolean;
-export declare function requireRealProviders(): void;
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers/real-providers`. Run
+ * `bun kumiko-upgrade --apply` to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers/real-providers";

package/dist/testing/real-providers.js

@@ -1,21 +1,5 @@
-// Playwright configs load this module under plain Node via
-// @cosmicdrift/kumiko-testing/e2e, so it must stay import-free.
-export const REAL_PROVIDERS_ENV = "KUMIKO_REAL_PROVIDERS";
-const CI_FLAG = "CI";
-function isCi() {
-    const ci = process.env[CI_FLAG];
-    return ci !== undefined && ci !== "" && ci !== "0" && ci.toLowerCase() !== "false";
-}
-// Apps and the e2e/bunfig templates gate real-provider runs on this same
-// check instead of re-reading KUMIKO_REAL_PROVIDERS themselves.
-export function isRealProviderRun(env = process.env) {
-    return env[REAL_PROVIDERS_ENV] === "1";
-}
-export function requireRealProviders() {
-    if (isCi()) {
-        throw new Error(`Real-provider tests never run in CI (CI is set). Run them locally with ${REAL_PROVIDERS_ENV}=1 via the test:real / e2e:real script.`);
-    }
-    if (!isRealProviderRun()) {
-        throw new Error(`Real-provider test needs ${REAL_PROVIDERS_ENV}=1 (an API key alone never enables it). Run it via the test:real / e2e:real script.`);
-    }
-}
+/**
+ * @deprecated Moved to `@cosmicdrift/kumiko-testing/helpers/real-providers`. Run
+ * `bun kumiko-upgrade --apply` to rewrite imports. Removed in the first release after 2026-10-29.
+ */
+export * from "@cosmicdrift/kumiko-testing/helpers/real-providers";