@warlock.js/core 5.2.3 → 5.2.4

package/esm/resource/resource-field-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource-field-builder.mjs","names":[],"sources":["../../../../../../../core/src/resource/resource-field-builder.ts"],"sourcesContent":["import { isObject } from \"@mongez/supportive-is\";\nimport dayjs from \"dayjs\";\nimport relativeTime from \"dayjs/plugin/relativeTime.js\";\nimport { storage } from \"../storage\";\n\n// `humanTime` date options call dayjs(...).fromNow(), which lives in the\n// relativeTime plugin. dayjs.extend is idempotent (a plugin registers itself\n// once), so extending here at module load is safe to repeat.\ndayjs.extend(relativeTime);\nimport { uploadsUrl, url } from \"../utils/urls\";\nimport { type LocalizedObject } from \"./../utils/get-localized\";\nimport { type ResourceFieldBuilderDateOutputOptions, type ResourceOutputValueCastType } from \"./types\";\n\nexport class ResourceFieldBuilder {\n  /**\n   * Field value\n   */\n  protected fieldValue?: unknown;\n\n  /**\n   * Whether the value is nullable\n   * If set to false and value is null, it will be returned as undefined\n   */\n  protected isNullable = false;\n\n  /**\n   * Whether this field is an array\n   * When true, transform() maps over each element using the base type\n   */\n  protected isArrayField = false;\n\n  /**\n   * Default value\n   */\n  protected defaultValue?: unknown;\n\n  /**\n   * Date format\n   */\n  protected dateFormat = \"DD-MM-YYYY hh:mm:ss A\";\n\n  /**\n   * Input key\n   */\n  protected inputKeyToUse?: string;\n\n  /**\n   * Add a condition before transforming the value\n   */\n  protected condition?: () => boolean;\n\n  /**\n   * Define how date fields are returned\n   * If type of the date options is string then it will be returned as a string\n   * otherwise it will be returned as an object contains the date options\n   */\n  protected dateOptionsInput: ResourceFieldBuilderDateOutputOptions = {\n    format: true,\n    timestamp: true,\n    timezone: false,\n    locale: false,\n    offset: false,\n    humanTime: true,\n    iso: true,\n  };\n\n  /**\n   * Constructor\n   */\n  public constructor(protected readonly type: ResourceOutputValueCastType) {\n    //\n  }\n\n  /**\n   * Parse a cast type string (including suffixes) into a configured builder.\n   * Suffix order: [] before ? (e.g. \"string[]?\")\n   * Parsing strips right-to-left: ? first, then [].\n   */\n  public static fromCastType(castType: string): ResourceFieldBuilder {\n    let baseType = castType;\n    let nullable = false;\n    let isArray = false;\n\n    if (baseType.endsWith(\"?\")) {\n      nullable = true;\n      baseType = baseType.slice(0, -1);\n    }\n\n    if (baseType.endsWith(\"[]\")) {\n      isArray = true;\n      baseType = baseType.slice(0, -2);\n    }\n\n    const builder = new ResourceFieldBuilder(baseType as ResourceOutputValueCastType);\n    if (nullable) builder.nullable();\n    if (isArray) builder.array();\n    return builder;\n  }\n\n  /**\n   * Set input key\n   * Will be used in transformation if provided\n   */\n  public setInputKey(key: string) {\n    this.inputKeyToUse = key;\n\n    return this;\n  }\n\n  /**\n   * Add a condition before transforming the value\n   */\n  public when(condition: () => boolean) {\n    this.condition = condition;\n    return this;\n  }\n\n  /**\n   * Set whether the value is nullable\n   */\n  public nullable() {\n    this.isNullable = true;\n    return this;\n  }\n\n  /**\n   * Mark this field as an array\n   * transform() will map over each element using the base type\n   */\n  public array() {\n    this.isArrayField = true;\n    return this;\n  }\n\n  /**\n   * Get input key\n   */\n  public getInputKey() {\n    return this.inputKeyToUse;\n  }\n\n  /**\n   * Set default value\n   */\n  public default(value: unknown) {\n    this.defaultValue = value;\n\n    return this;\n  }\n\n  /**\n   * Set field format\n   */\n  public format(format: string) {\n    this.dateFormat = format;\n\n    return this;\n  }\n\n  /**\n   * Set date options\n   * This will override current date options\n   */\n  public dateOptions(options: ResourceFieldBuilderDateOutputOptions) {\n    this.dateOptionsInput = options;\n\n    return this;\n  }\n\n  /**\n   * Transform the value.\n   * When isArrayField is true, maps over each element using transformSingleValue.\n   */\n  public transform(value: any, locale?: string) {\n    if (this.isArrayField) {\n      if (!Array.isArray(value)) {\n        return this.isNullable ? null : [];\n      }\n\n      return value\n        .map((item) => this.transformSingleValue(item, locale))\n        .filter((v) => v !== undefined);\n    }\n\n    return this.transformSingleValue(value, locale);\n  }\n\n  /**\n   * Transform a single value according to the base type.\n   */\n  protected transformSingleValue(value: any, locale?: string) {\n    if (value === undefined || value === null) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    if (this.condition && !this.condition()) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    switch (this.type) {\n      case \"string\":\n        return String(value);\n      case \"number\": {\n        const num = Number(value);\n        return isNaN(num) ? (this.isNullable ? null : undefined) : num;\n      }\n      case \"boolean\":\n        return Boolean(value);\n      case \"float\": {\n        const float = parseFloat(value);\n        return isNaN(float) ? (this.isNullable ? null : undefined) : float;\n      }\n\n      case \"int\": {\n        const int = parseInt(value);\n        return isNaN(int) ? (this.isNullable ? null : undefined) : int;\n      }\n\n      case \"date\":\n        return this.transformDate(value as string | Date, locale);\n      case \"localized\":\n        return this.transformLocalized(value as LocalizedObject[], locale);\n      case \"url\":\n        return url(value as string);\n      case \"uploadsUrl\":\n        return uploadsUrl(value as string);\n      case \"storageUrl\":\n        return storage.url(value as string);\n      case \"object\":\n        return isObject(value) && !Array.isArray(value) && Object.keys(value).length > 0\n          ? value\n          : this.isNullable\n            ? null\n            : undefined;\n      case \"array\":\n        return Array.isArray(value) ? value : this.isNullable ? null : undefined;\n    }\n  }\n\n  /**\n   * Transform date value\n   */\n  protected transformDate(value: string | Date, locale?: string) {\n    if (typeof this.dateOptionsInput === \"string\") {\n      if (this.dateOptionsInput === \"format\") {\n        return dayjs(value).format(this.dateFormat);\n      }\n\n      if (this.dateOptionsInput === \"iso\") {\n        return dayjs(value).toISOString();\n      }\n\n      if (this.dateOptionsInput === \"timestamp\") {\n        return dayjs(value).valueOf();\n      }\n\n      if (this.dateOptionsInput === \"humanTime\") {\n        return (dayjs as any)(value).fromNow();\n      }\n\n      if (this.dateOptionsInput === \"locale\") {\n        if (!locale) {\n          return dayjs(value).format(this.dateFormat);\n        }\n\n        return dayjs(value).locale(locale).format(this.dateFormat);\n      }\n    }\n\n    // now manage it as an object based on date options what's marked as true\n    const output: {\n      format?: string;\n      timestamp?: number;\n      humanTime?: string;\n      locale?: string;\n      iso?: string;\n    } = {};\n\n    let dayjsObject = dayjs((value as any)?.iso || value);\n\n    if (locale) {\n      dayjsObject = dayjsObject.locale(locale);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    if (this.dateOptionsInput.format) {\n      output.format = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.timestamp) {\n      output.timestamp = dayjsObject.valueOf();\n    }\n\n    if (this.dateOptionsInput.humanTime) {\n      output.humanTime = (dayjsObject as any).fromNow();\n    }\n\n    if (this.dateOptionsInput.locale) {\n      output.locale = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    return output;\n  }\n\n  /**\n   * Transform localized value\n   */\n  protected transformLocalized(value: LocalizedObject[] | string, locale?: string) {\n    if (typeof value === \"string\") {\n      return value;\n    }\n\n    if (!locale) {\n      return value[0]?.value || value;\n    }\n\n    return value.find((item) => item.localeCode === locale)?.value;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"resource-field-builder.mjs","names":[],"sources":["../../../../../../../core/src/resource/resource-field-builder.ts"],"sourcesContent":["import { isObject } from \"@mongez/supportive-is\";\nimport dayjs from \"dayjs\";\nimport relativeTime from \"dayjs/plugin/relativeTime.js\";\nimport { storage } from \"../storage\";\n\n// `humanTime` date options call dayjs(...).fromNow(), which lives in the\n// relativeTime plugin. dayjs.extend is idempotent (a plugin registers itself\n// once), so extending here at module load is safe to repeat.\ndayjs.extend(relativeTime);\nimport { uploadsUrl, url } from \"../utils/urls\";\nimport { type LocalizedObject } from \"./../utils/get-localized\";\nimport { type ResourceFieldBuilderDateOutputOptions, type ResourceOutputValueCastType } from \"./types\";\n\nexport class ResourceFieldBuilder {\n  /**\n   * Field value\n   */\n  protected fieldValue?: unknown;\n\n  /**\n   * Whether the value is nullable\n   * If set to false and value is null, it will be returned as undefined\n   */\n  protected isNullable = false;\n\n  /**\n   * Whether this field is an array\n   * When true, transform() maps over each element using the base type\n   */\n  protected isArrayField = false;\n\n  /**\n   * Default value\n   */\n  protected defaultValue?: unknown;\n\n  /**\n   * Date format\n   */\n  protected dateFormat = \"DD-MM-YYYY hh:mm:ss A\";\n\n  /**\n   * Input key\n   */\n  protected inputKeyToUse?: string;\n\n  /**\n   * Add a condition before transforming the value\n   */\n  protected condition?: () => boolean;\n\n  /**\n   * Define how date fields are returned\n   * If type of the date options is string then it will be returned as a string\n   * otherwise it will be returned as an object contains the date options\n   */\n  protected dateOptionsInput: ResourceFieldBuilderDateOutputOptions = {\n    format: true,\n    timestamp: true,\n    timezone: false,\n    locale: false,\n    offset: false,\n    humanTime: true,\n    iso: true,\n  };\n\n  /**\n   * Constructor\n   */\n  public constructor(protected readonly type: ResourceOutputValueCastType) {\n    //\n  }\n\n  /**\n   * Parse a cast type string (including suffixes) into a configured builder.\n   * Suffix order: [] before ? (e.g. \"string[]?\")\n   * Parsing strips right-to-left: ? first, then [].\n   */\n  public static fromCastType(castType: string): ResourceFieldBuilder {\n    let baseType = castType;\n    let nullable = false;\n    let isArray = false;\n\n    if (baseType.endsWith(\"?\")) {\n      nullable = true;\n      baseType = baseType.slice(0, -1);\n    }\n\n    if (baseType.endsWith(\"[]\")) {\n      isArray = true;\n      baseType = baseType.slice(0, -2);\n    }\n\n    const builder = new ResourceFieldBuilder(baseType as ResourceOutputValueCastType);\n    if (nullable) builder.nullable();\n    if (isArray) builder.array();\n    return builder;\n  }\n\n  /**\n   * Set input key\n   * Will be used in transformation if provided\n   */\n  public setInputKey(key: string) {\n    this.inputKeyToUse = key;\n\n    return this;\n  }\n\n  /**\n   * Add a condition before transforming the value\n   */\n  public when(condition: () => boolean) {\n    this.condition = condition;\n    return this;\n  }\n\n  /**\n   * Set whether the value is nullable\n   */\n  public nullable() {\n    this.isNullable = true;\n    return this;\n  }\n\n  /**\n   * Mark this field as an array\n   * transform() will map over each element using the base type\n   */\n  public array() {\n    this.isArrayField = true;\n    return this;\n  }\n\n  /**\n   * Get input key\n   */\n  public getInputKey() {\n    return this.inputKeyToUse;\n  }\n\n  /**\n   * Set default value\n   */\n  public default(value: unknown) {\n    this.defaultValue = value;\n\n    return this;\n  }\n\n  /**\n   * Set field format\n   */\n  public format(format: string) {\n    this.dateFormat = format;\n\n    return this;\n  }\n\n  /**\n   * Set date options\n   * This will override current date options\n   */\n  public dateOptions(options: ResourceFieldBuilderDateOutputOptions) {\n    this.dateOptionsInput = options;\n\n    return this;\n  }\n\n  /**\n   * Transform the value.\n   * When isArrayField is true, maps over each element using transformSingleValue.\n   */\n  public transform(value: any, locale?: string) {\n    if (this.isArrayField) {\n      if (!Array.isArray(value)) {\n        return this.isNullable ? null : [];\n      }\n\n      return value\n        .map((item) => this.transformSingleValue(item, locale))\n        .filter((v) => v !== undefined);\n    }\n\n    return this.transformSingleValue(value, locale);\n  }\n\n  /**\n   * Transform a single value according to the base type.\n   */\n  protected transformSingleValue(value: any, locale?: string) {\n    if (value === undefined || value === null) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    if (this.condition && !this.condition()) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    switch (this.type) {\n      case \"string\":\n        return String(value);\n      case \"number\": {\n        const num = Number(value);\n        return isNaN(num) ? (this.isNullable ? null : undefined) : num;\n      }\n      case \"boolean\":\n        return Boolean(value);\n      case \"float\": {\n        const float = parseFloat(value);\n        return isNaN(float) ? (this.isNullable ? null : undefined) : float;\n      }\n\n      case \"int\": {\n        const int = parseInt(value);\n        return isNaN(int) ? (this.isNullable ? null : undefined) : int;\n      }\n\n      case \"date\":\n        return this.transformDate(value as string | Date, locale);\n      case \"localized\":\n        return this.transformLocalized(value as LocalizedObject[], locale);\n      case \"url\":\n        return url(value as string);\n      case \"uploadsUrl\":\n        return uploadsUrl(value as string);\n      case \"storageUrl\":\n        return storage.url(value as string);\n      case \"object\":\n        return isObject(value) && !Array.isArray(value) && Object.keys(value).length > 0\n          ? value\n          : this.isNullable\n            ? null\n            : undefined;\n      case \"array\":\n        return Array.isArray(value) ? value : this.isNullable ? null : undefined;\n    }\n  }\n\n  /**\n   * Transform date value\n   */\n  protected transformDate(value: string | Date, locale?: string) {\n    if (typeof this.dateOptionsInput === \"string\") {\n      if (this.dateOptionsInput === \"format\") {\n        return dayjs(value).format(this.dateFormat);\n      }\n\n      if (this.dateOptionsInput === \"iso\") {\n        return dayjs(value).toISOString();\n      }\n\n      if (this.dateOptionsInput === \"timestamp\") {\n        return dayjs(value).valueOf();\n      }\n\n      if (this.dateOptionsInput === \"humanTime\") {\n        return (dayjs as any)(value).fromNow();\n      }\n\n      if (this.dateOptionsInput === \"locale\") {\n        if (!locale) {\n          return dayjs(value).format(this.dateFormat);\n        }\n\n        return dayjs(value).locale(locale).format(this.dateFormat);\n      }\n    }\n\n    // now manage it as an object based on date options what's marked as true\n    const output: {\n      format?: string;\n      timestamp?: number;\n      humanTime?: string;\n      locale?: string;\n      iso?: string;\n    } = {};\n\n    let dayjsObject = dayjs((value as any)?.iso || value);\n\n    if (locale) {\n      dayjsObject = dayjsObject.locale(locale);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    if (this.dateOptionsInput.format) {\n      output.format = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.timestamp) {\n      output.timestamp = dayjsObject.valueOf();\n    }\n\n    if (this.dateOptionsInput.humanTime) {\n      output.humanTime = (dayjsObject as any).fromNow();\n    }\n\n    if (this.dateOptionsInput.locale) {\n      output.locale = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    return output;\n  }\n\n  /**\n   * Transform localized value\n   */\n  protected transformLocalized(value: LocalizedObject[] | string, locale?: string) {\n    if (typeof value === \"string\") {\n      return value;\n    }\n\n    if (!locale) {\n      return value[0]?.value || value;\n    }\n\n    return value.find((item) => item.localeCode === locale)?.value;\n  }\n}\n"],"mappings":"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"}

