@nifrajs/schema 0.1.0-alpha.2 → 0.1.0-beta.0

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,gBAAgB,EAAiB,MAAM,eAAe,CAAA;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAIxD;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;IAC9F,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;CACvB,CAAA;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CA6BxE"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,gBAAgB,EAAiB,MAAM,eAAe,CAAA;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAKxD;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG;IAC9F,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;CACvB,CAAA;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAiCxE"}

package/dist/adapter.js

@@ -1,5 +1,6 @@
 import { TypeCompiler } from "@sinclair/typebox/compiler";
 import { Value } from "@sinclair/typebox/value";
+import { ensureDefaultFormats } from "./formats.js";
 /**
  * Map a TypeBox validation error to a Standard Schema issue. TypeBox reports JSON
  * Pointers (`"/name"`, `"/items/0"`); Standard Schema wants a segment array (`""` is
@@ -38,6 +39,10 @@ export function fromTypeBox(schema) {
             version: 1,
             vendor: "nifra",
             validate: (value) => {
+                // Install the standard string formats before the first Compile/Check. Driven from this
+                // reachable path (not a top-level import side effect) so a production bundle can't
+                // tree-shake the registration away — see ./formats.ts. Idempotent, ~free after first call.
+                ensureDefaultFormats();
                 if (compiled === undefined && !evalFree) {
                     try {
                         compiled = TypeCompiler.Compile(schema);

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAc/C;;;;;GAKG;AACH,SAAS,OAAO,CAAC,KAA0D;IACzE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;KACrE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAoB,MAAS;IACtD,IAAI,QAAkC,CAAA;IACtC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,CAAC,KAAc,EAA6B,EAAE;gBACtD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACxC,IAAI,CAAC;wBACH,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;oBACzC,CAAC;oBAAC,MAAM,CAAC;wBACP,8EAA8E;wBAC9E,QAAQ,GAAG,IAAI,CAAA;oBACjB,CAAC;gBACH,CAAC;gBACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;wBAAE,OAAO,EAAE,KAAK,EAAE,CAAA;oBAC3C,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;gBAC7D,CAAC;gBACD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;oBAAE,OAAO,EAAE,KAAK,EAAE,CAAA;gBAChD,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;YAClE,CAAC;YACD,oEAAoE;YACpE,8EAA8E;YAC9E,KAAK,EAAE,SAA2D;SACnE;QACD,UAAU,EAAE,MAAM;KACnB,CAAA;AACH,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAcnD;;;;;GAKG;AACH,SAAS,OAAO,CAAC,KAA0D;IACzE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;KACrE,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAoB,MAAS;IACtD,IAAI,QAAkC,CAAA;IACtC,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,CAAC,KAAc,EAA6B,EAAE;gBACtD,uFAAuF;gBACvF,mFAAmF;gBACnF,2FAA2F;gBAC3F,oBAAoB,EAAE,CAAA;gBACtB,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACxC,IAAI,CAAC;wBACH,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;oBACzC,CAAC;oBAAC,MAAM,CAAC;wBACP,8EAA8E;wBAC9E,QAAQ,GAAG,IAAI,CAAA;oBACjB,CAAC;gBACH,CAAC;gBACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;wBAAE,OAAO,EAAE,KAAK,EAAE,CAAA;oBAC3C,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;gBAC7D,CAAC;gBACD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;oBAAE,OAAO,EAAE,KAAK,EAAE,CAAA;gBAChD,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;YAClE,CAAC;YACD,oEAAoE;YACpE,8EAA8E;YAC9E,KAAK,EAAE,SAA2D;SACnE;QACD,UAAU,EAAE,MAAM;KACnB,CAAA;AACH,CAAC"}

package/dist/formats.d.ts

@@ -1,3 +1,19 @@
 /** Register (or override) a string format usable as `t.string({ format: name })`. */
 export declare function registerFormat(name: string, validate: (value: string) => boolean): void;
+/**
+ * Install the standard string formats into TypeBox's global `FormatRegistry`, once.
+ *
+ * This is driven from the validate path (see `./adapter.ts`) rather than run as a bare
+ * top-level import side effect *on purpose*: a production bundler (`Bun.build`, esbuild)
+ * tree-shakes a module that is only imported for its effect, and Bun.build does **not**
+ * honor the `sideEffects` package.json field — so the old top-level registration loop was
+ * dropped from prod server bundles, making every `t.string({ format })` reject with
+ * "Unknown format" while unbundled `nifra dev` worked. Calling this from code the validator
+ * actually reaches keeps the registration in the bundle.
+ *
+ * Idempotent and cheap to call on every validate (a single boolean check after the first
+ * run). The `Has` guard means a format a consumer registered first via {@link registerFormat}
+ * is left untouched.
+ */
+export declare function ensureDefaultFormats(): void;
 //# sourceMappingURL=formats.d.ts.map

