@warlock.js/core 4.0.174 → 4.1.2

package/esm/http/request.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/http/request.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport events from \"@mongez/events\";\r\nimport { trans, transFrom } from \"@mongez/localization\";\r\nimport { Random, except, get, only, rtrim, set, unset } from \"@mongez/reinforcements\";\r\nimport { isEmpty } from \"@mongez/supportive-is\";\r\nimport type { LogLevel } from \"@warlock.js/logger\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { BaseValidator, v } from \"@warlock.js/seal\";\r\nimport type { FastifyRequest } from \"fastify\";\r\nimport { type IncomingHttpHeaders } from \"node:http2\";\r\nimport { config } from \"../config/config-getter\";\r\nimport type { Middleware, Route } from \"../router\";\r\nimport { validateAll } from \"../validation/validateAll\";\r\nimport { createRequestStore } from \"./middleware/inject-request-context\";\r\nimport { Response } from \"./response\";\r\nimport type { RequestEvent } from \"./types\";\r\nimport { UploadedFile } from \"./uploaded-file\";\r\n\r\ntype StandardHeaders = {\r\n  // copy every declared property from http.IncomingHttpHeaders\r\n  // but remove index signatures\r\n  [K in keyof IncomingHttpHeaders as string extends K\r\n    ? never\r\n    : number extends K\r\n      ? never\r\n      : K]: IncomingHttpHeaders[K];\r\n};\r\n\r\ntype HeaderKeys = keyof StandardHeaders;\r\n\r\nexport class Request<RequestValidation = any> {\r\n  /**\r\n   * Underlying Fastify request — a public escape hatch to capabilities the\r\n   * framework's high-level helpers don't yet cover.\r\n   *\r\n   * **Prefer framework methods first**: `request.input()`, `request.header()`,\r\n   * `request.body`, `request.query`, `request.params`, `request.file()`,\r\n   * `request.user`, `request.detectIp()`, etc. They handle locale, parsing,\r\n   * trust-proxy, and validation pipeline integration correctly.\r\n   *\r\n   * **Reach for `baseRequest` only** when the framework genuinely lacks a\r\n   * helper for what you need — and when you do, file an issue so we can add\r\n   * it. The escape hatch is the release valve that lets consumers move\r\n   * faster than the framework, but every long-term reach here is a missing\r\n   * helper waiting to be added.\r\n   */\r\n  public baseRequest!: FastifyRequest;\r\n\r\n  /**\r\n   * Response Object\r\n   */\r\n  public response!: Response;\r\n\r\n  /**\r\n   * Route Object\r\n   */\r\n  public route!: Route;\r\n\r\n  /**\r\n   * Parsed Request Payload\r\n   */\r\n  protected payload: any = {};\r\n\r\n  /**\r\n   * Decoded access token payload (set by auth middleware)\r\n   */\r\n  public decodedAccessToken?: any;\r\n\r\n  /**\r\n   * Current request instance\r\n   */\r\n  public static current: Request;\r\n\r\n  /**\r\n   * Translation method\r\n   * Type of it is the same as the type of trans function\r\n   */\r\n  public trans: ReturnType<typeof trans> = trans;\r\n\r\n  /**\r\n   * Alias to trans method\r\n   */\r\n  public t: ReturnType<typeof trans> = trans;\r\n\r\n  /**\r\n   * Dynamic properties index signature\r\n   *\r\n   * This allows attaching custom properties to the request instance,\r\n   * commonly used during validation middleware to attach fetched models.\r\n   *\r\n   * @example\r\n   * // In validation middleware:\r\n   * const post = await Post.find(request.int(\"id\"));\r\n   * if (!post) return response.notFound();\r\n   * request.post = post; // Attach the model to the request\r\n   *\r\n   * // In route handler:\r\n   * const post = request.post;\r\n   * // Work with the pre-fetched model\r\n   */\r\n  [key: string]: any;\r\n\r\n  /**\r\n   * Locale code\r\n   */\r\n  protected _locale = \"\";\r\n\r\n  /**\r\n   * Validated data\r\n   */\r\n  protected validatedData?: RequestValidation;\r\n\r\n  /**\r\n   * Request id\r\n   */\r\n  public id = Random.string(32);\r\n\r\n  /**\r\n   * Start Time\r\n   */\r\n  public startTime = Date.now();\r\n\r\n  /**\r\n   * End Time\r\n   */\r\n  public endTime?: undefined | number;\r\n\r\n  /**\r\n   * Set request handler\r\n   */\r\n  public setRequest(request: FastifyRequest) {\r\n    this.baseRequest = request;\r\n\r\n    this.resolveRequestId();\r\n\r\n    this.parsePayload();\r\n\r\n    const localeCode = this.getLocaleCode();\r\n\r\n    this.trans = this.t = transFrom.bind(null, localeCode);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Inherit `X-Request-Id` from the incoming request, fall back to a custom\r\n   * generator, then to the field-init default (`Random.string(32)`).\r\n   *\r\n   * Inherited values are validated (length cap + printable-ASCII) to prevent\r\n   * log-injection from a malicious client. Disable the whole behavior by\r\n   * setting `http.requestId.enabled = false` — in which case the field-init\r\n   * default is used regardless of any incoming header.\r\n   */\r\n  protected resolveRequestId() {\r\n    const requestIdConfig = config.key(\"http.requestId\") || {};\r\n\r\n    if (requestIdConfig.enabled === false) return;\r\n\r\n    const headerName = (requestIdConfig.header || \"x-request-id\").toLowerCase();\r\n    const incoming = this.baseRequest.headers[headerName];\r\n\r\n    if (Request.isValidRequestId(incoming)) {\r\n      this.id = incoming;\r\n\r\n      return;\r\n    }\r\n\r\n    if (typeof requestIdConfig.generator === \"function\") {\r\n      this.id = requestIdConfig.generator();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Validate a candidate request-id value. Accepts non-empty printable ASCII\r\n   * up to 128 characters — tight enough to reject newline / control-character\r\n   * log-injection, loose enough to accept UUIDs, ULIDs, snowflakes, etc.\r\n   */\r\n  protected static isValidRequestId(value: unknown): value is string {\r\n    return (\r\n      typeof value === \"string\" &&\r\n      value.length > 0 &&\r\n      value.length <= 128 &&\r\n      /^[\\x21-\\x7e]+$/.test(value)\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Translate from the given locale code\r\n   */\r\n  public transFrom(localeCode: string, keyword: string, placeholders?: any) {\r\n    return transFrom(localeCode, keyword, placeholders);\r\n  }\r\n\r\n  /**\r\n   * Get current locale code\r\n   */\r\n  public get locale() {\r\n    if (this._locale) return this._locale;\r\n\r\n    return this.header(\"translation-locale-code\") || this.localized;\r\n  }\r\n\r\n  /**\r\n   * Set locale code\r\n   */\r\n  public set locale(localeCode: string) {\r\n    this._locale = localeCode;\r\n  }\r\n\r\n  /**\r\n   * Get locale code that will be used for translation\r\n   */\r\n  public get localized() {\r\n    if (this._locale) return this._locale;\r\n\r\n    return (this._locale = this.header(\"locale\") || this.query[\"locale\"]);\r\n  }\r\n\r\n  /**\r\n   * Set locale code\r\n   */\r\n  public setLocaleCode(localeCode: string) {\r\n    this._locale = localeCode;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get current locale code or return default locale code\r\n   */\r\n  public getLocaleCode(defaultLocaleCode: string = config.key(\"app.localeCode\") || \"en\") {\r\n    return this.locale || defaultLocaleCode;\r\n  }\r\n\r\n  /**\r\n   * Get http protocol\r\n   */\r\n  public get protocol() {\r\n    return this.baseRequest.protocol;\r\n  }\r\n\r\n  /**\r\n   * Validate the given validation schema\r\n   */\r\n  public async validate(validation: BaseValidator, selectedInputs?: string[]) {\r\n    return await v.validate(validation, selectedInputs ? this.only(selectedInputs) : this.all());\r\n  }\r\n\r\n  /**\r\n   * Clear current user\r\n   */\r\n  public clearCurrentUser() {\r\n    this.user = undefined;\r\n  }\r\n\r\n  /**\r\n   * Get value of the given header\r\n   */\r\n  public header<TCustomHeader extends string = HeaderKeys>(\r\n    name: TCustomHeader | HeaderKeys,\r\n    defaultValue: any = null,\r\n  ) {\r\n    return this.baseRequest.headers[name.toLocaleLowerCase()] ?? defaultValue;\r\n  }\r\n\r\n  /**\r\n   * Get all cookies from the current request\r\n   */\r\n  public get cookies(): Record<string, string | undefined> {\r\n    return this.baseRequest.cookies || {};\r\n  }\r\n\r\n  /**\r\n   * Get a particular cookie value or fallback to default\r\n   */\r\n  public cookie(name: string, defaultValue?: any): string | any {\r\n    const value = this.cookies[name] ?? defaultValue;\r\n\r\n    try {\r\n      return JSON.parse(value);\r\n    } catch (error) {\r\n      return value;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Determine if the request has the specified cookie\r\n   */\r\n  public hasCookie(name: string): boolean {\r\n    return this.cookies[name] !== undefined;\r\n  }\r\n\r\n  /**\r\n   * Get the current request domain\r\n   */\r\n  public get domain() {\r\n    return this.baseRequest.hostname.replace(/^www\\./, \"\");\r\n  }\r\n\r\n  /**\r\n   * Get hostname\r\n   */\r\n  public get hostname() {\r\n    return this.domain;\r\n  }\r\n\r\n  /**\r\n   * Get request origin\r\n   */\r\n  public get origin() {\r\n    return this.baseRequest.headers.origin as string;\r\n  }\r\n\r\n  /**\r\n   * Get the domain of the origin\r\n   */\r\n  public get originDomain() {\r\n    const domain = this.origin ? new URL(this.origin).hostname : null;\r\n\r\n    if (domain?.startsWith(\"www.\")) {\r\n      return domain.replace(/^www\\./, \"\");\r\n    }\r\n\r\n    return domain;\r\n  }\r\n\r\n  /**\r\n   * Get authorization header value\r\n   */\r\n  public get authorizationValue(): string {\r\n    const authorization = this.header(\"authorization\");\r\n\r\n    if (!authorization) return \"\";\r\n\r\n    const [type, value] = authorization.split(\" \");\r\n\r\n    if (![\"bearer\", \"key\"].includes(type.toLowerCase())) return \"\";\r\n\r\n    return value || \"\";\r\n  }\r\n\r\n  /**\r\n   * Get access token from Authorization header\r\n   *\r\n   * If the Authorization header does not start with `Bearer` value then return null\r\n   */\r\n  public get accessToken(): string | undefined {\r\n    const authorization = this.header(\"authorization\");\r\n\r\n    if (!authorization) return;\r\n\r\n    const [type, value] = authorization.split(\" \");\r\n\r\n    if (type.toLowerCase() !== \"bearer\") return;\r\n\r\n    return value;\r\n  }\r\n\r\n  /**\r\n   * Get the authorization header\r\n   */\r\n  public get authorization() {\r\n    return this.header(\"authorization\");\r\n  }\r\n\r\n  /**\r\n   * Get current request method\r\n   */\r\n  public get method(): string {\r\n    return this.baseRequest.method;\r\n  }\r\n\r\n  /**\r\n   * Parse the payload and merge it from the request body, params and query string\r\n   */\r\n  protected parsePayload() {\r\n    this.payload.body = this.parseBody(this.baseRequest.body);\r\n\r\n    this.payload.query = this.parseBody(this.baseRequest.query);\r\n    this.payload.params = { ...(this.baseRequest.params || {}) };\r\n    this.payload.all = {\r\n      ...this.payload.body,\r\n      ...this.payload.query,\r\n      ...this.payload.params,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Parse body payload\r\n   */\r\n  protected parseBody(data: any) {\r\n    try {\r\n      if (!data) return {};\r\n\r\n      const body: any = {};\r\n\r\n      const arrayOfObjectValues: any = {};\r\n\r\n      for (let key in data) {\r\n        const value = data[key];\r\n\r\n        let isArrayKey = false;\r\n\r\n        if (key.endsWith(\"[]\")) {\r\n          isArrayKey = true;\r\n        }\r\n\r\n        key = rtrim(key, \"[]\");\r\n\r\n        // check if the key is has a square brackets, then convert it into object\r\n        // i.e user[email] => user: {email: \"value\"}\r\n        // also check if its an array of objects\r\n\r\n        if (key.includes(\"[\")) {\r\n          // check if its an array of objects\r\n          if (key.includes(\"][\")) {\r\n            const keyParts = key.split(\"[\");\r\n\r\n            const keyName = keyParts[0];\r\n            if (!arrayOfObjectValues[keyName]) {\r\n              arrayOfObjectValues[keyName] = [];\r\n            }\r\n\r\n            const keyNameParts = keyParts[1].split(\"]\");\r\n\r\n            const index = Number(keyNameParts[0]);\r\n\r\n            if (!arrayOfObjectValues[keyName][index]) {\r\n              arrayOfObjectValues[keyName][index] = {};\r\n            }\r\n\r\n            // now get the key after the index\r\n            const keyNameParts2 = keyParts[2].split(\"]\");\r\n            const keyName2 = keyNameParts2[0];\r\n\r\n            arrayOfObjectValues[keyName][index][keyName2] = this.parseValue(value);\r\n\r\n            continue;\r\n          }\r\n\r\n          const keyParts = key.split(\"[\");\r\n          const keyName = keyParts[0];\r\n          const keyNameParts = keyParts[1].split(\"]\");\r\n\r\n          set(\r\n            body,\r\n            keyName + \".\" + keyNameParts[0],\r\n            Array.isArray(value) ? value.map(this.parseValue.bind(this)) : this.parseValue(value),\r\n          );\r\n\r\n          continue;\r\n        }\r\n\r\n        if (Array.isArray(value)) {\r\n          set(body, key, value.map(this.parseValue.bind(this)));\r\n        } else if (isArrayKey) {\r\n          if (body[key]) {\r\n            body[key].push(this.parseValue(value));\r\n          } else {\r\n            body[key] = [this.parseValue(value)];\r\n\r\n            continue;\r\n          }\r\n        } else {\r\n          set(body, key, this.parseValue(value));\r\n        }\r\n      }\r\n\r\n      // now merge the array of objects into the body\r\n      for (const key in arrayOfObjectValues) {\r\n        body[key] = arrayOfObjectValues[key];\r\n      }\r\n\r\n      return body;\r\n    } catch (error) {\r\n      console.log(error);\r\n      this.log(error, \"error\");\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Parse the given data\r\n   */\r\n  protected parseValue(data: any) {\r\n    // data.value appears only in the multipart form data\r\n    // if it json, then just return the data\r\n    if (data?.file) return new UploadedFile(data);\r\n    if (data?.value !== undefined && data?.fields && data?.type) {\r\n      data = data.value;\r\n    }\r\n\r\n    if (data === \"false\") return false;\r\n\r\n    if (data === \"true\") return true;\r\n\r\n    if (data === \"null\") return null;\r\n\r\n    if (typeof data === \"string\") return data.trim();\r\n\r\n    return data;\r\n  }\r\n\r\n  /**\r\n   * Set route handler\r\n   */\r\n  public setRoute(route: Route) {\r\n    this.route = route;\r\n\r\n    // pass the route to the response object\r\n    this.response.setRoute(route);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Trigger an http event\r\n   */\r\n  public trigger(eventName: RequestEvent, ...args: any[]) {\r\n    return events.trigger(`request.${eventName}`, ...args, this);\r\n  }\r\n\r\n  /**\r\n   * Listen to the given event\r\n   */\r\n  public on(eventName: RequestEvent, callback: any) {\r\n    return this.subscribe(eventName, callback);\r\n  }\r\n\r\n  /**\r\n   * Make a log message\r\n   */\r\n  public log(message: any, level: LogLevel = \"info\") {\r\n    if (!config.key(\"http.log\")) return;\r\n\r\n    log.log({\r\n      module: \"request\",\r\n      action: this.route.method + \" \" + this.route.path.replace(\"/*\", \"\") + `:${this.id}`,\r\n      message,\r\n      type: level,\r\n      context: {\r\n        request: this,\r\n      },\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Get current request path\r\n   */\r\n  public get path() {\r\n    return this.baseRequest.url;\r\n  }\r\n\r\n  /**\r\n   * {@alias}\r\n   */\r\n  public get url() {\r\n    return this.baseRequest.url;\r\n  }\r\n\r\n  /**\r\n   * Get full url\r\n   */\r\n  public get fullUrl() {\r\n    return this.protocol + \"://\" + this.hostname + this.path;\r\n  }\r\n\r\n  /**\r\n   * Drive the middleware chain for the current route, then defer to the\r\n   * controller. Returns the first response value any middleware short-circuits\r\n   * with, or `undefined` to continue into validation + handler.\r\n   *\r\n   * @internal Framework orchestration — do not call from app code. Will move\r\n   * to a dedicated controller dispatcher in a future refactor.\r\n   */\r\n  public async runMiddleware() {\r\n    // measure request time\r\n    // check for middleware first\r\n    const middlewareOutput = await this.executeMiddleware();\r\n\r\n    if (middlewareOutput !== undefined) {\r\n      // 👇🏻 make sure first its not a response instance\r\n      if (middlewareOutput instanceof Response) return middlewareOutput;\r\n      // 👇🏻 send the response\r\n      return this.response.send(middlewareOutput);\r\n    }\r\n\r\n    const handler = this.route.handler;\r\n\r\n    if (!handler.validation) return;\r\n\r\n    // 👇🏻 check for validation using validateAll helper function\r\n    const validationOutput = await validateAll(handler.validation, this, this.response);\r\n\r\n    return validationOutput;\r\n  }\r\n\r\n  /**\r\n   * Return the request handler attached to the current route.\r\n   *\r\n   * @internal Framework orchestration — do not call from app code.\r\n   */\r\n  public getHandler() {\r\n    return this.route.handler;\r\n  }\r\n\r\n  /**\r\n   * Get inputs that has been validated only\r\n   * You can also pass an array of inputs to get only the validated inputs\r\n   */\r\n  public validated<Output = RequestValidation>(inputs?: (keyof Output | (string & {}))[]): Output {\r\n    if (this.validatedData) {\r\n      return inputs\r\n        ? only(this.validatedData as Output, inputs as string[])\r\n        : (this.validatedData as Output);\r\n    }\r\n\r\n    return {} as Output;\r\n  }\r\n\r\n  /**\r\n   * Get inputs that has been validated except the given inputs\r\n   */\r\n  public validatedExcept(...inputs: string[]): RequestValidation {\r\n    return except(this.validated(), inputs);\r\n  }\r\n\r\n  /**\r\n   * Set validated data\r\n   */\r\n  public setValidatedData(data: RequestValidation) {\r\n    this.validatedData = data;\r\n  }\r\n\r\n  /**\r\n   * Top-level entry into the request lifecycle — opens the context store,\r\n   * runs middleware, drives the handler, handles errors.\r\n   *\r\n   * @internal Framework orchestration — do not call from app code. Wired\r\n   * from the Fastify route handler in `router.scan()`.\r\n   */\r\n  public async execute() {\r\n    try {\r\n      // call executingAction event\r\n\r\n      this.log(\"Executing the request\");\r\n\r\n      return await createRequestStore(this, this.response);\r\n    } catch (error) {\r\n      this.log(error, \"error\");\r\n\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Iterate the collected middlewares in order; return the first short-circuit\r\n   * value or `undefined` when every middleware passes through.\r\n   *\r\n   * @internal Framework orchestration — do not call from app code.\r\n   */\r\n  protected async executeMiddleware() {\r\n    // collect all middlewares for current route\r\n    const middlewares = this.collectMiddlewares();\r\n\r\n    // check if there are no middlewares, then return\r\n    if (middlewares.length === 0) return;\r\n\r\n    this.log(\"About to execute request middlewares\");\r\n\r\n    // trigger the executingMiddleware event\r\n    this.trigger(\"executingMiddleware\", middlewares, this.route);\r\n\r\n    for (const middleware of middlewares) {\r\n      this.log(\"Executing middleware \" + colors.yellowBright(middleware.name));\r\n      const output = await middleware(this, this.response);\r\n      this.log(\"Executed middleware \" + colors.yellowBright(middleware.name), \"success\");\r\n\r\n      if (output !== undefined) {\r\n        this.log(\r\n          colors.yellow(\"request intercepted by middleware \") + colors.cyanBright(middleware.name),\r\n          \"warn\",\r\n        );\r\n\r\n        this.trigger(\"executedMiddleware\");\r\n\r\n        this.log(\"Request middlewares executed\", \"success\");\r\n\r\n        return output;\r\n      }\r\n    }\r\n\r\n    this.log(\"Request middlewares executed\", \"success\");\r\n\r\n    // trigger the executedMiddleware event\r\n    this.trigger(\"executedMiddleware\", middlewares, this.route);\r\n  }\r\n\r\n  /**\r\n   * Gather the middleware list for the current route — today just the\r\n   * route-level array; future extraction may merge group + app-wide layers.\r\n   *\r\n   * @internal Framework orchestration — do not call from app code.\r\n   */\r\n  protected collectMiddlewares(): Middleware[] {\r\n    const middlewaresList: Middleware[] = [];\r\n\r\n    // collect route middlewares\r\n    if (this.route.middleware) {\r\n      middlewaresList.push(...this.route.middleware);\r\n    }\r\n\r\n    return middlewaresList;\r\n  }\r\n\r\n  /**\r\n   * Get request input value from query string, params or body\r\n   */\r\n  public input(key: string, defaultValue?: any) {\r\n    return get(this.payload.all, key, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Get email input value, this will lowercase the value\r\n   */\r\n  public email(key: string = \"email\", defaultValue: string = \"\"): string {\r\n    return this.input(key, defaultValue)?.toLowerCase() || defaultValue;\r\n  }\r\n\r\n  /**\r\n   * @alias input\r\n   */\r\n  public get(key: string, defaultValue?: any) {\r\n    return this.input(key, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Determine if request has input value\r\n   */\r\n  public has(key: string) {\r\n    return get(this.payload.all, key, undefined) !== undefined;\r\n  }\r\n\r\n  /**\r\n   * Set request input value\r\n   */\r\n  public set(key: string, value: any) {\r\n    set(this.payload.all, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Set the given value if the request does not have the input\r\n   */\r\n  public setDefault(key: string, value: any) {\r\n    if (this.has(key)) return this;\r\n\r\n    set(this.payload.all, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Unset request payload keys\r\n   */\r\n  public unset(...keys: string[]) {\r\n    this.payload.all = unset(this.payload.all, keys);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get request body\r\n   */\r\n  public get body() {\r\n    return this.payload.body;\r\n  }\r\n\r\n  /**\r\n   * Set request body value\r\n   */\r\n  public setBody(key: string, value: any) {\r\n    set(this.payload.body, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get body inputs except files\r\n   */\r\n  public get bodyInputs() {\r\n    const inputs = this.payload.body;\r\n\r\n    const bodyInputs: any = {};\r\n\r\n    for (const key in inputs) {\r\n      const value = inputs[key];\r\n\r\n      if (value.file && value.fieldname) continue;\r\n\r\n      bodyInputs[key] = value;\r\n    }\r\n\r\n    return bodyInputs;\r\n  }\r\n\r\n  /**\r\n   * Get request file in UploadedFile instance\r\n   */\r\n  public file(key: string): UploadedFile | undefined {\r\n    const file = this.input(key);\r\n\r\n    return file;\r\n  }\r\n\r\n  /**\r\n   * Get uploaded files from the request for the given name\r\n   * If the given name is not present in the request, return an empty array\r\n   */\r\n  public files(name: string): UploadedFile[] {\r\n    return this.input(name) || [];\r\n  }\r\n\r\n  /**\r\n   * Get request params\r\n   */\r\n  public get params() {\r\n    return this.payload.params;\r\n  }\r\n\r\n  /**\r\n   * Set request params value\r\n   */\r\n  public setParam(key: string, value: any) {\r\n    set(this.payload.params, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get request query\r\n   */\r\n  public get query() {\r\n    return this.payload.query;\r\n  }\r\n\r\n  /**\r\n   * Set request query value\r\n   */\r\n  public setQuery(key: string, value: any) {\r\n    set(this.payload.query, key, value);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get all inputs\r\n   */\r\n  public all() {\r\n    return this.payload.all;\r\n  }\r\n\r\n  /**\r\n   * Get all inputs except params\r\n   */\r\n  public allExceptParams() {\r\n    return {\r\n      ...this.payload.query,\r\n      ...this.payload.body,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get all heavy inputs except params\r\n   */\r\n  public heavyExceptParams() {\r\n    const inputs = this.allExceptParams();\r\n\r\n    const heavyInputs: any = {};\r\n\r\n    for (const key in inputs) {\r\n      const value = inputs[key];\r\n\r\n      if (isEmpty(value) && value !== null) continue;\r\n\r\n      heavyInputs[key] = value;\r\n    }\r\n\r\n    return heavyInputs;\r\n  }\r\n\r\n  /**\r\n   * Get only heavy inputs, the input with a value\r\n   */\r\n  public heavy() {\r\n    const inputs = this.all();\r\n\r\n    const heavyInputs: any = {};\r\n\r\n    for (const key in inputs) {\r\n      const value = inputs[key];\r\n\r\n      if (isEmpty(value) && value !== null) continue;\r\n\r\n      heavyInputs[key] = value;\r\n    }\r\n\r\n    return heavyInputs;\r\n  }\r\n\r\n  /**\r\n   * Get only the given keys from the request data\r\n   */\r\n  public only(keys: string[]) {\r\n    return only(this.all(), keys);\r\n  }\r\n\r\n  /**\r\n   * Pluck the given keys from the request data\r\n   */\r\n  public pluck(keys: string[]) {\r\n    const data = this.only(keys);\r\n\r\n    this.unset(...keys);\r\n\r\n    return data;\r\n  }\r\n\r\n  /**\r\n   * Get all request inputs except the given keys\r\n   */\r\n  public except(keys: string[]) {\r\n    return except(this.all(), keys);\r\n  }\r\n\r\n  /**\r\n   * Get boolean input value\r\n   */\r\n  public bool(key: string, defaultValue = false) {\r\n    const value = this.input(key, defaultValue);\r\n\r\n    if (value === \"true\") {\r\n      return true;\r\n    }\r\n\r\n    if (value === \"false\") {\r\n      return false;\r\n    }\r\n\r\n    if (value === 0) {\r\n      return false;\r\n    }\r\n\r\n    return Boolean(value);\r\n  }\r\n\r\n  /**\r\n   * Get integer input value\r\n   */\r\n  public int(key: string, defaultValue: number = 0): number | undefined {\r\n    const value = this.input(key, defaultValue);\r\n\r\n    if (!value && value !== 0) return undefined;\r\n\r\n    return parseInt(value);\r\n  }\r\n\r\n  /**\r\n   * Shorthand getter to get id param\r\n   */\r\n  public get idParam() {\r\n    return this.int(\"id\");\r\n  }\r\n\r\n  /**\r\n   * Get string input value\r\n   */\r\n  public string(key: string, defaultValue: string = \"\"): string {\r\n    const value = this.input(key, defaultValue);\r\n\r\n    return String(value);\r\n  }\r\n\r\n  /**\r\n   * Get float input value\r\n   */\r\n  public float(key: string, defaultValue: number = 0): number {\r\n    const value = this.input(key, defaultValue);\r\n\r\n    return parseFloat(value) || 0;\r\n  }\r\n\r\n  /**\r\n   * Get number input value\r\n   */\r\n  public number(key: string, defaultValue: number = 0): number {\r\n    const value = Number(this.input(key, defaultValue));\r\n\r\n    return isNaN(value) ? defaultValue : value;\r\n  }\r\n\r\n  /**\r\n   * Immediate-peer IP as Fastify reports it — the address that connected to\r\n   * the server socket, with `trustProxy` resolution applied. Use this when\r\n   * you specifically need the peer address (rate-limit-by-direct-connection,\r\n   * health-check origin verification).\r\n   *\r\n   * **For most use cases prefer `request.detectIp()`** — behind any proxy\r\n   * (load balancer, CDN, sidecar) `ip` reports the proxy, not the real client.\r\n   */\r\n  public get ip() {\r\n    return this.baseRequest.ip;\r\n  }\r\n\r\n  /**\r\n   * Best-effort real client IP — checks `X-Real-IP` and `X-Forwarded-For`\r\n   * headers first, falls back to `baseRequest.ip` when neither is present.\r\n   *\r\n   * **Prefer this over `request.ip` for any caller behind a proxy** (load\r\n   * balancer, CDN, reverse proxy, k8s ingress). Only trust the result as\r\n   * far as you trust the upstream proxy chain — `X-Forwarded-For` is\r\n   * client-settable; verify the request came through your trusted edge\r\n   * before treating the value as authoritative.\r\n   */\r\n  public detectIp() {\r\n    // as the server maybe used behind a proxy\r\n    // then we need to check first if there is a forwarded ip\r\n    // check for the real-ip header\r\n\r\n    const realIp = this.header(\"x-real-ip\");\r\n\r\n    if (realIp) return realIp;\r\n\r\n    const forwardedIp = this.header(\"x-forwarded-for\");\r\n\r\n    return forwardedIp || this.baseRequest.ip;\r\n  }\r\n\r\n  /**\r\n   * An alias to detectIp\r\n   */\r\n  public get realIp() {\r\n    return this.detectIp();\r\n  }\r\n\r\n  /**\r\n   * Get request ips\r\n   */\r\n  public get ips() {\r\n    return this.baseRequest.ips;\r\n  }\r\n\r\n  /**\r\n   * Get request referer\r\n   */\r\n  public get referer() {\r\n    return this.baseRequest.headers.referer;\r\n  }\r\n\r\n  /**\r\n   * Get user agent\r\n   */\r\n  public get userAgent() {\r\n    return this.baseRequest.headers[\"user-agent\"];\r\n  }\r\n\r\n  /**\r\n   * Get request headers\r\n   */\r\n  public get headers(): typeof this.baseRequest.headers {\r\n    return this.baseRequest.headers;\r\n  }\r\n\r\n  /**\r\n   * Set the given header\r\n   */\r\n  public setHeader(key: HeaderKeys, value: string) {\r\n    this.baseRequest.headers[key.toLowerCase()] = value;\r\n\r\n    return this;\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/http/response.d.mts

