adorn-api 1.0.0 → 1.0.2

package/dist/integrations/metal-orm/schema/column-map.js

@@ -0,0 +1,207 @@
+import { v } from '../../../validation/native/schema.js';
+/**
+ * Database column type categories for schema mapping.
+ *
+ * These sets categorize database column types for
+ * appropriate schema generation.
+ */
+const INTEGER_TYPES = new Set(['int', 'integer', 'bigint']);
+const DECIMAL_TYPES = new Set(['decimal', 'numeric', 'float', 'double', 'real']);
+const STRING_TYPES = new Set(['char', 'text', 'enum']);
+const BOOLEAN_TYPES = new Set(['boolean', 'bool']);
+const DATE_TIME_TYPES = new Set(['date', 'datetime', 'timestamp', 'timestamptz', 'time', 'timetz']);
+const JSON_TYPES = new Set(['json', 'jsonb']);
+const BINARY_TYPES = new Set(['blob', 'binary', 'varbinary', 'bytea']);
+/**
+ * Helper function to create successful validation results.
+ *
+ * @template T - The value type
+ * @param value - The validated value
+ * @returns Validation result with ok: true
+ */
+function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a base string schema.
+ *
+ * @returns Basic string validation schema
+ */
+function baseStringSchema() {
+    return v.string();
+}
+/**
+ * Creates a base number schema.
+ *
+ * @returns Basic number validation schema
+ */
+function _baseNumberSchema() {
+    return v.number();
+}
+/**
+ * Creates a base boolean schema.
+ *
+ * @returns Basic boolean validation schema
+ */
+function _baseBooleanSchema() {
+    return v.boolean();
+}
+/**
+ * Creates a schema that accepts any value.
+ *
+ * Used for JSON/BLOB columns that can contain
+ * arbitrary data structures.
+ *
+ * @returns Schema that validates any value
+ */
+function anySchema() {
+    return {
+        kind: 'object',
+        name: 'json',
+        ir: { kind: 'object', properties: {}, required: [], strict: false },
+        parse(value) {
+            return ok(value);
+        },
+    };
+}
+/**
+ * Maps Metal-ORM column definitions to validation schemas.
+ *
+ * This function converts database column types to appropriate
+ * validation schemas that can be used for request validation
+ * and data processing.
+ *
+ * @param column - Metal-ORM column definition
+ * @returns Validation schema appropriate for the column type
+ *
+ * @example
+ * ```typescript
+ * // Integer column
+ * const intColumn = { type: 'int', notNull: true };
+ * const intSchema = columnToSchema(intColumn);
+ * // Returns: v.number().int()
+ *
+ * // UUID column
+ * const uuidColumn = { type: 'uuid', notNull: false };
+ * const uuidSchema = columnToSchema(uuidColumn);
+ * // Returns: v.string().format('uuid')
+ *
+ * // DateTime column
+ * const dateColumn = { type: 'timestamp', notNull: true };
+ * const dateSchema = columnToSchema(dateColumn);
+ * // Returns: v.string().format('date-time')
+ *
+ * // VARCHAR with length
+ * const varcharColumn = { type: 'varchar', args: [255], notNull: true };
+ * const varcharSchema = columnToSchema(varcharColumn);
+ * // Returns: v.string().max(255)
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using in entity schema generation
+ * import { entity } from './entity';
+ * import { columnToSchema } from './column-map';
+ *
+ * // Custom entity schema with column mapping
+ * function customEntitySchema(Entity: EntityCtor<any>) {
+ *   const table = tableDefOf(Entity);
+ *   const shape: Record<string, Schema<any>> = {};
+ *
+ *   for (const [key, column] of Object.entries(table.columns)) {
+ *     const schema = columnToSchema(column);
+ *     shape[key] = column.notNull ? schema : v.optional(schema);
+ *   }
+ *
+ *   return v.object(shape);
+ * }
+ * ```
+ *
+ * @see entity for complete entity schema generation
+ * @see ValidationResult for validation result structure
+ */
+export function columnToSchema(column) {
+    const rawType = String(column.type ?? '').toLowerCase();
+    const normalizedType = rawType.split('(')[0].trim();
+    if (INTEGER_TYPES.has(normalizedType)) {
+        return v.number().int();
+    }
+    if (DECIMAL_TYPES.has(normalizedType)) {
+        return v.number();
+    }
+    if (BOOLEAN_TYPES.has(normalizedType)) {
+        return v.boolean();
+    }
+    if (normalizedType === 'uuid') {
+        const schema = baseStringSchema();
+        if (schema.ir.kind === 'string') {
+            schema.ir.format = 'uuid';
+        }
+        return schema;
+    }
+    if (DATE_TIME_TYPES.has(normalizedType)) {
+        const schema = baseStringSchema();
+        if (schema.ir.kind === 'string') {
+            schema.ir.format = 'date-time';
+        }
+        return schema;
+    }
+    if (normalizedType === 'varchar') {
+        const schema = baseStringSchema();
+        const len = typeof column.args?.[0] === 'number' ? column.args[0] : undefined;
+        return len !== undefined ? schema.max(len) : schema;
+    }
+    if (STRING_TYPES.has(normalizedType)) {
+        return baseStringSchema();
+    }
+    if (JSON_TYPES.has(normalizedType)) {
+        return anySchema();
+    }
+    if (BINARY_TYPES.has(normalizedType)) {
+        const schema = baseStringSchema();
+        return schema;
+    }
+    if (normalizedType === 'text') {
+        return baseStringSchema();
+    }
+    return baseStringSchema();
+}
+/**
+ * Checks if a column is required (not nullable).
+ *
+ * @param column - Metal-ORM column definition
+ * @returns true if column is required (notNull), false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Required column
+ * const requiredColumn = { type: 'string', notNull: true };
+ * const isRequired = isRequiredColumn(requiredColumn); // true
+ *
+ * // Optional column
+ * const optionalColumn = { type: 'string', notNull: false };
+ * const isOptional = isRequiredColumn(optionalColumn); // false
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using in schema generation
+ * function generateSchemaFromTable(table: TableDef) {
+ *   const shape: Record<string, Schema<any>> = {};
+ *
+ *   for (const [key, column] of Object.entries(table.columns)) {
+ *     const schema = columnToSchema(column);
+ *     const required = isRequiredColumn(column);
+ *     shape[key] = required ? schema : v.optional(schema);
+ *   }
+ *
+ *   return v.object(shape);
+ * }
+ * ```
+ *
+ * @see columnToSchema for column type mapping
+ */
+export function isRequiredColumn(column) {
+    return Boolean(column.notNull);
+}
+//# sourceMappingURL=column-map.js.map