package/esm/resource/resource.d.mts.map

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

package/esm/resource/resource.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.mjs","names":[],"sources":["../../../../../../../core/src/resource/resource.ts"],"sourcesContent":["import { get, isLazy, set, type GenericObject } from \"@mongez/reinforcements\";\r\nimport { Model } from \"@warlock.js/cascade\";\r\nimport { useRequestStore } from \"../http/context/request-context\";\r\nimport { ResourceFieldBuilder } from \"./resource-field-builder\";\r\nimport {\r\n  type ResourceArraySchema,\r\n  type ResourceFieldConfig,\r\n  type ResourceOutputValueCastType,\r\n  type ResourceSchema,\r\n} from \"./types\";\r\n\r\n/**\r\n * Maximum recursion depth for self-referencing fields.\r\n * Prevents runaway serialization on deep trees or circular data.\r\n */\r\nconst MAX_SELF_DEPTH = 10;\r\n\r\n/**\r\n * Resource contract\r\n */\r\nexport interface ResourceContract {\r\n  /**\r\n   * Resource data\r\n   */\r\n  resource: GenericObject;\r\n\r\n  /**\r\n   * Resource final output\r\n   */\r\n  data: GenericObject;\r\n\r\n  /**\r\n   * Original data\r\n   */\r\n  originalData: GenericObject;\r\n\r\n  /**\r\n   * Convert resource to JSON\r\n   */\r\n  toJSON(): GenericObject;\r\n\r\n  /**\r\n   * Transform the given value with given type\r\n   */\r\n  transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;\r\n\r\n  /**\r\n   * Get a input value for the given key\r\n   */\r\n  get(key: string, defaultValue?: any): any;\r\n\r\n  /**\r\n   * Set the given value for the given field\r\n   */\r\n  set(key: string, value: any): ResourceContract;\r\n\r\n  /**\r\n   * Create an array schema for transforming array items\r\n   */\r\n  arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;\r\n\r\n  /**\r\n   * Get a string field builder\r\n   */\r\n  string(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a date field builder\r\n   */\r\n  date(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a localized field builder\r\n   */\r\n  localized(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a url field builder\r\n   */\r\n  url(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a uploadsUrl field builder\r\n   */\r\n  uploadsUrl(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a number field builder\r\n   */\r\n  number(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a boolean field builder\r\n   */\r\n  boolean(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a float field builder\r\n   */\r\n  float(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a int field builder\r\n   */\r\n  int(inputKey?: string): ResourceFieldBuilder;\r\n}\r\n\r\n/**\r\n * Resource constructor\r\n */\r\nexport interface ResourceConstructor {\r\n  new (originalData: GenericObject | Resource | Model): ResourceContract;\r\n}\r\n\r\nexport class Resource implements ResourceContract {\r\n  /**\r\n   * Resource data\r\n   */\r\n  public resource: GenericObject = {};\r\n\r\n  /**\r\n   * Resource final output\r\n   */\r\n  public data: GenericObject = {};\r\n\r\n  /**\r\n   * Tracks visited object identities during self-reference recursion.\r\n   * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).\r\n   */\r\n  protected _selfSeen?: Set<unknown>;\r\n\r\n  /**\r\n   * Raw resource schema — field declarations as written by the developer.\r\n   * Used by doc generators for introspection.\r\n   */\r\n  public static schema: ResourceSchema = {};\r\n\r\n  /**\r\n   * Normalized schema — all string cast types and tuples converted to\r\n   * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.\r\n   */\r\n  public static parsedSchema: Record<string, ResourceFieldConfig> = {};\r\n\r\n  /**\r\n   * Normalize a raw schema into parsedSchema.\r\n   * Converts string cast types (including suffixes) and tuples into pre-built builders.\r\n   * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.\r\n   */\r\n  public static normalizeSchema(schema: ResourceSchema): Record<string, ResourceFieldConfig> {\r\n    const parsed: Record<string, ResourceFieldConfig> = {};\r\n\r\n    for (const [key, value] of Object.entries(schema)) {\r\n      if (value === \"self\" || value === \"self[]\") {\r\n        // Keep self-references as-is — resolved lazily in transformValue\r\n        parsed[key] = value;\r\n      } else if (isLazy<ResourceConstructor>(value)) {\r\n        // Keep Lazy<ResourceConstructor> as-is — resolved at transform\r\n        // time so cyclic resource refs (A embeds B embeds A) compose\r\n        // without import-graph cycles.\r\n        parsed[key] = value;\r\n      } else if (typeof value === \"string\") {\r\n        parsed[key] = ResourceFieldBuilder.fromCastType(value);\r\n      } else if (Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\") {\r\n        const builder = ResourceFieldBuilder.fromCastType(value[1] as string);\r\n        builder.setInputKey(value[0]);\r\n        parsed[key] = builder;\r\n      } else {\r\n        parsed[key] = value;\r\n      }\r\n    }\r\n\r\n    return parsed;\r\n  }\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor(public originalData: GenericObject | Resource | Model) {\r\n    if (this.originalData instanceof Model) {\r\n      this.resource = this.originalData.data;\r\n    } else if (this.originalData instanceof Resource) {\r\n      this.resource = this.originalData.data;\r\n    } else {\r\n      this.resource = this.originalData;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Convert resource to JSON\r\n   */\r\n  public toJSON() {\r\n    this.boot();\r\n    this.transformOutput();\r\n    this.extend();\r\n\r\n    return this.data;\r\n  }\r\n\r\n  /**\r\n   * Boot method\r\n   * Called before transforming the resource\r\n   */\r\n  protected boot() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Transform resource to output using the pre-normalized parsedSchema.\r\n   * Builders handle their own array/nullable logic internally.\r\n   * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.\r\n   */\r\n  protected transformOutput() {\r\n    const localeCode = useRequestStore()?.request?.locale;\r\n    const parsedSchema = (this.constructor as typeof Resource).parsedSchema;\r\n\r\n    for (const [outputKey, outputSettings] of Object.entries(parsedSchema)) {\r\n      const inputValue = this.get(outputKey);\r\n      const outputValue = this.transformValue(inputValue, outputSettings, localeCode);\r\n\r\n      if (outputValue !== undefined) {\r\n        this.set(outputKey, outputValue);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Transform the given value with given type\r\n   */\r\n  public transform(value: any, type: ResourceOutputValueCastType, locale?: string) {\r\n    return new ResourceFieldBuilder(type).transform(value, locale);\r\n  }\r\n\r\n  /**\r\n   * Transform the given value for the given output setting.\r\n   * After normalization, string cast types no longer reach here — they are pre-converted to builders.\r\n   */\r\n  protected transformValue(value: any, outputSettings: ResourceFieldConfig, locale?: string): any {\r\n    let outputValue: any;\r\n\r\n    if (isLazy<ResourceConstructor>(outputSettings)) {\r\n      // Resolve the lazy ref now (cyclic resource imports are fully loaded\r\n      // by serialization time) and recurse — the resolved constructor is\r\n      // handled by the ResourceConstructor branch below.\r\n      return this.transformValue(value, outputSettings.resolve(), locale);\r\n    }\r\n\r\n    if (outputSettings === \"self\" || outputSettings === \"self[]\") {\r\n      // Self-reference — resolve using the same resource class with cycle detection\r\n      outputValue = this.transformSelfReference(value, outputSettings === \"self[]\");\r\n    } else if (\r\n      typeof outputSettings === \"function\" &&\r\n      outputSettings.prototype instanceof Resource\r\n    ) {\r\n      if (!value) return;\r\n      // Nested resource — handle both single and array values\r\n      if (Array.isArray(value)) {\r\n        if (value.length === 0) return;\r\n        outputValue = value\r\n          .map((item) => new (outputSettings as typeof Resource)(item).toJSON())\r\n          .filter((v) => v !== undefined);\r\n      } else {\r\n        outputValue = new (outputSettings as typeof Resource)(value).toJSON();\r\n      }\r\n    } else if (typeof outputSettings === \"function\") {\r\n      // Resolver function - bind to Resource instance for access to this.get(), etc.\r\n      outputValue = (outputSettings as Function).call(this, value, this);\r\n    } else if (outputSettings instanceof ResourceFieldBuilder) {\r\n      // Builder — handles array mapping and nullable internally via isArrayField\r\n      const inputKey = outputSettings.getInputKey();\r\n      outputValue = outputSettings.transform(inputKey ? this.get(inputKey) : value, locale);\r\n    } else if (\r\n      typeof outputSettings === \"object\" &&\r\n      outputSettings !== null &&\r\n      \"__type\" in outputSettings &&\r\n      outputSettings.__type === \"arrayOf\"\r\n    ) {\r\n      // ResourceArraySchema — structured array items with their own sub-schema\r\n      if (Array.isArray(value)) {\r\n        outputValue = value\r\n          .map((item) => this.transformArrayItem(item, outputSettings.schema, locale))\r\n          .filter((v) => v !== undefined);\r\n      } else {\r\n        outputValue = this.transformArrayItem(value, outputSettings.schema, locale);\r\n      }\r\n    }\r\n\r\n    return outputValue;\r\n  }\r\n\r\n  /**\r\n   * Extend the resource output\r\n   */\r\n  protected extend() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Transform a self-referencing field value.\r\n   *\r\n   * @example\r\n   * // Single: parent: \"self\"\r\n   * // Array:  children: \"self[]\"\r\n   */\r\n  protected transformSelfReference(value: any, isArray: boolean): any {\r\n    if (isArray) {\r\n      return Array.isArray(value)\r\n        ? value.map((item) => this.resolveSelf(item)).filter((v) => v !== undefined)\r\n        : undefined;\r\n    }\r\n\r\n    return this.resolveSelf(value);\r\n  }\r\n\r\n  /**\r\n   * Resolve a single self-reference value.\r\n   * Uses identity-based cycle detection (id/_id) and a max depth guard.\r\n   */\r\n  protected resolveSelf(value: any): any {\r\n    if (!value) return undefined;\r\n\r\n    const identity = value.id ?? value._id ?? value;\r\n    const seen = this._selfSeen ?? new Set();\r\n\r\n    // Circular reference or depth limit reached — stop recursion\r\n    if (seen.has(identity) || seen.size >= MAX_SELF_DEPTH) {\r\n      return undefined;\r\n    }\r\n\r\n    seen.add(identity);\r\n\r\n    const SelfConstructor = this.constructor as typeof Resource;\r\n    const child = new SelfConstructor(value);\r\n    child._selfSeen = seen;\r\n\r\n    return child.toJSON();\r\n  }\r\n\r\n  /**\r\n   * Transform a single array item according to the given schema\r\n   */\r\n  protected transformArrayItem(\r\n    item: any,\r\n    schema: Record<string, ResourceFieldConfig>,\r\n    locale?: string,\r\n  ) {\r\n    const transformedItem: GenericObject = {};\r\n\r\n    for (const [outputKey, outputSettings] of Object.entries(schema)) {\r\n      let fieldKey = outputKey;\r\n      let valueTransformType = outputSettings as ResourceFieldConfig;\r\n\r\n      if (Array.isArray(outputSettings)) {\r\n        fieldKey = outputSettings[0];\r\n        valueTransformType = outputSettings[1];\r\n      }\r\n\r\n      const inputValue = get(item, fieldKey);\r\n      const outputValue = this.transformValue(inputValue, valueTransformType, locale);\r\n\r\n      if (outputValue !== undefined) {\r\n        set(transformedItem, outputKey, outputValue);\r\n      }\r\n    }\r\n\r\n    return transformedItem;\r\n  }\r\n\r\n  /**\r\n   * Get a input value for the given key\r\n   */\r\n  public get(key: string, defaultValue?: any) {\r\n    return get(this.resource, key, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Set the given value for the given field\r\n   */\r\n  public set(key: string, value: any): ResourceContract {\r\n    set(this.data, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Create an array schema for transforming array items\r\n   */\r\n  public arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema {\r\n    return {\r\n      __type: \"arrayOf\",\r\n      schema,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get a string field builder\r\n   */\r\n  public string(inputKey?: string) {\r\n    return this.fieldBuilder(\"string\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a date field builder\r\n   */\r\n  public date(inputKey?: string) {\r\n    return this.fieldBuilder(\"date\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a localized field builder\r\n   */\r\n  public localized(inputKey?: string) {\r\n    return this.fieldBuilder(\"localized\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a url field builder\r\n   */\r\n  public url(inputKey?: string) {\r\n    return this.fieldBuilder(\"url\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a uploadsUrl field builder\r\n   */\r\n  public uploadsUrl(inputKey?: string) {\r\n    return this.fieldBuilder(\"uploadsUrl\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a number field builder\r\n   */\r\n  public number(inputKey?: string) {\r\n    return this.fieldBuilder(\"number\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a boolean field builder\r\n   */\r\n  public boolean(inputKey?: string) {\r\n    return this.fieldBuilder(\"boolean\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a float field builder\r\n   */\r\n  public float(inputKey?: string) {\r\n    return this.fieldBuilder(\"float\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a int field builder\r\n   */\r\n  public int(inputKey?: string) {\r\n    return this.fieldBuilder(\"int\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * New field builder\r\n   */\r\n  protected fieldBuilder(type: ResourceOutputValueCastType, inputKey?: string) {\r\n    const builder = new ResourceFieldBuilder(type);\r\n\r\n    if (inputKey) {\r\n      builder.setInputKey(inputKey);\r\n    }\r\n\r\n    return builder;\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"resource.mjs","names":[],"sources":["../../../../../../../core/src/resource/resource.ts"],"sourcesContent":["import { get, isLazy, set, type GenericObject } from \"@mongez/reinforcements\";\r\nimport { Model } from \"@warlock.js/cascade\";\r\nimport { useRequestStore } from \"../http/context/request-context\";\r\nimport { ResourceFieldBuilder } from \"./resource-field-builder\";\r\nimport {\r\n  type ResourceArraySchema,\r\n  type ResourceFieldConfig,\r\n  type ResourceOutputValueCastType,\r\n  type ResourceSchema,\r\n} from \"./types\";\r\n\r\n/**\r\n * Maximum recursion depth for self-referencing fields.\r\n * Prevents runaway serialization on deep trees or circular data.\r\n */\r\nconst MAX_SELF_DEPTH = 10;\r\n\r\n/**\r\n * Resource contract\r\n */\r\nexport interface ResourceContract {\r\n  /**\r\n   * Resource data\r\n   */\r\n  resource: GenericObject;\r\n\r\n  /**\r\n   * Resource final output\r\n   */\r\n  data: GenericObject;\r\n\r\n  /**\r\n   * Original data\r\n   */\r\n  originalData: GenericObject;\r\n\r\n  /**\r\n   * Convert resource to JSON\r\n   */\r\n  toJSON(): GenericObject;\r\n\r\n  /**\r\n   * Transform the given value with given type\r\n   */\r\n  transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;\r\n\r\n  /**\r\n   * Get a input value for the given key\r\n   */\r\n  get(key: string, defaultValue?: any): any;\r\n\r\n  /**\r\n   * Set the given value for the given field\r\n   */\r\n  set(key: string, value: any): ResourceContract;\r\n\r\n  /**\r\n   * Create an array schema for transforming array items\r\n   */\r\n  arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;\r\n\r\n  /**\r\n   * Get a string field builder\r\n   */\r\n  string(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a date field builder\r\n   */\r\n  date(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a localized field builder\r\n   */\r\n  localized(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a url field builder\r\n   */\r\n  url(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a uploadsUrl field builder\r\n   */\r\n  uploadsUrl(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a number field builder\r\n   */\r\n  number(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a boolean field builder\r\n   */\r\n  boolean(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a float field builder\r\n   */\r\n  float(inputKey?: string): ResourceFieldBuilder;\r\n\r\n  /**\r\n   * Get a int field builder\r\n   */\r\n  int(inputKey?: string): ResourceFieldBuilder;\r\n}\r\n\r\n/**\r\n * Resource constructor\r\n */\r\nexport interface ResourceConstructor {\r\n  new (originalData: GenericObject | Resource | Model): ResourceContract;\r\n}\r\n\r\nexport class Resource implements ResourceContract {\r\n  /**\r\n   * Resource data\r\n   */\r\n  public resource: GenericObject = {};\r\n\r\n  /**\r\n   * Resource final output\r\n   */\r\n  public data: GenericObject = {};\r\n\r\n  /**\r\n   * Tracks visited object identities during self-reference recursion.\r\n   * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).\r\n   */\r\n  protected _selfSeen?: Set<unknown>;\r\n\r\n  /**\r\n   * Raw resource schema — field declarations as written by the developer.\r\n   * Used by doc generators for introspection.\r\n   */\r\n  public static schema: ResourceSchema = {};\r\n\r\n  /**\r\n   * Normalized schema — all string cast types and tuples converted to\r\n   * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.\r\n   */\r\n  public static parsedSchema: Record<string, ResourceFieldConfig> = {};\r\n\r\n  /**\r\n   * Normalize a raw schema into parsedSchema.\r\n   * Converts string cast types (including suffixes) and tuples into pre-built builders.\r\n   * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.\r\n   */\r\n  public static normalizeSchema(schema: ResourceSchema): Record<string, ResourceFieldConfig> {\r\n    const parsed: Record<string, ResourceFieldConfig> = {};\r\n\r\n    for (const [key, value] of Object.entries(schema)) {\r\n      if (value === \"self\" || value === \"self[]\") {\r\n        // Keep self-references as-is — resolved lazily in transformValue\r\n        parsed[key] = value;\r\n      } else if (isLazy<ResourceConstructor>(value)) {\r\n        // Keep Lazy<ResourceConstructor> as-is — resolved at transform\r\n        // time so cyclic resource refs (A embeds B embeds A) compose\r\n        // without import-graph cycles.\r\n        parsed[key] = value;\r\n      } else if (typeof value === \"string\") {\r\n        parsed[key] = ResourceFieldBuilder.fromCastType(value);\r\n      } else if (Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\") {\r\n        const builder = ResourceFieldBuilder.fromCastType(value[1] as string);\r\n        builder.setInputKey(value[0]);\r\n        parsed[key] = builder;\r\n      } else {\r\n        parsed[key] = value;\r\n      }\r\n    }\r\n\r\n    return parsed;\r\n  }\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor(public originalData: GenericObject | Resource | Model) {\r\n    if (this.originalData instanceof Model) {\r\n      this.resource = this.originalData.data;\r\n    } else if (this.originalData instanceof Resource) {\r\n      this.resource = this.originalData.data;\r\n    } else {\r\n      this.resource = this.originalData;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Convert resource to JSON\r\n   */\r\n  public toJSON() {\r\n    this.boot();\r\n    this.transformOutput();\r\n    this.extend();\r\n\r\n    return this.data;\r\n  }\r\n\r\n  /**\r\n   * Boot method\r\n   * Called before transforming the resource\r\n   */\r\n  protected boot() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Transform resource to output using the pre-normalized parsedSchema.\r\n   * Builders handle their own array/nullable logic internally.\r\n   * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.\r\n   */\r\n  protected transformOutput() {\r\n    const localeCode = useRequestStore()?.request?.locale;\r\n    const parsedSchema = (this.constructor as typeof Resource).parsedSchema;\r\n\r\n    for (const [outputKey, outputSettings] of Object.entries(parsedSchema)) {\r\n      const inputValue = this.get(outputKey);\r\n      const outputValue = this.transformValue(inputValue, outputSettings, localeCode);\r\n\r\n      if (outputValue !== undefined) {\r\n        this.set(outputKey, outputValue);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Transform the given value with given type\r\n   */\r\n  public transform(value: any, type: ResourceOutputValueCastType, locale?: string) {\r\n    return new ResourceFieldBuilder(type).transform(value, locale);\r\n  }\r\n\r\n  /**\r\n   * Transform the given value for the given output setting.\r\n   * After normalization, string cast types no longer reach here — they are pre-converted to builders.\r\n   */\r\n  protected transformValue(value: any, outputSettings: ResourceFieldConfig, locale?: string): any {\r\n    let outputValue: any;\r\n\r\n    if (isLazy<ResourceConstructor>(outputSettings)) {\r\n      // Resolve the lazy ref now (cyclic resource imports are fully loaded\r\n      // by serialization time) and recurse — the resolved constructor is\r\n      // handled by the ResourceConstructor branch below.\r\n      return this.transformValue(value, outputSettings.resolve(), locale);\r\n    }\r\n\r\n    if (outputSettings === \"self\" || outputSettings === \"self[]\") {\r\n      // Self-reference — resolve using the same resource class with cycle detection\r\n      outputValue = this.transformSelfReference(value, outputSettings === \"self[]\");\r\n    } else if (\r\n      typeof outputSettings === \"function\" &&\r\n      outputSettings.prototype instanceof Resource\r\n    ) {\r\n      if (!value) return;\r\n      // Nested resource — handle both single and array values\r\n      if (Array.isArray(value)) {\r\n        if (value.length === 0) return;\r\n        outputValue = value\r\n          .map((item) => new (outputSettings as typeof Resource)(item).toJSON())\r\n          .filter((v) => v !== undefined);\r\n      } else {\r\n        outputValue = new (outputSettings as typeof Resource)(value).toJSON();\r\n      }\r\n    } else if (typeof outputSettings === \"function\") {\r\n      // Resolver function - bind to Resource instance for access to this.get(), etc.\r\n      outputValue = (outputSettings as Function).call(this, value, this);\r\n    } else if (outputSettings instanceof ResourceFieldBuilder) {\r\n      // Builder — handles array mapping and nullable internally via isArrayField\r\n      const inputKey = outputSettings.getInputKey();\r\n      outputValue = outputSettings.transform(inputKey ? this.get(inputKey) : value, locale);\r\n    } else if (\r\n      typeof outputSettings === \"object\" &&\r\n      outputSettings !== null &&\r\n      \"__type\" in outputSettings &&\r\n      outputSettings.__type === \"arrayOf\"\r\n    ) {\r\n      // ResourceArraySchema — structured array items with their own sub-schema\r\n      if (Array.isArray(value)) {\r\n        outputValue = value\r\n          .map((item) => this.transformArrayItem(item, outputSettings.schema, locale))\r\n          .filter((v) => v !== undefined);\r\n      } else {\r\n        outputValue = this.transformArrayItem(value, outputSettings.schema, locale);\r\n      }\r\n    }\r\n\r\n    return outputValue;\r\n  }\r\n\r\n  /**\r\n   * Extend the resource output\r\n   */\r\n  protected extend() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Transform a self-referencing field value.\r\n   *\r\n   * @example\r\n   * // Single: parent: \"self\"\r\n   * // Array:  children: \"self[]\"\r\n   */\r\n  protected transformSelfReference(value: any, isArray: boolean): any {\r\n    if (isArray) {\r\n      return Array.isArray(value)\r\n        ? value.map((item) => this.resolveSelf(item)).filter((v) => v !== undefined)\r\n        : undefined;\r\n    }\r\n\r\n    return this.resolveSelf(value);\r\n  }\r\n\r\n  /**\r\n   * Resolve a single self-reference value.\r\n   * Uses identity-based cycle detection (id/_id) and a max depth guard.\r\n   */\r\n  protected resolveSelf(value: any): any {\r\n    if (!value) return undefined;\r\n\r\n    const identity = value.id ?? value._id ?? value;\r\n    const seen = this._selfSeen ?? new Set();\r\n\r\n    // Circular reference or depth limit reached — stop recursion\r\n    if (seen.has(identity) || seen.size >= MAX_SELF_DEPTH) {\r\n      return undefined;\r\n    }\r\n\r\n    seen.add(identity);\r\n\r\n    const SelfConstructor = this.constructor as typeof Resource;\r\n    const child = new SelfConstructor(value);\r\n    child._selfSeen = seen;\r\n\r\n    return child.toJSON();\r\n  }\r\n\r\n  /**\r\n   * Transform a single array item according to the given schema\r\n   */\r\n  protected transformArrayItem(\r\n    item: any,\r\n    schema: Record<string, ResourceFieldConfig>,\r\n    locale?: string,\r\n  ) {\r\n    const transformedItem: GenericObject = {};\r\n\r\n    for (const [outputKey, outputSettings] of Object.entries(schema)) {\r\n      let fieldKey = outputKey;\r\n      let valueTransformType = outputSettings as ResourceFieldConfig;\r\n\r\n      if (Array.isArray(outputSettings)) {\r\n        fieldKey = outputSettings[0];\r\n        valueTransformType = outputSettings[1];\r\n      }\r\n\r\n      const inputValue = get(item, fieldKey);\r\n      const outputValue = this.transformValue(inputValue, valueTransformType, locale);\r\n\r\n      if (outputValue !== undefined) {\r\n        set(transformedItem, outputKey, outputValue);\r\n      }\r\n    }\r\n\r\n    return transformedItem;\r\n  }\r\n\r\n  /**\r\n   * Get a input value for the given key\r\n   */\r\n  public get(key: string, defaultValue?: any) {\r\n    return get(this.resource, key, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Set the given value for the given field\r\n   */\r\n  public set(key: string, value: any): ResourceContract {\r\n    set(this.data, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Create an array schema for transforming array items\r\n   */\r\n  public arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema {\r\n    return {\r\n      __type: \"arrayOf\",\r\n      schema,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get a string field builder\r\n   */\r\n  public string(inputKey?: string) {\r\n    return this.fieldBuilder(\"string\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a date field builder\r\n   */\r\n  public date(inputKey?: string) {\r\n    return this.fieldBuilder(\"date\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a localized field builder\r\n   */\r\n  public localized(inputKey?: string) {\r\n    return this.fieldBuilder(\"localized\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a url field builder\r\n   */\r\n  public url(inputKey?: string) {\r\n    return this.fieldBuilder(\"url\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a uploadsUrl field builder\r\n   */\r\n  public uploadsUrl(inputKey?: string) {\r\n    return this.fieldBuilder(\"uploadsUrl\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a number field builder\r\n   */\r\n  public number(inputKey?: string) {\r\n    return this.fieldBuilder(\"number\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a boolean field builder\r\n   */\r\n  public boolean(inputKey?: string) {\r\n    return this.fieldBuilder(\"boolean\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a float field builder\r\n   */\r\n  public float(inputKey?: string) {\r\n    return this.fieldBuilder(\"float\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * Get a int field builder\r\n   */\r\n  public int(inputKey?: string) {\r\n    return this.fieldBuilder(\"int\", inputKey);\r\n  }\r\n\r\n  /**\r\n   * New field builder\r\n   */\r\n  protected fieldBuilder(type: ResourceOutputValueCastType, inputKey?: string) {\r\n    const builder = new ResourceFieldBuilder(type);\r\n\r\n    if (inputKey) {\r\n      builder.setInputKey(inputKey);\r\n    }\r\n\r\n    return builder;\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/restful/restful.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"mappings":";;;;;;;uBAOsB,OAAA,WAAkB,KAAA,aAAkB,aAAA;;;;YAI9C,UAAA,EAAY,iBAAA;;AAJxB;;YASY,UAAA;EAT4B;;;EAAA,UAc5B,eAAA;EAUU;;;EAAA,mBALD,UAAA,EAAY,iBAAA,CAAkB,CAAA;EA8BpB;;;EAAA,UAzBnB,QAAA,EAAU,MAAA;EAyDD;;;;;EA7CZ,KAAA;EAkEwB;;;EA7DlB,IAAA,CAAK,EAAA,WAAU,OAAA,CAAA,CAAA;EA6GG;;;EArGlB,IAAA,CAAA;IAAO,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiJtB;;;EAjHjB,GAAA,CAAA;IAAM,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoJ7B;;;EA/HT,MAAA,CAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EA+HA;;;EA/EzC,MAAA,CAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EAgHI;;;EApE7C,KAAA,CAAA;IAAQ,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoHyB;;;EAjFjE,MAAA,CAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAwFoB;;;EAvD7D,UAAA,CAAA;IAAa,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiE/C;;;EAAA,UAjBK,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA4BrE;;;EAAA,UArBG,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA+BvC;;;EAAA,UAxBvB,YAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EA0BgC;;;EAAA,UAnBnB,QAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAsBS;;;EAAA,UAfI,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAmB/E;;;EAAA,UAZa,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAuBhE;;;EAAA,UAhBE,WAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBS;;;EAAA,UAfI,OAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAqBU;;;EAAA,UAdG,UAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,GAAU,CAAA,EACV,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBQ;;;EAAA,UAfK,MAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAYY;;;;EAAA,UAJC,cAAA,CACd,MAAA,UACA,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,SAAa,OAAA,SAAA,MAAA,gBAAA,QAAA;AAAA"}
+{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"mappings":";;;;;;;uBAOsB,OAAA,WAAkB,KAAA,aAAkB,aAAA;;;;YAI9C,UAAA,EAAY,iBAAA;;AAJxB;;YASY,UAAA;EAT4B;;;EAAA,UAc5B,eAAA;EAUU;;;EAAA,mBALD,UAAA,EAAY,iBAAA,CAAkB,CAAA;EA8BpB;;;EAAA,UAzBnB,QAAA,EAAU,MAAA;EAyDD;;;;;EA7CZ,KAAA;EAkEwB;;;EA7DlB,IAAA,CAAK,EAAA,WAAU,OAAA,CAAA,CAAA;EA6GG;;;EArGlB,IAAA;IAAO,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiJtB;;;EAjHjB,GAAA;IAAM,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoJ7B;;;EA/HT,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EA+HA;;;EA/EzC,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA;EAgHI;;;EApE7C,KAAA;IAAQ,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAoHyB;;;EAjFjE,MAAA;IAAS,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAwFoB;;;EAvD7D,UAAA;IAAa,OAAA;IAAS;EAAA,GAAY,WAAA,GAAW,OAAA,CAAA,QAAA;EAiE/C;;;EAAA,UAjBK,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA4BrE;;;EAAA,UArBG,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EA+BvC;;;EAAA,UAxBvB,YAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EA0BgC;;;EAAA,UAnBnB,QAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAsBS;;;EAAA,UAfI,YAAA,CAAa,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAmB/E;;;EAAA,UAZa,QAAA,CAAS,QAAA,EAAU,OAAA,EAAS,SAAA,EAAW,QAAA,EAAU,OAAA,EAAS,CAAA,GAAI,OAAA;EAuBhE;;;EAAA,UAhBE,WAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBS;;;EAAA,UAfI,OAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,EAAY,CAAA,GACX,OAAA;EAqBU;;;EAAA,UAdG,UAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,GAAU,CAAA,EACV,UAAA,GAAa,CAAA,GACZ,OAAA;EAsBQ;;;EAAA,UAfK,MAAA,CACd,QAAA,EAAU,OAAA,EACV,SAAA,EAAW,QAAA,EACX,OAAA,EAAS,CAAA,EACT,UAAA,GAAa,CAAA,GACZ,OAAA;EAYY;;;;EAAA,UAJC,cAAA,CACd,MAAA,UACA,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,SAAa,OAAA,SAAA,MAAA,gBAAA,QAAA;AAAA"}

