문제 create:feature --with-create가 만드는 작성 폼의 feedback은 form.failure와 결과 불명 두 가지뿐이다. 저장 성공은 상세로 이동해서 알리는데, "변경됨으로 확인"은 reconcileUnknownEffect(...).then(form.settleApplied)이고 이동하지 않는다. settleApplied가 결과를 success로 바꾸고 기본값 resetOnSuccess로 입력을 비우므로, 결과 불명 화면이 사라진 뒤 빈 폼만 남는다. 짝 백엔드 기본(NEVER)에서는 이것이 화면 안의 유일한 행동이다. 사용자는 확인이 받아들여졌는지 모르고, 다시 입력해 저장하면 키 없는 생성이 한 번 더 나간다(실제로 저장됐던 경우 중복). 참조 폼은 같은 경우 "저장했습니다."를 보인다. 고른 방법 확인 뒤 폼을 정리하고(settleApplied, flushSync라 이동 전에 dirty 가드가 풀린다) 목록으로 이동한다. 목록은 항목이 실제로 저장됐는지를 보여 주는 화면이고, reconcileUnknownEffect가 이미 목록 topic을 무효화한다. 라우터가 목록 제목으로 포커스를 옮기므로 08-01의 포커스 문제도 이 폼에서는 생기지 않는다. 생성 기능 테스트에 "응답을 잃은 생성 → 변경됨으로 확인 → 목록 제목과 항목"을 한 행 더했다 (NEVER·KEYED 공통). 매뉴얼 02의 생성 테스트 행에 적었다. 버린 대안 참조 폼처럼 success 가지에 확인 문구를 둔다: 생성 catalog에 키가 하나 늘고, 항목이 실제로 있는지는 여전히 보이지 않는다. 위험·한계 - 짝 백엔드 생성기에는 목록 GET이 아직 없다(1103/03-07 결정 대기). 실제 짝 백엔드에서는 이동한 목록이 405를 받는다(생성 목록 페이지가 지금 그렇다). 생성 테스트는 MSW로 목록을 답한다. - 생성 결과 파일은 단위 테스트가 문자열로만 보고, 동작은 test:feature-scaffold (KEYED, FE-GATE-020)와 test:sample-removal(NEVER)에서 생성한 테스트가 본다. 검증 desktop batch에서 확인: node scripts/run-vitest.ts run tests/unit/create-feature.test.ts corepack pnpm test:feature-scaffold corepack pnpm test:sample-removal Refs: 1105/08-02
537 lines
22 KiB
TypeScript
537 lines
22 KiB
TypeScript
import { access, mkdir, mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
|
|
import { tmpdir } from "node:os";
|
|
import path from "node:path";
|
|
import { pathToFileURL } from "node:url";
|
|
|
|
import { afterEach, describe, expect, it } from "vitest";
|
|
|
|
import {
|
|
CreateFeatureError,
|
|
parseRequest,
|
|
planFeature,
|
|
randomTopicSuffix,
|
|
writeFeatureFiles,
|
|
type FeatureRequest,
|
|
type InstalledFacts,
|
|
} from "../../scripts/create-feature.ts";
|
|
import { createFileSystemDeclarationSource } from "../../scripts/generate-product-feature-index.ts";
|
|
import { PLACEHOLDER_CONTRACT_PACKAGE_DIGEST } from "../../src/contracts/deployment-admission.ts";
|
|
|
|
/**
|
|
* U7. What `pnpm create:feature` renders, checked without touching the
|
|
* repository. test:feature-scaffold writes a feature into a copy and runs the
|
|
* gates on it; this file covers the ids, the topic, the order and the refusals.
|
|
*/
|
|
const INSTALLED: InstalledFacts = Object.freeze({
|
|
appIds: ["template-app"],
|
|
featureIds: ["orders-feature", "drafts-feature"],
|
|
contexts: [
|
|
{ id: "orders-context", routePath: "orders/*" },
|
|
{ id: "billing-context", routePath: "billing/*" },
|
|
],
|
|
contextDirectories: ["orders-context", "billing-context"],
|
|
routes: [
|
|
{ routeId: "APP_HOME", path: "/", chunkId: "route-home", navigationOrder: 10 },
|
|
{ routeId: "ORDERS_LIST", path: "/orders", chunkId: "route-orders-list", navigationOrder: 50 },
|
|
{ routeId: "NOT_FOUND", path: "*", chunkId: "route-not-found", navigationOrder: null },
|
|
],
|
|
topics: ["qinv.0000000000000000000000000a"],
|
|
messageKeys: ["route.APP_HOME.title", "home.list.title"],
|
|
});
|
|
const TOPIC_SUFFIX = "abcdefghjkmnpqrstvwxyz0123";
|
|
|
|
function plan(request: FeatureRequest, installed: InstalledFacts = INSTALLED) {
|
|
return planFeature(request, installed, () => TOPIC_SUFFIX);
|
|
}
|
|
|
|
function rendered(request: FeatureRequest): string {
|
|
return [...plan(request).files.values()].join("\n");
|
|
}
|
|
|
|
describe("create:feature rendering", () => {
|
|
it("prefixes every global id with the feature and carries no sample token", () => {
|
|
const text = rendered({ id: "invoice-feature" });
|
|
|
|
expect(text).not.toMatch(/reference/iu);
|
|
const ids = [
|
|
...text.matchAll(
|
|
/\b(?:schemaId|inputSchemaId|operationId|mapperId|outputContractId|policyId|diagnosticsOperation|definitionId|chunkId|routeId|moduleId|loadingSurface|contributionId|owner)\s*:\s*"([^"]+)"/gu,
|
|
),
|
|
...text.matchAll(/\bzodValidator\(\s*"([^"]+)"/gu),
|
|
...text.matchAll(/defineQueryNamespaceIdentity\(\s*"([^"]+)"/gu),
|
|
...text.matchAll(/kind: "([a-z][^"]*\.[^"]*)"/gu),
|
|
...text.matchAll(/^\s+"((?:route\.)?[A-Za-z_.]+)": "/gmu),
|
|
].map((match) => match[1] ?? "");
|
|
expect(ids.length).toBeGreaterThan(30);
|
|
for (const id of ids) {
|
|
expect(id).toMatch(
|
|
/^(?:INVOICE_|Invoice|invoice[.-]|route\.INVOICE_LIST\.|route-invoice-|feature-frontend-invoice-feature$)/u,
|
|
);
|
|
}
|
|
expect(text).not.toMatch(/"NoRequest"/u);
|
|
});
|
|
|
|
it("names the route, context and topic it creates", () => {
|
|
const created = plan({ id: "invoice-feature" });
|
|
|
|
expect(created).toMatchObject({
|
|
contextId: "invoice-context",
|
|
newContext: true,
|
|
routeId: "INVOICE_LIST",
|
|
routePath: "/invoice",
|
|
topic: `qinv.${TOPIC_SUFFIX}`,
|
|
placeholder: true,
|
|
});
|
|
expect([...created.files.keys()]).toEqual(
|
|
expect.arrayContaining([
|
|
"src/contexts/invoice-context/context-module.ts",
|
|
"src/features/invoice-feature/feature-module.ts",
|
|
"tests/features/invoice-feature/invoice-feature-input.test.ts",
|
|
"tests/features/invoice-feature/invoice-list-page.test.tsx",
|
|
"artifacts/tests/a11y-manual/INVOICE_LIST.md",
|
|
]),
|
|
);
|
|
expect([...created.files.keys()].some((file) => file.includes("/domain/"))).toBe(false);
|
|
expect(created.files.get("src/contexts/invoice-context/context-module.ts")).toContain(
|
|
'CONTEXT_ROUTE_PATH = "invoice/*"',
|
|
);
|
|
expect(created.files.get("artifacts/tests/a11y-manual/INVOICE_LIST.md")).toMatch(
|
|
/^Status: pending-manual-review$/mu,
|
|
);
|
|
});
|
|
|
|
it("generates a fresh lower-case 26-character topic and refuses an installed one", () => {
|
|
const first = randomTopicSuffix();
|
|
expect(first).toMatch(/^[0-9a-hjkmnp-tv-z]{26}$/u);
|
|
expect(randomTopicSuffix()).not.toBe(first);
|
|
expect(() =>
|
|
planFeature({ id: "invoice-feature" }, INSTALLED, () => "0000000000000000000000000a"),
|
|
).toThrow(/qinv\.0000000000000000000000000a is already installed/u);
|
|
});
|
|
|
|
it("places the route after the last navigation entry", () => {
|
|
expect(rendered({ id: "invoice-feature" })).toContain("navigationOrder: 60,");
|
|
});
|
|
|
|
it("adds the route under an existing context's root", () => {
|
|
const created = plan({ id: "invoice-feature", context: "billing-context" });
|
|
|
|
expect(created).toMatchObject({ newContext: false, routePath: "/billing/invoice" });
|
|
expect([...created.files.keys()].some((file) => file.startsWith("src/contexts/"))).toBe(false);
|
|
});
|
|
|
|
it("pins the placeholder through its exported constant, or the given package", () => {
|
|
expect(rendered({ id: "invoice-feature" })).toContain(
|
|
"digest: PLACEHOLDER_CONTRACT_PACKAGE_DIGEST,",
|
|
);
|
|
const digest = `sha256:${"ab".repeat(32)}`;
|
|
const pinned = plan({
|
|
id: "invoice-feature",
|
|
contractPackage: {
|
|
packageId: "@org-contracts/invoice",
|
|
version: "1.4.2",
|
|
digest,
|
|
sourceRevision: "0a1b2c3d",
|
|
},
|
|
});
|
|
const contract = pinned.files.get(
|
|
"src/features/invoice-feature/contracts/invoice-feature-contract.ts",
|
|
);
|
|
expect(pinned.placeholder).toBe(false);
|
|
expect(contract).toContain(`digest: "${digest}",`);
|
|
expect(contract).not.toContain("PLACEHOLDER");
|
|
expect(digest).not.toBe(PLACEHOLDER_CONTRACT_PACKAGE_DIGEST);
|
|
});
|
|
|
|
// 1101 README 14.3. test:feature-scaffold runs the gateway test this renders.
|
|
it("reads the paired backend's Envelope and tests it with the backend's own bodies", () => {
|
|
const { files } = plan({ id: "invoice-feature" });
|
|
const contracts = "src/features/invoice-feature/contracts";
|
|
|
|
expect(files.get(`${contracts}/invoice-contract-contribution.ts`)).toContain(
|
|
'responseEnvelope: "ENVELOPE_V1" as const,',
|
|
);
|
|
expect(files.get(`${contracts}/invoice-schemas.ts`)).toMatch(
|
|
/invoiceProblemSchema = z\s*\.object\(\{\s*code: z\.string\(\)\.regex/u,
|
|
);
|
|
expect(
|
|
files.get("tests/features/invoice-feature/invoice-http-gateway.test.ts"),
|
|
).toContain('success: true, data: [{ id: "item-1", name: "First item" }]');
|
|
});
|
|
|
|
// 1103/03-07. The paired backend's new-feature.sh maps /<plural> (its
|
|
// camel-case name plus s, es or ies); the frontend's list reads the same
|
|
// resource path. The backend's api-base-path belongs in API_BASE_URL.
|
|
it.each([
|
|
["invoice-feature", "/invoices"],
|
|
["purchase-order-feature", "/purchaseOrders"],
|
|
["batch-feature", "/batches"],
|
|
["box-feature", "/boxes"],
|
|
["company-feature", "/companies"],
|
|
["day-feature", "/days"],
|
|
["status-feature", "/statuses"],
|
|
])("lists %s at the backend scaffold's resource path %s", (id, apiPath) => {
|
|
const base = id.slice(0, -"-feature".length);
|
|
const contribution = plan({ id }).files.get(
|
|
`src/features/${id}/contracts/${base}-contract-contribution.ts`,
|
|
);
|
|
|
|
expect(contribution).toContain(`const API_PATH = "${apiPath}";`);
|
|
});
|
|
|
|
// 1103/03-02. A page list's meta.page.total counts every page.
|
|
it("shows the total the backend counted, not the length of the first page", () => {
|
|
const { files } = plan({ id: "invoice-feature" });
|
|
|
|
expect(files.get("src/features/invoice-feature/contracts/invoice-mapper.ts")).toContain(
|
|
"total: page?.total ?? items.length",
|
|
);
|
|
expect(
|
|
files.get("src/features/invoice-feature/presentation/invoice-list-page.tsx"),
|
|
).toContain('message("invoice.list.resultCount", { count: query.data.total })');
|
|
});
|
|
});
|
|
|
|
/**
|
|
* 1103/09-06, 03-07. `--with-create` adds the paired backend scaffold's other
|
|
* two endpoints (POST /<plural>, GET /<plural>/{id}) with a detail page, a
|
|
* create form and the unknown-result handling. test:feature-scaffold and
|
|
* test:sample-removal generate it and run the gates on it.
|
|
*/
|
|
describe("create:feature --with-create", () => {
|
|
const contributionOf = (files: ReadonlyMap<string, string>) =>
|
|
files.get("src/features/invoice-feature/contracts/invoice-contract-contribution.ts") ?? "";
|
|
|
|
it("prefixes every id of the slice and adds its routes, pages and tests", () => {
|
|
const created = plan({ id: "invoice-feature", write: "NEVER" });
|
|
const text = [...created.files.values()].join("\n");
|
|
|
|
// No sample id. (`supportReference` is a platform prop.) Written so this
|
|
// file holds no sample id itself, which test:sample-removal looks for.
|
|
expect(text).not.toMatch(/REFERENCE_|ReferenceResource|reference-(?:feature|context)/u);
|
|
const ids = [
|
|
...text.matchAll(
|
|
/\b(?:schemaId|operationId|policyId|diagnosticsOperation|definitionId|chunkId|routeId|moduleId|loadingSurface|contributionId)\s*:\s*"([^"]+)"/gu,
|
|
),
|
|
...text.matchAll(/\bzodValidator\(\s*"([^"]+)"/gu),
|
|
...text.matchAll(/kind: "([a-z][^"]*\.[^"]*)"/gu),
|
|
...text.matchAll(/^\s+"((?:route\.)?[A-Za-z_.]+)": "/gmu),
|
|
].map((match) => match[1] ?? "");
|
|
expect(ids.length).toBeGreaterThan(50);
|
|
for (const id of ids) {
|
|
expect(id).toMatch(
|
|
/^(?:INVOICE_|Invoice|invoice[.-]|route\.INVOICE_(?:LIST|DETAIL|CREATE)\.|route-invoice-)/u,
|
|
);
|
|
}
|
|
expect([...created.files.keys()]).toEqual(
|
|
expect.arrayContaining([
|
|
"src/features/invoice-feature/presentation/invoice-detail-page.tsx",
|
|
"src/features/invoice-feature/presentation/invoice-create-page.tsx",
|
|
"src/features/invoice-feature/presentation/invoice-form.ts",
|
|
"src/features/invoice-feature/presentation/invoice-route-codecs.ts",
|
|
"src/features/invoice-feature/presentation/use-invoice-item.ts",
|
|
"src/features/invoice-feature/presentation/use-invoice-create.ts",
|
|
"tests/features/invoice-feature/invoice-create-page.test.tsx",
|
|
"artifacts/tests/a11y-manual/INVOICE_DETAIL.md",
|
|
"artifacts/tests/a11y-manual/INVOICE_CREATE.md",
|
|
]),
|
|
);
|
|
expect(created.routes).toEqual([
|
|
{ routeId: "INVOICE_LIST", path: "/invoice" },
|
|
{ routeId: "INVOICE_DETAIL", path: "/invoice/items/:invoiceId" },
|
|
{ routeId: "INVOICE_CREATE", path: "/invoice/new" },
|
|
]);
|
|
});
|
|
|
|
// 1103/16-01. Every generated operation declares the Envelope.
|
|
it("declares the Envelope on every operation it writes", () => {
|
|
const contribution = contributionOf(plan({ id: "invoice-feature", write: "NEVER" }).files);
|
|
|
|
expect(contribution.match(/operationId: "INVOICE_[A-Z_]+",/gu)).toHaveLength(3);
|
|
expect(contribution.match(/responseEnvelope: "ENVELOPE_V1" as const,/gu)).toHaveLength(3);
|
|
expect(contribution).toContain("pathTemplate: `${API_PATH}/{id}`,");
|
|
});
|
|
|
|
// 1103/03-07. new-feature.sh generates a NOT_IDEMPOTENT create: the backend
|
|
// ignores a key, so a same-key resend would create a second item.
|
|
it("matches the backend scaffold's NOT_IDEMPOTENT create with a NEVER command", () => {
|
|
const contribution = contributionOf(plan({ id: "invoice-feature", write: "NEVER" }).files);
|
|
|
|
expect(contribution).toContain('retrySemantics: "NEVER" as const,');
|
|
expect(contribution).toContain("retryBudget: 0 as const,");
|
|
expect(contribution).not.toContain("IDEMPOTENCY_REPLAY");
|
|
expect(contribution).toContain("acceptedStatuses: Object.freeze([201]),");
|
|
// 1103/03-01. The backend checks the name before its transaction.
|
|
expect(contribution).toContain('refusedBeforeWrite: Object.freeze(["INVOICE_INVALID"]),');
|
|
});
|
|
|
|
// 1105/08-04. Like the reference form: while a save this page did not
|
|
// start holds the coordinator, the save is off and the feedback says a
|
|
// save is running, instead of a save button that does nothing.
|
|
it("keeps the create's save off and says so while another save of it runs", () => {
|
|
const page =
|
|
plan({ id: "invoice-feature", write: "NEVER" }).files.get(
|
|
"src/features/invoice-feature/presentation/invoice-create-page.tsx",
|
|
) ?? "";
|
|
|
|
expect(page).toContain(
|
|
'const otherSaveRunning = mutation.state.indicator === "mutation-pending" && !form.pending;',
|
|
);
|
|
expect(page).toContain("disabled={effectUnknown || otherSaveRunning}");
|
|
expect(page).toContain('otherSaveRunning && form.result !== "effect-unknown" ? (');
|
|
expect(page).toContain("<AsyncSurface state={mutation.state} />");
|
|
});
|
|
|
|
// 1105/08-02. Confirming an unknown create used to leave an emptied form
|
|
// that said nothing. It opens the list, which shows whether the item is
|
|
// there, and the generated page test walks that path.
|
|
it.each(["NEVER", "KEYED"] as const)(
|
|
"opens the list after the user confirms an unknown %s create",
|
|
(write) => {
|
|
const { files } = plan({ id: "invoice-feature", write });
|
|
|
|
expect(
|
|
files.get("src/features/invoice-feature/presentation/invoice-create-page.tsx"),
|
|
).toContain('void navigate(invoiceRouteUrl("INVOICE_LIST"));');
|
|
expect(
|
|
files.get("tests/features/invoice-feature/invoice-create-page.test.tsx"),
|
|
).toContain('it("opens the list after the user confirms a create whose response was lost"');
|
|
},
|
|
);
|
|
|
|
// 1103/16-07. A backend create made KEYED (IdempotencyExecutor) takes these.
|
|
it("writes the KEYED values for a backend create made KEYED", () => {
|
|
const { files } = plan({ id: "invoice-feature", write: "KEYED" });
|
|
const contribution = contributionOf(files);
|
|
|
|
expect(contribution).toContain('retrySemantics: "KEYED" as const,');
|
|
expect(contribution).toContain('mode: "IDEMPOTENCY_REPLAY" as const,');
|
|
expect(contribution).toContain('operationIdentityField: "idempotencyKey",');
|
|
expect(contribution).toContain("retryBudget: 1 as const,");
|
|
expect(
|
|
files.get("tests/features/invoice-feature/invoice-create-page.test.tsx"),
|
|
).toContain('posts[1]!.headers.get("idempotency-key")');
|
|
expect(
|
|
files.get("src/features/invoice-feature/presentation/use-invoice-create.ts"),
|
|
).toContain("...commandMutationIdentity(INVOICE_CREATE_ITEM_CONTRACT),");
|
|
});
|
|
|
|
it("refuses a slice route that collides with an installed one", () => {
|
|
expect(() =>
|
|
plan(
|
|
{ id: "invoice-feature", write: "NEVER" },
|
|
{
|
|
...INSTALLED,
|
|
routes: [
|
|
...INSTALLED.routes,
|
|
{ routeId: "LEGACY", path: "/invoice/new", chunkId: "route-legacy", navigationOrder: null },
|
|
],
|
|
},
|
|
),
|
|
).toThrow(/route INVOICE_CREATE .* collides with installed route LEGACY/u);
|
|
});
|
|
|
|
it("takes --with-create and --keyed, and --keyed only with --with-create", () => {
|
|
expect(parseRequest(["invoice-feature", "--with-create"])).toMatchObject({
|
|
write: "NEVER",
|
|
});
|
|
expect(parseRequest(["invoice-feature", "--with-create", "--keyed"])).toMatchObject({
|
|
write: "KEYED",
|
|
});
|
|
expect(parseRequest(["invoice-feature"]).write).toBeUndefined();
|
|
expect(() => parseRequest(["invoice-feature", "--keyed"])).toThrow(
|
|
/--keyed needs --with-create/u,
|
|
);
|
|
});
|
|
});
|
|
|
|
/**
|
|
* X1 (2026-11-04). The generated context declaration is executed, not only
|
|
* read as text: the generator's declaration source reads it from disk, and an
|
|
* app module built from its exported route root accepts every route the
|
|
* feature declares (the check the router relies on, 09-06).
|
|
*/
|
|
describe("create:feature context declaration", () => {
|
|
const roots: string[] = [];
|
|
afterEach(async () => {
|
|
await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
|
|
});
|
|
|
|
async function appFor(
|
|
contextId: string,
|
|
routePath: string,
|
|
maxFeatures: number,
|
|
routes: readonly Readonly<{ routeId: string; path: string }>[],
|
|
) {
|
|
const { defineBoundedContextModule } = await import(
|
|
"../../src/contexts/bounded-context-module.ts"
|
|
);
|
|
const { defineDeployableAppModule } = await import("../../src/apps/deployable-app-module.ts");
|
|
return defineDeployableAppModule({
|
|
id: "template-app",
|
|
budget: { maxContexts: 20 },
|
|
contexts: [
|
|
defineBoundedContextModule({
|
|
id: contextId,
|
|
budget: { maxFeatures },
|
|
features: [
|
|
{
|
|
id: "invoice-feature",
|
|
contracts: {
|
|
routes: Object.fromEntries(routes.map((route) => [route.routeId, route])),
|
|
},
|
|
} as never,
|
|
],
|
|
route: { path: routePath, loadRoutes: async () => [] },
|
|
}),
|
|
],
|
|
});
|
|
}
|
|
|
|
it.each([undefined, "NEVER"] as const)(
|
|
"writes a context module the generator reads and whose root holds the routes (write %s)",
|
|
async (write) => {
|
|
const root = await mkdtemp(path.join(tmpdir(), "create-feature-context-"));
|
|
roots.push(root);
|
|
const created = plan({ id: "invoice-feature", write });
|
|
await mkdir(path.join(root, "src/apps/template-app"), { recursive: true });
|
|
await writeFile(
|
|
path.join(root, "src/apps/template-app/app-module.ts"),
|
|
'export const APP_MODULE_ID = "template-app";\nexport const APP_MAX_CONTEXTS = 20;\n',
|
|
);
|
|
await writeFeatureFiles(root, created.files);
|
|
|
|
const source = await createFileSystemDeclarationSource(root);
|
|
expect(source.contextsOf("template-app")).toEqual([
|
|
{ id: "invoice-context", appId: "template-app", routePath: "invoice/*", maxFeatures: 20 },
|
|
]);
|
|
expect(source.featuresOf("invoice-context").map((feature) => feature.id)).toEqual([
|
|
"invoice-feature",
|
|
]);
|
|
const declared = (await import(
|
|
pathToFileURL(path.join(root, "src/contexts/invoice-context/context-module.ts")).href
|
|
)) as Record<string, unknown>;
|
|
expect(declared).toMatchObject({
|
|
CONTEXT_MODULE_ID: "invoice-context",
|
|
CONTEXT_APP_ID: "template-app",
|
|
CONTEXT_ROUTE_PATH: "invoice/*",
|
|
});
|
|
|
|
const app = await appFor(
|
|
String(declared["CONTEXT_MODULE_ID"]),
|
|
String(declared["CONTEXT_ROUTE_PATH"]),
|
|
Number(declared["CONTEXT_MAX_FEATURES"]),
|
|
created.routes,
|
|
);
|
|
expect(app.contexts.map((context) => context.id)).toEqual(["invoice-context"]);
|
|
},
|
|
);
|
|
|
|
it("puts the routes under an existing context's root", async () => {
|
|
const created = plan({ id: "invoice-feature", context: "billing-context", write: "NEVER" });
|
|
|
|
expect(created.routes.map((route) => route.path)).toEqual([
|
|
"/billing/invoice",
|
|
"/billing/invoice/items/:invoiceId",
|
|
"/billing/invoice/new",
|
|
]);
|
|
await expect(appFor("billing-context", "billing/*", 20, created.routes)).resolves.toBeDefined();
|
|
});
|
|
});
|
|
|
|
describe("create:feature refusals", () => {
|
|
it.each(["Invoice", "invoice_feature", "-invoice", "invoice--x", "invoice-", "", "a".repeat(41)])(
|
|
"refuses the id %j",
|
|
(id) => {
|
|
expect(() => plan({ id })).toThrow(/kebab-case/u);
|
|
},
|
|
);
|
|
|
|
it.each([
|
|
[{ id: "orders-feature" }, /already a feature or context/u],
|
|
[{ id: "orders-context" }, /already a feature or context/u],
|
|
[{ id: "orders" }, /prefix its ids with "orders", which orders-feature already uses/u],
|
|
[{ id: "billing-feature" }, /pass --context billing-context/u],
|
|
[{ id: "invoice-feature", context: "orders" }, /already owns the route root orders\/\*/u],
|
|
[{ id: "invoice-feature", context: "drafts-feature" }, /is a feature id/u],
|
|
[{ id: "home-feature" }, /message keys already exist: home\.list\.title/u],
|
|
[
|
|
{
|
|
id: "invoice-feature",
|
|
contractPackage: {
|
|
packageId: "@org-contracts/invoice",
|
|
version: "1.4.2",
|
|
digest: "sha256:abc",
|
|
sourceRevision: "0a1b2c3d",
|
|
},
|
|
},
|
|
/not a pinned identity: invoice-feature: package digest/u,
|
|
],
|
|
] as const)("refuses %j", (request, reason) => {
|
|
expect(() => plan(request)).toThrow(reason);
|
|
});
|
|
|
|
it("refuses a route that collides with an installed one", () => {
|
|
expect(() =>
|
|
plan(
|
|
{ id: "invoice-feature" },
|
|
{
|
|
...INSTALLED,
|
|
routes: [
|
|
...INSTALLED.routes,
|
|
{ routeId: "LEGACY", path: "/invoice", chunkId: "route-legacy", navigationOrder: null },
|
|
],
|
|
},
|
|
),
|
|
).toThrow(/collides with installed route LEGACY/u);
|
|
});
|
|
});
|
|
|
|
describe("create:feature writing", () => {
|
|
const roots: string[] = [];
|
|
afterEach(async () => {
|
|
await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
|
|
});
|
|
|
|
async function emptyRoot(): Promise<string> {
|
|
const root = await mkdtemp(path.join(tmpdir(), "create-feature-"));
|
|
roots.push(root);
|
|
return root;
|
|
}
|
|
|
|
it("refuses to overwrite and writes nothing when one target exists", async () => {
|
|
const root = await emptyRoot();
|
|
const files = plan({ id: "invoice-feature" }).files;
|
|
await mkdir(path.join(root, "artifacts/tests/a11y-manual"), { recursive: true });
|
|
await writeFile(path.join(root, "artifacts/tests/a11y-manual/INVOICE_LIST.md"), "kept\n");
|
|
|
|
await expect(writeFeatureFiles(root, files)).rejects.toThrow(
|
|
/refusing to overwrite: artifacts\/tests\/a11y-manual\/INVOICE_LIST\.md/u,
|
|
);
|
|
expect(await readdir(root)).toEqual(["artifacts"]);
|
|
});
|
|
|
|
it("refuses an existing feature directory", async () => {
|
|
const root = await emptyRoot();
|
|
await mkdir(path.join(root, "src/features/invoice-feature"), { recursive: true });
|
|
|
|
await expect(
|
|
writeFeatureFiles(root, plan({ id: "invoice-feature" }).files, [
|
|
"src/features/invoice-feature",
|
|
]),
|
|
).rejects.toThrow(CreateFeatureError);
|
|
});
|
|
|
|
it("removes what it wrote when a later write fails", async () => {
|
|
const root = await emptyRoot();
|
|
const files = new Map([
|
|
["src/features/broken/first.ts", "export {};\n"],
|
|
// A file cannot be a directory, so this write fails after the first.
|
|
["src/features/broken/first.ts/second.ts", "export {};\n"],
|
|
]);
|
|
|
|
await expect(writeFeatureFiles(root, files)).rejects.toThrow();
|
|
await expect(access(path.join(root, "src"))).rejects.toThrow();
|
|
});
|
|
});
|