package/dist/formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAyBA,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAEvF"}
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAyBA,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAEvF;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}

package/dist/formats.js

@@ -8,9 +8,9 @@ import { FormatRegistry } from "@sinclair/typebox";
  *
  * Patterns are pragmatic (not full RFC grammars) but reject obvious garbage. Need a
  * stricter rule or a format not listed here (e.g. `ipv6`, `hostname`)? Register it
- * with {@link registerFormat}. Importing this module performs the registration as a
- * one-time side effect; the `Has` guard means an app that registered its own
- * validator first wins.
+ * with {@link registerFormat}. The defaults are installed lazily by
+ * {@link ensureDefaultFormats} from the validate path; the `Has` guard means an app
+ * that registered its own validator first wins.
  */
 const DEFAULT_FORMATS = {
     email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
@@ -25,8 +25,29 @@ const DEFAULT_FORMATS = {
 export function registerFormat(name, validate) {
     FormatRegistry.Set(name, validate);
 }
-for (const [name, pattern] of Object.entries(DEFAULT_FORMATS)) {
-    if (!FormatRegistry.Has(name))
-        FormatRegistry.Set(name, (value) => pattern.test(value));
+let defaultsRegistered = false;
+/**
+ * Install the standard string formats into TypeBox's global `FormatRegistry`, once.
+ *
+ * This is driven from the validate path (see `./adapter.ts`) rather than run as a bare
+ * top-level import side effect *on purpose*: a production bundler (`Bun.build`, esbuild)
+ * tree-shakes a module that is only imported for its effect, and Bun.build does **not**
+ * honor the `sideEffects` package.json field — so the old top-level registration loop was
+ * dropped from prod server bundles, making every `t.string({ format })` reject with
+ * "Unknown format" while unbundled `nifra dev` worked. Calling this from code the validator
+ * actually reaches keeps the registration in the bundle.
+ *
+ * Idempotent and cheap to call on every validate (a single boolean check after the first
+ * run). The `Has` guard means a format a consumer registered first via {@link registerFormat}
+ * is left untouched.
+ */
+export function ensureDefaultFormats() {
+    if (defaultsRegistered)
+        return;
+    defaultsRegistered = true;
+    for (const [name, pattern] of Object.entries(DEFAULT_FORMATS)) {
+        if (!FormatRegistry.Has(name))
+            FormatRegistry.Set(name, (value) => pattern.test(value));
+    }
 }
 //# sourceMappingURL=formats.js.map

package/dist/formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"formats.js","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,eAAe,GAAqC;IACxD,KAAK,EAAE,4BAA4B;IACnC,IAAI,EAAE,iEAAiE;IACvE,WAAW,EAAE,4EAA4E;IACzF,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,wDAAwD;IAC9D,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,qEAAqE;CAC5E,CAAA;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAoC;IAC/E,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC;AAED,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AACzF,CAAC"}
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,eAAe,GAAqC;IACxD,KAAK,EAAE,4BAA4B;IACnC,IAAI,EAAE,iEAAiE;IACvE,WAAW,EAAE,4EAA4E;IACzF,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,wDAAwD;IAC9D,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,qEAAqE;CAC5E,CAAA;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,QAAoC;IAC/E,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC;AAED,IAAI,kBAAkB,GAAG,KAAK,CAAA;AAE9B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,kBAAkB;QAAE,OAAM;IAC9B,kBAAkB,GAAG,IAAI,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAI5D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}

package/dist/index.js

@@ -7,8 +7,9 @@
  * a validator; this package is the opt-in default.
  */
 export { fromTypeBox } from "./adapter.js";
-// Re-exporting evaluates ./formats.ts, registering the standard string formats so
-// `t.string({ format })` validates instead of rejecting everything.
+// `registerFormat` adds/overrides a custom string format. The standard formats (email, uuid, …)
+// install themselves lazily from the validate path (see ./adapter.ts) — NOT as an import side
+// effect of this module, which a production bundler would tree-shake away.
 export { registerFormat } from "./formats.js";
 export { toOpenAPI } from "./openapi.js";
 export { t } from "./t.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC5D,kFAAkF;AAClF,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAA0C,SAAS,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC5D,gGAAgG;AAChG,8FAA8F;AAC9F,2EAA2E;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAA0C,SAAS,EAAE,MAAM,cAAc,CAAA;AAChF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/schema",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-beta.0",
   "description": "Built-in schema builder `t` — TypeBox-backed (free JSON Schema + compiled validators), implements Standard Schema so nifra routes validate it natively.",
   "keywords": [
     "bun",
@@ -35,11 +35,8 @@
     "dist",
     "src"
   ],
-  "comment:sideEffects": "formats.ts registers string formats into TypeBox's global FormatRegistry on import — that file must not be tree-shaken away, so it (not the package) is marked side-effectful.",
-  "sideEffects": [
-    "./src/formats.ts",
-    "./dist/formats.js"
-  ],
+  "comment:sideEffects": "No module here runs work at import time: the standard string formats install lazily from the validate path (src/adapter.ts → src/formats.ts ensureDefaultFormats), not as a top-level import side effect. The previous `sideEffects: [formats]` array did not survive bundling — Bun.build ignores the field — which is why formats were dropped from prod bundles. `false` is accurate now and lets consumers tree-shake freely.",
+  "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.build.json && bun run ../../scripts/fix-dts.ts dist"
   },