package/esm/restful/restful.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"restful.mjs","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport type { Model } from \"@warlock.js/cascade\";\nimport { log } from \"@warlock.js/logger\";\nimport type { Request, Response } from \"../http\";\nimport type { QueryBuilderContract, RepositoryManager } from \"../repositories\";\nimport type { HttpContext, RestfulMiddleware, RouteResource } from \"../router\";\n\nexport abstract class Restful<T extends Model> implements RouteResource {\n  /**\n   * Middleware for each method\n   */\n  protected middleware: RestfulMiddleware = {};\n\n  /**\n   * Record name\n   */\n  protected recordName = \"record\";\n\n  /**\n   * Records list name\n   */\n  protected recordsListName = \"records\";\n\n  /**\n   * Repository\n   */\n  protected abstract repository: RepositoryManager<T>;\n\n  /**\n   * Define what to be returned when a record is created|updated|deleted|patched\n   */\n  protected returnOn: Record<string, \"record\" | \"records\"> = {\n    create: \"record\",\n    update: \"record\",\n    delete: \"record\",\n    patch: \"record\",\n  };\n\n  /**\n   * Enable fetching cache\n   *\n   * @default true\n   */\n  public cache = true;\n\n  /**\n   * Find record instance by id\n   */\n  public async find(id: number) {\n    const findMethod = this.cache ? \"getCached\" : \"find\";\n    return this.repository[findMethod](id);\n  }\n\n  /**\n   * List records\n   */\n  public async list({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"list\", request, response)) return;\n\n      const responseDocument: GenericObject = {};\n\n      const data = request.heavy();\n\n      if (data.paginate === \"false\") {\n        data.paginate = false;\n      }\n\n      const listMethod = this.cache ? \"listCached\" : \"list\";\n\n      const { data: documents, pagination } = await this.repository[listMethod](data);\n\n      responseDocument[this.recordsListName] = documents;\n\n      if (pagination) {\n        responseDocument.pagination = pagination;\n      }\n\n      return response.success(responseDocument);\n    } catch (error: any) {\n      log.error(\"restful\", \"list\", error);\n      return response.serverError(error);\n    }\n  }\n\n  /**\n   * Get single record\n   */\n  public async get({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"get\", request, response)) return;\n\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"get\", error);\n    }\n  }\n\n  /**\n   * Create a new record\n   */\n  public async create({ request, response }: HttpContext) {\n    try {\n      const model = this.repository.newModel();\n      const beforeCreate = await this.beforeCreate(request, response, model);\n\n      if (beforeCreate) {\n        return beforeCreate;\n      }\n\n      const beforeSave = await this.beforeSave(request, response, model);\n\n      if (beforeSave) {\n        return beforeSave;\n      }\n\n      const record = await this.repository.create(request.all());\n\n      const createOutput = await this.onCreate(request, response, record);\n\n      if (createOutput) {\n        return createOutput;\n      }\n\n      const saveOutput = await this.onSave(request, response, record);\n\n      if (saveOutput) {\n        return saveOutput;\n      }\n\n      if (this.returnOn.create === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.successCreate({\n        [this.recordName]: record,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"create\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Update record\n   */\n  public async update({ request, response }: HttpContext) {\n    try {\n      // Find record\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const beforeOutput = await this.beforeUpdate(request, response, record);\n      if (beforeOutput) {\n        return beforeOutput;\n      }\n\n      const beforeSafe = await this.beforeSave(request, response, record);\n\n      if (beforeSafe) {\n        return beforeSafe;\n      }\n\n      const oldRecord = record.clone();\n\n      await record.save(request.allExceptParams());\n\n      this.onUpdate(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.update === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"update\", error);\n    }\n  }\n\n  /**\n   * Patch record\n   */\n  public async patch({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const oldRecord = record.clone();\n\n      await this.beforePatch(request, response, record, oldRecord);\n      await this.beforeSave(request, response, record, oldRecord);\n\n      await record.save(request.heavyExceptParams());\n\n      this.onPatch(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.patch === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"patch\", error);\n    }\n  }\n\n  /**\n   * Delete record\n   */\n  public async delete({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      if (await this.callMiddleware(\"delete\", request, response, record)) return;\n\n      await this.beforeDelete(request, response, record);\n\n      await record.destroy();\n\n      this.onDelete(request, response, record);\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success();\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"delete\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Bulk delete records\n   */\n  public async bulkDelete({ request, response }: HttpContext) {\n    try {\n      const ids = request.input(\"id\");\n\n      if (!Array.isArray(ids)) {\n        return response.badRequest({\n          error: \"id must be an array\",\n        });\n      }\n\n      const records = await this.repository.all({\n        perform: (query: QueryBuilderContract<T>) =>\n          query.whereIn(\n            \"id\",\n            ids.map((id) => parseInt(id)),\n          ),\n      });\n\n      await Promise.all(\n        records.map(async (record) => {\n          if (await this.callMiddleware(\"delete\", request, response, record)) {\n            return;\n          }\n\n          await this.beforeDelete(request, response, record);\n          await record.destroy();\n          this.onDelete(request, response, record);\n        }),\n      );\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        deleted: records.length,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"bulkDelete\", error);\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Before create\n   */\n  protected async beforeCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On create\n   */\n  protected async onCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before update\n   */\n  protected async beforeUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On update\n   */\n  protected async onUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before delete\n   */\n  protected async beforeDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On delete\n   */\n  protected async onDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before patch\n   */\n  protected async beforePatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On patch\n   */\n  protected async onPatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before save\n   */\n  protected async beforeSave(\n    _request: Request,\n    _response: Response,\n    _record?: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On save\n   */\n  protected async onSave(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Call middleware for the given method\n   *\n   */\n  protected async callMiddleware(\n    method: string,\n    request: Request,\n    response: Response,\n    _record?: any,\n  ) {\n    if (!this.middleware[method]) return;\n\n    for (const middleware of this.middleware[method]) {\n      const output = await middleware({ request, response });\n\n      if (output) {\n        return output;\n      }\n    }\n\n    return;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"restful.mjs","names":[],"sources":["../../../../../../../core/src/restful/restful.ts"],"sourcesContent":["import type { GenericObject } from \"@mongez/reinforcements\";\nimport type { Model } from \"@warlock.js/cascade\";\nimport { log } from \"@warlock.js/logger\";\nimport type { Request, Response } from \"../http\";\nimport type { QueryBuilderContract, RepositoryManager } from \"../repositories\";\nimport type { HttpContext, RestfulMiddleware, RouteResource } from \"../router\";\n\nexport abstract class Restful<T extends Model> implements RouteResource {\n  /**\n   * Middleware for each method\n   */\n  protected middleware: RestfulMiddleware = {};\n\n  /**\n   * Record name\n   */\n  protected recordName = \"record\";\n\n  /**\n   * Records list name\n   */\n  protected recordsListName = \"records\";\n\n  /**\n   * Repository\n   */\n  protected abstract repository: RepositoryManager<T>;\n\n  /**\n   * Define what to be returned when a record is created|updated|deleted|patched\n   */\n  protected returnOn: Record<string, \"record\" | \"records\"> = {\n    create: \"record\",\n    update: \"record\",\n    delete: \"record\",\n    patch: \"record\",\n  };\n\n  /**\n   * Enable fetching cache\n   *\n   * @default true\n   */\n  public cache = true;\n\n  /**\n   * Find record instance by id\n   */\n  public async find(id: number) {\n    const findMethod = this.cache ? \"getCached\" : \"find\";\n    return this.repository[findMethod](id);\n  }\n\n  /**\n   * List records\n   */\n  public async list({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"list\", request, response)) return;\n\n      const responseDocument: GenericObject = {};\n\n      const data = request.heavy();\n\n      if (data.paginate === \"false\") {\n        data.paginate = false;\n      }\n\n      const listMethod = this.cache ? \"listCached\" : \"list\";\n\n      const { data: documents, pagination } = await this.repository[listMethod](data);\n\n      responseDocument[this.recordsListName] = documents;\n\n      if (pagination) {\n        responseDocument.pagination = pagination;\n      }\n\n      return response.success(responseDocument);\n    } catch (error: any) {\n      log.error(\"restful\", \"list\", error);\n      return response.serverError(error);\n    }\n  }\n\n  /**\n   * Get single record\n   */\n  public async get({ request, response }: HttpContext) {\n    try {\n      if (await this.callMiddleware(\"get\", request, response)) return;\n\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"get\", error);\n    }\n  }\n\n  /**\n   * Create a new record\n   */\n  public async create({ request, response }: HttpContext) {\n    try {\n      const model = this.repository.newModel();\n      const beforeCreate = await this.beforeCreate(request, response, model);\n\n      if (beforeCreate) {\n        return beforeCreate;\n      }\n\n      const beforeSave = await this.beforeSave(request, response, model);\n\n      if (beforeSave) {\n        return beforeSave;\n      }\n\n      const record = await this.repository.create(request.all());\n\n      const createOutput = await this.onCreate(request, response, record);\n\n      if (createOutput) {\n        return createOutput;\n      }\n\n      const saveOutput = await this.onSave(request, response, record);\n\n      if (saveOutput) {\n        return saveOutput;\n      }\n\n      if (this.returnOn.create === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.successCreate({\n        [this.recordName]: record,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"create\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Update record\n   */\n  public async update({ request, response }: HttpContext) {\n    try {\n      // Find record\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const beforeOutput = await this.beforeUpdate(request, response, record);\n      if (beforeOutput) {\n        return beforeOutput;\n      }\n\n      const beforeSafe = await this.beforeSave(request, response, record);\n\n      if (beforeSafe) {\n        return beforeSafe;\n      }\n\n      const oldRecord = record.clone();\n\n      await record.save(request.allExceptParams());\n\n      this.onUpdate(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.update === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"update\", error);\n    }\n  }\n\n  /**\n   * Patch record\n   */\n  public async patch({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound({\n          error: \"Record not found\",\n        });\n      }\n\n      const oldRecord = record.clone();\n\n      await this.beforePatch(request, response, record, oldRecord);\n      await this.beforeSave(request, response, record, oldRecord);\n\n      await record.save(request.heavyExceptParams());\n\n      this.onPatch(request, response, record, oldRecord);\n      this.onSave(request, response, record, oldRecord);\n\n      if (this.returnOn.patch === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        [this.recordName]: record,\n      });\n    } catch (error) {\n      log.error(\"restful\", \"patch\", error);\n    }\n  }\n\n  /**\n   * Delete record\n   */\n  public async delete({ request, response }: HttpContext) {\n    try {\n      const record = await this.find(request.input(\"id\"));\n\n      if (!record) {\n        return response.notFound();\n      }\n\n      if (await this.callMiddleware(\"delete\", request, response, record)) return;\n\n      await this.beforeDelete(request, response, record);\n\n      await record.destroy();\n\n      this.onDelete(request, response, record);\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success();\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"delete\", error);\n\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Bulk delete records\n   */\n  public async bulkDelete({ request, response }: HttpContext) {\n    try {\n      const ids = request.input(\"id\");\n\n      if (!Array.isArray(ids)) {\n        return response.badRequest({\n          error: \"id must be an array\",\n        });\n      }\n\n      const records = await this.repository.all({\n        perform: (query: QueryBuilderContract<T>) =>\n          query.whereIn(\n            \"id\",\n            ids.map((id) => parseInt(id)),\n          ),\n      });\n\n      await Promise.all(\n        records.map(async (record) => {\n          if (await this.callMiddleware(\"delete\", request, response, record)) {\n            return;\n          }\n\n          await this.beforeDelete(request, response, record);\n          await record.destroy();\n          this.onDelete(request, response, record);\n        }),\n      );\n\n      if (this.returnOn.delete === \"records\") {\n        return this.list({ request, response });\n      }\n\n      return response.success({\n        deleted: records.length,\n      });\n    } catch (error: Error | any) {\n      log.error(\"restful\", \"bulkDelete\", error);\n      return response.badRequest({\n        error: error.message,\n      });\n    }\n  }\n\n  /**\n   * Before create\n   */\n  protected async beforeCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On create\n   */\n  protected async onCreate(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before update\n   */\n  protected async beforeUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On update\n   */\n  protected async onUpdate(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before delete\n   */\n  protected async beforeDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * On delete\n   */\n  protected async onDelete(_request: Request, _response: Response, _record: T): Promise<any> {\n    //\n  }\n\n  /**\n   * Before patch\n   */\n  protected async beforePatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On patch\n   */\n  protected async onPatch(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Before save\n   */\n  protected async beforeSave(\n    _request: Request,\n    _response: Response,\n    _record?: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * On save\n   */\n  protected async onSave(\n    _request: Request,\n    _response: Response,\n    _record: T,\n    _oldRecord?: T,\n  ): Promise<any> {\n    //\n  }\n\n  /**\n   * Call middleware for the given method\n   *\n   */\n  protected async callMiddleware(\n    method: string,\n    request: Request,\n    response: Response,\n    _record?: any,\n  ) {\n    if (!this.middleware[method]) return;\n\n    for (const middleware of this.middleware[method]) {\n      const output = await middleware({ request, response });\n\n      if (output) {\n        return output;\n      }\n    }\n\n    return;\n  }\n}\n"],"mappings":"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"}

package/esm/router/log-request-lifecycle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"log-request-lifecycle.mjs","names":[],"sources":["../../../../../../../core/src/router/log-request-lifecycle.ts"],"sourcesContent":["/**\n * Both ends of a request's log entry.\n *\n * ## Why the completion line exists\n *\n * The router logged `Starting Request: <id>` and nothing else. A request that\n * hung for thirty seconds and one that returned in two milliseconds produced\n * **byte-identical output**, so the log could not answer the one question\n * anyone opens it to ask.\n *\n * Note what \"detecting a hang\" actually means. Nothing can log the completion\n * of a request that never completes — the mechanism is the **absence** of a\n * completion line beside a start line that has one. That only works if the\n * completion line is emitted on every settled path, **including a throw**,\n * which is why the error path here is not an afterthought.\n *\n * ## Why the level tracks the status\n *\n * A handled 500 does not throw; it returns a response. Logging it at `info`\n * would bury the exact entries someone scanning the log is hunting for, so the\n * level is derived from the outcome: informational below 400, a warning for\n * client errors, an error for server errors and for anything that threw.\n *\n * ## Ports rather than a direct `log` import\n *\n * The behaviour worth pinning down is *which lines come out, in which order,\n * at which level, when the run throws*. Injecting the sink and the clock makes\n * that assertable without a server, a socket or a fake timer.\n */\n\nexport type RequestLogEntry = {\n  module: string;\n  action: string;\n  message: string;\n  /**\n   * Typed as the logger accepts it, not as `unknown`. These entries exist to be\n   * handed to `log.info` / `warn` / `error`, whose parameter is\n   * `Record<string, any>` — `unknown` was not assignable, so the adapter in\n   * router.ts could not compile even though every real caller passes an object.\n   */\n  context?: Record<string, any>;\n};\n\nexport type RequestLogPorts = {\n  info(entry: RequestLogEntry): void;\n  warn(entry: RequestLogEntry): void;\n  error(entry: RequestLogEntry): void;\n  /** Monotonic milliseconds. Called exactly twice per request. */\n  now(): number;\n};\n\nexport type RequestLogDescriptor = {\n  module: string;\n  action: string;\n  requestId: string;\n  /**\n   * Typed as the logger accepts it, not as `unknown`. These entries exist to be\n   * handed to `log.info` / `warn` / `error`, whose parameter is\n   * `Record<string, any>` — `unknown` was not assignable, so the adapter in\n   * router.ts could not compile even though every real caller passes an object.\n   */\n  context?: Record<string, any>;\n  /**\n   * Read AFTER the run settles — the status is decided during the request, so\n   * capturing it up front would report the default on every entry.\n   */\n  statusCode(): number | undefined;\n};\n\ntype Level = \"info\" | \"warn\" | \"error\";\n\nfunction levelForStatus(statusCode: number | undefined): Level {\n  // An unknown status is not evidence of a problem; saying \"error\" because we\n  // failed to read a number would be inventing a defect.\n  if (statusCode === undefined) return \"info\";\n\n  if (statusCode >= 500) return \"error\";\n\n  if (statusCode >= 400) return \"warn\";\n\n  return \"info\";\n}\n\nexport async function logRequestLifecycle<TResult>(\n  ports: RequestLogPorts,\n  descriptor: RequestLogDescriptor,\n  run: () => Promise<TResult>,\n): Promise<TResult> {\n  const startedAt = ports.now();\n\n  ports.info({\n    module: descriptor.module,\n    action: descriptor.action,\n    message: `Starting Request: ${descriptor.requestId}`,\n    context: descriptor.context,\n  });\n\n  const finish = (level: Level, outcome: string): void => {\n    const duration = Math.round(ports.now() - startedAt);\n\n    ports[level]({\n      module: descriptor.module,\n      action: descriptor.action,\n      message: `Completed Request: ${descriptor.requestId} — ${outcome} in ${duration}ms`,\n      context: descriptor.context,\n    });\n  };\n\n  try {\n    const result = await run();\n\n    const statusCode = descriptor.statusCode();\n\n    finish(levelForStatus(statusCode), statusCode === undefined ? \"no status\" : String(statusCode));\n\n    return result;\n  } catch (error) {\n    // The throw is reported and then re-thrown untouched: this function\n    // observes the request, it does not own its error handling.\n    finish(\"error\", `threw ${error instanceof Error ? error.name : typeof error}`);\n\n    throw error;\n  }\n}\n"],"mappings":";AAuEA,SAAS,eAAe,YAAuC;CAG7D,IAAI,eAAe,QAAW,OAAO;CAErC,IAAI,cAAc,KAAK,OAAO;CAE9B,IAAI,cAAc,KAAK,OAAO;CAE9B,OAAO;AACT;AAEA,eAAsB,oBACpB,OACA,YACA,KACkB;CAClB,MAAM,YAAY,MAAM,IAAI;CAE5B,MAAM,KAAK;EACT,QAAQ,WAAW;EACnB,QAAQ,WAAW;EACnB,SAAS,qBAAqB,WAAW;EACzC,SAAS,WAAW;CACtB,CAAC;CAED,MAAM,UAAU,OAAc,YAA0B;EACtD,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI,IAAI,SAAS;EAEnD,MAAM,OAAO;GACX,QAAQ,WAAW;GACnB,QAAQ,WAAW;GACnB,SAAS,sBAAsB,WAAW,UAAU,KAAK,QAAQ,MAAM,SAAS;GAChF,SAAS,WAAW;EACtB,CAAC;CACH;CAEA,IAAI;EACF,MAAM,SAAS,MAAM,IAAI;EAEzB,MAAM,aAAa,WAAW,WAAW;EAEzC,OAAO,eAAe,UAAU,GAAG,eAAe,SAAY,cAAc,OAAO,UAAU,CAAC;EAE9F,OAAO;CACT,SAAS,OAAO;EAGd,OAAO,SAAS,SAAS,iBAAiB,QAAQ,MAAM,OAAO,OAAO,OAAO;EAE7E,MAAM;CACR;AACF"}
+{"version":3,"file":"log-request-lifecycle.mjs","names":[],"sources":["../../../../../../../core/src/router/log-request-lifecycle.ts"],"sourcesContent":["/**\n * Both ends of a request's log entry.\n *\n * ## Why the completion line exists\n *\n * The router logged `Starting Request: <id>` and nothing else. A request that\n * hung for thirty seconds and one that returned in two milliseconds produced\n * **byte-identical output**, so the log could not answer the one question\n * anyone opens it to ask.\n *\n * Note what \"detecting a hang\" actually means. Nothing can log the completion\n * of a request that never completes — the mechanism is the **absence** of a\n * completion line beside a start line that has one. That only works if the\n * completion line is emitted on every settled path, **including a throw**,\n * which is why the error path here is not an afterthought.\n *\n * ## Why the level tracks the status\n *\n * A handled 500 does not throw; it returns a response. Logging it at `info`\n * would bury the exact entries someone scanning the log is hunting for, so the\n * level is derived from the outcome: informational below 400, a warning for\n * client errors, an error for server errors and for anything that threw.\n *\n * ## Ports rather than a direct `log` import\n *\n * The behaviour worth pinning down is *which lines come out, in which order,\n * at which level, when the run throws*. Injecting the sink and the clock makes\n * that assertable without a server, a socket or a fake timer.\n */\n\nexport type RequestLogEntry = {\n  module: string;\n  action: string;\n  message: string;\n  /**\n   * Typed as the logger accepts it, not as `unknown`. These entries exist to be\n   * handed to `log.info` / `warn` / `error`, whose parameter is\n   * `Record<string, any>` — `unknown` was not assignable, so the adapter in\n   * router.ts could not compile even though every real caller passes an object.\n   */\n  context?: Record<string, any>;\n};\n\nexport type RequestLogPorts = {\n  info(entry: RequestLogEntry): void;\n  warn(entry: RequestLogEntry): void;\n  error(entry: RequestLogEntry): void;\n  /** Monotonic milliseconds. Called exactly twice per request. */\n  now(): number;\n};\n\nexport type RequestLogDescriptor = {\n  module: string;\n  action: string;\n  requestId: string;\n  /**\n   * Typed as the logger accepts it, not as `unknown`. These entries exist to be\n   * handed to `log.info` / `warn` / `error`, whose parameter is\n   * `Record<string, any>` — `unknown` was not assignable, so the adapter in\n   * router.ts could not compile even though every real caller passes an object.\n   */\n  context?: Record<string, any>;\n  /**\n   * Read AFTER the run settles — the status is decided during the request, so\n   * capturing it up front would report the default on every entry.\n   */\n  statusCode(): number | undefined;\n};\n\ntype Level = \"info\" | \"warn\" | \"error\";\n\nfunction levelForStatus(statusCode: number | undefined): Level {\n  // An unknown status is not evidence of a problem; saying \"error\" because we\n  // failed to read a number would be inventing a defect.\n  if (statusCode === undefined) return \"info\";\n\n  if (statusCode >= 500) return \"error\";\n\n  if (statusCode >= 400) return \"warn\";\n\n  return \"info\";\n}\n\nexport async function logRequestLifecycle<TResult>(\n  ports: RequestLogPorts,\n  descriptor: RequestLogDescriptor,\n  run: () => Promise<TResult>,\n): Promise<TResult> {\n  const startedAt = ports.now();\n\n  ports.info({\n    module: descriptor.module,\n    action: descriptor.action,\n    message: `Starting Request: ${descriptor.requestId}`,\n    context: descriptor.context,\n  });\n\n  const finish = (level: Level, outcome: string): void => {\n    const duration = Math.round(ports.now() - startedAt);\n\n    ports[level]({\n      module: descriptor.module,\n      action: descriptor.action,\n      message: `Completed Request: ${descriptor.requestId} — ${outcome} in ${duration}ms`,\n      context: descriptor.context,\n    });\n  };\n\n  try {\n    const result = await run();\n\n    const statusCode = descriptor.statusCode();\n\n    finish(levelForStatus(statusCode), statusCode === undefined ? \"no status\" : String(statusCode));\n\n    return result;\n  } catch (error) {\n    // The throw is reported and then re-thrown untouched: this function\n    // observes the request, it does not own its error handling.\n    finish(\"error\", `threw ${error instanceof Error ? error.name : typeof error}`);\n\n    throw error;\n  }\n}\n"],"mappings":";AAuEA,SAAS,eAAe,YAAuC;CAG7D,IAAI,eAAe,QAAW,OAAO;CAErC,IAAI,cAAc,KAAK,OAAO;CAE9B,IAAI,cAAc,KAAK,OAAO;CAE9B,OAAO;AACT;AAEA,eAAsB,oBACpB,OACA,YACA,KACkB;CAClB,MAAM,YAAY,MAAM,IAAI;CAE5B,MAAM,KAAK;EACT,QAAQ,WAAW;EACnB,QAAQ,WAAW;EACnB,SAAS,qBAAqB,WAAW;EACzC,SAAS,WAAW;CACtB,CAAC;CAED,MAAM,UAAU,OAAc,YAA0B;EACtD,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI,IAAI,SAAS;EAEnD,MAAM,MAAM,CAAC;GACX,QAAQ,WAAW;GACnB,QAAQ,WAAW;GACnB,SAAS,sBAAsB,WAAW,UAAU,KAAK,QAAQ,MAAM,SAAS;GAChF,SAAS,WAAW;EACtB,CAAC;CACH;CAEA,IAAI;EACF,MAAM,SAAS,MAAM,IAAI;EAEzB,MAAM,aAAa,WAAW,WAAW;EAEzC,OAAO,eAAe,UAAU,GAAG,eAAe,SAAY,cAAc,OAAO,UAAU,CAAC;EAE9F,OAAO;CACT,SAAS,OAAO;EAGd,OAAO,SAAS,SAAS,iBAAiB,QAAQ,MAAM,OAAO,OAAO,OAAO;EAE7E,MAAM;CACR;AACF"}

package/esm/router/normalize-route-path.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-route-path.d.mts","names":[],"sources":["../../../../../../../core/src/router/normalize-route-path.ts"],"mappings":";;AAyBA;;;;AAA8C;;;;;;;;;;;;;;;;;;iBAA9B,kBAAA,CAAA,GAAsB,QAAQ"}
+{"version":3,"file":"normalize-route-path.d.mts","names":[],"sources":["../../../../../../../core/src/router/normalize-route-path.ts"],"mappings":";;AAyBA;;;;AAA8C;;;;;;;;;;;;;;;;;;iBAA9B,kBAAA,IAAsB,QAAQ"}

package/esm/router/positional-handler-diagnostics.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"positional-handler-diagnostics.d.mts","names":[],"sources":["../../../../../../../core/src/router/positional-handler-diagnostics.ts"],"mappings":";;;;AAyPsE;AAmBtE;;AAnBsE,KArN1D,wBAAA;EAwOsE,kDAtOhF,MAAA,EAAQ,KAAK,YA+OC;EA5Od,IAAA;EAGA,WAAA,UAyOgE;EAtOhE,UAAA;AAAA;;;AAkP4C;AAS9C;;;;AAAkF;AAclF;;;;;;;;;;;;;AAAsF;;;;;;;;;;;iBAhGtE,0BAAA,CAA2B,OAAgB;;;;;;;;;iBA+B3C,uBAAA,CACd,OAAA,WACA,KAAA;EAAS,MAAA,EAAQ,KAAK;EAAY,IAAA;EAAc,UAAA;AAAA;;;;iBAmBlC,6BAAA,CAAA,YAA0C,wBAAwB;;;;;;iBASlE,+BAAA,CAAgC,UAAkB;;;;;iBAYlD,8BAAA,CAAA;;;;;;iBASA,gCAAA,CAAiC,OAAiC,EAAxB,wBAAwB;;;;;;;iBAclE,+BAAA,CAAgC,MAAA,GAAQ,IAAA,QAAY,GAAA,YAAkB,wBAAA"}
+{"version":3,"file":"positional-handler-diagnostics.d.mts","names":[],"sources":["../../../../../../../core/src/router/positional-handler-diagnostics.ts"],"mappings":";;;;AAyPsE;AAmBtE;;AAnBsE,KArN1D,wBAAA;EAwOsE,kDAtOhF,MAAA,EAAQ,KAAK,YA+OC;EA5Od,IAAA;EAGA,WAAA,UAyOgE;EAtOhE,UAAA;AAAA;;;AAkP4C;AAS9C;;;;AAAkF;AAclF;;;;;;;;;;;;;AAAsF;;;;;;;;;;;iBAhGtE,0BAAA,CAA2B,OAAgB;;;;;;;;;iBA+B3C,uBAAA,CACd,OAAA,WACA,KAAA;EAAS,MAAA,EAAQ,KAAK;EAAY,IAAA;EAAc,UAAA;AAAA;;;;iBAmBlC,6BAAA,aAA0C,wBAAwB;;;;;;iBASlE,+BAAA,CAAgC,UAAkB;;;;;iBAYlD,8BAAA;;;;;;iBASA,gCAAA,CAAiC,OAAiC,EAAxB,wBAAwB;;;;;;;iBAclE,+BAAA,CAAgC,MAAA,GAAQ,IAAA,QAAY,GAAA,YAAkB,wBAAA"}

