@warlock.js/core 5.31.0 → 5.32.0

package/esm/resource/resource.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resource.mjs","names":[],"sources":["../../../../../../../../packages/core/src/resource/resource.ts"],"sourcesContent":["import { get, isLazy, set, type GenericObject } from \"@mongez/reinforcements\";\nimport { Model } from \"@warlock.js/cascade\";\nimport { useRequestStore } from \"../http/context/request-context\";\nimport { isNullableResource } from \"./nullable-resource\";\nimport { ResourceFieldBuilder } from \"./resource-field-builder\";\nimport {\n  type ResourceArraySchema,\n  type ResourceFieldConfig,\n  type ResourceOutputValueCastType,\n} from \"./types\";\n\n/**\n * Maximum recursion depth for self-referencing fields.\n * Prevents runaway serialization on deep trees or circular data.\n */\nconst MAX_SELF_DEPTH = 10;\n\n/**\n * Whether the given schema entry is an `arrayOf` item schema\n */\nfunction isArrayOfSchema(value: unknown): value is ResourceArraySchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    (value as { __type?: unknown }).__type === \"arrayOf\" &&\n    typeof (value as { schema?: unknown }).schema === \"object\" &&\n    (value as { schema?: unknown }).schema !== null\n  );\n}\n\n/**\n * Resource contract\n */\nexport interface ResourceContract<Out = GenericObject> {\n  /**\n   * Resource data\n   */\n  resource: GenericObject;\n\n  /**\n   * Resource final output\n   */\n  data: GenericObject;\n\n  /**\n   * Original data\n   */\n  originalData: GenericObject;\n\n  /**\n   * Convert resource to JSON\n   */\n  toJSON(): Out;\n\n  /**\n   * Transform the given value with given type\n   */\n  transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;\n\n  /**\n   * Get a input value for the given key\n   */\n  get(key: string, defaultValue?: any): any;\n\n  /**\n   * Set the given value for the given field\n   */\n  set(key: string, value: any): ResourceContract;\n\n  /**\n   * Create an array schema for transforming array items\n   */\n  arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;\n\n  /**\n   * Get a string field builder\n   */\n  string(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a date field builder\n   */\n  date(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a localized field builder\n   */\n  localized(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a url field builder\n   */\n  url(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a uploadsUrl field builder\n   */\n  uploadsUrl(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a number field builder\n   */\n  number(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a boolean field builder\n   */\n  boolean(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a float field builder\n   */\n  float(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a int field builder\n   */\n  int(inputKey?: string): ResourceFieldBuilder;\n}\n\n/**\n * Resource constructor\n */\nexport interface ResourceConstructor<Out = GenericObject> {\n  new (originalData: GenericObject | Resource | Model): ResourceContract<Out>;\n}\n\nexport class Resource implements ResourceContract {\n  /**\n   * Resource data\n   */\n  public resource: GenericObject = {};\n\n  /**\n   * Resource final output\n   */\n  public data: GenericObject = {};\n\n  /**\n   * Tracks visited object identities during self-reference recursion.\n   * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).\n   */\n  protected _selfSeen?: Set<unknown>;\n\n  /**\n   * Raw resource schema — field declarations as written by the developer.\n   * Used by doc generators for introspection.\n   */\n  public static schema: Record<string, ResourceFieldConfig | string> = {};\n\n  /**\n   * Normalized schema — all string cast types and tuples converted to\n   * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.\n   */\n  public static parsedSchema: Record<string, ResourceFieldConfig> = {};\n\n  /**\n   * Normalize a raw schema into parsedSchema.\n   * Converts string cast types (including suffixes) and tuples into pre-built builders.\n   * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.\n   */\n  public static normalizeSchema(\n    schema: Record<string, ResourceFieldConfig | string>,\n  ): Record<string, ResourceFieldConfig> {\n    const parsed: Record<string, ResourceFieldConfig> = {};\n\n    for (const [key, value] of Object.entries(schema)) {\n      if (value === \"self\" || value === \"self[]\") {\n        // Keep self-references as-is — resolved lazily in transformValue\n        parsed[key] = value;\n      } else if (isLazy<ResourceConstructor>(value)) {\n        // Keep Lazy<ResourceConstructor> as-is — resolved at transform\n        // time so cyclic resource refs (A embeds B embeds A) compose\n        // without import-graph cycles.\n        parsed[key] = value;\n      } else if (typeof value === \"string\") {\n        parsed[key] = ResourceFieldBuilder.fromCastType(value);\n      } else if (\n        Array.isArray(value) &&\n        value.length === 2 &&\n        typeof value[0] === \"string\" &&\n        typeof value[1] === \"string\"\n      ) {\n        const builder = ResourceFieldBuilder.fromCastType(value[1]);\n        builder.setInputKey(value[0]);\n        parsed[key] = builder;\n      } else if (isArrayOfSchema(value)) {\n        // arrayOf item schemas follow the same rules as the top level: cast\n        // strings and tuples become builders (nested arrayOf recurses).\n        parsed[key] = { ...value, schema: Resource.normalizeSchema(value.schema) };\n      } else {\n        parsed[key] = value;\n      }\n    }\n\n    return parsed;\n  }\n\n  /**\n   * Constructor\n   */\n  public constructor(public originalData: GenericObject | Resource | Model) {\n    if (this.originalData instanceof Model) {\n      this.resource = this.originalData.data;\n    } else if (this.originalData instanceof Resource) {\n      this.resource = this.originalData.data;\n    } else {\n      this.resource = this.originalData;\n    }\n  }\n\n  /**\n   * Convert resource to JSON\n   */\n  public toJSON() {\n    this.boot();\n    this.transformOutput();\n    this.extend();\n\n    return this.data;\n  }\n\n  /**\n   * Boot method\n   * Called before transforming the resource\n   */\n  protected boot() {\n    //\n  }\n\n  /**\n   * Transform resource to output using the pre-normalized parsedSchema.\n   * Builders handle their own array/nullable logic internally.\n   * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.\n   */\n  protected transformOutput() {\n    const localeCode = useRequestStore()?.request?.locale;\n    const parsedSchema = this.resolveParsedSchema();\n    // A model is read through its accessors; anything else through the\n    // constructor's normalized input (a wrapped resource's serialized data).\n    const source = this.originalData instanceof Model ? this.originalData : this.resource;\n\n    for (const [outputKey, outputSettings] of Object.entries(parsedSchema)) {\n      const inputKey =\n        outputSettings instanceof ResourceFieldBuilder ? outputSettings.getInputKey() : undefined;\n      const inputValue = this.resolveSourceValue(source, outputKey, inputKey);\n      const outputValue = this.transformValue(inputValue, outputSettings, localeCode);\n\n      if (outputValue !== undefined) {\n        this.set(outputKey, outputValue);\n      }\n    }\n  }\n\n  /**\n   * Resolve the normalized schema of THIS class.\n   * `@RegisterResource()` is optional: when the class has no own `parsedSchema`\n   * (a static field is inherited from the base as `{}`), normalize its own\n   * static `schema` (or an instance `schema` field) once and cache it on the class.\n   */\n  protected resolveParsedSchema(): Record<string, ResourceFieldConfig> {\n    const ctor = this.constructor as typeof Resource;\n\n    if (Object.hasOwn(ctor, \"parsedSchema\")) {\n      return ctor.parsedSchema;\n    }\n\n    const instanceSchema = (\n      this as unknown as { schema?: Record<string, ResourceFieldConfig | string> }\n    ).schema;\n    const schema = instanceSchema ?? ctor.schema;\n\n    if (!schema || Object.keys(schema).length === 0) {\n      throw new Error(\n        `Resource \"${ctor.name}\" has no schema. Declare \\`static schema = { ... }\\` on the class.`,\n      );\n    }\n\n    const parsed = Resource.normalizeSchema(schema);\n\n    // Instance schemas are per-class by convention, so caching on the class is safe\n    ctor.parsedSchema = parsed;\n\n    return parsed;\n  }\n\n  /**\n   * Transform the given value with given type\n   */\n  public transform(value: any, type: ResourceOutputValueCastType, locale?: string) {\n    return new ResourceFieldBuilder(type).transform(value, locale);\n  }\n\n  /**\n   * Transform the given value for the given output setting.\n   * After normalization, string cast types no longer reach here — they are pre-converted to builders.\n   */\n  protected transformValue(value: any, outputSettings: ResourceFieldConfig, locale?: string): any {\n    let outputValue: any;\n\n    if (isLazy<ResourceConstructor>(outputSettings)) {\n      // Resolve the lazy ref now (cyclic resource imports are fully loaded\n      // by serialization time) and recurse — the resolved constructor is\n      // handled by the ResourceConstructor branch below.\n      return this.transformValue(value, outputSettings.resolve(), locale);\n    }\n\n    if (isNullableResource(outputSettings)) {\n      // nullable(Resource) — always present: null for a missing input, the resource output otherwise\n      if (value === null || value === undefined) return null;\n\n      return this.transformValue(value, outputSettings.resource, locale) ?? null;\n    }\n\n    if (Array.isArray(outputSettings) && outputSettings.length === 1) {\n      // [Resource] — a list field. [] stays [], a missing/null input omits the field.\n      if (!Array.isArray(value)) return;\n\n      return value\n        .map((item) => this.transformValue(item, outputSettings[0], locale))\n        .filter((v) => v !== undefined);\n    }\n\n    if (outputSettings === \"self\" || outputSettings === \"self[]\") {\n      // Self-reference — resolve using the same resource class with cycle detection\n      outputValue = this.transformSelfReference(value, outputSettings === \"self[]\");\n    } else if (\n      typeof outputSettings === \"function\" &&\n      outputSettings.prototype instanceof Resource\n    ) {\n      if (!value) return;\n      // Nested resource — handle both single and array values\n      if (Array.isArray(value)) {\n        // An empty list stays an empty list ([] is the honest output); only a\n        // missing/null input omits the field.\n        outputValue = value\n          .map((item) => new (outputSettings as typeof Resource)(item).toJSON())\n          .filter((v) => v !== undefined);\n      } else {\n        outputValue = new (outputSettings as typeof Resource)(value).toJSON();\n      }\n    } else if (typeof outputSettings === \"function\") {\n      // Resolver function - bind to Resource instance for access to this.get(), etc.\n      outputValue = (outputSettings as Function).call(this, value, this);\n    } else if (outputSettings instanceof ResourceFieldBuilder) {\n      // Builder — handles array mapping and nullable internally via isArrayField\n      outputValue = outputSettings.transform(value, locale);\n    } else if (\n      typeof outputSettings === \"object\" &&\n      outputSettings !== null &&\n      \"__type\" in outputSettings &&\n      outputSettings.__type === \"arrayOf\"\n    ) {\n      // ResourceArraySchema — structured array items with their own sub-schema\n      if (Array.isArray(value)) {\n        outputValue = value\n          .map((item) => this.transformArrayItem(item, outputSettings.schema, locale))\n          .filter((v) => v !== undefined);\n      } else {\n        outputValue = this.transformArrayItem(value, outputSettings.schema, locale);\n      }\n    }\n\n    return outputValue;\n  }\n\n  /**\n   * Extend the resource output\n   */\n  protected extend() {\n    //\n  }\n\n  /**\n   * Transform a self-referencing field value.\n   *\n   * @example\n   * // Single: parent: \"self\"\n   * // Array:  children: \"self[]\"\n   */\n  protected transformSelfReference(value: any, isArray: boolean): any {\n    if (isArray) {\n      return Array.isArray(value)\n        ? value.map((item) => this.resolveSelf(item)).filter((v) => v !== undefined)\n        : undefined;\n    }\n\n    return this.resolveSelf(value);\n  }\n\n  /**\n   * Resolve a single self-reference value.\n   * Uses identity-based cycle detection (id/_id) and a max depth guard.\n   */\n  protected resolveSelf(value: any): any {\n    if (!value) return undefined;\n\n    const identity = value.id ?? value._id ?? value;\n    // Ancestors of the current path only: siblings never see each other,\n    // so the set size is the depth.\n    const ancestors = this._selfSeen ?? new Set();\n\n    // Circular reference or depth limit reached — stop recursion\n    if (ancestors.has(identity) || ancestors.size >= MAX_SELF_DEPTH) {\n      return undefined;\n    }\n\n    const SelfConstructor = this.constructor as typeof Resource;\n    const child = new SelfConstructor(value);\n    child._selfSeen = new Set(ancestors).add(identity);\n\n    return child.toJSON();\n  }\n\n  /**\n   * Transform a single array item according to the given schema\n   */\n  protected transformArrayItem(\n    item: any,\n    schema: Record<string, ResourceFieldConfig>,\n    locale?: string,\n  ) {\n    const transformedItem: GenericObject = {};\n\n    for (const [outputKey, outputSettings] of Object.entries(schema)) {\n      let fieldKey = outputKey;\n      let valueTransformType = outputSettings as ResourceFieldConfig;\n\n      if (Array.isArray(outputSettings) && outputSettings.length === 2) {\n        fieldKey = outputSettings[0] as string;\n        valueTransformType = outputSettings[1] as ResourceFieldConfig;\n      }\n\n      const inputKey =\n        valueTransformType instanceof ResourceFieldBuilder\n          ? valueTransformType.getInputKey()\n          : undefined;\n      const inputValue = this.resolveSourceValue(item, outputKey, inputKey ?? fieldKey);\n      const outputValue = this.transformValue(inputValue, valueTransformType, locale);\n\n      if (outputValue !== undefined) {\n        set(transformedItem, outputKey, outputValue);\n      }\n    }\n\n    return transformedItem;\n  }\n\n  /**\n   * Resolve one schema field from a model or plain object. Mongo records use `_id`\n   * internally, while resources expose `id` by convention.\n   */\n  protected resolveSourceValue(\n    source: GenericObject | Resource | Model,\n    outputKey: string,\n    inputKey?: string,\n  ) {\n    const key = inputKey ?? outputKey;\n    const read = (field: string) =>\n      source instanceof Model ? source.get(field) : get(source, field);\n    const value = read(key);\n\n    return outputKey === \"id\" && key === \"id\" && value === undefined ? read(\"_id\") : value;\n  }\n\n  /**\n   * Get a input value for the given key\n   */\n  public get(key: string, defaultValue?: any) {\n    return get(this.resource, key, defaultValue);\n  }\n\n  /**\n   * Set the given value for the given field\n   */\n  public set(key: string, value: any): ResourceContract {\n    set(this.data, key, value);\n\n    return this;\n  }\n\n  /**\n   * Create an array schema for transforming array items\n   */\n  public arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema {\n    return {\n      __type: \"arrayOf\",\n      schema,\n    };\n  }\n\n  /**\n   * Get a string field builder\n   */\n  public string(inputKey?: string) {\n    return this.fieldBuilder(\"string\", inputKey);\n  }\n\n  /**\n   * Get a date field builder\n   */\n  public date(inputKey?: string) {\n    return this.fieldBuilder(\"date\", inputKey);\n  }\n\n  /**\n   * Get a localized field builder\n   */\n  public localized(inputKey?: string) {\n    return this.fieldBuilder(\"localized\", inputKey);\n  }\n\n  /**\n   * Get a url field builder\n   */\n  public url(inputKey?: string) {\n    return this.fieldBuilder(\"url\", inputKey);\n  }\n\n  /**\n   * Get a uploadsUrl field builder\n   */\n  public uploadsUrl(inputKey?: string) {\n    return this.fieldBuilder(\"uploadsUrl\", inputKey);\n  }\n\n  /**\n   * Get a number field builder\n   */\n  public number(inputKey?: string) {\n    return this.fieldBuilder(\"number\", inputKey);\n  }\n\n  /**\n   * Get a boolean field builder\n   */\n  public boolean(inputKey?: string) {\n    return this.fieldBuilder(\"boolean\", inputKey);\n  }\n\n  /**\n   * Get a float field builder\n   */\n  public float(inputKey?: string) {\n    return this.fieldBuilder(\"float\", inputKey);\n  }\n\n  /**\n   * Get a int field builder\n   */\n  public int(inputKey?: string) {\n    return this.fieldBuilder(\"int\", inputKey);\n  }\n\n  /**\n   * New field builder\n   */\n  protected fieldBuilder(type: ResourceOutputValueCastType, inputKey?: string) {\n    const builder = new ResourceFieldBuilder(type);\n\n    if (inputKey) {\n      builder.setInputKey(inputKey);\n    }\n\n    return builder;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"resource.mjs","names":[],"sources":["../../../../../../../../packages/core/src/resource/resource.ts"],"sourcesContent":["import { get, isLazy, set, type GenericObject } from \"@mongez/reinforcements\";\nimport { Model } from \"@warlock.js/cascade\";\nimport { useRequestStore } from \"../http/context/request-context\";\nimport { isNullableResource } from \"./nullable-resource\";\nimport { ResourceFieldBuilder } from \"./resource-field-builder\";\nimport {\n  type ResourceArraySchema,\n  type ResourceFieldConfig,\n  type ResourceOutputValueCastType,\n} from \"./types\";\n\n/**\n * Maximum recursion depth for self-referencing fields.\n * Prevents runaway serialization on deep trees or circular data.\n */\nconst MAX_SELF_DEPTH = 10;\n\n/**\n * Whether the given schema entry is an `arrayOf` item schema\n */\nfunction isArrayOfSchema(value: unknown): value is ResourceArraySchema {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    (value as { __type?: unknown }).__type === \"arrayOf\" &&\n    typeof (value as { schema?: unknown }).schema === \"object\" &&\n    (value as { schema?: unknown }).schema !== null\n  );\n}\n\n/**\n * Resource contract\n */\nexport interface ResourceContract<Out = GenericObject> {\n  /**\n   * Resource data\n   */\n  resource: GenericObject;\n\n  /**\n   * Resource final output\n   */\n  data: GenericObject;\n\n  /**\n   * Original data\n   */\n  originalData: GenericObject;\n\n  /**\n   * Convert resource to JSON\n   */\n  toJSON(): Out;\n\n  /**\n   * Transform the given value with given type\n   */\n  transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;\n\n  /**\n   * Get a input value for the given key\n   */\n  get(key: string, defaultValue?: any): any;\n\n  /**\n   * Set the given value for the given field\n   */\n  set(key: string, value: any): ResourceContract;\n\n  /**\n   * Create an array schema for transforming array items\n   */\n  arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;\n\n  /**\n   * Get a string field builder\n   */\n  string(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a date field builder\n   */\n  date(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a localized field builder\n   */\n  localized(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a url field builder\n   */\n  url(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a uploadsUrl field builder\n   */\n  uploadsUrl(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a number field builder\n   */\n  number(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a boolean field builder\n   */\n  boolean(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a float field builder\n   */\n  float(inputKey?: string): ResourceFieldBuilder;\n\n  /**\n   * Get a int field builder\n   */\n  int(inputKey?: string): ResourceFieldBuilder;\n}\n\n/**\n * Resource constructor\n */\nexport interface ResourceConstructor<Out = GenericObject> {\n  new (originalData: GenericObject | Resource | Model): ResourceContract<Out>;\n}\n\nexport class Resource implements ResourceContract {\n  /**\n   * Resource data\n   */\n  public resource: GenericObject = {};\n\n  /**\n   * Resource final output\n   */\n  public data: GenericObject = {};\n\n  /**\n   * Tracks visited object identities during self-reference recursion.\n   * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).\n   */\n  protected _selfSeen?: Set<unknown>;\n\n  /**\n   * Raw resource schema — field declarations as written by the developer.\n   * Used by doc generators for introspection.\n   */\n  public static schema: Record<string, ResourceFieldConfig | string> = {};\n\n  /**\n   * Normalized schema — all string cast types and tuples converted to\n   * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.\n   */\n  public static parsedSchema: Record<string, ResourceFieldConfig> = {};\n\n  /**\n   * Normalize a raw schema into parsedSchema.\n   * Converts string cast types (including suffixes) and tuples into pre-built builders.\n   * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.\n   */\n  public static normalizeSchema(\n    schema: Record<string, ResourceFieldConfig | string>,\n  ): Record<string, ResourceFieldConfig> {\n    const parsed: Record<string, ResourceFieldConfig> = {};\n\n    for (const [key, value] of Object.entries(schema)) {\n      if (value === \"self\" || value === \"self[]\") {\n        // Keep self-references as-is — resolved lazily in transformValue\n        parsed[key] = value;\n      } else if (isLazy<ResourceConstructor>(value)) {\n        // Keep Lazy<ResourceConstructor> as-is — resolved at transform\n        // time so cyclic resource refs (A embeds B embeds A) compose\n        // without import-graph cycles.\n        parsed[key] = value;\n      } else if (typeof value === \"string\") {\n        parsed[key] = ResourceFieldBuilder.fromCastType(value);\n      } else if (\n        Array.isArray(value) &&\n        value.length === 2 &&\n        typeof value[0] === \"string\" &&\n        typeof value[1] === \"string\"\n      ) {\n        const builder = ResourceFieldBuilder.fromCastType(value[1]);\n        builder.setInputKey(value[0]);\n        parsed[key] = builder;\n      } else if (isArrayOfSchema(value)) {\n        // arrayOf item schemas follow the same rules as the top level: cast\n        // strings and tuples become builders (nested arrayOf recurses).\n        parsed[key] = { ...value, schema: Resource.normalizeSchema(value.schema) };\n      } else {\n        parsed[key] = value;\n      }\n    }\n\n    return parsed;\n  }\n\n  /**\n   * Constructor\n   */\n  public constructor(public originalData: GenericObject | Resource | Model) {\n    if (this.originalData instanceof Model) {\n      this.resource = this.originalData.data;\n    } else if (this.originalData instanceof Resource) {\n      this.resource = this.originalData.data;\n    } else {\n      this.resource = this.originalData;\n    }\n  }\n\n  /**\n   * Convert resource to JSON\n   */\n  public toJSON() {\n    this.boot();\n    this.transformOutput();\n    this.extend();\n\n    return this.data;\n  }\n\n  /**\n   * Boot method\n   * Called before transforming the resource\n   */\n  protected boot() {\n    //\n  }\n\n  /**\n   * Transform resource to output using the pre-normalized parsedSchema.\n   * Builders handle their own array/nullable logic internally.\n   * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.\n   */\n  protected transformOutput() {\n    const localeCode = useRequestStore()?.request?.locale;\n    const parsedSchema = this.resolveParsedSchema();\n    // A model is read through its accessors; anything else through the\n    // constructor's normalized input (a wrapped resource's serialized data).\n    const source = this.originalData instanceof Model ? this.originalData : this.resource;\n\n    for (const [outputKey, outputSettings] of Object.entries(parsedSchema)) {\n      const inputKey =\n        outputSettings instanceof ResourceFieldBuilder ? outputSettings.getInputKey() : undefined;\n      const inputValue = this.resolveSourceValue(source, outputKey, inputKey);\n      const outputValue = this.transformValue(inputValue, outputSettings, localeCode);\n\n      if (outputValue !== undefined) {\n        this.set(outputKey, outputValue);\n      }\n    }\n  }\n\n  /**\n   * Resolve the normalized schema of THIS class.\n   * `@RegisterResource()` is optional: when the class has no own `parsedSchema`\n   * (a static field is inherited from the base as `{}`), normalize its own\n   * static `schema` (or an instance `schema` field) once and cache it on the class.\n   */\n  protected resolveParsedSchema(): Record<string, ResourceFieldConfig> {\n    const ctor = this.constructor as typeof Resource;\n\n    if (Object.hasOwn(ctor, \"parsedSchema\")) {\n      return ctor.parsedSchema;\n    }\n\n    const instanceSchema = (\n      this as unknown as { schema?: Record<string, ResourceFieldConfig | string> }\n    ).schema;\n    const schema = instanceSchema ?? ctor.schema;\n\n    if (!schema || Object.keys(schema).length === 0) {\n      throw new Error(\n        `Resource \"${ctor.name}\" has no schema. Declare \\`static schema = { ... }\\` on the class.`,\n      );\n    }\n\n    const parsed = Resource.normalizeSchema(schema);\n\n    // Instance schemas are per-class by convention, so caching on the class is safe\n    ctor.parsedSchema = parsed;\n\n    return parsed;\n  }\n\n  /**\n   * Transform the given value with given type\n   */\n  public transform(value: any, type: ResourceOutputValueCastType, locale?: string) {\n    return new ResourceFieldBuilder(type).transform(value, locale);\n  }\n\n  /**\n   * Transform the given value for the given output setting.\n   * After normalization, string cast types no longer reach here — they are pre-converted to builders.\n   */\n  protected transformValue(value: any, outputSettings: ResourceFieldConfig, locale?: string): any {\n    let outputValue: any;\n\n    if (isLazy<ResourceConstructor>(outputSettings)) {\n      // Resolve the lazy ref now (cyclic resource imports are fully loaded\n      // by serialization time) and recurse — the resolved constructor is\n      // handled by the ResourceConstructor branch below.\n      return this.transformValue(value, outputSettings.resolve(), locale);\n    }\n\n    if (isNullableResource(outputSettings)) {\n      // nullable(Resource) — always present: null for a missing input, the resource output otherwise\n      if (value === null || value === undefined) return null;\n\n      return this.transformValue(value, outputSettings.resource, locale) ?? null;\n    }\n\n    if (Array.isArray(outputSettings) && outputSettings.length === 1) {\n      // [Resource] — a list field. [] stays [], a missing/null input omits the field.\n      if (!Array.isArray(value)) return;\n\n      return value\n        .map((item) => this.transformValue(item, outputSettings[0], locale))\n        .filter((v) => v !== undefined);\n    }\n\n    if (outputSettings === \"self\" || outputSettings === \"self[]\") {\n      // Self-reference — resolve using the same resource class with cycle detection\n      outputValue = this.transformSelfReference(value, outputSettings === \"self[]\");\n    } else if (\n      typeof outputSettings === \"function\" &&\n      outputSettings.prototype instanceof Resource\n    ) {\n      if (!value) return;\n      // Nested resource — handle both single and array values\n      if (Array.isArray(value)) {\n        // An empty list stays an empty list ([] is the honest output); only a\n        // missing/null input omits the field.\n        outputValue = value\n          .map((item) => new (outputSettings as typeof Resource)(item).toJSON())\n          .filter((v) => v !== undefined);\n      } else {\n        outputValue = new (outputSettings as typeof Resource)(value).toJSON();\n      }\n    } else if (typeof outputSettings === \"function\") {\n      // Resolver function - bind to Resource instance for access to this.get(), etc.\n      outputValue = (outputSettings as Function).call(this, value, this);\n    } else if (outputSettings instanceof ResourceFieldBuilder) {\n      // Builder — handles array mapping and nullable internally via isArrayField\n      outputValue = outputSettings.transform(value, locale);\n    } else if (\n      typeof outputSettings === \"object\" &&\n      outputSettings !== null &&\n      \"__type\" in outputSettings &&\n      outputSettings.__type === \"arrayOf\"\n    ) {\n      // ResourceArraySchema — structured array items with their own sub-schema\n      if (Array.isArray(value)) {\n        outputValue = value\n          .map((item) => this.transformArrayItem(item, outputSettings.schema, locale))\n          .filter((v) => v !== undefined);\n      } else {\n        outputValue = this.transformArrayItem(value, outputSettings.schema, locale);\n      }\n    }\n\n    return outputValue;\n  }\n\n  /**\n   * Extend the resource output\n   */\n  protected extend() {\n    //\n  }\n\n  /**\n   * Transform a self-referencing field value.\n   *\n   * @example\n   * // Single: parent: \"self\"\n   * // Array:  children: \"self[]\"\n   */\n  protected transformSelfReference(value: any, isArray: boolean): any {\n    if (isArray) {\n      return Array.isArray(value)\n        ? value.map((item) => this.resolveSelf(item)).filter((v) => v !== undefined)\n        : undefined;\n    }\n\n    return this.resolveSelf(value);\n  }\n\n  /**\n   * Resolve a single self-reference value.\n   * Uses identity-based cycle detection (id/_id) and a max depth guard.\n   */\n  protected resolveSelf(value: any): any {\n    if (!value) return undefined;\n\n    const identity = value.id ?? value._id ?? value;\n    // Ancestors of the current path only: siblings never see each other,\n    // so the set size is the depth.\n    const ancestors = this._selfSeen ?? new Set();\n\n    // Circular reference or depth limit reached — stop recursion\n    if (ancestors.has(identity) || ancestors.size >= MAX_SELF_DEPTH) {\n      return undefined;\n    }\n\n    const SelfConstructor = this.constructor as typeof Resource;\n    const child = new SelfConstructor(value);\n    child._selfSeen = new Set(ancestors).add(identity);\n\n    return child.toJSON();\n  }\n\n  /**\n   * Transform a single array item according to the given schema\n   */\n  protected transformArrayItem(\n    item: any,\n    schema: Record<string, ResourceFieldConfig>,\n    locale?: string,\n  ) {\n    const transformedItem: GenericObject = {};\n\n    for (const [outputKey, outputSettings] of Object.entries(schema)) {\n      let fieldKey = outputKey;\n      let valueTransformType = outputSettings as ResourceFieldConfig;\n\n      if (Array.isArray(outputSettings) && outputSettings.length === 2) {\n        fieldKey = outputSettings[0] as string;\n        valueTransformType = outputSettings[1] as ResourceFieldConfig;\n      }\n\n      const inputKey =\n        valueTransformType instanceof ResourceFieldBuilder\n          ? valueTransformType.getInputKey()\n          : undefined;\n      const inputValue = this.resolveSourceValue(item, outputKey, inputKey ?? fieldKey);\n      const outputValue = this.transformValue(inputValue, valueTransformType, locale);\n\n      if (outputValue !== undefined) {\n        set(transformedItem, outputKey, outputValue);\n      }\n    }\n\n    return transformedItem;\n  }\n\n  /**\n   * Resolve one schema field from a model or plain object. Mongo records use `_id`\n   * internally, while resources expose `id` by convention.\n   */\n  protected resolveSourceValue(\n    source: GenericObject | Resource | Model,\n    outputKey: string,\n    inputKey?: string,\n  ) {\n    const key = inputKey ?? outputKey;\n    const read = (field: string) =>\n      source instanceof Model ? source.get(field) : get(source, field);\n    const value = read(key);\n\n    return outputKey === \"id\" && key === \"id\" && value === undefined ? read(\"_id\") : value;\n  }\n\n  /**\n   * Get a input value for the given key\n   */\n  public get(key: string, defaultValue?: any) {\n    return get(this.resource, key, defaultValue);\n  }\n\n  /**\n   * Set the given value for the given field\n   */\n  public set(key: string, value: any): ResourceContract {\n    set(this.data, key, value);\n\n    return this;\n  }\n\n  /**\n   * Create an array schema for transforming array items\n   */\n  public arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema {\n    return {\n      __type: \"arrayOf\",\n      schema,\n    };\n  }\n\n  /**\n   * Get a string field builder\n   */\n  public string(inputKey?: string) {\n    return this.fieldBuilder(\"string\", inputKey);\n  }\n\n  /**\n   * Get a date field builder\n   */\n  public date(inputKey?: string) {\n    return this.fieldBuilder(\"date\", inputKey);\n  }\n\n  /**\n   * Get a localized field builder\n   */\n  public localized(inputKey?: string) {\n    return this.fieldBuilder(\"localized\", inputKey);\n  }\n\n  /**\n   * Get a url field builder\n   */\n  public url(inputKey?: string) {\n    return this.fieldBuilder(\"url\", inputKey);\n  }\n\n  /**\n   * Get a uploadsUrl field builder\n   */\n  public uploadsUrl(inputKey?: string) {\n    return this.fieldBuilder(\"uploadsUrl\", inputKey);\n  }\n\n  /**\n   * Get a number field builder\n   */\n  public number(inputKey?: string) {\n    return this.fieldBuilder(\"number\", inputKey);\n  }\n\n  /**\n   * Get a boolean field builder\n   */\n  public boolean(inputKey?: string) {\n    return this.fieldBuilder(\"boolean\", inputKey);\n  }\n\n  /**\n   * Get a float field builder\n   */\n  public float(inputKey?: string) {\n    return this.fieldBuilder(\"float\", inputKey);\n  }\n\n  /**\n   * Get a int field builder\n   */\n  public int(inputKey?: string) {\n    return this.fieldBuilder(\"int\", inputKey);\n  }\n\n  /**\n   * New field builder\n   */\n  protected fieldBuilder(type: ResourceOutputValueCastType, inputKey?: string) {\n    const builder = new ResourceFieldBuilder(type);\n\n    if (inputKey) {\n      builder.setInputKey(inputKey);\n    }\n\n    return builder;\n  }\n}\n"],"mappings":"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"}

