arkos 2.0.0-next.17 → 2.0.0-next.19

package/dist/cjs/modules/swagger/utils/helpers/openapi-schema-converter.js

@@ -1,333 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const dynamic_loader_1 = require("../../../../utils/dynamic-loader.js");
-const zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
-const class_validator_to_json_schema_1 = __importDefault(require("./class-validator-to-json-schema.js"));
-const server_1 = require("../../../../server.js");
-class OpenAPIchemaConverter {
-    constructor() {
-        this.validatorToJsonSchema = (schema) => {
-            const validationResolver = (0, server_1.getArkosConfig)()?.validation?.resolver;
-            const fn = validationResolver === "zod"
-                ? zod_to_json_schema_1.default
-                : class_validator_to_json_schema_1.default;
-            return fn(schema);
-        };
-    }
-    isSchemaLike(value) {
-        if (!value)
-            return false;
-        if ((0, dynamic_loader_1.isZodSchema)(value))
-            return true;
-        if ((0, dynamic_loader_1.isClass)(value))
-            return true;
-        if (this.isPlainObject(value) && value.type)
-            return true;
-        return false;
-    }
-    isPlainObject(value) {
-        return Object.prototype.toString.call(value) === "[object Object]";
-    }
-    convertToJsonSchema(schema) {
-        if (this.isPlainObject(schema) && schema?.type)
-            return schema;
-        if ((0, dynamic_loader_1.isZodSchema)(schema) || (0, dynamic_loader_1.isClass)(schema))
-            return this.validatorToJsonSchema(schema);
-        throw new Error(`Unsupported schema type. Expected Zod schema, class constructor, or JSON Schema object.`);
-    }
-    getDefaultDescription(statusCode) {
-        const defaults = {
-            "200": "Success",
-            "201": "Created",
-            "202": "Accepted",
-            "204": "No Content",
-            "400": "Bad Request",
-            "401": "Unauthorized",
-            "403": "Forbidden",
-            "404": "Not Found",
-            "409": "Conflict",
-            "422": "Unprocessable Entity",
-            "500": "Internal Server Error",
-            "502": "Bad Gateway",
-            "503": "Service Unavailable",
-        };
-        return defaults[statusCode] || "Response";
-    }
-    flattenSchemaCore(schema, prefix = "", visitedRefs = new Set()) {
-        const flattened = [];
-        if (schema.$ref) {
-            const refPath = schema.$ref;
-            if (visitedRefs.has(refPath))
-                return flattened;
-            visitedRefs.add(refPath);
-            const resolvedSchema = this.resolveRef(schema, refPath);
-            if (resolvedSchema) {
-                flattened.push(...this.flattenSchemaCore(resolvedSchema, prefix, visitedRefs));
-            }
-            visitedRefs.delete(refPath);
-            return flattened;
-        }
-        if (schema.type === "array" && schema.items) {
-            const arrayPrefix = prefix && schema.items?.format === "binary" ? prefix : `${prefix}[0]`;
-            if (schema.items.type === "array") {
-                flattened.push(...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs));
-            }
-            else if (schema.items.properties || schema.items.type === "object") {
-                flattened.push(...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs));
-            }
-            else if (schema.items.type || schema.items.$ref) {
-                flattened.push({
-                    name: arrayPrefix,
-                    schema: {
-                        type: schema.items.type,
-                        ...(schema.items.enum && { enum: schema.items.enum }),
-                        ...(schema.items.format && { format: schema.items.format }),
-                    },
-                    required: false,
-                });
-            }
-            return flattened;
-        }
-        if ((schema.type === "object" || !schema.type) && schema.properties) {
-            for (const [key, value] of Object.entries(schema.properties)) {
-                const paramName = prefix ? `${prefix}[${key}]` : key;
-                if (value.$ref) {
-                    const refPath = value.$ref;
-                    if (visitedRefs.has(refPath))
-                        continue;
-                    visitedRefs.add(refPath);
-                    const resolvedSchema = this.resolveRef(schema, refPath);
-                    if (resolvedSchema) {
-                        flattened.push(...this.flattenSchemaCore(resolvedSchema, paramName, visitedRefs));
-                    }
-                    visitedRefs.delete(refPath);
-                }
-                else if (value.type === "array" && value.items) {
-                    const arrayPrefix = paramName && value.items?.format == "binary"
-                        ? paramName
-                        : `${paramName}[0]`;
-                    if (value.items.type === "array") {
-                        flattened.push(...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs));
-                    }
-                    else if (value.items.type === "object" || value.items.properties) {
-                        flattened.push(...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs));
-                    }
-                    else {
-                        flattened.push({
-                            name: arrayPrefix,
-                            schema: {
-                                type: value.items.type,
-                                ...(value.items.enum && { enum: value.items.enum }),
-                                ...(value.items.format && { format: value.items.format }),
-                            },
-                            required: false,
-                        });
-                    }
-                }
-                else if (value.type === "object" && value.properties) {
-                    flattened.push(...this.flattenSchemaCore(value, paramName, visitedRefs));
-                }
-                else {
-                    flattened.push({
-                        name: paramName,
-                        schema: {
-                            type: value.type,
-                            ...(value.enum && { enum: value.enum }),
-                            ...(value.format && { format: value.format }),
-                        },
-                        required: schema.required?.includes(key) || false,
-                    });
-                }
-            }
-            return flattened;
-        }
-        if (schema.type && prefix) {
-            flattened.push({
-                name: prefix,
-                schema: {
-                    type: schema.type,
-                    ...(schema.enum && { enum: schema.enum }),
-                    ...(schema.format && { format: schema.format }),
-                },
-                required: false,
-            });
-        }
-        return flattened;
-    }
-    flattenSchema(schema) {
-        const flattened = this.flattenSchemaCore(schema);
-        const flattenedSchema = {
-            ...schema,
-            properties: {},
-            required: [],
-        };
-        for (const item of flattened) {
-            flattenedSchema.properties[item.name] = item.schema;
-            if (item.required) {
-                flattenedSchema.required.push(item.name);
-            }
-        }
-        if (flattenedSchema.required.length === 0) {
-            delete flattenedSchema.required;
-        }
-        return flattenedSchema;
-    }
-    convertResponseDefinition(statusCode, definition) {
-        if (!definition.content && this.isSchemaLike(definition)) {
-            return {
-                description: this.getDefaultDescription(statusCode),
-                content: {
-                    "application/json": {
-                        schema: this.convertToJsonSchema(definition),
-                    },
-                },
-            };
-        }
-        if (definition.content && this.isSchemaLike(definition.content)) {
-            return {
-                description: definition.description || this.getDefaultDescription(statusCode),
-                content: {
-                    "application/json": {
-                        schema: this.convertToJsonSchema(definition.content),
-                    },
-                },
-                ...(definition.headers && { headers: definition.headers }),
-                ...(definition.links && { links: definition.links }),
-            };
-        }
-        if (definition.content) {
-            const converted = {
-                description: definition.description || this.getDefaultDescription(statusCode),
-                content: {},
-            };
-            for (const [mediaType, mediaObj] of Object.entries(definition.content)) {
-                converted.content[mediaType] = {
-                    ...mediaObj,
-                    schema: this.convertToJsonSchema(mediaObj.schema),
-                };
-            }
-            if (definition.headers)
-                converted.headers = definition.headers;
-            if (definition.links)
-                converted.links = definition.links;
-            return converted;
-        }
-        return definition;
-    }
-    convertRequestBodyDefinition(definition) {
-        if (!definition)
-            return undefined;
-        if (!definition.content && this.isSchemaLike(definition)) {
-            return {
-                required: true,
-                content: {
-                    "application/json": {
-                        schema: this.convertToJsonSchema(definition),
-                    },
-                },
-            };
-        }
-        if (definition.content && this.isSchemaLike(definition.content)) {
-            return {
-                required: definition.required === false ? false : true,
-                description: definition.description,
-                content: {
-                    "application/json": {
-                        schema: this.convertToJsonSchema(definition.content),
-                    },
-                },
-            };
-        }
-        if (definition.content) {
-            const converted = {
-                required: definition.required ?? true,
-                content: {},
-            };
-            if (definition.description)
-                converted.description = definition.description;
-            for (const [mediaType, mediaObj] of Object.entries(definition.content)) {
-                const jsonSchema = this.convertToJsonSchema(mediaObj.schema);
-                if (mediaType === "multipart/form-data") {
-                    converted.content[mediaType] = {
-                        ...mediaObj,
-                        schema: this.flattenSchema(jsonSchema),
-                    };
-                }
-                else {
-                    converted.content[mediaType] = {
-                        ...mediaObj,
-                        schema: jsonSchema,
-                    };
-                }
-            }
-            return converted;
-        }
-        return definition;
-    }
-    convertParameters(parameters) {
-        if (!parameters)
-            return undefined;
-        return parameters.map((param) => {
-            if (param.$ref)
-                return param;
-            if (param.schema)
-                return {
-                    ...param,
-                    schema: this.convertToJsonSchema(param.schema),
-                };
-            return param;
-        });
-    }
-    convertResponses(responses) {
-        if (!responses)
-            return undefined;
-        const converted = {};
-        for (const [statusCode, definition] of Object.entries(responses)) {
-            converted[statusCode] = this.convertResponseDefinition(statusCode, definition);
-        }
-        return converted;
-    }
-    convertOpenAPIConfig(config) {
-        if (!config || config === false)
-            return config;
-        const converted = { ...config };
-        if (config.responses)
-            converted.responses = this.convertResponses(config.responses);
-        if (config.requestBody)
-            converted.requestBody = this.convertRequestBodyDefinition(config.requestBody);
-        if (config.parameters)
-            converted.parameters = this.convertParameters(config.parameters);
-        return converted;
-    }
-    jsonSchemaToOpenApiParameters(paramType, schema, prefix = "", visitedRefs = new Set()) {
-        const flattened = this.flattenSchemaCore(schema, prefix, visitedRefs);
-        return flattened.map(({ name, schema, required }) => ({
-            in: paramType,
-            name,
-            required,
-            schema,
-        }));
-    }
-    resolveRef(rootSchema, refPath) {
-        if (!refPath.startsWith("#/properties/")) {
-            return null;
-        }
-        const path = refPath.substring(2).split("/");
-        let current = rootSchema;
-        for (const part of path) {
-            if (current && current[part] !== undefined) {
-                current = current[part];
-            }
-            else {
-                return null;
-            }
-        }
-        return current;
-    }
-}
-const openApiSchemaConverter = new OpenAPIchemaConverter();
-exports.default = openApiSchemaConverter;
-//# sourceMappingURL=openapi-schema-converter.js.map

