@ddd-ts-kit/validation 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# @ddd-ts-kit/validation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One `Schema` contract for input validation at the boundary, with adapters for zod,
+class-validator and any Standard Schema library. Routes, DTOs and the OpenAPI generator depend
+on the contract, so the validation library can change without touching them.
+
+Business rules do not belong here: they live in the domain and never import a validation library.
+
+## The contract
+
+```ts
+import { parseOrThrow, type Infer, type Schema } from '@ddd-ts-kit/validation';
+
+interface Schema<T> {
+  parse(input: unknown): Result<T, ValidationIssue[]>;
+  toJsonSchema(): JsonSchema;
+}
+
+type ValidationIssue = { path: string; code: string; message: string }; // path: "items.0.sku"
+```
+
+A schema is a value: one per input, handed to the route or the event that validates with it.
+It is never bound in a container, so it is an interface and not an injectable port (an abstract
+class): there is nothing to declare in a composition root.
+
+- `parse` never throws for an invalid input: it returns `err(issues)`.
+- `parseOrThrow(schema, input)` returns the value or throws a `ValidationError`, a `DomainError`
+  with code `VALIDATION_FAILED` and the `issues`.
+- `Infer<typeof schema>` gives the parsed type.
+- `customSchema(parse, jsonSchema?)` builds a schema from a plain function.
+
+The root entry imports no third-party package. Each adapter lives in its own subpath and its
+library is an optional peer dependency: install only the one you use.
+
+## zod
+
+```sh
+npm i zod
+```
+
+```ts
+import { z } from 'zod';
+import { zodSchema } from '@ddd-ts-kit/validation/zod';
+
+const placeOrder = zodSchema(
+  z.object({
+    customerId: z.string().uuid(),
+    items: z.array(z.object({ sku: z.string().min(1), quantity: z.number().int().positive() })).min(1),
+  }),
+);
+
+const result = placeOrder.parse(input);
+if (!result.ok) {
+  console.log(result.error); // [{ path: 'items.0.sku', code: 'too_small', message: '...' }]
+}
+```
+
+The JSON Schema comes from zod 4's `z.toJSONSchema` (draft 2020-12, usable as is in OpenAPI
+3.1). It describes the input side by default; pass `{ io: 'output' }` for a response body. A
+type JSON Schema cannot represent (a `Date`, a `bigint`) is written as `{}` rather than
+failing the generation.
+
+## class-validator
+
+```sh
+npm i class-validator class-transformer class-validator-jsonschema reflect-metadata
+```
+
+```ts
+import { Type } from 'class-transformer';
+import { ArrayMinSize, IsInt, IsString, IsUUID, Min, ValidateNested } from 'class-validator';
+import { classSchema } from '@ddd-ts-kit/validation/class-validator';
+
+class OrderItemDto {
+  @IsString() sku = '';
+  @IsInt() @Min(1) quantity = 0;
+}
+
+class PlaceOrderDto {
+  @IsUUID() customerId = '';
+
+  @ValidateNested({ each: true })
+  @Type(() => OrderItemDto)
+  @ArrayMinSize(1)
+  items: OrderItemDto[] = [];
+}
+
+const placeOrder = classSchema(PlaceOrderDto);
+```
+
+`parse` returns an instance of the class. `whitelist` and `forbidNonWhitelisted` are on by
+default: an undeclared property is an issue. Override with
+`classSchema(Dto, { validator: { forbidNonWhitelisted: false }, transform: { ... } })`.
+Nested errors are flattened (`items.0.quantity`), one issue per failed constraint, the
+constraint name as `code`. The JSON Schema is draft 2020-12 and carries the nested classes
+reachable from the class under `$defs`.
+
+Requires `experimentalDecorators` in the project's `tsconfig.json`.
+
+## Standard Schema (valibot, arktype, ...)
+
+```ts
+import * as v from 'valibot';
+import { standardSchema } from '@ddd-ts-kit/validation/standard-schema';
+
+const placeOrder = standardSchema(
+  v.object({ customerId: v.pipe(v.string(), v.uuid()) }),
+  // Optional: the JSON Schema of the contract, which this adapter does not derive.
+  { type: 'object', required: ['customerId'], properties: { customerId: { type: 'string', format: 'uuid' } } },
+);
+```
+
+The adapter reads `~standard.validate` of Standard Schema v1 and nothing else: it derives no
+JSON Schema, neither from the library's own exporter nor from the separate Standard JSON
+Schema specification. Give it as the second argument (written by hand, or produced by the
+exporter of your library); without it `toJsonSchema()` returns `{}`, which the OpenAPI
+document shows as "any value". The specification carries no error code, so every issue has
+the code `invalid`. A schema that validates asynchronously makes
+`parse` throw: async schemas are not supported at the boundary.

