@cosmneo/onion-lasagna-typebox 0.2.0

package/dist/index.cjs

@@ -0,0 +1,130 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Type: () => import_typebox.Type,
+  pagination: () => pagination,
+  typeboxSchema: () => typeboxSchema
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/typebox.adapter.ts
+var import_value = require("@sinclair/typebox/value");
+var import_typebox = require("@sinclair/typebox");
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    if (typeof value === "object" && value !== null) {
+      return "[Complex Object]";
+    }
+    if (typeof value === "bigint") {
+      return String(value);
+    }
+    return String(value);
+  }
+}
+function typeboxSchema(schema) {
+  return {
+    validate(data) {
+      if (!import_value.Value.Check(schema, data)) {
+        const errors = [...import_value.Value.Errors(schema, data)];
+        return {
+          success: false,
+          issues: errors.map((error) => ({
+            // TypeBox paths are like '/property/nested' - convert to array
+            path: error.path.split("/").filter(Boolean),
+            message: error.message,
+            code: error.type ? String(error.type) : void 0,
+            // Use safeStringify to handle circular references and non-serializable values
+            expected: error.schema ? safeStringify(error.schema) : void 0,
+            received: error.value !== void 0 ? safeStringify(error.value) : void 0
+          }))
+        };
+      }
+      try {
+        const decoded = import_value.Value.Decode(schema, data);
+        return { success: true, data: decoded };
+      } catch (error) {
+        return {
+          success: false,
+          issues: [
+            {
+              path: [],
+              message: error instanceof Error ? error.message : "Transform decode failed",
+              code: "transform_error"
+            }
+          ]
+        };
+      }
+    },
+    toJsonSchema(_options) {
+      return structuredClone(schema);
+    },
+    _output: void 0,
+    _input: void 0,
+    _schema: schema
+  };
+}
+
+// src/schemas/pagination.ts
+var import_typebox2 = require("@sinclair/typebox");
+var pagination = {
+  /**
+   * Query params schema for paginated list requests.
+   *
+   * Uses JSON Schema `default` annotations. Coercion from query string
+   * values is handled by the framework (e.g., Fastify).
+   *
+   * @example
+   * ```typescript
+   * // Direct use
+   * typeboxSchema(pagination.input)
+   *
+   * // Extended with filters
+   * typeboxSchema(Type.Intersect([
+   *   pagination.input,
+   *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),
+   * ]))
+   * ```
+   */
+  input: import_typebox2.Type.Object({
+    page: import_typebox2.Type.Optional(import_typebox2.Type.Integer({ minimum: 1, default: 1 })),
+    pageSize: import_typebox2.Type.Optional(import_typebox2.Type.Integer({ minimum: 1, maximum: 100, default: 10 }))
+  }),
+  /**
+   * Factory for paginated response schemas.
+   *
+   * @param itemSchema - TypeBox schema for individual items in the list
+   * @returns TypeBox schema for `{ items: T[], total: number }`
+   */
+  response: (itemSchema) => import_typebox2.Type.Object({
+    items: import_typebox2.Type.Array(itemSchema),
+    total: import_typebox2.Type.Integer({ minimum: 0 })
+  })
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Type,
+  pagination,
+  typeboxSchema
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/typebox.adapter.ts","../src/schemas/pagination.ts"],"sourcesContent":["export { typeboxSchema, Type } from './typebox.adapter';\nexport { pagination } from './schemas/pagination';\n","/**\n * @fileoverview TypeBox schema adapter for the unified route system.\n *\n * TypeBox is unique among validation libraries because its schemas ARE\n * JSON Schema. This makes it ideal for OpenAPI generation with zero\n * conversion overhead.\n *\n * @module unified/schema/adapters/typebox\n */\n\nimport type { Static, StaticEncode, TSchema } from '@sinclair/typebox';\nimport { Value } from '@sinclair/typebox/value';\nimport type {\n  JsonSchema,\n  JsonSchemaOptions,\n  SchemaAdapter,\n  ValidationResult,\n} from '@cosmneo/onion-lasagna/http/schema/types';\n\n/**\n * Safely stringifies a value for error reporting.\n * Returns undefined if stringification fails (e.g., circular references, BigInt).\n */\nfunction safeStringify(value: unknown): string | undefined {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    // Handle circular references, BigInt, or other non-serializable values\n    if (typeof value === 'object' && value !== null) {\n      return '[Complex Object]';\n    }\n    if (typeof value === 'bigint') {\n      return String(value);\n    }\n    return String(value);\n  }\n}\n\n/**\n * Creates a SchemaAdapter from a TypeBox schema.\n *\n * TypeBox schemas are JSON Schema, so `toJsonSchema()` simply returns\n * the schema itself (with optional cleanup). This makes TypeBox the most\n * efficient choice when OpenAPI generation is a priority.\n *\n * @typeParam T - A TypeBox schema type\n *\n * @param schema - A TypeBox schema to wrap\n * @returns A SchemaAdapter that validates using TypeBox and returns the schema as JSON Schema\n *\n * @example Basic usage\n * ```typescript\n * import { Type } from '@sinclair/typebox';\n * import { typeboxSchema } from '@cosmneo/onion-lasagna-typebox';\n *\n * const userSchema = typeboxSchema(Type.Object({\n *   name: Type.String({ minLength: 1, maxLength: 100 }),\n *   email: Type.String({ format: 'email' }),\n *   age: Type.Optional(Type.Integer({ minimum: 0, maximum: 150 })),\n * }));\n *\n * // Validate data\n * const result = userSchema.validate({\n *   name: 'John Doe',\n *   email: 'john@example.com',\n * });\n *\n * if (result.success) {\n *   console.log(result.data); // { name: 'John Doe', email: 'john@example.com' }\n * }\n *\n * // Get JSON Schema (this IS the TypeBox schema!)\n * const jsonSchema = userSchema.toJsonSchema();\n * ```\n *\n * @example Complex types\n * ```typescript\n * const orderSchema = typeboxSchema(Type.Object({\n *   id: Type.String({ format: 'uuid' }),\n *   items: Type.Array(Type.Object({\n *     productId: Type.String(),\n *     quantity: Type.Integer({ minimum: 1 }),\n *     price: Type.Number({ minimum: 0 }),\n *   })),\n *   status: Type.Union([\n *     Type.Literal('pending'),\n *     Type.Literal('processing'),\n *     Type.Literal('shipped'),\n *     Type.Literal('delivered'),\n *   ]),\n *   createdAt: Type.String({ format: 'date-time' }),\n * }));\n * ```\n */\nexport function typeboxSchema<T extends TSchema>(\n  schema: T,\n): SchemaAdapter<Static<T>, StaticEncode<T>> {\n  return {\n    validate(data: unknown): ValidationResult<Static<T>> {\n      if (!Value.Check(schema, data)) {\n        // Collect all validation errors\n        const errors = [...Value.Errors(schema, data)];\n\n        return {\n          success: false,\n          issues: errors.map((error) => ({\n            // TypeBox paths are like '/property/nested' - convert to array\n            path: error.path.split('/').filter(Boolean),\n            message: error.message,\n            code: error.type ? String(error.type) : undefined,\n            // Use safeStringify to handle circular references and non-serializable values\n            expected: error.schema ? safeStringify(error.schema) : undefined,\n            received: error.value !== undefined ? safeStringify(error.value) : undefined,\n          })),\n        };\n      }\n\n      // Apply transforms if any (no-op when schema has no transforms)\n      try {\n        const decoded = Value.Decode(schema, data);\n        return { success: true, data: decoded };\n      } catch (error) {\n        return {\n          success: false,\n          issues: [\n            {\n              path: [],\n              message: error instanceof Error ? error.message : 'Transform decode failed',\n              code: 'transform_error',\n            },\n          ],\n        };\n      }\n    },\n\n    toJsonSchema(_options?: JsonSchemaOptions): JsonSchema {\n      // Deep clone to prevent mutation and strip TypeBox-specific\n      // Symbol-keyed metadata ([Kind], etc.), producing clean JSON Schema\n      return structuredClone(schema) as JsonSchema;\n    },\n\n    _output: undefined as Static<T>,\n    _input: undefined as StaticEncode<T>,\n    _schema: schema,\n  };\n}\n\n/**\n * Re-export TypeBox Type for convenience.\n * Users can import TypeBox functionality from this module.\n */\nexport { Type } from '@sinclair/typebox';\n","/**\n * @fileoverview Pre-built TypeBox pagination schemas.\n *\n * Provides reusable schemas for paginated list endpoints,\n * matching the core `PaginationInput` and `PaginatedData<T>` types.\n *\n * TypeBox uses JSON Schema `default` annotations for default values.\n * Frameworks like Fastify handle coercion from strings natively via JSON Schema.\n *\n * @module schemas/pagination\n */\n\nimport { Type, type TSchema } from '@sinclair/typebox';\n\nexport const pagination = {\n  /**\n   * Query params schema for paginated list requests.\n   *\n   * Uses JSON Schema `default` annotations. Coercion from query string\n   * values is handled by the framework (e.g., Fastify).\n   *\n   * @example\n   * ```typescript\n   * // Direct use\n   * typeboxSchema(pagination.input)\n   *\n   * // Extended with filters\n   * typeboxSchema(Type.Intersect([\n   *   pagination.input,\n   *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),\n   * ]))\n   * ```\n   */\n  input: Type.Object({\n    page: Type.Optional(Type.Integer({ minimum: 1, default: 1 })),\n    pageSize: Type.Optional(Type.Integer({ minimum: 1, maximum: 100, default: 10 })),\n  }),\n\n  /**\n   * Factory for paginated response schemas.\n   *\n   * @param itemSchema - TypeBox schema for individual items in the list\n   * @returns TypeBox schema for `{ items: T[], total: number }`\n   */\n  response: <T extends TSchema>(itemSchema: T) =>\n    Type.Object({\n      items: Type.Array(itemSchema),\n      total: Type.Integer({ minimum: 0 }),\n    }),\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWA,mBAAsB;AA4ItB,qBAAqB;AAhIrB,SAAS,cAAc,OAAoC;AACzD,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AAEN,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,aAAO;AAAA,IACT;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,KAAK;AAAA,IACrB;AACA,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AA0DO,SAAS,cACd,QAC2C;AAC3C,SAAO;AAAA,IACL,SAAS,MAA4C;AACnD,UAAI,CAAC,mBAAM,MAAM,QAAQ,IAAI,GAAG;AAE9B,cAAM,SAAS,CAAC,GAAG,mBAAM,OAAO,QAAQ,IAAI,CAAC;AAE7C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ,OAAO,IAAI,CAAC,WAAW;AAAA;AAAA,YAE7B,MAAM,MAAM,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,YAC1C,SAAS,MAAM;AAAA,YACf,MAAM,MAAM,OAAO,OAAO,MAAM,IAAI,IAAI;AAAA;AAAA,YAExC,UAAU,MAAM,SAAS,cAAc,MAAM,MAAM,IAAI;AAAA,YACvD,UAAU,MAAM,UAAU,SAAY,cAAc,MAAM,KAAK,IAAI;AAAA,UACrE,EAAE;AAAA,QACJ;AAAA,MACF;AAGA,UAAI;AACF,cAAM,UAAU,mBAAM,OAAO,QAAQ,IAAI;AACzC,eAAO,EAAE,SAAS,MAAM,MAAM,QAAQ;AAAA,MACxC,SAAS,OAAO;AACd,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ;AAAA,YACN;AAAA,cACE,MAAM,CAAC;AAAA,cACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,cAClD,MAAM;AAAA,YACR;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,aAAa,UAA0C;AAGrD,aAAO,gBAAgB,MAAM;AAAA,IAC/B;AAAA,IAEA,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AACF;;;ACrIA,IAAAA,kBAAmC;AAE5B,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBxB,OAAO,qBAAK,OAAO;AAAA,IACjB,MAAM,qBAAK,SAAS,qBAAK,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC;AAAA,IAC5D,UAAU,qBAAK,SAAS,qBAAK,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,SAAS,GAAG,CAAC,CAAC;AAAA,EACjF,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQD,UAAU,CAAoB,eAC5B,qBAAK,OAAO;AAAA,IACV,OAAO,qBAAK,MAAM,UAAU;AAAA,IAC5B,OAAO,qBAAK,QAAQ,EAAE,SAAS,EAAE,CAAC;AAAA,EACpC,CAAC;AACL;","names":["import_typebox"]}

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+import * as _sinclair_typebox from '@sinclair/typebox';
+import { TSchema, Static, StaticEncode } from '@sinclair/typebox';
+export { Type } from '@sinclair/typebox';
+import { SchemaAdapter } from '@cosmneo/onion-lasagna/http/schema/types';
+
+/**
+ * @fileoverview TypeBox schema adapter for the unified route system.
+ *
+ * TypeBox is unique among validation libraries because its schemas ARE
+ * JSON Schema. This makes it ideal for OpenAPI generation with zero
+ * conversion overhead.
+ *
+ * @module unified/schema/adapters/typebox
+ */
+
+/**
+ * Creates a SchemaAdapter from a TypeBox schema.
+ *
+ * TypeBox schemas are JSON Schema, so `toJsonSchema()` simply returns
+ * the schema itself (with optional cleanup). This makes TypeBox the most
+ * efficient choice when OpenAPI generation is a priority.
+ *
+ * @typeParam T - A TypeBox schema type
+ *
+ * @param schema - A TypeBox schema to wrap
+ * @returns A SchemaAdapter that validates using TypeBox and returns the schema as JSON Schema
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Type } from '@sinclair/typebox';
+ * import { typeboxSchema } from '@cosmneo/onion-lasagna-typebox';
+ *
+ * const userSchema = typeboxSchema(Type.Object({
+ *   name: Type.String({ minLength: 1, maxLength: 100 }),
+ *   email: Type.String({ format: 'email' }),
+ *   age: Type.Optional(Type.Integer({ minimum: 0, maximum: 150 })),
+ * }));
+ *
+ * // Validate data
+ * const result = userSchema.validate({
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.data); // { name: 'John Doe', email: 'john@example.com' }
+ * }
+ *
+ * // Get JSON Schema (this IS the TypeBox schema!)
+ * const jsonSchema = userSchema.toJsonSchema();
+ * ```
+ *
+ * @example Complex types
+ * ```typescript
+ * const orderSchema = typeboxSchema(Type.Object({
+ *   id: Type.String({ format: 'uuid' }),
+ *   items: Type.Array(Type.Object({
+ *     productId: Type.String(),
+ *     quantity: Type.Integer({ minimum: 1 }),
+ *     price: Type.Number({ minimum: 0 }),
+ *   })),
+ *   status: Type.Union([
+ *     Type.Literal('pending'),
+ *     Type.Literal('processing'),
+ *     Type.Literal('shipped'),
+ *     Type.Literal('delivered'),
+ *   ]),
+ *   createdAt: Type.String({ format: 'date-time' }),
+ * }));
+ * ```
+ */
+declare function typeboxSchema<T extends TSchema>(schema: T): SchemaAdapter<Static<T>, StaticEncode<T>>;
+
+declare const pagination: {
+    /**
+     * Query params schema for paginated list requests.
+     *
+     * Uses JSON Schema `default` annotations. Coercion from query string
+     * values is handled by the framework (e.g., Fastify).
+     *
+     * @example
+     * ```typescript
+     * // Direct use
+     * typeboxSchema(pagination.input)
+     *
+     * // Extended with filters
+     * typeboxSchema(Type.Intersect([
+     *   pagination.input,
+     *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),
+     * ]))
+     * ```
+     */
+    input: _sinclair_typebox.TObject<{
+        page: _sinclair_typebox.TOptional<_sinclair_typebox.TInteger>;
+        pageSize: _sinclair_typebox.TOptional<_sinclair_typebox.TInteger>;
+    }>;
+    /**
+     * Factory for paginated response schemas.
+     *
+     * @param itemSchema - TypeBox schema for individual items in the list
+     * @returns TypeBox schema for `{ items: T[], total: number }`
+     */
+    response: <T extends TSchema>(itemSchema: T) => _sinclair_typebox.TObject<{
+        items: _sinclair_typebox.TArray<T>;
+        total: _sinclair_typebox.TInteger;
+    }>;
+};
+
+export { pagination, typeboxSchema };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import * as _sinclair_typebox from '@sinclair/typebox';
+import { TSchema, Static, StaticEncode } from '@sinclair/typebox';
+export { Type } from '@sinclair/typebox';
+import { SchemaAdapter } from '@cosmneo/onion-lasagna/http/schema/types';
+
+/**
+ * @fileoverview TypeBox schema adapter for the unified route system.
+ *
+ * TypeBox is unique among validation libraries because its schemas ARE
+ * JSON Schema. This makes it ideal for OpenAPI generation with zero
+ * conversion overhead.
+ *
+ * @module unified/schema/adapters/typebox
+ */
+
+/**
+ * Creates a SchemaAdapter from a TypeBox schema.
+ *
+ * TypeBox schemas are JSON Schema, so `toJsonSchema()` simply returns
+ * the schema itself (with optional cleanup). This makes TypeBox the most
+ * efficient choice when OpenAPI generation is a priority.
+ *
+ * @typeParam T - A TypeBox schema type
+ *
+ * @param schema - A TypeBox schema to wrap
+ * @returns A SchemaAdapter that validates using TypeBox and returns the schema as JSON Schema
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Type } from '@sinclair/typebox';
+ * import { typeboxSchema } from '@cosmneo/onion-lasagna-typebox';
+ *
+ * const userSchema = typeboxSchema(Type.Object({
+ *   name: Type.String({ minLength: 1, maxLength: 100 }),
+ *   email: Type.String({ format: 'email' }),
+ *   age: Type.Optional(Type.Integer({ minimum: 0, maximum: 150 })),
+ * }));
+ *
+ * // Validate data
+ * const result = userSchema.validate({
+ *   name: 'John Doe',
+ *   email: 'john@example.com',
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.data); // { name: 'John Doe', email: 'john@example.com' }
+ * }
+ *
+ * // Get JSON Schema (this IS the TypeBox schema!)
+ * const jsonSchema = userSchema.toJsonSchema();
+ * ```
+ *
+ * @example Complex types
+ * ```typescript
+ * const orderSchema = typeboxSchema(Type.Object({
+ *   id: Type.String({ format: 'uuid' }),
+ *   items: Type.Array(Type.Object({
+ *     productId: Type.String(),
+ *     quantity: Type.Integer({ minimum: 1 }),
+ *     price: Type.Number({ minimum: 0 }),
+ *   })),
+ *   status: Type.Union([
+ *     Type.Literal('pending'),
+ *     Type.Literal('processing'),
+ *     Type.Literal('shipped'),
+ *     Type.Literal('delivered'),
+ *   ]),
+ *   createdAt: Type.String({ format: 'date-time' }),
+ * }));
+ * ```
+ */
+declare function typeboxSchema<T extends TSchema>(schema: T): SchemaAdapter<Static<T>, StaticEncode<T>>;
+
+declare const pagination: {
+    /**
+     * Query params schema for paginated list requests.
+     *
+     * Uses JSON Schema `default` annotations. Coercion from query string
+     * values is handled by the framework (e.g., Fastify).
+     *
+     * @example
+     * ```typescript
+     * // Direct use
+     * typeboxSchema(pagination.input)
+     *
+     * // Extended with filters
+     * typeboxSchema(Type.Intersect([
+     *   pagination.input,
+     *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),
+     * ]))
+     * ```
+     */
+    input: _sinclair_typebox.TObject<{
+        page: _sinclair_typebox.TOptional<_sinclair_typebox.TInteger>;
+        pageSize: _sinclair_typebox.TOptional<_sinclair_typebox.TInteger>;
+    }>;
+    /**
+     * Factory for paginated response schemas.
+     *
+     * @param itemSchema - TypeBox schema for individual items in the list
+     * @returns TypeBox schema for `{ items: T[], total: number }`
+     */
+    response: <T extends TSchema>(itemSchema: T) => _sinclair_typebox.TObject<{
+        items: _sinclair_typebox.TArray<T>;
+        total: _sinclair_typebox.TInteger;
+    }>;
+};
+
+export { pagination, typeboxSchema };

package/dist/index.js

@@ -0,0 +1,101 @@
+// src/typebox.adapter.ts
+import { Value } from "@sinclair/typebox/value";
+import { Type } from "@sinclair/typebox";
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    if (typeof value === "object" && value !== null) {
+      return "[Complex Object]";
+    }
+    if (typeof value === "bigint") {
+      return String(value);
+    }
+    return String(value);
+  }
+}
+function typeboxSchema(schema) {
+  return {
+    validate(data) {
+      if (!Value.Check(schema, data)) {
+        const errors = [...Value.Errors(schema, data)];
+        return {
+          success: false,
+          issues: errors.map((error) => ({
+            // TypeBox paths are like '/property/nested' - convert to array
+            path: error.path.split("/").filter(Boolean),
+            message: error.message,
+            code: error.type ? String(error.type) : void 0,
+            // Use safeStringify to handle circular references and non-serializable values
+            expected: error.schema ? safeStringify(error.schema) : void 0,
+            received: error.value !== void 0 ? safeStringify(error.value) : void 0
+          }))
+        };
+      }
+      try {
+        const decoded = Value.Decode(schema, data);
+        return { success: true, data: decoded };
+      } catch (error) {
+        return {
+          success: false,
+          issues: [
+            {
+              path: [],
+              message: error instanceof Error ? error.message : "Transform decode failed",
+              code: "transform_error"
+            }
+          ]
+        };
+      }
+    },
+    toJsonSchema(_options) {
+      return structuredClone(schema);
+    },
+    _output: void 0,
+    _input: void 0,
+    _schema: schema
+  };
+}
+
+// src/schemas/pagination.ts
+import { Type as Type2 } from "@sinclair/typebox";
+var pagination = {
+  /**
+   * Query params schema for paginated list requests.
+   *
+   * Uses JSON Schema `default` annotations. Coercion from query string
+   * values is handled by the framework (e.g., Fastify).
+   *
+   * @example
+   * ```typescript
+   * // Direct use
+   * typeboxSchema(pagination.input)
+   *
+   * // Extended with filters
+   * typeboxSchema(Type.Intersect([
+   *   pagination.input,
+   *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),
+   * ]))
+   * ```
+   */
+  input: Type2.Object({
+    page: Type2.Optional(Type2.Integer({ minimum: 1, default: 1 })),
+    pageSize: Type2.Optional(Type2.Integer({ minimum: 1, maximum: 100, default: 10 }))
+  }),
+  /**
+   * Factory for paginated response schemas.
+   *
+   * @param itemSchema - TypeBox schema for individual items in the list
+   * @returns TypeBox schema for `{ items: T[], total: number }`
+   */
+  response: (itemSchema) => Type2.Object({
+    items: Type2.Array(itemSchema),
+    total: Type2.Integer({ minimum: 0 })
+  })
+};
+export {
+  Type,
+  pagination,
+  typeboxSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/typebox.adapter.ts","../src/schemas/pagination.ts"],"sourcesContent":["/**\n * @fileoverview TypeBox schema adapter for the unified route system.\n *\n * TypeBox is unique among validation libraries because its schemas ARE\n * JSON Schema. This makes it ideal for OpenAPI generation with zero\n * conversion overhead.\n *\n * @module unified/schema/adapters/typebox\n */\n\nimport type { Static, StaticEncode, TSchema } from '@sinclair/typebox';\nimport { Value } from '@sinclair/typebox/value';\nimport type {\n  JsonSchema,\n  JsonSchemaOptions,\n  SchemaAdapter,\n  ValidationResult,\n} from '@cosmneo/onion-lasagna/http/schema/types';\n\n/**\n * Safely stringifies a value for error reporting.\n * Returns undefined if stringification fails (e.g., circular references, BigInt).\n */\nfunction safeStringify(value: unknown): string | undefined {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    // Handle circular references, BigInt, or other non-serializable values\n    if (typeof value === 'object' && value !== null) {\n      return '[Complex Object]';\n    }\n    if (typeof value === 'bigint') {\n      return String(value);\n    }\n    return String(value);\n  }\n}\n\n/**\n * Creates a SchemaAdapter from a TypeBox schema.\n *\n * TypeBox schemas are JSON Schema, so `toJsonSchema()` simply returns\n * the schema itself (with optional cleanup). This makes TypeBox the most\n * efficient choice when OpenAPI generation is a priority.\n *\n * @typeParam T - A TypeBox schema type\n *\n * @param schema - A TypeBox schema to wrap\n * @returns A SchemaAdapter that validates using TypeBox and returns the schema as JSON Schema\n *\n * @example Basic usage\n * ```typescript\n * import { Type } from '@sinclair/typebox';\n * import { typeboxSchema } from '@cosmneo/onion-lasagna-typebox';\n *\n * const userSchema = typeboxSchema(Type.Object({\n *   name: Type.String({ minLength: 1, maxLength: 100 }),\n *   email: Type.String({ format: 'email' }),\n *   age: Type.Optional(Type.Integer({ minimum: 0, maximum: 150 })),\n * }));\n *\n * // Validate data\n * const result = userSchema.validate({\n *   name: 'John Doe',\n *   email: 'john@example.com',\n * });\n *\n * if (result.success) {\n *   console.log(result.data); // { name: 'John Doe', email: 'john@example.com' }\n * }\n *\n * // Get JSON Schema (this IS the TypeBox schema!)\n * const jsonSchema = userSchema.toJsonSchema();\n * ```\n *\n * @example Complex types\n * ```typescript\n * const orderSchema = typeboxSchema(Type.Object({\n *   id: Type.String({ format: 'uuid' }),\n *   items: Type.Array(Type.Object({\n *     productId: Type.String(),\n *     quantity: Type.Integer({ minimum: 1 }),\n *     price: Type.Number({ minimum: 0 }),\n *   })),\n *   status: Type.Union([\n *     Type.Literal('pending'),\n *     Type.Literal('processing'),\n *     Type.Literal('shipped'),\n *     Type.Literal('delivered'),\n *   ]),\n *   createdAt: Type.String({ format: 'date-time' }),\n * }));\n * ```\n */\nexport function typeboxSchema<T extends TSchema>(\n  schema: T,\n): SchemaAdapter<Static<T>, StaticEncode<T>> {\n  return {\n    validate(data: unknown): ValidationResult<Static<T>> {\n      if (!Value.Check(schema, data)) {\n        // Collect all validation errors\n        const errors = [...Value.Errors(schema, data)];\n\n        return {\n          success: false,\n          issues: errors.map((error) => ({\n            // TypeBox paths are like '/property/nested' - convert to array\n            path: error.path.split('/').filter(Boolean),\n            message: error.message,\n            code: error.type ? String(error.type) : undefined,\n            // Use safeStringify to handle circular references and non-serializable values\n            expected: error.schema ? safeStringify(error.schema) : undefined,\n            received: error.value !== undefined ? safeStringify(error.value) : undefined,\n          })),\n        };\n      }\n\n      // Apply transforms if any (no-op when schema has no transforms)\n      try {\n        const decoded = Value.Decode(schema, data);\n        return { success: true, data: decoded };\n      } catch (error) {\n        return {\n          success: false,\n          issues: [\n            {\n              path: [],\n              message: error instanceof Error ? error.message : 'Transform decode failed',\n              code: 'transform_error',\n            },\n          ],\n        };\n      }\n    },\n\n    toJsonSchema(_options?: JsonSchemaOptions): JsonSchema {\n      // Deep clone to prevent mutation and strip TypeBox-specific\n      // Symbol-keyed metadata ([Kind], etc.), producing clean JSON Schema\n      return structuredClone(schema) as JsonSchema;\n    },\n\n    _output: undefined as Static<T>,\n    _input: undefined as StaticEncode<T>,\n    _schema: schema,\n  };\n}\n\n/**\n * Re-export TypeBox Type for convenience.\n * Users can import TypeBox functionality from this module.\n */\nexport { Type } from '@sinclair/typebox';\n","/**\n * @fileoverview Pre-built TypeBox pagination schemas.\n *\n * Provides reusable schemas for paginated list endpoints,\n * matching the core `PaginationInput` and `PaginatedData<T>` types.\n *\n * TypeBox uses JSON Schema `default` annotations for default values.\n * Frameworks like Fastify handle coercion from strings natively via JSON Schema.\n *\n * @module schemas/pagination\n */\n\nimport { Type, type TSchema } from '@sinclair/typebox';\n\nexport const pagination = {\n  /**\n   * Query params schema for paginated list requests.\n   *\n   * Uses JSON Schema `default` annotations. Coercion from query string\n   * values is handled by the framework (e.g., Fastify).\n   *\n   * @example\n   * ```typescript\n   * // Direct use\n   * typeboxSchema(pagination.input)\n   *\n   * // Extended with filters\n   * typeboxSchema(Type.Intersect([\n   *   pagination.input,\n   *   Type.Object({ searchTerm: Type.Optional(Type.String()) }),\n   * ]))\n   * ```\n   */\n  input: Type.Object({\n    page: Type.Optional(Type.Integer({ minimum: 1, default: 1 })),\n    pageSize: Type.Optional(Type.Integer({ minimum: 1, maximum: 100, default: 10 })),\n  }),\n\n  /**\n   * Factory for paginated response schemas.\n   *\n   * @param itemSchema - TypeBox schema for individual items in the list\n   * @returns TypeBox schema for `{ items: T[], total: number }`\n   */\n  response: <T extends TSchema>(itemSchema: T) =>\n    Type.Object({\n      items: Type.Array(itemSchema),\n      total: Type.Integer({ minimum: 0 }),\n    }),\n};\n"],"mappings":";AAWA,SAAS,aAAa;AA4ItB,SAAS,YAAY;AAhIrB,SAAS,cAAc,OAAoC;AACzD,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,QAAQ;AAEN,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,aAAO;AAAA,IACT;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO,OAAO,KAAK;AAAA,IACrB;AACA,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AA0DO,SAAS,cACd,QAC2C;AAC3C,SAAO;AAAA,IACL,SAAS,MAA4C;AACnD,UAAI,CAAC,MAAM,MAAM,QAAQ,IAAI,GAAG;AAE9B,cAAM,SAAS,CAAC,GAAG,MAAM,OAAO,QAAQ,IAAI,CAAC;AAE7C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ,OAAO,IAAI,CAAC,WAAW;AAAA;AAAA,YAE7B,MAAM,MAAM,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,YAC1C,SAAS,MAAM;AAAA,YACf,MAAM,MAAM,OAAO,OAAO,MAAM,IAAI,IAAI;AAAA;AAAA,YAExC,UAAU,MAAM,SAAS,cAAc,MAAM,MAAM,IAAI;AAAA,YACvD,UAAU,MAAM,UAAU,SAAY,cAAc,MAAM,KAAK,IAAI;AAAA,UACrE,EAAE;AAAA,QACJ;AAAA,MACF;AAGA,UAAI;AACF,cAAM,UAAU,MAAM,OAAO,QAAQ,IAAI;AACzC,eAAO,EAAE,SAAS,MAAM,MAAM,QAAQ;AAAA,MACxC,SAAS,OAAO;AACd,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ;AAAA,YACN;AAAA,cACE,MAAM,CAAC;AAAA,cACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,cAClD,MAAM;AAAA,YACR;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,aAAa,UAA0C;AAGrD,aAAO,gBAAgB,MAAM;AAAA,IAC/B;AAAA,IAEA,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AACF;;;ACrIA,SAAS,QAAAA,aAA0B;AAE5B,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBxB,OAAOA,MAAK,OAAO;AAAA,IACjB,MAAMA,MAAK,SAASA,MAAK,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC;AAAA,IAC5D,UAAUA,MAAK,SAASA,MAAK,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,SAAS,GAAG,CAAC,CAAC;AAAA,EACjF,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQD,UAAU,CAAoB,eAC5BA,MAAK,OAAO;AAAA,IACV,OAAOA,MAAK,MAAM,UAAU;AAAA,IAC5B,OAAOA,MAAK,QAAQ,EAAE,SAAS,EAAE,CAAC;AAAA,EACpC,CAAC;AACL;","names":["Type"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@cosmneo/onion-lasagna-typebox",
+  "version": "0.2.0",
+  "description": "TypeBox schema adapter for onion-lasagna",
+  "type": "module",
+  "license": "MIT",
+  "author": "Cosmneo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cosmneo/onion-lasagna.git",
+    "directory": "packages/schemas/onion-lasagna-typebox"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@sinclair/typebox": "^0.34.41",
+    "@cosmneo/onion-lasagna": "workspace:*",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "@sinclair/typebox": "^0.34.41",
+    "@cosmneo/onion-lasagna": ">=0.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "prepublishOnly": "bun run build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}