@mandujs/core 0.12.2 → 0.13.0

package/src/contract/schema.ts

@@ -5,33 +5,33 @@
 
 import type { z } from "zod";
 
-/** HTTP Methods supported in contracts */
-export type ContractMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
-
-/**
- * Client-safe schema options
- */
-export type ClientSafeRequestMap = Partial<Record<
-  ContractMethod,
-  {
-    query?: boolean;
-    body?: boolean;
-    params?: boolean;
-    headers?: boolean;
-  }
->>;
-
-export type ClientSafeResponseMap = number[] | Partial<Record<number, boolean>>;
-
-export interface ClientSafeOptions {
-  /** Request schema exposure */
-  request?: ClientSafeRequestMap;
-  /** Response schema exposure */
-  response?: ClientSafeResponseMap;
-  /** Include standard error responses if defined */
-  includeErrors?: boolean;
-}
-
+/** HTTP Methods supported in contracts */
+export type ContractMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+
+/**
+ * Client-safe schema options
+ */
+export type ClientSafeRequestMap = Partial<Record<
+  ContractMethod,
+  {
+    query?: boolean;
+    body?: boolean;
+    params?: boolean;
+    headers?: boolean;
+  }
+>>;
+
+export type ClientSafeResponseMap = number[] | Partial<Record<number, boolean>>;
+
+export interface ClientSafeOptions {
+  /** Request schema exposure */
+  request?: ClientSafeRequestMap;
+  /** Response schema exposure */
+  response?: ClientSafeResponseMap;
+  /** Include standard error responses if defined */
+  includeErrors?: boolean;
+}
+
 /** Example data for request/response documentation */
 export interface SchemaExamples {
   /** Example name → example data */
@@ -97,19 +97,19 @@ export interface ContractResponseSchema {
 export type ContractNormalizeMode = "strip" | "strict" | "passthrough";
 
 /** Full contract schema definition */
-export interface ContractSchema {
-  /** Contract name (optional) */
-  name?: string;
-  /** Contract version (optional) */
-  version?: string;
-  /** Contract metadata (optional) */
-  meta?: Record<string, unknown>;
-  /** Client-safe schema config (optional) */
-  clientSafe?: ClientSafeOptions;
-  /** API description */
-  description?: string;
-  /** Tags for grouping (e.g., OpenAPI tags) */
-  tags?: string[];
+export interface ContractSchema {
+  /** Contract name (optional) */
+  name?: string;
+  /** Contract version (optional) */
+  version?: string;
+  /** Contract metadata (optional) */
+  meta?: Record<string, unknown>;
+  /** Client-safe schema config (optional) */
+  clientSafe?: ClientSafeOptions;
+  /** API description */
+  description?: string;
+  /** Tags for grouping (e.g., OpenAPI tags) */
+  tags?: string[];
   /** Request schemas by method */
   request: ContractRequestSchema;
   /** Response schemas by status code */
@@ -129,14 +129,14 @@ export interface ContractSchema {
 }
 
 /** Contract definition input (what user provides) */
-export interface ContractDefinition {
-  name?: string;
-  version?: string;
-  meta?: Record<string, unknown>;
-  clientSafe?: ClientSafeOptions;
-  description?: string;
-  tags?: string[];
-  request: ContractRequestSchema;
+export interface ContractDefinition {
+  name?: string;
+  version?: string;
+  meta?: Record<string, unknown>;
+  clientSafe?: ClientSafeOptions;
+  description?: string;
+  tags?: string[];
+  request: ContractRequestSchema;
   response: ContractResponseSchema;
   /** Normalize mode for request data */
   normalize?: ContractNormalizeMode;

package/src/contract/types.ts

@@ -11,22 +11,22 @@ import type {
   MethodRequestSchema,
 } from "./schema";
 
-/**
- * Extract inferred type from Zod schema
- */
-type InferZod<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
-
-/**
- * Extract inferred type from response schema (supports ResponseSchemaWithExamples)
- */
-export type InferResponseSchema<T> =
-  T extends { schema: infer S }
-    ? S extends z.ZodTypeAny
-      ? z.infer<S>
-      : never
-    : T extends z.ZodTypeAny
-      ? z.infer<T>
-      : never;
+/**
+ * Extract inferred type from Zod schema
+ */
+type InferZod<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+
+/**
+ * Extract inferred type from response schema (supports ResponseSchemaWithExamples)
+ */
+export type InferResponseSchema<T> =
+  T extends { schema: infer S }
+    ? S extends z.ZodTypeAny
+      ? z.infer<S>
+      : never
+    : T extends z.ZodTypeAny
+      ? z.infer<T>
+      : never;
 
 /**
  * Infer request schema types for a single method
@@ -50,9 +50,9 @@ type InferContractRequest<T extends ContractRequestSchema> = {
 /**
  * Infer all response schemas
  */
-type InferContractResponse<T extends ContractResponseSchema> = {
-  [K in keyof T]: InferResponseSchema<T[K]>;
-};
+type InferContractResponse<T extends ContractResponseSchema> = {
+  [K in keyof T]: InferResponseSchema<T[K]>;
+};
 
 /**
  * Infer full contract types
@@ -115,34 +115,34 @@ export type InferBody<
 /**
  * Extract params type for a specific method
  */
-export type InferParams<
-  T extends ContractSchema,
-  M extends keyof T["request"]
-> = T["request"][M] extends MethodRequestSchema
-  ? T["request"][M]["params"] extends z.ZodTypeAny
-    ? z.infer<T["request"][M]["params"]>
-    : undefined
-  : undefined;
-
-/**
- * Extract headers type for a specific method
- */
-export type InferHeaders<
-  T extends ContractSchema,
-  M extends keyof T["request"]
-> = T["request"][M] extends MethodRequestSchema
-  ? T["request"][M]["headers"] extends z.ZodTypeAny
-    ? z.infer<T["request"][M]["headers"]>
-    : undefined
-  : undefined;
+export type InferParams<
+  T extends ContractSchema,
+  M extends keyof T["request"]
+> = T["request"][M] extends MethodRequestSchema
+  ? T["request"][M]["params"] extends z.ZodTypeAny
+    ? z.infer<T["request"][M]["params"]>
+    : undefined
+  : undefined;
+
+/**
+ * Extract headers type for a specific method
+ */
+export type InferHeaders<
+  T extends ContractSchema,
+  M extends keyof T["request"]
+> = T["request"][M] extends MethodRequestSchema
+  ? T["request"][M]["headers"] extends z.ZodTypeAny
+    ? z.infer<T["request"][M]["headers"]>
+    : undefined
+  : undefined;
 
 /**
  * Extract response type for a specific status code
  */
-export type InferResponse<
-  T extends ContractSchema,
-  S extends keyof T["response"]
-> = InferResponseSchema<T["response"][S]>;
+export type InferResponse<
+  T extends ContractSchema,
+  S extends keyof T["response"]
+> = InferResponseSchema<T["response"][S]>;
 
 /**
  * Helper type to get all defined methods in a contract
@@ -183,20 +183,20 @@ export type RequiredFields<
 /**
  * Get the success response type (200 or 201)
  */
-export type SuccessResponse<T extends ContractSchema> =
-  InferResponseSchema<T["response"][200]> extends never
-    ? InferResponseSchema<T["response"][201]>
-    : InferResponseSchema<T["response"][200]>;
+export type SuccessResponse<T extends ContractSchema> =
+  InferResponseSchema<T["response"][200]> extends never
+    ? InferResponseSchema<T["response"][201]>
+    : InferResponseSchema<T["response"][200]>;
 
 /**
  * Get the error response type (400, 404, 500, etc.)
  */
-export type ErrorResponse<T extends ContractSchema> =
-  | InferResponseSchema<T["response"][400]>
-  | InferResponseSchema<T["response"][401]>
-  | InferResponseSchema<T["response"][403]>
-  | InferResponseSchema<T["response"][404]>
-  | InferResponseSchema<T["response"][500]>;
+export type ErrorResponse<T extends ContractSchema> =
+  | InferResponseSchema<T["response"][400]>
+  | InferResponseSchema<T["response"][401]>
+  | InferResponseSchema<T["response"][403]>
+  | InferResponseSchema<T["response"][404]>
+  | InferResponseSchema<T["response"][500]>;
 
 /**
  * Utility type for strict contract enforcement
@@ -233,8 +233,8 @@ export type ContractFetchOptions<
 /**
  * Response type union for a contract
  */
-export type ContractResponseUnion<T extends ContractSchema> = {
-  [K in keyof T["response"]]: InferResponseSchema<T["response"][K]> extends never
-    ? never
-    : { status: K; data: InferResponseSchema<T["response"][K]> };
-}[keyof T["response"]];
+export type ContractResponseUnion<T extends ContractSchema> = {
+  [K in keyof T["response"]]: InferResponseSchema<T["response"][K]> extends never
+    ? never
+    : { status: K; data: InferResponseSchema<T["response"][K]> };
+}[keyof T["response"]];

package/src/contract/validator.ts

@@ -13,32 +13,32 @@
  */
 
 import type { z } from "zod";
-import type {
-  ContractSchema,
-  ContractValidationResult,
-  ContractValidationError,
-  ContractValidationIssue,
-  MethodRequestSchema,
-  ContractNormalizeMode,
-  ResponseSchemaWithExamples,
-} from "./schema";
+import type {
+  ContractSchema,
+  ContractValidationResult,
+  ContractValidationError,
+  ContractValidationIssue,
+  MethodRequestSchema,
+  ContractNormalizeMode,
+  ResponseSchemaWithExamples,
+} from "./schema";
 import {
   type NormalizeMode,
   type NormalizeOptions,
   normalizeSchema,
   createCoerceSchema,
 } from "./normalize";
-import { ZodObject } from "zod";
-
-function isResponseSchemaWithExamples(
-  schema: z.ZodTypeAny | ResponseSchemaWithExamples | undefined
-): schema is ResponseSchemaWithExamples {
-  return (
-    schema !== undefined &&
-    typeof schema === "object" &&
-    "schema" in schema
-  );
-}
+import { ZodObject } from "zod";
+
+function isResponseSchemaWithExamples(
+  schema: z.ZodTypeAny | ResponseSchemaWithExamples | undefined
+): schema is ResponseSchemaWithExamples {
+  return (
+    schema !== undefined &&
+    typeof schema === "object" &&
+    "schema" in schema
+  );
+}
 
 /**
  * Validator 옵션
@@ -453,18 +453,18 @@ export class ContractValidator {
    * @param responseBody - The response body (already parsed)
    * @param statusCode - HTTP status code
    */
-  validateResponse(responseBody: unknown, statusCode: number): ContractValidationResult {
-    const responseSchemaOrWithExamples = this.contract.response[statusCode];
-    if (!responseSchemaOrWithExamples) {
-      // No schema defined for this status code, pass through
-      return { success: true };
-    }
-
-    const responseSchema = isResponseSchemaWithExamples(responseSchemaOrWithExamples)
-      ? responseSchemaOrWithExamples.schema
-      : responseSchemaOrWithExamples;
-
-    const result = responseSchema.safeParse(responseBody);
+  validateResponse(responseBody: unknown, statusCode: number): ContractValidationResult {
+    const responseSchemaOrWithExamples = this.contract.response[statusCode];
+    if (!responseSchemaOrWithExamples) {
+      // No schema defined for this status code, pass through
+      return { success: true };
+    }
+
+    const responseSchema = isResponseSchemaWithExamples(responseSchemaOrWithExamples)
+      ? responseSchemaOrWithExamples.schema
+      : responseSchemaOrWithExamples;
+
+    const result = responseSchema.safeParse(responseBody);
     if (!result.success) {
       const errors: ContractValidationError[] = [
         {