package/dist/integrations/metal-orm/schema/column-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-map.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/column-map.ts"],"names":[],"mappings":"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"}

package/dist/integrations/metal-orm/schema/ddl.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ddl.d.ts.map

package/dist/integrations/metal-orm/schema/ddl.d.ts.map

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

package/dist/integrations/metal-orm/schema/ddl.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\integrations\metal-orm\schema\ddl.ts
+//# sourceMappingURL=ddl.js.map

package/dist/integrations/metal-orm/schema/ddl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/ddl.ts"],"names":[],"mappings":";AAAA,2DAA2D"}

package/dist/integrations/metal-orm/schema/dto.d.ts

@@ -0,0 +1,7 @@
+import type { Schema } from '../../../validation/native/schema.js';
+import { type EntityCtor } from './tabledef.js';
+import type { SaveGraphInputPayload } from 'metal-orm';
+export type DtoMode = 'create' | 'update';
+export type EntityDtoSchema<T, Mode extends DtoMode> = Mode extends 'create' ? Schema<SaveGraphInputPayload<T>> : Schema<Partial<SaveGraphInputPayload<T>>>;
+export declare function entityDto<T, Mode extends DtoMode>(Entity: EntityCtor<T>, mode: Mode): EntityDtoSchema<T, Mode>;
+//# sourceMappingURL=dto.d.ts.map