package/esm/router/positional-handler-diagnostics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"positional-handler-diagnostics.mjs","names":[],"sources":["../../../../../../../core/src/router/positional-handler-diagnostics.ts"],"sourcesContent":["/**\n * Early detection of route handlers still written against the **v4 positional\n * signature** — `(request, response)` — after v5 moved to a single context\n * object, `({ request, response })`.\n *\n * ## Why this exists\n *\n * A v4 handler is not rejected anywhere. It registers fine, and the router\n * calls it with one argument, so `response` is simply `undefined`. The app only\n * breaks on the first request that reaches it, with:\n *\n *     TypeError: Cannot read properties of undefined (reading 'success')\n *\n * That message names nothing the reader can act on — not the route, not the\n * handler, not the change to make. This module turns that late, opaque failure\n * into one explicit list printed at boot, and into a `warlock doctor` check.\n *\n * The break itself is intentional; nothing here restores the positional form.\n * Detection and diagnostics only.\n *\n * ## Why it warns and never throws\n *\n * The signal is a heuristic (see {@link looksLikePositionalHandler}), so a\n * false positive is possible in principle. Turning one into a boot failure\n * would take a working application down over a guess, which is strictly worse\n * than the problem being diagnosed. Everything on this path is therefore a\n * warning: nothing here throws, and nothing here changes how a handler is\n * called. A miss simply degrades to the old runtime `TypeError`.\n */\n\nimport { log } from \"@warlock.js/logger\";\nimport type { Route } from \"./types\";\n\n/**\n * One route whose handler looks like it was written for v4.\n */\nexport type PositionalHandlerSuspect = {\n  /** HTTP method the route was registered under. */\n  method: Route[\"method\"];\n\n  /** Full route path, prefixes already applied. */\n  path: string;\n\n  /** Handler function name, or `\"(anonymous)\"` when it has none. */\n  handlerName: string;\n\n  /** Route file the route came from, when the router knows it. */\n  sourceFile: string;\n};\n\n/**\n * Collected across the whole registration pass so the warning can be emitted\n * ONCE, as a single list, rather than one line per route (or — as before — one\n * mystery 500 per request).\n */\nconst suspects: PositionalHandlerSuspect[] = [];\n\n/**\n * Split the parameter list of a function's source into top-level parameters.\n *\n * Depth-aware and quote-aware, because a default value may itself contain\n * commas, parentheses, braces or strings — `(request, response = f(a, b))` is\n * two parameters, not three. Anything unbalanced returns `undefined`: refusing\n * to guess is what keeps a parse quirk from becoming a false warning.\n *\n * @param openIndex index of the `(` that opens the parameter list.\n */\nfunction splitTopLevelParameters(source: string, openIndex: number): string[] | undefined {\n  const parameters: string[] = [];\n\n  let depth = 0;\n  let current = \"\";\n  let quote = \"\";\n\n  for (let index = openIndex; index < source.length; index++) {\n    const char = source[index];\n\n    if (quote) {\n      if (char === \"\\\\\") {\n        current += char + (source[index + 1] ?? \"\");\n        index++;\n        continue;\n      }\n\n      if (char === quote) {\n        quote = \"\";\n      }\n\n      current += char;\n      continue;\n    }\n\n    if (char === '\"' || char === \"'\" || char === \"`\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n\n    if (char === \"(\" || char === \"[\" || char === \"{\") {\n      depth++;\n\n      // The paren that opens the list is punctuation, not part of a parameter.\n      if (depth === 1) continue;\n\n      current += char;\n      continue;\n    }\n\n    if (char === \")\" || char === \"]\" || char === \"}\") {\n      depth--;\n\n      if (depth === 0) {\n        if (current.trim()) {\n          parameters.push(current.trim());\n        }\n\n        return parameters;\n      }\n\n      current += char;\n      continue;\n    }\n\n    if (char === \",\" && depth === 1) {\n      parameters.push(current.trim());\n      current = \"\";\n      continue;\n    }\n\n    current += char;\n  }\n\n  // Never found the closing paren — treat the source as unreadable.\n  return undefined;\n}\n\n/**\n * Read a function's declared parameters from its own source.\n *\n * Returns `undefined` whenever the source cannot be trusted, which callers must\n * treat as \"no information\" rather than \"no parameters\":\n *\n * - `Function.prototype.bind` replaces the body with `[native code]`, so every\n *   `[Controller, \"method\"]` tuple handler lands here (the router binds them);\n * - native functions likewise;\n * - a class, whose first `(` belongs to a constructor or a method, not to a\n *   parameter list;\n * - anything that fails to parse.\n */\nfunction readParameterList(handler: Function): string[] | undefined {\n  let source: string;\n\n  try {\n    source = Function.prototype.toString.call(handler);\n  } catch {\n    return undefined;\n  }\n\n  if (source.includes(\"[native code]\")) return undefined;\n\n  if (/^\\s*class[\\s{]/.test(source)) return undefined;\n\n  // A single parameter needs no parentheses: `ctx => …`, `async ctx => …`.\n  const bareArrow = source.match(/^\\s*(?:async\\s+)?([A-Za-z_$][\\w$]*)\\s*=>/);\n\n  if (bareArrow) return [bareArrow[1]];\n\n  const openIndex = source.indexOf(\"(\");\n\n  if (openIndex === -1) return undefined;\n\n  return splitTopLevelParameters(source, openIndex);\n}\n\n/**\n * Whether a parameter is written as a destructuring pattern — `{ request }` or\n * `[a, b]` — as opposed to a plain name.\n */\nfunction isDestructured(parameter: string) {\n  const start = parameter.trimStart();\n\n  return start.startsWith(\"{\") || start.startsWith(\"[\");\n}\n\n/**\n * Does this handler look like it was written for the v4 positional signature?\n *\n * ## The signal, and what it misses\n *\n * `Function.length` alone is not enough, because it stops counting at the first\n * defaulted parameter:\n *\n * | handler                            | `.length` | actually |\n * | ---------------------------------- | --------- | -------- |\n * | `({ request, response }) => …`     | 1         | v5       |\n * | `(ctx) => …`                       | 1         | v5       |\n * | `(request, response) => …`         | 2         | v4       |\n * | `(request, response = x) => …`     | 1         | v4       |\n *\n * So the primary signal is the function's own source: a handler is suspect when\n * it declares **two or more** parameters and the first is **not** destructured.\n * Reading the source catches the defaulted row that arity cannot, and rules out\n * the `({ … }, extra)` shape that arity would wrongly flag.\n *\n * When the source is unreadable — a bound or native function — this falls back\n * to `handler.length >= 2`, which `bind` preserves. That is a weaker signal but\n * never a wrong one for the common cases; it only loses the defaulted row.\n *\n * ## What is still missed, by design\n *\n * A one-parameter v4 handler (`(request) => …`) is indistinguishable from a v5\n * `(ctx) => …` and is deliberately not flagged — guessing there would produce\n * false positives on correct code. False positives against the canonical\n * `({ … })` form are essentially nil, and every miss simply leaves today's\n * behaviour in place.\n */\nexport function looksLikePositionalHandler(handler: unknown): boolean {\n  if (typeof handler !== \"function\") return false;\n\n  const parameters = readParameterList(handler);\n\n  if (parameters) {\n    return parameters.length >= 2 && !isDestructured(parameters[0]);\n  }\n\n  return handler.length >= 2;\n}\n\n/**\n * The name to print for a handler.\n *\n * `Function.bind` prefixes the name with `\"bound \"`, and the router binds every\n * `[Controller, \"method\"]` tuple handler. The bare method name is what the user\n * actually wrote, so that is what gets printed.\n */\nfunction handlerDisplayName(handler: Function): string {\n  return handler.name?.replace(/^bound /, \"\").trim() || \"(anonymous)\";\n}\n\n/**\n * Inspect one route's handler as it registers, recording it when it looks like\n * the v4 positional form. Called from `Router.add`, so the cost is paid once per\n * route at registration and never per request.\n *\n * Deliberately total: any unexpected failure in the heuristic is swallowed, so a\n * diagnostic can never be the reason a route fails to register.\n */\nexport function inspectHandlerSignature(\n  handler: unknown,\n  route: { method: Route[\"method\"]; path: string; sourceFile: string },\n) {\n  try {\n    if (!looksLikePositionalHandler(handler)) return;\n\n    suspects.push({\n      method: route.method,\n      path: route.path,\n      handlerName: handlerDisplayName(handler as Function),\n      sourceFile: route.sourceFile,\n    });\n  } catch {\n    // A diagnostic must never break registration.\n  }\n}\n\n/**\n * Every suspect recorded so far, in registration order.\n */\nexport function listPositionalHandlerSuspects(): readonly PositionalHandlerSuspect[] {\n  return suspects;\n}\n\n/**\n * Drop the suspects belonging to a route file. Kept in step with\n * `Router.removeRoutesBySourceFile` so an HMR reload that fixes a handler does\n * not keep reporting the version it replaced.\n */\nexport function forgetPositionalHandlerSuspects(sourceFile: string) {\n  for (let index = suspects.length - 1; index >= 0; index--) {\n    if (suspects[index].sourceFile === sourceFile) {\n      suspects.splice(index, 1);\n    }\n  }\n}\n\n/**\n * Drop every recorded suspect. Intended for tests, which share the router\n * singleton.\n */\nexport function clearPositionalHandlerSuspects() {\n  suspects.length = 0;\n}\n\n/**\n * The one-line diagnostic for a single route. Written for someone who has never\n * read Warlock's internals: it names the handler, the route, what is wrong, and\n * the exact edit that fixes it.\n */\nexport function describePositionalHandlerSuspect(suspect: PositionalHandlerSuspect): string {\n  return (\n    `Handler \"${suspect.handlerName}\" (${suspect.method} ${suspect.path}) looks like ` +\n    `the v4 positional signature (request, response). ` +\n    `v5 passes a single context object — change it to ({ request, response }).`\n  );\n}\n\n/**\n * The full boot-time warning: every suspect, once, in one entry.\n *\n * One boot, one list — not one warning per route, and emphatically not one 500\n * per request. Returns the reported suspects so callers can assert on them.\n */\nexport function reportPositionalHandlerSuspects(logger: Pick<typeof log, \"warn\"> = log) {\n  const reported = [...suspects];\n\n  if (reported.length === 0) return reported;\n\n  const headline =\n    reported.length === 1\n      ? \"1 route handler looks like the v4 positional signature.\"\n      : `${reported.length} route handlers look like the v4 positional signature.`;\n\n  logger.warn({\n    module: \"router\",\n    action: \"handlerSignature\",\n    message:\n      `${headline} Warlock v5 calls every route handler with a single context object, ` +\n      `so a second parameter is always undefined and the request fails as soon as it is used:\\n` +\n      reported.map((suspect) => `  - ${describePositionalHandlerSuspect(suspect)}`).join(\"\\n\"),\n    context: { handlers: reported },\n  });\n\n  return reported;\n}\n"],"mappings":"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"}
+{"version":3,"file":"positional-handler-diagnostics.mjs","names":[],"sources":["../../../../../../../core/src/router/positional-handler-diagnostics.ts"],"sourcesContent":["/**\n * Early detection of route handlers still written against the **v4 positional\n * signature** — `(request, response)` — after v5 moved to a single context\n * object, `({ request, response })`.\n *\n * ## Why this exists\n *\n * A v4 handler is not rejected anywhere. It registers fine, and the router\n * calls it with one argument, so `response` is simply `undefined`. The app only\n * breaks on the first request that reaches it, with:\n *\n *     TypeError: Cannot read properties of undefined (reading 'success')\n *\n * That message names nothing the reader can act on — not the route, not the\n * handler, not the change to make. This module turns that late, opaque failure\n * into one explicit list printed at boot, and into a `warlock doctor` check.\n *\n * The break itself is intentional; nothing here restores the positional form.\n * Detection and diagnostics only.\n *\n * ## Why it warns and never throws\n *\n * The signal is a heuristic (see {@link looksLikePositionalHandler}), so a\n * false positive is possible in principle. Turning one into a boot failure\n * would take a working application down over a guess, which is strictly worse\n * than the problem being diagnosed. Everything on this path is therefore a\n * warning: nothing here throws, and nothing here changes how a handler is\n * called. A miss simply degrades to the old runtime `TypeError`.\n */\n\nimport { log } from \"@warlock.js/logger\";\nimport type { Route } from \"./types\";\n\n/**\n * One route whose handler looks like it was written for v4.\n */\nexport type PositionalHandlerSuspect = {\n  /** HTTP method the route was registered under. */\n  method: Route[\"method\"];\n\n  /** Full route path, prefixes already applied. */\n  path: string;\n\n  /** Handler function name, or `\"(anonymous)\"` when it has none. */\n  handlerName: string;\n\n  /** Route file the route came from, when the router knows it. */\n  sourceFile: string;\n};\n\n/**\n * Collected across the whole registration pass so the warning can be emitted\n * ONCE, as a single list, rather than one line per route (or — as before — one\n * mystery 500 per request).\n */\nconst suspects: PositionalHandlerSuspect[] = [];\n\n/**\n * Split the parameter list of a function's source into top-level parameters.\n *\n * Depth-aware and quote-aware, because a default value may itself contain\n * commas, parentheses, braces or strings — `(request, response = f(a, b))` is\n * two parameters, not three. Anything unbalanced returns `undefined`: refusing\n * to guess is what keeps a parse quirk from becoming a false warning.\n *\n * @param openIndex index of the `(` that opens the parameter list.\n */\nfunction splitTopLevelParameters(source: string, openIndex: number): string[] | undefined {\n  const parameters: string[] = [];\n\n  let depth = 0;\n  let current = \"\";\n  let quote = \"\";\n\n  for (let index = openIndex; index < source.length; index++) {\n    const char = source[index];\n\n    if (quote) {\n      if (char === \"\\\\\") {\n        current += char + (source[index + 1] ?? \"\");\n        index++;\n        continue;\n      }\n\n      if (char === quote) {\n        quote = \"\";\n      }\n\n      current += char;\n      continue;\n    }\n\n    if (char === '\"' || char === \"'\" || char === \"`\") {\n      quote = char;\n      current += char;\n      continue;\n    }\n\n    if (char === \"(\" || char === \"[\" || char === \"{\") {\n      depth++;\n\n      // The paren that opens the list is punctuation, not part of a parameter.\n      if (depth === 1) continue;\n\n      current += char;\n      continue;\n    }\n\n    if (char === \")\" || char === \"]\" || char === \"}\") {\n      depth--;\n\n      if (depth === 0) {\n        if (current.trim()) {\n          parameters.push(current.trim());\n        }\n\n        return parameters;\n      }\n\n      current += char;\n      continue;\n    }\n\n    if (char === \",\" && depth === 1) {\n      parameters.push(current.trim());\n      current = \"\";\n      continue;\n    }\n\n    current += char;\n  }\n\n  // Never found the closing paren — treat the source as unreadable.\n  return undefined;\n}\n\n/**\n * Read a function's declared parameters from its own source.\n *\n * Returns `undefined` whenever the source cannot be trusted, which callers must\n * treat as \"no information\" rather than \"no parameters\":\n *\n * - `Function.prototype.bind` replaces the body with `[native code]`, so every\n *   `[Controller, \"method\"]` tuple handler lands here (the router binds them);\n * - native functions likewise;\n * - a class, whose first `(` belongs to a constructor or a method, not to a\n *   parameter list;\n * - anything that fails to parse.\n */\nfunction readParameterList(handler: Function): string[] | undefined {\n  let source: string;\n\n  try {\n    source = Function.prototype.toString.call(handler);\n  } catch {\n    return undefined;\n  }\n\n  if (source.includes(\"[native code]\")) return undefined;\n\n  if (/^\\s*class[\\s{]/.test(source)) return undefined;\n\n  // A single parameter needs no parentheses: `ctx => …`, `async ctx => …`.\n  const bareArrow = source.match(/^\\s*(?:async\\s+)?([A-Za-z_$][\\w$]*)\\s*=>/);\n\n  if (bareArrow) return [bareArrow[1]];\n\n  const openIndex = source.indexOf(\"(\");\n\n  if (openIndex === -1) return undefined;\n\n  return splitTopLevelParameters(source, openIndex);\n}\n\n/**\n * Whether a parameter is written as a destructuring pattern — `{ request }` or\n * `[a, b]` — as opposed to a plain name.\n */\nfunction isDestructured(parameter: string) {\n  const start = parameter.trimStart();\n\n  return start.startsWith(\"{\") || start.startsWith(\"[\");\n}\n\n/**\n * Does this handler look like it was written for the v4 positional signature?\n *\n * ## The signal, and what it misses\n *\n * `Function.length` alone is not enough, because it stops counting at the first\n * defaulted parameter:\n *\n * | handler                            | `.length` | actually |\n * | ---------------------------------- | --------- | -------- |\n * | `({ request, response }) => …`     | 1         | v5       |\n * | `(ctx) => …`                       | 1         | v5       |\n * | `(request, response) => …`         | 2         | v4       |\n * | `(request, response = x) => …`     | 1         | v4       |\n *\n * So the primary signal is the function's own source: a handler is suspect when\n * it declares **two or more** parameters and the first is **not** destructured.\n * Reading the source catches the defaulted row that arity cannot, and rules out\n * the `({ … }, extra)` shape that arity would wrongly flag.\n *\n * When the source is unreadable — a bound or native function — this falls back\n * to `handler.length >= 2`, which `bind` preserves. That is a weaker signal but\n * never a wrong one for the common cases; it only loses the defaulted row.\n *\n * ## What is still missed, by design\n *\n * A one-parameter v4 handler (`(request) => …`) is indistinguishable from a v5\n * `(ctx) => …` and is deliberately not flagged — guessing there would produce\n * false positives on correct code. False positives against the canonical\n * `({ … })` form are essentially nil, and every miss simply leaves today's\n * behaviour in place.\n */\nexport function looksLikePositionalHandler(handler: unknown): boolean {\n  if (typeof handler !== \"function\") return false;\n\n  const parameters = readParameterList(handler);\n\n  if (parameters) {\n    return parameters.length >= 2 && !isDestructured(parameters[0]);\n  }\n\n  return handler.length >= 2;\n}\n\n/**\n * The name to print for a handler.\n *\n * `Function.bind` prefixes the name with `\"bound \"`, and the router binds every\n * `[Controller, \"method\"]` tuple handler. The bare method name is what the user\n * actually wrote, so that is what gets printed.\n */\nfunction handlerDisplayName(handler: Function): string {\n  return handler.name?.replace(/^bound /, \"\").trim() || \"(anonymous)\";\n}\n\n/**\n * Inspect one route's handler as it registers, recording it when it looks like\n * the v4 positional form. Called from `Router.add`, so the cost is paid once per\n * route at registration and never per request.\n *\n * Deliberately total: any unexpected failure in the heuristic is swallowed, so a\n * diagnostic can never be the reason a route fails to register.\n */\nexport function inspectHandlerSignature(\n  handler: unknown,\n  route: { method: Route[\"method\"]; path: string; sourceFile: string },\n) {\n  try {\n    if (!looksLikePositionalHandler(handler)) return;\n\n    suspects.push({\n      method: route.method,\n      path: route.path,\n      handlerName: handlerDisplayName(handler as Function),\n      sourceFile: route.sourceFile,\n    });\n  } catch {\n    // A diagnostic must never break registration.\n  }\n}\n\n/**\n * Every suspect recorded so far, in registration order.\n */\nexport function listPositionalHandlerSuspects(): readonly PositionalHandlerSuspect[] {\n  return suspects;\n}\n\n/**\n * Drop the suspects belonging to a route file. Kept in step with\n * `Router.removeRoutesBySourceFile` so an HMR reload that fixes a handler does\n * not keep reporting the version it replaced.\n */\nexport function forgetPositionalHandlerSuspects(sourceFile: string) {\n  for (let index = suspects.length - 1; index >= 0; index--) {\n    if (suspects[index].sourceFile === sourceFile) {\n      suspects.splice(index, 1);\n    }\n  }\n}\n\n/**\n * Drop every recorded suspect. Intended for tests, which share the router\n * singleton.\n */\nexport function clearPositionalHandlerSuspects() {\n  suspects.length = 0;\n}\n\n/**\n * The one-line diagnostic for a single route. Written for someone who has never\n * read Warlock's internals: it names the handler, the route, what is wrong, and\n * the exact edit that fixes it.\n */\nexport function describePositionalHandlerSuspect(suspect: PositionalHandlerSuspect): string {\n  return (\n    `Handler \"${suspect.handlerName}\" (${suspect.method} ${suspect.path}) looks like ` +\n    `the v4 positional signature (request, response). ` +\n    `v5 passes a single context object — change it to ({ request, response }).`\n  );\n}\n\n/**\n * The full boot-time warning: every suspect, once, in one entry.\n *\n * One boot, one list — not one warning per route, and emphatically not one 500\n * per request. Returns the reported suspects so callers can assert on them.\n */\nexport function reportPositionalHandlerSuspects(logger: Pick<typeof log, \"warn\"> = log) {\n  const reported = [...suspects];\n\n  if (reported.length === 0) return reported;\n\n  const headline =\n    reported.length === 1\n      ? \"1 route handler looks like the v4 positional signature.\"\n      : `${reported.length} route handlers look like the v4 positional signature.`;\n\n  logger.warn({\n    module: \"router\",\n    action: \"handlerSignature\",\n    message:\n      `${headline} Warlock v5 calls every route handler with a single context object, ` +\n      `so a second parameter is always undefined and the request fails as soon as it is used:\\n` +\n      reported.map((suspect) => `  - ${describePositionalHandlerSuspect(suspect)}`).join(\"\\n\"),\n    context: { handlers: reported },\n  });\n\n  return reported;\n}\n"],"mappings":"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"}