package/dist/cjs/modules/swagger/utils/helpers/openapi-schema-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi-schema-converter.js","sourceRoot":"","sources":["../../../../../../src/modules/swagger/utils/helpers/openapi-schema-converter.ts"],"names":[],"mappings":"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","sourcesContent":["import { OpenAPIV3 } from \"openapi-types\";\nimport { isClass, isZodSchema } from \"../../../../utils/dynamic-loader\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport classValidatorToJsonSchema from \"./class-validator-to-json-schema\";\nimport { getArkosConfig } from \"../../../../server\";\n\n/**\n * Singleton class responsible for converting various schema formats (Zod, Class DTOs, JSON Schema)\n * into OpenAPI-compliant schema objects. Handles shorthand syntax for responses, request bodies,\n * and parameters.\n */\nclass OpenAPIchemaConverter {\n  private validatorToJsonSchema: (schema: any) => any;\n\n  constructor() {\n    this.validatorToJsonSchema = (schema: any) => {\n      const validationResolver = getArkosConfig()?.validation?.resolver;\n      const fn =\n        validationResolver === \"zod\"\n          ? zodToJsonSchema\n          : classValidatorToJsonSchema;\n\n      return fn(schema);\n    };\n  }\n\n  /**\n   * Checks if a value is a schema-like object (Zod, Class, or JSON Schema).\n   *\n   * @param value - The value to check\n   * @returns True if the value is a schema-like object\n   */\n  private isSchemaLike(value: any): boolean {\n    if (!value) return false;\n\n    if (isZodSchema(value)) return true;\n\n    if (isClass(value)) return true;\n\n    if (this.isPlainObject(value) && value.type) return true;\n\n    return false;\n  }\n\n  /**\n   * Checks if a value is a plain JavaScript object.\n   *\n   * @param value - The value to check\n   * @returns True if the value is a plain object\n   */\n  private isPlainObject(value: any): boolean {\n    return Object.prototype.toString.call(value) === \"[object Object]\";\n  }\n\n  /**\n   * Converts a schema-like object (Zod, Class, or JSON Schema) into a JSON Schema object.\n   *\n   * @param schema - The schema to convert\n   * @returns The JSON Schema representation, or undefined if schema is null/undefined\n   */\n  private convertToJsonSchema(schema: any): any {\n    if (this.isPlainObject(schema) && schema?.type) return schema;\n\n    if (isZodSchema(schema) || isClass(schema))\n      return this.validatorToJsonSchema(schema);\n\n    throw new Error(\n      `Unsupported schema type. Expected Zod schema, class constructor, or JSON Schema object.`\n    );\n  }\n\n  /**\n   * Gets the default description for an HTTP status code.\n   *\n   * @param statusCode - The HTTP status code\n   * @returns A human-readable default description\n   */\n  private getDefaultDescription(statusCode: string): string {\n    const defaults: Record<string, string> = {\n      \"200\": \"Success\",\n      \"201\": \"Created\",\n      \"202\": \"Accepted\",\n      \"204\": \"No Content\",\n      \"400\": \"Bad Request\",\n      \"401\": \"Unauthorized\",\n      \"403\": \"Forbidden\",\n      \"404\": \"Not Found\",\n      \"409\": \"Conflict\",\n      \"422\": \"Unprocessable Entity\",\n      \"500\": \"Internal Server Error\",\n      \"502\": \"Bad Gateway\",\n      \"503\": \"Service Unavailable\",\n    };\n\n    return defaults[statusCode] || \"Response\";\n  }\n\n  /**\n   * Core flattening logic that converts a JSON schema into bracket notation.\n   * Handles nested objects, arrays, and circular references.\n   *\n   * @param schema - The JSON schema to flatten\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of flattened field descriptors\n   */\n  flattenSchemaCore(\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ): Array<{ name: string; schema: any; required: boolean }> {\n    const flattened: Array<{ name: string; schema: any; required: boolean }> =\n      [];\n\n    if (schema.$ref) {\n      const refPath = schema.$ref;\n      if (visitedRefs.has(refPath)) return flattened;\n\n      visitedRefs.add(refPath);\n      const resolvedSchema = this.resolveRef(schema, refPath);\n      if (resolvedSchema) {\n        flattened.push(\n          ...this.flattenSchemaCore(resolvedSchema, prefix, visitedRefs)\n        );\n      }\n      visitedRefs.delete(refPath);\n      return flattened;\n    }\n\n    if (schema.type === \"array\" && schema.items) {\n      const arrayPrefix =\n        prefix && schema.items?.format === \"binary\" ? prefix : `${prefix}[0]`;\n\n      // Check if items is an array FIRST, before checking for object\n      if (schema.items.type === \"array\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.properties || schema.items.type === \"object\") {\n        flattened.push(\n          ...this.flattenSchemaCore(schema.items, arrayPrefix, visitedRefs)\n        );\n      } else if (schema.items.type || schema.items.$ref) {\n        flattened.push({\n          name: arrayPrefix,\n          schema: {\n            type: schema.items.type,\n            ...(schema.items.enum && { enum: schema.items.enum }),\n            ...(schema.items.format && { format: schema.items.format }),\n          },\n          required: false,\n        });\n      }\n\n      return flattened;\n    }\n\n    if ((schema.type === \"object\" || !schema.type) && schema.properties) {\n      for (const [key, value] of Object.entries(schema.properties) as any) {\n        const paramName = prefix ? `${prefix}[${key}]` : key;\n\n        if (value.$ref) {\n          const refPath = value.$ref;\n          if (visitedRefs.has(refPath)) continue;\n\n          visitedRefs.add(refPath);\n          const resolvedSchema = this.resolveRef(schema, refPath);\n\n          if (resolvedSchema) {\n            flattened.push(\n              ...this.flattenSchemaCore(resolvedSchema, paramName, visitedRefs)\n            );\n          }\n          visitedRefs.delete(refPath);\n        } else if (value.type === \"array\" && value.items) {\n          const arrayPrefix =\n            paramName && value.items?.format == \"binary\"\n              ? paramName\n              : `${paramName}[0]`;\n\n          if (value.items.type === \"array\") {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else if (value.items.type === \"object\" || value.items.properties) {\n            flattened.push(\n              ...this.flattenSchemaCore(value.items, arrayPrefix, visitedRefs)\n            );\n          } else {\n            flattened.push({\n              name: arrayPrefix,\n              schema: {\n                type: value.items.type,\n                ...(value.items.enum && { enum: value.items.enum }),\n                ...(value.items.format && { format: value.items.format }),\n              },\n              required: false,\n            });\n          }\n        } else if (value.type === \"object\" && value.properties) {\n          flattened.push(\n            ...this.flattenSchemaCore(value, paramName, visitedRefs)\n          );\n        } else {\n          flattened.push({\n            name: paramName,\n            schema: {\n              type: value.type,\n              ...(value.enum && { enum: value.enum }),\n              ...(value.format && { format: value.format }),\n            },\n            required: schema.required?.includes(key) || false,\n          });\n        }\n      }\n      return flattened;\n    }\n\n    // Handle primitive types with prefix\n    if (schema.type && prefix) {\n      flattened.push({\n        name: prefix,\n        schema: {\n          type: schema.type,\n          ...(schema.enum && { enum: schema.enum }),\n          ...(schema.format && { format: schema.format }),\n        },\n        required: false,\n      });\n    }\n\n    return flattened;\n  }\n\n  /**\n   * Flattens a JSON schema while preserving the schema structure.\n   * Converts nested objects and arrays into bracket notation properties.\n   * Used for multipart/form-data schema representation.\n   *\n   * @param schema - The JSON schema to flatten\n   * @returns A flattened schema object with bracket notation properties\n   */\n  flattenSchema(schema: any): any {\n    const flattened = this.flattenSchemaCore(schema);\n\n    // Convert the flattened array into a schema object\n    const flattenedSchema: any = {\n      ...schema,\n      properties: {},\n      required: [],\n    };\n\n    for (const item of flattened) {\n      flattenedSchema.properties[item.name] = item.schema;\n      if (item.required) {\n        flattenedSchema.required.push(item.name);\n      }\n    }\n\n    // Remove empty required array if no required fields\n    if (flattenedSchema.required.length === 0) {\n      delete flattenedSchema.required;\n    }\n\n    return flattenedSchema;\n  }\n\n  /**\n   * Converts a response definition (shorthand, medium, or full format) into a standard\n   * OpenAPI ResponseObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: ProfileDto → assumes application/json + default description\n   * 2. Medium: { content: ProfileDto, description: \"...\" } → custom description\n   * 3. Full: { content: { \"application/json\": { schema: ProfileDto } } } → full control\n   *\n   * @param statusCode - The HTTP status code for this response\n   * @param definition - The response definition to convert\n   * @returns A standard OpenAPI ResponseObject\n   */\n  convertResponseDefinition(\n    statusCode: string,\n    definition: any\n  ): OpenAPIV3.ResponseObject {\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        description: this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n        ...(definition.headers && { headers: definition.headers }),\n        ...(definition.links && { links: definition.links }),\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.ResponseObject = {\n        description:\n          definition.description || this.getDefaultDescription(statusCode),\n        content: {},\n      };\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        converted.content![mediaType] = {\n          ...mediaObj,\n          schema: this.convertToJsonSchema(mediaObj.schema),\n        };\n      }\n\n      if (definition.headers) converted.headers = definition.headers;\n      if (definition.links) converted.links = definition.links;\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts a request body definition (shorthand, medium, or full format) into a standard\n   * OpenAPI RequestBodyObject.\n   *\n   * Supports three formats:\n   * 1. Shorthand: CreateUserDto → assumes application/json + required: true\n   * 2. Medium: { content: CreateUserDto, required?: boolean } → custom config\n   * 3. Full: { content: { \"application/json\": { schema: CreateUserDto } } } → full control\n   *\n   * For multipart/form-data, automatically converts the schema into an array of parameters.\n   *\n   * @param definition - The request body definition to convert\n   * @returns A standard OpenAPI RequestBodyObject, or undefined if no definition provided\n   */\n  convertRequestBodyDefinition(\n    definition: any\n  ): OpenAPIV3.RequestBodyObject | undefined {\n    if (!definition) return undefined;\n\n    if (!definition.content && this.isSchemaLike(definition)) {\n      return {\n        required: true,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition),\n          },\n        },\n      };\n    }\n\n    if (definition.content && this.isSchemaLike(definition.content)) {\n      return {\n        required: definition.required === false ? false : true,\n        description: definition.description,\n        content: {\n          \"application/json\": {\n            schema: this.convertToJsonSchema(definition.content),\n          },\n        },\n      };\n    }\n\n    if (definition.content) {\n      const converted: OpenAPIV3.RequestBodyObject = {\n        required: definition.required ?? true,\n        content: {},\n      };\n\n      if (definition.description)\n        converted.description = definition.description;\n\n      for (const [mediaType, mediaObj] of Object.entries(\n        definition.content\n      ) as any[]) {\n        const jsonSchema = this.convertToJsonSchema(mediaObj.schema);\n\n        // For multipart/form-data, flatten the schema into bracket notation\n        if (mediaType === \"multipart/form-data\") {\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: this.flattenSchema(jsonSchema),\n          };\n        } else {\n          // For other media types (like application/json), keep the full schema\n          converted.content[mediaType] = {\n            ...mediaObj,\n            schema: jsonSchema,\n          };\n        }\n      }\n\n      return converted;\n    }\n\n    return definition;\n  }\n\n  /**\n   * Converts an array of parameter definitions, transforming any Zod/Class schemas\n   * into JSON Schema objects.\n   *\n   * @param parameters - Array of parameter definitions to convert\n   * @returns Array of standard OpenAPI ParameterObjects, or undefined if no parameters provided\n   */\n  convertParameters(\n    parameters: any[] | undefined\n  ): (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined {\n    if (!parameters) return undefined;\n\n    return parameters.map((param) => {\n      if (param.$ref) return param;\n\n      if (param.schema)\n        return {\n          ...param,\n          schema: this.convertToJsonSchema(param.schema),\n        };\n\n      return param;\n    });\n  }\n\n  /**\n   * Converts all responses in a responses object, handling shorthand, medium, and full formats.\n   *\n   * @param responses - Object containing response definitions keyed by status code\n   * @returns Object with converted OpenAPI ResponseObjects\n   */\n  convertResponses(\n    responses: Record<string, any> | undefined\n  ): Record<string, OpenAPIV3.ResponseObject> | undefined {\n    if (!responses) return undefined;\n\n    const converted: Record<string, OpenAPIV3.ResponseObject> = {};\n\n    for (const [statusCode, definition] of Object.entries(responses)) {\n      converted[statusCode] = this.convertResponseDefinition(\n        statusCode,\n        definition\n      );\n    }\n\n    return converted;\n  }\n\n  /**\n   * Converts a complete OpenAPI operation configuration, processing responses, requestBody,\n   * and parameters to handle shorthand syntax and schema conversions.\n   *\n   * @param config - The OpenAPI operation configuration to convert\n   * @returns The converted configuration with all schemas transformed to JSON Schema\n   */\n  convertOpenAPIConfig(config: any): any {\n    if (!config || config === false) return config;\n\n    const converted = { ...config };\n\n    if (config.responses)\n      converted.responses = this.convertResponses(config.responses);\n\n    if (config.requestBody)\n      converted.requestBody = this.convertRequestBodyDefinition(\n        config.requestBody\n      );\n\n    if (config.parameters)\n      converted.parameters = this.convertParameters(config.parameters);\n\n    return converted;\n  }\n\n  /**\n   * Converts a JSON schema to OpenAPI parameter objects with flattened paths.\n   * This is used for query/path/header parameters.\n   *\n   * @param paramType - The parameter location (query, path, header, cookie)\n   * @param schema - The JSON schema to convert\n   * @param prefix - Optional prefix for nested properties\n   * @param visitedRefs - Set to track circular references\n   * @returns Array of OpenAPI parameter objects\n   */\n  jsonSchemaToOpenApiParameters(\n    paramType: string,\n    schema: any,\n    prefix = \"\",\n    visitedRefs = new Set<string>()\n  ) {\n    const flattened = this.flattenSchemaCore(schema, prefix, visitedRefs);\n\n    return flattened.map(({ name, schema, required }) => ({\n      in: paramType,\n      name,\n      required,\n      schema,\n    }));\n  }\n\n  resolveRef(rootSchema: any, refPath: string): any {\n    if (!refPath.startsWith(\"#/properties/\")) {\n      return null;\n    }\n\n    const path = refPath.substring(2).split(\"/\");\n    let current = rootSchema;\n\n    for (const part of path) {\n      if (current && current[part] !== undefined) {\n        current = current[part];\n      } else {\n        return null;\n      }\n    }\n\n    return current;\n  }\n}\n\nconst openApiSchemaConverter = new OpenAPIchemaConverter();\n\nexport default openApiSchemaConverter;\n"]}

