refactor: 프론트 템플릿 리펙토링

src/features/reference-feature/contracts/reference-mapper.ts

@@ -5,8 +5,8 @@ import {
 import {
   mappingFailure,
   mappingSuccess,
-  type MappingResult,
   type InstalledBoundaryMapper,
+  type MappingResult,
 } from "../../../contracts/boundary-mapper.ts";
 
 export type ReferenceResourceView = Readonly<{
@@ -16,7 +16,9 @@ export type ReferenceResourceView = Readonly<{
   optimistic?: boolean;
 }>;
 
-function mapReferenceDto(value: unknown): MappingResult<ReferenceResource> {
+export function mapReferenceResourcePayload(
+  value: unknown,
+): MappingResult<ReferenceResource> {
   if (!value || typeof value !== "object") {
     return mappingFailure("MAPPING_INVARIANT_REJECTED");
   }
@@ -37,28 +39,40 @@ function mapReferenceDto(value: unknown): MappingResult<ReferenceResource> {
   }
 }
 
+export function mapReferenceResourceListPayload(
+  payload: unknown,
+): MappingResult<readonly ReferenceResource[]> {
+  if (!Array.isArray(payload)) {
+    return mappingFailure("MAPPING_INVARIANT_REJECTED");
+  }
+  if (payload.length > 100) {
+    return mappingFailure("OUTPUT_LIMIT_EXCEEDED");
+  }
+  const output: ReferenceResource[] = [];
+  for (const item of payload) {
+    const mapped = mapReferenceResourcePayload(item);
+    if (!mapped.ok) return mapped;
+    output.push(mapped.value);
+  }
+  return mappingSuccess(Object.freeze(output));
+}
+
+/**
+ * Registry-facing compatibility projection. Feature adapters should prefer the
+ * operation-specific mapper functions above so their result type is exact.
+ */
 export function mapReferenceOperation(
   operationId: string,
   payload: unknown,
 ): MappingResult<ReferenceResource | readonly ReferenceResource[]> {
   if (operationId === "LIST_REFERENCE_RESOURCES") {
-    if (!Array.isArray(payload)) {
-      return mappingFailure("MAPPING_INVARIANT_REJECTED");
-    }
-    if (payload.length > 100) return mappingFailure("OUTPUT_LIMIT_EXCEEDED");
-    const output: ReferenceResource[] = [];
-    for (const item of payload) {
-      const mapped = mapReferenceDto(item);
-      if (!mapped.ok) return mapped;
-      output.push(mapped.value);
-    }
-    return mappingSuccess(Object.freeze(output));
+    return mapReferenceResourceListPayload(payload);
   }
   if (
     operationId === "CREATE_REFERENCE_RESOURCE" ||
     operationId === "GET_REFERENCE_RESOURCE"
   ) {
-    return mapReferenceDto(payload);
+    return mapReferenceResourcePayload(payload);
   }
   return mappingFailure("MAPPING_INVARIANT_REJECTED");
 }
@@ -71,8 +85,7 @@ export const REFERENCE_BOUNDARY_MAPPERS = Object.freeze({
     outputContractId: "ReferenceResourceList",
     owner: "feature-frontend-reference-feature-vertical-slice",
     maxOutputItems: 100,
-    map: (input: unknown) =>
-      mapReferenceOperation("LIST_REFERENCE_RESOURCES", input),
+    map: mapReferenceResourceListPayload,
   }),
   ReferenceResourceMapper: Object.freeze({
     mapperId: "ReferenceResourceMapper",
@@ -81,8 +94,7 @@ export const REFERENCE_BOUNDARY_MAPPERS = Object.freeze({
     outputContractId: "ReferenceResource",
     owner: "feature-frontend-reference-feature-vertical-slice",
     maxOutputItems: 1,
-    map: (input: unknown) =>
-      mapReferenceOperation("GET_REFERENCE_RESOURCE", input),
+    map: mapReferenceResourcePayload,
   }),
 } satisfies Readonly<Record<string, InstalledBoundaryMapper>>);