@venizia/ignis-kernel 0.4.6 → 0.4.7-1

package/dist/esm/base/middlewares/app-error/zod.handler.js

@@ -1,59 +1,62 @@
 import { MessageCode } from '@venizia/ignis-helpers/core';
 import { HTTP } from '@venizia/ignis-helpers/common';
-const DEFAULT_VALIDATION_MESSAGE = 'ValidationError';
-/** Returns a schema-author-supplied code (`issue.params.code`) when it is a non-empty string. */
-const extractIssueCode = (opts) => {
-    const paramsCode = opts.issue?.params?.code;
-    if (typeof paramsCode === 'string' && paramsCode.length > 0) {
-        return paramsCode;
+export class ZodErrorHandler {
+    static { this.DEFAULT_VALIDATION_MESSAGE = 'ValidationError'; }
+    /** Returns a schema-author-supplied code (`issue.params.code`) when it is a non-empty string. */
+    static extractIssueCode(opts) {
+        const paramsCode = opts.issue?.params?.code;
+        if (typeof paramsCode === 'string' && paramsCode.length > 0) {
+            return paramsCode;
+        }
+        return undefined;
     }
-    return undefined;
-};
-/** Formats a ZodError into the 422 validation response. */
-export const formatZodError = (opts) => {
-    const { isProduction, requestId, url, path, error } = opts;
-    const statusCode = HTTP.ResultCodes.RS_4.UnprocessableEntity;
-    let validationErrors;
-    try {
-        validationErrors = JSON.parse(error.message);
-    }
-    catch {
-        validationErrors = error;
-    }
-    const issues = Array.isArray(validationErrors) ? validationErrors : null;
-    // Prefer the first issue with a custom `params.code`, else its raw Zod code.
-    let messageCode;
-    let message = DEFAULT_VALIDATION_MESSAGE;
-    if (issues && issues.length > 0) {
-        const primaryIssue = issues.find((issue) => extractIssueCode({ issue }) !== undefined) ?? issues[0];
-        messageCode = extractIssueCode({ issue: primaryIssue }) ?? primaryIssue.code;
-        message = primaryIssue.message;
-    }
-    // A ZodError we could not parse into issues yields no code of its own; the response still carries one, so no error response is ever missing the field a client branches on.
-    const resolvedMessageCode = MessageCode.resolve(messageCode);
-    return {
-        statusCode,
-        response: {
-            message,
+    /** Formats a ZodError into the 422 validation response. */
+    static formatZodError(opts) {
+        const { isProduction, requestId, url, path, error } = opts;
+        const statusCode = HTTP.ResultCodes.RS_4.UnprocessableEntity;
+        let validationErrors;
+        try {
+            validationErrors = JSON.parse(error.message);
+        }
+        catch {
+            validationErrors = error;
+        }
+        const issues = Array.isArray(validationErrors) ? validationErrors : null;
+        // Prefer the first issue with a custom `params.code`, else its raw Zod code.
+        let messageCode;
+        let message = ZodErrorHandler.DEFAULT_VALIDATION_MESSAGE;
+        if (issues && issues.length > 0) {
+            const primaryIssue = issues.find((issue) => ZodErrorHandler.extractIssueCode({ issue }) !== undefined) ??
+                issues[0];
+            messageCode = ZodErrorHandler.extractIssueCode({ issue: primaryIssue }) ?? primaryIssue.code;
+            message = primaryIssue.message;
+        }
+        // A ZodError we could not parse into issues yields no code of its own; the response still carries one, so no error response is ever missing the field a client branches on.
+        const resolvedMessageCode = MessageCode.resolve(messageCode);
+        return {
             statusCode,
-            // `args` is empty: a Zod issue carries no interpolation values - per-field detail is in `details.cause`.
-            normalized: { text: message, code: resolvedMessageCode, args: {} },
-            requestId,
-            details: {
-                url,
-                path,
-                stack: !isProduction ? error.stack : undefined,
-                cause: issues
-                    ? issues.map((el) => ({
-                        path: el.path.join('.') || 'root',
-                        message: el.message,
-                        code: el.code,
-                        expected: el.expected,
-                        received: el.received,
-                    }))
-                    : validationErrors,
+            response: {
+                message,
+                statusCode,
+                // `args` is empty: a Zod issue carries no interpolation values - per-field detail is in `details.cause`.
+                normalized: { text: message, code: resolvedMessageCode, args: {} },
+                requestId,
+                details: {
+                    url,
+                    path,
+                    stack: !isProduction ? error.stack : undefined,
+                    cause: issues
+                        ? issues.map((el) => ({
+                            path: el.path.join('.') || 'root',
+                            message: el.message,
+                            code: el.code,
+                            expected: el.expected,
+                            received: el.received,
+                        }))
+                        : validationErrors,
+                },
             },
-        },
-    };
-};
+        };
+    }
+}
 //# sourceMappingURL=zod.handler.js.map

package/dist/esm/base/middlewares/app-error/zod.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.handler.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/zod.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAIrD,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;AAErD,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,CAAC,IAA8B,EAAE,EAAE;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC;IAE5C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAM9B,EAAE,EAAE;IACH,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC;IAE7D,IAAI,gBAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAE,gBAAoC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9F,6EAA6E;IAC7E,IAAI,WAA+B,CAAC;IACpC,IAAI,OAAO,GAAG,0BAA0B,CAAC;IAEzC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;QACjF,WAAW,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC;QAC7E,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,4KAA4K;IAC5K,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7D,OAAO;QACL,UAAU;QACV,QAAQ,EAAE;YACR,OAAO;YACP,UAAU;YACV,yGAAyG;YACzG,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,EAAE,EAAE;YAClE,SAAS;YACT,OAAO,EAAE;gBACP,GAAG;gBACH,IAAI;gBACJ,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC9C,KAAK,EAAE,MAAM;oBACX,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;wBAClB,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM;wBACjC,OAAO,EAAE,EAAE,CAAC,OAAO;wBACnB,IAAI,EAAE,EAAE,CAAC,IAAI;wBACb,QAAQ,EAAE,EAAE,CAAC,QAAQ;wBACrB,QAAQ,EAAE,EAAE,CAAC,QAAQ;qBACtB,CAAC,CAAC;oBACL,CAAC,CAAC,gBAAgB;aACrB;SACF;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { MessageCode } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { HTTPResponseError } from 'hono/types';\nimport type { IZodIssueLike } from './common';\n\nconst DEFAULT_VALIDATION_MESSAGE = 'ValidationError';\n\n/** Returns a schema-author-supplied code (`issue.params.code`) when it is a non-empty string. */\nconst extractIssueCode = (opts: { issue: IZodIssueLike }) => {\n  const paramsCode = opts.issue?.params?.code;\n\n  if (typeof paramsCode === 'string' && paramsCode.length > 0) {\n    return paramsCode;\n  }\n\n  return undefined;\n};\n\n/** Formats a ZodError into the 422 validation response. */\nexport const formatZodError = (opts: {\n  isProduction: boolean;\n  requestId: string;\n  url: string;\n  path: string;\n  error: Error | HTTPResponseError;\n}) => {\n  const { isProduction, requestId, url, path, error } = opts;\n  const statusCode = HTTP.ResultCodes.RS_4.UnprocessableEntity;\n\n  let validationErrors: unknown;\n  try {\n    validationErrors = JSON.parse(error.message);\n  } catch {\n    validationErrors = error;\n  }\n\n  const issues = Array.isArray(validationErrors) ? (validationErrors as IZodIssueLike[]) : null;\n\n  // Prefer the first issue with a custom `params.code`, else its raw Zod code.\n  let messageCode: string | undefined;\n  let message = DEFAULT_VALIDATION_MESSAGE;\n\n  if (issues && issues.length > 0) {\n    const primaryIssue =\n      issues.find((issue) => extractIssueCode({ issue }) !== undefined) ?? issues[0];\n    messageCode = extractIssueCode({ issue: primaryIssue }) ?? primaryIssue.code;\n    message = primaryIssue.message;\n  }\n\n  // A ZodError we could not parse into issues yields no code of its own; the response still carries one, so no error response is ever missing the field a client branches on.\n  const resolvedMessageCode = MessageCode.resolve(messageCode);\n\n  return {\n    statusCode,\n    response: {\n      message,\n      statusCode,\n      // `args` is empty: a Zod issue carries no interpolation values - per-field detail is in `details.cause`.\n      normalized: { text: message, code: resolvedMessageCode, args: {} },\n      requestId,\n      details: {\n        url,\n        path,\n        stack: !isProduction ? error.stack : undefined,\n        cause: issues\n          ? issues.map((el) => ({\n              path: el.path.join('.') || 'root',\n              message: el.message,\n              code: el.code,\n              expected: el.expected,\n              received: el.received,\n            }))\n          : validationErrors,\n      },\n    },\n  };\n};\n"]}
+{"version":3,"file":"zod.handler.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/app-error/zod.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAIrD,MAAM,OAAO,eAAe;aACF,+BAA0B,GAAG,iBAAiB,CAAC;IAEvE,iGAAiG;IACzF,MAAM,CAAC,gBAAgB,CAAC,IAA8B;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC;QAE5C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,2DAA2D;IAC3D,MAAM,CAAC,cAAc,CAAC,IAMrB;QACC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,CAAC;QAE7D,IAAI,gBAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB,GAAG,KAAK,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAE,gBAAoC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE9F,6EAA6E;QAC7E,IAAI,WAA+B,CAAC;QACpC,IAAI,OAAO,GAAG,eAAe,CAAC,0BAA0B,CAAC;QAEzD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,GAChB,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;gBACjF,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,WAAW,GAAG,eAAe,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC;YAC7F,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;QACjC,CAAC;QAED,4KAA4K;QAC5K,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE7D,OAAO;YACL,UAAU;YACV,QAAQ,EAAE;gBACR,OAAO;gBACP,UAAU;gBACV,yGAAyG;gBACzG,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,EAAE,EAAE;gBAClE,SAAS;gBACT,OAAO,EAAE;oBACP,GAAG;oBACH,IAAI;oBACJ,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;oBAC9C,KAAK,EAAE,MAAM;wBACX,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;4BAClB,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM;4BACjC,OAAO,EAAE,EAAE,CAAC,OAAO;4BACnB,IAAI,EAAE,EAAE,CAAC,IAAI;4BACb,QAAQ,EAAE,EAAE,CAAC,QAAQ;4BACrB,QAAQ,EAAE,EAAE,CAAC,QAAQ;yBACtB,CAAC,CAAC;wBACL,CAAC,CAAC,gBAAgB;iBACrB;aACF;SACF,CAAC;IACJ,CAAC","sourcesContent":["import { MessageCode } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport type { HTTPResponseError } from 'hono/types';\nimport type { IZodIssueLike } from './common';\n\nexport class ZodErrorHandler {\n  private static readonly DEFAULT_VALIDATION_MESSAGE = 'ValidationError';\n\n  /** Returns a schema-author-supplied code (`issue.params.code`) when it is a non-empty string. */\n  private static extractIssueCode(opts: { issue: IZodIssueLike }) {\n    const paramsCode = opts.issue?.params?.code;\n\n    if (typeof paramsCode === 'string' && paramsCode.length > 0) {\n      return paramsCode;\n    }\n\n    return undefined;\n  }\n\n  /** Formats a ZodError into the 422 validation response. */\n  static formatZodError(opts: {\n    isProduction: boolean;\n    requestId: string;\n    url: string;\n    path: string;\n    error: Error | HTTPResponseError;\n  }) {\n    const { isProduction, requestId, url, path, error } = opts;\n    const statusCode = HTTP.ResultCodes.RS_4.UnprocessableEntity;\n\n    let validationErrors: unknown;\n    try {\n      validationErrors = JSON.parse(error.message);\n    } catch {\n      validationErrors = error;\n    }\n\n    const issues = Array.isArray(validationErrors) ? (validationErrors as IZodIssueLike[]) : null;\n\n    // Prefer the first issue with a custom `params.code`, else its raw Zod code.\n    let messageCode: string | undefined;\n    let message = ZodErrorHandler.DEFAULT_VALIDATION_MESSAGE;\n\n    if (issues && issues.length > 0) {\n      const primaryIssue =\n        issues.find((issue) => ZodErrorHandler.extractIssueCode({ issue }) !== undefined) ??\n        issues[0];\n      messageCode = ZodErrorHandler.extractIssueCode({ issue: primaryIssue }) ?? primaryIssue.code;\n      message = primaryIssue.message;\n    }\n\n    // A ZodError we could not parse into issues yields no code of its own; the response still carries one, so no error response is ever missing the field a client branches on.\n    const resolvedMessageCode = MessageCode.resolve(messageCode);\n\n    return {\n      statusCode,\n      response: {\n        message,\n        statusCode,\n        // `args` is empty: a Zod issue carries no interpolation values - per-field detail is in `details.cause`.\n        normalized: { text: message, code: resolvedMessageCode, args: {} },\n        requestId,\n        details: {\n          url,\n          path,\n          stack: !isProduction ? error.stack : undefined,\n          cause: issues\n            ? issues.map((el) => ({\n                path: el.path.join('.') || 'root',\n                message: el.message,\n                code: el.code,\n                expected: el.expected,\n                received: el.received,\n              }))\n            : validationErrors,\n        },\n      },\n    };\n  }\n}\n"]}

package/dist/esm/base/middlewares/emoji-favicon/emoji-favicon.middleware.d.ts

@@ -1,6 +1,8 @@
 import type { MiddlewareHandler } from 'hono';
-/** Serves an emoji as an SVG favicon on /favicon.ico. */
-export declare const emojiFavicon: (opts: {
-    icon: string;
-}) => MiddlewareHandler;
+export declare class EmojiFaviconMiddleware {
+    /** Serves an emoji as an SVG favicon on /favicon.ico. */
+    static create(opts: {
+        icon: string;
+    }): MiddlewareHandler;
+}
 //# sourceMappingURL=emoji-favicon.middleware.d.ts.map

package/dist/esm/base/middlewares/emoji-favicon/emoji-favicon.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emoji-favicon.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/emoji-favicon/emoji-favicon.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,yDAAyD;AACzD,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,iBAerD,CAAC"}
+{"version":3,"file":"emoji-favicon.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/emoji-favicon/emoji-favicon.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG9C,qBAAa,sBAAsB;IACjC,yDAAyD;IACzD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB;CAgBzD"}

package/dist/esm/base/middlewares/emoji-favicon/emoji-favicon.middleware.js

@@ -1,14 +1,16 @@
 import { createMiddleware } from 'hono/factory';
-/** Serves an emoji as an SVG favicon on /favicon.ico. */
-export const emojiFavicon = (opts) => {
-    const { icon } = opts;
-    const mw = createMiddleware(async (context, next) => {
-        if (context.req.path !== '/favicon.ico') {
-            return next();
-        }
-        context.res.headers.set('content-type', 'image/svg+xml');
-        return context.body(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" x="-0.1em" font-size="90">${icon}</text></svg>`);
-    });
-    return mw;
-};
+export class EmojiFaviconMiddleware {
+    /** Serves an emoji as an SVG favicon on /favicon.ico. */
+    static create(opts) {
+        const { icon } = opts;
+        const mw = createMiddleware(async (context, next) => {
+            if (context.req.path !== '/favicon.ico') {
+                return next();
+            }
+            context.res.headers.set('content-type', 'image/svg+xml');
+            return context.body(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><text y=".9em" x="-0.1em" font-size="90">${icon}</text></svg>`);
+        });
+        return mw;
+    }
+}
 //# sourceMappingURL=emoji-favicon.middleware.js.map

package/dist/esm/base/middlewares/emoji-favicon/emoji-favicon.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"emoji-favicon.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/emoji-favicon/emoji-favicon.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAsB,EAAqB,EAAE;IACxE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAEtB,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAClD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACxC,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,IAAI,CACjB,0GAA0G,IAAI,eAAe,CAC9H,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC","sourcesContent":["import type { MiddlewareHandler } from 'hono';\nimport { createMiddleware } from 'hono/factory';\n\n/** Serves an emoji as an SVG favicon on /favicon.ico. */\nexport const emojiFavicon = (opts: { icon: string }): MiddlewareHandler => {\n  const { icon } = opts;\n\n  const mw = createMiddleware(async (context, next) => {\n    if (context.req.path !== '/favicon.ico') {\n      return next();\n    }\n\n    context.res.headers.set('content-type', 'image/svg+xml');\n    return context.body(\n      `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 100 100\"><text y=\".9em\" x=\"-0.1em\" font-size=\"90\">${icon}</text></svg>`,\n    );\n  });\n\n  return mw;\n};\n"]}
+{"version":3,"file":"emoji-favicon.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/emoji-favicon/emoji-favicon.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,OAAO,sBAAsB;IACjC,yDAAyD;IACzD,MAAM,CAAC,MAAM,CAAC,IAAsB;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAClD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACxC,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,IAAI,CACjB,0GAA0G,IAAI,eAAe,CAC9H,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC;IACZ,CAAC;CACF","sourcesContent":["import type { MiddlewareHandler } from 'hono';\nimport { createMiddleware } from 'hono/factory';\n\nexport class EmojiFaviconMiddleware {\n  /** Serves an emoji as an SVG favicon on /favicon.ico. */\n  static create(opts: { icon: string }): MiddlewareHandler {\n    const { icon } = opts;\n\n    const mw = createMiddleware(async (context, next) => {\n      if (context.req.path !== '/favicon.ico') {\n        return next();\n      }\n\n      context.res.headers.set('content-type', 'image/svg+xml');\n      return context.body(\n        `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 100 100\"><text y=\".9em\" x=\"-0.1em\" font-size=\"90\">${icon}</text></svg>`,\n      );\n    });\n\n    return mw;\n  }\n}\n"]}

package/dist/esm/base/middlewares/form-body/form-body.middleware.d.ts

@@ -1,12 +1,16 @@
-import type { MiddlewareHandler } from 'hono/types';
-/** Whether a route declares a form body, so its validator will parse one. */
-export declare const hasFormBody: (opts: {
-    content?: Record<string, unknown>;
-}) => boolean;
-/**
- * Parses a declared form body just ahead of the route's validator, which reads the cached result.
- * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own
- * text and no code; read here, it is `core.request.body_malformed`.
- */
-export declare const formBodyReader: MiddlewareHandler;
+import type { Context, Next } from 'hono';
+export declare class FormBodyMiddleware {
+    private static readonly FORM_CONTENT_TYPES;
+    /** Whether a route declares a form body, so its validator will parse one. */
+    static hasFormBody(opts: {
+        content?: Record<string, unknown>;
+    }): boolean;
+    /**
+     * Parses a declared form body just ahead of the route's validator, which reads the cached result.
+     * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own
+     * text and no code; read here, it is `core.request.body_malformed`. Mounted as a Hono middleware
+     * handler (`FormBodyMiddleware.read`), so it never reads `this`.
+     */
+    static read(context: Context, next: Next): Promise<void>;
+}
 //# sourceMappingURL=form-body.middleware.d.ts.map

package/dist/esm/base/middlewares/form-body/form-body.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-body.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/form-body/form-body.middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOpD,6EAA6E;AAC7E,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAG,OAGzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,iBAQ5B,CAAC"}
+{"version":3,"file":"form-body.middleware.d.ts","sourceRoot":"","sources":["../../../../../src/base/middlewares/form-body/form-body.middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAGxC;IAEF,6EAA6E;IAC7E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO;IAQxE;;;;;OAKG;WACU,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/D"}

package/dist/esm/base/middlewares/form-body/form-body.middleware.js

@@ -1,24 +1,28 @@
 import { HTTP } from '@venizia/ignis-helpers/common';
-import { readFormBody } from '@venizia/ignis-helpers/core';
-const FORM_CONTENT_TYPES = [
-    HTTP.HeaderValues.MULTIPART_FORM_DATA,
-    HTTP.HeaderValues.APPLICATION_FORM_URLENCODED,
-];
-/** Whether a route declares a form body, so its validator will parse one. */
-export const hasFormBody = (opts) => {
-    const { content } = opts;
-    return content !== undefined && FORM_CONTENT_TYPES.some((contentType) => contentType in content);
-};
-/**
- * Parses a declared form body just ahead of the route's validator, which reads the cached result.
- * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own
- * text and no code; read here, it is `core.request.body_malformed`.
- */
-export const formBodyReader = async (context, next) => {
-    const contentType = context.req.header(HTTP.Headers.CONTENT_TYPE) ?? '';
-    if (FORM_CONTENT_TYPES.some((formType) => contentType.includes(formType))) {
-        await readFormBody({ req: context.req });
+import { FormBodyUtility } from '@venizia/ignis-helpers/core';
+export class FormBodyMiddleware {
+    static { this.FORM_CONTENT_TYPES = [
+        HTTP.HeaderValues.MULTIPART_FORM_DATA,
+        HTTP.HeaderValues.APPLICATION_FORM_URLENCODED,
+    ]; }
+    /** Whether a route declares a form body, so its validator will parse one. */
+    static hasFormBody(opts) {
+        const { content } = opts;
+        return (content !== undefined &&
+            FormBodyMiddleware.FORM_CONTENT_TYPES.some((contentType) => contentType in content));
     }
-    await next();
-};
+    /**
+     * Parses a declared form body just ahead of the route's validator, which reads the cached result.
+     * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own
+     * text and no code; read here, it is `core.request.body_malformed`. Mounted as a Hono middleware
+     * handler (`FormBodyMiddleware.read`), so it never reads `this`.
+     */
+    static async read(context, next) {
+        const contentType = context.req.header(HTTP.Headers.CONTENT_TYPE) ?? '';
+        if (FormBodyMiddleware.FORM_CONTENT_TYPES.some((formType) => contentType.includes(formType))) {
+            await FormBodyUtility.readFormBody({ req: context.req });
+        }
+        await next();
+    }
+}
 //# sourceMappingURL=form-body.middleware.js.map

package/dist/esm/base/middlewares/form-body/form-body.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-body.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/form-body/form-body.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,MAAM,kBAAkB,GAAG;IACzB,IAAI,CAAC,YAAY,CAAC,mBAAmB;IACrC,IAAI,CAAC,YAAY,CAAC,2BAA2B;CAC9C,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAA2C,EAAW,EAAE;IAClF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzB,OAAO,OAAO,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC;AACnG,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IACvE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAExE,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,EAAE,CAAC;AACf,CAAC,CAAC","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { readFormBody } from '@venizia/ignis-helpers/core';\nimport type { MiddlewareHandler } from 'hono/types';\n\nconst FORM_CONTENT_TYPES = [\n  HTTP.HeaderValues.MULTIPART_FORM_DATA,\n  HTTP.HeaderValues.APPLICATION_FORM_URLENCODED,\n];\n\n/** Whether a route declares a form body, so its validator will parse one. */\nexport const hasFormBody = (opts: { content?: Record<string, unknown> }): boolean => {\n  const { content } = opts;\n  return content !== undefined && FORM_CONTENT_TYPES.some((contentType) => contentType in content);\n};\n\n/**\n * Parses a declared form body just ahead of the route's validator, which reads the cached result.\n * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own\n * text and no code; read here, it is `core.request.body_malformed`.\n */\nexport const formBodyReader: MiddlewareHandler = async (context, next) => {\n  const contentType = context.req.header(HTTP.Headers.CONTENT_TYPE) ?? '';\n\n  if (FORM_CONTENT_TYPES.some((formType) => contentType.includes(formType))) {\n    await readFormBody({ req: context.req });\n  }\n\n  await next();\n};\n"]}
+{"version":3,"file":"form-body.middleware.js","sourceRoot":"","sources":["../../../../../src/base/middlewares/form-body/form-body.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,MAAM,OAAO,kBAAkB;aACL,uBAAkB,GAAG;QAC3C,IAAI,CAAC,YAAY,CAAC,mBAAmB;QACrC,IAAI,CAAC,YAAY,CAAC,2BAA2B;KAC9C,CAAC;IAEF,6EAA6E;IAC7E,MAAM,CAAC,WAAW,CAAC,IAA2C;QAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,OAAO,CACL,OAAO,KAAK,SAAS;YACrB,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,OAAO,CAAC,CACpF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAgB,EAAE,IAAU;QAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAExE,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC7F,MAAM,eAAe,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC","sourcesContent":["import { HTTP } from '@venizia/ignis-helpers/common';\nimport { FormBodyUtility } from '@venizia/ignis-helpers/core';\nimport type { Context, Next } from 'hono';\n\nexport class FormBodyMiddleware {\n  private static readonly FORM_CONTENT_TYPES = [\n    HTTP.HeaderValues.MULTIPART_FORM_DATA,\n    HTTP.HeaderValues.APPLICATION_FORM_URLENCODED,\n  ];\n\n  /** Whether a route declares a form body, so its validator will parse one. */\n  static hasFormBody(opts: { content?: Record<string, unknown> }): boolean {\n    const { content } = opts;\n    return (\n      content !== undefined &&\n      FormBodyMiddleware.FORM_CONTENT_TYPES.some((contentType) => contentType in content)\n    );\n  }\n\n  /**\n   * Parses a declared form body just ahead of the route's validator, which reads the cached result.\n   * Left to the validator, a malformed body is a bare `HTTPException(400)` carrying the parser's own\n   * text and no code; read here, it is `core.request.body_malformed`. Mounted as a Hono middleware\n   * handler (`FormBodyMiddleware.read`), so it never reads `this`.\n   */\n  static async read(context: Context, next: Next): Promise<void> {\n    const contentType = context.req.header(HTTP.Headers.CONTENT_TYPE) ?? '';\n\n    if (FormBodyMiddleware.FORM_CONTENT_TYPES.some((formType) => contentType.includes(formType))) {\n      await FormBodyUtility.readFormBody({ req: context.req });\n    }\n\n    await next();\n  }\n}\n"]}

package/dist/esm/base/models/common/schemas.d.ts

@@ -17,69 +17,21 @@ export declare const ErrorSchema: z.ZodObject<{
     details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, z.core.$strip>;
 export type TErrorResponse = z.infer<typeof ErrorSchema>;
-export declare const idParamsSchema: (opts?: {
-    idType: TIdSchemaType;
-}) => z.ZodObject<{
-    id: z.ZodNumber;
-}, z.core.$strip> | z.ZodObject<{
-    id: z.ZodString;
-}, z.core.$strip>;
-export declare const jsonContent: <T extends z.ZodType>(opts: {
-    schema: T;
-    description: string;
-    required?: boolean;
-}) => {
-    description: string;
-    content: {
-        'application/json': {
-            schema: T;
-        };
-    };
-    required: boolean | undefined;
-};
-/** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
-export declare const errorResponses: () => {
-    '4XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-    '5XX': {
-        description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
-            };
-        };
-        required: boolean | undefined;
-    };
-};
+/** OpenAPI schema builders for the parts of a route that every controller repeats. */
+export declare class OpenApiSchemas {
+    static idParams(opts?: {
+        idType: TIdSchemaType;
+    }): z.ZodObject<{
+        id: z.ZodNumber;
+    }, z.core.$strip> | z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+    static requiredString(opts?: {
+        min?: number;
+        max?: number;
+        fixed?: number;
+    }): z.ZodString;
+}
 /** OpenAPI Header Object format */
 type THeaderObject = {
     description?: string;
@@ -96,65 +48,192 @@ type TJsonResponseOpts<T extends z.ZodType, H extends TResponseHeaders | undefin
     required?: boolean;
     headers?: H;
 };
-export declare const jsonResponse: <ContentSchema extends z.ZodType, HeaderSchema extends TResponseHeaders | undefined = undefined>(opts: TJsonResponseOpts<ContentSchema, HeaderSchema>) => {
-    '4XX': {
+/** OpenAPI response builders: the JSON and HTML bodies of a route, and the error bodies every route shares. */
+export declare class OpenApiResponses {
+    /** Creates HTML content configuration for OpenAPI documentation. */
+    static htmlContent(opts: {
+        description: string;
+        required?: boolean;
+    }): {
         description: string;
         content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
+            'text/html': {
+                schema: z.ZodString;
             };
         };
-        required: boolean | undefined;
+        required: boolean;
     };
-    '5XX': {
+    /** Creates HTML response configuration for OpenAPI documentation. */
+    static htmlResponse(opts: {
         description: string;
-        content: {
-            'application/json': {
-                schema: z.ZodObject<{
-                    statusCode: z.ZodOptional<z.ZodNumber>;
-                    message: z.ZodString;
-                    normalized: z.ZodOptional<z.ZodObject<{
-                        text: z.ZodString;
-                        code: z.ZodString;
-                        args: z.ZodRecord<z.ZodString, z.ZodAny>;
-                    }, z.core.$strip>>;
-                    extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                    requestId: z.ZodOptional<z.ZodString>;
-                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-                }, z.core.$strip>;
+        required?: boolean;
+    }): {
+        '4XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
             };
+            required: boolean | undefined;
+        };
+        '5XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
+            };
+            required: boolean | undefined;
+        };
+        200: {
+            description: string;
+            content: {
+                'text/html': {
+                    schema: z.ZodString;
+                };
+            };
+            required: boolean;
         };
-        required: boolean | undefined;
     };
-    200: {
+    static jsonContent<T extends z.ZodType>(opts: {
+        schema: T;
+        description: string;
+        required?: boolean;
+    }): {
         description: string;
         content: {
             'application/json': {
-                schema: ContentSchema;
+                schema: T;
             };
         };
         required: boolean | undefined;
-    } | {
-        headers: NonNullable<HeaderSchema>;
-        description: string;
-        content: {
-            'application/json': {
-                schema: ContentSchema;
+    };
+    /** The JSON error body of a route, under `4XX` and `5XX` - the range keys OpenAPI accepts. */
+    static errorResponses(): {
+        '4XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
             };
+            required: boolean | undefined;
+        };
+        '5XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
+            };
+            required: boolean | undefined;
         };
-        required: boolean | undefined;
     };
-};
+    static jsonResponse<ContentSchema extends z.ZodType, HeaderSchema extends TResponseHeaders | undefined = undefined>(opts: TJsonResponseOpts<ContentSchema, HeaderSchema>): {
+        '4XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
+            };
+            required: boolean | undefined;
+        };
+        '5XX': {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: z.ZodObject<{
+                        statusCode: z.ZodOptional<z.ZodNumber>;
+                        message: z.ZodString;
+                        normalized: z.ZodOptional<z.ZodObject<{
+                            text: z.ZodString;
+                            code: z.ZodString;
+                            args: z.ZodRecord<z.ZodString, z.ZodAny>;
+                        }, z.core.$strip>>;
+                        extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                        requestId: z.ZodOptional<z.ZodString>;
+                        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+                    }, z.core.$strip>;
+                };
+            };
+            required: boolean | undefined;
+        };
+        200: {
+            description: string;
+            content: {
+                'application/json': {
+                    schema: ContentSchema;
+                };
+            };
+            required: boolean | undefined;
+        } | {
+            headers: NonNullable<HeaderSchema>;
+            description: string;
+            content: {
+                'application/json': {
+                    schema: ContentSchema;
+                };
+            };
+            required: boolean | undefined;
+        };
+    };
+}
 export {};
 //# sourceMappingURL=schemas.d.ts.map