@zipbul/baker 2.1.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;
@@ -9,6 +12,10 @@ export interface EmitContext {
     fail(code: string): string;
     /** Whether error collection mode is enabled (= !stopAtFirstError) */
     collectErrors: boolean;
+    /** 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;
 }
 export interface EmittableRule {
     (value: unknown): boolean | Promise<boolean>;
@@ -17,14 +24,45 @@ 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';
+    readonly requiresType?: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'object';
     /** Expose rule parameters for external reading */
     readonly constraints?: Record<string, unknown>;
-    /** true when using an async validate function — deserialize-builder generates await code */
+    /** true when the rule is explicitly async and must be awaited */
     readonly isAsync?: boolean;
 }
+/** @internal internal rule shape used by builders for optimization metadata */
+export interface InternalRule extends EmittableRule {
+    readonly plan?: RulePlan;
+}
+export type RulePlanExpr = {
+    kind: 'value';
+} | {
+    kind: 'member';
+    object: RulePlanExpr;
+    property: 'length';
+} | {
+    kind: 'call0';
+    object: RulePlanExpr;
+    method: 'getTime';
+} | {
+    kind: 'literal';
+    value: number;
+};
+export type RulePlanCheck = {
+    kind: 'compare';
+    left: RulePlanExpr;
+    op: '<' | '<=' | '>' | '>=' | '===' | '!==';
+    right: RulePlanExpr;
+} | {
+    kind: 'and' | 'or';
+    checks: RulePlanCheck[];
+};
+export interface RulePlan {
+    cacheKey?: 'length' | 'time';
+    failure: RulePlanCheck;
+}
 /** Arguments for user-defined message callback */
 export interface MessageArgs {
     property: string;
@@ -32,12 +70,12 @@ export interface MessageArgs {
     constraints: Record<string, unknown>;
 }
 export interface RuleDef {
-    rule: EmittableRule;
+    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 {
@@ -46,13 +84,14 @@ export interface TransformParams {
     obj: Record<string, unknown>;
 }
 export interface Transformer {
-    deserialize(params: TransformParams): unknown;
-    serialize(params: TransformParams): unknown;
+    deserialize(params: TransformParams): unknown | Promise<unknown>;
+    serialize(params: TransformParams): unknown | Promise<unknown>;
 }
 /** Internal — direction-specific transform function stored after @Field processing */
-export type TransformFunction = (params: TransformParams) => unknown;
+export type TransformFunction = (params: TransformParams) => unknown | Promise<unknown>;
 export interface TransformDef {
     fn: TransformFunction;
+    isAsync?: boolean;
     options?: {
         groups?: string[];
         deserializeOnly?: boolean;
@@ -69,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: {
@@ -82,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 {
@@ -115,18 +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>>;
+    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,2 +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.1.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-fnv35wrf.js

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

package/dist/index-k3d659ad.js

@@ -1,3 +0,0 @@
-// @bun
-import{d as v}from"./index-fnv35wrf.js";var z=new Set;function B(h,w){if(!Object.prototype.hasOwnProperty.call(h,v))h[v]=Object.create(null),z.add(h);let G=h[v];return G[w]??={validation:[],transform:[],expose:[],exclude:null,type:null,flags:{}}}var H=Symbol.for("baker:arrayOf");function T(...h){let w={rules:h};return w[H]=!0,w}function J(h){return typeof h==="object"&&h!==null&&h[H]===!0}var U=new Set(["type","discriminator","keepDiscriminatorProperty","rules","optional","nullable","name","deserializeName","serializeName","exclude","groups","when","transform","message","context","mapValue","setValue"]);function C(h){if(typeof h==="function")return!1;if(typeof h!=="object"||h===null)return!1;if(J(h))return!1;let w=Object.keys(h);if(w.length===0)return!0;return w.some((G)=>U.has(G))}function X(h){if(h.length===0)return{rules:[],options:{}};if(h.length===1&&C(h[0])){let G=h[0];return{rules:G.rules??[],options:G}}let w=h[h.length-1];if(C(w)){let G=w,j=h.slice(0,-1);if(G.rules)j=[...j,...G.rules];return{rules:j,options:G}}return{rules:h,options:{}}}function Z(h,w,G){for(let j of w)if(J(j))for(let q of j.rules){let b={rule:q,each:!0,groups:G.groups};if(G.message!==void 0)b.message=G.message;if(G.context!==void 0)b.context=G.context;h.validation.push(b)}else{let q={rule:j,groups:G.groups};if(G.message!==void 0)q.message=G.message;if(G.context!==void 0)q.context=G.context;h.validation.push(q)}}function $(h,w){if(w.name)h.expose.push({name:w.name,groups:w.groups});else if(w.deserializeName||w.serializeName){if(w.deserializeName)h.expose.push({name:w.deserializeName,deserializeOnly:!0,groups:w.groups});if(w.serializeName)h.expose.push({name:w.serializeName,serializeOnly:!0,groups:w.groups})}else if(w.groups)h.expose.push({groups:w.groups});else h.expose.push({})}function K(h,w){if(!w.transform)return;let G=Array.isArray(w.transform)?w.transform:[w.transform];for(let j of G)h.transform.push({fn:j.deserialize,options:{deserializeOnly:!0}},{fn:j.serialize,options:{serializeOnly:!0}})}function E(...h){return(w,G)=>{let j=w.constructor,b=B(j,G),{rules:Q,options:S}=X(h);if(Z(b,Q,S),S.optional)b.flags.isOptional=!0;if(S.nullable)b.flags.isNullable=!0;if(S.when)b.flags.validateIf=S.when;if(S.type)b.type={fn:S.type,discriminator:S.discriminator,keepDiscriminatorProperty:S.keepDiscriminatorProperty,collectionValue:S.mapValue??S.setValue};if($(b,S),S.exclude){if(S.exclude===!0)b.exclude={};else if(S.exclude==="deserializeOnly")b.exclude={deserializeOnly:!0};else if(S.exclude==="serializeOnly")b.exclude={serializeOnly:!0}}K(b,S)}}
-export{z as a,T as b,E as c};

package/dist/index-s0n74vx1.js

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

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';