package/dist/integrations/metal-orm/schema/dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/dto.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAa,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1C,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,IACjD,IAAI,SAAS,QAAQ,GACjB,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAChC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAahD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAC/C,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,IAAI,GACT,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAqB1B"}

package/dist/integrations/metal-orm/schema/dto.js

@@ -0,0 +1,34 @@
+import { optional, v } from '../../../validation/native/schema.js';
+import { tableDefOf } from './tabledef.js';
+import { columnToSchema } from './column-map.js';
+function shouldSkipColumnForCreate(column) {
+    return Boolean(column.autoIncrement || column.generated);
+}
+function isRequiredForCreate(column) {
+    if (!column.notNull)
+        return false;
+    if (column.default !== undefined)
+        return false;
+    if (column.autoIncrement || column.generated)
+        return false;
+    return true;
+}
+export function entityDto(Entity, mode) {
+    const table = tableDefOf(Entity);
+    const shape = {};
+    for (const [key, column] of Object.entries(table.columns)) {
+        const schema = columnToSchema(column);
+        if (mode === 'create' && shouldSkipColumnForCreate(column)) {
+            continue;
+        }
+        if (mode === 'update') {
+            shape[key] = optional(schema);
+            continue;
+        }
+        const required = isRequiredForCreate(column);
+        shape[key] = required ? schema : optional(schema);
+    }
+    const base = v.object(shape).strict();
+    return base;
+}
+//# sourceMappingURL=dto.js.map

package/dist/integrations/metal-orm/schema/dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjD,SAAS,yBAAyB,CAAC,MAAiB;IAClD,OAAO,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAiB;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,MAAqB,EACrB,IAAU;IAEV,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,KAAK,GAAoC,EAAE,CAAC;IAElD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAA0B,EAAE,CAAC;QACnF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,IAAI,KAAK,QAAQ,IAAI,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,OAAO,IAAgC,CAAC;AAC1C,CAAC"}

package/dist/integrations/metal-orm/schema/entity.d.ts

@@ -0,0 +1,99 @@
+import type { Schema } from '../../../validation/native/schema.js';
+import { type EntityCtor } from './tabledef.js';
+/**
+ * Options for customizing entity schema generation.
+ *
+ * These options allow selecting specific columns, excluding columns,
+ * and naming the generated schema.
+ */
+export type EntitySchemaOptions = {
+    /** Array of column names to include (exclusive selection) */
+    pick?: readonly string[];
+    /** Array of column names to exclude */
+    omit?: readonly string[];
+    /** Optional name for the generated schema */
+    name?: string;
+};
+/**
+ * Generates a validation schema from a Metal-ORM entity.
+ *
+ * This function creates a Schema object that validates data against
+ * the structure of a Metal-ORM entity, including column types,
+ * nullability constraints, and other database-level validations.
+ *
+ * @template T - The entity type
+ * @param Entity - Metal-ORM entity constructor
+ * @param opts - Options for customizing schema generation
+ * @returns Schema that validates against the entity structure
+ *
+ * @example
+ * ```typescript
+ * // Basic entity schema
+ * const userSchema = entity(User);
+ *
+ * // Schema with selected columns only
+ * const userProfileSchema = entity(User, {
+ *   pick: ['id', 'name', 'email', 'avatarUrl']
+ * });
+ *
+ * // Schema with excluded columns
+ * const userPublicSchema = entity(User, {
+ *   omit: ['passwordHash', 'emailVerificationToken']
+ * });
+ *
+ * // Named schema
+ * const createUserSchema = entity(User, {
+ *   name: 'CreateUserDto',
+ *   omit: ['id', 'createdAt', 'updatedAt']
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using in a controller with validation
+ * @Post('/users')
+ * async createUser(@Body() userData: unknown) {
+ *   const userSchema = entity(User, {
+ *     omit: ['id', 'createdAt', 'updatedAt']
+ *   });
+ *
+ *   const validationResult = await validator.validate(userData, userSchema);
+ *   if (!validationResult.ok) {
+ *     throw ValidationError.fromIssues(validationResult.issues);
+ *   }
+ *
+ *   const createdUser = await userService.create(validationResult.value);
+ *   return reply(201, createdUser);
+ * }
+ * ```
+ *
+ * @see Schema for the returned schema type
+ * @see EntityCtor for Metal-ORM entity constructor type
+ */
+export declare function entity<T>(Entity: EntityCtor<T>, opts?: EntitySchemaOptions): Schema<T>;
+/**
+ * Generates a validation schema for an array of entities.
+ *
+ * @template T - The entity type
+ * @param Entity - Metal-ORM entity constructor
+ * @param opts - Options for customizing schema generation
+ * @returns Schema that validates an array of entities
+ *
+ * @example
+ * ```typescript
+ * // Array of users
+ * const usersArraySchema = entityArray(User);
+ *
+ * // Array with selected columns
+ * const userPreviewsSchema = entityArray(User, {
+ *   pick: ['id', 'name', 'email']
+ * });
+ * ```
+ */
+export declare function entityArray<T>(Entity: EntityCtor<T>, opts?: EntitySchemaOptions): Schema<T[]> & {
+    min(n: number): Schema<T[]> & /*elided*/ any;
+    max(n: number): Schema<T[]> & /*elided*/ any;
+    optional(): Schema<T[] | undefined>;
+    nullable(): Schema<T[] | null>;
+};
+//# sourceMappingURL=entity.d.ts.map

