refactor: 프론트엔드 리펙토링

src/features/reference-feature/adapters/create-reference-feature-input.ts

@@ -2,6 +2,9 @@ import {
   createFeatureHttpBinding,
   type InstalledHttpOperationExecutor,
 } from "../../../adapters/http/index.ts";
+import {
+  defineFeatureAdapterContribution,
+} from "../../feature-adapter-contribution.ts";
 import { createReferenceFeatureInput } from "../application/reference-feature-api.ts";
 import {
   REFERENCE_FEATURE_ID,
@@ -17,15 +20,14 @@ export type InstalledContractOperationExecutor =
 /**
  * Feature-owned composition seam.
  *
- * The feature contributes typed operation descriptors and its application
- * gateway. HTTP lifecycle/error normalization stays in the reusable capability
- * binding rather than being repeated by every product feature.
+ * The feature receives only the HTTP capability it declares in `needs`.
+ * HTTP lifecycle/error normalization stays in the reusable capability binding.
  */
 export function createReferenceFeatureInstalledInput(context: Readonly<{
-  contractOperations: InstalledHttpOperationExecutor;
+  http: InstalledHttpOperationExecutor;
 }>) {
   const http = createFeatureHttpBinding(
-    context.contractOperations,
+    context.http,
     REFERENCE_HTTP_OPERATIONS,
   );
 
@@ -35,7 +37,9 @@ export function createReferenceFeatureInstalledInput(context: Readonly<{
   });
 }
 
-export const REFERENCE_FEATURE_ADAPTER_CONTRIBUTION = Object.freeze({
-  featureId: REFERENCE_FEATURE_ID,
-  createInput: createReferenceFeatureInstalledInput,
-});
+export const REFERENCE_FEATURE_ADAPTER_CONTRIBUTION =
+  defineFeatureAdapterContribution({
+    featureId: REFERENCE_FEATURE_ID,
+    needs: ["http"] as const,
+    createInput: createReferenceFeatureInstalledInput,
+  });

src/features/reference-feature/adapters/reference-http-gateway.ts

@@ -1,40 +1,57 @@
 import {
-  defineFeatureHttpOperation,
+  defineFeatureHttpOperationForRoutes,
   type FeatureHttpBinding,
 } from "../../../adapters/http/index.ts";
-import type {
-  ReferenceCreateCommand,
-  ReferenceGateway,
-  ReferenceListFilters,
-} from "../application/reference-feature-api.ts";
-import type { ReferenceResource } from "../domain/reference-resource.ts";
+import {
+  CREATE_REFERENCE_RESOURCE_CONTRACT,
+  GET_REFERENCE_RESOURCE_CONTRACT,
+  LIST_REFERENCE_RESOURCES_CONTRACT,
+} from "../contracts/reference-feature-contract-contribution.ts";
+import {
+  REFERENCE_FEATURE_CONTRACT,
+} from "../contracts/reference-feature-contract.ts";
 import {
   mapReferenceResourceListPayload,
   mapReferenceResourcePayload,
 } from "../contracts/reference-mapper.ts";
+import type {
+  ReferenceGateway,
+} from "../application/reference-feature-api.ts";
+
+export type ReferenceFeatureRouteId =
+  keyof typeof REFERENCE_FEATURE_CONTRACT.routes;
+
+const defineReferenceHttpOperation =
+  defineFeatureHttpOperationForRoutes<ReferenceFeatureRouteId>();
 
 export const REFERENCE_HTTP_OPERATIONS = Object.freeze({
-  LIST_REFERENCE_RESOURCES: defineFeatureHttpOperation<
-    ReferenceListFilters,
-    readonly ReferenceResource[]
-  >({
-    operationId: "LIST_REFERENCE_RESOURCES",
+  LIST_REFERENCE_RESOURCES: defineReferenceHttpOperation({
+    contract: LIST_REFERENCE_RESOURCES_CONTRACT,
     routeId: "REFERENCE_RESOURCE_LIST",
     mapSuccess: mapReferenceResourceListPayload,
   }),
-  CREATE_REFERENCE_RESOURCE: defineFeatureHttpOperation<
-    ReferenceCreateCommand,
-    ReferenceResource
-  >({
-    operationId: "CREATE_REFERENCE_RESOURCE",
+  CREATE_REFERENCE_RESOURCE: defineReferenceHttpOperation({
+    contract: CREATE_REFERENCE_RESOURCE_CONTRACT,
     routeId: "REFERENCE_RESOURCE_LIST",
     mapSuccess: mapReferenceResourcePayload,
+    mapProblem(problem, metadata) {
+      if (metadata.status === 409) {
+        return Object.freeze({
+          kind: "CONFLICT" as const,
+          code: problem.code ?? "REFERENCE_RESOURCE_CONFLICT",
+        });
+      }
+      if (metadata.status === 422) {
+        return Object.freeze({
+          kind: "VALIDATION_REJECTED" as const,
+          code: problem.code ?? "REFERENCE_RESOURCE_REJECTED",
+        });
+      }
+      return undefined;
+    },
   }),
-  GET_REFERENCE_RESOURCE: defineFeatureHttpOperation<
-    Readonly<{ resourceId: string }>,
-    ReferenceResource
-  >({
-    operationId: "GET_REFERENCE_RESOURCE",
+  GET_REFERENCE_RESOURCE: defineReferenceHttpOperation({
+    contract: GET_REFERENCE_RESOURCE_CONTRACT,
     routeId: "REFERENCE_RESOURCE_DETAIL",
     mapSuccess: mapReferenceResourcePayload,
   }),