package/src/adapter.ts

@@ -2,6 +2,7 @@ import type { StandardIssue, StandardResult, StandardSchemaV1, StandardTypes } f
 import type { Static, TSchema } from "@sinclair/typebox"
 import { type TypeCheck, TypeCompiler } from "@sinclair/typebox/compiler"
 import { Value } from "@sinclair/typebox/value"
+import { ensureDefaultFormats } from "./formats.ts"
 
 /**
  * A `t` schema. It is a Standard Schema (so any nifra route validates it with no
@@ -54,6 +55,10 @@ export function fromTypeBox<T extends TSchema>(schema: T): NifraSchema<T> {
       version: 1,
       vendor: "nifra",
       validate: (value: unknown): StandardResult<Static<T>> => {
+        // Install the standard string formats before the first Compile/Check. Driven from this
+        // reachable path (not a top-level import side effect) so a production bundle can't
+        // tree-shake the registration away — see ./formats.ts. Idempotent, ~free after first call.
+        ensureDefaultFormats()
         if (compiled === undefined && !evalFree) {
           try {
             compiled = TypeCompiler.Compile(schema)

package/src/formats.ts

@@ -9,9 +9,9 @@ import { FormatRegistry } from "@sinclair/typebox"
  *
  * Patterns are pragmatic (not full RFC grammars) but reject obvious garbage. Need a
  * stricter rule or a format not listed here (e.g. `ipv6`, `hostname`)? Register it
- * with {@link registerFormat}. Importing this module performs the registration as a
- * one-time side effect; the `Has` guard means an app that registered its own
- * validator first wins.
+ * with {@link registerFormat}. The defaults are installed lazily by
+ * {@link ensureDefaultFormats} from the validate path; the `Has` guard means an app
+ * that registered its own validator first wins.
  */
 const DEFAULT_FORMATS: Readonly<Record<string, RegExp>> = {
   email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
@@ -28,6 +28,27 @@ export function registerFormat(name: string, validate: (value: string) => boolea
   FormatRegistry.Set(name, validate)
 }
 
-for (const [name, pattern] of Object.entries(DEFAULT_FORMATS)) {
-  if (!FormatRegistry.Has(name)) FormatRegistry.Set(name, (value) => pattern.test(value))
+let defaultsRegistered = false
+
+/**
+ * Install the standard string formats into TypeBox's global `FormatRegistry`, once.
+ *
+ * This is driven from the validate path (see `./adapter.ts`) rather than run as a bare
+ * top-level import side effect *on purpose*: a production bundler (`Bun.build`, esbuild)
+ * tree-shakes a module that is only imported for its effect, and Bun.build does **not**
+ * honor the `sideEffects` package.json field — so the old top-level registration loop was
+ * dropped from prod server bundles, making every `t.string({ format })` reject with
+ * "Unknown format" while unbundled `nifra dev` worked. Calling this from code the validator
+ * actually reaches keeps the registration in the bundle.
+ *
+ * Idempotent and cheap to call on every validate (a single boolean check after the first
+ * run). The `Has` guard means a format a consumer registered first via {@link registerFormat}
+ * is left untouched.
+ */
+export function ensureDefaultFormats(): void {
+  if (defaultsRegistered) return
+  defaultsRegistered = true
+  for (const [name, pattern] of Object.entries(DEFAULT_FORMATS)) {
+    if (!FormatRegistry.Has(name)) FormatRegistry.Set(name, (value) => pattern.test(value))
+  }
 }

package/src/index.ts

@@ -7,8 +7,9 @@
  * a validator; this package is the opt-in default.
  */
 export { fromTypeBox, type NifraSchema } from "./adapter.ts"
-// Re-exporting evaluates ./formats.ts, registering the standard string formats so
-// `t.string({ format })` validates instead of rejecting everything.
+// `registerFormat` adds/overrides a custom string format. The standard formats (email, uuid, …)
+// install themselves lazily from the validate path (see ./adapter.ts) — NOT as an import side
+// effect of this module, which a production bundler would tree-shake away.
 export { registerFormat } from "./formats.ts"
 export { type OpenAPIDocument, type OpenAPIInfo, toOpenAPI } from "./openapi.ts"
 export { t } from "./t.ts"