package/esm/resource/types.d.mts

@@ -1,35 +1,35 @@
 import { ResponseStatus } from "../http/response.mjs";
+import "../http/index.mjs";
 import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
 import { ResourceConstructor, ResourceContract } from "./resource.mjs";
 import { NullableResource } from "./nullable-resource.mjs";
 import { Lazy } from "@mongez/reinforcements";
-
 //#region ../../packages/core/src/resource/types.d.ts
-type ResourceOutputValueCastType = "string" | "number" | "date" | "localized" | "boolean" | "url" | "float" | "int" | "object" | "array" | "uploadsUrl"
+export 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
  */
-| "storageUrl";
+"storageUrl";
 /**
  * Self-referencing type — resolves the field using the same resource class.
  * - `"self"` for a single nested self-reference
  * - `"self[]"` for an array of self-references
  */
-type ResourceSelfReference = "self" | "self[]";
+export type ResourceSelfReference = "self" | "self[]";
 /**
  * Cast type with modifier suffixes for use in resource schemas.
  * - `[]` suffix declares the field as an array (e.g. "string[]")
  * - `?` suffix declares the field as nullable — always present in output, value or null (e.g. "number?")
  * - Combined: `[]` must come before `?` (e.g. "string[]?")
  */
-type ResourceCastType = ResourceOutputValueCastType | `${ResourceOutputValueCastType}[]` | `${ResourceOutputValueCastType}?` | `${ResourceOutputValueCastType}[]?`;
-type ResourceArraySchema = {
+export type ResourceCastType = ResourceOutputValueCastType | `${ResourceOutputValueCastType}[]` | `${ResourceOutputValueCastType}?` | `${ResourceOutputValueCastType}[]?`;
+export type ResourceArraySchema = {
   __type: "arrayOf";
   schema: Record<string, ResourceFieldConfig>;
 };
-type ResourceFieldConfig = ResourceCastType | ResourceConstructor | ResourceSelfReference | Lazy<ResourceConstructor> | NullableResource | [ResourceConstructor] | [string, ResourceCastType] | ResourceFieldBuilder | ResourceArraySchema | ((value: any, resource: ResourceContract) => any);
-type ResourceSchema = Record<string, ResourceFieldConfig>;
-type ResourceFieldBuilderDateOutputOptions = {
+export type ResourceFieldConfig = ResourceCastType | ResourceConstructor | ResourceSelfReference | Lazy<ResourceConstructor> | NullableResource | [ResourceConstructor] | [string, ResourceCastType] | ResourceFieldBuilder | ResourceArraySchema | ((value: any, resource: ResourceContract) => any);
+export type ResourceSchema = Record<string, ResourceFieldConfig>;
+export type ResourceFieldBuilderDateOutputOptions = {
   /**
    * If set to true, then it will be returned as a formatted date
    */
@@ -68,18 +68,18 @@ type ResourceFieldBuilderDateOutputOptions = {
  * - nullable(ResourceConstructor) for a nested resource that is `null` when the value is missing
  * - A nested plain object of any of the above
  */
-type ResponseBodyValue = ResourceCastType | ResourceConstructor | [ResourceConstructor] | NullableResource<ResourceConstructor<any>> | {
+export type ResponseBodyValue = ResourceCastType | ResourceConstructor | [ResourceConstructor] | NullableResource<ResourceConstructor<any>> | {
   [key: string]: ResponseBodyValue;
 };
 /**
  * Response schema for a controller — used for documentation / OpenAPI generation.
  * Keyed by HTTP status code, each entry declares the expected response body shape.
  */
-type ResponseSchema = { [statusCode in ResponseStatus]?: {
+export type ResponseSchema = { [statusCode in ResponseStatus]?: {
   body: {
     [key: string]: ResponseBodyValue;
   };
-} };
+}; };
 /**
  * Collapse `any` to `unknown` so an untyped resolver never leaks `any` into a resource output.
  */
@@ -91,7 +91,7 @@ type AnyToUnknown<T> = 0 extends 1 & T ? unknown : T;
  * humanTime are on; timezone, locale and offset are off). A date field customised through a
  * builder (`dateOptions()`) is a builder field and resolves to `unknown`.
  */
-type BaseCastOutput<C extends string> = C extends "string" | "localized" | "url" | "uploadsUrl" | "storageUrl" ? string : C extends "number" | "float" | "int" ? number : C extends "boolean" ? boolean : C extends "object" ? Record<string, unknown> : C extends "array" ? unknown[] : C extends "date" ? {
+export type BaseCastOutput<C extends string> = C extends "string" | "localized" | "url" | "uploadsUrl" | "storageUrl" ? string : C extends "number" | "float" | "int" ? number : C extends "boolean" ? boolean : C extends "object" ? Record<string, unknown> : C extends "array" ? unknown[] : C extends "date" ? {
   iso: string;
   format: string;
   timestamp: number;
@@ -107,14 +107,14 @@ type BaseCastOutput<C extends string> = C extends "string" | "localized" | "url"
  * CastOutput<"string[]">  // string[]
  * CastOutput<"url[]?">    // string[] | null
  */
-type CastOutput<C extends string> = C extends `${infer B}[]?` ? BaseCastOutput<B>[] | null : C extends `${infer B}[]` ? BaseCastOutput<B>[] : C extends `${infer B}?` ? BaseCastOutput<B> | null : BaseCastOutput<C>;
+export type CastOutput<C extends string> = C extends `${infer B}[]?` ? BaseCastOutput<B>[] | null : C extends `${infer B}[]` ? BaseCastOutput<B>[] : C extends `${infer B}?` ? BaseCastOutput<B> | null : BaseCastOutput<C>;
 /**
  * Output type of one schema field.
  *
  * `Root` is the schema of the resource being defined, used to resolve `"self"` and `"self[]"`.
  * Anything that cannot be inferred statically (builders) is `unknown`, never `any`.
  */
-type FieldOutput<F, Root extends ResourceSchema = ResourceSchema> = F extends "self" ? ResourceOutputOf<Root, Root> : F extends "self[]" ? ResourceOutputOf<Root, Root>[] : F extends string ? CastOutput<F> : F extends NullableResource<infer R> ? FieldOutput<R, Root> | null : F extends readonly [new (...args: any[]) => {
+export type FieldOutput<F, Root extends ResourceSchema = ResourceSchema> = F extends "self" ? ResourceOutputOf<Root, Root> : F extends "self[]" ? ResourceOutputOf<Root, Root>[] : F extends string ? CastOutput<F> : F extends NullableResource<infer R> ? FieldOutput<R, Root> | null : F extends readonly [new (...args: any[]) => {
   toJSON(): infer O;
 }] ? AnyToUnknown<O>[] : F extends readonly [string, infer C extends string] ? CastOutput<C> : F extends ResourceFieldBuilder ? unknown : F extends Lazy<infer R> ? FieldOutput<R, Root> : F extends {
   readonly __type: "arrayOf";
@@ -129,7 +129,7 @@ type FieldOutput<F, Root extends ResourceSchema = ResourceSchema> = F extends "s
  * type UserJson = ResourceOutputOf<{ id: "number"; name: "string?" }>;
  * // { id: number; name: string | null }
  */
-type ResourceOutputOf<S extends ResourceSchema, Root extends ResourceSchema = S> = { -readonly [K in keyof S]: FieldOutput<S[K], Root> };
+export type ResourceOutputOf<S extends ResourceSchema, Root extends ResourceSchema = S> = { -readonly [K in keyof S]: FieldOutput<S[K], Root>; };
 /**
  * JSON output type of a resource class or of a resource instance.
  *
@@ -137,7 +137,7 @@ type ResourceOutputOf<S extends ResourceSchema, Root extends ResourceSchema = S>
  * type UserJson = ResourceOutput<typeof UserResource>;
  * type SameJson = ResourceOutput<InstanceType<typeof UserResource>>;
  */
-type ResourceOutput<R> = R extends (new (...args: any[]) => {
+export type ResourceOutput<R> = R extends (new (...args: any[]) => {
   toJSON(): infer O;
 }) ? O : R extends {
   toJSON(): infer O;
@@ -151,7 +151,7 @@ type ResourceOutput<R> = R extends (new (...args: any[]) => {
  * @example
  * type Out = ResponseBodyOutput<{ user: typeof UserResource; token: "string"; tags: "string[]?" }>;
  */
-type ResponseBodyOutput<B> = B extends string ? CastOutput<B> : B extends readonly [infer R] ? ResourceOutput<R>[] : B extends (new (...args: any[]) => unknown) ? ResourceOutput<B> : B extends NullableResource<infer R> ? ResourceOutput<R> | null : B extends object ? { -readonly [K in keyof B]: ResponseBodyOutput<B[K]> } : never;
+export type ResponseBodyOutput<B> = B extends string ? CastOutput<B> : B extends readonly [infer R] ? ResourceOutput<R>[] : B extends (new (...args: any[]) => unknown) ? ResourceOutput<B> : B extends NullableResource<infer R> ? ResourceOutput<R> | null : B extends object ? { -readonly [K in keyof B]: ResponseBodyOutput<B[K]>; } : never;
 /**
  * Output type of a whole response schema: the body output per declared status code.
  *
@@ -159,9 +159,9 @@ type ResponseBodyOutput<B> = B extends string ? CastOutput<B> : B extends readon
  * type LoginResponses = ResponseSchemaOutput<typeof loginSchema>;
  * // { 200: { user: UserJson; token: string }; 400: { error: string } }
  */
-type ResponseSchemaOutput<S extends ResponseSchema> = { -readonly [K in keyof S]-?: S[K] extends {
+export type ResponseSchemaOutput<S extends ResponseSchema> = { -readonly [K in keyof S]-?: S[K] extends {
   body: infer B;
-} ? ResponseBodyOutput<B> : never };
+} ? ResponseBodyOutput<B> : never; };
 //#endregion
-export { BaseCastOutput, CastOutput, FieldOutput, ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutput, ResourceOutputOf, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyOutput, ResponseBodyValue, ResponseSchema, ResponseSchemaOutput };
+export {};
 //# sourceMappingURL=types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/resource/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/resource/types.ts"],"mappings":";;;;;;;YAMY;;;;;;;;;;YAsBA;;;;;;;YAQA,mBACR,iCACG,qCACA,oCACA;YAEK;EACV;EACA,QAAQ,eAAe;;YAGb,sBACR,mBACA,sBACA,wBACA,KAAK,uBACL,oBACC,gCACQ,oBACT,uBACA,wBACE,YAAY,UAAU;YAEhB,iBAAiB,eAAe;YAEhC;;;;EAKN;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;;;;;;;;YAiBM,oBACR,mBACA,uBACC,uBACD,iBAAiB;GACd,cAAc;;;;;;YAMT,oBACT,cAAc;EACb;KAAS,cAAc;;;;;;KAOtB,aAAa,mBAAmB,cAAc;;;;;;;;YASvC,eAAe,oBAAoB,kFAO3C,gDAEE,gCAEE,qBACE,0BACA,gCAEE;EACI;EAAa;EAAgB;EAAmB;;;;;;;;;;;;YAapD,WAAW,oBAAoB,mBAAmB,SAC1D,eAAe,cACf,mBAAmB,QACjB,eAAe,OACf,mBAAmB,OACjB,eAAe,YACf,eAAe;;;;;;;YAQX,YAAY,GAAG,aAAa,iBAAiB,kBAAkB,mBACvE,iBAAiB,MAAM,QACvB,qBACE,iBAAiB,MAAM,UACvB,mBACE,WAAW,KACX,UAAU,uBAAuB,KAC/B,YAAY,GAAG,eACf,4BAA4B;EAAkB,gBAAgB;KAC5D,aAAa,OACb,kCAAkC,oBAChC,WAAW,KACX,UAAU,iCAER,UAAU,WAAW,KACnB,YAAY,GAAG,QACf;WACa;WACA,cAAc,aAAa;IAEtC,iBAAiB,MAAM,UACvB,mBAAkB;EAAkB,gBAAgB;KAClD,aAAa,KACb,eAAc,sBAAsB,KAClC,aAAa;;;;;;;;YAUzB,iBAAiB,UAAU,gBAAgB,aAAa,iBAAiB,kBACxE,WAAW,IAAI,YAAY,EAAE,IAAI;;;;;;;;YAUlC,eAAe,KAAK,mBAAkB;EAAkB,gBAAgB;KAChF,IACA;EAAY,gBAAgB;IAC1B;;;;;;;;;;YAYM,mBAAmB,KAAK,mBAChC,WAAW,KACX,0BAA0B,KACxB,eAAe,OACf,mBAAkB,2BAChB,eAAe,KACf,UAAU,uBAAuB,KAC/B,eAAe,YACf,gCACe,WAAW,IAAI,mBAAmB,EAAE;;;;;;;;YAUjD,qBAAqB,UAAU,+BAC9B,WAAW,MAAM,EAAE;EAAa,YAAY;IAAM,mBAAmB"}

package/esm/restful/index.d.mts

@@ -1 +1,2 @@
-import { Restful } from "./restful.mjs";
+import { Restful } from "./restful.mjs";
+export { Restful };

package/esm/restful/index.mjs

@@ -1,3 +1,3 @@
 import { Restful } from "./restful.mjs";
 
-export {  };
+export { Restful };

package/esm/restful/restful.d.mts

@@ -1,12 +1,14 @@
 import { Response } from "../http/response.mjs";
 import { Request } from "../http/request.mjs";
+import "../http/index.mjs";
 import { HttpContext, RestfulMiddleware, RouteResource } from "../router/types.mjs";
+import "../router/index.mjs";
 import { RepositoryManager } from "../repositories/repository.manager.mjs";
+import "../repositories/index.mjs";
 import { Model } from "@warlock.js/cascade";
 import { GenericObject } from "@mongez/reinforcements";
-
 //#region ../../packages/core/src/restful/restful.d.ts
-declare abstract class Restful<T extends Model> implements RouteResource {
+export declare abstract class Restful<T extends Model> implements RouteResource {
   /**
    * Middleware for each method
    */
@@ -40,52 +42,31 @@ declare abstract class Restful<T extends Model> implements RouteResource {
   /**
    * List records
    */
-  list({
-    request,
-    response
-  }: HttpContext): Promise<any[] | Response | Record<string, any>>;
+  list({ request, response }: HttpContext): Promise<any[] | Record<string, any> | Response>;
   /**
    * Get single record
    */
-  get({
-    request,
-    response
-  }: HttpContext): Promise<any[] | Response | Record<string, any>>;
+  get({ request, response }: HttpContext): Promise<any[] | Record<string, any> | Response>;
   /**
    * Create a new record
    */
-  create({
-    request,
-    response
-  }: HttpContext): Promise<any>;
+  create({ request, response }: HttpContext): Promise<any>;
   /**
    * Update record
    */
-  update({
-    request,
-    response
-  }: HttpContext): Promise<any>;
+  update({ request, response }: HttpContext): Promise<any>;
   /**
    * Patch record
    */
-  patch({
-    request,
-    response
-  }: HttpContext): Promise<any>;
+  patch({ request, response }: HttpContext): Promise<any>;
   /**
    * Delete record
    */
-  delete({
-    request,
-    response
-  }: HttpContext): Promise<any[] | Response | Record<string, any>>;
+  delete({ request, response }: HttpContext): Promise<any[] | Record<string, any> | Response>;
   /**
    * Bulk delete records
    */
-  bulkDelete({
-    request,
-    response
-  }: HttpContext): Promise<any[] | Response | Record<string, any>>;
+  bulkDelete({ request, response }: HttpContext): Promise<any[] | Record<string, any> | Response>;
   /**
    * Before create
    */
@@ -136,8 +117,7 @@ declare abstract class Restful<T extends Model> implements RouteResource {
    * Call middleware for the given method
    *
    */
-  protected callMiddleware(method: string, request: Request, response: Response, _record?: any): Promise<any[] | Response | Record<string, any> | undefined>;
+  protected callMiddleware(method: string, request: Request, response: Response, _record?: any): Promise<any[] | Record<string, any> | Response | undefined>;
 }
 //#endregion
-export { Restful };
 //# sourceMappingURL=restful.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/restful/restful.ts"],"mappings":"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"}
+{"version":3,"file":"restful.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/restful/restful.ts"],"mappings":";;;;;;;;;;8BASsB,QAAQ,UAAU,kBAAkB;;;;YAI9C,YAAY;;;;YAKZ;;;;YAKA;;;;qBAKS,YAAY,kBAAkB;;;;YAKvC,UAAU;;;;;;EAYb;;;;EAKM,KAAK,aAAU,QAAA;;;;EAQf,OAAO,SAAS,YAAY,cAAW,gBAAA,sBAAA;;;;EAkCvC,MAAM,SAAS,YAAY,cAAW,gBAAA,sBAAA;;;;EAyBtC,SAAS,SAAS,YAAY,cAAW;;;;EAsDzC,SAAS,SAAS,YAAY,cAAW;;;;EAkDzC,QAAQ,SAAS,YAAY,cAAW;;;;EAkDxC,SAAS,SAAS,YAAY,cAAW,gBAAA,sBAAA;;;;EAiCzC,aAAa,SAAS,YAAY,cAAW,gBAAA,sBAAA;;;;YA+C1C,aAAa,UAAU,SAAS,WAAW,UAAU,SAAS,IAAI;;;;YAOlE,SAAS,UAAU,SAAS,WAAW,UAAU,SAAS,IAAI;;;;YAO9D,aACd,UAAU,SACV,WAAW,UACX,SAAS,GACT,aAAa,IACZ;;;;YAOa,SACd,UAAU,SACV,WAAW,UACX,SAAS,GACT,YAAY,IACX;;;;YAOa,aAAa,UAAU,SAAS,WAAW,UAAU,SAAS,IAAI;;;;YAOlE,SAAS,UAAU,SAAS,WAAW,UAAU,SAAS,IAAI;;;;YAO9D,YACd,UAAU,SACV,WAAW,UACX,SAAS,GACT,aAAa,IACZ;;;;YAOa,QACd,UAAU,SACV,WAAW,UACX,SAAS,GACT,YAAY,IACX;;;;YAOa,WACd,UAAU,SACV,WAAW,UACX,UAAU,GACV,aAAa,IACZ;;;;YAOa,OACd,UAAU,SACV,WAAW,UACX,SAAS,GACT,aAAa,IACZ;;;;;;YASO,QAAQ,uCAAuC,SAAS,UAAU;;;;;YA6B5D,eACd,gBACA,SAAS,SACT,UAAU,UACV,gBAAa,gBAAA,sBAAA"}

package/esm/router/index.d.mts

@@ -6,4 +6,5 @@ import { matchesDerivedRouteName, routeNameMethodSuffix } from "./route-name-met
 import { RouteNameTakenError } from "./route-name-taken-error.mjs";
 import { RouteRegistry } from "./route-registry.mjs";
 import { Router, router } from "./router.mjs";
-import { AUTH_GUARD_MARKER, isAuthGuardMiddleware, isUnguardedMutatingRoute, markAuthGuard, reportUnguardedMutatingRoutes, resetUnguardedRouteReports } from "./unguarded-route-diagnostics.mjs";
+import { AUTH_GUARD_MARKER, isAuthGuardMiddleware, isUnguardedMutatingRoute, markAuthGuard, reportUnguardedMutatingRoutes, resetUnguardedRouteReports } from "./unguarded-route-diagnostics.mjs";
+export { AUTH_GUARD_MARKER, GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, NamedApiRoute, NamedApiRoutesOptions, PartialPick, PositionalHandlerSuspect, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteNameTakenError, RouteOptions, RouteRateLimitOptions, RouteRegistry, RouteResource, Router, RouterGroupCallback, RouterStacks, StaticMountOptions, ValidationFailureContext, ValidationFailureHandler, ValidationFailureResponse, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, isAuthGuardMiddleware, isUnguardedMutatingRoute, listPositionalHandlerSuspects, looksLikePositionalHandler, markAuthGuard, matchesDerivedRouteName, normalizeRequestPath, normalizeRoutePath, reportPositionalHandlerSuspects, reportUnguardedMutatingRoutes, resetUnguardedRouteReports, routeNameMethodSuffix, router };

package/esm/router/index.mjs

@@ -7,4 +7,4 @@ import { RouteRegistry } from "./route-registry.mjs";
 import { AUTH_GUARD_MARKER, isAuthGuardMiddleware, isUnguardedMutatingRoute, markAuthGuard, reportUnguardedMutatingRoutes, resetUnguardedRouteReports } from "./unguarded-route-diagnostics.mjs";
 import { Router, router } from "./router.mjs";
 
-export {  };
+export { AUTH_GUARD_MARKER, RouteNameTakenError, RouteRegistry, Router, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, isAuthGuardMiddleware, isUnguardedMutatingRoute, listPositionalHandlerSuspects, looksLikePositionalHandler, markAuthGuard, matchesDerivedRouteName, normalizeRequestPath, normalizeRoutePath, reportPositionalHandlerSuspects, reportUnguardedMutatingRoutes, resetUnguardedRouteReports, routeNameMethodSuffix, router };

package/esm/router/named-api-routes-with-responses.mjs

@@ -30,7 +30,8 @@ async function importResourceNamespaces(files, onWarn) {
 * cannot be imported is reported once through `onWarn` and left out of the map.
 */
 async function collectResourceExportMap(files, onWarn) {
-	return buildResourceMap(await importResourceNamespaces([...files].filter(isResourceFile), onWarn));
+	const namespaces = await importResourceNamespaces([...files].filter(isResourceFile), onWarn);
+	return buildResourceMap(namespaces);
 }
 /**
 * Named API route snapshots, with a `response` type map on every route whose handler

package/esm/router/named-api-routes-with-responses.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"named-api-routes-with-responses.mjs","names":[],"sources":["../../../../../../../../packages/core/src/router/named-api-routes-with-responses.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport {\n  buildResourceMap,\n  createResourceTypeResolver,\n  describeResponseSchemaTypes,\n  type ResourceModuleExport,\n  type ResourceModuleNamespace,\n  type ResourceTypeResolver,\n} from \"./response-schema-types\";\nimport { router } from \"./router\";\nimport type { NamedApiRoute } from \"./types\";\n\nconst RESOURCE_FILE_PATTERN = /(^|\\/)src\\/.*\\.resource\\.tsx?$/;\n\nexport type ResourceSourceFile = Readonly<{\n  absolutePath: string;\n  relativePath: string;\n}>;\n\nexport type NamedApiRoutesWithResponsesOptions = Readonly<{\n  /**\n   * Application root, the folder that contains `.warlock/typings/`.\n   */\n  appRoot: string;\n  /**\n   * Every file the orchestrator knows about. `*.resource.ts(x)` files under `src/` are\n   * imported to map resource classes back to their exports.\n   */\n  files: Iterable<ResourceSourceFile>;\n  /**\n   * Receives a human readable warning (unmapped resource, unreadable resource module).\n   */\n  onWarn?: (message: string) => void;\n}>;\n\nfunction isResourceFile(file: ResourceSourceFile): boolean {\n  return RESOURCE_FILE_PATTERN.test(file.relativePath.replace(/\\\\/g, \"/\"));\n}\n\nasync function importResourceNamespaces(\n  files: readonly ResourceSourceFile[],\n  onWarn: ((message: string) => void) | undefined,\n): Promise<ResourceModuleNamespace[]> {\n  const namespaces: ResourceModuleNamespace[] = [];\n\n  for (const file of files) {\n    try {\n      const namespace = (await importAppModule(pathToFileURL(file.absolutePath).href)) as Record<\n        string,\n        unknown\n      >;\n\n      namespaces.push({ file: file.absolutePath, namespace });\n    } catch (error) {\n      onWarn?.(\n        `Could not import ${file.relativePath} to type API responses: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n      );\n    }\n  }\n\n  return namespaces;\n}\n\n/**\n * Identity map from every resource class exported by a `*.resource.ts(x)` file under\n * `src/` to the module export it came from.\n *\n * The modules are imported through the same importer the routes used, so a resource class\n * found in a `responseSchema` is the very instance exported by its module. A module that\n * cannot be imported is reported once through `onWarn` and left out of the map.\n */\nexport async function collectResourceExportMap(\n  files: Iterable<ResourceSourceFile>,\n  onWarn?: (message: string) => void,\n): Promise<Map<unknown, ResourceModuleExport>> {\n  const namespaces = await importResourceNamespaces([...files].filter(isResourceFile), onWarn);\n\n  return buildResourceMap(namespaces);\n}\n\n/**\n * Named API route snapshots, with a `response` type map on every route whose handler\n * declares `responseSchema`.\n *\n * Resource modules are imported only when at least one route declares a schema, through\n * the same importer the routes used, so a resource class seen in a schema is the very\n * instance exported by its module. Never throws: if anything fails the routes come back\n * without `response` (and the failure is reported once through `onWarn`).\n */\nexport async function collectNamedApiRoutesWithResponses(\n  options: NamedApiRoutesWithResponsesOptions,\n): Promise<readonly NamedApiRoute[]> {\n  try {\n    const declaresSchema = router.list().some((route) => route.handler?.responseSchema);\n\n    if (!declaresSchema) return router.getNamedApiRoutes();\n\n    const resolveResource: ResourceTypeResolver = createResourceTypeResolver(\n      await collectResourceExportMap(options.files, options.onWarn),\n      options.appRoot,\n    );\n\n    return router.getNamedApiRoutes({\n      resolveResponse: (schema, route) =>\n        describeResponseSchemaTypes(schema, resolveResource, (fieldPath) => {\n          options.onWarn?.(\n            `Route \"${route.name}\" (${route.method} ${route.path}): response ${fieldPath} is a resource that is not exported from a *.resource.ts file, typed as unknown.`,\n          );\n        }),\n    });\n  } catch (error) {\n    options.onWarn?.(\n      `Could not type API responses: ${error instanceof Error ? error.message : String(error)}`,\n    );\n\n    return router.getNamedApiRoutes();\n  }\n}\n"],"mappings":";;;;;;AAaA,MAAM,wBAAwB;AAuB9B,SAAS,eAAe,MAAmC;CACzD,OAAO,sBAAsB,KAAK,KAAK,aAAa,QAAQ,OAAO,GAAG,CAAC;AACzE;AAEA,eAAe,yBACb,OACA,QACoC;CACpC,MAAM,aAAwC,CAAC;CAE/C,KAAK,MAAM,QAAQ,OACjB,IAAI;EACF,MAAM,YAAa,MAAM,gBAAgB,cAAc,KAAK,YAAY,CAAC,CAAC,IAAI;EAK9E,WAAW,KAAK;GAAE,MAAM,KAAK;GAAc;EAAU,CAAC;CACxD,SAAS,OAAO;EACd,SACE,oBAAoB,KAAK,aAAa,0BACpC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAEzD;CACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,eAAsB,yBACpB,OACA,QAC6C;CAG7C,OAAO,iBAAiB,MAFC,yBAAyB,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,cAAc,GAAG,MAAM,CAEzD;AACpC;;;;;;;;;;AAWA,eAAsB,mCACpB,SACmC;CACnC,IAAI;EAGF,IAAI,CAFmB,OAAO,KAAK,CAAC,CAAC,MAAM,UAAU,MAAM,SAAS,cAElD,GAAG,OAAO,OAAO,kBAAkB;EAErD,MAAM,kBAAwC,2BAC5C,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,MAAM,GAC5D,QAAQ,OACV;EAEA,OAAO,OAAO,kBAAkB,EAC9B,kBAAkB,QAAQ,UACxB,4BAA4B,QAAQ,kBAAkB,cAAc;GAClE,QAAQ,SACN,UAAU,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,MAAM,KAAK,cAAc,UAAU,iFAC/E;EACF,CAAC,EACL,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,SACN,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACxF;EAEA,OAAO,OAAO,kBAAkB;CAClC;AACF"}
+{"version":3,"file":"named-api-routes-with-responses.mjs","names":[],"sources":["../../../../../../../../packages/core/src/router/named-api-routes-with-responses.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport {\n  buildResourceMap,\n  createResourceTypeResolver,\n  describeResponseSchemaTypes,\n  type ResourceModuleExport,\n  type ResourceModuleNamespace,\n  type ResourceTypeResolver,\n} from \"./response-schema-types\";\nimport { router } from \"./router\";\nimport type { NamedApiRoute } from \"./types\";\n\nconst RESOURCE_FILE_PATTERN = /(^|\\/)src\\/.*\\.resource\\.tsx?$/;\n\nexport type ResourceSourceFile = Readonly<{\n  absolutePath: string;\n  relativePath: string;\n}>;\n\nexport type NamedApiRoutesWithResponsesOptions = Readonly<{\n  /**\n   * Application root, the folder that contains `.warlock/typings/`.\n   */\n  appRoot: string;\n  /**\n   * Every file the orchestrator knows about. `*.resource.ts(x)` files under `src/` are\n   * imported to map resource classes back to their exports.\n   */\n  files: Iterable<ResourceSourceFile>;\n  /**\n   * Receives a human readable warning (unmapped resource, unreadable resource module).\n   */\n  onWarn?: (message: string) => void;\n}>;\n\nfunction isResourceFile(file: ResourceSourceFile): boolean {\n  return RESOURCE_FILE_PATTERN.test(file.relativePath.replace(/\\\\/g, \"/\"));\n}\n\nasync function importResourceNamespaces(\n  files: readonly ResourceSourceFile[],\n  onWarn: ((message: string) => void) | undefined,\n): Promise<ResourceModuleNamespace[]> {\n  const namespaces: ResourceModuleNamespace[] = [];\n\n  for (const file of files) {\n    try {\n      const namespace = (await importAppModule(pathToFileURL(file.absolutePath).href)) as Record<\n        string,\n        unknown\n      >;\n\n      namespaces.push({ file: file.absolutePath, namespace });\n    } catch (error) {\n      onWarn?.(\n        `Could not import ${file.relativePath} to type API responses: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n      );\n    }\n  }\n\n  return namespaces;\n}\n\n/**\n * Identity map from every resource class exported by a `*.resource.ts(x)` file under\n * `src/` to the module export it came from.\n *\n * The modules are imported through the same importer the routes used, so a resource class\n * found in a `responseSchema` is the very instance exported by its module. A module that\n * cannot be imported is reported once through `onWarn` and left out of the map.\n */\nexport async function collectResourceExportMap(\n  files: Iterable<ResourceSourceFile>,\n  onWarn?: (message: string) => void,\n): Promise<Map<unknown, ResourceModuleExport>> {\n  const namespaces = await importResourceNamespaces([...files].filter(isResourceFile), onWarn);\n\n  return buildResourceMap(namespaces);\n}\n\n/**\n * Named API route snapshots, with a `response` type map on every route whose handler\n * declares `responseSchema`.\n *\n * Resource modules are imported only when at least one route declares a schema, through\n * the same importer the routes used, so a resource class seen in a schema is the very\n * instance exported by its module. Never throws: if anything fails the routes come back\n * without `response` (and the failure is reported once through `onWarn`).\n */\nexport async function collectNamedApiRoutesWithResponses(\n  options: NamedApiRoutesWithResponsesOptions,\n): Promise<readonly NamedApiRoute[]> {\n  try {\n    const declaresSchema = router.list().some((route) => route.handler?.responseSchema);\n\n    if (!declaresSchema) return router.getNamedApiRoutes();\n\n    const resolveResource: ResourceTypeResolver = createResourceTypeResolver(\n      await collectResourceExportMap(options.files, options.onWarn),\n      options.appRoot,\n    );\n\n    return router.getNamedApiRoutes({\n      resolveResponse: (schema, route) =>\n        describeResponseSchemaTypes(schema, resolveResource, (fieldPath) => {\n          options.onWarn?.(\n            `Route \"${route.name}\" (${route.method} ${route.path}): response ${fieldPath} is a resource that is not exported from a *.resource.ts file, typed as unknown.`,\n          );\n        }),\n    });\n  } catch (error) {\n    options.onWarn?.(\n      `Could not type API responses: ${error instanceof Error ? error.message : String(error)}`,\n    );\n\n    return router.getNamedApiRoutes();\n  }\n}\n"],"mappings":";;;;;;AAaA,MAAM,wBAAwB;AAuB9B,SAAS,eAAe,MAAmC;CACzD,OAAO,sBAAsB,KAAK,KAAK,aAAa,QAAQ,OAAO,GAAG,CAAC;AACzE;AAEA,eAAe,yBACb,OACA,QACoC;CACpC,MAAM,aAAwC,CAAC;CAE/C,KAAK,MAAM,QAAQ,OACjB,IAAI;EACF,MAAM,YAAa,MAAM,gBAAgB,cAAc,KAAK,YAAY,CAAC,CAAC,IAAI;EAK9E,WAAW,KAAK;GAAE,MAAM,KAAK;GAAc;EAAU,CAAC;CACxD,SAAS,OAAO;EACd,SACE,oBAAoB,KAAK,aAAa,0BACpC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAEzD;CACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,eAAsB,yBACpB,OACA,QAC6C;CAC7C,MAAM,aAAa,MAAM,yBAAyB,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,cAAc,GAAG,MAAM;CAE3F,OAAO,iBAAiB,UAAU;AACpC;;;;;;;;;;AAWA,eAAsB,mCACpB,SACmC;CACnC,IAAI;EAGF,IAAI,CAFmB,OAAO,KAAK,CAAC,CAAC,MAAM,UAAU,MAAM,SAAS,cAElD,GAAG,OAAO,OAAO,kBAAkB;EAErD,MAAM,kBAAwC,2BAC5C,MAAM,yBAAyB,QAAQ,OAAO,QAAQ,MAAM,GAC5D,QAAQ,OACV;EAEA,OAAO,OAAO,kBAAkB,EAC9B,kBAAkB,QAAQ,UACxB,4BAA4B,QAAQ,kBAAkB,cAAc;GAClE,QAAQ,SACN,UAAU,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,MAAM,KAAK,cAAc,UAAU,iFAC/E;EACF,CAAC,EACL,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,SACN,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACxF;EAEA,OAAO,OAAO,kBAAkB;CAClC;AACF"}

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

@@ -8,7 +8,6 @@
  * slash optional. The root path is already canonical and must never become an
  * empty string.
  */
-declare function normalizeRequestPath(pathname: string): string;
+export 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

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

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

@@ -22,7 +22,6 @@
  * @example normalizeRoutePath("/users/", "/:id") // "/users/:id"
  * @example normalizeRoutePath("") // "/"
  */
-declare function normalizeRoutePath(...segments: string[]): string;
+export 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

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

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

@@ -1,14 +1,17 @@
 import { Route } from "./types.mjs";
 import { log } from "@warlock.js/logger";
-
 //#region ../../packages/core/src/router/positional-handler-diagnostics.d.ts
 /**
  * One route whose handler looks like it was written for v4.
  */
-type PositionalHandlerSuspect = {
-  /** HTTP method the route was registered under. */method: Route["method"]; /** Full route path, prefixes already applied. */
-  path: string; /** Handler function name, or `"(anonymous)"` when it has none. */
-  handlerName: string; /** Route file the route came from, when the router knows it. */
+export type PositionalHandlerSuspect = {
+  /** HTTP method the route was registered under. */
+  method: Route["method"];
+  /** Full route path, prefixes already applied. */
+  path: string;
+  /** Handler function name, or `"(anonymous)"` when it has none. */
+  handlerName: string;
+  /** Route file the route came from, when the router knows it. */
   sourceFile: string;
 };
 /**
@@ -43,7 +46,7 @@ type PositionalHandlerSuspect = {
  * `({ … })` form are essentially nil, and every miss simply leaves today's
  * behaviour in place.
  */
-declare function looksLikePositionalHandler(handler: unknown): boolean;
+export declare function looksLikePositionalHandler(handler: unknown): boolean;
 /**
  * Inspect one route's handler as it registers, recording it when it looks like
  * the v4 positional form. Called from `Router.add`, so the cost is paid once per
@@ -52,7 +55,7 @@ declare function looksLikePositionalHandler(handler: unknown): boolean;
  * Deliberately total: any unexpected failure in the heuristic is swallowed, so a
  * diagnostic can never be the reason a route fails to register.
  */
-declare function inspectHandlerSignature(handler: unknown, route: {
+export declare function inspectHandlerSignature(handler: unknown, route: {
   method: Route["method"];
   path: string;
   sourceFile: string;
@@ -60,31 +63,30 @@ declare function inspectHandlerSignature(handler: unknown, route: {
 /**
  * Every suspect recorded so far, in registration order.
  */
-declare function listPositionalHandlerSuspects(): readonly PositionalHandlerSuspect[];
+export declare function listPositionalHandlerSuspects(): readonly PositionalHandlerSuspect[];
 /**
  * Drop the suspects belonging to a route file. Kept in step with
  * `Router.removeRoutesBySourceFile` so an HMR reload that fixes a handler does
  * not keep reporting the version it replaced.
  */
-declare function forgetPositionalHandlerSuspects(sourceFile: string): void;
+export declare function forgetPositionalHandlerSuspects(sourceFile: string): void;
 /**
  * Drop every recorded suspect. Intended for tests, which share the router
  * singleton.
  */
-declare function clearPositionalHandlerSuspects(): void;
+export declare function clearPositionalHandlerSuspects(): void;
 /**
  * The one-line diagnostic for a single route. Written for someone who has never
  * read Warlock's internals: it names the handler, the route, what is wrong, and
  * the exact edit that fixes it.
  */
-declare function describePositionalHandlerSuspect(suspect: PositionalHandlerSuspect): string;
+export declare function describePositionalHandlerSuspect(suspect: PositionalHandlerSuspect): string;
 /**
  * The full boot-time warning: every suspect, once, in one entry.
  *
  * One boot, one list — not one warning per route, and emphatically not one 500
  * per request. Returns the reported suspects so callers can assert on them.
  */
-declare function reportPositionalHandlerSuspects(logger?: Pick<typeof log, "warn">): PositionalHandlerSuspect[];
+export declare function reportPositionalHandlerSuspects(logger?: Pick<typeof log, "warn">): PositionalHandlerSuspect[];
 //#endregion
-export { PositionalHandlerSuspect, clearPositionalHandlerSuspects, describePositionalHandlerSuspect, forgetPositionalHandlerSuspects, inspectHandlerSignature, listPositionalHandlerSuspects, looksLikePositionalHandler, reportPositionalHandlerSuspects };
 //# sourceMappingURL=positional-handler-diagnostics.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"positional-handler-diagnostics.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/router/positional-handler-diagnostics.ts"],"mappings":";;;;AAiQsE;AAmBtE;;AAnBsE,KA7N1D,wBAAA;EAgPsE,kDA9OhF,MAAA,EAAQ,KAAK,YAuPC;EApPd,IAAA;EAGA,WAAA,UAiPgE;EA9OhE,UAAA;AAAA;;;AA4P4C;AAS9C;;;;AAAkF;AAclF;;;;;;;;;;;;;AAAsF;;;;;;;;;;;iBAtGtE,0BAAA,CAA2B,OAAgB;;;;;;;;;iBAmC3C,uBAAA,CACd,OAAA,WACA,KAAA;EAAS,MAAA,EAAQ,KAAK;EAAY,IAAA;EAAc,UAAA;AAAA;;;;iBAmBlC,6BAAA,aAA0C,wBAAwB;;;;;;iBASlE,+BAAA,CAAgC,UAAkB;;;;;iBAclD,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":["../../../../../../../../packages/core/src/router/positional-handler-diagnostics.ts"],"mappings":";;;;;;YAoCY;;EAEV,QAAQ;;EAGR;;EAGA;;EAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA6Kc,2BAA2B;;;;;;;;;wBAmC3B,wBACd,kBACA;EAAS,QAAQ;EAAiB;EAAc;;;;;wBAmBlC,0CAA0C;;;;;;wBAS1C,gCAAgC;;;;;wBAchC;;;;;;wBASA,iCAAiC,SAAS;;;;;;;wBAc1C,gCAAgC,SAAQ,YAAY,eAAkB"}

package/esm/router/resolve-route-rate-limit.mjs

@@ -1,5 +1,5 @@
 import { buildRouteRateLimit } from "./build-route-rate-limit.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../../packages/core/src/router/resolve-route-rate-limit.ts
 /**
@@ -10,7 +10,7 @@ import config from "@mongez/config";
 * opts them back in.
 */
 function staticFilesAreRateLimited() {
-	return config.get("http.rateLimit.staticFiles") === true;
+	return baseConfig.get("http.rateLimit.staticFiles") === true;
 }
 /**
 * Resolve a static mount's rate-limit setting: `true` keeps it under the
@@ -43,5 +43,5 @@ function resolveExplicitRateLimit(rateLimit) {
 }
 
 //#endregion
-export { resolveRouteRateLimit, resolveStaticRateLimit };
+export { resolveRouteRateLimit, resolveStaticRateLimit, staticFilesAreRateLimited };
 //# sourceMappingURL=resolve-route-rate-limit.mjs.map

package/esm/router/resolve-route-rate-limit.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-route-rate-limit.mjs","names":[],"sources":["../../../../../../../../packages/core/src/router/resolve-route-rate-limit.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { buildRouteRateLimit } from \"./build-route-rate-limit\";\nimport type { Route, RouteRateLimitOptions } from \"./types\";\n\n/**\n * What `@fastify/rate-limit` reads from a route's `config.rateLimit`:\n * `false` exempts the route, an object gives it its own limit and bucket, and\n * `undefined` leaves it under the global policy.\n */\nexport type RouteRateLimitSetting = false | Record<string, unknown> | undefined;\n\n/**\n * Whether static files (the public folder, `router.directory()` mounts and\n * `router.file()` routes) count against the global limiter. Off by default:\n * one page load fetches many assets, which would spend a client's quota on\n * files instead of pages and API calls. `http.rateLimit.staticFiles: true`\n * opts them back in.\n */\nexport function staticFilesAreRateLimited(): boolean {\n  return config.get(\"http.rateLimit.staticFiles\") === true;\n}\n\n/**\n * Resolve a static mount's rate-limit setting: `true` keeps it under the\n * global limiter, `false` exempts it, an object gives it its own limit, and\n * leaving it unset follows `http.rateLimit.staticFiles`.\n */\nexport function resolveStaticRateLimit(\n  rateLimit: RouteRateLimitOptions | boolean | undefined,\n): RouteRateLimitSetting {\n  if (rateLimit === undefined) {\n    return staticFilesAreRateLimited() ? undefined : false;\n  }\n\n  return resolveExplicitRateLimit(rateLimit);\n}\n\n/**\n * Resolve a router route's rate-limit setting, identically for production\n * registration and the development wildcard dispatcher.\n *\n * Precedence: the route's own `rateLimit` option, then a\n * `serverOptions.config.rateLimit` passed through to Fastify, then the\n * static-file default for `router.file()` routes, then the global policy.\n */\nexport function resolveRouteRateLimit(\n  route: Pick<Route, \"rateLimit\" | \"serverOptions\" | \"$staticFile\">,\n): RouteRateLimitSetting {\n  if (route.rateLimit !== undefined) {\n    return resolveExplicitRateLimit(route.rateLimit);\n  }\n\n  const passedThrough: unknown = (\n    route.serverOptions?.config as { rateLimit?: unknown } | undefined\n  )?.rateLimit;\n\n  if (passedThrough === false) return false;\n\n  if (typeof passedThrough === \"object\" && passedThrough !== null) {\n    return passedThrough as Record<string, unknown>;\n  }\n\n  if (route.$staticFile) return resolveStaticRateLimit(undefined);\n\n  return undefined;\n}\n\nfunction resolveExplicitRateLimit(\n  rateLimit: RouteRateLimitOptions | boolean,\n): RouteRateLimitSetting {\n  if (rateLimit === true) return undefined;\n\n  if (rateLimit === false) return false;\n\n  return buildRouteRateLimit(rateLimit);\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,4BAAqC;CACnD,OAAO,OAAO,IAAI,4BAA4B,MAAM;AACtD;;;;;;AAOA,SAAgB,uBACd,WACuB;CACvB,IAAI,cAAc,QAChB,OAAO,0BAA0B,IAAI,SAAY;CAGnD,OAAO,yBAAyB,SAAS;AAC3C;;;;;;;;;AAUA,SAAgB,sBACd,OACuB;CACvB,IAAI,MAAM,cAAc,QACtB,OAAO,yBAAyB,MAAM,SAAS;CAGjD,MAAM,iBACJ,MAAM,eAAe,OAAM,EAC1B;CAEH,IAAI,kBAAkB,OAAO,OAAO;CAEpC,IAAI,OAAO,kBAAkB,YAAY,kBAAkB,MACzD,OAAO;CAGT,IAAI,MAAM,aAAa,OAAO,uBAAuB,MAAS;AAGhE;AAEA,SAAS,yBACP,WACuB;CACvB,IAAI,cAAc,MAAM,OAAO;CAE/B,IAAI,cAAc,OAAO,OAAO;CAEhC,OAAO,oBAAoB,SAAS;AACtC"}
+{"version":3,"file":"resolve-route-rate-limit.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/router/resolve-route-rate-limit.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { buildRouteRateLimit } from \"./build-route-rate-limit\";\nimport type { Route, RouteRateLimitOptions } from \"./types\";\n\n/**\n * What `@fastify/rate-limit` reads from a route's `config.rateLimit`:\n * `false` exempts the route, an object gives it its own limit and bucket, and\n * `undefined` leaves it under the global policy.\n */\nexport type RouteRateLimitSetting = false | Record<string, unknown> | undefined;\n\n/**\n * Whether static files (the public folder, `router.directory()` mounts and\n * `router.file()` routes) count against the global limiter. Off by default:\n * one page load fetches many assets, which would spend a client's quota on\n * files instead of pages and API calls. `http.rateLimit.staticFiles: true`\n * opts them back in.\n */\nexport function staticFilesAreRateLimited(): boolean {\n  return config.get(\"http.rateLimit.staticFiles\") === true;\n}\n\n/**\n * Resolve a static mount's rate-limit setting: `true` keeps it under the\n * global limiter, `false` exempts it, an object gives it its own limit, and\n * leaving it unset follows `http.rateLimit.staticFiles`.\n */\nexport function resolveStaticRateLimit(\n  rateLimit: RouteRateLimitOptions | boolean | undefined,\n): RouteRateLimitSetting {\n  if (rateLimit === undefined) {\n    return staticFilesAreRateLimited() ? undefined : false;\n  }\n\n  return resolveExplicitRateLimit(rateLimit);\n}\n\n/**\n * Resolve a router route's rate-limit setting, identically for production\n * registration and the development wildcard dispatcher.\n *\n * Precedence: the route's own `rateLimit` option, then a\n * `serverOptions.config.rateLimit` passed through to Fastify, then the\n * static-file default for `router.file()` routes, then the global policy.\n */\nexport function resolveRouteRateLimit(\n  route: Pick<Route, \"rateLimit\" | \"serverOptions\" | \"$staticFile\">,\n): RouteRateLimitSetting {\n  if (route.rateLimit !== undefined) {\n    return resolveExplicitRateLimit(route.rateLimit);\n  }\n\n  const passedThrough: unknown = (\n    route.serverOptions?.config as { rateLimit?: unknown } | undefined\n  )?.rateLimit;\n\n  if (passedThrough === false) return false;\n\n  if (typeof passedThrough === \"object\" && passedThrough !== null) {\n    return passedThrough as Record<string, unknown>;\n  }\n\n  if (route.$staticFile) return resolveStaticRateLimit(undefined);\n\n  return undefined;\n}\n\nfunction resolveExplicitRateLimit(\n  rateLimit: RouteRateLimitOptions | boolean,\n): RouteRateLimitSetting {\n  if (rateLimit === true) return undefined;\n\n  if (rateLimit === false) return false;\n\n  return buildRouteRateLimit(rateLimit);\n}\n"],"mappings":";;;;;;;;;;;AAkBA,SAAgB,4BAAqC;CACnD,OAAOA,WAAO,IAAI,4BAA4B,MAAM;AACtD;;;;;;AAOA,SAAgB,uBACd,WACuB;CACvB,IAAI,cAAc,QAChB,OAAO,0BAA0B,IAAI,SAAY;CAGnD,OAAO,yBAAyB,SAAS;AAC3C;;;;;;;;;AAUA,SAAgB,sBACd,OACuB;CACvB,IAAI,MAAM,cAAc,QACtB,OAAO,yBAAyB,MAAM,SAAS;CAGjD,MAAM,iBACJ,MAAM,eAAe,OAAM,EAC1B;CAEH,IAAI,kBAAkB,OAAO,OAAO;CAEpC,IAAI,OAAO,kBAAkB,YAAY,kBAAkB,MACzD,OAAO;CAGT,IAAI,MAAM,aAAa,OAAO,uBAAuB,MAAS;AAGhE;AAEA,SAAS,yBACP,WACuB;CACvB,IAAI,cAAc,MAAM,OAAO;CAE/B,IAAI,cAAc,OAAO,OAAO;CAEhC,OAAO,oBAAoB,SAAS;AACtC"}