package/dist/cjs/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}

package/dist/cjs/server.js

@@ -1,60 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getArkosConfig = getArkosConfig;
-exports.logAppStartup = logAppStartup;
-const sheu_1 = __importDefault(require("./utils/sheu.js"));
-const port_and_host_allocator_1 = __importDefault(require("./utils/features/port-and-host-allocator.js"));
-const arkos_config_helpers_1 = require("./utils/helpers/arkos-config.helpers.js");
-const app_1 = require("./app.js");
-function getArkosConfig() {
-    return (0, arkos_config_helpers_1.getArkosConfig)();
-}
-process.on("uncaughtException", (err) => {
-    if (err.message.includes("EPIPE"))
-        return;
-    if (process.env.NO_CLI === "true")
-        sheu_1.default.error("UNCAUGHT EXCEPTION! SHUTTING DOWN...\n", {
-            timestamp: true,
-            bold: true,
-        });
-    console.error(err);
-    setTimeout(() => {
-        process.exit(1);
-    }, 0);
-});
-process.on("unhandledRejection", (err) => {
-    if (process.env.NO_CLI === "true" && process.env.__SKIP_LISTEN !== "true")
-        sheu_1.default.error("UNHANDLED REJECTION! SHUTTING DOWN...\n", {
-            timestamp: true,
-            bold: true,
-        });
-    console.error(err);
-    const server = (0, app_1.getAppServer)();
-    if (server?.close)
-        server?.close(() => {
-            process.exit(1);
-        });
-    else
-        setTimeout(() => {
-            process.exit(1);
-        }, 0);
-});
-function logAppStartup(port, _host) {
-    let networkHost = port_and_host_allocator_1.default.getFirstNonLocalIp();
-    const config = getArkosConfig();
-    const host = ["0.0.0.0", "127.0.0.1"].includes(_host) ? "localhost" : _host;
-    const time = new Date().toTimeString().split(" ")[0];
-    const message = `${sheu_1.default.gray(time)} {{server}} waiting on http://${host}:${port}`;
-    sheu_1.default.ready(message.replace("{{server}}", `${process.env.ARKOS_BUILD === "true" ? "Production" : "Development"} server`));
-    if (networkHost && _host === "0.0.0.0")
-        sheu_1.default.ready(message.replace(host, networkHost).replace("{{server}}", `Network server`));
-    if (config?.swagger &&
-        ((config?.swagger?.enableAfterBuild &&
-            process.env.ARKOS_BUILD === "true") ||
-            process.env.ARKOS_BUILD !== "true"))
-        sheu_1.default.ready(`${message.replace("{{server}}", "Documentation")}${config?.swagger?.endpoint || "/api/docs"}`);
-}
-//# sourceMappingURL=server.js.map

