adorn-api 1.0.22 → 1.0.24

package/dist/openapi/zod-to-openapi.js

@@ -0,0 +1,184 @@
+export function zodToOpenApi(schema) {
+    return convertZodType(schema);
+}
+function convertZodType(schema) {
+    if (!schema || !schema._def) {
+        return { type: "object" };
+    }
+    const def = schema._def;
+    const typeName = def.typeName;
+    switch (typeName) {
+        case "ZodString":
+            return convertZodString(def);
+        case "ZodNumber":
+            return convertZodNumber(def);
+        case "ZodBoolean":
+            return { type: "boolean" };
+        case "ZodArray":
+            return {
+                type: "array",
+                items: convertZodType(def.type),
+            };
+        case "ZodObject":
+            return convertZodObject(schema);
+        case "ZodOptional":
+            return convertZodType(def.innerType);
+        case "ZodNullable":
+            const inner = convertZodType(def.innerType);
+            if (inner?.type) {
+                const types = Array.isArray(inner.type) ? inner.type : [inner.type];
+                return { ...inner, type: [...new Set([...types, "null"])] };
+            }
+            return { anyOf: [inner, { type: "null" }] };
+        case "ZodDefault":
+            const defaultSchema = convertZodType(def.innerType);
+            defaultSchema.default = def.defaultValue();
+            return defaultSchema;
+        case "ZodEnum":
+            return {
+                type: "string",
+                enum: def.values,
+            };
+        case "ZodLiteral":
+            return {
+                type: typeof def.value,
+                enum: [def.value],
+            };
+        case "ZodUnion":
+            return {
+                oneOf: def.options.map((opt) => convertZodType(opt)),
+            };
+        case "ZodEffects":
+            return convertZodType(def.schema);
+        case "ZodDate":
+            return { type: "string", format: "date-time" };
+        case "ZodAny":
+            return {};
+        case "ZodRecord":
+            return {
+                type: "object",
+                additionalProperties: convertZodType(def.valueType),
+            };
+        case "ZodTuple":
+            return {
+                type: "array",
+                items: def.items.map((item) => convertZodType(item)),
+                minItems: def.items.length,
+                maxItems: def.items.length,
+            };
+        default:
+            return { type: "object" };
+    }
+}
+function convertZodString(def) {
+    const result = { type: "string" };
+    if (def.checks) {
+        for (const check of def.checks) {
+            switch (check.kind) {
+                case "email":
+                    result.format = "email";
+                    break;
+                case "url":
+                    result.format = "uri";
+                    break;
+                case "uuid":
+                    result.format = "uuid";
+                    break;
+                case "datetime":
+                    result.format = "date-time";
+                    break;
+                case "min":
+                    result.minLength = check.value;
+                    break;
+                case "max":
+                    result.maxLength = check.value;
+                    break;
+                case "regex":
+                    result.pattern = check.regex.source;
+                    break;
+            }
+        }
+    }
+    return result;
+}
+function convertZodNumber(def) {
+    const result = { type: "number" };
+    if (!def.checks) {
+        return result;
+    }
+    const hasInt = def.checks.some((c) => c.kind === "int");
+    const hasPositive = def.checks.some((c) => c.kind === "positive");
+    const hasNegative = def.checks.some((c) => c.kind === "negative");
+    const hasMin = def.checks.some((c) => c.kind === "min");
+    const hasMax = def.checks.some((c) => c.kind === "max");
+    if (hasInt) {
+        result.type = "integer";
+    }
+    if (hasPositive) {
+        result.exclusiveMinimum = 0;
+        if (hasInt) {
+            result.type = "integer";
+        }
+        return result;
+    }
+    if (hasNegative) {
+        result.exclusiveMaximum = 0;
+        if (hasInt) {
+            result.type = "integer";
+        }
+        return result;
+    }
+    if (hasMin) {
+        const minCheck = def.checks.find((c) => c.kind === "min");
+        if (minCheck && !minCheck.inclusive) {
+            result.exclusiveMinimum = minCheck.value;
+        }
+        else {
+            result.minimum = minCheck.value;
+        }
+    }
+    if (hasMax) {
+        const maxCheck = def.checks.find((c) => c.kind === "max");
+        if (maxCheck && !maxCheck.inclusive) {
+            result.exclusiveMaximum = maxCheck.value;
+        }
+        else {
+            result.maximum = maxCheck.value;
+        }
+    }
+    return result;
+}
+function convertZodObject(schema) {
+    const shape = schema.shape;
+    const properties = {};
+    const required = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const zodValue = value;
+        properties[key] = convertZodType(zodValue);
+        if (!isOptional(zodValue)) {
+            required.push(key);
+        }
+    }
+    const result = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0) {
+        result.required = required;
+    }
+    return result;
+}
+export function isOptional(schema) {
+    if (!schema || !schema._def)
+        return false;
+    const def = schema._def;
+    const typeName = def.typeName;
+    if (typeName === "ZodOptional")
+        return true;
+    if (typeName === "ZodDefault")
+        return true;
+    if (typeName === "ZodNullable")
+        return isOptional(def.innerType);
+    return false;
+}
+//# sourceMappingURL=zod-to-openapi.js.map