package/dist/integrations/metal-orm/schema/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/entity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG5D;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,uCAAuC;IACvC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAAC,CAAC,CAAC,CAkB1F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,mBAAwB;;;;;EAEnF"}

package/dist/integrations/metal-orm/schema/entity.js

@@ -0,0 +1,99 @@
+import { optional, v } from '../../../validation/native/schema.js';
+import { columnToSchema } from './column-map.js';
+import { tableDefOf } from './tabledef.js';
+/**
+ * Generates a validation schema from a Metal-ORM entity.
+ *
+ * This function creates a Schema object that validates data against
+ * the structure of a Metal-ORM entity, including column types,
+ * nullability constraints, and other database-level validations.
+ *
+ * @template T - The entity type
+ * @param Entity - Metal-ORM entity constructor
+ * @param opts - Options for customizing schema generation
+ * @returns Schema that validates against the entity structure
+ *
+ * @example
+ * ```typescript
+ * // Basic entity schema
+ * const userSchema = entity(User);
+ *
+ * // Schema with selected columns only
+ * const userProfileSchema = entity(User, {
+ *   pick: ['id', 'name', 'email', 'avatarUrl']
+ * });
+ *
+ * // Schema with excluded columns
+ * const userPublicSchema = entity(User, {
+ *   omit: ['passwordHash', 'emailVerificationToken']
+ * });
+ *
+ * // Named schema
+ * const createUserSchema = entity(User, {
+ *   name: 'CreateUserDto',
+ *   omit: ['id', 'createdAt', 'updatedAt']
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using in a controller with validation
+ * @Post('/users')
+ * async createUser(@Body() userData: unknown) {
+ *   const userSchema = entity(User, {
+ *     omit: ['id', 'createdAt', 'updatedAt']
+ *   });
+ *
+ *   const validationResult = await validator.validate(userData, userSchema);
+ *   if (!validationResult.ok) {
+ *     throw ValidationError.fromIssues(validationResult.issues);
+ *   }
+ *
+ *   const createdUser = await userService.create(validationResult.value);
+ *   return reply(201, createdUser);
+ * }
+ * ```
+ *
+ * @see Schema for the returned schema type
+ * @see EntityCtor for Metal-ORM entity constructor type
+ */
+export function entity(Entity, opts = {}) {
+    const table = tableDefOf(Entity);
+    const pick = opts.pick ? new Set(opts.pick) : null;
+    const omit = opts.omit ? new Set(opts.omit) : null;
+    const shape = {};
+    for (const [key, column] of Object.entries(table.columns)) {
+        if (pick && !pick.has(key))
+            continue;
+        if (omit && omit.has(key))
+            continue;
+        const schema = columnToSchema(column);
+        shape[key] = column.notNull ? schema : optional(schema);
+    }
+    const base = v.object(shape).strict();
+    const typed = base;
+    return opts.name ? v.named(opts.name, typed) : typed;
+}
+/**
+ * Generates a validation schema for an array of entities.
+ *
+ * @template T - The entity type
+ * @param Entity - Metal-ORM entity constructor
+ * @param opts - Options for customizing schema generation
+ * @returns Schema that validates an array of entities
+ *
+ * @example
+ * ```typescript
+ * // Array of users
+ * const usersArraySchema = entityArray(User);
+ *
+ * // Array with selected columns
+ * const userPreviewsSchema = entityArray(User, {
+ *   pick: ['id', 'name', 'email']
+ * });
+ * ```
+ */
+export function entityArray(Entity, opts = {}) {
+    return v.array(entity(Entity, opts));
+}
+//# sourceMappingURL=entity.js.map