package/dist/cjs/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import AppError from \"./modules/error-handler/utils/app-error\";\nimport sheu from \"./utils/sheu\";\nimport portAndHostAllocator from \"./utils/features/port-and-host-allocator\";\nimport { getArkosConfig as getArkosConfigHelper } from \"./utils/helpers/arkos-config.helpers\";\nimport { UserArkosConfig } from \"./utils/define-config\";\nimport { getAppServer } from \"./app\";\n\n/**\n * Gives access to the underlying current configurations being used by **Arkos** by default and also loaded through `arkos.config.{ts|js}`\n *\n * @returns {ArkosConfig}\n */\nexport function getArkosConfig(): UserArkosConfig {\n  // This was kept only not to require many changes on the given time\n  return getArkosConfigHelper();\n}\n\nprocess.on(\"uncaughtException\", (err) => {\n  if (err.message.includes(\"EPIPE\")) return;\n\n  if (process.env.NO_CLI === \"true\")\n    sheu.error(\"UNCAUGHT EXCEPTION! SHUTTING DOWN...\\n\", {\n      timestamp: true,\n      bold: true,\n    });\n\n  console.error(err);\n  setTimeout(() => {\n    process.exit(1);\n  }, 0);\n});\n\nprocess.on(\"unhandledRejection\", (err: AppError) => {\n  if (process.env.NO_CLI === \"true\" && process.env.__SKIP_LISTEN !== \"true\")\n    sheu.error(\"UNHANDLED REJECTION! SHUTTING DOWN...\\n\", {\n      timestamp: true,\n      bold: true,\n    });\n  console.error(err);\n\n  const server = getAppServer();\n\n  if (server?.close)\n    server?.close(() => {\n      process.exit(1);\n    });\n  else\n    setTimeout(() => {\n      process.exit(1);\n    }, 0);\n});\n\nexport function logAppStartup(port: number | string, _host: string) {\n  let networkHost = portAndHostAllocator.getFirstNonLocalIp();\n  const config = getArkosConfig();\n\n  const host = [\"0.0.0.0\", \"127.0.0.1\"].includes(_host) ? \"localhost\" : _host;\n  const time = new Date().toTimeString().split(\" \")[0];\n\n  const message = `${sheu.gray(time)} {{server}} waiting on http://${host}:${port}`;\n\n  sheu.ready(\n    message.replace(\n      \"{{server}}\",\n      `${process.env.ARKOS_BUILD === \"true\" ? \"Production\" : \"Development\"} server`\n    )\n  );\n  if (networkHost && _host === \"0.0.0.0\")\n    sheu.ready(\n      message.replace(host, networkHost).replace(\"{{server}}\", `Network server`)\n    );\n  if (\n    config?.swagger &&\n    ((config?.swagger?.enableAfterBuild &&\n      process.env.ARKOS_BUILD === \"true\") ||\n      process.env.ARKOS_BUILD !== \"true\")\n  )\n    sheu.ready(\n      `${message.replace(\"{{server}}\", \"Documentation\")}${config?.swagger?.endpoint || \"/api/docs\"}`\n    );\n}\n"]}