package/esm/router/route-registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"route-registry.d.mts","names":[],"sources":["../../../../../../../core/src/router/route-registry.ts"],"mappings":";;;;;AAuBA;;cAAa,aAAA;EAAA,QACH,MAAA;;EAgDI;;;EAjCL,QAAA,CAAS,MAAA,EAAQ,KAAA;EAfhB;;;EAkCD,aAAA,CAAc,KAAA,EAAO,KAAA;EAnBZ;;;;EA8BT,IAAA,CACL,MAAA,UACA,GAAA;IACG,KAAA,EAAO,KAAA;IAAO,MAAA,EAAQ,MAAA;EAAA;EAAf;;;EAkBL,aAAA,CAAA;AAAA"}
+{"version":3,"file":"route-registry.d.mts","names":[],"sources":["../../../../../../../core/src/router/route-registry.ts"],"mappings":";;;;;AAuBA;;cAAa,aAAA;EAAA,QACH,MAAA;;EAgDI;;;EAjCL,QAAA,CAAS,MAAA,EAAQ,KAAA;EAfhB;;;EAkCD,aAAA,CAAc,KAAA,EAAO,KAAA;EAnBZ;;;;EA8BT,IAAA,CACL,MAAA,UACA,GAAA;IACG,KAAA,EAAO,KAAA;IAAO,MAAA,EAAQ,MAAA;EAAA;EAAf;;;EAkBL,aAAA;AAAA"}

