문제 QueryDefinition의 owner·operationId와 BoundMutation의 owner는 필수 칸이다. bindQuery가 돌려주는 객체에는 둘 다 없고, src 어디서도 읽지 않는다. 기능 작성자는 효과 없는 값을 매번 채우고, 매뉴얼은 그 오타를 "못 잡는 위험"으로 적어 오히려 신경 쓰게 한다(리뷰 16-06 ①②). 고른 방법 세 칸을 @deprecated 선택 칸으로 바꾼다. 참조 기능과 생성 뼈대는 더는 채우지 않는다. 요청 기록의 operation ID는 지금처럼 descriptor에서 온다. 매뉴얼 6·7단계와 patterns.md에 "적지 않는다"와, 라우트 계약 title· navigationLabel을 무엇이 읽는지(FE-REG-ROUTE, lab 측정)를 적었다. 버린 대안 - 칸을 바로 지우기: 객체 리터럴의 초과 속성 검사로 테스트 3파일과 다운스트림 정의가 컴파일 오류가 난다. 선택 칸으로 한 릴리스 두고 지운다. - 쿼리 operationId를 진단 이름표로 잇기: HTTP 실행 기록이 이미 descriptor의 operation ID를 싣는다. 같은 값을 두 번 싣는다. 위험·한계 - 라우트 계약의 title·navigationLabel(16-06 ③)은 그대로 둔다. 지우려면 FE-REG-ROUTE 기준선 행을 catalog에서 만들고, 플랫폼 라우트와 test-performance.ts를 함께 바꿔야 한다. 다른 작업(예제 화면 이동)과 같은 파일이라 이번에는 문서로만 적었다. 검증 - RED: application-query-scope-fence 새 테스트가 tsconfig.test에서 owner· operationId 누락으로 타입 오류. 선택 칸으로 바꾼 뒤 통과. - tests/features/reference-feature, tests/unit/create-feature.test.ts, scope-fence 129건 통과. check:types(app·node·test), lint 통과. Refs: docs/reviews/2026-11-03-maturity-review/16-structure-patterns.md 16-06
141 lines
4.4 KiB
TypeScript
141 lines
4.4 KiB
TypeScript
import { useApplicationFeature } from "../../../presentation/providers/application-provider.tsx";
|
|
import {
|
|
useApplicationMutation,
|
|
useApplicationQuery,
|
|
} from "../../../presentation/adapters/query/application-query.ts";
|
|
import {
|
|
REFERENCE_FEATURE_ID,
|
|
REFERENCE_RESOURCE_INVALIDATION_TOPIC,
|
|
REFERENCE_RESOURCE_QUERY_NAMESPACE,
|
|
} from "../contracts/reference-feature-contract.ts";
|
|
import type {
|
|
ReferenceCreateCommand,
|
|
ReferenceFeatureInput,
|
|
ReferenceListFilters,
|
|
} from "../application/reference-feature-api.ts";
|
|
import type { ReferenceResourceView } from "../contracts/reference-mapper.ts";
|
|
import { CREATE_REFERENCE_RESOURCE_CONTRACT } from "../contracts/reference-feature-contract-contribution.ts";
|
|
import {
|
|
bindQuery,
|
|
commandMutationIdentity,
|
|
type BoundMutation,
|
|
type QueryResultMeasure,
|
|
} from "../../../contracts/server-state.ts";
|
|
import { useServerStateScope } from "../../../presentation/adapters/query/server-state-scope-provider.tsx";
|
|
import { useReferenceListFilters } from "./reference-routes.ts";
|
|
|
|
const UTF8 = new TextEncoder();
|
|
|
|
/**
|
|
* §10.4. Feature-owned measurement over the mapped application value. There is
|
|
* no generic fallback: bounded string bytes plus fixed primitive width plus a
|
|
* small per-item overhead, never `JSON.stringify` or a recursive walker.
|
|
*/
|
|
function measureResourceView(view: ReferenceResourceView): QueryResultMeasure {
|
|
return {
|
|
itemCount: 1,
|
|
estimatedBytes:
|
|
UTF8.encode(view.resourceId).byteLength +
|
|
UTF8.encode(view.title).byteLength +
|
|
UTF8.encode(view.createdAt ?? "").byteLength +
|
|
32,
|
|
};
|
|
}
|
|
|
|
function measureResourceList(
|
|
views: readonly ReferenceResourceView[],
|
|
): QueryResultMeasure {
|
|
let estimatedBytes = 16;
|
|
for (const view of views) {
|
|
estimatedBytes += measureResourceView(view).estimatedBytes;
|
|
}
|
|
return { itemCount: views.length, estimatedBytes };
|
|
}
|
|
|
|
const REFERENCE_CREATE_MUTATION_POLICY = Object.freeze({
|
|
definitionId: "reference-resource-create-v1",
|
|
definitionVersion: 1,
|
|
// 1103/16-05. The operation id and the key requirement are the
|
|
// descriptor's, so a misspelt id cannot pass the type check.
|
|
...commandMutationIdentity(CREATE_REFERENCE_RESOURCE_CONTRACT),
|
|
duplicatePolicy: "REJECT_WHILE_ACTIVE" as const,
|
|
invalidate: Object.freeze([REFERENCE_RESOURCE_INVALIDATION_TOPIC]),
|
|
});
|
|
|
|
type ReferenceCreateMutationBinding = Pick<
|
|
BoundMutation<ReferenceCreateCommand, ReferenceResourceView>,
|
|
"scope" | "execute"
|
|
>;
|
|
|
|
function bindReferenceCreateMutation(
|
|
binding: ReferenceCreateMutationBinding,
|
|
): BoundMutation<ReferenceCreateCommand, ReferenceResourceView> {
|
|
return Object.freeze({
|
|
...REFERENCE_CREATE_MUTATION_POLICY,
|
|
...binding,
|
|
});
|
|
}
|
|
|
|
export function useReferenceFeatureInput(): ReferenceFeatureInput {
|
|
return useApplicationFeature(REFERENCE_FEATURE_ID);
|
|
}
|
|
|
|
export function useReferenceDetail(resourceId: string) {
|
|
const input = useReferenceFeatureInput();
|
|
const scope = useServerStateScope();
|
|
const query = useApplicationQuery(
|
|
bindQuery(
|
|
{
|
|
definitionId: "reference-resource-detail-v1",
|
|
definitionVersion: 1,
|
|
namespace: REFERENCE_RESOURCE_QUERY_NAMESPACE,
|
|
profileId: "DETAIL_STANDARD",
|
|
measureResult: measureResourceView,
|
|
execute: (selectedResourceId: string, { signal }) =>
|
|
input.getResource(selectedResourceId, { signal }),
|
|
},
|
|
resourceId,
|
|
scope,
|
|
),
|
|
);
|
|
return Object.freeze({ query });
|
|
}
|
|
|
|
export function useReferenceCreate() {
|
|
const input = useReferenceFeatureInput();
|
|
const scope = useServerStateScope();
|
|
const mutation = bindReferenceCreateMutation({
|
|
scope,
|
|
execute: input.createResource,
|
|
});
|
|
return useApplicationMutation(mutation);
|
|
}
|
|
|
|
export function useReferenceFeature() {
|
|
const input = useReferenceFeatureInput();
|
|
const scope = useServerStateScope();
|
|
const filters = useReferenceListFilters();
|
|
const query = useApplicationQuery(
|
|
bindQuery(
|
|
{
|
|
definitionId: "reference-resource-list-v1",
|
|
definitionVersion: 1,
|
|
namespace: REFERENCE_RESOURCE_QUERY_NAMESPACE,
|
|
profileId: "LIST_STANDARD",
|
|
measureResult: measureResourceList,
|
|
execute: (selectedFilters: ReferenceListFilters, { signal }) =>
|
|
input.listResources(selectedFilters, { signal }),
|
|
},
|
|
filters,
|
|
scope,
|
|
),
|
|
);
|
|
const mutation = useApplicationMutation(
|
|
bindReferenceCreateMutation({
|
|
scope,
|
|
execute: input.createResource,
|
|
}),
|
|
);
|
|
return Object.freeze({ filters, query, mutation });
|
|
}
|