package/dist/cjs/types/arkos-config/utils.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=utils.js.map

package/dist/cjs/types/arkos-config/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/types/arkos-config/utils.ts"],"names":[],"mappings":"","sourcesContent":["import { ArkosRequest } from \"..\";\nimport { AccessAction, DetailedAccessControlRule } from \"../auth\";\n\n/** Context passed to `before` hooks of `authenticate`. */\nexport interface AuthenticateBeforeHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n  /** Bypasses core logic and jumps directly to `after` hooks. */\n  skip: () => void;\n}\n\n/** Context passed to `after` hooks of `authenticate`. */\nexport interface AuthenticateAfterHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n}\n\n/** Context passed to `onError` hooks of `authenticate`. */\nexport interface AuthenticateErrorHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n  /** The error thrown during authentication. */\n  error: unknown;\n  /** Suppresses the error and jumps to `after` hooks. */\n  skip: () => void;\n}\n\nexport type AuthenticateHookHandler = (\n  ctx: AuthenticateBeforeHookContext\n) => void | Promise<void>;\n\nexport type AuthenticateAfterHookHandler = (\n  ctx: AuthenticateAfterHookContext\n) => void | Promise<void>;\n\nexport type AuthenticateErrorHookHandler = (\n  ctx: AuthenticateErrorHookContext\n) => void | Promise<void>;\n\n/** Context passed to `before` hooks of `authorize`. */\nexport interface AuthorizeBeforeHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n  /** The action being authorized (e.g. `\"Create\"`, `\"Delete\"`). */\n  action: AccessAction;\n  /** The resource being accessed in kebab-case (e.g. `\"post\"`, `\"cart-item\"`). */\n  resource: string;\n  /** The access control rule for this action. */\n  rule?: string[] | DetailedAccessControlRule | \"*\";\n  /** Bypasses core logic and jumps directly to `after` hooks. */\n  skip: () => void;\n}\n\n/** Context passed to `after` hooks of `authorize`. */\nexport interface AuthorizeAfterHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n  /** The action that was authorized (e.g. `\"Create\"`, `\"Delete\"`). */\n  action: AccessAction;\n  /** The resource that was accessed in kebab-case (e.g. `\"post\"`, `\"cart-item\"`). */\n  resource: string;\n  /** The access control rule that was applied. */\n  rule?: string[] | DetailedAccessControlRule | \"*\";\n}\n\n/** Context passed to `onError` hooks of `authorize`. */\nexport interface AuthorizeErrorHookContext {\n  /** The incoming request object. */\n  req: ArkosRequest;\n  /** The error thrown during authorization. */\n  error: unknown;\n  /** The action being authorized (e.g. `\"Create\"`, `\"Delete\"`). */\n  action: AccessAction;\n  /** The resource being accessed in kebab-case (e.g. `\"post\"`, `\"cart-item\"`). */\n  resource: string;\n  /** The access control rule for this action. */\n  rule?: string[] | DetailedAccessControlRule | \"*\";\n  /** Suppresses the error and jumps to `after` hooks. */\n  skip: () => void;\n}\n\nexport type AuthorizeHookHandler = (\n  ctx: AuthorizeBeforeHookContext\n) => void | Promise<void>;\n\nexport type AuthorizeAfterHookHandler = (\n  ctx: AuthorizeAfterHookContext\n) => void | Promise<void>;\n\nexport type AuthorizeErrorHookHandler = (\n  ctx: AuthorizeErrorHookContext\n) => void | Promise<void>;\n"]}

package/dist/cjs/types/arkos-prisma-input.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=arkos-prisma-input.js.map