@@ -0,0 +1,452 @@
+import { StorageFile } from "../storage/storage-file.mjs";
+import { Request } from "./request.mjs";
+import { ResponseEvent, ResponseSSEController, ResponseStreamController } from "./types.mjs";
+import { Route } from "../router/types.mjs";
+import { ValidationResult } from "@warlock.js/seal";
+import { LogLevel } from "@warlock.js/logger";
+import { EventSubscription } from "@mongez/events";
+import { FastifyReply } from "fastify";
+import { CookieSerializeOptions } from "@fastify/cookie";
+import React from "react";
+
+//#region ../../@warlock.js/core/src/http/response.d.ts
+type CookieValue = string | number | boolean | Record<string, any> | Array<any>;
+/**
+ * Cookie options accepted by `response.cookie()`.
+ *
+ * Extends Fastify's `CookieSerializeOptions` with `raw` — set to `true` to
+ * skip the default `JSON.stringify` of the value and write it as-is. Use for
+ * plain-string cookies (session tokens, opaque IDs) that shouldn't be JSON-quoted.
+ *
+ * When `raw: true`, non-string values are coerced via `String(value)`. The
+ * read side (`request.cookie(name)`) tries `JSON.parse` first and falls back
+ * to the raw string on parse failure, so round-tripping a raw string cookie
+ * Just Works.
+ */
+type CookieOptions = CookieSerializeOptions & {
+  /**
+   * Skip JSON.stringify and write the value as-is.
+   *
+   * @default false
+   */
+  raw?: boolean;
+};
+declare enum ResponseStatus {
+  OK = 200,
+  CREATED = 201,
+  ACCEPTED = 202,
+  MOVED_PERMANENTLY = 301,
+  FOUND = 302,
+  SEE_OTHER = 303,
+  NOT_MODIFIED = 304,
+  TEMPORARY_REDIRECT = 307,
+  PERMANENT_REDIRECT = 308,
+  NO_CONTENT = 204,
+  BAD_REQUEST = 400,
+  UNAUTHORIZED = 401,
+  FORBIDDEN = 403,
+  NOT_FOUND = 404,
+  METHOD_NOT_ALLOWED = 405,
+  CONFLICT = 409,
+  TOO_MANY_REQUESTS = 429,
+  INTERNAL_SERVER_ERROR = 500,
+  SERVICE_UNAVAILABLE = 503
+}
+/**
+ * Options for sending files
+ */
+type SendFileOptions = {
+  cacheTime?: number;
+  immutable?: boolean;
+  inline?: boolean;
+  filename?: string;
+};
+/**
+ * Options for sending buffers
+ */
+type SendBufferOptions = SendFileOptions & {
+  contentType?: string;
+  etag?: string;
+};
+declare class Response {
+  /**
+   * Current route
+   */
+  protected route: Route;
+  /**
+   * Underlying Fastify reply — a public escape hatch to capabilities the
+   * framework's high-level helpers don't yet cover.
+   *
+   * **Prefer framework methods first**: `response.send()`, `response.header()`,
+   * `response.cookie()`, `response.sendFile()`, `response.stream()`, etc.
+   * They wire status codes, content-type detection, the event lifecycle, and
+   * the cache-pattern replay path correctly.
+   *
+   * **Reach for `baseResponse` only** when the framework genuinely lacks a
+   * helper for what you need — and when you do, file an issue so we can add
+   * it. Streaming and SSE are the precedent here: they bypass `send()`
+   * deliberately because the framework didn't ship chunked-write support
+   * natively at the time. Reaching here for non-streaming work means a
+   * missing helper, not an answer.
+   */
+  baseResponse: FastifyReply;
+  /**
+   * Current status code
+   */
+  protected currentStatusCode: number;
+  /**
+   * Current response body
+   */
+  protected currentBody: any;
+  /**
+   * Request object
+   */
+  request: Request;
+  /**
+   * Internal events related to this particular response object
+   */
+  protected events: Map<string, any[]>;
+  /**
+   * Parsed body
+   * This will return the parsed body of the response
+   * Please note that if this property is called before the response is sent, it will return undefined
+   */
+  parsedBody: any;
+  /**
+   * Get raw response
+   */
+  get raw(): import("http").ServerResponse<import("http").IncomingMessage>;
+  /**
+   * Get Current response body
+   */
+  get body(): any;
+  /**
+   * Set response body
+   */
+  set body(body: any);
+  /**
+   * Add event on sending response
+   */
+  onSending(callback: any): this;
+  /**
+   * Add event on sent response
+   */
+  onSent(callback: any): this;
+  /**
+   * Set the Fastify response object
+   */
+  setResponse(response: FastifyReply): this;
+  /**
+   * Reset the response state
+   */
+  reset(): void;
+  /**
+   * Set current route
+   */
+  setRoute(route: Route): this;
+  /**
+   * Get the content type
+   */
+  get contentType(): string | number | string[] | undefined;
+  /**
+   * Set the content type
+   */
+  setContentType(contentType: string): this;
+  /**
+   * Get the status code
+   */
+  get statusCode(): number;
+  /**
+   * Check if response status is ok
+   */
+  get isOk(): boolean;
+  /**
+   * Check if the response has been sent
+   */
+  get sent(): boolean;
+  /**
+   * Add a listener to the response event
+   */
+  static on(event: ResponseEvent, listener: (response: Response) => void): EventSubscription;
+  /**
+   * Trigger the response event
+   */
+  protected static trigger(event: ResponseEvent, ...args: any[]): Promise<unknown>;
+  /**
+   * Parse body
+   */
+  protected parseBody(): Promise<any>;
+  /**
+   * Parse the given value
+   */
+  parse(value: any): Promise<any>;
+  /**
+   * Make a log message
+   */
+  log(message: string, level?: LogLevel): void;
+  /**
+   * Check if returning response is json
+   */
+  get isJson(): boolean;
+  /**
+   * Send the response
+   * @param data - Response data
+   * @param statusCode - HTTP status code
+   * @param triggerEvents - Whether to trigger response events (default: true)
+   */
+  send(data?: any, statusCode?: number, triggerEvents?: boolean): Promise<Response>;
+  /**
+   * Replay a previously-captured response shape — used by cache-pattern
+   * middlewares (idempotency, response cache) to send a cached response
+   * without re-running the controller.
+   *
+   * Preserves the cached status code, content-type, and any extra headers,
+   * then sends the body through the standard `send()` pipeline so the full
+   * event lifecycle still fires (`sent`, `success`, status-specific events).
+   * That keeps cross-cutting observers (logger, metrics, audit) consistent
+   * between fresh and replayed responses.
+   *
+   * @example
+   * // Inside a cache-pattern middleware on HIT:
+   * return response.header("X-Cache", "HIT").replay({
+   *   status: cached.status,
+   *   body: cached.body,
+   *   contentType: cached.contentType,
+   * });
+   */
+  replay(cached: {
+    status: number;
+    body: unknown;
+    contentType?: string;
+    headers?: Record<string, string>;
+  }): Promise<Response>;
+  /**
+   * Send html response
+   */
+  html(data: string, statusCode?: number): Promise<Response>;
+  /**
+   * Render the given react component
+   */
+  render(element: React.ReactElement | React.ComponentType, status?: number): Promise<Response>;
+  /**
+   * Send xml response
+   */
+  xml(data: string, statusCode?: number): Promise<Response>;
+  /**
+   * Send plain text response
+   */
+  text(data: string, statusCode?: number): Promise<Response>;
+  /**
+   * Create a streaming response for progressive/chunked data sending
+   *
+   * This method allows you to send data in chunks and control when the response ends.
+   * Perfect for Server-Sent Events (SSE), progressive rendering, or streaming large responses.
+   *
+   * @example
+   * ```ts
+   * const stream = response.stream("text/html");
+   * stream.send("<html><body>");
+   * stream.send("<h1>Hello</h1>");
+   * stream.render(<MyComponent />);
+   * stream.send("</body></html>");
+   * stream.end();
+   * ```
+   *
+   * @param contentType - The content type for the stream (default: "text/plain")
+   * @returns Stream controller with send(), render(), and end() methods
+   */
+  stream(contentType?: string): ResponseStreamController;
+  /**
+   * Create a Server-Sent Events (SSE) stream
+   *
+   * SSE is a standard for pushing real-time updates from server to client.
+   * Perfect for live notifications, progress updates, or real-time data feeds.
+   *
+   * @example
+   * ```ts
+   * const sse = response.sse();
+   *
+   * // Send events
+   * sse.send("message", { text: "Hello!" });
+   * sse.send("notification", { type: "info", message: "Update available" }, "msg-123");
+   *
+   * // Keep connection alive
+   * const keepAlive = setInterval(() => sse.comment("ping"), 30000);
+   *
+   * // Clean up when done
+   * clearInterval(keepAlive);
+   * sse.end();
+   * ```
+   *
+   * @returns SSE controller with send(), comment(), and end() methods
+   */
+  sse(): ResponseSSEController;
+  /**
+   * Set the status code
+   */
+  setStatusCode(statusCode: number): this;
+  /**
+   * Redirect the user to another route
+   */
+  redirect(url: string, statusCode?: number): this;
+  /**
+   * Permanent redirect
+   */
+  permanentRedirect(url: string): this;
+  /**
+   * Get the response time
+   */
+  getResponseTime(): number;
+  /**
+   * Remove a specific header
+   */
+  removeHeader(key: string): this;
+  /**
+   * Get a specific header
+   */
+  getHeader(key: string): string | number | string[] | undefined;
+  /**
+   * Get the response headers
+   */
+  getHeaders(): Record<import("fastify/types/utils").HttpHeader, string | number | string[] | undefined>;
+  /**
+   * Set multiple headers
+   */
+  headers(headers: Record<string, string>): this;
+  /**
+   * Set the response header
+   */
+  header(key: string, value: any): this;
+  /**
+   * Set a cookie on the response.
+   *
+   * Values are JSON-stringified by default so structured cookies round-trip
+   * cleanly with `request.cookie(name)`. Pass `{ raw: true }` to skip the
+   * JSON wrapping for plain-string cookies (session tokens, opaque IDs).
+   *
+   * @example
+   * // JSON-wrapped (default) — round-trips with request.cookie()
+   * response.cookie("prefs", { theme: "dark" }, { maxAge: 3600, httpOnly: true });
+   *
+   * @example
+   * // Raw string — no JSON quoting; useful for tokens / opaque IDs
+   * response.cookie("session", "abc.def.ghi", { raw: true, httpOnly: true });
+   */
+  cookie(name: string, value: CookieValue, options?: CookieOptions): this;
+  /**
+   * Clear a cookie from the response
+   *
+   * @example
+   * response.clearCookie('token', { path: '/' });
+   */
+  clearCookie(name: string, options?: CookieSerializeOptions): this;
+  /**
+   * Alias to header method
+   */
+  setHeader(key: string, value: any): this;
+  /**
+   * Send an error response with status code 500
+   */
+  serverError(data: any): Promise<Response>;
+  /**
+   * Send a forbidden response with status code 403
+   */
+  forbidden(data?: any): Promise<Response>;
+  /**
+   * Send a service unavailable response with status code 503
+   */
+  serviceUnavailable(data: any): Promise<Response>;
+  /**
+   * Send an unauthorized response with status code 401
+   */
+  unauthorized(data?: any): Promise<Response>;
+  /**
+   * Send a not found response with status code 404
+   */
+  notFound(data?: any): Promise<Response>;
+  /**
+   * Send a bad request response with status code 400
+   */
+  badRequest(data: any): Promise<Response>;
+  /**
+   * Send a content too large response with status code 413
+   */
+  contentTooLarge(data: any): Promise<Response>;
+  /**
+   * Send a success response with status code 201
+   */
+  successCreate(data: any): Promise<Response>;
+  /**
+   * Send a success response
+   */
+  success(data?: any): Promise<Response>;
+  /**
+   * Send a no content response with status code 204
+   */
+  noContent(): FastifyReply<import("fastify").RouteGenericInterface, import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>;
+  /**
+   * Send an accepted response with status code 202
+   * Used for async operations that have been accepted but not yet processed
+   */
+  accepted(data?: any): Promise<Response>;
+  /**
+   * Send a conflict response with status code 409
+   */
+  conflict(data?: any): Promise<Response>;
+  /**
+   * Send a too many requests response with status code 429
+   */
+  tooManyRequests(data: any): Promise<Response>;
+  /**
+   * Send an unprocessable entity response with status code 422
+   * Used for semantic validation errors
+   */
+  unprocessableEntity(data: any): Promise<Response>;
+  /**
+   * Apply response options (cache, disposition, etag)
+   * Shared helper for sendFile and sendBuffer
+   */
+  private applyResponseOptions;
+  /**
+   * Send a file as a response
+   */
+  sendFile(filePath: string | StorageFile, options?: number | SendFileOptions): Promise<Response>;
+  /**
+   * Send buffer as a response
+   * Useful for dynamically generated content (e.g., resized images, generated PDFs)
+   */
+  sendBuffer(buffer: Buffer, options?: number | SendBufferOptions): FastifyReply<import("fastify").RouteGenericInterface, import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, unknown, import("fastify").FastifySchema, import("fastify").FastifyTypeProviderDefault, unknown>;
+  /**
+   * Send an Image instance as a response
+   * Automatically detects image format and sets content type
+   */
+  sendImage(image: any, // Type as 'any' to avoid circular dependency with Image class
+  options?: number | (Omit<SendBufferOptions, "contentType"> & {
+    contentType?: string;
+  })): Promise<never>;
+  /**
+   * Send file and cache it
+   * Cache time in seconds
+   * Cache time will be one year
+   */
+  sendCachedFile(path: string | StorageFile, cacheTime?: number): Promise<Response>;
+  /**
+   * Download the given file path
+   */
+  download(path: string, filename?: string): Promise<Response>;
+  /**
+   * Download the given file path
+   */
+  downloadFile(filePath: string, filename?: string): Promise<Response>;
+  /**
+   * Get content type of the given path
+   */
+  getFileContentType(filePath: string): string;
+  /**
+   * Mark the response as failed
+   */
+  failedSchema(result: ValidationResult): Promise<Response>;
+}
+//#endregion
+export { CookieOptions, Response, ResponseStatus, SendBufferOptions, SendFileOptions };
+//# sourceMappingURL=response.d.mts.map

package/esm/http/response.d.mts.map

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