package/dist/class-validator/class-schema.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+import { type ClassTransformOptions } from 'class-transformer';
+import { type ValidatorOptions } from 'class-validator';
+import type { Schema } from '../schema.js';
+import type { DtoClass } from './dto-class.js';
+export interface ClassSchemaOptions {
+    /** Merged over the defaults `{ whitelist: true, forbidNonWhitelisted: true }`. */
+    readonly validator?: ValidatorOptions;
+    readonly transform?: ClassTransformOptions;
+}
+export declare function classSchema<T extends object>(dto: DtoClass<T>, options?: ClassSchemaOptions): Schema<T>;
+//# sourceMappingURL=class-schema.d.ts.map

package/dist/class-validator/class-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-schema.d.ts","sourceRoot":"","sources":["../../src/class-validator/class-schema.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAA6D,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAAC,CAAC,CAAC,CAoB3G"}

package/dist/class-validator/class-schema.js

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { err, ok } from '@ddd-ts-kit/kernel';
+import { selfContainedSchema } from './self-contained-schema.js';
+export function classSchema(dto, options = {}) {
+    const validatorOptions = {
+        whitelist: true,
+        forbidNonWhitelisted: true,
+        ...options.validator,
+    };
+    return {
+        parse(input) {
+            if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+                return err([{ path: '', code: 'isObject', message: 'An object is expected.' }]);
+            }
+            const instance = plainToInstance(dto, input, options.transform);
+            const errors = validateSync(instance, validatorOptions);
+            return errors.length === 0 ? ok(instance) : err(flatten(errors, ''));
+        },
+        toJsonSchema: () => selfContainedSchema(dto.name),
+    };
+}
+function flatten(errors, parent) {
+    return errors.flatMap((error) => {
+        const path = parent === '' ? error.property : `${parent}.${error.property}`;
+        const own = Object.entries(error.constraints ?? {}).map(([code, message]) => ({
+            path,
+            code,
+            message,
+        }));
+        return [...own, ...flatten(error.children ?? [], path)];
+    });
+}
+//# sourceMappingURL=class-schema.js.map

package/dist/class-validator/class-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-schema.js","sourceRoot":"","sources":["../../src/class-validator/class-schema.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAA8B,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAsE,MAAM,iBAAiB,CAAC;AACnH,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAI7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQjE,MAAM,UAAU,WAAW,CAAmB,GAAgB,EAAE,OAAO,GAAuB,EAAE;IAC9F,MAAM,gBAAgB,GAAqB;QACzC,SAAS,EAAE,IAAI;QACf,oBAAoB,EAAE,IAAI;QAC1B,GAAG,OAAO,CAAC,SAAS;KACrB,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,KAAK;YACT,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxE,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YAExD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,MAAsC,EAAE,MAAc;IACrE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAE5E,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5E,IAAI;YACJ,IAAI;YACJ,OAAO;SACR,CAAC,CAAC,CAAC;QAEJ,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/class-validator/dto-class.d.ts

