@fluojs/core 1.0.0-beta.1

package/dist/metadata/shared.js

@@ -0,0 +1,231 @@
+import { fallbackClone } from '../utils.js';
+
+/**
+ * Generic metadata bag shape used by the TC39 `Symbol.metadata` integration points.
+ */
+
+const symbolWithMetadata = Symbol;
+/**
+ * Active symbol key used to read and write standard metadata bags.
+ */
+export let metadataSymbol = symbolWithMetadata.metadata ?? Symbol.for('fluo.symbol.metadata');
+
+/**
+ * Ensures `Symbol.metadata` exists and returns the symbol used by Fluo metadata helpers.
+ *
+ * @returns The resolved metadata symbol.
+ */
+export function ensureMetadataSymbol() {
+  if (symbolWithMetadata.metadata) {
+    metadataSymbol = symbolWithMetadata.metadata;
+    return metadataSymbol;
+  }
+  Object.defineProperty(Symbol, 'metadata', {
+    configurable: true,
+    value: metadataSymbol
+  });
+  return metadataSymbol;
+}
+void ensureMetadataSymbol();
+function isPlainObject(value) {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+/**
+ * Clones mutable metadata payloads before storing or returning them from shared metadata helpers.
+ *
+ * @param value Metadata value to clone defensively.
+ * @returns A detached clone for supported mutable shapes, or the original value for immutable references.
+ */
+export function cloneMutableValue(value) {
+  if (Array.isArray(value) || value instanceof Date || value instanceof Map || value instanceof Set || isPlainObject(value)) {
+    return fallbackClone(value);
+  }
+  return value;
+}
+
+/**
+ * Canonical symbol keys for metadata emitted through the standard decorator metadata bag.
+ */
+export const standardMetadataKeys = {
+  classValidation: Symbol.for('fluo.standard.class-validation'),
+  controller: Symbol.for('fluo.standard.controller'),
+  dtoFieldBinding: Symbol.for('fluo.standard.dto-binding'),
+  dtoFieldValidation: Symbol.for('fluo.standard.dto-validation'),
+  injection: Symbol.for('fluo.standard.injection'),
+  route: Symbol.for('fluo.standard.route')
+};
+
+/**
+ * Canonical symbol keys for Fluo-owned metadata stores.
+ */
+export const metadataKeys = {
+  module: Symbol.for('fluo.metadata.module'),
+  controller: Symbol.for('fluo.metadata.controller'),
+  route: Symbol.for('fluo.metadata.route'),
+  dtoFieldBinding: Symbol.for('fluo.metadata.dto-field-binding'),
+  dtoFieldValidation: Symbol.for('fluo.metadata.dto-field-validation'),
+  injection: Symbol.for('fluo.metadata.injection'),
+  classDi: Symbol.for('fluo.metadata.class-di'),
+  classValidation: Symbol.for('fluo.metadata.class-validation')
+};
+
+/**
+ * Clones a readonly collection into a mutable array for defensive metadata reads and writes.
+ *
+ * @param collection Collection to clone.
+ * @returns A cloned mutable array, or `undefined` when the collection is absent.
+ */
+export function cloneCollection(collection) {
+  return collection ? collection.map(value => cloneMutableValue(value)) : undefined;
+}
+
+/**
+ * Looks up or creates a property-keyed metadata map for a target object.
+ *
+ * @param store WeakMap-backed metadata store.
+ * @param target Target object that owns the metadata map.
+ * @returns The existing or newly created metadata map for the target.
+ */
+export function getOrCreatePropertyMap(store, target) {
+  let map = store.get(target);
+  if (!map) {
+    map = new Map();
+    store.set(target, map);
+  }
+  return map;
+}
+
+/**
+ * Merges two arrays into a single deduplicated array, preserving insertion order.
+ * Deduplication uses reference equality (===), so two objects with identical shapes
+ * are treated as distinct entries unless they are the exact same reference.
+ * Returns `undefined` when both inputs are empty or absent.
+ *
+ * @param existing Existing values in insertion order.
+ * @param values Additional values to merge.
+ * @returns A deduplicated merged array, or `undefined` when both inputs are empty.
+ */
+export function mergeUnique(existing, values) {
+  if (!existing?.length && !values?.length) {
+    return undefined;
+  }
+  const merged = [...(existing ?? [])];
+  const seen = new Set(merged);
+  for (const value of values ?? []) {
+    if (!seen.has(value)) {
+      seen.add(value);
+      merged.push(value);
+    }
+  }
+  return merged;
+}
+
+/**
+ * Reads the standard metadata bag stored directly on a target.
+ *
+ * @param target Target object that may own standard metadata.
+ * @returns The metadata bag when present, otherwise `undefined`.
+ */
+export function getStandardMetadataBag(target) {
+  const metadata = Reflect.get(target, metadataSymbol);
+  if (typeof metadata !== 'object' || metadata === null) {
+    return undefined;
+  }
+  return metadata;
+}
+
+/**
+ * Reads the standard metadata bag stored on a target's constructor.
+ *
+ * @param target Instance or prototype whose constructor metadata should be inspected.
+ * @returns The constructor metadata bag when present, otherwise `undefined`.
+ */
+export function getStandardConstructorMetadataBag(target) {
+  const constructor = target.constructor;
+  return constructor ? getStandardMetadataBag(constructor) : undefined;
+}
+
+/**
+ * Reads a constructor-level metadata record from the standard metadata bag.
+ *
+ * @param target Instance or prototype whose constructor metadata should be inspected.
+ * @param key Symbol key of the stored metadata record.
+ * @returns The stored record when present, otherwise `undefined`.
+ */
+export function getStandardConstructorMetadataRecord(target, key) {
+  return getStandardConstructorMetadataBag(target)?.[key];
+}
+
+/**
+ * Reads a constructor-level property map from the standard metadata bag.
+ *
+ * @param target Instance or prototype whose constructor metadata should be inspected.
+ * @param key Symbol key of the stored metadata map.
+ * @returns The stored property map when present, otherwise `undefined`.
+ */
+export function getStandardConstructorMetadataMap(target, key) {
+  return getStandardConstructorMetadataRecord(target, key);
+}
+
+/**
+ * Merges stored and standard metadata property keys while preserving first-seen order.
+ *
+ * @param stored Property keys from the explicit Fluo store.
+ * @param standard Property keys from the standard metadata bag.
+ * @returns A deduplicated ordered list of metadata property keys.
+ */
+export function mergeMetadataPropertyKeys(stored, standard) {
+  const keys = [];
+  const seen = new Set();
+  for (const source of [stored, standard]) {
+    if (!source) {
+      continue;
+    }
+    for (const key of source.keys()) {
+      if (!seen.has(key)) {
+        seen.add(key);
+        keys.push(key);
+      }
+    }
+  }
+  return keys;
+}
+
+/**
+ * Appends a value into a property-keyed array store, creating the array on first write.
+ *
+ * @param store WeakMap-backed property store.
+ * @param target Target object that owns the property map.
+ * @param propertyKey Property key associated with the array entry.
+ * @param value Value to append.
+ */
+export function appendPropertyMapValue(store, target, propertyKey, value) {
+  const map = getOrCreatePropertyMap(store, target);
+  const existing = map.get(propertyKey);
+  if (existing) {
+    existing.push(value);
+    return;
+  }
+  map.set(propertyKey, [value]);
+}
+
+/**
+ * Appends a value into a WeakMap-backed array store, creating the array on first write.
+ *
+ * @param store WeakMap-backed array store.
+ * @param target Target function used as the WeakMap key.
+ * @param value Value to append.
+ */
+export function appendWeakMapValue(store, target, value) {
+  const existing = store.get(target);
+  if (existing) {
+    existing.push(value);
+    return;
+  }
+  store.set(target, [value]);
+}

package/dist/metadata/store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Clone-on-read/write metadata store contract for function/object keyed metadata records.
+ */
+export interface ClonedWeakMapStore<TKey extends object, TValue> {
+    read(target: TKey): TValue | undefined;
+    update(target: TKey, updateValue: (current: TValue | undefined) => TValue): void;
+    write(target: TKey, value: TValue): void;
+}
+/**
+ * Creates a WeakMap-backed store that clones values when they enter or leave the cache.
+ *
+ * @param cloneValue Clone routine used to isolate stored metadata from caller mutations.
+ * @returns A cloned WeakMap store for metadata helpers.
+ */
+export declare function createClonedWeakMapStore<TKey extends object, TValue>(cloneValue: (value: TValue) => TValue): ClonedWeakMapStore<TKey, TValue>;
+//# sourceMappingURL=store.d.ts.map

package/dist/metadata/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/metadata/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM;IAC7D,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,IAAI,CAAC;IACjF,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,SAAS,MAAM,EAAE,MAAM,EAClE,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACpC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAelC"}

package/dist/metadata/store.js

@@ -0,0 +1,25 @@
+/**
+ * Clone-on-read/write metadata store contract for function/object keyed metadata records.
+ */
+
+/**
+ * Creates a WeakMap-backed store that clones values when they enter or leave the cache.
+ *
+ * @param cloneValue Clone routine used to isolate stored metadata from caller mutations.
+ * @returns A cloned WeakMap store for metadata helpers.
+ */
+export function createClonedWeakMapStore(cloneValue) {
+  const store = new WeakMap();
+  return {
+    read(target) {
+      const value = store.get(target);
+      return value !== undefined ? cloneValue(value) : undefined;
+    },
+    update(target, updateValue) {
+      store.set(target, cloneValue(updateValue(store.get(target))));
+    },
+    write(target, value) {
+      store.set(target, cloneValue(value));
+    }
+  };
+}

package/dist/metadata/symbol-metadata-polyfill.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureSymbolMetadataPolyfill(): symbol;
+//# sourceMappingURL=symbol-metadata-polyfill.d.ts.map

package/dist/metadata/symbol-metadata-polyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-metadata-polyfill.d.ts","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-polyfill.ts"],"names":[],"mappings":"AAEA,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/metadata/symbol-metadata-polyfill.js

@@ -0,0 +1,4 @@
+import { ensureMetadataSymbol } from './shared.js';
+export function ensureSymbolMetadataPolyfill() {
+  return ensureMetadataSymbol();
+}

package/dist/metadata/types.d.ts

@@ -0,0 +1,210 @@
+import type { Constructor, MaybePromise, MetadataPropertyKey, MetadataSource, Token } from '../types.js';
+export type MetadataCollection<T = unknown> = T[];
+export interface ModuleMetadata {
+    imports?: MetadataCollection;
+    providers?: MetadataCollection;
+    controllers?: MetadataCollection;
+    exports?: MetadataCollection;
+    middleware?: MetadataCollection;
+    global?: boolean;
+}
+export interface ControllerMetadata {
+    basePath: string;
+    guards?: MetadataCollection;
+    interceptors?: MetadataCollection;
+    version?: string;
+}
+export interface RouteHeader {
+    name: string;
+    value: string;
+}
+export interface RouteRedirect {
+    url: string;
+    statusCode?: number;
+}
+export interface RouteMetadata {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+    path: string;
+    request?: new (...args: never[]) => unknown;
+    guards?: MetadataCollection;
+    headers?: RouteHeader[];
+    interceptors?: MetadataCollection;
+    redirect?: RouteRedirect;
+    successStatus?: number;
+    version?: string;
+}
+export interface DtoFieldBindingMetadata {
+    source: MetadataSource;
+    key?: string;
+    optional?: boolean;
+    converter?: Token | {
+        convert(value: unknown, target: unknown): MaybePromise<unknown>;
+    };
+}
+export interface ValidationIssueMetadata {
+    code: string;
+    field?: string;
+    message: string;
+    source?: MetadataSource;
+}
+export type ValidationRuleResult = boolean | void | ValidationIssueMetadata | readonly ValidationIssueMetadata[];
+export interface ValidationDecoratorOptions {
+    code?: string;
+    each?: boolean;
+    message?: string;
+}
+export interface CustomValidationDecoratorOptions extends ValidationDecoratorOptions {
+    source?: MetadataSource;
+}
+export interface CustomFieldValidationContext<T = unknown> {
+    dto: T;
+    propertyKey: MetadataPropertyKey;
+}
+export type CustomFieldValidator<T = unknown> = (value: unknown, context: CustomFieldValidationContext<T>) => MaybePromise<ValidationRuleResult>;
+export type CustomClassValidator<T = unknown> = (value: T) => MaybePromise<ValidationRuleResult>;
+export type ConditionalFieldValidator<T = unknown> = (dto: T, value: unknown) => MaybePromise<boolean>;
+export type DtoFieldValidationRule = ({
+    kind: 'validateIf';
+    validateIf: ConditionalFieldValidator;
+} & ValidationDecoratorOptions) | ({
+    kind: 'defined';
+} & ValidationDecoratorOptions) | ({
+    kind: 'optional';
+} & ValidationDecoratorOptions) | ({
+    kind: 'equals';
+    value: unknown;
+} & ValidationDecoratorOptions) | ({
+    kind: 'notEquals';
+    value: unknown;
+} & ValidationDecoratorOptions) | ({
+    kind: 'empty';
+} & ValidationDecoratorOptions) | ({
+    kind: 'notEmpty';
+} & ValidationDecoratorOptions) | ({
+    kind: 'in';
+    values: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'notIn';
+    values: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'string';
+} & ValidationDecoratorOptions) | ({
+    kind: 'number';
+    allowNaN?: boolean;
+} & ValidationDecoratorOptions) | ({
+    kind: 'boolean';
+} & ValidationDecoratorOptions) | ({
+    kind: 'date';
+} & ValidationDecoratorOptions) | ({
+    kind: 'array';
+} & ValidationDecoratorOptions) | ({
+    kind: 'object';
+} & ValidationDecoratorOptions) | ({
+    kind: 'enum';
+    values: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'int';
+} & ValidationDecoratorOptions) | ({
+    kind: 'divisibleBy';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'positive';
+} & ValidationDecoratorOptions) | ({
+    kind: 'negative';
+} & ValidationDecoratorOptions) | ({
+    kind: 'min';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'max';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'minDate';
+    value: Date;
+} & ValidationDecoratorOptions) | ({
+    kind: 'maxDate';
+    value: Date;
+} & ValidationDecoratorOptions) | ({
+    kind: 'contains';
+    value: string;
+} & ValidationDecoratorOptions) | ({
+    kind: 'notContains';
+    value: string;
+} & ValidationDecoratorOptions) | ({
+    kind: 'length';
+    min: number;
+    max?: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'minLength';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'maxLength';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'nested';
+    dto: Constructor | (() => Constructor);
+} & ValidationDecoratorOptions) | ({
+    kind: 'validatorjs';
+    validator: 'alpha' | 'alphanumeric' | 'ascii' | 'base64' | 'booleanString' | 'currency' | 'dataURI' | 'dateString' | 'decimal' | 'email' | 'fqdn' | 'hexColor' | 'hexadecimal' | 'ip' | 'isbn' | 'issn' | 'json' | 'jwt' | 'locale' | 'lowercase' | 'magnetURI' | 'matches' | 'mimeType' | 'mobilePhone' | 'mongoId' | 'numberString' | 'port' | 'postalCode' | 'rgbColor' | 'rfc3339' | 'semVer' | 'uppercase' | 'url' | 'uuid' | 'iso8601' | 'latitude' | 'longitude' | 'latLong';
+    args?: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayContains';
+    values: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayNotContains';
+    values: readonly unknown[];
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayNotEmpty';
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayMinSize';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayMaxSize';
+    value: number;
+} & ValidationDecoratorOptions) | ({
+    kind: 'arrayUnique';
+    selector?: (value: unknown) => unknown;
+} & ValidationDecoratorOptions) | ({
+    kind: 'custom';
+    validate: CustomFieldValidator;
+    source?: MetadataSource;
+} & ValidationDecoratorOptions);
+export interface ClassValidationRule {
+    code?: string;
+    message?: string;
+    validate: CustomClassValidator;
+}
+export interface InjectionMetadata {
+    token: unknown;
+    optional?: boolean;
+}
+export interface ClassDiMetadata {
+    inject?: Token[];
+    scope?: 'singleton' | 'request' | 'transient';
+}
+export interface DtoBindingSchemaEntry {
+    propertyKey: MetadataPropertyKey;
+    metadata: DtoFieldBindingMetadata;
+}
+export interface DtoValidationSchemaEntry {
+    propertyKey: MetadataPropertyKey;
+    rules: readonly DtoFieldValidationRule[];
+}
+export interface InjectionSchemaEntry {
+    propertyKey: MetadataPropertyKey;
+    metadata: InjectionMetadata;
+}
+export interface StandardRouteMetadataRecord {
+    guards?: MetadataCollection;
+    headers?: RouteHeader[];
+    interceptors?: MetadataCollection;
+    method?: RouteMetadata['method'];
+    path?: string;
+    redirect?: RouteRedirect;
+    request?: new (...args: never[]) => unknown;
+    successStatus?: number;
+    version?: string;
+}
+export type StandardDtoBindingRecord = Partial<DtoFieldBindingMetadata>;
+export type StandardDtoValidationRecord = DtoFieldValidationRule[];
+export type StandardInjectionRecord = Partial<InjectionMetadata>;
+//# sourceMappingURL=types.d.ts.map

package/dist/metadata/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metadata/types.ts"],"names":[],"mappings":"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"}

package/dist/metadata/types.js

@@ -0,0 +1 @@
+export {};

package/dist/metadata/validation.d.ts

@@ -0,0 +1,11 @@
+import type { ClassValidationRule, DtoBindingSchemaEntry, DtoFieldBindingMetadata, DtoFieldValidationRule, DtoValidationSchemaEntry } from './types.js';
+import type { Constructor, MetadataPropertyKey } from '../types.js';
+export declare function getDtoFieldBindingMetadata(target: object, propertyKey: MetadataPropertyKey): DtoFieldBindingMetadata | undefined;
+export declare function defineDtoFieldBindingMetadata(target: object, propertyKey: MetadataPropertyKey, metadata: DtoFieldBindingMetadata): void;
+export declare function appendDtoFieldValidationRule(target: object, propertyKey: MetadataPropertyKey, rule: DtoFieldValidationRule): void;
+export declare function appendClassValidationRule(target: Function, rule: ClassValidationRule): void;
+export declare function getDtoBindingSchema(dto: Constructor): DtoBindingSchemaEntry[];
+export declare function getDtoFieldValidationRules(target: object, propertyKey: MetadataPropertyKey): readonly DtoFieldValidationRule[];
+export declare function getDtoValidationSchema(dto: Constructor): DtoValidationSchemaEntry[];
+export declare function getClassValidationRules(target: Function): readonly ClassValidationRule[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/metadata/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/metadata/validation.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EAGzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAsBpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,uBAAuB,GAAG,SAAS,CAiBhI;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAEN;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,IAAI,EAAE,sBAAsB,GAC3B,IAAI,CAEN;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAI3F;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,qBAAqB,EAAE,CA8B7E;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,SAAS,sBAAsB,EAAE,CAQ9H;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,wBAAwB,EAAE,CAiBnF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,mBAAmB,EAAE,CAExF"}

package/dist/metadata/validation.js

@@ -0,0 +1,93 @@
+import { appendPropertyMapValue, cloneMutableValue, getOrCreatePropertyMap, getStandardConstructorMetadataMap, getStandardMetadataBag, mergeMetadataPropertyKeys, standardMetadataKeys } from './shared.js';
+import { createClonedWeakMapStore } from './store.js';
+const dtoFieldBindingStore = new WeakMap();
+const dtoFieldValidationStore = new WeakMap();
+const classValidationStore = createClonedWeakMapStore(rules => rules.map(rule => cloneMutableValue(rule)));
+function getStandardDtoBindingMap(target) {
+  return getStandardConstructorMetadataMap(target, standardMetadataKeys.dtoFieldBinding);
+}
+function getStandardDtoValidationMap(target) {
+  return getStandardConstructorMetadataMap(target, standardMetadataKeys.dtoFieldValidation);
+}
+function getStandardClassValidationRules(target) {
+  const rules = getStandardMetadataBag(target)?.[standardMetadataKeys.classValidation];
+  return rules ? rules.map(rule => cloneMutableValue(rule)) : undefined;
+}
+export function getDtoFieldBindingMetadata(target, propertyKey) {
+  const stored = dtoFieldBindingStore.get(target)?.get(propertyKey);
+  const standard = getStandardDtoBindingMap(target)?.get(propertyKey);
+  const source = stored?.source ?? standard?.source;
+  if (!source) {
+    return undefined;
+  }
+  const converter = stored?.converter ?? standard?.converter;
+  return {
+    ...(converter === undefined ? {} : {
+      converter
+    }),
+    key: stored?.key ?? standard?.key,
+    optional: stored?.optional ?? standard?.optional,
+    source
+  };
+}
+export function defineDtoFieldBindingMetadata(target, propertyKey, metadata) {
+  getOrCreatePropertyMap(dtoFieldBindingStore, target).set(propertyKey, {
+    ...metadata
+  });
+}
+export function appendDtoFieldValidationRule(target, propertyKey, rule) {
+  appendPropertyMapValue(dtoFieldValidationStore, target, propertyKey, cloneMutableValue(rule));
+}
+export function appendClassValidationRule(target, rule) {
+  const rules = classValidationStore.read(target) ?? [];
+  rules.push(cloneMutableValue(rule));
+  classValidationStore.write(target, rules);
+}
+export function getDtoBindingSchema(dto) {
+  const stored = dtoFieldBindingStore.get(dto.prototype) ?? new Map();
+  const standard = getStandardMetadataBag(dto)?.[standardMetadataKeys.dtoFieldBinding] ?? new Map();
+  const keys = mergeMetadataPropertyKeys(stored, standard);
+  return keys.flatMap(propertyKey => {
+    const storedEntry = stored.get(propertyKey);
+    const standardEntry = standard.get(propertyKey);
+    const source = storedEntry?.source ?? standardEntry?.source;
+    if (!source) {
+      return [];
+    }
+    const converter = storedEntry?.converter ?? standardEntry?.converter;
+    return [{
+      propertyKey,
+      metadata: {
+        ...(converter === undefined ? {} : {
+          converter
+        }),
+        key: storedEntry?.key ?? standardEntry?.key,
+        optional: storedEntry?.optional ?? standardEntry?.optional,
+        source
+      }
+    }];
+  });
+}
+export function getDtoFieldValidationRules(target, propertyKey) {
+  const stored = dtoFieldValidationStore.get(target)?.get(propertyKey) ?? [];
+  const standard = getStandardDtoValidationMap(target)?.get(propertyKey) ?? [];
+  return [...standard.map(rule => cloneMutableValue(rule)), ...stored.map(rule => cloneMutableValue(rule))];
+}
+export function getDtoValidationSchema(dto) {
+  const stored = dtoFieldValidationStore.get(dto.prototype) ?? new Map();
+  const standard = getStandardDtoValidationMap(dto.prototype) ?? new Map();
+  const keys = mergeMetadataPropertyKeys(stored, standard);
+  return keys.flatMap(propertyKey => {
+    const rules = [...(standard.get(propertyKey) ?? []).map(rule => cloneMutableValue(rule)), ...(stored.get(propertyKey) ?? []).map(rule => cloneMutableValue(rule))];
+    if (rules.length === 0) {
+      return [];
+    }
+    return [{
+      propertyKey,
+      rules
+    }];
+  });
+}
+export function getClassValidationRules(target) {
+  return [...(getStandardClassValidationRules(target) ?? []), ...(classValidationStore.read(target) ?? [])];
+}

package/dist/metadata.d.ts

@@ -0,0 +1,9 @@
+export { getClassDiMetadata, getInheritedClassDiMetadata, getOwnClassDiMetadata, defineClassDiMetadata } from './metadata/class-di.js';
+export { defineControllerMetadata, defineRouteMetadata, getControllerMetadata, getRouteMetadata } from './metadata/controller-route.js';
+export { defineInjectionMetadata, getInjectionSchema } from './metadata/injection.js';
+export { defineModuleMetadata, getModuleMetadata } from './metadata/module.js';
+export { ensureMetadataSymbol, metadataKeys, metadataSymbol } from './metadata/shared.js';
+export { ensureSymbolMetadataPolyfill } from './metadata/symbol-metadata-polyfill.js';
+export { appendClassValidationRule, appendDtoFieldValidationRule, defineDtoFieldBindingMetadata, getClassValidationRules, getDtoBindingSchema, getDtoFieldBindingMetadata, getDtoFieldValidationRules, getDtoValidationSchema, } from './metadata/validation.js';
+export type { ClassDiMetadata, ClassValidationRule, ConditionalFieldValidator, ControllerMetadata, CustomClassValidator, CustomFieldValidationContext, CustomFieldValidator, CustomValidationDecoratorOptions, DtoBindingSchemaEntry, DtoFieldBindingMetadata, DtoFieldValidationRule, DtoValidationSchemaEntry, InjectionMetadata, InjectionSchemaEntry, MetadataCollection, ModuleMetadata, RouteHeader, RouteMetadata, RouteRedirect, ValidationDecoratorOptions, ValidationIssueMetadata, ValidationRuleResult, } from './metadata/types.js';
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACvI,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACxI,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,mBAAmB,EACnB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,7 @@
+export { getClassDiMetadata, getInheritedClassDiMetadata, getOwnClassDiMetadata, defineClassDiMetadata } from './metadata/class-di.js';
+export { defineControllerMetadata, defineRouteMetadata, getControllerMetadata, getRouteMetadata } from './metadata/controller-route.js';
+export { defineInjectionMetadata, getInjectionSchema } from './metadata/injection.js';
+export { defineModuleMetadata, getModuleMetadata } from './metadata/module.js';
+export { ensureMetadataSymbol, metadataKeys, metadataSymbol } from './metadata/shared.js';
+export { ensureSymbolMetadataPolyfill } from './metadata/symbol-metadata-polyfill.js';
+export { appendClassValidationRule, appendDtoFieldValidationRule, defineDtoFieldBindingMetadata, getClassValidationRules, getDtoBindingSchema, getDtoFieldBindingMetadata, getDtoFieldValidationRules, getDtoValidationSchema } from './metadata/validation.js';