package/dist/openapi/zod-to-openapi.js.map

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

package/dist/types/common.d.ts

@@ -0,0 +1,4 @@
+export type PlainObject = Record<string, any>;
+export type Constructor<T = any> = new (...args: any[]) => T;
+export type MaybePromise<T> = T | Promise<T>;
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE7D,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/common.js

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

package/dist/types/common.js.map

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

package/dist/types/controller.d.ts

@@ -0,0 +1,14 @@
+import { Request, Response, NextFunction } from 'express';
+export interface ControllerClass {
+    new (...args: any[]): any;
+}
+export interface RouteHandler {
+    (...args: any[]): any;
+}
+export interface MiddlewareFunction {
+    (req: Request, res: Response, next: NextFunction): void | Promise<void>;
+}
+export interface GuardFunction {
+    (req: Request, res: Response, next: NextFunction): boolean | Promise<boolean>;
+}
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/types/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}

package/dist/types/controller.js

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

package/dist/types/controller.js.map

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

package/dist/types/metadata.d.ts

@@ -0,0 +1,48 @@
+export interface ControllerMetadata {
+    path: string;
+    middlewares: Function[];
+    guards: Function[];
+}
+export interface RouteMetadata {
+    path: string;
+    method: HttpMethod;
+    handlerName: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    middlewares: Function[];
+    guards: Function[];
+    parameters: ParameterMetadata[];
+    response?: ResponseMetadata;
+    schemas?: SchemaConfig;
+    entity?: any;
+    schema?: any;
+    isArray?: boolean;
+    includeRelations?: string[];
+    relationsDepth?: number;
+}
+export interface ParameterMetadata {
+    name: string;
+    type: "query" | "body" | "params" | "combined";
+    index: number;
+    schema?: any;
+    required?: boolean;
+}
+export interface ResponseMetadata {
+    status: number;
+    description?: string;
+    schema?: any;
+    isArray?: boolean;
+}
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export interface SchemaConfig {
+    params?: any;
+    body?: any;
+    query?: any;
+}
+export interface ValidatedInput<P = unknown, B = unknown, Q = unknown> {
+    params: P;
+    body: B;
+    query: Q;
+}
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/types/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACnE,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,CAAC,CAAC;CACV"}

package/dist/types/metadata.js

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

package/dist/types/metadata.js.map

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

package/dist/types/openapi.d.ts

@@ -0,0 +1,30 @@
+import type { OpenAPIV3_1 } from 'openapi-types';
+export interface OpenApiOptions {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    components?: OpenAPIV3_1.ComponentsObject;
+}
+export type OpenApiSpec = {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths?: Record<string, OpenAPIV3_1.PathItemObject>;
+    components?: OpenAPIV3_1.ComponentsObject;
+    tags?: OpenAPIV3_1.TagObject[];
+    servers?: OpenAPIV3_1.ServerObject[];
+} & Omit<OpenAPIV3_1.Document, 'openapi' | 'info' | 'paths' | 'components' | 'tags' | 'servers'>;
+//# sourceMappingURL=openapi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/types/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;CAC3C;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;IAC1C,IAAI,CAAC,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC;CACtC,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC"}

package/dist/types/openapi.js

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

package/dist/types/openapi.js.map

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

