@kamaalio/hono-standard-openapi 0.0.1

package/dist/type-inference.d.ts

@@ -0,0 +1,80 @@
+import type { Env, Handler, MiddlewareHandler, TypedResponse, ValidationTargets } from 'hono';
+import type { StatusCode } from 'hono/utils/http-status';
+import type { StandardSchemaV1 } from './standard-schema.ts';
+import type { RouteConfigBase } from './types.ts';
+type HasUndefined<T> = undefined extends T ? true : false;
+/** Rewrites OpenAPI's `/users/{id}` into the `/users/:id` Hono routes with. */
+export type ConvertPathType<T extends string> = T extends `${infer Start}/{${infer Param}}${infer Rest}` ? `${Start}/:${Param}${ConvertPathType<Rest>}` : T;
+type RequestPart<R extends RouteConfigBase, Part extends string> = R extends {
+    request: infer Request;
+} ? Part extends keyof Request ? Request[Part] : never : never;
+type InputTypeBase<R extends RouteConfigBase, Part extends string, Type extends keyof ValidationTargets> = RequestPart<R, Part> extends infer Schema extends StandardSchemaV1 ? {
+    in: {
+        [K in Type]: HasUndefined<ValidationTargets[K]> extends true ? {
+            [K2 in keyof StandardSchemaV1.InferInput<Schema>]?: StandardSchemaV1.InferInput<Schema>[K2];
+        } : {
+            [K2 in keyof StandardSchemaV1.InferInput<Schema>]: StandardSchemaV1.InferInput<Schema>[K2];
+        };
+    };
+    out: {
+        [K in Type]: StandardSchemaV1.InferOutput<Schema>;
+    };
+} : {};
+type RequestContent<R extends RouteConfigBase> = R extends {
+    request: {
+        body: {
+            content: infer Content;
+        };
+    };
+} ? Content : never;
+type JsonMediaType<Content> = {
+    [K in keyof Content]: K extends `application/${string}json` ? K : never;
+}[keyof Content];
+type FormMediaType<Content> = {
+    [K in keyof Content]: K extends 'multipart/form-data' | 'application/x-www-form-urlencoded' ? K : never;
+}[keyof Content];
+type BodySchema<Content, MediaType> = MediaType extends keyof Content ? Content[MediaType] extends {
+    schema: infer Schema extends StandardSchemaV1;
+} ? Schema : never : never;
+type InputTypeBody<R extends RouteConfigBase, MediaType, Target extends 'json' | 'form'> = BodySchema<RequestContent<R>, MediaType> extends infer Schema extends StandardSchemaV1 ? {
+    in: {
+        [K in Target]: StandardSchemaV1.InferInput<Schema>;
+    };
+    out: {
+        [K in Target]: StandardSchemaV1.InferOutput<Schema>;
+    };
+} : {};
+/** Everything a handler can read off the request, derived from the route's schemas. */
+export type ComputeInput<R extends RouteConfigBase> = InputTypeBase<R, 'params', 'param'> & InputTypeBase<R, 'query', 'query'> & InputTypeBase<R, 'headers', 'header'> & InputTypeBase<R, 'cookies', 'cookie'> & InputTypeBody<R, JsonMediaType<RequestContent<R>>, 'json'> & InputTypeBody<R, FormMediaType<RequestContent<R>>, 'form'>;
+/**
+ * The status code a response key stands for.
+ *
+ * Keys can be written either way — `200` or `'200'` — so both forms resolve to the same code.
+ */
+type StatusFrom<Key> = Key extends StatusCode ? Key : Key extends `${infer Status extends number}` ? Status extends StatusCode ? Status : never : never;
+type ResponseBody<Response, MediaType> = MediaType extends keyof Response ? Response[MediaType] extends {
+    schema: infer Schema extends StandardSchemaV1;
+} ? StandardSchemaV1.InferOutput<Schema> : never : never;
+type TypedResponseFor<Response, Status extends StatusCode> = Response extends {
+    content: infer Content;
+} ? ResponseBody<Content, JsonMediaType<Content>> extends infer Body ? [Body] extends [never] ? TypedResponse<unknown, Status, 'text'> : TypedResponse<Body, Status, 'json'> : never : never;
+/** The responses a handler is allowed to return, one per documented status code. */
+export type RouteConfigToTypedResponse<R extends RouteConfigBase> = {
+    [Key in keyof R['responses']]: TypedResponseFor<R['responses'][Key], StatusFrom<Key>>;
+}[keyof R['responses']];
+type HasContentlessResponse<R extends RouteConfigBase> = {
+    [Key in keyof R['responses']]: R['responses'][Key] extends {
+        content: unknown;
+    } ? never : true;
+}[keyof R['responses']];
+/**
+ * What a handler may return.
+ *
+ * A route that documents a response without a body — a 204, say — can also answer with a plain
+ * `Response`, since there is no schema to satisfy.
+ */
+export type RouteHandlerResponse<R extends RouteConfigBase> = [HasContentlessResponse<R>] extends [never] ? RouteConfigToTypedResponse<R> | Promise<RouteConfigToTypedResponse<R>> : RouteConfigToTypedResponse<R> | Promise<RouteConfigToTypedResponse<R>> | Response | Promise<Response>;
+export type RouteHandler<R extends RouteConfigBase, E extends Env = Env> = Handler<E, ConvertPathType<R['path']>, ComputeInput<R>, RouteHandlerResponse<R>>;
+export type RouteMiddleware<E extends Env = Env> = MiddlewareHandler<E> | readonly MiddlewareHandler<E>[];
+export {};
+//# sourceMappingURL=type-inference.d.ts.map