package/dist/integrations/metal-orm/schema/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAkB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,UAAU,MAAM,CAAI,MAAqB,EAAE,OAA4B,EAAE;IAC7E,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnD,MAAM,KAAK,GAAoC,EAAE,CAAC;IAElD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAA0B,EAAE,CAAC;QACnF,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACrC,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAEpC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,IAA4B,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAI,MAAqB,EAAE,OAA4B,EAAE;IAClF,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/integrations/metal-orm/schema/filters.d.ts

@@ -0,0 +1,11 @@
+import type { Schema } from '../../../validation/native/schema.js';
+import { type EntityCtor } from './tabledef.js';
+import type { HttpPick, Paged } from './types.js';
+export type FiltersOptions<P extends readonly (string & PropertyKey)[]> = {
+    pick: P;
+    paging?: boolean;
+};
+export declare function filtersFromEntity<T, const P extends readonly (keyof T & string)[], const Opts extends FiltersOptions<P>>(Entity: EntityCtor<T>, opts: Opts): Schema<(Opts['paging'] extends false ? Record<string, never> : Paged) & Partial<{
+    [K in P[number]]: HttpPick<T, K>;
+}>>;
+//# sourceMappingURL=filters.d.ts.map

package/dist/integrations/metal-orm/schema/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/filters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,IAAI;IACxE,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,CAAC,EACD,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,EAC7C,KAAK,CAAC,IAAI,SAAS,cAAc,CAAC,CAAC,CAAC,EAEpC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,IAAI,GACT,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC;KAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;CAAE,CAAC,CAAC,CAmBxH"}

package/dist/integrations/metal-orm/schema/filters.js

@@ -0,0 +1,21 @@
+import { optional, v } from '../../../validation/native/schema.js';
+import { tableDefOf } from './tabledef.js';
+import { columnToSchema } from './column-map.js';
+export function filtersFromEntity(Entity, opts) {
+    const table = tableDefOf(Entity);
+    const shape = {};
+    if (opts.paging !== false) {
+        shape.page = v.number().int().min(1).optional();
+        shape.pageSize = v.number().int().min(1).max(100).optional();
+    }
+    const columns = table.columns;
+    for (const key of opts.pick) {
+        const column = columns[key];
+        if (!column)
+            continue;
+        shape[key] = optional(columnToSchema(column));
+    }
+    const schema = v.object(shape).strict();
+    return schema;
+}
+//# sourceMappingURL=filters.js.map

package/dist/integrations/metal-orm/schema/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAmB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASjD,MAAM,UAAU,iBAAiB,CAK/B,MAAqB,EACrB,IAAU;IAEV,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,KAAK,GAAoC,EAAE,CAAC;IAElD,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChD,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAoC,CAAC;IAE3D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAa,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,KAAK,CAAC,GAAa,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,OAAO,MAAgI,CAAC;AAC1I,CAAC"}

package/dist/integrations/metal-orm/schema/index.d.ts

@@ -0,0 +1,5 @@
+export * from './entity.js';
+export * from './dto.js';
+export * from './filters.js';
+export * from './tabledef.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/metal-orm/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/integrations/metal-orm/schema/index.js