package/esm/router/route-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"route-registry.mjs","names":[],"sources":["../../../../../../../core/src/router/route-registry.ts"],"sourcesContent":["import FindMyWay, { type HTTPMethod, type Instance } from \"find-my-way\";\nimport { normalizeRequestPath } from \"./normalize-request-path\";\nimport type { RequestMethod, Route } from \"./types\";\n\n/**\n * The concrete HTTP verbs an `all` route expands into.\n * Mirrors the set Fastify's `.all()` answers in production, so `router.any()`\n * routes behave identically under the dev server and prod Fastify.\n */\nconst ALL_METHODS: Exclude<RequestMethod, \"all\">[] = [\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"OPTIONS\",\n  \"HEAD\",\n];\n\n/**\n * Route Registry\n * Manages dynamic route matching using find-my-way for HMR support\n */\nexport class RouteRegistry {\n  private router: Instance<any>;\n\n  public constructor() {\n    this.router = FindMyWay({\n      // Request paths are normalized explicitly in `find`; leaving this off\n      // makes that shared normalizer, rather than a second router option, the\n      // reason development accepts a terminal slash.\n      ignoreTrailingSlash: false,\n      caseSensitive: false,\n    });\n  }\n\n  /**\n   * Register all routes from the router's internal list\n   */\n  public register(routes: Route[]): void {\n    // Register each route\n    for (const route of routes) {\n      if (route.method === \"all\") {\n        for (const method of ALL_METHODS) {\n          this.registerRoute({\n            ...route,\n            method,\n          });\n        }\n      } else {\n        this.registerRoute(route);\n      }\n    }\n  }\n\n  /**\n   * Register a single route\n   */\n  public registerRoute(route: Route): void {\n    this.router.on(route.method as HTTPMethod, route.path, (req, res, params) => {\n      // Store the route and params for later use\n      return { route, params };\n    });\n  }\n\n  /**\n   * Find a matching route for the given method and URL\n   * @returns Matched route with extracted params, or null if no match\n   */\n  public find(\n    method: string,\n    url: string,\n  ): { route: Route; params: Record<string, string> } | null {\n    // Strip query string from URL (find-my-way expects just the path)\n    const path = normalizeRequestPath(url.split(\"?\")[0]);\n\n    const match = this.router.find(method as HTTPMethod, path);\n\n    if (!match) {\n      return null;\n    }\n\n    // find-my-way handler expects (req, res, params, store, searchParams)\n    // We only care about the return value which contains { route, params }\n    return match.handler(null as any, null as any, match.params, match.store, {});\n  }\n\n  /**\n   * Get all registered routes count (for debugging)\n   */\n  public getRouteCount(): number {\n    return this.router\n      .prettyPrint()\n      .split(\"\\n\")\n      .filter((line) => line.trim()).length;\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,cAA+C;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;AAMA,IAAa,gBAAb,MAA2B;CAGzB,AAAO,cAAc;EACnB,KAAK,SAAS,UAAU;GAItB,qBAAqB;GACrB,eAAe;EACjB,CAAC;CACH;;;;CAKA,AAAO,SAAS,QAAuB;EAErC,KAAK,MAAM,SAAS,QAClB,IAAI,MAAM,WAAW,OACnB,KAAK,MAAM,UAAU,aACnB,KAAK,cAAc;GACjB,GAAG;GACH;EACF,CAAC;OAGH,KAAK,cAAc,KAAK;CAG9B;;;;CAKA,AAAO,cAAc,OAAoB;EACvC,KAAK,OAAO,GAAG,MAAM,QAAsB,MAAM,OAAO,KAAK,KAAK,WAAW;GAE3E,OAAO;IAAE;IAAO;GAAO;EACzB,CAAC;CACH;;;;;CAMA,AAAO,KACL,QACA,KACyD;EAEzD,MAAM,OAAO,qBAAqB,IAAI,MAAM,GAAG,EAAE,EAAE;EAEnD,MAAM,QAAQ,KAAK,OAAO,KAAK,QAAsB,IAAI;EAEzD,IAAI,CAAC,OACH,OAAO;EAKT,OAAO,MAAM,QAAQ,MAAa,MAAa,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC;CAC9E;;;;CAKA,AAAO,gBAAwB;EAC7B,OAAO,KAAK,OACT,YAAY,EACZ,MAAM,IAAI,EACV,QAAQ,SAAS,KAAK,KAAK,CAAC,EAAE;CACnC;AACF"}
+{"version":3,"file":"route-registry.mjs","names":[],"sources":["../../../../../../../core/src/router/route-registry.ts"],"sourcesContent":["import FindMyWay, { type HTTPMethod, type Instance } from \"find-my-way\";\nimport { normalizeRequestPath } from \"./normalize-request-path\";\nimport type { RequestMethod, Route } from \"./types\";\n\n/**\n * The concrete HTTP verbs an `all` route expands into.\n * Mirrors the set Fastify's `.all()` answers in production, so `router.any()`\n * routes behave identically under the dev server and prod Fastify.\n */\nconst ALL_METHODS: Exclude<RequestMethod, \"all\">[] = [\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"OPTIONS\",\n  \"HEAD\",\n];\n\n/**\n * Route Registry\n * Manages dynamic route matching using find-my-way for HMR support\n */\nexport class RouteRegistry {\n  private router: Instance<any>;\n\n  public constructor() {\n    this.router = FindMyWay({\n      // Request paths are normalized explicitly in `find`; leaving this off\n      // makes that shared normalizer, rather than a second router option, the\n      // reason development accepts a terminal slash.\n      ignoreTrailingSlash: false,\n      caseSensitive: false,\n    });\n  }\n\n  /**\n   * Register all routes from the router's internal list\n   */\n  public register(routes: Route[]): void {\n    // Register each route\n    for (const route of routes) {\n      if (route.method === \"all\") {\n        for (const method of ALL_METHODS) {\n          this.registerRoute({\n            ...route,\n            method,\n          });\n        }\n      } else {\n        this.registerRoute(route);\n      }\n    }\n  }\n\n  /**\n   * Register a single route\n   */\n  public registerRoute(route: Route): void {\n    this.router.on(route.method as HTTPMethod, route.path, (req, res, params) => {\n      // Store the route and params for later use\n      return { route, params };\n    });\n  }\n\n  /**\n   * Find a matching route for the given method and URL\n   * @returns Matched route with extracted params, or null if no match\n   */\n  public find(\n    method: string,\n    url: string,\n  ): { route: Route; params: Record<string, string> } | null {\n    // Strip query string from URL (find-my-way expects just the path)\n    const path = normalizeRequestPath(url.split(\"?\")[0]);\n\n    const match = this.router.find(method as HTTPMethod, path);\n\n    if (!match) {\n      return null;\n    }\n\n    // find-my-way handler expects (req, res, params, store, searchParams)\n    // We only care about the return value which contains { route, params }\n    return match.handler(null as any, null as any, match.params, match.store, {});\n  }\n\n  /**\n   * Get all registered routes count (for debugging)\n   */\n  public getRouteCount(): number {\n    return this.router\n      .prettyPrint()\n      .split(\"\\n\")\n      .filter((line) => line.trim()).length;\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAM,cAA+C;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;AAMA,IAAa,gBAAb,MAA2B;CAGzB,AAAO,cAAc;EACnB,KAAK,SAAS,UAAU;GAItB,qBAAqB;GACrB,eAAe;EACjB,CAAC;CACH;;;;CAKA,AAAO,SAAS,QAAuB;EAErC,KAAK,MAAM,SAAS,QAClB,IAAI,MAAM,WAAW,OACnB,KAAK,MAAM,UAAU,aACnB,KAAK,cAAc;GACjB,GAAG;GACH;EACF,CAAC;OAGH,KAAK,cAAc,KAAK;CAG9B;;;;CAKA,AAAO,cAAc,OAAoB;EACvC,KAAK,OAAO,GAAG,MAAM,QAAsB,MAAM,OAAO,KAAK,KAAK,WAAW;GAE3E,OAAO;IAAE;IAAO;GAAO;EACzB,CAAC;CACH;;;;;CAMA,AAAO,KACL,QACA,KACyD;EAEzD,MAAM,OAAO,qBAAqB,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE;EAEnD,MAAM,QAAQ,KAAK,OAAO,KAAK,QAAsB,IAAI;EAEzD,IAAI,CAAC,OACH,OAAO;EAKT,OAAO,MAAM,QAAQ,MAAa,MAAa,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC;CAC9E;;;;CAKA,AAAO,gBAAwB;EAC7B,OAAO,KAAK,OACT,YAAY,CAAC,CACb,MAAM,IAAI,CAAC,CACX,QAAQ,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC;CACnC;AACF"}

package/esm/router/router.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.mts","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"mappings":"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"}
+{"version":3,"file":"router.d.mts","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"mappings":";;;;;;;cA6Ha,MAAA;;AAAb;;UAIU,MAAA;EA8BqB;;;;;;;;EAAA,QApBrB,aAAA;EAiEgD;;;;EAAA,QA3DhD,2BAAA;EAiII;;;EAAA,eAxHG,QAAA;EAkJJ;;;EAAA,UA7ID,iBAAA,EAAmB,oBAAA;EAqQkC;;;EAAA,UAhQrD,cAAA,EAAgB,MAAA,WAAiB,MAAA,EAAQ,MAAA,EAAQ,MAAA,EAAQ,eAAA;EA8QJ;;;;EAAA,UAvQrD,MAAA,EAAQ,YAAA;EA4RiB;;;EAAA,OAnRrB,WAAA,IAAW,MAAA;EAAA,QAQlB,WAAA;EAyR8C;;;EAlR9C,cAAA,CAAe,QAAA,GAAW,MAAA,EAAQ,MAAA,EAAQ,MAAA,EAAQ,eAAA;EAqS5C;;;EA5RN,aAAA,CAAc,QAAA,GAAW,MAAA,EAAQ,MAAA,EAAQ,MAAA,EAAQ,eAAA;EA6R1C;;;EApRP,QAAA,CAAS,IAAA,UAAc,EAAA,UAAY,YAAA;EA2cxB;;;EAlcX,SAAA,CAAU,OAAA,EAAS,oBAAA;EAmcvB;;;EA1bI,IAAA,CAAK,IAAA,UAAc,QAAA,UAAkB,SAAA;EAufvB;;;EA9ed,UAAA,CAAW,IAAA,UAAc,QAAA,UAAkB,SAAA;EA4nB9B;;;EAnnBb,KAAA,CAAM,KAAA,EAAO,MAAA,kBAAwB,SAAA;EAxHpC;;;EAmID,WAAA,CAAY,KAAA,EAAO,MAAA,kBAAwB,SAAA;EArGxC;;;EAgHH,KAAA,CACL,IAAA,UACA,OAAA,UACA,OAAA,GAAU,IAAA,CAAK,uBAAA;EAEV,KAAA,CAAM,OAAA,EAAS,uBAAA;EAhHqB;;;EAoIpC,GAAA,CACL,MAAA,EAAQ,KAAA,YACR,IAAA,qBACA,OAAA,EAAS,kBAAA,EACT,OAAA,GAAS,YAAA;EAjIO;;;EAkPX,GAAA,CAAI,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA1NxD;;;EAiOA,GAAA,CAAI,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAjOd;;;EAwO1C,IAAA,CAAK,IAAA,qBAAyB,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA/N3C;;;EAsOzB,GAAA,CAAI,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA7NxD;;;EAoOA,MAAA,CAAO,IAAA,qBAAyB,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA3NtE;;;EAkOA,KAAA,CAAM,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAzNrD;;;EAgOL,IAAA,CAAK,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAvN9C;;;EA8NX,OAAA,CAAQ,IAAA,UAAc,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EArN/C;;;EA4Nb,KAAA,CAAM,IAAA,UAAc,OAAA,GAAS,YAAA,GAAiB,YAAA;EAjN3B;;;;;;;;;;EA+NnB,eAAA,CACL,IAAA,UACA,QAAA,EAAU,aAAA,EACV,OAAA,GAAS,YAAA;IACP,IAAA,GAAO,cAAA;IACP,MAAA,GAAS,cAAA;IACT,OAAA,GAAU,OAAA,CAAQ,MAAA,CAAO,cAAA,EAAgB,cAAA;MACvC,UAAA,GAAa,cAAA;IAAA;EAAA;EA/LjB;;;EAqSK,KAAA,CAAM,OAAA,EAAS,oBAAA,EAAsB,QAAA,EAAU,mBAAA;EAnL3C;;;EAuOJ,MAAA,CAAO,MAAA,UAAgB,QAAA;EAvOwB;;;;;;;;;;;;EAuP/C,OAAA,CAAQ,OAAA,mBAA0B,QAAA;EAlOlC;;;;;;EA4OM,cAAA,UACX,UAAA,UACA,QAAA,QAAgB,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC3B,OAAA,CAAQ,CAAA;EAxOG;;;;;EAyQP,wBAAA,CAAyB,UAAA;EAlQnB;;;;;;;;EA4RA,0BAAA,IACX,WAAA,EAAa,QAAA,UACb,OAAA,QAAe,CAAA,GAAI,OAAA,CAAQ,CAAA,IAC1B,OAAA,CAAQ,CAAA;EAxRqD;;;EAAA,QAsUxD,gBAAA;EA/T8B;;;EA2Y/B,IAAA,IAAI,KAAA;EApYJ;;;;;;;;EAgZA,UAAA;EA/XI;;;EAsYJ,IAAA,CAAK,MAAA,EAAQ,eAAA;EApYP;;;;EAibN,aAAA,CAAc,MAAA,EAAQ,eAAA;EAhbgB;;;EAuiBtC,QAAA,CAAS,IAAA,UAAc,MAAA;EAhcvB;;;EAAA,QAqdC,WAAA;AAAA;AAAA,cA4CG,MAAA,EAAM,MAAuB"}