@zipbul/baker 2.2.0 → 3.0.0

package/dist/src/types.d.ts

@@ -1,3 +1,6 @@
+import type { Result, ResultAsync } from '@zipbul/result';
+import type { BakerIssue } from './errors';
+import type { RuntimeOptions } from './interfaces';
 export interface EmitContext {
     /** Register a RegExp in the reference array, return its index */
     addRegex(re: RegExp): number;
@@ -12,7 +15,7 @@ export interface EmitContext {
     /** Whether this emit runs inside a type gate (typeof/instanceof already verified) */
     insideTypeGate?: boolean;
     /** @internal Path expression for inline nested — used by makeRuleEmitCtx */
-    _pathExpr?: string;
+    pathExpr?: string;
 }
 export interface EmittableRule {
     (value: unknown): boolean | Promise<boolean>;
@@ -21,7 +24,7 @@ export interface EmittableRule {
     /**
      * Meta for the builder to determine whether to insert a typeof guard.
      * Only set for rules that assume a specific type (e.g., isEmail → 'string').
-     * @IsString itself is undefined (it includes its own typeof check).
+     * `@IsString` itself is undefined (it includes its own typeof check).
      */
     readonly requiresType?: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object';
     /** Expose rule parameters for external reading */
@@ -70,9 +73,9 @@ export interface RuleDef {
     rule: InternalRule;
     each?: boolean;
     groups?: string[];
-    /** Value to include in BakerError.message on validation failure */
+    /** Value to include in BakerIssue.message on validation failure */
     message?: string | ((args: MessageArgs) => string);
-    /** Arbitrary value to include in BakerError.context on validation failure */
+    /** Arbitrary value to include in BakerIssue.context on validation failure */
     context?: unknown;
 }
 export interface TransformParams {
@@ -105,8 +108,10 @@ export interface ExcludeDef {
     deserializeOnly?: boolean;
     serializeOnly?: boolean;
 }
+/** Generic class constructor — contravariant `never[]` args accept any user constructor */
+export type ClassCtor<T = object> = new (...args: never[]) => T;
 export interface TypeDef {
-    fn: () => (new (...args: any[]) => any) | (new (...args: any[]) => any)[];
+    fn: () => ClassCtor | ClassCtor[] | MapConstructor | SetConstructor;
     discriminator?: {
         property: string;
         subTypes: {
@@ -118,26 +123,26 @@ export interface TypeDef {
     /** seal() normalization result — true if fn() returns an array */
     isArray?: boolean;
     /** seal() normalization result — cached class after resolving fn() (DTOs only, excluding primitives) */
-    resolvedClass?: new (...args: any[]) => any;
+    resolvedClass?: ClassCtor;
     /** seal() normalization result — Map or Set collection type */
     collection?: 'Map' | 'Set';
     /** Nested DTO class thunk for Map value / Set element */
-    collectionValue?: () => new (...args: any[]) => any;
+    collectionValue?: () => ClassCtor;
     /** seal() normalization result — cached class after resolving collectionValue */
-    resolvedCollectionValue?: new (...args: any[]) => any;
+    resolvedCollectionValue?: ClassCtor;
 }
 export interface PropertyFlags {
-    /** @IsOptional() — skip all validation when undefined/null */
+    /** `@IsOptional`() — skip all validation when undefined/null */
     isOptional?: boolean;
-    /** @IsDefined() — disallow undefined (overrides @IsOptional). Current code rejects only undefined; null is delegated to subsequent validation */
+    /** `@IsDefined`() — disallow undefined (overrides @IsOptional). Current code rejects only undefined; null is delegated to subsequent validation */
     isDefined?: boolean;
-    /** @IsNullable() — allow and assign null, reject undefined */
+    /** `@IsNullable`() — allow and assign null, reject undefined */
     isNullable?: boolean;
-    /** @ValidateIf(cond) — skip all field validation when false */
-    validateIf?: (obj: Record<string, any>) => boolean;
-    /** @ValidateNested() — trigger recursive validation for nested DTOs. Used with @Type */
+    /** `@ValidateIf`(cond) — skip all field validation when false */
+    validateIf?: (obj: Record<string, unknown>) => boolean;
+    /** `@ValidateNested`() — trigger recursive validation for nested DTOs. Used with @Type */
     validateNested?: boolean;
-    /** @ValidateNested({ each: true }) — validate nested DTOs per array element */
+    /** `@ValidateNested`({ each: true }) — validate nested DTOs per array element */
     validateNestedEach?: boolean;
 }
 export interface RawPropertyMeta {
@@ -151,20 +156,17 @@ export interface RawPropertyMeta {
 export interface RawClassMeta {
     [propertyKey: string]: RawPropertyMeta;
 }
-import type { RuntimeOptions } from './interfaces';
-import type { BakerError } from './errors';
-import type { Result, ResultAsync } from '@zipbul/result';
 export interface SealedExecutors<T> {
     /** Internal executor — Result pattern. deserialize() wraps and converts to throw */
-    _deserialize(input: unknown, options?: RuntimeOptions): Result<T, BakerError[]> | ResultAsync<T, BakerError[]>;
+    deserialize(input: unknown, options?: RuntimeOptions): Result<T, BakerIssue[]> | ResultAsync<T, BakerIssue[]>;
     /** Internal executor — always succeeds. serialize assumes no validation */
-    _serialize(instance: T, options?: RuntimeOptions): Record<string, unknown> | Promise<Record<string, unknown>>;
-    /** Internal executor — validate-only (no object creation). Returns null on success, BakerError[] on failure */
-    _validate(input: unknown, options?: RuntimeOptions): BakerError[] | null | Promise<BakerError[] | null>;
+    serialize(instance: T, options?: RuntimeOptions): Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** Internal executor — validate-only (no object creation). Returns null on success, BakerIssue[] on failure */
+    validate(input: unknown, options?: RuntimeOptions): BakerIssue[] | null | Promise<BakerIssue[] | null>;
     /** true if the deserialize direction has async rules/transforms/nested */
-    _isAsync: boolean;
+    isAsync: boolean;
     /** true if the serialize direction has async transforms/nested */
-    _isSerializeAsync: boolean;
+    isSerializeAsync: boolean;
     /** Merged metadata cache — used internally by unseal helper */
-    _merged?: RawClassMeta;
+    merged?: RawClassMeta;
 }

package/dist/src/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/utils.d.ts

@@ -1,4 +1,4 @@
-/** minification-safe async function detection (uses Symbol.toStringTag, not constructor.name) */
-export declare function isAsyncFunction(fn: Function): boolean;
+/** minification-safe async function detection — uses Object.prototype.toString brand instead of constructor.name */
+export declare function isAsyncFunction(fn: (...args: never[]) => unknown): boolean;
 /** Promise-like detection used to enforce sync/async contract at runtime */
 export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;

package/dist/src/utils.js

@@ -0,0 +1,10 @@
+/** minification-safe async function detection — uses Object.prototype.toString brand instead of constructor.name */
+export function isAsyncFunction(fn) {
+    return Object.prototype.toString.call(fn) === '[object AsyncFunction]';
+}
+/** Promise-like detection used to enforce sync/async contract at runtime */
+export function isPromiseLike(value) {
+    return ((typeof value === 'object' || typeof value === 'function') &&
+        value !== null &&
+        typeof value.then === 'function');
+}

package/package.json

@@ -1,102 +1,95 @@
 {
   "name": "@zipbul/baker",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "Fastest decorator-based DTO validation for TypeScript. AOT code generation, 42ns per validation, 163x faster than class-validator. Zero reflect-metadata.",
-  "license": "MIT",
-  "author": "Junhyung Park (https://github.com/parkrevil)",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/zipbul/baker.git"
-  },
-  "bugs": "https://github.com/zipbul/baker/issues",
-  "homepage": "https://github.com/zipbul/baker#readme",
   "keywords": [
-    "validation",
-    "validator",
-    "transform",
-    "transformer",
-    "decorator",
-    "dto",
-    "typescript",
-    "runtime-validation",
-    "type-safe",
-    "class-validator",
+    "aot",
+    "bun",
     "class-transformer",
+    "class-validator",
     "class-validator-alternative",
-    "zod-alternative",
-    "serialize",
-    "deserialize",
     "code-generation",
-    "aot",
-    "bun",
+    "decorator",
+    "deserialize",
+    "dto",
     "fast-validation",
-    "schema-validation"
+    "runtime-validation",
+    "schema-validation",
+    "serialize",
+    "transform",
+    "transformer",
+    "type-safe",
+    "typescript",
+    "validation",
+    "validator",
+    "zod-alternative"
   ],
-  "engines": {
-    "bun": ">=1.0.0"
+  "homepage": "https://github.com/zipbul/baker#readme",
+  "bugs": "https://github.com/zipbul/baker/issues",
+  "license": "MIT",
+  "author": "Junhyung Park (https://github.com/parkrevil)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zipbul/baker.git"
   },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "README.md",
+    "CHANGELOG.md",
+    "MIGRATION-3.0.md",
+    "LICENSE"
+  ],
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     },
     "./decorators": {
-      "import": "./dist/src/decorators/index.js",
-      "types": "./dist/src/decorators/index.d.ts"
+      "types": "./dist/src/decorators/index.d.ts",
+      "import": "./dist/src/decorators/index.js"
     },
     "./rules": {
-      "import": "./dist/src/rules/index.js",
-      "types": "./dist/src/rules/index.d.ts"
+      "types": "./dist/src/rules/index.d.ts",
+      "import": "./dist/src/rules/index.js"
     },
     "./symbols": {
-      "import": "./dist/src/symbols.js",
-      "types": "./dist/src/symbols.d.ts"
+      "types": "./dist/src/symbols.d.ts",
+      "import": "./dist/src/symbols.js"
     },
     "./transformers": {
-      "import": "./dist/src/transformers/index.js",
-      "types": "./dist/src/transformers/index.d.ts"
+      "types": "./dist/src/transformers/index.d.ts",
+      "import": "./dist/src/transformers/index.js"
     }
   },
-  "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "README.md",
-    "LICENSE"
-  ],
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "peerDependencies": {
-    "luxon": ">=3.0.0",
-    "moment": ">=2.0.0"
-  },
-  "peerDependenciesMeta": {
-    "luxon": {
-      "optional": true
-    },
-    "moment": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@zipbul/result": "1.0.0"
-  },
   "scripts": {
-    "build": "bun build index.ts src/decorators/index.ts src/rules/index.ts src/symbols.ts src/transformers/index.ts --outdir dist --target bun --format esm --splitting --packages external --root . --production && tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && bun scripts/add-js-extensions.ts",
+    "changeset": "changeset",
+    "deps:check": "dpdm --no-warning --no-tree --no-output -T index.ts src/",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "knip": "knip",
+    "lint": "oxlint",
+    "prepare": "husky",
+    "release": "changeset publish",
     "test": "bun test",
     "test:coverage": "bun test --coverage",
     "test:memory": "bun run scripts/check-memory.ts",
-    "changeset": "changeset",
-    "version-packages": "changeset version",
-    "release": "changeset publish",
-    "prepare": "husky"
+    "typecheck": "tsc --noEmit",
+    "typecheck:bench": "tsc --noEmit -p bench/tsconfig.json && tsc --noEmit -p bench/class-validator/tsconfig.json",
+    "version-packages": "changeset version"
+  },
+  "dependencies": {
+    "@zipbul/result": "1.0.0"
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.8",
@@ -105,15 +98,35 @@
     "@sinclair/typebox": "^0.34.48",
     "@types/bun": "^1.3.9",
     "@types/luxon": "^3.7.1",
-    "@types/moment": "^2.13.0",
     "ajv": "^8.18.0",
     "arktype": "^2.2.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.15.1",
+    "dpdm": "^4.2.0",
     "husky": "^9.1.7",
+    "knip": "^6.14.1",
+    "luxon": "^3.7.1",
     "mitata": "^1.0.34",
+    "moment": "^2.30.1",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.65.0",
     "reflect-metadata": "^0.2.2",
     "valibot": "^1.3.1",
     "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "luxon": ">=3.0.0",
+    "moment": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "luxon": {
+      "optional": true
+    },
+    "moment": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "bun": ">=1.3.13"
   }
-}
+}

package/dist/index-03cysbck.js

@@ -1,3 +0,0 @@
-// @bun
-import{o as C}from"./index-jp2yjd6g.js";var H=new Set;function J(h,G){if(!Object.prototype.hasOwnProperty.call(h,C))h[C]=Object.create(null),H.add(h);let S=h[C];return S[G]??={validation:[],transform:[],expose:[],exclude:null,type:null,flags:{}}}function Q(h){return h[Symbol.toStringTag]==="AsyncFunction"}function U(h){return(typeof h==="object"||typeof h==="function")&&h!==null&&typeof h.then==="function"}var $=Symbol.for("baker:arrayOf");function M(...h){let G={rules:h};return G[$]=!0,G}function N(h){return typeof h==="object"&&h!==null&&h[$]===!0}var V=new Set(["type","discriminator","keepDiscriminatorProperty","rules","optional","nullable","name","deserializeName","serializeName","exclude","groups","when","transform","message","context","mapValue","setValue"]);function X(h){if(typeof h==="function")return!1;if(typeof h!=="object"||h===null)return!1;if(N(h))return!1;let G=Object.keys(h);if(G.length===0)return!0;return G.some((S)=>V.has(S))}function I(h){if(h.length===0)return{rules:[],options:{}};if(h.length===1&&X(h[0])){let S=h[0];return{rules:S.rules??[],options:S}}let G=h[h.length-1];if(X(G)){let S=G,q=h.slice(0,-1);if(S.rules)q=[...q,...S.rules];return{rules:q,options:S}}return{rules:h,options:{}}}function L(h,G,S){for(let q of G)if(N(q))for(let w of q.rules){let b={rule:w,each:!0,groups:S.groups};if(S.message!==void 0)b.message=S.message;if(S.context!==void 0)b.context=S.context;h.validation.push(b)}else{let w={rule:q,groups:S.groups};if(S.message!==void 0)w.message=S.message;if(S.context!==void 0)w.context=S.context;h.validation.push(w)}}function E(h,G){if(G.name)h.expose.push({name:G.name,groups:G.groups});else if(G.deserializeName||G.serializeName){if(G.deserializeName)h.expose.push({name:G.deserializeName,deserializeOnly:!0,groups:G.groups});if(G.serializeName)h.expose.push({name:G.serializeName,serializeOnly:!0,groups:G.groups})}else if(G.groups)h.expose.push({groups:G.groups});else h.expose.push({})}function Z(h,G,S){let q=Q(S);return{fn:(b)=>{let B=S(b);if(!q&&U(B))throw Error(`@Field(${h}) ${G} transform returned Promise. Declare the transform with async if it is asynchronous.`);return B},isAsync:q}}function P(h,G,S){if(!S.transform)return;let q=Array.isArray(S.transform)?S.transform:[S.transform];for(let w of q){let b=Z(G,"deserialize",w.deserialize),B=Z(G,"serialize",w.serialize);h.transform.push({fn:b.fn,isAsync:b.isAsync,options:{deserializeOnly:!0}},{fn:B.fn,isAsync:B.isAsync,options:{serializeOnly:!0}})}}function v(...h){return(G,S)=>{let q=G.constructor,w=S,b=J(q,w),{rules:B,options:j}=I(h);if(L(b,B,j),j.optional)b.flags.isOptional=!0;if(j.nullable)b.flags.isNullable=!0;if(j.when)b.flags.validateIf=j.when;if(j.type)b.type={fn:j.type,discriminator:j.discriminator,keepDiscriminatorProperty:j.keepDiscriminatorProperty,collectionValue:j.mapValue??j.setValue};if(E(b,j),j.exclude){if(j.exclude===!0)b.exclude={};else if(j.exclude==="deserializeOnly")b.exclude={deserializeOnly:!0};else if(j.exclude==="serializeOnly")b.exclude={serializeOnly:!0}}P(b,w,j)}}
-export{H as j,Q as k,U as l,M as m,v as n};

package/dist/index-dcbd798a.js

@@ -1,3 +0,0 @@
-// @bun
-var I=()=>({kind:"value"}),Y=(w=I())=>({kind:"member",object:w,property:"length"}),Z=(w=I())=>({kind:"call0",object:w,method:"getTime"}),O=(w)=>({kind:"literal",value:w}),_=(w,z,A)=>({kind:"compare",left:w,op:z,right:typeof A==="number"?O(A):A});var $=(...w)=>({kind:"or",checks:w});function L(w){return Q({name:w.name,requiresType:w.requiresType,constraints:w.constraints,plan:w.plan,validate:w.validate,emit:(z,A)=>U(z,A,w.name,w.plan)})}function Q(w){let z=(A)=>w.validate(A);if(z.emit=w.emit,z.ruleName=w.name,w.requiresType!==void 0)z.requiresType=w.requiresType;if(z.constraints=w.constraints??{},w.isAsync)z.isAsync=!0;if(w.plan)z.plan=w.plan;return z}function U(w,z,A,B,F,K){let M=K?W(B.failure):B.failure;return`if (${J(M,w,F)}) ${z.fail(A)};`}function W(w){if(w.kind==="compare")return w;let z=w.checks.filter((A)=>!X(A));if(z.length===0)return w;if(z.length===1)return z[0];return{kind:w.kind,checks:z}}function X(w){if(w.kind!=="compare"||w.op!=="!==")return!1;return H(w.left,w.right)}function H(w,z){if(w.kind!==z.kind)return!1;if(w.kind==="value")return!0;if(w.kind==="literal")return w.value===z.value;if(w.kind==="member")return H(w.object,z.object);if(w.kind==="call0")return w.method===z.method&&H(w.object,z.object);return!1}function J(w,z,A){if(w.kind==="compare")return`${D(w.left,z,A)} ${w.op} ${D(w.right,z,A)}`;let B=w.kind==="and"?" && ":" || ";return`(${w.checks.map((F)=>J(F,z,A)).join(B)})`}function D(w,z,A){switch(w.kind){case"value":return z;case"literal":return String(w.value);case"member":return A?.length??`${D(w.object,z,A)}.length`;case"call0":return A?.time??`${D(w.object,z,A)}.getTime()`}}
-export{I as a,Y as b,Z as c,O as d,_ as e,$ as f,L as g,Q as h,U as i};

package/dist/index-jp2yjd6g.js

@@ -1,3 +0,0 @@
-// @bun
-var f=Symbol.for("baker:raw"),g=Symbol.for("baker:sealed");
-export{f as o,g as p};

package/dist/index-mw7met6r.js

@@ -1,3 +0,0 @@
-// @bun
-var a=import.meta.require;
-export{a as q};

package/dist/index-xdn55cz3.js

@@ -1 +0,0 @@
-// @bun

package/dist/src/functions/_run-sealed.d.ts

@@ -1,7 +0,0 @@
-import type { BakerErrors } from '../errors';
-import type { RuntimeOptions } from '../interfaces';
-/**
- * @internal — shared seal+dispatch+unwrap for deserialize and validate.
- * Calls sealed._deserialize, converts Result to BakerErrors, maps success via onSuccess.
- */
-export declare function _runSealed<S>(Class: Function, input: unknown, options: RuntimeOptions | undefined, onSuccess: (result: any) => S): S | BakerErrors | Promise<S | BakerErrors>;

package/dist/src/functions/index.d.ts

@@ -1,3 +0,0 @@
-export { deserialize } from './deserialize';
-export { serialize } from './serialize';
-export { validate } from './validate';

package/dist/src/seal/index.d.ts

@@ -1,5 +0,0 @@
-export { _autoSeal, _sealOnDemand, _resetForTesting, _sealedClasses, mergeInheritance } from './seal';
-export { buildDeserializeCode } from './deserialize-builder';
-export { buildSerializeCode } from './serialize-builder';
-export { analyzeCircular } from './circular-analyzer';
-export { validateExposeStacks } from './expose-validator';