문제: 1103/16-05 수정으로 commandMutationIdentity가 생겼지만 BoundMutation.operationId는 여전히 string이다. 정책에 operation ID를 문자열로 직접 적으면 오타가 check:types와 check:registries를 통과하고, 저장할 때마다 실행기가 보내기 전에 MISSING_IDEMPOTENCY_KEY 위반으로 거부한다. 매뉴얼 01은 이것을 "못 잡음"으로 적고 있었다. 고른 방법: BoundMutation.operationId를 brand 타입 MutationOperationId로 바꾼다. 이 값을 돌려주는 것은 commandMutationIdentity뿐이라, 문자열을 직접 적으면 check:types가 실패한다. 런타임 값은 descriptor의 문자열 그대로이고 실행기·intent factory는 바뀌지 않는다. 참조 기능과 쓰기 slice 생성기는 이미 commandMutationIdentity를 spread하므로 고칠 것이 없다. 템플릿 테스트의 손글씨 ID 20곳은 tests/helpers/mutation-operation-id.ts (commandMutationIdentity를 거치는 test helper)나 그 파일의 descriptor로 바꿨다. 매뉴얼 01·patterns 표·state 설계 예시를 맞췄다. 버린 대안: (1) 위반 이름을 INTENT_OPERATION_MISMATCH로 나누는 것. 실행 때만 드러나는 것은 같고, 공개 위반 어휘에 값이 하나 늘어 다운스트림 분기가 바뀐다. (2) 설치된 operation ID의 union 타입. 기능마다 늦게 적재되는 계약 전체를 타입으로 모을 곳이 없다. 위험·한계: 공개 타입(src/contracts/server-state.ts)이 좁아진다. 정책에 operation ID를 문자열로 적은 다운스트림 코드는 동기화 뒤 check:types가 실패한다. commandMutationIdentity에 descriptor 상수 대신 손으로 만든 객체를 넘기면 여전히 오타가 통과한다(매뉴얼 "못 잡음"). HTTP가 아닌 뮤테이션은 descriptor 모양 객체를 넘겨야 한다. 이 repo에는 그런 소비자가 없다. 검증: desktop batch에서 확인. corepack pnpm check:types:test tests/unit/command-mutation-identity.test.ts의 @ts-expect-error가 부모 커밋에서는 쓰이지 않아(TS2578) 실패하고 이 커밋에서 통과한다. node scripts/run-vitest.ts run tests/unit/command-mutation-identity.test.ts tests/component/application-mutation-admission.test.tsx tests/component/application-mutation-scope-fence.test.tsx tests/component/application-query.test.tsx tests/component/form-foundation.test.tsx BREAKING CHANGE: BoundMutation.operationId는 string이 아니라 MutationOperationId다. 뮤테이션 정책의 `operationId: "<ID>"`와 `requiresIdempotencyKey`를 `...commandMutationIdentity(<OPERATION>_CONTRACT)` 로 바꾼다(src/contracts/server-state.ts). commandMutationIdentity의 반환 타입도 operationId가 MutationOperationId다. Refs: 1103/16-05
615 lines
22 KiB
TypeScript
615 lines
22 KiB
TypeScript
// @vitest-environment jsdom
|
|
|
|
import { act, renderHook, waitFor } from "@testing-library/react";
|
|
import { describe, expect, it, vi } from "vitest";
|
|
|
|
import {
|
|
type ApplicationResult,
|
|
useApplicationMutation,
|
|
} from "../../src/presentation/adapters/query/application-query.ts";
|
|
import type { MutationIntentFactory } from "../../src/application/ports/mutation-intent-factory.ts";
|
|
import { createFailure } from "../../src/contracts/errors.ts";
|
|
import type { MutationIntent } from "../../src/contracts/mutation-intent.ts";
|
|
import { createRuntimeIdentityRegistry } from "../../src/contracts/query-keys.ts";
|
|
import { MUTATION_COORDINATOR_BOUNDS } from "../../src/contracts/server-state.ts";
|
|
import {
|
|
RESOURCE_INVALIDATION_TOPIC,
|
|
deterministicMutationIntentFactory,
|
|
queryClient,
|
|
scopeSnapshot,
|
|
wrapper,
|
|
} from "./application-query-fixture.tsx";
|
|
import { useLegacyApplicationMutation } from "../helpers/legacy-application-query-harness.ts";
|
|
import { testMutationOperationId } from "../helpers/mutation-operation-id.ts";
|
|
|
|
describe("application mutation intent admission", () => {
|
|
it("retains optimistic data when execute throws after dispatch begins", async () => {
|
|
const client = queryClient();
|
|
const key = ["resource", "thrown-unknown-effect"];
|
|
client.setQueryData(key, ["base"]);
|
|
const hook = renderHook(
|
|
() =>
|
|
useLegacyApplicationMutation<string, string>({
|
|
execute: async () => {
|
|
throw new Error("private transport defect");
|
|
},
|
|
currentData: client.getQueryData(key),
|
|
optimistic: {
|
|
queryKey: key,
|
|
update: (previous, input) => [
|
|
...(previous as string[]),
|
|
input,
|
|
],
|
|
},
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
let outcome: ApplicationResult<string> | undefined;
|
|
await act(async () => {
|
|
outcome = await hook.result.current.submit("created");
|
|
});
|
|
|
|
expect(outcome).toMatchObject({
|
|
ok: false,
|
|
error: {
|
|
effect: "MAYBE_APPLIED",
|
|
retryable: false,
|
|
action: "contact-support",
|
|
},
|
|
});
|
|
expect(JSON.stringify(outcome)).not.toContain("private transport defect");
|
|
expect(client.getQueryData(key)).toEqual(["base", "created"]);
|
|
expect(hook.result.current.state.indicator).toBe(
|
|
"mutation-effect-unknown",
|
|
);
|
|
});
|
|
|
|
it("creates a distinct logical intent for each independently admitted submit", async () => {
|
|
const client = queryClient();
|
|
const scope = scopeSnapshot();
|
|
const observedIntents: unknown[] = [];
|
|
const execute = vi.fn(
|
|
async (
|
|
input: string,
|
|
context: Readonly<{ signal: AbortSignal; intent?: unknown }>,
|
|
) => {
|
|
observedIntents.push(context.intent);
|
|
return { ok: true as const, value: input };
|
|
},
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useApplicationMutation<string, string>({
|
|
definitionId: "independent-intent-v1",
|
|
definitionVersion: 1,
|
|
operationId: testMutationOperationId("CREATE_WITH_INTENT"),
|
|
requiresIdempotencyKey: true,
|
|
owner: "platform-test",
|
|
duplicatePolicy: "ALLOW_PARALLEL",
|
|
scope,
|
|
execute,
|
|
invalidate: [],
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
await act(async () => {
|
|
await hook.result.current.submit("same-input");
|
|
await hook.result.current.submit("same-input");
|
|
});
|
|
|
|
expect(observedIntents).toHaveLength(2);
|
|
expect(observedIntents[0]).toMatchObject({
|
|
intentId: "intent-1",
|
|
operationId: "CREATE_WITH_INTENT",
|
|
idempotencyKey: "key-1",
|
|
});
|
|
expect(observedIntents[1]).toMatchObject({
|
|
intentId: "intent-2",
|
|
operationId: "CREATE_WITH_INTENT",
|
|
idempotencyKey: "key-2",
|
|
});
|
|
expect(observedIntents[0]).not.toEqual(observedIntents[1]);
|
|
});
|
|
|
|
it("creates no second intent when JOIN_IDENTICAL shares an admitted submit", async () => {
|
|
const client = queryClient();
|
|
const scope = scopeSnapshot();
|
|
const deterministicFactory = deterministicMutationIntentFactory();
|
|
const createIntent = vi.fn(deterministicFactory.create);
|
|
const factory: MutationIntentFactory = Object.freeze({
|
|
create: createIntent,
|
|
});
|
|
let complete: (value: ApplicationResult<string>) => void = () => {};
|
|
const execute = vi.fn(
|
|
() =>
|
|
new Promise<ApplicationResult<string>>((resolve) => {
|
|
complete = resolve;
|
|
}),
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useApplicationMutation<string, string>({
|
|
definitionId: "joined-intent-v1",
|
|
definitionVersion: 1,
|
|
operationId: testMutationOperationId("CREATE_JOINED"),
|
|
requiresIdempotencyKey: true,
|
|
owner: "platform-test",
|
|
duplicatePolicy: "JOIN_IDENTICAL",
|
|
scope,
|
|
execute,
|
|
invalidate: [],
|
|
}),
|
|
{ wrapper: wrapper(client, factory) },
|
|
);
|
|
|
|
let first: Promise<ApplicationResult<string>> | null = null;
|
|
let joined: Promise<ApplicationResult<string>> | null = null;
|
|
act(() => {
|
|
first = hook.result.current.submit("same-input");
|
|
joined = hook.result.current.submit("same-input");
|
|
});
|
|
|
|
expect(first).toBe(joined);
|
|
await waitFor(() => expect(execute).toHaveBeenCalledOnce());
|
|
expect(createIntent).toHaveBeenCalledOnce();
|
|
expect(createIntent).toHaveBeenCalledWith({
|
|
operationId: "CREATE_JOINED",
|
|
canonicalInputIdentity:
|
|
"scope-fingerprint-0001:joined-intent-v1:scope-identity-token-0001",
|
|
requiresIdempotencyKey: true,
|
|
});
|
|
|
|
complete({ ok: true, value: "same-input" });
|
|
if (!first) throw new Error("expected admitted mutation");
|
|
await act(() => first);
|
|
});
|
|
|
|
it("bounds JOIN_IDENTICAL waiters without starting another mutation", async () => {
|
|
const client = queryClient();
|
|
const scope = scopeSnapshot();
|
|
let complete: (value: ApplicationResult<string>) => void = () => {};
|
|
const execute = vi.fn(
|
|
() =>
|
|
new Promise<ApplicationResult<string>>((resolve) => {
|
|
complete = resolve;
|
|
}),
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useApplicationMutation<string, string>({
|
|
definitionId: "joined-waiter-budget-v1",
|
|
definitionVersion: 1,
|
|
operationId: testMutationOperationId("CREATE_JOINED_BOUNDED"),
|
|
requiresIdempotencyKey: true,
|
|
owner: "platform-test",
|
|
duplicatePolicy: "JOIN_IDENTICAL",
|
|
scope,
|
|
execute,
|
|
invalidate: [],
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
let admitted: Promise<ApplicationResult<string>> | null = null;
|
|
let joined: readonly Promise<ApplicationResult<string>>[] = [];
|
|
let overflow: Promise<ApplicationResult<string>> | null = null;
|
|
act(() => {
|
|
admitted = hook.result.current.submit("same-input");
|
|
joined = Array.from(
|
|
{ length: MUTATION_COORDINATOR_BOUNDS.waitersPerJoinedIntent },
|
|
() => hook.result.current.submit("same-input"),
|
|
);
|
|
overflow = hook.result.current.submit("same-input");
|
|
});
|
|
|
|
expect(joined.every((waiter) => waiter === admitted)).toBe(true);
|
|
expect(overflow).not.toBe(admitted);
|
|
if (!overflow) throw new Error("expected overflow result");
|
|
await expect(overflow).resolves.toMatchObject({
|
|
ok: false,
|
|
error: {
|
|
kind: "DUPLICATE_IN_FLIGHT",
|
|
code: "JOIN_WAITER_LIMIT_EXCEEDED",
|
|
effect: "NOT_STARTED",
|
|
},
|
|
});
|
|
await waitFor(() => expect(execute).toHaveBeenCalledOnce());
|
|
|
|
complete({ ok: true, value: "same-input" });
|
|
if (!admitted) throw new Error("expected admitted mutation");
|
|
await act(() => admitted);
|
|
});
|
|
|
|
it("keeps the legacy raw mutation path outside the intent factory", async () => {
|
|
const client = queryClient();
|
|
const createIntent = vi.fn<MutationIntentFactory["create"]>();
|
|
const factory: MutationIntentFactory = Object.freeze({
|
|
create: createIntent,
|
|
});
|
|
const execute = vi.fn(async (input: string) => ({
|
|
ok: true as const,
|
|
value: input,
|
|
}));
|
|
const hook = renderHook(
|
|
() =>
|
|
useLegacyApplicationMutation<string, string>({
|
|
definitionId: "legacy-raw-path-v1",
|
|
execute,
|
|
}),
|
|
{ wrapper: wrapper(client, factory) },
|
|
);
|
|
|
|
await act(() => hook.result.current.submit("legacy-input"));
|
|
|
|
expect(execute).toHaveBeenCalledOnce();
|
|
expect(createIntent).not.toHaveBeenCalled();
|
|
});
|
|
|
|
// 1101/08-03. Type fixture, checked by `tsc -p tsconfig.test.json`: if the
|
|
// product hook takes a raw executor again, the directive below is unused
|
|
// (TS2578) and the type check fails. Only the harness reaches that path.
|
|
it("rejects a raw executor on the product hook at compile time", () => {
|
|
const raw = {
|
|
definitionId: "raw-product-call-v1",
|
|
execute: async (input: string) => ({ ok: true as const, value: input }),
|
|
};
|
|
const useRawProductMutation = () =>
|
|
useApplicationMutation<string, string>(
|
|
// @ts-expect-error a raw executor is not a BoundMutation.
|
|
raw,
|
|
);
|
|
|
|
expect(useRawProductMutation).toBeTypeOf("function");
|
|
});
|
|
|
|
it("rejects a duplicate submit by default while one is active", async () => {
|
|
const client = queryClient();
|
|
let complete: (value: ApplicationResult<string>) => void = () => {};
|
|
const execute = vi.fn(
|
|
() =>
|
|
new Promise<ApplicationResult<string>>((resolve) => {
|
|
complete = resolve;
|
|
}),
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useLegacyApplicationMutation<string, string>({
|
|
definitionId: "legacy-duplicate-rejection-v1",
|
|
execute,
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
let first: Promise<ApplicationResult<string>> | null = null;
|
|
let duplicate: Promise<ApplicationResult<string>> | null = null;
|
|
act(() => {
|
|
first = hook.result.current.submit("created");
|
|
duplicate = hook.result.current.submit("created");
|
|
});
|
|
|
|
if (!first || !duplicate) throw new Error("expected two submissions");
|
|
await expect(duplicate).resolves.toMatchObject({
|
|
ok: false,
|
|
error: { kind: "DUPLICATE_IN_FLIGHT" },
|
|
});
|
|
expect(execute).toHaveBeenCalledOnce();
|
|
|
|
complete({ ok: true, value: "created" });
|
|
await act(() => first as Promise<ApplicationResult<string>>);
|
|
});
|
|
|
|
it("deduplicates submit and commits one optimistic mutation", async () => {
|
|
const client = queryClient();
|
|
const key = ["resource", "list"];
|
|
client.setQueryData(key, ["existing"]);
|
|
let complete: (value: ApplicationResult<string>) => void = () => {};
|
|
const execute = vi.fn(
|
|
() =>
|
|
new Promise<ApplicationResult<string>>((resolve) => {
|
|
complete = resolve;
|
|
}),
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useLegacyApplicationMutation<string, string>({
|
|
// §11.2: joining is opt-in. The default is REJECT_WHILE_ACTIVE.
|
|
duplicatePolicy: "JOIN_IDENTICAL",
|
|
execute,
|
|
invalidate: [RESOURCE_INVALIDATION_TOPIC],
|
|
currentData: client.getQueryData(key),
|
|
optimistic: {
|
|
queryKey: key,
|
|
update: (previous, input) => [
|
|
...(previous as string[]),
|
|
input,
|
|
],
|
|
},
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
let first: Promise<ApplicationResult<string>> | null = null;
|
|
let duplicate: Promise<ApplicationResult<string>> | null = null;
|
|
act(() => {
|
|
first = hook.result.current.submit("created");
|
|
duplicate = hook.result.current.submit("created");
|
|
});
|
|
expect(first).toBe(duplicate);
|
|
await waitFor(() =>
|
|
expect(client.getQueryData(key)).toEqual(["existing", "created"]),
|
|
);
|
|
await waitFor(() => expect(execute).toHaveBeenCalledOnce());
|
|
await waitFor(() =>
|
|
expect(hook.result.current.state.indicator).toBe("mutation-pending"),
|
|
);
|
|
|
|
complete({ ok: true, value: "created" });
|
|
if (!first) throw new Error("expected pending mutation");
|
|
await act(() => first);
|
|
expect(client.getQueryState(key)?.isInvalidated).toBe(true);
|
|
await waitFor(() =>
|
|
expect(hook.result.current.state.indicator).toBeNull(),
|
|
);
|
|
});
|
|
|
|
it("never joins distinct mutation inputs to the same runtime promise", async () => {
|
|
const client = queryClient();
|
|
const resolvers = new Map<
|
|
string,
|
|
(value: ApplicationResult<string>) => void
|
|
>();
|
|
const execute = vi.fn(
|
|
(input: string) =>
|
|
new Promise<ApplicationResult<string>>((resolve) => {
|
|
resolvers.set(input, resolve);
|
|
}),
|
|
);
|
|
const hook = renderHook(
|
|
() =>
|
|
useLegacyApplicationMutation<string, string>({
|
|
definitionId: "legacy-parallel-distinct-inputs-v1",
|
|
execute,
|
|
currentData: true,
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
|
|
let first: Promise<ApplicationResult<string>> | undefined;
|
|
let second: Promise<ApplicationResult<string>> | undefined;
|
|
act(() => {
|
|
first = hook.result.current.submit("first");
|
|
second = hook.result.current.submit("second");
|
|
});
|
|
expect(first).not.toBe(second);
|
|
await waitFor(() => expect(execute).toHaveBeenCalledTimes(2));
|
|
|
|
resolvers.get("first")?.({ ok: true, value: "first" });
|
|
resolvers.get("second")?.({ ok: true, value: "second" });
|
|
if (!first || !second) throw new Error("expected pending mutations");
|
|
await act(async () => {
|
|
await Promise.all([first, second]);
|
|
});
|
|
});
|
|
|
|
describe("unknown-effect replay (D-1)", () => {
|
|
function replayScope(maxEntries?: number) {
|
|
let token = 0;
|
|
return {
|
|
...scopeSnapshot(),
|
|
identities: createRuntimeIdentityRegistry({
|
|
...(maxEntries === undefined ? {} : { maxEntries }),
|
|
tokenFactory: () => `replay-identity-token-${String(++token).padStart(4, "0")}`,
|
|
}),
|
|
};
|
|
}
|
|
|
|
function renderKeyedCreate(
|
|
outcomes: ApplicationResult<string>[],
|
|
options: Readonly<{ maxIdentities?: number; keyed?: boolean }> = {},
|
|
) {
|
|
const client = queryClient();
|
|
const intents: MutationIntent[] = [];
|
|
const sentAt: number[] = [];
|
|
const execute = vi.fn(
|
|
async (
|
|
input: string,
|
|
context: Readonly<{ signal: AbortSignal; intent: MutationIntent }>,
|
|
): Promise<ApplicationResult<string>> => {
|
|
intents.push(context.intent);
|
|
sentAt.push(performance.now());
|
|
return outcomes.shift() ?? { ok: true, value: input };
|
|
},
|
|
);
|
|
const scope = replayScope(options.maxIdentities);
|
|
const hook = renderHook(
|
|
() =>
|
|
useApplicationMutation<string, string>({
|
|
definitionId: "replay-intent-v1",
|
|
definitionVersion: 1,
|
|
operationId: testMutationOperationId("CREATE_REPLAYED"),
|
|
requiresIdempotencyKey: options.keyed ?? true,
|
|
owner: "platform-test",
|
|
duplicatePolicy: "REJECT_WHILE_ACTIVE",
|
|
scope,
|
|
execute,
|
|
invalidate: [],
|
|
}),
|
|
{ wrapper: wrapper(client) },
|
|
);
|
|
return { hook, intents, execute, sentAt };
|
|
}
|
|
|
|
const unknown: ApplicationResult<string> = {
|
|
ok: false,
|
|
error: createFailure("SERVER_FAILURE", "CREATE_REPLAYED", 0, {
|
|
effect: "MAYBE_APPLIED",
|
|
}),
|
|
};
|
|
|
|
it("sends the same intent when the same input is saved again after an unknown effect", async () => {
|
|
const { hook, intents } = renderKeyedCreate([unknown]);
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
expect(hook.result.current.state.indicator).toBe(
|
|
"mutation-effect-unknown",
|
|
);
|
|
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
|
|
expect(intents).toHaveLength(2);
|
|
expect(intents[1]).toBe(intents[0]);
|
|
expect(intents[1]?.idempotencyKey).toBe("key-1");
|
|
await waitFor(() =>
|
|
expect(hook.result.current.state.indicator).toBeNull(),
|
|
);
|
|
});
|
|
|
|
it("mints a new key when the input changes after an unknown effect", async () => {
|
|
const { hook, intents } = renderKeyedCreate([unknown]);
|
|
await act(() => hook.result.current.submit("first-input"));
|
|
await act(() => hook.result.current.submit("changed-input"));
|
|
|
|
expect(intents.map((intent) => intent.idempotencyKey)).toEqual([
|
|
"key-1",
|
|
"key-2",
|
|
]);
|
|
// The first request is still unresolved; a different request cannot
|
|
// settle it.
|
|
expect(hook.result.current.state.indicator).toBe(
|
|
"mutation-effect-unknown",
|
|
);
|
|
});
|
|
|
|
// 0929/03-06. The unknown request leases its input identity, so a full
|
|
// identity registry evicts other inputs first and the same input saved
|
|
// later still finds the unknown request and its key.
|
|
it("keeps the unknown input's identity when the identity registry is full", async () => {
|
|
const { hook, intents } = renderKeyedCreate([unknown], { maxIdentities: 2 });
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
// A two-entry registry: the third input evicts the oldest unleased one.
|
|
await act(() => hook.result.current.submit("second-input"));
|
|
await act(() => hook.result.current.submit("third-input"));
|
|
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
|
|
expect(intents.map((intent) => intent.idempotencyKey)).toEqual([
|
|
"key-1",
|
|
"key-2",
|
|
"key-3",
|
|
"key-1",
|
|
]);
|
|
});
|
|
|
|
it("resends the unknown head request with its original key", async () => {
|
|
const { hook, intents, execute } = renderKeyedCreate([unknown, unknown]);
|
|
await act(() => hook.result.current.submit("resent-input"));
|
|
|
|
let resent: ApplicationResult<string> | null | undefined;
|
|
await act(async () => {
|
|
resent = await hook.result.current.resendUnknownEffect();
|
|
});
|
|
expect(resent).toMatchObject({
|
|
ok: false,
|
|
error: { effect: "MAYBE_APPLIED" },
|
|
});
|
|
await act(async () => {
|
|
resent = await hook.result.current.resendUnknownEffect();
|
|
});
|
|
|
|
expect(resent).toEqual({ ok: true, value: "resent-input" });
|
|
expect(execute.mock.calls.map(([input]) => input)).toEqual([
|
|
"resent-input",
|
|
"resent-input",
|
|
"resent-input",
|
|
]);
|
|
expect(new Set(intents.map((intent) => intent.idempotencyKey))).toEqual(
|
|
new Set(["key-1"]),
|
|
);
|
|
await waitFor(() =>
|
|
expect(hook.result.current.state.indicator).toBeNull(),
|
|
);
|
|
// Nothing is left to resend once the effect is settled.
|
|
await act(async () => {
|
|
resent = await hook.result.current.resendUnknownEffect();
|
|
});
|
|
expect(resent).toBeNull();
|
|
expect(execute).toHaveBeenCalledTimes(3);
|
|
});
|
|
|
|
// 0929/03-03. A command without a key has nothing the server can match a
|
|
// second request to: resending it after a lost answer can apply it twice.
|
|
it("offers no resend for an unknown request that carries no key", async () => {
|
|
const { hook, execute } = renderKeyedCreate([unknown], { keyed: false });
|
|
await act(() => hook.result.current.submit("keyless-input"));
|
|
expect(hook.result.current.state.indicator).toBe("mutation-effect-unknown");
|
|
|
|
expect(hook.result.current.canResendUnknownEffect).toBe(false);
|
|
expect(hook.result.current.state.unknownEffectResendable).toBe(false);
|
|
let resent: ApplicationResult<string> | null | undefined;
|
|
await act(async () => {
|
|
resent = await hook.result.current.resendUnknownEffect();
|
|
});
|
|
|
|
expect(resent).toBeNull();
|
|
expect(execute).toHaveBeenCalledOnce();
|
|
expect(hook.result.current.state.indicator).toBe("mutation-effect-unknown");
|
|
});
|
|
|
|
it("offers the same-key resend for an unknown keyed request", async () => {
|
|
const { hook } = renderKeyedCreate([unknown]);
|
|
expect(hook.result.current.canResendUnknownEffect).toBe(false);
|
|
await act(() => hook.result.current.submit("keyed-input"));
|
|
|
|
expect(hook.result.current.canResendUnknownEffect).toBe(true);
|
|
expect(hook.result.current.state.unknownEffectResendable).toBe(true);
|
|
});
|
|
|
|
// 백엔드 1101/02-01. The paired backend answers a same-key request while
|
|
// the first still runs with 409 IDEMPOTENT_IN_FLIGHT and Retry-After.
|
|
it("holds a resend until the Retry-After of the unknown answer", async () => {
|
|
const inFlight: ApplicationResult<string> = {
|
|
ok: false,
|
|
error: createFailure("CONFLICT", "CREATE_REPLAYED", 0, {
|
|
code: "IDEMPOTENT_IN_FLIGHT",
|
|
effect: "MAYBE_APPLIED",
|
|
retryAfterMs: 300,
|
|
}),
|
|
};
|
|
const { hook, intents, sentAt } = renderKeyedCreate([inFlight]);
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
|
|
await act(async () => {
|
|
await hook.result.current.resendUnknownEffect();
|
|
});
|
|
|
|
expect(intents[1]).toBe(intents[0]);
|
|
expect((sentAt[1] ?? 0) - (sentAt[0] ?? 0)).toBeGreaterThanOrEqual(290);
|
|
});
|
|
|
|
it("waits at most the resend ceiling for a long Retry-After", async () => {
|
|
const inFlight: ApplicationResult<string> = {
|
|
ok: false,
|
|
error: createFailure("CONFLICT", "CREATE_REPLAYED", 0, {
|
|
code: "IDEMPOTENT_IN_FLIGHT",
|
|
effect: "MAYBE_APPLIED",
|
|
retryAfterMs: 3_600_000,
|
|
}),
|
|
};
|
|
const { hook, sentAt } = renderKeyedCreate([inFlight]);
|
|
await act(() => hook.result.current.submit("same-input"));
|
|
vi.useFakeTimers({ toFake: ["setTimeout"] });
|
|
try {
|
|
await act(async () => {
|
|
const resent = hook.result.current.resendUnknownEffect();
|
|
await vi.advanceTimersByTimeAsync(5_000);
|
|
await resent;
|
|
});
|
|
expect(sentAt).toHaveLength(2);
|
|
} finally {
|
|
vi.useRealTimers();
|
|
}
|
|
});
|
|
});
|
|
});
|