package/dist/type-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.d.ts","sourceRoot":"","sources":["../src/type-inference.ts"],"names":[],"mappings":"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"}

package/dist/type-inference.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type-inference.js.map

package/dist/type-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-inference.js","sourceRoot":"","sources":["../src/type-inference.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+import type { HeadersObject, LinksObject, OperationObject, ParameterObject, ReferenceObject, RequestBodyObject, ResponsesObject, SchemaObject } from 'openapi3-ts/oas31';
+import type { StandardSchema } from './standard-schema.ts';
+export type { ReferenceObject, SchemaObject };
+/** Either a schema to convert, or an already-written OpenAPI schema to pass through untouched. */
+export type SchemaOrReference = StandardSchema | SchemaObject | ReferenceObject;
+export interface MediaTypeObject {
+    readonly schema?: SchemaOrReference | undefined;
+    readonly example?: unknown;
+    readonly examples?: Record<string, unknown> | undefined;
+    readonly encoding?: Record<string, unknown> | undefined;
+}
+export type ContentObject = Record<string, MediaTypeObject>;
+export interface RequestBody extends Omit<RequestBodyObject, 'content'> {
+    readonly content: ContentObject;
+}
+export interface ResponseConfig {
+    readonly description: string;
+    readonly headers?: StandardSchema | HeadersObject | undefined;
+    readonly links?: LinksObject | undefined;
+    readonly content?: ContentObject | undefined;
+}
+export interface RouteRequest {
+    readonly body?: RequestBody | undefined;
+    readonly params?: StandardSchema | undefined;
+    readonly query?: StandardSchema | undefined;
+    readonly cookies?: StandardSchema | undefined;
+    readonly headers?: StandardSchema | undefined;
+}
+export type RouteMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options' | 'trace';
+export interface RouteConfigBase extends Omit<OperationObject, 'responses' | 'parameters'> {
+    readonly method: RouteMethod;
+    readonly path: string;
+    readonly request?: RouteRequest | undefined;
+    readonly parameters?: (ParameterObject | ReferenceObject)[] | undefined;
+    readonly responses: Record<string, ResponseConfig | ReferenceObject>;
+}
+export type { ResponsesObject };
+/** Where a parameter lives in the request. */
+export type ParameterLocation = 'path' | 'query' | 'header' | 'cookie';
+/** The request keys that become parameters, in the order the document lists them. */
+export declare const PARAMETER_SOURCES: readonly [{
+    readonly key: 'params';
+    readonly location: 'path';
+}, {
+    readonly key: 'query';
+    readonly location: 'query';
+}, {
+    readonly key: 'headers';
+    readonly location: 'header';
+}, {
+    readonly key: 'cookies';
+    readonly location: 'cookie';
+}];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAE9C,kGAAkG;AAClG,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACzD;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErG,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,YAAY,CAAC;IACxF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,eAAe,GAAG,eAAe,CAAC,EAAE,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAAC,CAAC;CACtE;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,qFAAqF;AACrF,eAAO,MAAM,iBAAiB;kBACrB,QAAQ;uBAAY,MAAM;;kBAC1B,OAAO;uBAAY,OAAO;;kBAC1B,SAAS;uBAAY,QAAQ;;kBAC7B,SAAS;uBAAY,QAAQ;EACkD,CAAC"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/** The request keys that become parameters, in the order the document lists them. */
+export const PARAMETER_SOURCES = [
+    { key: 'params', location: 'path' },
+    { key: 'query', location: 'query' },
+    { key: 'headers', location: 'header' },
+    { key: 'cookies', location: 'cookie' },
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA6DA,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE;IACnC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE;IACnC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACtC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;CACgD,CAAC"}

package/dist/validator.d.ts

@@ -0,0 +1,30 @@
+import type { Context, Env, MiddlewareHandler, ValidationTargets } from 'hono';
+import type { StandardSchemaV1 } from './standard-schema.ts';
+/** What a validation attempt produced, handed to a hook before the handler runs. */
+export type ValidationResult<T> = {
+    readonly target: keyof ValidationTargets;
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly target: keyof ValidationTargets;
+    readonly success: false;
+    readonly data: unknown;
+    readonly error: {
+        readonly issues: readonly StandardSchemaV1.Issue[];
+    };
+};
+/**
+ * Runs before the handler, once per validated part of the request.
+ *
+ * Returning a `Response` (or throwing) takes over the request; returning nothing lets it continue,
+ * which is how a hook can log a failure without changing the outcome.
+ */
+export type Hook<T, E extends Env, P extends string, R> = (result: ValidationResult<T>, c: Context<E, P>) => R | undefined;
+/**
+ * Validates one part of a request against a Standard Schema.
+ *
+ * Header names are matched case-insensitively against the schema's own property names, because HTTP
+ * header casing is not something a caller should have to get right.
+ */
+export declare function standardValidator<E extends Env, P extends string>(target: keyof ValidationTargets, schema: StandardSchemaV1, propertyNames: readonly string[], hook?: Hook<unknown, E, P, unknown>): MiddlewareHandler<E, P>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAG/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,iBAAiB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACtF;IACE,QAAQ,CAAC,MAAM,EAAE,MAAM,iBAAiB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,CAAA;KAAE,CAAC;CACxE,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI,CACxD,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KACb,CAAC,GAAG,SAAS,CAAC;AAEnB;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EAC/D,MAAM,EAAE,MAAM,iBAAiB,EAC/B,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,GAClC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAkBzB"}

package/dist/validator.js

@@ -0,0 +1,31 @@
+import { validator } from 'hono/validator';
+/**
+ * Validates one part of a request against a Standard Schema.
+ *
+ * Header names are matched case-insensitively against the schema's own property names, because HTTP
+ * header casing is not something a caller should have to get right.
+ */
+export function standardValidator(target, schema, propertyNames, hook) {
+    return validator(target, async (value, c) => {
+        const candidate = target === 'header' ? withSchemaCasing(value, propertyNames) : value;
+        const result = await schema['~standard'].validate(candidate);
+        if (result.issues == null) {
+            const hooked = hook?.({ data: result.value, success: true, target }, c);
+            if (hooked instanceof Response)
+                return hooked;
+            return result.value;
+        }
+        const failure = { data: candidate, error: { issues: result.issues }, success: false, target };
+        const hooked = hook?.(failure, c);
+        if (hooked instanceof Response)
+            return hooked;
+        return c.json({ error: { issues: result.issues }, success: false }, 400);
+    });
+}
+function withSchemaCasing(value, propertyNames) {
+    if (typeof value !== 'object' || value == null || propertyNames.length === 0)
+        return value;
+    const casingByLowercased = new Map(propertyNames.map(name => [name.toLowerCase(), name]));
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [casingByLowercased.get(key.toLowerCase()) ?? key, entry]));
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAyB3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA+B,EAC/B,MAAwB,EACxB,aAAgC,EAChC,IAAmC;IAEnC,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1C,MAAM,SAAS,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;YACxE,IAAI,MAAM,YAAY,QAAQ;gBAAE,OAAO,MAAM,CAAC;YAE9C,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAW,CAAC;QACvG,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,MAAM,YAAY,QAAQ;YAAE,OAAO,MAAM,CAAC;QAE9C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,aAAgC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3F,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1F,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC,CACvG,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@kamaalio/hono-standard-openapi",
+  "version": "0.0.1",
+  "description": "Generate OpenAPI documents from any Standard Schema library, for Hono.",
+  "keywords": [
+    "hono",
+    "json-schema",
+    "openapi",
+    "standard-schema",
+    "validator"
+  ],
+  "license": "MIT",
+  "author": "",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p tsconfig.build.json",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint",
+    "prepare": "husky",
+    "release": "sh scripts/publish.sh",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0",
+    "openapi3-ts": "^4.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "eslint-plugin-import": "^2.32.0",
+    "hono": "^4.13.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.3.0",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
+    "oxlint-tsgolint": "^7.0.2001",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "hono": ">=4.10.0"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs,ts}": "pnpm run lint",
+    "*": "oxfmt --no-error-on-unmatched-pattern"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.6.0",
+      "onFail": "download"
+    }
+  }
+}