package/dist/validation/zod-adapter.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * Format Zod errors into readable strings
+ */
+export declare function formatZodErrors(error: z.ZodError): string[];
+/**
+ * Create an Express middleware that validates a specific request property using Zod
+ */
+export declare function createZodValidationMiddleware(source: 'params' | 'body' | 'query', schema: z.ZodType<any>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Type helper for inferring schema types
+ */
+export type InferSchema<T> = T extends z.ZodType<infer U> ? U : never;
+//# sourceMappingURL=zod-adapter.d.ts.map

package/dist/validation/zod-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.d.ts","sourceRoot":"","sources":["../../src/validation/zod-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/D;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,EAAE,CAK3D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,EACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAER,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBAiBhE;AAuCD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/validation/zod-adapter.js

@@ -0,0 +1,61 @@
+/**
+ * Format Zod errors into readable strings
+ */
+export function formatZodErrors(error) {
+    return error.errors.map((err) => {
+        const path = err.path.join('.');
+        return path ? `${path}: ${err.message}` : err.message;
+    });
+}
+/**
+ * Create an Express middleware that validates a specific request property using Zod
+ */
+export function createZodValidationMiddleware(source, schema) {
+    return async (req, res, next) => {
+        const data = getRequestData(req, source);
+        const result = await schema.safeParseAsync(data);
+        if (!result.success) {
+            res.status(400).json({
+                error: 'Validation failed',
+                source,
+                errors: formatZodErrors(result.error),
+            });
+            return;
+        }
+        // Replace with validated/transformed data
+        setRequestData(req, source, result.data);
+        return next();
+    };
+}
+/**
+ * Get data from request based on source
+ */
+function getRequestData(req, source) {
+    switch (source) {
+        case 'params':
+            return req.params;
+        case 'body':
+            return req.body;
+        case 'query':
+            return req.query;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Set validated data back to request
+ */
+function setRequestData(req, source, data) {
+    switch (source) {
+        case 'params':
+            req.params = data;
+            break;
+        case 'body':
+            req.body = data;
+            break;
+        case 'query':
+            req.query = data;
+            break;
+    }
+}
+//# sourceMappingURL=zod-adapter.js.map

package/dist/validation/zod-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-adapter.js","sourceRoot":"","sources":["../../src/validation/zod-adapter.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;IAC1D,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CACzC,MAAmC,EACnC,MAAsB;IAEtB,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACjB,KAAK,EAAE,mBAAmB;gBAC1B,MAAM;gBACN,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;aACxC,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,0CAA0C;QAC1C,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAAY,EAAE,MAAmC;IACrE,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,QAAQ;YACT,OAAO,GAAG,CAAC,MAAM,CAAC;QACtB,KAAK,MAAM;YACP,OAAO,GAAG,CAAC,IAAI,CAAC;QACpB,KAAK,OAAO;YACR,OAAO,GAAG,CAAC,KAAK,CAAC;QACrB;YACI,OAAO,SAAS,CAAC;IACzB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CACnB,GAAY,EACZ,MAAmC,EACnC,IAAS;IAET,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,QAAQ;YACT,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;YAClB,MAAM;QACV,KAAK,MAAM;YACP,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAChB,MAAM;QACV,KAAK,OAAO;YACP,GAAW,CAAC,KAAK,GAAG,IAAI,CAAC;YAC1B,MAAM;IACd,CAAC;AACL,CAAC"}

package/examples/basic/app.ts

@@ -0,0 +1,15 @@
+import { createExpressApp } from "../../src";
+import { UserController } from "./user.controller";
+
+export function createApp() {
+  return createExpressApp({
+    controllers: [UserController],
+    openApi: {
+      info: {
+        title: "Adorn API",
+        version: "1.0.0"
+      },
+      docs: true
+    }
+  });
+}

package/examples/basic/index.ts

@@ -0,0 +1,6 @@
+import { createApp } from "./app";
+import { startExampleServer } from "../utils/start-server";
+
+const app = createApp();
+
+startExampleServer(app, { name: "Adorn API" });

package/examples/basic/user.controller.ts

@@ -0,0 +1,35 @@
+import {
+  Body,
+  Controller,
+  Get,
+  Params,
+  Post,
+  Returns,
+  type RequestContext
+} from "../../src";
+import { CreateUserDto, UserDto, UserParamsDto } from "./user.dtos";
+
+@Controller("/users")
+export class UserController {
+  @Get("/:id")
+  @Params(UserParamsDto)
+  @Returns(UserDto)
+  async getOne(ctx: RequestContext<unknown, undefined, { id: string }>) {
+    return {
+      id: ctx.params.id,
+      name: "Ada Lovelace",
+      nickname: "Ada"
+    };
+  }
+
+  @Post("/")
+  @Body(CreateUserDto)
+  @Returns({ status: 201, schema: UserDto, description: "Created" })
+  async create(ctx: RequestContext<CreateUserDto>) {
+    return {
+      id: "3f0f4d0f-1cb1-4cf1-9c32-3d4bce1b3f36",
+      name: ctx.body.name,
+      nickname: ctx.body.nickname
+    };
+  }
+}

package/examples/basic/user.dtos.ts

@@ -0,0 +1,23 @@
+import { Dto, Field, OmitDto, PickDto, t } from "../../src";
+
+@Dto({ description: "User record returned by the API." })
+export class UserDto {
+  @Field(t.uuid({ description: "User identifier." }))
+  id!: string;
+
+  @Field(t.string({ minLength: 1 }))
+  name!: string;
+
+  @Field(t.optional(t.string()))
+  nickname?: string;
+}
+
+export interface CreateUserDto extends Omit<UserDto, "id"> {}
+
+@OmitDto(UserDto, ["id"])
+export class CreateUserDto {}
+
+export interface UserParamsDto extends Pick<UserDto, "id"> {}
+
+@PickDto(UserDto, ["id"])
+export class UserParamsDto {}

package/examples/metal-orm-sqlite/app.ts

@@ -0,0 +1,18 @@
+import { createExpressApp } from "../../src";
+import { initializeDatabase } from "./db";
+import { PostController } from "./post.controller";
+import { UserController } from "./user.controller";
+import { startExampleServer } from "../utils/start-server";
+
+export async function start() {
+  await initializeDatabase();
+
+  const app = createExpressApp({
+    controllers: [UserController, PostController],
+    openApi: {
+      info: { title: "SQLite + MetalORM REST example", version: "1.0.0" },
+      docs: true
+    }
+  });
+  startExampleServer(app, { name: "SQLite + MetalORM REST example" });
+}

package/examples/metal-orm-sqlite/db.ts

@@ -0,0 +1,90 @@
+import sqlite3 from "sqlite3";
+import {
+  Orm,
+  SqliteDialect,
+  createSqliteExecutor,
+  type SqliteClientLike
+} from "metal-orm";
+
+let db: sqlite3.Database | null = null;
+let orm: Orm | null = null;
+
+function execSql(database: sqlite3.Database, sql: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    database.exec(sql, (err) => {
+      if (err) {
+        reject(err);
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+function createSqliteClient(database: sqlite3.Database): SqliteClientLike {
+  return {
+    all(sql, params = []) {
+      return new Promise((resolve, reject) => {
+        database.all(sql, params, (err, rows) => {
+          if (err) {
+            reject(err);
+            return;
+          }
+          resolve(rows as Record<string, unknown>[]);
+        });
+      });
+    },
+    beginTransaction() {
+      return execSql(database, "BEGIN");
+    },
+    commitTransaction() {
+      return execSql(database, "COMMIT");
+    },
+    rollbackTransaction() {
+      return execSql(database, "ROLLBACK");
+    }
+  };
+}
+
+export async function initializeDatabase() {
+  db = new sqlite3.Database(":memory:");
+  await execSql(db, "pragma foreign_keys = ON");
+  await execSql(
+    db,
+    "create table users (id integer primary key autoincrement, name text not null, email text, createdAt text not null)"
+  );
+  await execSql(
+    db,
+    "create table posts (id integer primary key autoincrement, title text not null, body text, userId integer not null, createdAt text not null, foreign key(userId) references users(id))"
+  );
+
+  await execSql(db, `
+    INSERT INTO users (name, email, createdAt) VALUES 
+      ('Alice', 'alice@example.com', '2026-01-17T00:00:00.000Z'),
+      ('Bob', 'bob@example.com', '2026-01-17T00:00:00.000Z')
+  `);
+
+  await execSql(db, `
+    INSERT INTO posts (title, body, userId, createdAt) VALUES 
+      ('First Post', 'This is the first post content', 1, '2026-01-17T00:00:00.000Z'),
+      ('Second Post', 'Another post here', 2, '2026-01-17T00:00:00.000Z'),
+      ('Third Post', 'Yet another post', 1, '2026-01-17T00:00:00.000Z')
+  `);
+
+  const executor = createSqliteExecutor(createSqliteClient(db));
+  orm = new Orm({
+    dialect: new SqliteDialect(),
+    executorFactory: {
+      createExecutor: () => executor,
+      createTransactionalExecutor: () => executor,
+      dispose: async () => {}
+    }
+  });
+}
+
+export function createSession() {
+  if (!orm) {
+    throw new Error("ORM not initialized");
+  }
+  return orm.createSession();
+}

package/examples/metal-orm-sqlite/index.ts

@@ -0,0 +1,6 @@
+import { start } from "./app";
+
+start().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});