@@ -0,0 +1,2 @@
+export type DtoClass<T extends object> = new () => T;
+//# sourceMappingURL=dto-class.d.ts.map

package/dist/class-validator/dto-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-class.d.ts","sourceRoot":"","sources":["../../src/class-validator/dto-class.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,CAAC"}

package/dist/class-validator/dto-class.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dto-class.js.map

package/dist/class-validator/dto-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-class.js","sourceRoot":"","sources":["../../src/class-validator/dto-class.ts"],"names":[],"mappings":""}

package/dist/class-validator/self-contained-schema.d.ts

@@ -0,0 +1,4 @@
+import type { JsonSchema } from '../json-schema.js';
+/** The JSON Schema of a class, carrying under `$defs` only the classes reachable from it. */
+export declare function selfContainedSchema(className: string): JsonSchema;
+//# sourceMappingURL=self-contained-schema.d.ts.map

package/dist/class-validator/self-contained-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-contained-schema.d.ts","sourceRoot":"","sources":["../../src/class-validator/self-contained-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAcjE"}

package/dist/class-validator/self-contained-schema.js

@@ -0,0 +1,58 @@
+import { defaultMetadataStorage } from 'class-transformer/cjs/storage.js';
+import { validationMetadatasToSchemas } from 'class-validator-jsonschema';
+const DEFS_POINTER = '#/$defs/';
+/** The JSON Schema of a class, carrying under `$defs` only the classes reachable from it. */
+export function selfContainedSchema(className) {
+    const all = generatedSchemas();
+    const own = all[className] ?? { type: 'object' };
+    const defs = {};
+    collectDefs(own, all, defs);
+    const names = Object.keys(defs).sort();
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        ...own,
+        ...(names.length > 0 ? { $defs: Object.fromEntries(names.map((name) => [name, defs[name]])) } : {}),
+    };
+}
+function generatedSchemas() {
+    const generated = validationMetadatasToSchemas({
+        classTransformerMetadataStorage: defaultMetadataStorage,
+        refPointerPrefix: DEFS_POINTER,
+    });
+    return Object.fromEntries(Object.entries(generated).map(([name, schema]) => [name, { ...schema }]));
+}
+function collectDefs(node, all, defs) {
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            collectDefs(item, all, defs);
+        }
+        return;
+    }
+    if (typeof node !== 'object' || node === null) {
+        return;
+    }
+    for (const [key, value] of Object.entries(node)) {
+        const name = referencedDefinition(key, value);
+        if (name === undefined) {
+            collectDefs(value, all, defs);
+        }
+        else {
+            collectDefinition(name, all, defs);
+        }
+    }
+}
+function referencedDefinition(key, value) {
+    if (key === '$ref' && typeof value === 'string' && value.startsWith(DEFS_POINTER)) {
+        return value.slice(DEFS_POINTER.length);
+    }
+    return undefined;
+}
+function collectDefinition(name, all, defs) {
+    const target = all[name];
+    // The root is carried too when a nested class points back at it.
+    if (target !== undefined && defs[name] === undefined) {
+        defs[name] = target;
+        collectDefs(target, all, defs);
+    }
+}
+//# sourceMappingURL=self-contained-schema.js.map

package/dist/class-validator/self-contained-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-contained-schema.js","sourceRoot":"","sources":["../../src/class-validator/self-contained-schema.ts"],"names":[],"mappings":"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"}

package/dist/class-validator.d.ts

@@ -0,0 +1,3 @@
+export { classSchema, type ClassSchemaOptions } from './class-validator/class-schema.js';
+export type { DtoClass } from './class-validator/dto-class.js';
+//# sourceMappingURL=class-validator.d.ts.map

package/dist/class-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-validator.d.ts","sourceRoot":"","sources":["../src/class-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACzF,YAAY,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/class-validator.js

@@ -0,0 +1,2 @@
+export { classSchema } from './class-validator/class-schema.js';
+//# sourceMappingURL=class-validator.js.map