package/dist/cjs/types/arkos-prisma-input.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arkos-prisma-input.js","sourceRoot":"","sources":["../../../src/types/arkos-prisma-input.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Helper type to exclude properties from T that exist in U\n * Used internally by XOR to create mutually exclusive types\n */\ntype Without<T, U> = {\n  [P in Exclude<keyof T, keyof U>]?: never;\n};\n/**\n * XOR (Exclusive OR) type for mutually exclusive union types\n * Ensures that properties from T and U cannot be mixed together\n * @see https://stackoverflow.com/questions/42123407/does-typescript-support-mutually-exclusive-types\n */\ntype XOR<T, U> = T extends object\n  ? U extends object\n    ? (Without<T, U> & U) | (Without<U, T> & T)\n    : U\n  : T;\ntype Unpack<T> = T;\n/**\n * Checks if a field is an array relation (one-to-many or many-to-many)\n * Identified by the presence of createMany property\n */\nexport type IsArrayRelation<T> =\n  Exclude<T, undefined> extends never\n    ? false\n    : Exclude<T, undefined> extends { createMany?: any }\n      ? true\n      : false;\n/**\n * Checks if a field is an object relation (one-to-one or many-to-one)\n * Identified by the presence of relation operations without being an array\n */\nexport type IsObjectRelation<T> =\n  Exclude<T, undefined> extends Array<any>\n    ? false\n    : Exclude<T, undefined> extends\n          | {\n              create?: any;\n            }\n          | {\n              connect?: any;\n            }\n          | {\n              connectOrCreate?: any;\n            }\n          | {\n              update?: any;\n            }\n          | {\n              delete?: any;\n            }\n          | {\n              disconnect?: any;\n            }\n      ? true\n      : false;\ntype ExtractCreateTypeArray<T> =\n  Exclude<T, undefined> extends {\n    create?: infer C;\n  }\n    ? Extract<C, Array<any>> extends Array<infer U>\n      ? U extends Array<infer I>\n        ? (Omit<I, \"OR\" | \"AND\" | \"NOT\"> & {\n            apiAction?: \"create\";\n          })[]\n        : (Omit<U, \"OR\" | \"AND\" | \"NOT\"> & {\n            apiAction?: \"create\";\n          })[]\n      : never\n    : never;\ntype ExtractConnectTypeArray<\n  T,\n  A extends\n    | \"connect\"\n    | \"delete\"\n    | \"update\"\n    | \"disconnect\"\n    | \"deleteMany\"\n    | \"set\",\n> =\n  Exclude<T, undefined> extends {\n    [k in A]?: infer C;\n  }\n    ? Extract<C, Array<any>> extends Array<infer U>\n      ? (Omit<U, \"OR\" | \"AND\" | \"NOT\"> & {\n          apiAction?: A;\n        })[]\n      : never\n    : never;\ntype ExtractUpdateTypeArray<T> =\n  Exclude<T, undefined> extends Array<infer Item>\n    ? Item extends {\n        update?: infer U;\n      }\n      ? U extends Array<infer UpdateItem>\n        ? UpdateItem extends {\n            where: infer W;\n            data: infer D;\n          }\n          ? ((W & D) & {\n              apiAction?: \"update\";\n            })[]\n          : never\n        : U extends {\n              where: infer W;\n              data: infer D;\n            }\n          ? ((W & D) & {\n              apiAction?: \"update\";\n            })[]\n          : never\n      : never\n    : never;\ntype ExtractCreateTypeObject<T> =\n  Exclude<T, undefined> extends {\n    create?: infer C;\n  }\n    ? Exclude<\n        Extract<Exclude<C, undefined>, object>,\n        Array<any>\n      > extends infer Obj\n      ? Obj extends object\n        ? Omit<Obj, \"OR\" | \"AND\" | \"NOT\"> & {\n            apiAction?: \"create\";\n          }\n        : never\n      : never\n    : never;\ntype ExtractConnectTypeObject<\n  T,\n  A extends \"connect\" | \"delete\" | \"update\" | \"disconnect\",\n> =\n  Exclude<T, undefined> extends {\n    [k in A]?: infer C;\n  }\n    ? Exclude<\n        Extract<Exclude<C, undefined>, object>,\n        Array<any>\n      > extends infer Obj\n      ? Obj extends object\n        ? Omit<Obj, \"OR\" | \"AND\" | \"NOT\"> & {\n            apiAction?: A;\n          }\n        : never\n      : never\n    : never;\ntype ExtractUpdateTypeObject<T> =\n  Exclude<T, undefined> extends {\n    update?: infer U;\n  }\n    ? U extends {\n        where: infer W;\n        data: infer D;\n      }\n      ? (W & D) & {\n          apiAction?: \"update\";\n        }\n      : Exclude<Extract<U, object>, Array<any>> & {\n          apiAction?: \"update\";\n        }\n    : never;\ntype FlattenArrayRelation<T> =\n  | (ExtractCreateTypeArray<T> extends never\n      ? never\n      : FlattenRelations<ExtractCreateTypeArray<T>>)\n  | (ExtractConnectTypeArray<T, \"connect\"> extends never\n      ? never\n      : FlattenRelations<ExtractConnectTypeArray<T, \"connect\">>)\n  | (ExtractUpdateTypeArray<T> extends never\n      ? never\n      : FlattenRelations<ExtractUpdateTypeArray<T>>)\n  | (Exclude<T, undefined> extends Array<infer Item>\n      ? Item extends {\n          delete?: any;\n        }\n        ? FlattenRelations<ExtractConnectTypeArray<T, \"delete\">> & {\n            apiAction: \"delete\";\n          }\n        : never\n      : never)\n  | (Exclude<T, undefined> extends Array<infer Item>\n      ? Item extends {\n          disconnect?: any;\n        }\n        ? FlattenRelations<ExtractConnectTypeArray<T, \"disconnect\">> & {\n            apiAction: \"disconnect\";\n          }\n        : never\n      : never)\n  | (Exclude<T, undefined> extends Array<infer Item>\n      ? Item extends {\n          set?: infer S;\n        }\n        ? Unpack<S> & {\n            apiAction?: \"set\";\n          }\n        : never\n      : never)\n  | (Exclude<T, undefined> extends Array<infer Item>\n      ? Item extends {\n          deleteMany?: any;\n        }\n        ? FlattenRelations<ExtractConnectTypeArray<T, \"deleteMany\">> & {\n            apiAction: \"deleteMany\";\n          }\n        : never\n      : never);\ntype FlattenObjectRelation<T> =\n  | (ExtractCreateTypeObject<T> extends never\n      ? never\n      : FlattenRelations<ExtractCreateTypeObject<T>>)\n  | (ExtractConnectTypeObject<T, \"connect\"> extends never\n      ? never\n      : FlattenRelations<ExtractConnectTypeObject<T, \"connect\">>)\n  | (ExtractUpdateTypeObject<T> extends never\n      ? never\n      : FlattenRelations<ExtractUpdateTypeObject<T>>)\n  | (Exclude<T, undefined> extends {\n      delete?: any;\n    }\n      ? FlattenRelations<ExtractConnectTypeObject<T, \"delete\">> & {\n          apiAction: \"delete\";\n        }\n      : never)\n  | (Exclude<T, undefined> extends {\n      disconnect?: any;\n    }\n      ? FlattenRelations<ExtractConnectTypeObject<T, \"disconnect\">> & {\n          apiAction: \"disconnect\";\n        }\n      : never)\n  | (Exclude<T, undefined> extends {\n      set?: infer S;\n    }\n      ? Unpack<S> & {\n          apiAction?: \"set\";\n        }\n      : never);\ntype StripPrismaFilters<T> = T extends\n  | { equals?: any }\n  | { in?: any }\n  | { notIn?: any }\n  | { lt?: any }\n  | { lte?: any }\n  | { gt?: any }\n  | { gte?: any }\n  | { AND?: any }\n  | { OR?: any }\n  | { NOT?: any }\n  ? Omit<\n      T,\n      | \"equals\"\n      | \"in\"\n      | \"notIn\"\n      | \"lt\"\n      | \"lte\"\n      | \"gt\"\n      | \"gte\"\n      | \"AND\"\n      | \"OR\"\n      | \"NOT\"\n    >\n  : T;\n\ntype StripToScalar<T> = T extends\n  | string\n  | number\n  | boolean\n  | Date\n  | null\n  | undefined\n  ? T\n  : never;\n\ntype FlattenRelations<T> = {\n  [K in keyof T]: IsArrayRelation<T[K]> extends true\n    ? FlattenArrayRelation<T[K]> | undefined\n    : IsObjectRelation<T[K]> extends true\n      ? XOR<FlattenObjectRelation<T[K]> | undefined, T[K]>\n      : StripPrismaFilters<T[K]> extends never\n        ? never\n        : T[K] extends object\n          ? T[K] extends Date | null | undefined\n            ? T[K]\n            : FlattenRelations<StripPrismaFilters<T[K]>> | undefined\n          : StripToScalar<T[K]> extends never\n            ? StripPrismaFilters<T[K]>\n            : StripToScalar<T[K]>;\n};\n/**\n * Flattens Prisma relation inputs into a simpler, developer-friendly format\n *\n * Transforms Prisma's nested relation format:\n * ```typescript\n * { posts: { create: [...], connect: [...], update: [...] } }\n * ```\n *\n * Into a flattened format with optional apiAction discriminators:\n * ```typescript\n * { posts: [\n *   { title: \"New Post\" },                    // auto-detected as create\n *   { id: 1 },                                 // auto-detected as connect\n *   { id: 2, title: \"Updated\", apiAction: \"update\" }\n * ]}\n * ```\n *\n * @see {@link https://wwww.arkosjs.com/docs/reference/arkos-prisma-input}\n * @template T - The Prisma input type (e.g., Prisma.UserCreateInput)\n * @returns A flattened version of the input type with simplified relation handling\n */\nexport type ArkosPrismaInput<T> = FlattenRelations<T>;\n"]}

package/dist/cjs/types/arkos.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=arkos.js.map

