@ddd-ts-kit/validation 0.12.0 → 0.13.0

package/README.md

@@ -1,7 +1,7 @@
 # @ddd-ts-kit/validation
 
 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
+class-validator, TypeBox 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.
@@ -29,6 +29,8 @@ class): there is nothing to declare in a composition root.
 - `Infer<typeof schema>` gives the parsed type.
 - `customSchema(parse, jsonSchema?)` builds a schema from a plain function.
 
+- `sharedSchema(name, schema)` documents a schema once, under `name` (see [shared schemas](#shared-schemas)).
+
 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.
 
@@ -97,6 +99,53 @@ reachable from the class under `$defs`.
 
 Requires `experimentalDecorators` in the project's `tsconfig.json`.
 
+A DTO class declared once is reused whole (`classSchema(SlotDto, { shared: true })`, or nested
+with `@ValidateNested()` and `@Type`), extended (`class BookBody extends SlotDto { ... }`) or in
+part, through three helpers that copy the constraints, the nested types and the transformations
+of the properties they keep:
+
+```ts
+import { omitClass, partialClass, pickClass } from '@ddd-ts-kit/validation/class-validator';
+
+class RescheduleBody extends pickClass(AppointmentDto, ['startsAt', 'endsAt']) {}
+class BookBody extends omitClass(AppointmentDto, ['status']) {}
+class EditPatientBody extends partialClass(PatientDto) {} // every property optional, checked when present
+```
+
+The class that extends a helper names the shape in the contract. Picking a property that carries
+no constraint is refused: validation would strip it as unknown. A derived class nested in
+another one through `@Type` declares at least one property of its own: class-validator-jsonschema
+documents a class only from its own decorators.
+
+## TypeBox
+
+```sh
+npm i typebox
+```
+
+```ts
+import Type from 'typebox';
+import { typeboxSchema } from '@ddd-ts-kit/validation/typebox';
+
+const slot = Type.Object({ startsAt: Type.String({ format: 'date-time' }), minutes: Type.Integer({ default: 30 }) }, { $id: 'Slot' });
+const book = typeboxSchema(Type.Object({ patientId: Type.String({ minLength: 1 }), slot }));
+const page = typeboxSchema(Type.Object({ limit: Type.Integer() }), { coerce: true }); // query strings
+```
+
+The schema is compiled once (`typebox/compile`). `parse` fills the defaults and drops the
+properties the schema does not declare, as zod does, then checks; the issue code is the JSON
+Schema keyword that failed (`required`, `format`, `minLength`...). `{ coerce: true }` converts
+text to the declared types first, for path parameters and query strings. A TypeBox schema is
+JSON Schema already: `toJsonSchema()` returns it, a nested schema built with an `$id` moved
+under `$defs` and referenced, so it lands once in the contract; a schema with its own `$id` is
+shared. A missing property is reported at its own path (`slot.startsAt`), as zod reports it, and
+two different schemas under one `$id` are refused. `Type.Pick`, `Type.Omit` and `Type.Partial`
+reuse a schema in part, as a new shape; `Type.Intersect([slot, Type.Object({...})])` extends it
+and keeps the shared part a reference (`allOf: [{ $ref: Slot }, ...]`), while
+`Type.Interface([slot], {...})` writes a new flat shape. (`Type.Composite` belongs to
+`@sinclair/typebox` 0.34 and does not exist in TypeBox 1.)
+Written for the `typebox` package, version 1 (the successor of `@sinclair/typebox`).
+
 ## Standard Schema (valibot, arktype, ...)
 
 ```ts
@@ -110,10 +159,43 @@ const placeOrder = standardSchema(
 );
 ```
 
-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
+The adapter validates with `~standard.validate` of Standard Schema v1. The JSON Schema of the
+contract is the second argument when it is given (written by hand, or produced by the exporter of
+your library); otherwise the one the library converts itself when it implements the companion
+specification, Standard JSON Schema v1 (`~standard.jsonSchema`; verified with zod 4, while arktype
+and valibot through `toStandardJsonSchema` of `@valibot/to-json-schema` announce it but are not
+verified here), input side by default and `standardSchema(schema, undefined, { io: 'output' })`
+for a response; otherwise `{}`, which the OpenAPI document shows as "any value". A schema the
+library cannot write as JSON Schema (zod refuses `z.date()`, `z.coerce.date()`, `z.custom`) is
+documented `{}` as well: pass its JSON Schema as the second argument. 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.
+
+## Shared schemas
+
+A schema several routes use is declared once and documented once: the OpenAPI generator of
+`@ddd-ts-kit/http` writes it in `components.schemas` and points at it with `$ref` from every
+route, whole or nested. A schema is shared when its JSON Schema is a reference to one of its own
+definitions (`{ $ref: '#/$defs/Slot', $defs: { Slot: ... } }`), the form each library reaches its
+own way:
+
+```ts
+// zod: an id in its metadata, kept when the schema is nested in another one
+const slot = z.object({ startsAt: z.iso.datetime(), endsAt: z.iso.datetime() }).meta({ id: 'Slot' });
+const reschedule = zodSchema(slot);
+const book = zodSchema(z.object({ patientId: z.uuid(), slot }));
+
+// class-validator: the name of the class
+const patient = classSchema(PatientDto, { shared: true });
+
+// TypeBox: an $id in its options, kept when the schema is nested in another one
+const money = Type.Object({ cents: Type.Integer(), currency: Type.String() }, { $id: 'Money' });
+
+// any schema, the Standard Schema ones included
+const amount = sharedSchema('Amount', standardSchema(amountSchema));
+```
+
+`sharedNameOf(jsonSchema)` answers the name a JSON Schema is shared under, if any. A shared
+schema of the presentation layer lives where `generate schema` writes it: under
+`presentation/http/schemas/` of its context, or under `presentation/` of the shared kernel when
+several contexts answer with it; never in the domain.

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

@@ -7,6 +7,11 @@ export interface ClassSchemaOptions {
     /** Merged over the defaults `{ whitelist: true, forbidNonWhitelisted: true }`. */
     readonly validator?: ValidatorOptions;
     readonly transform?: ClassTransformOptions;
+    /**
+     * Documented once, under the name of the class: the contract holds it in `components.schemas`
+     * and every route that uses it refers to it, as it already does for a nested class.
+     */
+    readonly shared?: boolean;
 }
 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

@@ -1 +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"}
+{"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;IAC3C;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;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

@@ -18,7 +18,7 @@ export function classSchema(dto, options = {}) {
             const errors = validateSync(instance, validatorOptions);
             return errors.length === 0 ? ok(instance) : err(flatten(errors, ''));
         },
-        toJsonSchema: () => selfContainedSchema(dto.name),
+        toJsonSchema: () => selfContainedSchema(dto, options.shared === true),
     };
 }
 function flatten(errors, parent) {

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

@@ -1 +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"}
+{"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;AAajE,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,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;KACtE,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/copy-class-metadata.d.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import type { DtoClass } from './dto-class.js';
+/**
+ * Copies onto `target` what class-validator and class-transformer know of each property of
+ * `source`, its ancestors included, that `keeps` accepts: the constraints, the nested type, the
+ * transformations and the reflected type. Answers the properties copied.
+ */
+export declare function copyClassMetadata(source: DtoClass<object>, target: DtoClass<object>, keeps: (property: string) => boolean): string[];
+//# sourceMappingURL=copy-class-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy-class-metadata.d.ts","sourceRoot":"","sources":["../../src/class-validator/copy-class-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAS/C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GACnC,MAAM,EAAE,CAiBV"}

package/dist/class-validator/copy-class-metadata.js

@@ -0,0 +1,52 @@
+import 'reflect-metadata';
+import { TransformationType } from 'class-transformer';
+import { defaultMetadataStorage } from 'class-transformer/cjs/storage.js';
+import { getMetadataStorage } from 'class-validator';
+import { prototypeOf } from './prototype-of.js';
+const TRANSFORMATIONS = [
+    TransformationType.PLAIN_TO_CLASS,
+    TransformationType.CLASS_TO_PLAIN,
+    TransformationType.CLASS_TO_CLASS,
+];
+/**
+ * Copies onto `target` what class-validator and class-transformer know of each property of
+ * `source`, its ancestors included, that `keeps` accepts: the constraints, the nested type, the
+ * transformations and the reflected type. Answers the properties copied.
+ */
+export function copyClassMetadata(source, target, keeps) {
+    const storage = getMetadataStorage();
+    const copied = new Set();
+    for (const metadata of storage.getTargetValidationMetadatas(source, '', true, false)) {
+        if (keeps(metadata.propertyName)) {
+            storage.addValidationMetadata(Object.assign({}, metadata, { target }));
+            copied.add(metadata.propertyName);
+        }
+    }
+    for (const property of copied) {
+        copyTransformations(source, target, property);
+        copyReflectedType(source, target, property);
+    }
+    return [...copied];
+}
+function copyTransformations(source, target, property) {
+    const type = typeMetadataOf(source, property);
+    if (type !== undefined) {
+        defaultMetadataStorage.addTypeMetadata({ ...type, target });
+    }
+    for (const transformation of TRANSFORMATIONS) {
+        for (const transform of defaultMetadataStorage.findTransformMetadatas(source, property, transformation)) {
+            defaultMetadataStorage.addTransformMetadata({ ...transform, target });
+        }
+    }
+}
+/** class-transformer answers `undefined` for a property without `@Type`, which its declaration does not say. */
+function typeMetadataOf(source, property) {
+    return defaultMetadataStorage.findTypeMetadata(source, property);
+}
+function copyReflectedType(source, target, property) {
+    const reflected = Reflect.getMetadata('design:type', prototypeOf(source), property);
+    if (reflected !== undefined) {
+        Reflect.defineMetadata('design:type', reflected, prototypeOf(target), property);
+    }
+}
+//# sourceMappingURL=copy-class-metadata.js.map

package/dist/class-validator/copy-class-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-class-metadata.js","sourceRoot":"","sources":["../../src/class-validator/copy-class-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAqB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,eAAe,GAAG;IACtB,kBAAkB,CAAC,cAAc;IACjC,kBAAkB,CAAC,cAAc;IACjC,kBAAkB,CAAC,cAAc;CAClC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,MAAwB,EACxB,KAAoC;IAEpC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,4BAA4B,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACrF,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAwB,EAAE,MAAwB,EAAE,QAAgB;IAC/F,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,sBAAsB,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,KAAK,MAAM,SAAS,IAAI,sBAAsB,CAAC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;YACxG,sBAAsB,CAAC,oBAAoB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,SAAS,cAAc,CAAC,MAAwB,EAAE,QAAgB;IAChE,OAAO,sBAAsB,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwB,EAAE,MAAwB,EAAE,QAAgB;IAC7F,MAAM,SAAS,GAAY,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE7F,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC;AACH,CAAC"}

package/dist/class-validator/declared-properties.d.ts

@@ -0,0 +1,4 @@
+import type { DtoClass } from './dto-class.js';
+/** The properties of a class, its ancestors included, that carry at least one class-validator decorator. */
+export declare function declaredProperties(dto: DtoClass<object>): Set<string>;
+//# sourceMappingURL=declared-properties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declared-properties.d.ts","sourceRoot":"","sources":["../../src/class-validator/declared-properties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAMrE"}

package/dist/class-validator/declared-properties.js

@@ -0,0 +1,8 @@
+import { getMetadataStorage } from 'class-validator';
+/** The properties of a class, its ancestors included, that carry at least one class-validator decorator. */
+export function declaredProperties(dto) {
+    return new Set(getMetadataStorage()
+        .getTargetValidationMetadatas(dto, '', true, false)
+        .map((metadata) => metadata.propertyName));
+}
+//# sourceMappingURL=declared-properties.js.map

package/dist/class-validator/declared-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declared-properties.js","sourceRoot":"","sources":["../../src/class-validator/declared-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,4GAA4G;AAC5G,MAAM,UAAU,kBAAkB,CAAC,GAAqB;IACtD,OAAO,IAAI,GAAG,CACZ,kBAAkB,EAAE;SACjB,4BAA4B,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC;SAClD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC5C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { DtoClass } from './dto-class.js';
+/**
+ * A new class, named `name`, that validates and documents the properties of `base` that `keeps`
+ * accepts, and nothing else. It is meant to be extended by a class of the presentation layer,
+ * which gives it its name in the contract: `class CancelBody extends pickClass(...) {}`.
+ */
+export declare function derivedClass<T extends object>(base: DtoClass<object>, name: string, keeps: (property: string) => boolean): DtoClass<T>;
+//# sourceMappingURL=derived-class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derived-class.d.ts","sourceRoot":"","sources":["../../src/class-validator/derived-class.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GACnC,QAAQ,CAAC,CAAC,CAAC,CAeb"}

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

@@ -0,0 +1,25 @@
+import { DeclarationError } from '@ddd-ts-kit/kernel/declarations';
+import { copyClassMetadata } from './copy-class-metadata.js';
+import { declaredProperties } from './declared-properties.js';
+/**
+ * A new class, named `name`, that validates and documents the properties of `base` that `keeps`
+ * accepts, and nothing else. It is meant to be extended by a class of the presentation layer,
+ * which gives it its name in the contract: `class CancelBody extends pickClass(...) {}`.
+ */
+export function derivedClass(base, name, keeps) {
+    const derived = class {
+    };
+    // Two derived classes of one name would merge in class-validator-jsonschema, which groups by name.
+    Object.defineProperty(derived, 'name', { value: name });
+    const copied = copyClassMetadata(base, derived, keeps);
+    if (!validatesAs(derived, copied)) {
+        throw new DeclarationError(`${name} keeps no property of ${base.name} that carries a constraint: there is nothing to validate.`);
+    }
+    return derived;
+}
+/** True once the class carries a constraint for some property, and for every one copied: it then parses into a `T`. */
+function validatesAs(derived, copied) {
+    const declared = declaredProperties(derived);
+    return copied.length > 0 && copied.every((property) => declared.has(property));
+}
+//# sourceMappingURL=derived-class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"derived-class.js","sourceRoot":"","sources":["../../src/class-validator/derived-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAsB,EACtB,IAAY,EACZ,KAAoC;IAEpC,MAAM,OAAO,GAAG;KAAQ,CAAC;IAEzB,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAEvD,IAAI,CAAC,WAAW,CAAI,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,gBAAgB,CACxB,GAAG,IAAI,yBAAyB,IAAI,CAAC,IAAI,2DAA2D,CACrG,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uHAAuH;AACvH,SAAS,WAAW,CAAmB,OAAyB,EAAE,MAAyB;IACzF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE7C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DtoClass } from './dto-class.js';
+/** Every property of a DTO class but `keys`, with their constraints, as a class to extend. */
+export declare function omitClass<T extends object, K extends keyof T & string>(base: DtoClass<T>, keys: readonly K[]): DtoClass<Omit<T, K>>;
+//# sourceMappingURL=omit-class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omit-class.d.ts","sourceRoot":"","sources":["../../src/class-validator/omit-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACpE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAMtB"}

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

@@ -0,0 +1,6 @@
+import { derivedClass } from './derived-class.js';
+/** Every property of a DTO class but `keys`, with their constraints, as a class to extend. */
+export function omitClass(base, keys) {
+    return derivedClass(base, `${base.name}_omit_${keys.join('_')}`, (property) => !keys.some((key) => key === property));
+}
+//# sourceMappingURL=omit-class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omit-class.js","sourceRoot":"","sources":["../../src/class-validator/omit-class.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,8FAA8F;AAC9F,MAAM,UAAU,SAAS,CACvB,IAAiB,EACjB,IAAkB;IAElB,OAAO,YAAY,CACjB,IAAI,EACJ,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EACrC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CACpD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { DtoClass } from './dto-class.js';
+/**
+ * Every property of a DTO class, each optional and checked by its constraints when present, as
+ * a class to extend: the body of a partial update, `class EditBody extends partialClass(PatientDto) {}`.
+ */
+export declare function partialClass<T extends object>(base: DtoClass<T>): DtoClass<Partial<T>>;
+//# sourceMappingURL=partial-class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"partial-class.d.ts","sourceRoot":"","sources":["../../src/class-validator/partial-class.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAStF"}

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

@@ -0,0 +1,17 @@
+import { IsOptional } from 'class-validator';
+import { declaredProperties } from './declared-properties.js';
+import { derivedClass } from './derived-class.js';
+import { prototypeOf } from './prototype-of.js';
+/**
+ * Every property of a DTO class, each optional and checked by its constraints when present, as
+ * a class to extend: the body of a partial update, `class EditBody extends partialClass(PatientDto) {}`.
+ */
+export function partialClass(base) {
+    const partial = derivedClass(base, `${base.name}_partial`, () => true);
+    const optional = IsOptional();
+    for (const property of declaredProperties(base)) {
+        optional(prototypeOf(partial), property);
+    }
+    return partial;
+}
+//# sourceMappingURL=partial-class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"partial-class.js","sourceRoot":"","sources":["../../src/class-validator/partial-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAmB,IAAiB;IAC9D,MAAM,OAAO,GAAG,YAAY,CAAa,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAE9B,KAAK,MAAM,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { DtoClass } from './dto-class.js';
+/**
+ * The properties `keys` of a DTO class, with their constraints, as a class to extend:
+ * `class RescheduleBody extends pickClass(AppointmentDto, ['startsAt', 'endsAt']) {}`.
+ */
+export declare function pickClass<T extends object, K extends keyof T & string>(base: DtoClass<T>, keys: readonly K[]): DtoClass<Pick<T, K>>;
+//# sourceMappingURL=pick-class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pick-class.d.ts","sourceRoot":"","sources":["../../src/class-validator/pick-class.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EACpE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,IAAI,EAAE,SAAS,CAAC,EAAE,GACjB,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAatB"}

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

@@ -0,0 +1,16 @@
+import { DeclarationError } from '@ddd-ts-kit/kernel/declarations';
+import { declaredProperties } from './declared-properties.js';
+import { derivedClass } from './derived-class.js';
+/**
+ * The properties `keys` of a DTO class, with their constraints, as a class to extend:
+ * `class RescheduleBody extends pickClass(AppointmentDto, ['startsAt', 'endsAt']) {}`.
+ */
+export function pickClass(base, keys) {
+    const declared = declaredProperties(base);
+    const undeclared = keys.filter((key) => !declared.has(key));
+    if (undeclared.length > 0) {
+        throw new DeclarationError(`${base.name} declares no constraint on ${undeclared.join(', ')}: picked, the property would be stripped as unknown. Decorate it in ${base.name} (@IsString(), @Allow(), ...).`);
+    }
+    return derivedClass(base, `${base.name}_pick_${keys.join('_')}`, (property) => keys.some((key) => key === property));
+}
+//# sourceMappingURL=pick-class.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pick-class.js","sourceRoot":"","sources":["../../src/class-validator/pick-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,IAAiB,EACjB,IAAkB;IAElB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,gBAAgB,CACxB,GAAG,IAAI,CAAC,IAAI,8BAA8B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,uEAAuE,IAAI,CAAC,IAAI,gCAAgC,CAChL,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAa,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CACxF,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/dist/class-validator/prototype-of.d.ts

@@ -0,0 +1,4 @@
+import type { DtoClass } from './dto-class.js';
+/** The object the instances of a class inherit from, where decorators record their metadata. */
+export declare function prototypeOf(dto: DtoClass<object>): object;
+//# sourceMappingURL=prototype-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-of.d.ts","sourceRoot":"","sources":["../../src/class-validator/prototype-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAIzD"}

package/dist/class-validator/prototype-of.js

@@ -0,0 +1,6 @@
+/** The object the instances of a class inherit from, where decorators record their metadata. */
+export function prototypeOf(dto) {
+    const { prototype } = dto;
+    return typeof prototype === 'object' && prototype !== null ? prototype : {};
+}
+//# sourceMappingURL=prototype-of.js.map

package/dist/class-validator/prototype-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-of.js","sourceRoot":"","sources":["../../src/class-validator/prototype-of.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,GAAqB;IAC/C,MAAM,EAAE,SAAS,EAAE,GAAoC,GAAG,CAAC;IAE3D,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}

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

@@ -1,4 +1,8 @@
 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;
+import type { DtoClass } from './dto-class.js';
+/**
+ * The JSON Schema of a class, carrying under `$defs` only the classes reachable from it. Shared,
+ * the class itself is one of them and the schema is a reference to it.
+ */
+export declare function selfContainedSchema(dto: DtoClass<object>, shared: boolean): JsonSchema;
 //# sourceMappingURL=self-contained-schema.d.ts.map

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

@@ -1 +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"}
+{"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;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,CActF"}

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

@@ -1,26 +1,41 @@
 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) {
+import { DEFINITIONS_POINTER } from '../shared/definitions-pointer.js';
+/**
+ * The JSON Schema of a class, carrying under `$defs` only the classes reachable from it. Shared,
+ * the class itself is one of them and the schema is a reference to it.
+ */
+export function selfContainedSchema(dto, shared) {
     const all = generatedSchemas();
-    const own = all[className] ?? { type: 'object' };
-    const defs = {};
+    const own = ownSchema(dto, all);
+    const defs = shared ? { [dto.name]: own } : {};
     collectDefs(own, all, defs);
     const names = Object.keys(defs).sort();
     return {
         $schema: 'https://json-schema.org/draft/2020-12/schema',
-        ...own,
+        ...(shared ? { $ref: `${DEFINITIONS_POINTER}${dto.name}` } : own),
         ...(names.length > 0 ? { $defs: Object.fromEntries(names.map((name) => [name, defs[name]])) } : {}),
     };
 }
 function generatedSchemas() {
     const generated = validationMetadatasToSchemas({
         classTransformerMetadataStorage: defaultMetadataStorage,
-        refPointerPrefix: DEFS_POINTER,
+        refPointerPrefix: DEFINITIONS_POINTER,
     });
     return Object.fromEntries(Object.entries(generated).map(([name, schema]) => [name, { ...schema }]));
 }
+/** A class that declares nothing itself (`class Body extends pickClass(...) {}`) is described by its nearest described ancestor. */
+function ownSchema(dto, all) {
+    let ancestor = dto;
+    while (typeof ancestor === 'function' && ancestor.name !== '') {
+        const described = all[ancestor.name];
+        if (described !== undefined) {
+            return described;
+        }
+        ancestor = Object.getPrototypeOf(ancestor);
+    }
+    return { type: 'object' };
+}
 function collectDefs(node, all, defs) {
     if (Array.isArray(node)) {
         for (const item of node) {
@@ -42,8 +57,8 @@ function collectDefs(node, all, defs) {
     }
 }
 function referencedDefinition(key, value) {
-    if (key === '$ref' && typeof value === 'string' && value.startsWith(DEFS_POINTER)) {
-        return value.slice(DEFS_POINTER.length);
+    if (key === '$ref' && typeof value === 'string' && value.startsWith(DEFINITIONS_POINTER)) {
+        return value.slice(DEFINITIONS_POINTER.length);
     }
     return undefined;
 }

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

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

@@ -1,3 +1,6 @@
 export { classSchema, type ClassSchemaOptions } from './class-validator/class-schema.js';
 export type { DtoClass } from './class-validator/dto-class.js';
+export { omitClass } from './class-validator/omit-class.js';
+export { partialClass } from './class-validator/partial-class.js';
+export { pickClass } from './class-validator/pick-class.js';
 //# sourceMappingURL=class-validator.d.ts.map

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

@@ -1 +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"}
+{"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;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/class-validator.js

@@ -1,2 +1,5 @@
 export { classSchema } from './class-validator/class-schema.js';
+export { omitClass } from './class-validator/omit-class.js';
+export { partialClass } from './class-validator/partial-class.js';
+export { pickClass } from './class-validator/pick-class.js';
 //# sourceMappingURL=class-validator.js.map

package/dist/class-validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"class-validator.js","sourceRoot":"","sources":["../src/class-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"class-validator.js","sourceRoot":"","sources":["../src/class-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,mCAAmC,CAAC;AAEzF,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,8 @@ 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 { sharedNameOf } from './shared/shared-name-of.js';
+export { sharedSchema } from './shared/shared-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

@@ -1 +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"}
+{"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,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

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

package/dist/index.js.map

@@ -1 +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"}
+{"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,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/shared/definitions-pointer.d.ts

@@ -0,0 +1,3 @@
+/** Where a JSON Schema of this package points at a schema it carries under `$defs`. */
+export declare const DEFINITIONS_POINTER = "#/$defs/";
+//# sourceMappingURL=definitions-pointer.d.ts.map

package/dist/shared/definitions-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions-pointer.d.ts","sourceRoot":"","sources":["../../src/shared/definitions-pointer.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,aAAa,CAAC"}

package/dist/shared/definitions-pointer.js

@@ -0,0 +1,3 @@
+/** Where a JSON Schema of this package points at a schema it carries under `$defs`. */
+export const DEFINITIONS_POINTER = '#/$defs/';
+//# sourceMappingURL=definitions-pointer.js.map

package/dist/shared/definitions-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions-pointer.js","sourceRoot":"","sources":["../../src/shared/definitions-pointer.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC"}

package/dist/shared/is-record.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=is-record.d.ts.map

package/dist/shared/is-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record.d.ts","sourceRoot":"","sources":["../../src/shared/is-record.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}