hono-takibi 0.9.75 → 0.9.77

package/README.md

@@ -75,7 +75,9 @@ export const getRoute = createRoute({
       description: 'OK',
       content: {
         'application/json': {
-          schema: z.object({ message: z.string().openapi({ example: 'Hono Takibi🔥' }) }),
+          schema: z
+            .object({ message: z.string().openapi({ example: 'Hono Takibi🔥' }) })
+            .openapi({ required: ['message'] }),
         },
       },
     },
@@ -105,6 +107,7 @@ Options:
   --export-examples           export examples
   --export-links              export links
   --export-callbacks          export callbacks
+  --readonly                  make schemas immutable (adds .readonly() and 'as const')
   --template                  generate app file and handler stubs
   --test                      generate empty *.test.ts files
   --base-path <path>          api prefix (default: /)
@@ -133,6 +136,7 @@ export default defineConfig({
   input: 'openapi.yaml',
   'zod-openapi': {
     output: './src/index.ts',
+    readonly: true,
     exportSchemas: true,
     exportSchemasTypes: true,
     exportParameters: true,

package/dist/cli/index.js

@@ -39,6 +39,7 @@ Options:
   --export-examples           export examples
   --export-links              export links
   --export-callbacks          export callbacks
+  --readonly                  make schemas immutable (adds .readonly() and 'as const')
   --template                  generate app file and handler stubs
   --test                      generate empty *.test.ts files
   --base-path <path>          api prefix (default: /)
@@ -128,6 +129,7 @@ function parseCli(args) {
             test: args.includes('--test'),
             basePath: getFlagValue(args, '--base-path') ?? '/', // default: /
             componentsOptions: {
+                readonly: args.includes('--readonly'),
                 exportSchemas: args.includes('--export-schemas'),
                 exportSchemasTypes: args.includes('--export-schemas-types'),
                 exportParameters: args.includes('--export-parameters'),
@@ -176,6 +178,7 @@ export async function honoTakibi() {
     const [takibiResult, schemaResult, parameterResult, headersResult, examplesResult, linksResult, callbacksResult, securitySchemesResult, requestBodiesResult, responsesResult, routeResult, typeResult, rpcResult,] = await Promise.all([
         config['zod-openapi']?.output
             ? takibi(openAPI, config['zod-openapi'].output, false, false, '/', {
+                readonly: config['zod-openapi'].readonly,
                 exportSchemasTypes: config['zod-openapi'].exportSchemasTypes ?? false,
                 exportSchemas: config['zod-openapi'].exportSchemas ?? false,
                 exportParametersTypes: config['zod-openapi'].exportParametersTypes ?? false,
@@ -191,38 +194,40 @@ export async function honoTakibi() {
             })
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.schemas
-            ? schemas(openAPI.components?.schemas, config['zod-openapi']?.components?.schemas?.output, config['zod-openapi']?.components?.schemas?.split ?? false, config['zod-openapi']?.components?.schemas?.exportTypes ?? false)
+            ? schemas(openAPI.components?.schemas, config['zod-openapi']?.components?.schemas?.output, config['zod-openapi']?.components?.schemas?.split ?? false, config['zod-openapi']?.components?.schemas?.exportTypes ?? false, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.parameters
-            ? parameters(openAPI.components?.parameters, config['zod-openapi']?.components?.parameters?.output, config['zod-openapi']?.components?.parameters?.split ?? false, config['zod-openapi']?.components?.parameters?.exportTypes ?? false, config['zod-openapi']?.components)
+            ? parameters(openAPI.components?.parameters, config['zod-openapi']?.components?.parameters?.output, config['zod-openapi']?.components?.parameters?.split ?? false, config['zod-openapi']?.components?.parameters?.exportTypes ?? false, config['zod-openapi']?.components, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.headers
-            ? headers(openAPI.components?.headers, config['zod-openapi']?.components?.headers?.output, config['zod-openapi']?.components?.headers?.split ?? false, config['zod-openapi']?.components?.headers?.exportTypes ?? false, config['zod-openapi']?.components)
+            ? headers(openAPI.components?.headers, config['zod-openapi']?.components?.headers?.output, config['zod-openapi']?.components?.headers?.split ?? false, config['zod-openapi']?.components?.headers?.exportTypes ?? false, config['zod-openapi']?.components, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.examples
-            ? examples(openAPI.components?.examples, config['zod-openapi']?.components?.examples?.output, config['zod-openapi']?.components?.examples?.split ?? false)
+            ? examples(openAPI.components?.examples, config['zod-openapi']?.components?.examples?.output, config['zod-openapi']?.components?.examples?.split ?? false, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.links
-            ? links(openAPI.components?.links, config['zod-openapi']?.components?.links?.output, config['zod-openapi']?.components?.links?.split ?? false)
+            ? links(openAPI.components?.links, config['zod-openapi']?.components?.links?.output, config['zod-openapi']?.components?.links?.split ?? false, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.callbacks
-            ? callbacks(openAPI.components?.callbacks, config['zod-openapi']?.components?.callbacks?.output, config['zod-openapi']?.components?.callbacks?.split ?? false)
+            ? callbacks(openAPI.components?.callbacks, config['zod-openapi']?.components?.callbacks?.output, config['zod-openapi']?.components?.callbacks?.split ?? false, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.securitySchemes
-            ? securitySchemes(openAPI.components?.securitySchemes, config['zod-openapi']?.components?.securitySchemes?.output, config['zod-openapi']?.components?.securitySchemes?.split ?? false)
+            ? securitySchemes(openAPI.components?.securitySchemes, config['zod-openapi']?.components?.securitySchemes?.output, config['zod-openapi']?.components?.securitySchemes?.split ?? false, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.requestBodies
-            ? requestBodies(openAPI.components?.requestBodies, config['zod-openapi']?.components?.requestBodies?.output, config['zod-openapi']?.components?.requestBodies?.split ?? false, config['zod-openapi']?.components)
+            ? requestBodies(openAPI.components?.requestBodies, config['zod-openapi']?.components?.requestBodies?.output, config['zod-openapi']?.components?.requestBodies?.split ?? false, config['zod-openapi']?.components, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.components?.responses
-            ? responses(openAPI.components?.responses, config['zod-openapi']?.components?.responses?.output, config['zod-openapi']?.components?.responses?.split ?? false, config['zod-openapi']?.components)
+            ? responses(openAPI.components?.responses, config['zod-openapi']?.components?.responses?.output, config['zod-openapi']?.components?.responses?.split ?? false, config['zod-openapi']?.components, config['zod-openapi']?.readonly)
             : Promise.resolve(undefined),
         config['zod-openapi']?.routes
-            ? route(openAPI, config['zod-openapi'].routes, config['zod-openapi'].components)
+            ? route(openAPI, config['zod-openapi'].routes, config['zod-openapi'].components, config['zod-openapi']?.readonly)
+            : Promise.resolve(undefined),
+        config.type
+            ? type(openAPI, config.type.output, config.type.readonly)
             : Promise.resolve(undefined),
-        config.type ? type(openAPI, config.type.output) : Promise.resolve(undefined),
         config.rpc
-            ? rpc(openAPI, config.rpc.output, config.rpc.import, config.rpc.split ?? false)
+            ? rpc(openAPI, config.rpc.output, config.rpc.import, config.rpc.split ?? false, config.rpc.client ?? 'client')
             : Promise.resolve(undefined),
     ]);
     if (takibiResult && !takibiResult.ok)

package/dist/config/index.d.ts

@@ -2,6 +2,7 @@ type Config = {
     readonly input: `${string}.yaml` | `${string}.json` | `${string}.tsp`;
     readonly 'zod-openapi'?: {
         readonly output?: `${string}.ts`;
+        readonly readonly?: boolean;
         readonly exportSchemas?: boolean;
         readonly exportSchemasTypes?: boolean;
         readonly exportParameters?: boolean;
@@ -70,12 +71,14 @@ type Config = {
         };
     };
     readonly type?: {
+        readonly readonly?: boolean;
         readonly output: `${string}.ts`;
     };
     readonly rpc?: {
         readonly output: string | `${string}.ts`;
         readonly import: string;
         readonly split?: boolean;
+        readonly client?: string;
     };
 };
 /**

package/dist/config/index.js

@@ -54,6 +54,13 @@ export function parseConfig(config) {
     }
     // zod-openapi
     if (config['zod-openapi'] !== undefined) {
+        if (config['zod-openapi'].readonly !== undefined &&
+            typeof config['zod-openapi'].readonly !== 'boolean') {
+            return {
+                ok: false,
+                error: `Invalid readonly format for zod-openapi: ${String(config['zod-openapi'].readonly)}`,
+            };
+        }
         if (config['zod-openapi'].exportSchemasTypes !== undefined &&
             typeof config['zod-openapi'].exportSchemasTypes !== 'boolean') {
             return {
@@ -192,6 +199,9 @@ export function parseConfig(config) {
         if (config.rpc.split !== undefined && typeof config.rpc.split !== 'boolean') {
             return { ok: false, error: `Invalid split format for rpc: ${String(config.rpc.split)}` };
         }
+        if (config.rpc.client !== undefined && typeof config.rpc.client !== 'string') {
+            return { ok: false, error: `Invalid client format for rpc: ${String(config.rpc.client)}` };
+        }
         // split: true requires directory (no .ts)
         if (config.rpc.split === true && isTs(config.rpc.output)) {
             return {

package/dist/core/components/callbacks.d.ts

@@ -5,6 +5,7 @@ import type { Components } from '../../openapi/index.js';
  * @param callbacks - OpenAPI callbacks object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -25,7 +26,7 @@ import type { Components } from '../../openapi/index.js';
  * // Creates: src/callbacks/onPaymentComplete.ts, src/callbacks/onOrderUpdate.ts, src/callbacks/index.ts
  * ```
  */
-export declare function callbacks(callbacks: Components['callbacks'], output: string, split: boolean): Promise<{
+export declare function callbacks(callbacks: Components['callbacks'], output: string, split: boolean, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/callbacks.js

@@ -15,6 +15,7 @@ import { core, makeExports } from '../../helper/index.js';
  * @param callbacks - OpenAPI callbacks object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -35,19 +36,19 @@ import { core, makeExports } from '../../helper/index.js';
  * // Creates: src/callbacks/onPaymentComplete.ts, src/callbacks/onOrderUpdate.ts, src/callbacks/index.ts
  * ```
  */
-export async function callbacks(callbacks, output, split) {
+export async function callbacks(callbacks, output, split, readonly) {
     if (!callbacks)
         return { ok: false, error: 'No callbacks found' };
     const keys = Object.keys(callbacks);
     if (keys.length === 0)
         return { ok: true, value: 'No callbacks found' };
     if (split) {
-        const exportsResult = await makeExports(callbacks, 'Callback', output);
+        const exportsResult = await makeExports(callbacks, 'Callback', output, readonly);
         if (!exportsResult.ok)
             return { ok: false, error: exportsResult.error };
         return { ok: true, value: exportsResult.value };
     }
-    const code = makeExportConst(callbacks, 'Callback');
+    const code = makeExportConst(callbacks, 'Callback', readonly);
     const coreResult = await core(code, path.dirname(output), output);
     if (!coreResult.ok)
         return { ok: false, error: coreResult.error };

package/dist/core/components/examples.d.ts

@@ -5,6 +5,7 @@ import type { Components } from '../../openapi/index.js';
  * @param examples - OpenAPI examples object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -25,7 +26,7 @@ import type { Components } from '../../openapi/index.js';
  * // Creates: src/examples/userExample.ts, src/examples/postExample.ts, src/examples/index.ts
  * ```
  */
-export declare function examples(examples: Components['examples'], output: string, split: boolean): Promise<{
+export declare function examples(examples: Components['examples'], output: string, split: boolean, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/examples.js

@@ -23,6 +23,7 @@ const hasRef = (val) => typeof val === 'object' && val !== null && '$ref' in val
  * @param examples - OpenAPI examples object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -43,12 +44,13 @@ const hasRef = (val) => typeof val === 'object' && val !== null && '$ref' in val
  * // Creates: src/examples/userExample.ts, src/examples/postExample.ts, src/examples/index.ts
  * ```
  */
-export async function examples(examples, output, split) {
+export async function examples(examples, output, split, readonly) {
     if (!examples)
         return { ok: false, error: 'No examples found' };
     const keys = Object.keys(examples);
     if (keys.length === 0)
         return { ok: true, value: 'No examples found' };
+    const asConst = readonly ? ' as const' : '';
     if (split) {
         const outDir = output.replace(/\.ts$/, '');
         // Generate index.ts with sorted exports
@@ -70,7 +72,7 @@ export async function examples(examples, output, split) {
                     return core(body, path.dirname(filePath), filePath);
                 }
                 // Inline value: generate JSON export
-                const body = `export const ${name} = ${JSON.stringify(v)}\n`;
+                const body = `export const ${name} = ${JSON.stringify(v)}${asConst}\n`;
                 return core(body, path.dirname(filePath), filePath);
             }),
             core(indexCode, path.dirname(path.join(outDir, 'index.ts')), path.join(outDir, 'index.ts')),
@@ -83,7 +85,7 @@ export async function examples(examples, output, split) {
             value: `Generated Example code written to ${outDir}/*.ts (index.ts included)`,
         };
     }
-    const code = makeExportConst(examples, 'Example');
+    const code = makeExportConst(examples, 'Example', readonly);
     const coreResult = await core(code, path.dirname(output), output);
     if (!coreResult.ok)
         return { ok: false, error: coreResult.error };

package/dist/core/components/headers.d.ts

@@ -6,7 +6,8 @@ import type { Components } from '../../openapi/index.js';
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
  * @param exportType - Whether to export TypeScript types
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `.readonly()` to Zod schemas
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -35,7 +36,7 @@ export declare function headers(headers: Components['headers'], output: string,
         readonly split?: boolean;
         readonly import?: string;
     };
-}): Promise<{
+}, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/headers.js

@@ -8,7 +8,7 @@
  */
 import path from 'node:path';
 import { headersCode } from '../../generator/zod-openapi-hono/openapi/components/headers.js';
-import { core, makeBarell, makeImports } from '../../helper/index.js';
+import { core, makeBarrel, makeImports } from '../../helper/index.js';
 import { lowerFirst, renderNamedImport } from '../../utils/index.js';
 /**
  * Generates header component files.
@@ -17,7 +17,8 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
  * @param exportType - Whether to export TypeScript types
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `.readonly()` to Zod schemas
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -40,7 +41,7 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * // Creates: src/headers/xRequestId.ts, src/headers/xCorrelationId.ts, src/headers/index.ts
  * ```
  */
-export async function headers(headers, output, split, exportType, components) {
+export async function headers(headers, output, split, exportType, components, readonly) {
     if (!headers)
         return { ok: false, error: 'No headers found' };
     const headerNames = Object.keys(headers);
@@ -52,11 +53,11 @@ export async function headers(headers, output, split, exportType, components) {
         const allResults = await Promise.all([
             ...headerNames.map((headerName) => {
                 const singleComponent = { headers: { [headerName]: headers[headerName] } };
-                const code = headersCode(singleComponent, true, exportType);
+                const code = headersCode(singleComponent, true, exportType, readonly);
                 const filePath = path.join(outDir, `${lowerFirst(headerName)}.ts`);
                 return core(toFileCode(code, filePath), path.dirname(filePath), filePath);
             }),
-            core(makeBarell(headers), outDir, path.join(outDir, 'index.ts')),
+            core(makeBarrel(headers), outDir, path.join(outDir, 'index.ts')),
         ]);
         const firstError = allResults.find((r) => !r.ok);
         if (firstError)
@@ -67,7 +68,7 @@ export async function headers(headers, output, split, exportType, components) {
         };
     }
     const importCode = renderNamedImport(['z'], '@hono/zod-openapi');
-    const headerDefinitions = headersCode({ headers }, true, exportType);
+    const headerDefinitions = headersCode({ headers }, true, exportType, readonly);
     const headerDefinitionsCode = `${importCode}\n\n${headerDefinitions}`;
     const coreResult = await core(toFileCode(headerDefinitionsCode, output), path.dirname(output), output);
     if (!coreResult.ok)

package/dist/core/components/links.d.ts

@@ -5,6 +5,7 @@ import type { Components } from '../../openapi/index.js';
  * @param links - OpenAPI links object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -25,7 +26,7 @@ import type { Components } from '../../openapi/index.js';
  * // Creates: src/links/getUserById.ts, src/links/getPostById.ts, src/links/index.ts
  * ```
  */
-export declare function links(links: Components['links'], output: string, split: boolean): Promise<{
+export declare function links(links: Components['links'], output: string, split: boolean, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/links.js

@@ -15,6 +15,7 @@ import { core, makeExports } from '../../helper/index.js';
  * @param links - OpenAPI links object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -35,19 +36,19 @@ import { core, makeExports } from '../../helper/index.js';
  * // Creates: src/links/getUserById.ts, src/links/getPostById.ts, src/links/index.ts
  * ```
  */
-export async function links(links, output, split) {
+export async function links(links, output, split, readonly) {
     if (!links)
         return { ok: false, error: 'No links found' };
     const keys = Object.keys(links);
     if (keys.length === 0)
         return { ok: true, value: 'No links found' };
     if (split) {
-        const exportsResult = await makeExports(links, 'Link', output);
+        const exportsResult = await makeExports(links, 'Link', output, readonly);
         if (!exportsResult.ok)
             return { ok: false, error: exportsResult.error };
         return { ok: true, value: exportsResult.value };
     }
-    const code = makeExportConst(links, 'Link');
+    const code = makeExportConst(links, 'Link', readonly);
     const coreResult = await core(code, path.dirname(output), output);
     if (!coreResult.ok)
         return { ok: false, error: coreResult.error };

package/dist/core/components/parameters.d.ts

@@ -6,7 +6,8 @@ import type { Components } from '../../openapi/index.js';
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
  * @param exportType - Whether to export TypeScript types
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `.readonly()` to Zod schemas
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -35,7 +36,7 @@ export declare function parameters(parameters: Components['parameters'], output:
         readonly split?: boolean;
         readonly import?: string;
     };
-}): Promise<{
+}, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/parameters.js

@@ -8,7 +8,7 @@
  */
 import path from 'node:path';
 import { parametersCode } from '../../generator/zod-openapi-hono/openapi/components/parameters.js';
-import { core, makeBarell, makeImports } from '../../helper/index.js';
+import { core, makeBarrel, makeImports } from '../../helper/index.js';
 import { lowerFirst, renderNamedImport } from '../../utils/index.js';
 /**
  * Generates parameter component files.
@@ -17,7 +17,8 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
  * @param exportType - Whether to export TypeScript types
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `.readonly()` to Zod schemas
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -40,7 +41,7 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * // Creates: src/parameters/userId.ts, src/parameters/page.ts, src/parameters/index.ts
  * ```
  */
-export async function parameters(parameters, output, split, exportType, components) {
+export async function parameters(parameters, output, split, exportType, components, readonly) {
     if (!parameters)
         return { ok: false, error: 'No parameters found' };
     const parameterNames = Object.keys(parameters);
@@ -52,11 +53,11 @@ export async function parameters(parameters, output, split, exportType, componen
         const allResults = await Promise.all([
             ...parameterNames.map((parameterName) => {
                 const singleComponent = { parameters: { [parameterName]: parameters[parameterName] } };
-                const code = parametersCode(singleComponent, true, exportType);
+                const code = parametersCode(singleComponent, true, exportType, readonly);
                 const filePath = path.join(outDir, `${lowerFirst(parameterName)}.ts`);
                 return core(toFileCode(code, filePath), path.dirname(filePath), filePath);
             }),
-            core(makeBarell(parameters), outDir, path.join(outDir, 'index.ts')),
+            core(makeBarrel(parameters), outDir, path.join(outDir, 'index.ts')),
         ]);
         const firstError = allResults.find((r) => !r.ok);
         if (firstError)
@@ -67,7 +68,7 @@ export async function parameters(parameters, output, split, exportType, componen
         };
     }
     const importCode = renderNamedImport(['z'], '@hono/zod-openapi');
-    const parameterDefinitions = parametersCode({ parameters }, true, exportType);
+    const parameterDefinitions = parametersCode({ parameters }, true, exportType, readonly);
     const parameterDefinitionsCode = `${importCode}\n\n${parameterDefinitions}`;
     const coreResult = await core(toFileCode(parameterDefinitionsCode, output), path.dirname(output), output);
     if (!coreResult.ok)

package/dist/core/components/requestBodies.d.ts

@@ -5,7 +5,8 @@ import type { Components } from '../../openapi/index.js';
  * @param requestBodies - OpenAPI requestBodies object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -32,7 +33,7 @@ export declare function requestBodies(requestBodies: Components['requestBodies']
         readonly split?: boolean;
         readonly import?: string;
     };
-}): Promise<{
+}, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/requestBodies.js

@@ -8,7 +8,7 @@
  */
 import path from 'node:path';
 import { requestBodiesCode } from '../../generator/zod-openapi-hono/openapi/components/request-bodies.js';
-import { core, makeBarell, makeImports } from '../../helper/index.js';
+import { core, makeBarrel, makeImports } from '../../helper/index.js';
 import { lowerFirst, renderNamedImport } from '../../utils/index.js';
 /**
  * Generates requestBody component files.
@@ -16,7 +16,8 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * @param requestBodies - OpenAPI requestBodies object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -37,7 +38,7 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * // Creates: src/requestBodies/createUser.ts, src/requestBodies/updateUser.ts, src/requestBodies/index.ts
  * ```
  */
-export async function requestBodies(requestBodies, output, split, components) {
+export async function requestBodies(requestBodies, output, split, components, readonly) {
     if (!requestBodies)
         return { ok: false, error: 'No requestBodies found' };
     const bodyNames = Object.keys(requestBodies);
@@ -49,11 +50,11 @@ export async function requestBodies(requestBodies, output, split, components) {
         const allResults = await Promise.all([
             ...bodyNames.map((bodyName) => {
                 const singleComponent = { requestBodies: { [bodyName]: requestBodies[bodyName] } };
-                const code = requestBodiesCode(singleComponent, true);
+                const code = requestBodiesCode(singleComponent, true, readonly);
                 const filePath = path.join(outDir, `${lowerFirst(bodyName)}.ts`);
                 return core(toFileCode(code, filePath), path.dirname(filePath), filePath);
             }),
-            core(makeBarell(requestBodies), outDir, path.join(outDir, 'index.ts')),
+            core(makeBarrel(requestBodies), outDir, path.join(outDir, 'index.ts')),
         ]);
         const firstError = allResults.find((r) => !r.ok);
         if (firstError)
@@ -64,7 +65,7 @@ export async function requestBodies(requestBodies, output, split, components) {
         };
     }
     const importCode = renderNamedImport(['z'], '@hono/zod-openapi');
-    const bodyDefinitions = requestBodiesCode({ requestBodies }, true);
+    const bodyDefinitions = requestBodiesCode({ requestBodies }, true, readonly);
     const bodyDefinitionsCode = `${importCode}\n\n${bodyDefinitions}`;
     const coreResult = await core(toFileCode(bodyDefinitionsCode, output), path.dirname(output), output);
     if (!coreResult.ok)

package/dist/core/components/responses.d.ts

@@ -5,7 +5,8 @@ import type { Components } from '../../openapi/index.js';
  * @param responses - OpenAPI responses object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -32,7 +33,7 @@ export declare function responses(responses: Components['responses'], output: st
         readonly split?: boolean;
         readonly import?: string;
     };
-}): Promise<{
+}, readonly?: boolean | undefined): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {

package/dist/core/components/responses.js

@@ -8,7 +8,7 @@
  */
 import path from 'node:path';
 import { responsesCode } from '../../generator/zod-openapi-hono/openapi/components/responses.js';
-import { core, makeBarell, makeImports } from '../../helper/index.js';
+import { core, makeBarrel, makeImports } from '../../helper/index.js';
 import { lowerFirst, renderNamedImport } from '../../utils/index.js';
 /**
  * Generates response component files.
@@ -16,7 +16,8 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * @param responses - OpenAPI responses object
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
- * @param imports - Schema import configuration for references
+ * @param components - Schema import configuration for references
+ * @param readonly - Whether to add `as const` assertion to the output.
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -37,7 +38,7 @@ import { lowerFirst, renderNamedImport } from '../../utils/index.js';
  * // Creates: src/responses/notFound.ts, src/responses/unauthorized.ts, src/responses/index.ts
  * ```
  */
-export async function responses(responses, output, split, components) {
+export async function responses(responses, output, split, components, readonly) {
     if (!responses)
         return { ok: false, error: 'No responses found' };
     const responseNames = Object.keys(responses);
@@ -49,11 +50,11 @@ export async function responses(responses, output, split, components) {
         const allResults = await Promise.all([
             ...responseNames.map((responseName) => {
                 const singleComponent = { responses: { [responseName]: responses[responseName] } };
-                const code = responsesCode(singleComponent, true);
+                const code = responsesCode(singleComponent, true, readonly);
                 const filePath = path.join(outDir, `${lowerFirst(responseName)}.ts`);
                 return core(toFileCode(code, filePath), path.dirname(filePath), filePath);
             }),
-            core(makeBarell(responses), outDir, path.join(outDir, 'index.ts')),
+            core(makeBarrel(responses), outDir, path.join(outDir, 'index.ts')),
         ]);
         const firstError = allResults.find((r) => !r.ok);
         if (firstError)
@@ -64,7 +65,7 @@ export async function responses(responses, output, split, components) {
         };
     }
     const importCode = renderNamedImport(['z'], '@hono/zod-openapi');
-    const responseDefinitions = responsesCode({ responses }, true);
+    const responseDefinitions = responsesCode({ responses }, true, readonly);
     const responseDefinitionsCode = `${importCode}\n\n${responseDefinitions}`;
     const coreResult = await core(toFileCode(responseDefinitionsCode, output), path.dirname(output), output);
     if (!coreResult.ok)

package/dist/core/components/schemas.d.ts

@@ -6,6 +6,7 @@ import type { Components } from '../../openapi/index.js';
  * @param output - Output file path or directory
  * @param split - Whether to split into multiple files
  * @param exportType - Whether to export TypeScript types
+ * @param readonly - Whether to add `.readonly()` modifier to schemas
  * @returns Promise resolving to success message or error
  *
  * @example
@@ -15,20 +16,23 @@ import type { Components } from '../../openapi/index.js';
  *   { User: { type: 'object', ... } },
  *   'src/schemas.ts',
  *   false,
- *   true
+ *   true,
+ *   false
  * )
  *
- * // Generate schemas in split mode
+ * // Generate schemas in split mode with readonly
  * await schemas(
  *   { User: {...}, Post: {...} },
  *   'src/schemas',
  *   true,
+ *   true,
  *   true
  * )
  * // Creates: src/schemas/user.ts, src/schemas/post.ts, src/schemas/index.ts
+ * // Each schema has .readonly() modifier
  * ```
  */
-export declare function schemas(schemas: Components['schemas'], output: string, split: boolean, exportType: boolean): Promise<{
+export declare function schemas(schemas: Components['schemas'], output: string, split: boolean, exportType: boolean, readonly?: boolean): Promise<{
     readonly ok: true;
     readonly value: string;
 } | {