package/dist/cjs/types/arkos.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"arkos.js","sourceRoot":"","sources":["../../../src/types/arkos.ts"],"names":[],"mappings":"","sourcesContent":["import { Express } from \"express\";\nimport { IncomingMessage, Server, ServerResponse } from \"http\";\nimport {\n  ArkosAuthRouteHookInstance,\n  ArkosFileUploadRouteHookInstance,\n  ArkosRouteHookInstance,\n} from \"../components/arkos-route-hook/types\";\nimport { ArkosServiceHookInstance } from \"../components/arkos-service-hook/types\";\nimport { IArkosRouter } from \"../exports\";\n\ntype ArkosRouterMethods =\n  | \"get\"\n  | \"post\"\n  | \"put\"\n  | \"patch\"\n  | \"delete\"\n  | \"options\"\n  | \"head\"\n  | \"all\"\n  | \"use\"\n  | \"trace\"\n  | \"route\"\n  | \"use\"\n  | \"load\";\n\n/**\n * Creates and configures an Arkos application instance.\n *\n * Arkos extends Express with a small set of methods for registering routers,\n * loading route/service hooks, and booting the application. All Arkos-specific\n * setup (`app.build()`) must happen before the app starts\n * accepting requests.\n *\n * @example\n * ```ts\n * // Simple setup\n * import arkos from \"arkos\";\n *\n * const app = arkos();\n *\n * app.use(reportsRouter);\n *\n * app.listen();\n * ```\n *\n * @example\n * ```ts\n * // Custom HTTP server (e.g. for WebSockets)\n * import arkos from \"arkos\";\n * import http from \"http\";\n *\n * const app = arkos();\n *\n * app.use(reportsRouter);\n *\n * async function start() {\n *  await app.build();\n *\n *  const server = http.createServer(app);\n *  app.listen(server)\n * }\n * main()\n * ```\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/routing/setup}\n */\nexport interface Arkos\n  extends Omit<Express, \"listen\" | ArkosRouterMethods>,\n    Pick<IArkosRouter, ArkosRouterMethods> {\n  (req: IncomingMessage, res: ServerResponse): void;\n  /**\n   * Applies all loaded items to the app by adding them as middleware,\n   * routers, or handlers at the end of the stack.\n   *\n   * This ensures that Arkos internals always run after user middleware/routes.\n   * Automatically called before listen() if not called manually.\n   */\n  build(): this;\n\n  /**\n   * Starts the server using Arkos-managed port and host configuration.\n   * Automatically calls build() if not called manually.\n   *\n   * @param callback Optional callback invoked once server starts\n   */\n  listen(callback?: (error?: Error) => void): Promise<Server>;\n\n  /**\n   * Starts the server using Arkos-managed port and host configuration.\n   * app.build() must be called before this.\n   *\n   * @param server {Server} - Optional HTTP server to listen on\n   * @param callback Optional callback invoked once server starts\n   */\n  listen(server: Server, callback?: (error?: Error) => void): Promise<Server>;\n}\n\n/**\n * Union of all valid types that can be passed to `app.load()`.\n * Grows as new Arkos-specific loadable types are introduced.\n */\nexport type ArkosLoadable =\n  | ArkosRouteHookInstance<any>\n  | ArkosAuthRouteHookInstance\n  | ArkosFileUploadRouteHookInstance\n  | ArkosServiceHookInstance<any, any>;\n"]}

package/dist/cjs/types/auth.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=auth.js.map

package/dist/cjs/types/auth.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/types/auth.ts"],"names":[],"mappings":"","sourcesContent":["import { JwtPayload } from \"jsonwebtoken\";\nimport { UserRole } from \".\";\n\n/**\n * Base set of controller actions available to all controllers.\n *\n * @example\n * const action: AccessAction = \"Create\";\n * const customAction: AccessAction = \"export\"; // Custom action\n */\nexport type AccessAction = \"Create\" | \"Update\" | \"Delete\" | \"View\" | string;\n\nexport type DetailedAccessControlRule = {\n  /** Array of role names that have permission for this action */\n  roles?: UserRole[] | \"*\";\n  /** Human-readable name for this permission (optional) */\n  name?: string;\n  /** Detailed description of what this permission allows (optional) */\n  description?: string;\n  /** Detailed error message of what must be returned on forbidden response (optional)\n   *\n   * Note: not yet implemented\n   * */\n  errorMessage?: string;\n};\n\n/**\n * Rules defining access control for different controller actions.\n * The array contains role names that are allowed to perform the action.\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/authentication/setup#using-auth-config-to-customize-endpoint-behavior}\n * @example\n *\n * const rules: AccessControlRules = {\n *   Create: {\n *     roles: [\"Admin\", \"Manager\"],\n *     name: \"Create a new user\",\n *     description: \"Allows to create a new user\"\n *   },\n *   Update: [\"Admin\"],\n *   Delete: [\"Admin\"],\n *   View: [\"Admin\", \"User\", \"Guest\"]\n * };\n *\n */\nexport type AccessControlRules = {\n  [key in AccessAction]: UserRole[] | DetailedAccessControlRule | \"*\";\n};\n\n/**\n * Rules defining authentication requirements for different controller actions.\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/authentication/setup#using-auth-config-to-customize-endpoint-behavior}\n * @example\n * const authRules: AuthenticationControlRules = {\n *   Create: true,\n *   Update: true,\n *   Delete: true,\n *   View: false  // Public access\n * };\n */\nexport type AuthenticationControlRules = {\n  [key in AccessAction]: boolean;\n};\n\n/**\n * Configuration for authentication control.\n *\n * @example\n * // All actions require authentication\n * const config1: AuthenticationControlConfig = true;\n *\n * // Specific rules per action\n * const config2: AuthenticationControlConfig = {\n *   Create: true,\n *   View: false\n * };\n */\nexport type AuthenticationControlConfig =\n  | boolean\n  | Partial<AuthenticationControlRules>;\n\n/**\n * Configuration for access control.\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/authentication/setup#auth-config-files---static-rbac}\n * @example\n * // All actions allowed for these roles\n * const config1: AccessControlConfig = [\"Admin\", \"Manager\"];\n *\n * // Specific rules per action\n * const config2: AccessControlConfig = {\n *   Create: [\"Admin\"],\n *   View: [\"User\", \"Admin\"]\n * };\n */\nexport type AccessControlConfig =\n  | UserRole[]\n  | Partial<AccessControlRules>\n  | \"*\";\n\n/**\n * Configuration for authentication and access control.\n *\n * @see {@link https://www.arkosjs.com/docs/core-concepts/authentication/setup#using-auth-config-to-customize-endpoint-behavior}\n * @example\n * export const authConfig: AuthConfigs = {\n *   authenticationControl: {\n *     Create: true,\n *     View: false\n *   },\n *   accessControl: {\n *     Create: [\"Admin\"],\n *     View: [\"User\", \"Admin\"]\n *   }\n * };\n */\nexport type AuthConfigs = {\n  authenticationControl?: AuthenticationControlConfig;\n  accessControl?: AccessControlConfig;\n};\n\n/**\n * Payload structure for JWT-based authentication, extending the standard `JwtPayload`.\n *\n * @example\n * const payload: AuthJwtPayload = {\n *   id: 123,\n *   roles: [\"Admin\"],\n *   email: \"user@example.com\"\n * };\n */\nexport interface AuthJwtPayload extends JwtPayload {\n  id?: number | string;\n  [x: string]: any;\n}\n"]}