@@ -0,0 +1,5 @@
+export * from './entity.js';
+export * from './dto.js';
+export * from './filters.js';
+export * from './tabledef.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/metal-orm/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/integrations/metal-orm/schema/openapi/entityToSchema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entityToSchema.d.ts.map

package/dist/integrations/metal-orm/schema/openapi/entityToSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityToSchema.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/metal-orm/schema/openapi/entityToSchema.ts"],"names":[],"mappings":""}

package/dist/integrations/metal-orm/schema/openapi/entityToSchema.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\integrations\metal-orm\schema\openapi\entityToSchema.ts
+//# sourceMappingURL=entityToSchema.js.map

package/dist/integrations/metal-orm/schema/openapi/entityToSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityToSchema.js","sourceRoot":"","sources":["../../../../../src/integrations/metal-orm/schema/openapi/entityToSchema.ts"],"names":[],"mappings":";AAAA,8EAA8E"}

package/dist/integrations/metal-orm/schema/openapi/tableDefToSchema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tableDefToSchema.d.ts.map

package/dist/integrations/metal-orm/schema/openapi/tableDefToSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableDefToSchema.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/metal-orm/schema/openapi/tableDefToSchema.ts"],"names":[],"mappings":""}

package/dist/integrations/metal-orm/schema/openapi/tableDefToSchema.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\integrations\metal-orm\schema\openapi\tableDefToSchema.ts
+//# sourceMappingURL=tableDefToSchema.js.map

package/dist/integrations/metal-orm/schema/openapi/tableDefToSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableDefToSchema.js","sourceRoot":"","sources":["../../../../../src/integrations/metal-orm/schema/openapi/tableDefToSchema.ts"],"names":[],"mappings":";AAAA,gFAAgF"}

package/dist/integrations/metal-orm/schema/sqlite.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/integrations/metal-orm/schema/sqlite.d.ts.map

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

package/dist/integrations/metal-orm/schema/sqlite.js

@@ -0,0 +1,3 @@
+export {};
+// placeholder for src\integrations\metal-orm\schema\sqlite.ts
+//# sourceMappingURL=sqlite.js.map

package/dist/integrations/metal-orm/schema/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/sqlite.ts"],"names":[],"mappings":";AAAA,8DAA8D"}

package/dist/integrations/metal-orm/schema/tabledef.d.ts

@@ -0,0 +1,4 @@
+import type { TableDef } from 'metal-orm';
+export type EntityCtor<T = unknown> = new (...args: unknown[]) => T;
+export declare function tableDefOf<T>(Entity: EntityCtor<T>): TableDef;
+//# sourceMappingURL=tabledef.d.ts.map

package/dist/integrations/metal-orm/schema/tabledef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabledef.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/tabledef.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAEpE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAO7D"}

package/dist/integrations/metal-orm/schema/tabledef.js

@@ -0,0 +1,10 @@
+import { getTableDefFromEntity } from 'metal-orm';
+export function tableDefOf(Entity) {
+    const table = getTableDefFromEntity(Entity);
+    if (!table) {
+        const name = Entity.name || 'Entity';
+        throw new Error(`Unable to derive MetalORM table definition for ${name}`);
+    }
+    return table;
+}
+//# sourceMappingURL=tabledef.js.map

package/dist/integrations/metal-orm/schema/tabledef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabledef.js","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/tabledef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAKlD,MAAM,UAAU,UAAU,CAAI,MAAqB;IACjD,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAA2B,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/integrations/metal-orm/schema/types.d.ts

@@ -0,0 +1,7 @@
+export type HttpScalar<T> = T extends Date ? string : T extends bigint ? number : T;
+export type HttpPick<T, K extends keyof T> = HttpScalar<T[K]>;
+export type Paged = {
+    page?: number;
+    pageSize?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/metal-orm/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/integrations/metal-orm/schema/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IACtB,CAAC,SAAS,IAAI,GAAG,MAAM,GACvB,CAAC,SAAS,MAAM,GAAG,MAAM,GACzB,CAAC,CAAC;AAEJ,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}