package/dist/class-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-validator.js","sourceRoot":"","sources":["../src/class-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,mCAAmC,CAAC"}

package/dist/custom-schema.d.ts

@@ -0,0 +1,7 @@
+import type { Result } from '@ddd-ts-kit/kernel';
+import type { JsonSchema } from './json-schema.js';
+import type { Schema } from './schema.js';
+import type { ValidationIssue } from './validation-issue.js';
+/** Builds a schema from a plain function, for hand-written checks and for tests. */
+export declare function customSchema<T>(parse: (input: unknown) => Result<T, ValidationIssue[]>, jsonSchema?: JsonSchema): Schema<T>;
+//# sourceMappingURL=custom-schema.d.ts.map

package/dist/custom-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-schema.d.ts","sourceRoot":"","sources":["../src/custom-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EACvD,UAAU,GAAE,UAAe,GAC1B,MAAM,CAAC,CAAC,CAAC,CAEX"}

package/dist/custom-schema.js

@@ -0,0 +1,5 @@
+/** Builds a schema from a plain function, for hand-written checks and for tests. */
+export function customSchema(parse, jsonSchema = {}) {
+    return { parse, toJsonSchema: () => jsonSchema };
+}
+//# sourceMappingURL=custom-schema.js.map

package/dist/custom-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-schema.js","sourceRoot":"","sources":["../src/custom-schema.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAC1B,KAAuD,EACvD,UAAU,GAAe,EAAE;IAE3B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/dist/format-path.d.ts

@@ -0,0 +1,3 @@
+/** Joins path segments the way every adapter reports them. */
+export declare function formatPath(segments: readonly PropertyKey[]): string;
+//# sourceMappingURL=format-path.d.ts.map

package/dist/format-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-path.d.ts","sourceRoot":"","sources":["../src/format-path.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAEnE"}

package/dist/format-path.js

@@ -0,0 +1,5 @@
+/** Joins path segments the way every adapter reports them. */
+export function formatPath(segments) {
+    return segments.map((segment) => String(segment)).join('.');
+}
+//# sourceMappingURL=format-path.js.map

package/dist/format-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-path.js","sourceRoot":"","sources":["../src/format-path.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,QAAgC;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { customSchema } from './custom-schema.js';
+export { formatPath } from './format-path.js';
+export type { Infer } from './infer.js';
+export type { JsonSchema } from './json-schema.js';
+export { parseOrThrow } from './parse-or-throw.js';
+export type { Schema } from './schema.js';
+export { ValidationError } from './validation-error.js';
+export type { ValidationIssue } from './validation-issue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { customSchema } from './custom-schema.js';
+export { formatPath } from './format-path.js';
+export { parseOrThrow } from './parse-or-throw.js';
+export { ValidationError } from './validation-error.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/infer.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from './schema.js';
+export type Infer<S> = S extends Schema<infer T> ? T : never;
+//# sourceMappingURL=infer.d.ts.map

package/dist/infer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.d.ts","sourceRoot":"","sources":["../src/infer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/infer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=infer.js.map

package/dist/infer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.js","sourceRoot":"","sources":["../src/infer.ts"],"names":[],"mappings":""}

package/dist/json-schema.d.ts

@@ -0,0 +1,2 @@
+export type JsonSchema = Record<string, unknown>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/json-schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-schema.js.map

package/dist/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":""}

package/dist/parse-or-throw.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from './schema.js';
+export declare function parseOrThrow<T>(schema: Schema<T>, input: unknown): T;
+//# sourceMappingURL=parse-or-throw.d.ts.map

package/dist/parse-or-throw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-or-throw.d.ts","sourceRoot":"","sources":["../src/parse-or-throw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAQpE"}

package/dist/parse-or-throw.js

@@ -0,0 +1,9 @@
+import { ValidationError } from './validation-error.js';
+export function parseOrThrow(schema, input) {
+    const result = schema.parse(input);
+    if (result.ok) {
+        return result.value;
+    }
+    throw new ValidationError(result.error);
+}
+//# sourceMappingURL=parse-or-throw.js.map