package/dist/cjs/types/index.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"","sourcesContent":["import { NextFunction, Response, Request } from \"express\";\nimport { PrismaModels } from \"../generated\";\nimport { ArkosFile } from \"./upload\";\n\n/**\n * Type definition for authentication-related Prisma query operations\n * @template T - The Prisma model delegate type\n */\nexport type AuthPrismaQueryOptions<T extends Record<string, any>> = {\n  // User profile endpoints\n  /**\n   * Options for retrieving the current authenticated user's profile\n   */\n  getMe?: Partial<Parameters<T[\"findUnique\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's profile\n   */\n  updateMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for soft deleting or deactivating the current authenticated user's account\n   */\n  deleteMe?: Partial<Parameters<T[\"update\"]>[0]>;\n  // Authentication endpoints\n  /**\n   * Options for user login authentication queries\n   */\n  login?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for user registration and account creation\n   */\n  signup?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for updating the current authenticated user's password\n   */\n  updatePassword?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for finding multiple auth actions\n   */\n  findManyAuthAction?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for finding a single auth action\n   */\n  findOneAuthAction?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n};\n\n/**\n * Base Prisma query options for standard CRUD operations\n * @template T - The Prisma model delegate type\n */\ntype BasePrismaQueryOptions<T extends Record<string, any>> = {\n  /**\n   * @deprecated Use `global` instead for general query options\n   */\n  queryOptions?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Global query options that can be used for all operations\n   * Replaces the deprecated queryOptions\n   */\n  global?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General find options for findMany and findOne operations\n   */\n  find?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * General create options for createOne and createMany operations\n   */\n  create?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * General update options for updateOne and updateMany operations\n   */\n  update?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * General delete options for deleteOne and deleteMany operations\n   */\n  delete?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * General save options for createOne, createMany, updateOne, updateMany operations\n   */\n  save?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for single record operations (createOne, updateOne)\n   */\n  saveOne?:\n    | Partial<Parameters<T[\"create\"]>[0]>\n    | Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Save options for multiple record operations (createMany, updateMany)\n   */\n  saveMany?:\n    | Partial<Parameters<T[\"createMany\"]>[0]>\n    | Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for finding a single record (first match)\n   */\n  findOne?: Partial<Parameters<T[\"findFirst\"]>[0]>;\n  /**\n   * Options for finding multiple records\n   */\n  findMany?: Partial<Parameters<T[\"findMany\"]>[0]>;\n  /**\n   * Options for creating a single record\n   */\n  createOne?: Partial<Parameters<T[\"create\"]>[0]>;\n  /**\n   * Options for creating multiple records\n   */\n  createMany?: Partial<Parameters<T[\"createMany\"]>[0]>;\n  /**\n   * Options for updating a single record\n   */\n  updateOne?: Partial<Parameters<T[\"update\"]>[0]>;\n  /**\n   * Options for updating multiple records\n   */\n  updateMany?: Partial<Parameters<T[\"updateMany\"]>[0]>;\n  /**\n   * Options for deleting a single record\n   */\n  deleteOne?: Partial<Parameters<T[\"delete\"]>[0]>;\n  /**\n   * Options for deleting multiple records\n   */\n  deleteMany?: Partial<Parameters<T[\"deleteMany\"]>[0]>;\n};\n\n/**\n * Type definition for Prisma query operations with flexible options\n * Conditionally provides auth-specific options when ModelName is \"auth\"\n * @template T - The Prisma model delegate type\n * @template ModelName - The model name (defaults to string for standard models)\n */\nexport type PrismaQueryOptions<\n  T extends Record<string, any>,\n  ModelName extends string = string,\n> = ModelName extends \"auth\"\n  ? AuthPrismaQueryOptions<T>\n  : BasePrismaQueryOptions<T>;\n\nexport interface BaseUser extends Record<string, any> {\n  id: string;\n  isSuperUser: boolean;\n  password: string;\n  passwordChangedAt?: Date;\n  deletedSelfAccountAt: Date;\n  isActive: boolean;\n}\n\ntype UserModelPayload =\n  PrismaModels<{}> extends { user: infer U }\n    ? U extends { GetPayload: infer P }\n      ? P\n      : never\n    : never;\n\nexport type User = UserModelPayload extends never ? BaseUser : UserModelPayload;\n\nexport type UserRole = User extends { roles: infer R extends any[] }\n  ? R[number]\n  : User extends { role: infer R }\n    ? R\n    : string;\n\nexport interface ArkosRequest<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  Query extends Record<string, any> = any,\n> extends Request<P, ResBody, ReqBody, Query> {\n  // /**\n  //  * Request signals used to control Arkos's built-in request handling pipeline.\n  //  *\n  //  * @since v1.6.0-beta\n  //  */\n  // signals?: {\n  //   /**\n  //    * When set to `true` in a `before` hook, Arkos skips its built-in logic for the current pipeline step (e.g. CRUD, authentication, authorization).\n  //    * Automatically reset to `false` after the step completes.\n  //    *\n  //    * @example\n  //    * ```ts\n  //    * before: (req, res, next) => {\n  //    *   req.user = myCustomAuth(req);\n  //    *   req.signals.skip = true;\n  //    *   next();\n  //    * }\n  //    * ```\n  //    */\n  //   skip?: boolean;\n  // };\n  /**\n   * Authenticated user\n   */\n  user?: User;\n  /**\n   * Single uploaded file, populated when using `{ uploads: { type: \"single\" }}`\n   */\n  file?: ArkosFile;\n  /**\n   * Uploaded files, populated when using `{ uploads: { type: \"array\" }}` or `{ uploads: { type: \"fileds\" }}`.\n   */\n  files?: ArkosFile[] | Record<string, ArkosFile[]>;\n\n  /**\n   * Fields to include in relational queries\n   */\n  relationFields?: Record<string, boolean>;\n\n  /**\n   * Prisma include options for related data\n   */\n  include?: Record<string, any>;\n\n  /**\n   * Data to be sent in the response\n   */\n  responseData?: Record<string, any> | null;\n\n  /**\n   * Additional context data\n   */\n  additionalData?: Record<string, any> | null;\n\n  /**\n   * HTTP status code for the response\n   */\n  responseStatus?: number;\n\n  /**\n   * Typed request body\n   */\n  body: ReqBody;\n\n  /**\n   * Prisma query options (where, orderBy, select, etc.)\n   */\n  prismaQueryOptions?: Record<string, any>;\n\n  /**\n   * Typed query parameters\n   */\n  query: Query;\n\n  /**\n   * JWT token used in authentication process\n   */\n  accessToken?: string;\n\n  /**\n   * Query parameters after being handled and transformed by middleware\n   */\n  transformedQuery?: Record<string, any>;\n\n  /**\n   * Processed filters from APIFeatures.filters\n   */\n  filters?: Record<string, any>;\n\n  /**\n   * Name of the Prisma model being queried\n   */\n  modelName?: string;\n}\n\nexport interface ArkosResponse<\n  ResBody = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> extends Response<ResBody, Locals> {}\n\nexport interface ArkosNextFunction extends NextFunction {}\n\nexport type ArkosRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n\nexport type ArkosErrorRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> = (\n  err: any,\n  req: ArkosRequest<P, ResBody, ReqBody, ReqQuery>,\n  res: ArkosResponse<ResBody, Locals>,\n  next: ArkosNextFunction\n) => void | Promise<void>;\n\nexport type ArkosAnyRequestHandler<\n  P extends Record<string, any> = any,\n  ResBody = any,\n  ReqBody = any,\n  ReqQuery extends Record<string, any> = any,\n  Locals extends Record<string, any> = Record<string, any>,\n> =\n  | ArkosRequestHandler<P, ResBody, ReqBody, ReqQuery, Locals>\n  | ArkosErrorRequestHandler<P, ResBody, ReqBody, ReqQuery, Locals>\n  | Array<\n      | ArkosRequestHandler<P, ResBody, ReqBody, ReqQuery, Locals>\n      | ArkosErrorRequestHandler<P, ResBody, ReqBody, ReqQuery, Locals>\n    >;\n"]}

package/dist/cjs/types/new-arkos-config.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=new-arkos-config.js.map