@kaapi/validator-arktype 0.0.19

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 demingongo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,231 @@
+# 🧪 @kaapi/validator-arktype
+
+![ESM Only](https://img.shields.io/badge/ESM-only-blue?style=flat-square)
+![npm](https://img.shields.io/npm/v/@kaapi/validator-arktype?style=flat-square)
+![license](https://img.shields.io/npm/l/@kaapi/validator-arktype?style=flat-square)
+
+**ArkType-powered validation plugin for [Kaapi](https://www.npmjs.com/package/@kaapi/kaapi)**. Validate request `params`, `payload`, `query`, `headers`, and `state` using [ArkType](https://www.npmjs.com/package/arktype) schemas. Includes built-in documentation helpers for seamless API docs generation.
+
+> ⚠️ This library is ESM‑only. It requires an environment that supports ESM imports.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install @kaapi/validator-arktype
+```
+
+### 📦 Peer Dependency
+
+Requires ArkType:
+
+```bash
+npm install arktype@^2.1.25
+```
+
+---
+
+## 🛠️ Usage
+
+### 🔌 Register the Plugin
+
+```ts
+import { Kaapi } from '@kaapi/kaapi';
+import { validatorArk } from '@kaapi/validator-arktype';
+import { type } from 'arktype';
+
+const app = new Kaapi({
+    port: 3000,
+    host: 'localhost',
+    docs: {
+        disabled: false, // explicitly enables documentation generation
+    },
+});
+
+await app.extend(validatorArk); // register the plugin
+```
+
+---
+
+### 📐 Define a Schema
+
+```ts
+import { ValidatorArkSchema } from '@kaapi/validator-arktype';
+import { type } from 'arktype';
+
+const routeSchema: ValidatorArkSchema = {
+    payload: type({
+        name: 'string',
+    }),
+};
+```
+
+---
+
+### 🧭 Create a Route
+
+```ts
+app.base()
+    .ark(routeSchema)
+    .route(
+        {
+            method: 'POST',
+            path: '/items',
+        },
+        (req) => ({ id: Date.now(), name: req.payload.name })
+    );
+
+// or using inline handler
+/*
+app.base().ark(routeSchema).route({
+  method: 'POST',
+  path: '/items',
+  handler: req => ({ id: Date.now(), name: req.payload.name })
+})
+*/
+```
+
+---
+
+## ⚙️ Advanced Configuration
+
+### 🚨 `failAction`
+
+Control how validation failures are handled:
+
+| Value      | Behavior                     | Safe?                     | Description                     |
+| ---------- | ---------------------------- | ------------------------- | ------------------------------- |
+| `'error'`  | Reject with validation error | ✅                        | Default safe behavior           |
+| `'log'`    | Log and reject               | ✅                        | Useful for observability        |
+| `function` | Custom handler               | ✅ (developer-controlled) | Must return or throw explicitly |
+| `'ignore'` | ❌ Not supported             | ❌                        | Unsafe and not implemented      |
+
+---
+
+### 🧪 Example with Overrides
+
+You can override ArkType validation behavior **globally** for all routes, or **per route** as needed.
+
+#### 🔁 Global Override (All Routes)
+
+```ts
+const app = new Kaapi({
+    // ...
+    routes: {
+        plugins: {
+            ark: {
+                failAction: 'log',
+            },
+        },
+    },
+});
+
+await app.extend(validatorArk);
+```
+
+This logs validation errors before throwing them for all ArkType-validated routes.
+
+#### 🔂 Per-Route Override
+
+```ts
+app.base()
+    .ark({
+        query: z.object({
+            name: z
+                .string()
+                .trim()
+                .nonempty()
+                .max(10)
+                .meta({
+                    description: 'Optional name to personalize the greeting response',
+                })
+                .optional()
+                .default('World'),
+        }),
+        failAction: async (request, h, err) => {
+            if (Boom.isBoom(err)) {
+                return h
+                    .response({
+                        ...err.output.payload,
+                        details: err.data.validationError.issues,
+                    })
+                    .code(err.output.statusCode)
+                    .takeover();
+            }
+            return err;
+        },
+    })
+    .route({
+        path: '/greetings',
+        method: 'GET',
+        handler: ({ query: { name } }) => `Hello ${name}!`,
+    });
+```
+
+---
+
+## 📤 File Upload Example
+
+Multipart file uploads with ArkType validation is supported. Here's how to validate an uploaded image file and stream it back in the response:
+
+```ts
+app.base()
+    .ark({
+        payload: type({
+            file: type({
+                _data: type.instanceOf(Buffer),
+                hapi: type({
+                    filename: 'string',
+                    headers: {
+                        'content-type': "'image/jpeg' | 'image/jpg' | 'image/png'",
+                    },
+                }),
+            }),
+        }),
+    })
+    .route(
+        {
+            method: 'POST',
+            path: '/upload-image',
+            options: {
+                description: 'Upload an image',
+                payload: {
+                    output: 'stream',
+                    parse: true,
+                    allow: 'multipart/form-data',
+                    multipart: { output: 'stream' },
+                    maxBytes: 1024 * 3_000,
+                },
+            },
+        },
+        (req, h) => h.response(req.payload.file._data).type(req.payload.file.hapi.headers['content-type'])
+    );
+```
+
+### 🧾 Notes
+
+- `type({ ... })` is used to accommodate the structure of multipart file metadata.
+- The `_data: type.instanceOf(Buffer)` field is automatically interpreted as a binary field by the documentation generator.
+- This ensures correct OpenAPI and Postman documentation is generated, with the file field shown as a binary upload.
+- The route streams the uploaded image back with its original content type.
+
+---
+
+## 🔄 Flexible API Design
+
+Prefer `Joi` or migrating gradually? No problem.
+
+You can still use `app.route(...)` with Joi-based validation while adopting ArkType via `app.base().ark(...).route(...)`. This dual-mode support ensures **graceful evolution**, allowing traditional and modern routes to coexist without breaking changes.
+
+---
+
+## 📚 License
+
+MIT
+
+> This package is tested as part of the Kaapi monorepo. See the [main Kaapi README](../../README.md) for coverage details.
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome! Feel free to open a discussion or submit a pull request.

package/lib/chunk-3R3TW4ZK.js

@@ -0,0 +1,142 @@
+// src/doc-helpers.ts
+import { OpenAPIJsonHelper, PostmanJsonHelper } from "@novice1/api-doc-json-helper";
+function transformValue(value) {
+  let r = value;
+  if (value && typeof value === "function" && "toJsonSchema" in value && typeof value.toJsonSchema === "function") {
+    r = value.toJsonSchema({
+      fallback: (v) => {
+        let r2 = {};
+        let _instanceof = "";
+        if (v && "proto" in v && v.proto && typeof v.proto === "function" && "name" in v.proto) {
+          r2.type = "object";
+          r2._instanceof = `${v.proto.name}`;
+          _instanceof = `${v.proto.name}`;
+        }
+        if (v.base) {
+          r2 = { ...r2, ...v.base };
+          if ("out" in v && v.out) {
+            if ("anyOf" in r2 && "type" in v.out) {
+              const description = r2.anyOf[0]?.description;
+              r2 = { ...v.out };
+              if (description) {
+                r2.description = description;
+              }
+              if (_instanceof) {
+                r2._instanceof = _instanceof;
+              }
+            } else {
+              r2 = { ...r2, ...v.out };
+            }
+          }
+        }
+        return r2;
+      }
+    });
+  }
+  return r;
+}
+var OpenAPIArkHelper = class _OpenAPIArkHelper extends OpenAPIJsonHelper {
+  constructor(params, isRequired) {
+    super({ ...params, value: transformValue(params.value) }, isRequired);
+  }
+  isValid() {
+    return !!(this._schema && typeof this._schema === "object" && !("~standard" in this._schema) && ("type" in this._schema && typeof this._schema.type === "string" || "oneOf" in this._schema && Array.isArray(this._schema.oneOf) || "anyOf" in this._schema && Array.isArray(this._schema.anyOf) || "enum" in this._schema && Array.isArray(this._schema.enum)));
+  }
+  getFirstItem() {
+    const schema = this._schema;
+    if ("items" in schema && typeof schema.items === "object") {
+      return new _OpenAPIArkHelper({ value: schema.items });
+    }
+    return;
+  }
+  getChildren() {
+    const r = {};
+    const schema = this._schema;
+    if ("properties" in schema && typeof schema.properties === "object" && schema.properties) {
+      const properties = schema.properties;
+      for (const p in properties) {
+        const isRequired = "required" in schema && Array.isArray(schema.required) && schema.required.includes(p);
+        r[p] = new _OpenAPIArkHelper({ value: properties[p] }, isRequired);
+      }
+    }
+    return r;
+  }
+  getAlternatives() {
+    const r = [];
+    const schema = this._schema;
+    if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+      for (const p of schema.oneOf) {
+        r.push(new _OpenAPIArkHelper({ value: p }));
+      }
+    }
+    return r;
+  }
+  isFile() {
+    if (!this.isValid()) return false;
+    let r = false;
+    const schema = this._schema;
+    if ("properties" in schema && typeof schema.properties === "object" && schema.properties) {
+      const properties = schema.properties;
+      r = !!("_data" in properties && properties._data && typeof properties._data === "object" && "_instanceof" in properties._data && properties._data._instanceof === "Buffer");
+    }
+    return r;
+  }
+  getFilesChildren() {
+    const r = {};
+    const schema = this._schema;
+    if ("properties" in schema && typeof schema.properties === "object" && schema.properties) {
+      const properties = schema.properties;
+      for (const p in properties) {
+        const isRequired = "required" in schema && Array.isArray(schema.required) && schema.required.includes(p);
+        const ch = new _OpenAPIArkHelper({ value: properties[p] }, isRequired);
+        if (ch.isFile()) {
+          r[p] = properties[p];
+        }
+      }
+    }
+    return r;
+  }
+};
+var PostmanArkHelper = class _PostmanArkHelper extends PostmanJsonHelper {
+  constructor(params, isRequired) {
+    super({ ...params, value: transformValue(params.value) }, isRequired);
+  }
+  isValid() {
+    return !!(this._schema && typeof this._schema === "object" && ("type" in this._schema && typeof this._schema.type === "string" || "oneOf" in this._schema && Array.isArray(this._schema.oneOf) || "anyOf" in this._schema && Array.isArray(this._schema.anyOf) || "enum" in this._schema && Array.isArray(this._schema.enum)));
+  }
+  getFirstItem() {
+    const schema = this._schema;
+    if ("items" in schema && typeof schema.items === "object") {
+      return new _PostmanArkHelper({ value: schema.items });
+    }
+    return;
+  }
+  getChildren() {
+    const r = {};
+    const schema = this._schema;
+    if ("properties" in schema && typeof schema.properties === "object" && schema.properties) {
+      const properties = schema.properties;
+      for (const p in properties) {
+        const isRequired = "required" in schema && Array.isArray(schema.required) && schema.required.includes(p);
+        r[p] = new _PostmanArkHelper({ value: properties[p] }, isRequired);
+      }
+    }
+    return r;
+  }
+  getAlternatives() {
+    const r = [];
+    const schema = this._schema;
+    if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+      for (const p of schema.oneOf) {
+        r.push(new _PostmanArkHelper({ value: p }));
+      }
+    }
+    return r;
+  }
+};
+
+export {
+  OpenAPIArkHelper,
+  PostmanArkHelper
+};
+//# sourceMappingURL=chunk-3R3TW4ZK.js.map

package/lib/chunk-3R3TW4ZK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/doc-helpers.ts"],"sourcesContent":["import type { KaapiOpenAPIHelperInterface } from '@kaapi/kaapi';\nimport { OpenAPIJsonHelper, PostmanJsonHelper } from '@novice1/api-doc-json-helper';\nimport type { Type, JsonSchema } from 'arktype';\n\nfunction transformValue(value?: Type | object | unknown) {\n    let r: unknown = value;\n    if (value && typeof value === 'function' && 'toJsonSchema' in value && typeof value.toJsonSchema === 'function') {\n        r = (value as Type).toJsonSchema({\n            fallback: (v) => {\n                let r: JsonSchema & { _instanceof?: string } = {};\n                let _instanceof = '';\n                if (v && 'proto' in v && v.proto && typeof v.proto === 'function' && 'name' in v.proto) {\n                    r.type = 'object';\n                    r._instanceof = `${v.proto.name}`;\n                    _instanceof = `${v.proto.name}`;\n                }\n                if (v.base) {\n                    r = { ...r, ...v.base };\n                    if ('out' in v && v.out) {\n                        if ('anyOf' in r && 'type' in v.out) {\n                            const description = r.anyOf[0]?.description;\n                            r = { ...v.out };\n                            if (description) {\n                                r.description = description;\n                            }\n                            if (_instanceof) {\n                                r._instanceof = _instanceof;\n                            }\n                        } else {\n                            r = { ...r, ...v.out };\n                        }\n                    }\n                }\n                return r;\n            },\n        });\n    }\n\n    return r;\n}\n\nexport class OpenAPIArkHelper extends OpenAPIJsonHelper implements KaapiOpenAPIHelperInterface {\n    constructor(\n        params: {\n            value?: Type | object | unknown;\n            isRoot?: boolean;\n        },\n        isRequired?: boolean\n    ) {\n        super({ ...params, value: transformValue(params.value) }, isRequired);\n    }\n    isValid(): boolean {\n        return !!(\n            this._schema &&\n            typeof this._schema === 'object' &&\n            !('~standard' in this._schema) &&\n            (('type' in this._schema && typeof this._schema.type === 'string') ||\n                ('oneOf' in this._schema && Array.isArray(this._schema.oneOf)) ||\n                ('anyOf' in this._schema && Array.isArray(this._schema.anyOf)) ||\n                ('enum' in this._schema && Array.isArray(this._schema.enum)))\n        );\n    }\n    getFirstItem(): OpenAPIArkHelper | undefined {\n        const schema = this._schema;\n\n        if ('items' in schema && typeof schema.items === 'object') {\n            return new OpenAPIArkHelper({ value: schema.items });\n        }\n\n        return;\n    }\n    getChildren(): Record<string, OpenAPIArkHelper> {\n        const r: Record<string, OpenAPIArkHelper> = {};\n        const schema = this._schema;\n        if ('properties' in schema && typeof schema.properties === 'object' && schema.properties) {\n            const properties: Record<string, unknown> = schema.properties as Record<string, unknown>;\n            for (const p in properties) {\n                const isRequired: boolean =\n                    'required' in schema && Array.isArray(schema.required) && schema.required.includes(p);\n                r[p] = new OpenAPIArkHelper({ value: properties[p] }, isRequired);\n            }\n        }\n        return r;\n    }\n    getAlternatives(): OpenAPIArkHelper[] {\n        const r: OpenAPIArkHelper[] = [];\n        const schema = this._schema;\n        if ('oneOf' in schema && Array.isArray(schema.oneOf)) {\n            for (const p of schema.oneOf) {\n                r.push(new OpenAPIArkHelper({ value: p }));\n            }\n        }\n        return r;\n    }\n    isFile(): boolean | undefined {\n        if (!this.isValid()) return false;\n        let r: boolean = false;\n        const schema = this._schema;\n        if ('properties' in schema && typeof schema.properties === 'object' && schema.properties) {\n            const properties: Record<string, unknown> = schema.properties as Record<string, unknown>;\n            r = !!(\n                '_data' in properties &&\n                properties._data &&\n                typeof properties._data === 'object' &&\n                '_instanceof' in properties._data &&\n                properties._data._instanceof === 'Buffer'\n            );\n        }\n        return r;\n    }\n    getFilesChildren(): Record<string, unknown> {\n        const r: Record<string, unknown> = {};\n        const schema = this._schema;\n        if ('properties' in schema && typeof schema.properties === 'object' && schema.properties) {\n            const properties: Record<string, unknown> = schema.properties as Record<string, unknown>;\n            for (const p in properties) {\n                const isRequired: boolean =\n                    'required' in schema && Array.isArray(schema.required) && schema.required.includes(p);\n                const ch = new OpenAPIArkHelper({ value: properties[p] }, isRequired);\n                if (ch.isFile()) {\n                    r[p] = properties[p];\n                }\n            }\n        }\n        return r;\n    }\n}\n\nexport class PostmanArkHelper extends PostmanJsonHelper {\n    constructor(\n        params: {\n            value?: Type | object | unknown;\n            isRoot?: boolean;\n        },\n        isRequired?: boolean\n    ) {\n        super({ ...params, value: transformValue(params.value) }, isRequired);\n    }\n    isValid(): boolean {\n        return !!(\n            this._schema &&\n            typeof this._schema === 'object' &&\n            (('type' in this._schema && typeof this._schema.type === 'string') ||\n                ('oneOf' in this._schema && Array.isArray(this._schema.oneOf)) ||\n                ('anyOf' in this._schema && Array.isArray(this._schema.anyOf)) ||\n                ('enum' in this._schema && Array.isArray(this._schema.enum)))\n        );\n    }\n    getFirstItem(): PostmanArkHelper | undefined {\n        const schema = this._schema;\n\n        if ('items' in schema && typeof schema.items === 'object') {\n            return new PostmanArkHelper({ value: schema.items });\n        }\n\n        return;\n    }\n    getChildren(): Record<string, PostmanArkHelper> {\n        const r: Record<string, PostmanArkHelper> = {};\n        const schema = this._schema;\n        if ('properties' in schema && typeof schema.properties === 'object' && schema.properties) {\n            const properties: Record<string, unknown> = schema.properties as Record<string, unknown>;\n            for (const p in properties) {\n                const isRequired: boolean =\n                    'required' in schema && Array.isArray(schema.required) && schema.required.includes(p);\n                r[p] = new PostmanArkHelper({ value: properties[p] }, isRequired);\n            }\n        }\n        return r;\n    }\n    getAlternatives(): PostmanArkHelper[] {\n        const r: PostmanArkHelper[] = [];\n        const schema = this._schema;\n        if ('oneOf' in schema && Array.isArray(schema.oneOf)) {\n            for (const p of schema.oneOf) {\n                r.push(new PostmanArkHelper({ value: p }));\n            }\n        }\n        return r;\n    }\n}\n"],"mappings":"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","names":["r"]}

package/lib/chunk-55J6XMHW.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-55J6XMHW.js.map

package/lib/chunk-55J6XMHW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/chunk-K4WN6QYS.js

@@ -0,0 +1,182 @@
+import {
+  OpenAPIArkHelper,
+  PostmanArkHelper
+} from "./chunk-3R3TW4ZK.js";
+
+// package.json
+var package_default = {
+  name: "@kaapi/validator-arktype",
+  type: "module",
+  version: "0.0.19",
+  private: false,
+  description: "ArkType-powered request validation and documentation plugin for Kaapi.",
+  main: "lib/index.js",
+  exports: {
+    ".": {
+      types: "./lib/index.d.ts",
+      default: "./lib/index.js"
+    }
+  },
+  scripts: {
+    build: "tsup src !src/**/*.d.ts --format esm --outDir lib --clean --metafile --dts --sourcemap && node ./scripts/buildDT.mjs",
+    check: "tsc --noEmit",
+    "check:deps": "depcruise src --validate",
+    ci: "npm run verify",
+    coverage: "c8 node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts",
+    format: "prettier --write ./",
+    "format:check": "prettier --check ./",
+    lint: "eslint .",
+    test: "node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts",
+    "type-coverage": "type-coverage --at-least 90 --detail",
+    verify: "npm run lint && npm run format:check && npm run check && npm run check:deps && npm run type-coverage && npm run test:kaukau && npm run coverage"
+  },
+  keywords: [
+    "kaapi",
+    "hapi",
+    "arktype",
+    "typescript",
+    "validation"
+  ],
+  author: "demingongo",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/demingongo/kaapi.git",
+    directory: "packages/validator-arktype"
+  },
+  license: "MIT",
+  dependencies: {
+    "@hapi/boom": "^10.0.1",
+    "@kaapi/kaapi": "workspace:^",
+    "@novice1/api-doc-json-helper": "^1.0.6",
+    arktype: "^2.1.25",
+    tslib: "^2.8.1"
+  },
+  devDependencies: {
+    "@types/mocha": "^10.0.10"
+  },
+  peerDependencies: {
+    arktype: "^2.1.25"
+  }
+};
+
+// src/validator.ts
+import Boom from "@hapi/boom";
+import { type } from "arktype";
+var { parse = { payload: true, query: true, params: true, headers: true, state: true } } = {};
+var supportedProps = ["payload", "query", "params", "headers", "state"];
+var normalizeBooleans = (obj) => {
+  for (const key in obj) {
+    const val = obj[key];
+    if (typeof val === "string") {
+      if (val === "true") obj[key] = true;
+      else if (val === "false") obj[key] = false;
+    } else if (Array.isArray(val)) {
+      obj[key] = val.map((v) => v === "true" ? true : v === "false" ? false : v);
+    }
+  }
+  return obj;
+};
+var validatorArk = {
+  async integrate(t) {
+    const validator = (schema) => {
+      return {
+        route(serverRoute, handler) {
+          if (!serverRoute.options) {
+            serverRoute.options = {};
+          }
+          if (typeof serverRoute.options === "object") {
+            if (!serverRoute.options.plugins) {
+              serverRoute.options.plugins = {};
+            }
+            serverRoute.options.plugins.ark = schema;
+            serverRoute.options.plugins.kaapi = serverRoute.options.plugins.kaapi || {};
+            if (serverRoute.options.plugins.kaapi.docs != false && // docs not disabled
+            !serverRoute.options.plugins.kaapi.docs?.disabled) {
+              if (!serverRoute.options.plugins?.kaapi?.docs?.helperSchemaProperty)
+                serverRoute.options.plugins.kaapi.docs = {
+                  ...serverRoute.options.plugins.kaapi.docs,
+                  helperSchemaProperty: "ark"
+                };
+              if (!serverRoute.options.plugins?.kaapi?.docs?.openAPIHelperClass)
+                serverRoute.options.plugins.kaapi.docs = {
+                  ...serverRoute.options.plugins.kaapi.docs,
+                  openAPIHelperClass: OpenAPIArkHelper
+                };
+            }
+          }
+          t.route(serverRoute, handler);
+          return t.server;
+        }
+      };
+    };
+    await t.server.register({
+      name: "kaapi-validator-arktype",
+      version: package_default.version,
+      register: async function(server) {
+        server.ext("onPreHandler", async (request, h) => {
+          const routeValidation = request?.route?.settings?.plugins?.ark;
+          try {
+            const data = {};
+            const dataSchema = {};
+            for (const prop of supportedProps) {
+              if (routeValidation?.[prop] && parse[prop]) {
+                dataSchema[prop] = routeValidation[prop];
+                data[prop] = prop === "query" ? normalizeBooleans(request[prop]) : request[prop];
+              }
+            }
+            let hasProps = false;
+            for (const key in dataSchema) {
+              if (Object.prototype.hasOwnProperty.call(dataSchema, key)) {
+                hasProps = true;
+                break;
+              }
+            }
+            if (hasProps) {
+              const parsedProps = type(dataSchema)(data);
+              if (parsedProps instanceof type.errors) {
+                throw parsedProps;
+              }
+              Object.assign(request, parsedProps);
+            }
+            return h.continue;
+          } catch (err) {
+            const issuePaths = /* @__PURE__ */ new Set();
+            let message;
+            if (err instanceof type.errors && err.issues.length) {
+              const firstIssue = err.issues[0];
+              message = firstIssue.message;
+            } else if (err instanceof Error) {
+              message = err.message;
+            } else {
+              message = "Unknown error";
+            }
+            const response = Boom.badRequest(message);
+            response.data = {
+              validationError: err
+            };
+            if (typeof routeValidation?.failAction === "function") {
+              return routeValidation.failAction(request, h, response);
+            }
+            if (routeValidation?.failAction === "log") {
+              request.log(["validation", "error", "arktype", ...issuePaths], response);
+            }
+            return response;
+          }
+        });
+        server.decorate("server", "ark", validator);
+      }
+    });
+    if (t.openapi) {
+      t.openapi.addHelperClass(OpenAPIArkHelper);
+    }
+    if (t.postman) {
+      t.postman.addHelperClass(PostmanArkHelper);
+    }
+  }
+};
+
+export {
+  supportedProps,
+  validatorArk
+};
+//# sourceMappingURL=chunk-K4WN6QYS.js.map

package/lib/chunk-K4WN6QYS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../package.json","../src/validator.ts"],"sourcesContent":["{\n  \"name\": \"@kaapi/validator-arktype\",\n  \"type\": \"module\",\n  \"version\": \"0.0.19\",\n  \"private\": false,\n  \"description\": \"ArkType-powered request validation and documentation plugin for Kaapi.\",\n  \"main\": \"lib/index.js\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./lib/index.d.ts\",\n      \"default\": \"./lib/index.js\"\n    }\n  },\n  \"scripts\": {\n    \"build\": \"tsup src !src/**/*.d.ts --format esm --outDir lib --clean --metafile --dts --sourcemap && node ./scripts/buildDT.mjs\",\n    \"check\": \"tsc --noEmit\",\n    \"check:deps\": \"depcruise src --validate\",\n    \"ci\": \"npm run verify\",\n    \"coverage\": \"c8 node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts\",\n    \"format\": \"prettier --write ./\",\n    \"format:check\": \"prettier --check ./\",\n    \"lint\": \"eslint .\",\n    \"test\": \"node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts\",\n    \"type-coverage\": \"type-coverage --at-least 90 --detail\",\n    \"verify\": \"npm run lint && npm run format:check && npm run check && npm run check:deps && npm run type-coverage && npm run test:kaukau && npm run coverage\"\n  },\n  \"keywords\": [\n    \"kaapi\",\n    \"hapi\",\n    \"arktype\",\n    \"typescript\",\n    \"validation\"\n  ],\n  \"author\": \"demingongo\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/demingongo/kaapi.git\",\n    \"directory\": \"packages/validator-arktype\"\n  },\n  \"license\": \"MIT\",\n  \"dependencies\": {\n    \"@hapi/boom\": \"^10.0.1\",\n    \"@kaapi/kaapi\": \"workspace:^\",\n    \"@novice1/api-doc-json-helper\": \"^1.0.6\",\n    \"arktype\": \"^2.1.25\",\n    \"tslib\": \"^2.8.1\"\n  },\n  \"devDependencies\": {\n    \"@types/mocha\": \"^10.0.10\"\n  },\n  \"peerDependencies\": {\n    \"arktype\": \"^2.1.25\"\n  }\n}\n","import pkg from '../package.json' with { type: 'json' };\nimport { OpenAPIArkHelper, PostmanArkHelper } from './doc-helpers.js';\nimport type {\n    ArklessReqRef,\n    ArklessReqRefDefaults,\n    ValidatorArk,\n    ValidatorArkReqRef,\n    ValidatorArkSchema,\n} from './types.js';\nimport Boom from '@hapi/boom';\nimport type {\n    KaapiServerRoute,\n    HandlerDecorations,\n    Lifecycle,\n    KaapiPlugin,\n    Request,\n    ResponseToolkit,\n} from '@kaapi/kaapi';\nimport { type, type Type } from 'arktype';\n\nconst { parse = { payload: true, query: true, params: true, headers: true, state: true } } = {};\nexport const supportedProps = ['payload', 'query', 'params', 'headers', 'state'] as const;\nconst normalizeBooleans = (obj: Record<string, unknown>) => {\n    for (const key in obj) {\n        const val = obj[key];\n        if (typeof val === 'string') {\n            if (val === 'true') obj[key] = true;\n            else if (val === 'false') obj[key] = false;\n        } else if (Array.isArray(val)) {\n            obj[key] = val.map((v) => (v === 'true' ? true : v === 'false' ? false : v));\n        }\n    }\n    return obj;\n};\n\nexport const validatorArk: KaapiPlugin = {\n    async integrate(t) {\n        const validator: ValidatorArk = <V extends ValidatorArkSchema>(schema: V) => {\n            return {\n                route<R extends ArklessReqRef = ArklessReqRefDefaults>(\n                    serverRoute: KaapiServerRoute<ValidatorArkReqRef<V> & R>,\n                    handler?:\n                        | HandlerDecorations\n                        | Lifecycle.Method<ValidatorArkReqRef<V> & R, Lifecycle.ReturnValue<ValidatorArkReqRef<V> & R>>\n                ) {\n                    if (!serverRoute.options) {\n                        serverRoute.options = {};\n                    }\n                    if (typeof serverRoute.options === 'object') {\n                        // validate\n                        if (!serverRoute.options.plugins) {\n                            serverRoute.options.plugins = {};\n                        }\n                        serverRoute.options.plugins.ark = schema;\n\n                        // docs\n                        serverRoute.options.plugins.kaapi = serverRoute.options.plugins.kaapi || {};\n                        if (\n                            serverRoute.options.plugins.kaapi.docs != false && // docs not disabled\n                            !serverRoute.options.plugins.kaapi.docs?.disabled // docs not disabled\n                        ) {\n                            if (!serverRoute.options.plugins?.kaapi?.docs?.helperSchemaProperty)\n                                // docs have not helperSchemaProperty\n                                serverRoute.options.plugins.kaapi.docs = {\n                                    ...serverRoute.options.plugins.kaapi.docs,\n                                    helperSchemaProperty: 'ark',\n                                };\n                            if (!serverRoute.options.plugins?.kaapi?.docs?.openAPIHelperClass)\n                                // docs have not openAPIHelperClass\n                                serverRoute.options.plugins.kaapi.docs = {\n                                    ...serverRoute.options.plugins.kaapi.docs,\n                                    openAPIHelperClass: OpenAPIArkHelper,\n                                };\n                        }\n                    }\n                    t.route(serverRoute, handler);\n                    return t.server;\n                },\n            };\n        };\n\n        await t.server.register({\n            name: 'kaapi-validator-arktype',\n            version: pkg.version,\n            register: async function (server) {\n                server.ext('onPreHandler', async (request: Request, h: ResponseToolkit) => {\n                    const routeValidation = request?.route?.settings?.plugins?.ark as ValidatorArkSchema | undefined;\n                    try {\n                        // Initialize empty objects to hold the parsed data and corresponding ArkType schemas\n                        const data: Record<string, unknown> = {};\n                        const dataSchema: Record<string, Type> = {};\n\n                        // Loop through all supported properties for this route\n                        for (const prop of supportedProps) {\n                            // Check if validation exists for this property and there is a parser defined\n                            if (routeValidation?.[prop] && parse[prop]) {\n                                // Add the ArkType schema for this property to the dataSchema\n                                dataSchema[prop] = routeValidation[prop];\n                                // Prepare the value for parsing:\n                                // - For query params, normalize boolean strings to actual booleans\n                                // - Otherwise, take the raw value from the request object\n                                data[prop] = prop === 'query' ? normalizeBooleans(request[prop]) : request[prop];\n                            }\n                        }\n\n                        // Determine if there are any properties to validate\n                        let hasProps = false;\n                        for (const key in dataSchema) {\n                            // Safely check own properties to avoid inherited keys\n                            if (Object.prototype.hasOwnProperty.call(dataSchema, key)) {\n                                hasProps = true;\n                                break;\n                            }\n                        }\n\n                        // If we have any props to validate, parse them using ArkType\n                        if (hasProps) {\n                            // Create an ArkType object from the collected schema and parse\n                            const parsedProps = type(dataSchema)(data);\n                            if (parsedProps instanceof type.errors) {\n                                // throw ArkErrors\n                                throw parsedProps;\n                            }\n                            // Merge the parsed and validated properties back into the request object\n                            Object.assign(request, parsedProps);\n                        }\n\n                        // Continue the Hapi request lifecycle\n                        return h.continue;\n                    } catch (err) {\n                        // Initialize a set to track which paths (properties) failed validation\n                        const issuePaths = new Set<string>();\n                        let message: string;\n\n                        // Check if the error is instance of ValiError\n                        if (err instanceof type.errors && err.issues.length) {\n                            const firstIssue = err.issues[0];\n                            message = firstIssue.message;\n                        } else if (err instanceof Error) {\n                            // If it’s a regular Error, use its message\n                            message = err.message;\n                        } else {\n                            // Unknown error type\n                            message = 'Unknown error';\n                        }\n\n                        // Create a Boom badRequest response with the error message\n                        const response = Boom.badRequest(message);\n\n                        // Attach the raw validation error object for debugging/logging\n                        response.data = {\n                            validationError: err,\n                        };\n\n                        // Handle custom failAction if it’s a function\n                        if (typeof routeValidation?.failAction === 'function') {\n                            return routeValidation.failAction(request, h, response);\n                        }\n\n                        // If failAction is 'log', log the validation error with the request\n                        if (routeValidation?.failAction === 'log') {\n                            request.log(['validation', 'error', 'arktype', ...issuePaths], response);\n                            // Note: unlike Hapi's failAction 'log', 'log' here still returns a Boom response\n                        }\n\n                        // Return the error response to halt request processing\n                        return response;\n                    }\n                });\n                server.decorate('server', 'ark', validator);\n            },\n        });\n\n        if (t.openapi) {\n            t.openapi.addHelperClass(OpenAPIArkHelper);\n        }\n        if (t.postman) {\n            t.postman.addHelperClass(PostmanArkHelper);\n        }\n    },\n};\n"],"mappings":"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","names":[]}

package/lib/declarations.d.ts

@@ -0,0 +1,13 @@
+import { ValidatorArkSchema, ValidatorArk } from './types.js';
+
+declare module '@kaapi/kaapi' {
+    interface PluginSpecificConfiguration {
+        ark?: ValidatorArkSchema;
+    }
+
+    interface Server {
+        ark: ValidatorArk;
+    }
+}
+
+export { };

package/lib/doc-helpers.d.ts

@@ -0,0 +1,28 @@
+import { KaapiOpenAPIHelperInterface } from '@kaapi/kaapi';
+import { OpenAPIJsonHelper, PostmanJsonHelper } from '@novice1/api-doc-json-helper';
+import { Type } from 'arktype';
+
+declare class OpenAPIArkHelper extends OpenAPIJsonHelper implements KaapiOpenAPIHelperInterface {
+    constructor(params: {
+        value?: Type | object | unknown;
+        isRoot?: boolean;
+    }, isRequired?: boolean);
+    isValid(): boolean;
+    getFirstItem(): OpenAPIArkHelper | undefined;
+    getChildren(): Record<string, OpenAPIArkHelper>;
+    getAlternatives(): OpenAPIArkHelper[];
+    isFile(): boolean | undefined;
+    getFilesChildren(): Record<string, unknown>;
+}
+declare class PostmanArkHelper extends PostmanJsonHelper {
+    constructor(params: {
+        value?: Type | object | unknown;
+        isRoot?: boolean;
+    }, isRequired?: boolean);
+    isValid(): boolean;
+    getFirstItem(): PostmanArkHelper | undefined;
+    getChildren(): Record<string, PostmanArkHelper>;
+    getAlternatives(): PostmanArkHelper[];
+}
+
+export { OpenAPIArkHelper, PostmanArkHelper };

package/lib/doc-helpers.js

@@ -0,0 +1,9 @@
+import {
+  OpenAPIArkHelper,
+  PostmanArkHelper
+} from "./chunk-3R3TW4ZK.js";
+export {
+  OpenAPIArkHelper,
+  PostmanArkHelper
+};
+//# sourceMappingURL=doc-helpers.js.map

package/lib/doc-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+import './declarations.d.ts'
+export { ArkSchema, ArklessReqRef, ArklessReqRefDefaults, Infer, ValidatorArk, ValidatorArkReqRef, ValidatorArkSchema, output } from './types.js';
+export { OpenAPIArkHelper, PostmanArkHelper } from './doc-helpers.js';
+export { supportedProps, validatorArk } from './validator.js';
+import '@kaapi/kaapi';
+import 'arktype';
+import '@novice1/api-doc-json-helper';

package/lib/index.js

@@ -0,0 +1,16 @@
+import "./chunk-55J6XMHW.js";
+import {
+  supportedProps,
+  validatorArk
+} from "./chunk-K4WN6QYS.js";
+import {
+  OpenAPIArkHelper,
+  PostmanArkHelper
+} from "./chunk-3R3TW4ZK.js";
+export {
+  OpenAPIArkHelper,
+  PostmanArkHelper,
+  supportedProps,
+  validatorArk
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/doc-helpers.ts":{"bytes":7238,"imports":[{"path":"@novice1/api-doc-json-helper","kind":"import-statement","external":true}],"format":"esm"},"src/types.ts":{"bytes":1833,"imports":[],"format":"esm"},"package.json":{"bytes":1797,"imports":[],"format":"esm","with":{"type":"json"}},"src/validator.ts":{"bytes":8695,"imports":[{"path":"package.json","kind":"import-statement","original":"../package.json","with":{"type":"json"}},{"path":"src/doc-helpers.ts","kind":"import-statement","original":"./doc-helpers.js"},{"path":"@hapi/boom","kind":"import-statement","external":true},{"path":"arktype","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":94,"imports":[{"path":"src/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/doc-helpers.ts","kind":"import-statement","original":"./doc-helpers.js"},{"path":"src/validator.ts","kind":"import-statement","original":"./validator.js"}],"format":"esm"}},"outputs":{"lib/doc-helpers.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"lib/doc-helpers.js":{"imports":[{"path":"lib/chunk-3R3TW4ZK.js","kind":"import-statement"}],"exports":["OpenAPIArkHelper","PostmanArkHelper"],"entryPoint":"src/doc-helpers.ts","inputs":{},"bytes":129},"lib/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"lib/index.js":{"imports":[{"path":"lib/chunk-55J6XMHW.js","kind":"import-statement"},{"path":"lib/chunk-K4WN6QYS.js","kind":"import-statement"},{"path":"lib/chunk-3R3TW4ZK.js","kind":"import-statement"}],"exports":["OpenAPIArkHelper","PostmanArkHelper","supportedProps","validatorArk"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0}},"bytes":265},"lib/types.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"lib/types.js":{"imports":[{"path":"lib/chunk-55J6XMHW.js","kind":"import-statement"}],"exports":[],"entryPoint":"src/types.ts","inputs":{},"bytes":30},"lib/chunk-55J6XMHW.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"lib/chunk-55J6XMHW.js":{"imports":[],"exports":[],"inputs":{"src/types.ts":{"bytesInOutput":0}},"bytes":0},"lib/validator.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"lib/validator.js":{"imports":[{"path":"lib/chunk-K4WN6QYS.js","kind":"import-statement"},{"path":"lib/chunk-3R3TW4ZK.js","kind":"import-statement"}],"exports":["supportedProps","validatorArk"],"entryPoint":"src/validator.ts","inputs":{},"bytes":147},"lib/chunk-K4WN6QYS.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":14467},"lib/chunk-K4WN6QYS.js":{"imports":[{"path":"lib/chunk-3R3TW4ZK.js","kind":"import-statement"},{"path":"@hapi/boom","kind":"import-statement","external":true},{"path":"arktype","kind":"import-statement","external":true}],"exports":["supportedProps","validatorArk"],"inputs":{"package.json":{"bytesInOutput":1758},"src/validator.ts":{"bytesInOutput":4285}},"bytes":6205},"lib/chunk-3R3TW4ZK.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":11310},"lib/chunk-3R3TW4ZK.js":{"imports":[{"path":"@novice1/api-doc-json-helper","kind":"import-statement","external":true}],"exports":["OpenAPIArkHelper","PostmanArkHelper"],"inputs":{"src/doc-helpers.ts":{"bytesInOutput":5107}},"bytes":5181}}}

package/lib/types.d.ts

@@ -0,0 +1,27 @@
+import { Lifecycle, ReqRefDefaults, ReqRef, MergeRefs, KaapiServerRoute, HandlerDecorations, Server } from '@kaapi/kaapi';
+import { Type } from 'arktype';
+
+type ArkSchema = Type<any, any> | undefined | null;
+type ValidatorArkSchema = {
+    payload?: ArkSchema;
+    query?: ArkSchema;
+    params?: ArkSchema;
+    headers?: ArkSchema;
+    state?: ArkSchema;
+    failAction?: 'error' | 'log' | Lifecycle.Method | undefined;
+};
+type ArklessReqRefDefaults = Omit<ReqRefDefaults, 'Query' | 'Headers' | 'Params' | 'Payload'>;
+type ArklessReqRef = Omit<ReqRef, 'Query' | 'Headers' | 'Params' | 'Payload'>;
+type Infer<T extends Type<any, any>> = T['infer'];
+type output<T, D = unknown> = T extends Type<any, any> ? Infer<T> : D;
+interface ValidatorArkReqRef<RS extends ValidatorArkSchema = ValidatorArkSchema> {
+    Query: output<RS['query'], MergeRefs<ArklessReqRefDefaults>['Query']>;
+    Headers: output<RS['headers'], MergeRefs<ArklessReqRefDefaults>['Headers']>;
+    Params: output<RS['params'], MergeRefs<ArklessReqRefDefaults>['Params']>;
+    Payload: output<RS['payload'], MergeRefs<ArklessReqRefDefaults>['Payload']>;
+}
+type ValidatorArk = <V extends ValidatorArkSchema>(schema: V) => {
+    route<R extends ArklessReqRef = ArklessReqRefDefaults>(serverRoute: KaapiServerRoute<ValidatorArkReqRef<V> & R>, handler?: HandlerDecorations | Lifecycle.Method<ValidatorArkReqRef<V> & R, Lifecycle.ReturnValue<ValidatorArkReqRef<V> & R>>): Server;
+};
+
+export type { ArkSchema, ArklessReqRef, ArklessReqRefDefaults, Infer, ValidatorArk, ValidatorArkReqRef, ValidatorArkSchema, output };

package/lib/types.js

@@ -0,0 +1,2 @@
+import "./chunk-55J6XMHW.js";
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/lib/validator.d.ts

@@ -0,0 +1,6 @@
+import { KaapiPlugin } from '@kaapi/kaapi';
+
+declare const supportedProps: readonly ["payload", "query", "params", "headers", "state"];
+declare const validatorArk: KaapiPlugin;
+
+export { supportedProps, validatorArk };

package/lib/validator.js

@@ -0,0 +1,10 @@
+import {
+  supportedProps,
+  validatorArk
+} from "./chunk-K4WN6QYS.js";
+import "./chunk-3R3TW4ZK.js";
+export {
+  supportedProps,
+  validatorArk
+};
+//# sourceMappingURL=validator.js.map

package/lib/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kaapi/validator-arktype",
+  "type": "module",
+  "version": "0.0.19",
+  "private": false,
+  "description": "ArkType-powered request validation and documentation plugin for Kaapi.",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src !src/**/*.d.ts --format esm --outDir lib --clean --metafile --dts --sourcemap && node ./scripts/buildDT.mjs",
+    "check": "tsc --noEmit",
+    "check:deps": "depcruise src --validate",
+    "ci": "npm run verify",
+    "coverage": "c8 node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts",
+    "format": "prettier --write ./",
+    "format:check": "prettier --check ./",
+    "lint": "eslint .",
+    "test": "node --loader ts-node/esm --experimental-specifier-resolution=node --no-warnings ../../node_modules/mocha/bin/mocha test/**/*.spec.ts",
+    "type-coverage": "type-coverage --at-least 90 --detail",
+    "verify": "npm run lint && npm run format:check && npm run check && npm run check:deps && npm run type-coverage && npm run test:kaukau && npm run coverage"
+  },
+  "keywords": [
+    "kaapi",
+    "hapi",
+    "arktype",
+    "typescript",
+    "validation"
+  ],
+  "author": "demingongo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/demingongo/kaapi.git",
+    "directory": "packages/validator-arktype"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@hapi/boom": "^10.0.1",
+    "@kaapi/kaapi": "workspace:^",
+    "@novice1/api-doc-json-helper": "^1.0.6",
+    "arktype": "^2.1.25",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.10"
+  },
+  "peerDependencies": {
+    "arktype": "^2.1.25"
+  }
+}