package/dist/parse-or-throw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-or-throw.js","sourceRoot":"","sources":["../src/parse-or-throw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,YAAY,CAAI,MAAiB,EAAE,KAAc;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,13 @@
+import type { Result } from '@ddd-ts-kit/kernel';
+import type { JsonSchema } from './json-schema.js';
+import type { ValidationIssue } from './validation-issue.js';
+/**
+ * The contract every validation library is adapted to. Presentation code depends on this
+ * interface only, so the library can be swapped without touching routes. A schema is a value
+ * handed to what validates with it, one per input: it is never bound in a container.
+ */
+export interface Schema<T> {
+    parse(input: unknown): Result<T, ValidationIssue[]>;
+    toJsonSchema(): JsonSchema;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC;IAEpD,YAAY,IAAI,UAAU,CAAC;CAC5B"}

package/dist/schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":""}

package/dist/standard-schema/infer-standard-output.d.ts

@@ -0,0 +1,3 @@
+import type { StandardSchemaV1 } from './standard-schema-v1.js';
+export type InferStandardOutput<S extends StandardSchemaV1> = NonNullable<S['~standard']['types']>['output'];
+//# sourceMappingURL=infer-standard-output.d.ts.map

package/dist/standard-schema/infer-standard-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-standard-output.d.ts","sourceRoot":"","sources":["../../src/standard-schema/infer-standard-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC"}

package/dist/standard-schema/infer-standard-output.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=infer-standard-output.js.map

package/dist/standard-schema/infer-standard-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-standard-output.js","sourceRoot":"","sources":["../../src/standard-schema/infer-standard-output.ts"],"names":[],"mappings":""}

package/dist/standard-schema/standard-schema-v1.d.ts

@@ -0,0 +1,25 @@
+/** The subset of the Standard Schema v1 specification this adapter relies on. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+    };
+}
+export type StandardSchemaResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: readonly StandardSchemaIssue[];
+};
+export interface StandardSchemaIssue {
+    readonly message: string;
+    readonly path?: readonly (PropertyKey | {
+        readonly key: PropertyKey;
+    })[] | undefined;
+}
+//# sourceMappingURL=standard-schema-v1.d.ts.map

package/dist/standard-schema/standard-schema-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema-v1.d.ts","sourceRoot":"","sources":["../../src/standard-schema/standard-schema-v1.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,oBAAoB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5G,QAAQ,CAAC,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;KACjF,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,CAAC,MAAM,IACnC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG;QAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC,EAAE,GAAG,SAAS,CAAC;CACtF"}

package/dist/standard-schema/standard-schema-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standard-schema-v1.js.map

package/dist/standard-schema/standard-schema-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema-v1.js","sourceRoot":"","sources":["../../src/standard-schema/standard-schema-v1.ts"],"names":[],"mappings":""}

package/dist/standard-schema/standard-schema.d.ts

@@ -0,0 +1,10 @@
+import type { JsonSchema } from '../json-schema.js';
+import type { Schema } from '../schema.js';
+import type { InferStandardOutput } from './infer-standard-output.js';
+import type { StandardSchemaV1 } from './standard-schema-v1.js';
+/**
+ * Standard Schema has no JSON Schema export, so the contract side is supplied by the caller
+ * and defaults to `{}` (any value).
+ */
+export declare function standardSchema<S extends StandardSchemaV1>(schema: S, jsonSchema?: JsonSchema): Schema<InferStandardOutput<S>>;
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/standard-schema/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../src/standard-schema/standard-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAA6C,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3G;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EACvD,MAAM,EAAE,CAAC,EACT,UAAU,GAAE,UAAe,GAC1B,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAkBhC"}

package/dist/standard-schema/standard-schema.js

@@ -0,0 +1,32 @@
+import { err, ok } from '@ddd-ts-kit/kernel';
+import { formatPath } from '../format-path.js';
+/**
+ * Standard Schema has no JSON Schema export, so the contract side is supplied by the caller
+ * and defaults to `{}` (any value).
+ */
+export function standardSchema(schema, jsonSchema = {}) {
+    return {
+        parse(input) {
+            const result = schema['~standard'].validate(input);
+            if (result instanceof Promise) {
+                // The verdict is discarded, its rejection must not surface as unhandled.
+                result.catch(() => undefined);
+                throw new Error(`The "${schema['~standard'].vendor}" schema validates asynchronously: async schemas are not supported at the boundary.`);
+            }
+            return verdictOf(result);
+        },
+        toJsonSchema: () => jsonSchema,
+    };
+}
+function verdictOf(result) {
+    if (result.issues === undefined) {
+        return ok(result.value);
+    }
+    return err(result.issues.map(issueOf));
+}
+function issueOf(issue) {
+    const segments = (issue.path ?? []).map((segment) => (typeof segment === 'object' ? segment.key : segment));
+    // The specification carries no machine-readable code.
+    return { path: formatPath(segments), code: 'invalid', message: issue.message };
+}
+//# sourceMappingURL=standard-schema.js.map

package/dist/standard-schema/standard-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.js","sourceRoot":"","sources":["../../src/standard-schema/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO/C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAS,EACT,UAAU,GAAe,EAAE;IAE3B,OAAO;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEnD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,yEAAyE;gBACzE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAE9B,MAAM,IAAI,KAAK,CACb,QAAQ,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,qFAAqF,CACxH,CAAC;YACJ,CAAC;YAED,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAS,MAAoC;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,OAAO,CAAC,KAA0B;IACzC,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5G,sDAAsD;IACtD,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AACjF,CAAC"}

package/dist/standard-schema.d.ts

@@ -0,0 +1,4 @@
+export type { InferStandardOutput } from './standard-schema/infer-standard-output.js';
+export type { StandardSchemaIssue, StandardSchemaResult, StandardSchemaV1, } from './standard-schema/standard-schema-v1.js';
+export { standardSchema } from './standard-schema/standard-schema.js';
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACtF,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/standard-schema.js

@@ -0,0 +1,2 @@
+export { standardSchema } from './standard-schema/standard-schema.js';
+//# sourceMappingURL=standard-schema.js.map

package/dist/standard-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.js","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/validation-error.d.ts

@@ -0,0 +1,8 @@
+import { DomainError } from '@ddd-ts-kit/kernel';
+import type { ValidationIssue } from './validation-issue.js';
+export declare class ValidationError extends DomainError {
+    readonly code = "VALIDATION_FAILED";
+    readonly issues: readonly ValidationIssue[];
+    constructor(issues: readonly ValidationIssue[], message?: string);
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,IAAI,uBAAuB;IAEpC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAE5C,YAAY,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,OAAO,SAA4B,EAGlF;CACF"}

package/dist/validation-error.js

@@ -0,0 +1,10 @@
+import { DomainError } from '@ddd-ts-kit/kernel';
+export class ValidationError extends DomainError {
+    code = 'VALIDATION_FAILED';
+    issues;
+    constructor(issues, message = 'The input is not valid.') {
+        super(message);
+        this.issues = issues;
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACrC,IAAI,GAAG,mBAAmB,CAAC;IAE3B,MAAM,CAA6B;IAE5C,YAAY,MAAkC,EAAE,OAAO,GAAG,yBAAyB;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/validation-issue.d.ts

@@ -0,0 +1,7 @@
+/** `path` is dotted (`items.0.sku`); the empty string designates the input itself. */
+export type ValidationIssue = {
+    path: string;
+    code: string;
+    message: string;
+};
+//# sourceMappingURL=validation-issue.d.ts.map

package/dist/validation-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-issue.d.ts","sourceRoot":"","sources":["../src/validation-issue.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/validation-issue.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation-issue.js.map

package/dist/validation-issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-issue.js","sourceRoot":"","sources":["../src/validation-issue.ts"],"names":[],"mappings":""}

package/dist/zod/zod-schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { Schema } from '../schema.js';
+export interface ZodSchemaOptions {
+    /**
+     * Which side of the schema the JSON Schema describes. `input` (default) documents what a
+     * client sends: fields with a default are optional. Use `output` for response bodies.
+     */
+    readonly io?: 'input' | 'output';
+}
+export declare function zodSchema<Z extends z.ZodType>(type: Z, options?: ZodSchemaOptions): Schema<z.output<Z>>;
+//# sourceMappingURL=zod-schema.d.ts.map

package/dist/zod/zod-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.d.ts","sourceRoot":"","sources":["../../src/zod/zod-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAClC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CA0B3G"}

package/dist/zod/zod-schema.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { err, ok } from '@ddd-ts-kit/kernel';
+import { formatPath } from '../format-path.js';
+export function zodSchema(type, options = {}) {
+    return {
+        parse(input) {
+            const result = type.safeParse(input);
+            if (result.success) {
+                return ok(result.data);
+            }
+            return err(result.error.issues.map((issue) => ({
+                path: formatPath(issue.path),
+                code: issue.code,
+                message: issue.message,
+            })));
+        },
+        toJsonSchema() {
+            return z.toJSONSchema(type, {
+                target: 'draft-2020-12',
+                io: options.io ?? 'input',
+                // A contract generator must not crash on a Date or a bigint: they degrade to `{}`.
+                unrepresentable: 'any',
+            });
+        },
+    };
+}
+//# sourceMappingURL=zod-schema.js.map

package/dist/zod/zod-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.js","sourceRoot":"","sources":["../../src/zod/zod-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAY/C,MAAM,UAAU,SAAS,CAAsB,IAAO,EAAE,OAAO,GAAqB,EAAE;IACpF,OAAO;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAErC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YAED,OAAO,GAAG,CACR,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAClC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QACD,YAAY;YACV,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE;gBAC1B,MAAM,EAAE,eAAe;gBACvB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,OAAO;gBACzB,mFAAmF;gBACnF,eAAe,EAAE,KAAK;aACvB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/zod.d.ts

@@ -0,0 +1,2 @@
+export { zodSchema, type ZodSchemaOptions } from './zod/zod-schema.js';
+//# sourceMappingURL=zod.d.ts.map

package/dist/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/zod.js

@@ -0,0 +1,2 @@
+export { zodSchema } from './zod/zod-schema.js';
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@ddd-ts-kit/validation",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "One Schema contract for input validation, with adapters for zod, class-validator and Standard Schema.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/validation"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/validation#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./zod": {
+      "types": "./dist/zod.d.ts",
+      "default": "./dist/zod.js"
+    },
+    "./class-validator": {
+      "types": "./dist/class-validator.d.ts",
+      "default": "./dist/class-validator.js"
+    },
+    "./standard-schema": {
+      "types": "./dist/standard-schema.d.ts",
+      "default": "./dist/standard-schema.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ddd-ts-kit/kernel": "0.1.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0",
+    "class-validator": ">=0.14.0",
+    "class-transformer": ">=0.5.0",
+    "class-validator-jsonschema": ">=5.0.0",
+    "reflect-metadata": ">=0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    },
+    "class-validator": {
+      "optional": true
+    },
+    "class-transformer": {
+      "optional": true
+    },
+    "class-validator-jsonschema": {
+      "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "zod": "^4.6.5",
+    "class-validator": "^0.15.1",
+    "class-transformer": "^0.5.1",
+    "class-validator-jsonschema": "^5.0.0",
+    "reflect-metadata": "^0.2.2",
+    "valibot": "^1.0.0"
+  }
+}