@warlock.js/core 5.1.0 → 5.2.0

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  ResourceArraySchema,\r\n  ResourceFieldConfig,\r\n  ResourceOutputValueCastType,\r\n  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":";;;;;;;;;;AAeA,MAAM,iBAAiB;AAmGvB,IAAa,WAAb,MAAa,SAAqC;;gBAqBT,CAAC;;;sBAM0B,CAAC;;;;;;;CAOnE,OAAc,gBAAgB,QAA6D;EACzF,MAAM,SAA8C,CAAC;EAErD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,IAAI,UAAU,UAAU,UAAU,UAEhC,OAAO,OAAO;OACT,IAAI,OAA4B,KAAK,GAI1C,OAAO,OAAO;OACT,IAAI,OAAO,UAAU,UAC1B,OAAO,OAAO,qBAAqB,aAAa,KAAK;OAChD,IAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,KAAK,OAAO,MAAM,OAAO,UAAU;GACrF,MAAM,UAAU,qBAAqB,aAAa,MAAM,EAAY;GACpE,QAAQ,YAAY,MAAM,EAAE;GAC5B,OAAO,OAAO;EAChB,OACE,OAAO,OAAO;EAIlB,OAAO;CACT;;;;CAKA,AAAO,YAAY,AAAO,cAAgD;EAAhD;kBA3DO,CAAC;cAKL,CAAC;EAuD5B,IAAI,KAAK,wBAAwB,OAC/B,KAAK,WAAW,KAAK,aAAa;OAC7B,IAAI,KAAK,wBAAwB,UACtC,KAAK,WAAW,KAAK,aAAa;OAElC,KAAK,WAAW,KAAK;CAEzB;;;;CAKA,AAAO,SAAS;EACd,KAAK,KAAK;EACV,KAAK,gBAAgB;EACrB,KAAK,OAAO;EAEZ,OAAO,KAAK;CACd;;;;;CAMA,AAAU,OAAO,CAEjB;;;;;;CAOA,AAAU,kBAAkB;EAC1B,MAAM,aAAa,gBAAgB,CAAC,EAAE,SAAS;EAC/C,MAAM,eAAgB,KAAK,YAAgC;EAE3D,KAAK,MAAM,CAAC,WAAW,mBAAmB,OAAO,QAAQ,YAAY,GAAG;GACtE,MAAM,aAAa,KAAK,IAAI,SAAS;GACrC,MAAM,cAAc,KAAK,eAAe,YAAY,gBAAgB,UAAU;GAE9E,IAAI,gBAAgB,QAClB,KAAK,IAAI,WAAW,WAAW;EAEnC;CACF;;;;CAKA,AAAO,UAAU,OAAY,MAAmC,QAAiB;EAC/E,OAAO,IAAI,qBAAqB,IAAI,CAAC,CAAC,UAAU,OAAO,MAAM;CAC/D;;;;;CAMA,AAAU,eAAe,OAAY,gBAAqC,QAAsB;EAC9F,IAAI;EAEJ,IAAI,OAA4B,cAAc,GAI5C,OAAO,KAAK,eAAe,OAAO,eAAe,QAAQ,GAAG,MAAM;EAGpE,IAAI,mBAAmB,UAAU,mBAAmB,UAElD,cAAc,KAAK,uBAAuB,OAAO,mBAAmB,QAAQ;OACvE,IACL,OAAO,mBAAmB,cAC1B,eAAe,qBAAqB,UACpC;GACA,IAAI,CAAC,OAAO;GAEZ,IAAI,MAAM,QAAQ,KAAK,GAAG;IACxB,IAAI,MAAM,WAAW,GAAG;IACxB,cAAc,MACX,KAAK,SAAS,IAAK,eAAmC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CACrE,QAAQ,MAAM,MAAM,MAAS;GAClC,OACE,cAAc,IAAK,eAAmC,KAAK,CAAC,CAAC,OAAO;EAExE,OAAO,IAAI,OAAO,mBAAmB,YAEnC,cAAe,eAA4B,KAAK,MAAM,OAAO,IAAI;OAC5D,IAAI,0BAA0B,sBAAsB;GAEzD,MAAM,WAAW,eAAe,YAAY;GAC5C,cAAc,eAAe,UAAU,WAAW,KAAK,IAAI,QAAQ,IAAI,OAAO,MAAM;EACtF,OAAO,IACL,OAAO,mBAAmB,YAC1B,mBAAmB,QACnB,YAAY,kBACZ,eAAe,WAAW,WAG1B,IAAI,MAAM,QAAQ,KAAK,GACrB,cAAc,MACX,KAAK,SAAS,KAAK,mBAAmB,MAAM,eAAe,QAAQ,MAAM,CAAC,CAAC,CAC3E,QAAQ,MAAM,MAAM,MAAS;OAEhC,cAAc,KAAK,mBAAmB,OAAO,eAAe,QAAQ,MAAM;EAI9E,OAAO;CACT;;;;CAKA,AAAU,SAAS,CAEnB;;;;;;;;CASA,AAAU,uBAAuB,OAAY,SAAuB;EAClE,IAAI,SACF,OAAO,MAAM,QAAQ,KAAK,IACtB,MAAM,KAAK,SAAS,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,QAAQ,MAAM,MAAM,MAAS,IACzE;EAGN,OAAO,KAAK,YAAY,KAAK;CAC/B;;;;;CAMA,AAAU,YAAY,OAAiB;EACrC,IAAI,CAAC,OAAO,OAAO;EAEnB,MAAM,WAAW,MAAM,MAAM,MAAM,OAAO;EAC1C,MAAM,OAAO,KAAK,6BAAa,IAAI,IAAI;EAGvC,IAAI,KAAK,IAAI,QAAQ,KAAK,KAAK,QAAQ,gBACrC;EAGF,KAAK,IAAI,QAAQ;EAEjB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,QAAQ,IAAI,gBAAgB,KAAK;EACvC,MAAM,YAAY;EAElB,OAAO,MAAM,OAAO;CACtB;;;;CAKA,AAAU,mBACR,MACA,QACA,QACA;EACA,MAAM,kBAAiC,CAAC;EAExC,KAAK,MAAM,CAAC,WAAW,mBAAmB,OAAO,QAAQ,MAAM,GAAG;GAChE,IAAI,WAAW;GACf,IAAI,qBAAqB;GAEzB,IAAI,MAAM,QAAQ,cAAc,GAAG;IACjC,WAAW,eAAe;IAC1B,qBAAqB,eAAe;GACtC;GAEA,MAAM,aAAa,IAAI,MAAM,QAAQ;GACrC,MAAM,cAAc,KAAK,eAAe,YAAY,oBAAoB,MAAM;GAE9E,IAAI,gBAAgB,QAClB,IAAI,iBAAiB,WAAW,WAAW;EAE/C;EAEA,OAAO;CACT;;;;CAKA,AAAO,IAAI,KAAa,cAAoB;EAC1C,OAAO,IAAI,KAAK,UAAU,KAAK,YAAY;CAC7C;;;;CAKA,AAAO,IAAI,KAAa,OAA8B;EACpD,IAAI,KAAK,MAAM,KAAK,KAAK;EAEzB,OAAO;CACT;;;;CAKA,AAAO,QAAQ,QAAkE;EAC/E,OAAO;GACL,QAAQ;GACR;EACF;CACF;;;;CAKA,AAAO,OAAO,UAAmB;EAC/B,OAAO,KAAK,aAAa,UAAU,QAAQ;CAC7C;;;;CAKA,AAAO,KAAK,UAAmB;EAC7B,OAAO,KAAK,aAAa,QAAQ,QAAQ;CAC3C;;;;CAKA,AAAO,UAAU,UAAmB;EAClC,OAAO,KAAK,aAAa,aAAa,QAAQ;CAChD;;;;CAKA,AAAO,IAAI,UAAmB;EAC5B,OAAO,KAAK,aAAa,OAAO,QAAQ;CAC1C;;;;CAKA,AAAO,WAAW,UAAmB;EACnC,OAAO,KAAK,aAAa,cAAc,QAAQ;CACjD;;;;CAKA,AAAO,OAAO,UAAmB;EAC/B,OAAO,KAAK,aAAa,UAAU,QAAQ;CAC7C;;;;CAKA,AAAO,QAAQ,UAAmB;EAChC,OAAO,KAAK,aAAa,WAAW,QAAQ;CAC9C;;;;CAKA,AAAO,MAAM,UAAmB;EAC9B,OAAO,KAAK,aAAa,SAAS,QAAQ;CAC5C;;;;CAKA,AAAO,IAAI,UAAmB;EAC5B,OAAO,KAAK,aAAa,OAAO,QAAQ;CAC1C;;;;CAKA,AAAU,aAAa,MAAmC,UAAmB;EAC3E,MAAM,UAAU,IAAI,qBAAqB,IAAI;EAE7C,IAAI,UACF,QAAQ,YAAY,QAAQ;EAG9B,OAAO;CACT;AACF"}
+{"version":3,"file":"resource.mjs","names":[],"sources":["C:/Work/Warlock.js/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/resource/types.d.mts

@@ -3,7 +3,7 @@ import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
 import { ResourceConstructor, ResourceContract } from "./resource.mjs";
 import { Lazy } from "@mongez/reinforcements";
 
-//#region ../core/src/resource/types.d.ts
+//#region core/src/resource/types.d.ts
 type ResourceOutputValueCastType = "string" | "number" | "date" | "localized" | "boolean" | "url" | "float" | "int" | "object" | "array" | "uploadsUrl"
 /**
  * Storage url means the value will be generated using current storage.url method

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/resource/types.ts"],"mappings":";;;;;;KAKY,2BAAA;;;AAAZ;;;;AAAuC;AAsBvC;;KAAY,qBAAA;;AAAqB;AAQjC;;;;KAAY,gBAAA,GACR,2BAAA,MACG,2BAAA,UACA,2BAAA,SACA,2BAAA;AAAA,KAEK,mBAAA;EACV,MAAA;EACA,MAAA,EAAQ,MAAM,SAAS,mBAAA;AAAA;AAAA,KAGb,mBAAA,GACR,gBAAA,GACA,mBAAA,GACA,qBAAA,GACA,IAAA,CAAK,mBAAA,aACI,gBAAA,IACT,oBAAA,GACA,mBAAA,KACE,KAAA,OAAY,QAAA,EAAU,gBAAA;AAAA,KAEhB,cAAA,GAAiB,MAAM,SAAS,mBAAA;AAAA,KAEhC,qCAAA;EAnBL;;AAA2B;EAwB5B,MAAA;EAtByB;;;EA0BzB,SAAA;EAxBJ;;;EA4BI,SAAA;EA5BsC;AAG5C;;EA6BM,QAAA;EA5BF;;;EAgCE,MAAA;EA7BF;;;EAiCE,MAAA;EA7BsB;;;EAiCtB,GAAA;AAAA;;;;;;;KAcM,iBAAA,GACR,2BAAA,GACA,mBAAA,IACC,mBAAA;;;;AAlDuC;KAwDhC,cAAA,oBACK,cAAA;EACb,IAAA,EAAM,MAAA,SAAe,iBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/resource/types.ts"],"mappings":";;;;;;KAKY,2BAAA;;;AAAZ;;;;AAAuC;AAsBvC;;KAAY,qBAAA;;AAAqB;AAQjC;;;;KAAY,gBAAA,GACR,2BAAA,MACG,2BAAA,UACA,2BAAA,SACA,2BAAA;AAAA,KAEK,mBAAA;EACV,MAAA;EACA,MAAA,EAAQ,MAAM,SAAS,mBAAA;AAAA;AAAA,KAGb,mBAAA,GACR,gBAAA,GACA,mBAAA,GACA,qBAAA,GACA,IAAA,CAAK,mBAAA,aACI,gBAAA,IACT,oBAAA,GACA,mBAAA,KACE,KAAA,OAAY,QAAA,EAAU,gBAAA;AAAA,KAEhB,cAAA,GAAiB,MAAM,SAAS,mBAAA;AAAA,KAEhC,qCAAA;EAnBL;;AAA2B;EAwB5B,MAAA;EAtByB;;;EA0BzB,SAAA;EAxBJ;;;EA4BI,SAAA;EA5BsC;AAG5C;;EA6BM,QAAA;EA5BF;;;EAgCE,MAAA;EA7BF;;;EAiCE,MAAA;EA7BsB;;;EAiCtB,GAAA;AAAA;;;;;;;KAcM,iBAAA,GACR,2BAAA,GACA,mBAAA,IACC,mBAAA;;;;AAlDuC;KAwDhC,cAAA,oBACK,cAAA;EACb,IAAA,EAAM,MAAA,SAAe,iBAAA;AAAA"}

package/esm/restful/restful.d.mts

@@ -4,7 +4,7 @@ import { HttpContext, RestfulMiddleware, RouteResource } from "../router/types.m
 import { RepositoryManager } from "../repositories/repository.manager.mjs";
 import { Model } from "@warlock.js/cascade";
 
-//#region ../core/src/restful/restful.d.ts
+//#region core/src/restful/restful.d.ts
 declare abstract class Restful<T extends Model> implements RouteResource {
   /**
    * Middleware for each method

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;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"}
+{"version":3,"file":"restful.d.mts","names":[],"sources":["C:/Work/Warlock.js/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"}

package/esm/restful/restful.mjs

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/restful/restful.ts
+//#region core/src/restful/restful.ts
 var Restful = class {
 	constructor() {
 		this.middleware = {};

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":["C:/Work/Warlock.js/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/describe-route-for-log.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/router/describe-route-for-log.ts
+//#region core/src/router/describe-route-for-log.ts
 /**
 * The `[GET /products]` label that identifies a route in the request log.
 *

package/esm/router/describe-route-for-log.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"describe-route-for-log.mjs","names":[],"sources":["../../../../../../../core/src/router/describe-route-for-log.ts"],"sourcesContent":["/**\n * The `[GET /products]` label that identifies a route in the request log.\n *\n * A trailing `/*` is stripped because a prefixed route is more readable as the\n * prefix it serves — `/products/*` is `/products` to anyone reading a log.\n *\n * Two things the previous one-liner (`path.replace(\"/*\", \"\")`) got wrong:\n *\n * 1. The BARE catch-all `/*` became the empty string, so every unmatched\n *    request logged as `[GET ]`. The reader is looking for which route\n *    matched; a blank is the one answer that helps nobody.\n * 2. `replace` removes the FIRST occurrence wherever it sits, so a `/*` in the\n *    middle of a path would have been silently deleted from the label. Nothing\n *    declares such a route today — which is exactly why it would go unnoticed\n *    if something did.\n */\nexport function describeRouteForLog(method: string, path: string): string {\n  return `${method} ${stripTrailingWildcard(path)}`;\n}\n\nfunction stripTrailingWildcard(path: string): string {\n  if (!path.endsWith(\"/*\")) return path;\n\n  const withoutWildcard = path.slice(0, -\"/*\".length);\n\n  // `/*` alone leaves nothing behind. Show the route's own declared path\n  // instead of a blank.\n  return withoutWildcard.length > 0 ? withoutWildcard : path;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,oBAAoB,QAAgB,MAAsB;CACxE,OAAO,GAAG,OAAO,GAAG,sBAAsB,IAAI;AAChD;AAEA,SAAS,sBAAsB,MAAsB;CACnD,IAAI,CAAC,KAAK,SAAS,IAAI,GAAG,OAAO;CAEjC,MAAM,kBAAkB,KAAK,MAAM,GAAG,EAAY;CAIlD,OAAO,gBAAgB,SAAS,IAAI,kBAAkB;AACxD"}
+{"version":3,"file":"describe-route-for-log.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/router/describe-route-for-log.ts"],"sourcesContent":["/**\n * The `[GET /products]` label that identifies a route in the request log.\n *\n * A trailing `/*` is stripped because a prefixed route is more readable as the\n * prefix it serves — `/products/*` is `/products` to anyone reading a log.\n *\n * Two things the previous one-liner (`path.replace(\"/*\", \"\")`) got wrong:\n *\n * 1. The BARE catch-all `/*` became the empty string, so every unmatched\n *    request logged as `[GET ]`. The reader is looking for which route\n *    matched; a blank is the one answer that helps nobody.\n * 2. `replace` removes the FIRST occurrence wherever it sits, so a `/*` in the\n *    middle of a path would have been silently deleted from the label. Nothing\n *    declares such a route today — which is exactly why it would go unnoticed\n *    if something did.\n */\nexport function describeRouteForLog(method: string, path: string): string {\n  return `${method} ${stripTrailingWildcard(path)}`;\n}\n\nfunction stripTrailingWildcard(path: string): string {\n  if (!path.endsWith(\"/*\")) return path;\n\n  const withoutWildcard = path.slice(0, -\"/*\".length);\n\n  // `/*` alone leaves nothing behind. Show the route's own declared path\n  // instead of a blank.\n  return withoutWildcard.length > 0 ? withoutWildcard : path;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,oBAAoB,QAAgB,MAAsB;CACxE,OAAO,GAAG,OAAO,GAAG,sBAAsB,IAAI;AAChD;AAEA,SAAS,sBAAsB,MAAsB;CACnD,IAAI,CAAC,KAAK,SAAS,IAAI,GAAG,OAAO;CAEjC,MAAM,kBAAkB,KAAK,MAAM,GAAG,EAAY;CAIlD,OAAO,gBAAgB,SAAS,IAAI,kBAAkB;AACxD"}

package/esm/router/index.d.mts

@@ -1,4 +1,7 @@
+import { normalizeRoutePath } from "./normalize-route-path.mjs";
+import { normalizeRequestPath } from "./normalize-request-path.mjs";
 import { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks } from "./types.mjs";
 import { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
+import { matchesDerivedRouteName, routeNameMethodSuffix } from "./route-name-method-suffix.mjs";
 import { RouteRegistry } from "./route-registry.mjs";
 import { Router, router } from "./router.mjs";

package/esm/router/index.mjs

@@ -1,4 +1,7 @@
+import { normalizeRoutePath } from "./normalize-route-path.mjs";
+import { normalizeRequestPath } from "./normalize-request-path.mjs";
 import { clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
+import { matchesDerivedRouteName, routeNameMethodSuffix } from "./route-name-method-suffix.mjs";
 import { RouteRegistry } from "./route-registry.mjs";
 import { Router, router } from "./router.mjs";
 

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

@@ -1,4 +1,4 @@
-//#region ../core/src/router/log-request-lifecycle.ts
+//#region core/src/router/log-request-lifecycle.ts
 function levelForStatus(statusCode) {
 	if (statusCode === void 0) return "info";
 	if (statusCode >= 500) return "error";

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  context?: unknown;\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  context?: unknown;\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":";AA2DA,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"}
+{"version":3,"file":"log-request-lifecycle.mjs","names":[],"sources":["C:/Work/Warlock.js/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"}

package/esm/router/normalize-request-path.d.mts

@@ -0,0 +1,14 @@
+//#region core/src/router/normalize-request-path.d.ts
+/**
+ * Canonicalize an incoming request pathname before either router matches it.
+ *
+ * This is deliberately narrower than `normalizeRoutePath`, which joins route
+ * declarations and also resolves doubled slashes plus `.` / `..` segments.
+ * A request must keep those bytes unchanged; v5.2 only makes one terminal
+ * slash optional. The root path is already canonical and must never become an
+ * empty string.
+ */
+declare function normalizeRequestPath(pathname: string): string;
+//#endregion
+export { normalizeRequestPath };
+//# sourceMappingURL=normalize-request-path.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-request-path.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/router/normalize-request-path.ts"],"mappings":";;AASA;;;;AAAqD;;;;iBAArC,oBAAA,CAAqB,QAAgB"}

package/esm/router/normalize-request-path.mjs

@@ -0,0 +1,18 @@
+//#region core/src/router/normalize-request-path.ts
+/**
+* Canonicalize an incoming request pathname before either router matches it.
+*
+* This is deliberately narrower than `normalizeRoutePath`, which joins route
+* declarations and also resolves doubled slashes plus `.` / `..` segments.
+* A request must keep those bytes unchanged; v5.2 only makes one terminal
+* slash optional. The root path is already canonical and must never become an
+* empty string.
+*/
+function normalizeRequestPath(pathname) {
+	if (pathname === "" || pathname === "/") return "/";
+	return pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+}
+
+//#endregion
+export { normalizeRequestPath };
+//# sourceMappingURL=normalize-request-path.mjs.map

package/esm/router/normalize-request-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-request-path.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/router/normalize-request-path.ts"],"sourcesContent":["/**\n * Canonicalize an incoming request pathname before either router matches it.\n *\n * This is deliberately narrower than `normalizeRoutePath`, which joins route\n * declarations and also resolves doubled slashes plus `.` / `..` segments.\n * A request must keep those bytes unchanged; v5.2 only makes one terminal\n * slash optional. The root path is already canonical and must never become an\n * empty string.\n */\nexport function normalizeRequestPath(pathname: string): string {\n  if (pathname === \"\" || pathname === \"/\") return \"/\";\n  return pathname.endsWith(\"/\") ? pathname.slice(0, -1) : pathname;\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,qBAAqB,UAA0B;CAC7D,IAAI,aAAa,MAAM,aAAa,KAAK,OAAO;CAChD,OAAO,SAAS,SAAS,GAAG,IAAI,SAAS,MAAM,GAAG,EAAE,IAAI;AAC1D"}

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

@@ -0,0 +1,28 @@
+//#region core/src/router/normalize-route-path.d.ts
+/**
+ * Normalize route path segments into the canonical path the router serves.
+ *
+ * This is the ONE definition of a route path's canonical form. `Router.add`
+ * calls it to join a group prefix onto a route path, and that call is the only
+ * reason a bare `"*"` (the not-found catch-all) is registered — and therefore
+ * matched, listed and diffed — as `"/*"`.
+ *
+ * Anything that PREDICTS or RECORDS a route path outside registration has to
+ * call this same function. The build-time page-route manifest is the case that
+ * forced it into existence: it is derived from a filesystem scan that never
+ * registers a route, so before it normalized here it persisted `"*"` while the
+ * running router held `"/*"`, and `warlock routes:diff` reported a route as
+ * changed immediately after a successful build.
+ *
+ * Keeping one implementation is what lets the diff stay a STRICT string
+ * comparison instead of teaching every consumer which spellings are secretly
+ * equivalent.
+ *
+ * @example normalizeRoutePath("*") // "/*"
+ * @example normalizeRoutePath("/users/", "/:id") // "/users/:id"
+ * @example normalizeRoutePath("") // "/"
+ */
+declare function normalizeRoutePath(...segments: string[]): string;
+//#endregion
+export { normalizeRoutePath };
+//# sourceMappingURL=normalize-route-path.d.mts.map

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

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

package/esm/router/normalize-route-path.mjs

@@ -0,0 +1,33 @@
+import concatRoute from "@mongez/concat-route";
+
+//#region core/src/router/normalize-route-path.ts
+/**
+* Normalize route path segments into the canonical path the router serves.
+*
+* This is the ONE definition of a route path's canonical form. `Router.add`
+* calls it to join a group prefix onto a route path, and that call is the only
+* reason a bare `"*"` (the not-found catch-all) is registered — and therefore
+* matched, listed and diffed — as `"/*"`.
+*
+* Anything that PREDICTS or RECORDS a route path outside registration has to
+* call this same function. The build-time page-route manifest is the case that
+* forced it into existence: it is derived from a filesystem scan that never
+* registers a route, so before it normalized here it persisted `"*"` while the
+* running router held `"/*"`, and `warlock routes:diff` reported a route as
+* changed immediately after a successful build.
+*
+* Keeping one implementation is what lets the diff stay a STRICT string
+* comparison instead of teaching every consumer which spellings are secretly
+* equivalent.
+*
+* @example normalizeRoutePath("*") // "/*"
+* @example normalizeRoutePath("/users/", "/:id") // "/users/:id"
+* @example normalizeRoutePath("") // "/"
+*/
+function normalizeRoutePath(...segments) {
+	return concatRoute(...segments);
+}
+
+//#endregion
+export { normalizeRoutePath };
+//# sourceMappingURL=normalize-route-path.mjs.map

package/esm/router/normalize-route-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-path.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/router/normalize-route-path.ts"],"sourcesContent":["import concatRoute from \"@mongez/concat-route\";\n\n/**\n * Normalize route path segments into the canonical path the router serves.\n *\n * This is the ONE definition of a route path's canonical form. `Router.add`\n * calls it to join a group prefix onto a route path, and that call is the only\n * reason a bare `\"*\"` (the not-found catch-all) is registered — and therefore\n * matched, listed and diffed — as `\"/*\"`.\n *\n * Anything that PREDICTS or RECORDS a route path outside registration has to\n * call this same function. The build-time page-route manifest is the case that\n * forced it into existence: it is derived from a filesystem scan that never\n * registers a route, so before it normalized here it persisted `\"*\"` while the\n * running router held `\"/*\"`, and `warlock routes:diff` reported a route as\n * changed immediately after a successful build.\n *\n * Keeping one implementation is what lets the diff stay a STRICT string\n * comparison instead of teaching every consumer which spellings are secretly\n * equivalent.\n *\n * @example normalizeRoutePath(\"*\") // \"/*\"\n * @example normalizeRoutePath(\"/users/\", \"/:id\") // \"/users/:id\"\n * @example normalizeRoutePath(\"\") // \"/\"\n */\nexport function normalizeRoutePath(...segments: string[]): string {\n  return concatRoute(...segments);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,mBAAmB,GAAG,UAA4B;CAChE,OAAO,YAAY,GAAG,QAAQ;AAChC"}

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

@@ -1,7 +1,7 @@
 import { Route } from "./types.mjs";
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/router/positional-handler-diagnostics.d.ts
+//#region core/src/router/positional-handler-diagnostics.d.ts
 /**
  * One route whose handler looks like it was written for v4.
  */

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,aAA0C,wBAAwB;;;;;;iBASlE,+BAAA,CAAgC,UAAkB;;;;;iBAYlD,8BAAA;;;;;;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":["C:/Work/Warlock.js/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"}

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

@@ -1,6 +1,6 @@
 import { log } from "@warlock.js/logger";
 
-//#region ../core/src/router/positional-handler-diagnostics.ts
+//#region core/src/router/positional-handler-diagnostics.ts
 /**
 * Early detection of route handlers still written against the **v4 positional
 * signature** — `(request, response)` — after v5 moved to a single context

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":["C:/Work/Warlock.js/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-builder.d.mts

@@ -1,7 +1,7 @@
 import { RequestHandlerType, RouteOptions } from "./types.mjs";
 import { Router } from "./router.mjs";
 
-//#region ../core/src/router/route-builder.d.ts
+//#region core/src/router/route-builder.d.ts
 declare class RouteBuilder {
   private readonly router;
   private readonly path;

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

@@ -1 +1 @@
-{"version":3,"file":"route-builder.d.mts","names":[],"sources":["../../../../../../../core/src/router/route-builder.ts"],"mappings":";;;;cAIa,YAAA;EAAA,iBAYQ,MAAA;EAAA,iBACA,IAAA;EAAA,iBACA,WAAA;EAAA,UAbT,WAAA;;;;;;;;;cAWS,MAAA,EAAQ,MAAA,EACR,IAAA,UACA,WAAA,GAAa,YAAA;EA4CqB;;;EApC9C,GAAA,CAAI,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAyDM;;;;EA3ChD,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAwE7B;;;EAhEhB,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA0F7B;;;;EA5Ed,OAAA,CAAQ,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA4FH;;;EApF3C,GAAA,CAAI,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAoGI;;;EAvF9C,SAAA,CAAU,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA8H1C;;;EAtHN,KAAA,CAAM,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA0HvC;;;EA7GL,QAAA,CAAS,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA6HN;;;EArHzC,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA9FjC;;;EA2GZ,SAAA,CAAU,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;;;;;EAahD,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;;;;;EAQ3C,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAhIjC;;;;EAwIZ,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAhIV;;;;EAwIjC,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA1HT;;;;EAkIpC,OAAA,CAAQ,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA1HZ;;;;;;;;;;EA4IlC,IAAA,CAAK,IAAA,UAAc,OAAA,GAAS,YAAA,GAAoB,YAAA;EAzGhD;;;;;;;;;;;;EA2HA,IAAA,CACL,QAAA;IACE,IAAA,GAAO,kBAAA;IACP,MAAA,GAAS,kBAAA;IACT,IAAA,GAAO,kBAAA;IACP,MAAA,GAAS,kBAAA;IACT,OAAA,GAAU,kBAAA;IACV,KAAA,GAAQ,kBAAA;EAAA,GAEV,OAAA,GAAS,YAAA;EA1FJ;;;EAAA,UAwGG,WAAA,CAAY,OAAA,GAAS,YAAA,GAAiB,YAAA;AAAA"}
+{"version":3,"file":"route-builder.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/router/route-builder.ts"],"mappings":";;;;cAIa,YAAA;EAAA,iBAYQ,MAAA;EAAA,iBACA,IAAA;EAAA,iBACA,WAAA;EAAA,UAbT,WAAA;;;;;;;;;cAWS,MAAA,EAAQ,MAAA,EACR,IAAA,UACA,WAAA,GAAa,YAAA;EA4CqB;;;EApC9C,GAAA,CAAI,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAyDM;;;;EA3ChD,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAwE7B;;;EAhEhB,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA0F7B;;;;EA5Ed,OAAA,CAAQ,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA4FH;;;EApF3C,GAAA,CAAI,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAoGI;;;EAvF9C,SAAA,CAAU,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA8H1C;;;EAtHN,KAAA,CAAM,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA0HvC;;;EA7GL,QAAA,CAAS,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA6HN;;;EArHzC,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA9FjC;;;EA2GZ,SAAA,CAAU,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;;;;;EAahD,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;;;;;EAQ3C,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAhIjC;;;;EAwIZ,IAAA,CAAK,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EAhIV;;;;EAwIjC,MAAA,CAAO,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA1HT;;;;EAkIpC,OAAA,CAAQ,OAAA,EAAS,kBAAA,EAAoB,OAAA,GAAS,YAAA;EA1HZ;;;;;;;;;;EA4IlC,IAAA,CAAK,IAAA,UAAc,OAAA,GAAS,YAAA,GAAoB,YAAA;EAzGhD;;;;;;;;;;;;EA2HA,IAAA,CACL,QAAA;IACE,IAAA,GAAO,kBAAA;IACP,MAAA,GAAS,kBAAA;IACT,IAAA,GAAO,kBAAA;IACP,MAAA,GAAS,kBAAA;IACT,OAAA,GAAU,kBAAA;IACV,KAAA,GAAQ,kBAAA;EAAA,GAEV,OAAA,GAAS,YAAA;EA1FJ;;;EAAA,UAwGG,WAAA,CAAY,OAAA,GAAS,YAAA,GAAiB,YAAA;AAAA"}

package/esm/router/route-builder.mjs

@@ -1,6 +1,6 @@
 import { merge } from "@mongez/reinforcements";
 
-//#region ../core/src/router/route-builder.ts
+//#region core/src/router/route-builder.ts
 var RouteBuilder = class RouteBuilder {
 	constructor(router, path, moreOptions = {}) {
 		this.router = router;

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

@@ -1 +1 @@
-{"version":3,"file":"route-builder.mjs","names":[],"sources":["../../../../../../../core/src/router/route-builder.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { type Router } from \"./router\";\nimport type { RequestHandlerType, RouteOptions } from \"./types\";\n\nexport class RouteBuilder {\n  protected addedRoutes = {\n    get: false,\n    post: false,\n    put: false,\n    delete: false,\n    patch: false,\n    options: false,\n    head: false,\n  };\n\n  public constructor(\n    private readonly router: Router,\n    private readonly path: string,\n    private readonly moreOptions: RouteOptions = {},\n  ) {\n    //\n  }\n\n  /**\n   * Add a get method to the route\n   */\n  public get(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.get) {\n      throw new Error(`Route ${this.path} already has a GET method`);\n    }\n\n    this.addedRoutes.get = true;\n    this.router.get(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Get one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public getOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.get(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a post method to the route\n   */\n  public post(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.post) {\n      throw new Error(`Route ${this.path} already has a POST method`);\n    }\n\n    this.addedRoutes.post = true;\n    this.router.post(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Post one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public postOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.post(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PUT request handler for current path\n   */\n  public put(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.put) {\n      throw new Error(`Route ${this.path} already has a PUT method`);\n    }\n\n    this.addedRoutes.put = true;\n    this.router.put(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Update one resource, appends /:id to the path\n   */\n  public updateOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.put(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PATCH request handler for current path\n   */\n  public patch(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.patch) {\n      throw new Error(`Route ${this.path} already has a PATCH method`);\n    }\n\n    this.addedRoutes.patch = true;\n    this.router.patch(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Patch one resource, appends /:id to the path\n   */\n  public patchOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.patch(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a DELETE request handler for current path\n   */\n  public delete(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.delete) {\n      throw new Error(`Route ${this.path} already has a DELETE method`);\n    }\n\n    this.addedRoutes.delete = true;\n    this.router.delete(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Delete one resource, appends /:id to the path\n   */\n  public deleteOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.delete(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  // ============================================================================\n  // RESTful Semantic Aliases\n  // ============================================================================\n\n  /**\n   * List all resources (RESTful alias for GET collection)\n   * @example router.route(\"/posts\").list(listPosts)\n   */\n  public list(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.get(handler, options);\n  }\n\n  /**\n   * Create a new resource (RESTful alias for POST)\n   * @example router.route(\"/posts\").create(createPost)\n   */\n  public create(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.post(handler, options);\n  }\n\n  /**\n   * Show a single resource (RESTful alias for GET one)\n   * @example router.route(\"/posts\").show(showPost) // GET /posts/:id\n   */\n  public show(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.getOne(handler, options);\n  }\n\n  /**\n   * Update a resource (RESTful alias for PUT one)\n   * @example router.route(\"/posts\").update(updatePost) // PUT /posts/:id\n   */\n  public update(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.updateOne(handler, options);\n  }\n\n  /**\n   * Destroy a resource (RESTful alias for DELETE one)\n   * @example router.route(\"/posts\").destroy(deletePost) // DELETE /posts/:id\n   */\n  public destroy(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.deleteOne(handler, options);\n  }\n\n  // ============================================================================\n  // Route Nesting\n  // ============================================================================\n\n  /**\n   * Create a nested route builder\n   * Useful for building nested resources like /posts/:id/comments\n   * @example\n   * router.route(\"/posts/:id\")\n   *   .getOne(showPost)\n   *   .nest(\"/comments\")\n   *     .list(listComments)      // GET /posts/:id/comments\n   *     .create(createComment);  // POST /posts/:id/comments\n   */\n  public nest(path: string, options: RouteOptions = {}): RouteBuilder {\n    const nestedPath = `${this.path}${path}`;\n    const mergedOptions = this.withOptions(options);\n    return new RouteBuilder(this.router, nestedPath, mergedOptions);\n  }\n\n  /**\n   * Set up common RESTful CRUD routes in one call\n   * @example\n   * router.route(\"/posts\").crud({\n   *   list: listPosts,        // GET /posts\n   *   create: createPost,     // POST /posts\n   *   show: showPost,         // GET /posts/:id\n   *   update: updatePost,     // PUT /posts/:id\n   *   destroy: deletePost,    // DELETE /posts/:id\n   *   patch: patchPost,       // PATCH /posts/:id\n   * });\n   */\n  public crud(\n    handlers: {\n      list?: RequestHandlerType;\n      create?: RequestHandlerType;\n      show?: RequestHandlerType;\n      update?: RequestHandlerType;\n      destroy?: RequestHandlerType;\n      patch?: RequestHandlerType;\n    },\n    options: RouteOptions = {},\n  ) {\n    if (handlers.list) this.get(handlers.list, options);\n    if (handlers.create) this.post(handlers.create, options);\n    if (handlers.show) this.getOne(handlers.show, options);\n    if (handlers.update) this.updateOne(handlers.update, options);\n    if (handlers.destroy) this.deleteOne(handlers.destroy, options);\n    if (handlers.patch) this.patchOne(handlers.patch, options);\n    return this;\n  }\n\n  /**\n   * Merge options with moreOptions\n   */\n  protected withOptions(options: RouteOptions = {}) {\n    return merge(this.moreOptions, options);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"route-builder.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/router/route-builder.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { type Router } from \"./router\";\nimport type { RequestHandlerType, RouteOptions } from \"./types\";\n\nexport class RouteBuilder {\n  protected addedRoutes = {\n    get: false,\n    post: false,\n    put: false,\n    delete: false,\n    patch: false,\n    options: false,\n    head: false,\n  };\n\n  public constructor(\n    private readonly router: Router,\n    private readonly path: string,\n    private readonly moreOptions: RouteOptions = {},\n  ) {\n    //\n  }\n\n  /**\n   * Add a get method to the route\n   */\n  public get(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.get) {\n      throw new Error(`Route ${this.path} already has a GET method`);\n    }\n\n    this.addedRoutes.get = true;\n    this.router.get(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Get one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public getOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.get(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a post method to the route\n   */\n  public post(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.post) {\n      throw new Error(`Route ${this.path} already has a POST method`);\n    }\n\n    this.addedRoutes.post = true;\n    this.router.post(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Post one resource, appends /:id to the path\n   * For example: /posts/:id\n   */\n  public postOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.post(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PUT request handler for current path\n   */\n  public put(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.put) {\n      throw new Error(`Route ${this.path} already has a PUT method`);\n    }\n\n    this.addedRoutes.put = true;\n    this.router.put(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Update one resource, appends /:id to the path\n   */\n  public updateOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.put(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a PATCH request handler for current path\n   */\n  public patch(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.patch) {\n      throw new Error(`Route ${this.path} already has a PATCH method`);\n    }\n\n    this.addedRoutes.patch = true;\n    this.router.patch(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Patch one resource, appends /:id to the path\n   */\n  public patchOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.patch(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Add a DELETE request handler for current path\n   */\n  public delete(handler: RequestHandlerType, options: RouteOptions = {}) {\n    if (this.addedRoutes.delete) {\n      throw new Error(`Route ${this.path} already has a DELETE method`);\n    }\n\n    this.addedRoutes.delete = true;\n    this.router.delete(this.path, handler, this.withOptions(options));\n    return this;\n  }\n\n  /**\n   * Delete one resource, appends /:id to the path\n   */\n  public deleteOne(handler: RequestHandlerType, options: RouteOptions = {}) {\n    this.router.delete(`${this.path}/:id`, handler, this.withOptions(options));\n    return this;\n  }\n\n  // ============================================================================\n  // RESTful Semantic Aliases\n  // ============================================================================\n\n  /**\n   * List all resources (RESTful alias for GET collection)\n   * @example router.route(\"/posts\").list(listPosts)\n   */\n  public list(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.get(handler, options);\n  }\n\n  /**\n   * Create a new resource (RESTful alias for POST)\n   * @example router.route(\"/posts\").create(createPost)\n   */\n  public create(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.post(handler, options);\n  }\n\n  /**\n   * Show a single resource (RESTful alias for GET one)\n   * @example router.route(\"/posts\").show(showPost) // GET /posts/:id\n   */\n  public show(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.getOne(handler, options);\n  }\n\n  /**\n   * Update a resource (RESTful alias for PUT one)\n   * @example router.route(\"/posts\").update(updatePost) // PUT /posts/:id\n   */\n  public update(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.updateOne(handler, options);\n  }\n\n  /**\n   * Destroy a resource (RESTful alias for DELETE one)\n   * @example router.route(\"/posts\").destroy(deletePost) // DELETE /posts/:id\n   */\n  public destroy(handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.deleteOne(handler, options);\n  }\n\n  // ============================================================================\n  // Route Nesting\n  // ============================================================================\n\n  /**\n   * Create a nested route builder\n   * Useful for building nested resources like /posts/:id/comments\n   * @example\n   * router.route(\"/posts/:id\")\n   *   .getOne(showPost)\n   *   .nest(\"/comments\")\n   *     .list(listComments)      // GET /posts/:id/comments\n   *     .create(createComment);  // POST /posts/:id/comments\n   */\n  public nest(path: string, options: RouteOptions = {}): RouteBuilder {\n    const nestedPath = `${this.path}${path}`;\n    const mergedOptions = this.withOptions(options);\n    return new RouteBuilder(this.router, nestedPath, mergedOptions);\n  }\n\n  /**\n   * Set up common RESTful CRUD routes in one call\n   * @example\n   * router.route(\"/posts\").crud({\n   *   list: listPosts,        // GET /posts\n   *   create: createPost,     // POST /posts\n   *   show: showPost,         // GET /posts/:id\n   *   update: updatePost,     // PUT /posts/:id\n   *   destroy: deletePost,    // DELETE /posts/:id\n   *   patch: patchPost,       // PATCH /posts/:id\n   * });\n   */\n  public crud(\n    handlers: {\n      list?: RequestHandlerType;\n      create?: RequestHandlerType;\n      show?: RequestHandlerType;\n      update?: RequestHandlerType;\n      destroy?: RequestHandlerType;\n      patch?: RequestHandlerType;\n    },\n    options: RouteOptions = {},\n  ) {\n    if (handlers.list) this.get(handlers.list, options);\n    if (handlers.create) this.post(handlers.create, options);\n    if (handlers.show) this.getOne(handlers.show, options);\n    if (handlers.update) this.updateOne(handlers.update, options);\n    if (handlers.destroy) this.deleteOne(handlers.destroy, options);\n    if (handlers.patch) this.patchOne(handlers.patch, options);\n    return this;\n  }\n\n  /**\n   * Merge options with moreOptions\n   */\n  protected withOptions(options: RouteOptions = {}) {\n    return merge(this.moreOptions, options);\n  }\n}\n"],"mappings":"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"}