@quilla-be-kit/http 0.2.0

package/dist/validator/zod.d.ts

@@ -0,0 +1,29 @@
+import { type ZodError } from 'zod';
+import type { RequestValidator } from './request-validator.interface.js';
+export type ZodRequestValidatorOptions = {
+    /**
+     * Formats Zod's raw issue array for inclusion in the thrown
+     * `ValidationError`'s `context.issues`. Defaults to passing
+     * `error.issues` through verbatim.
+     */
+    readonly extractIssues?: (error: ZodError) => unknown[];
+};
+/**
+ * `RequestValidator` adapter for Zod 4. Implements `describeSchema` so
+ * `@ValidateRequest` can inject `scopeId` / `userId` from the active
+ * `ExecutionContext` into payloads whose schemas declare those keys.
+ *
+ * Handles the two common shapes:
+ *
+ * - Bare `ZodObject` — keys come straight from `schema.shape`.
+ * - `ZodPipe` over `ZodObject` — the shape produced by chaining
+ *   `.transform(...)` onto an object (e.g. the schema returned by
+ *   `createQueryParametersSchema` in `@quilla-be-kit/persistence/query-schema`).
+ *   The adapter walks the pipe's input side until it reaches a
+ *   `ZodObject` and enumerates that.
+ *
+ * Any other shape (unions, primitives, tuples) returns `null` — the
+ * decorator then skips auth-injection for that schema.
+ */
+export declare function createZodRequestValidator(options?: ZodRequestValidatorOptions): RequestValidator;
+//# sourceMappingURL=zod.d.ts.map

package/dist/validator/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/validator/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAmB,MAAM,KAAK,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,kCAAkC,CAAC;AAE5F,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,EAAE,CAAC;CACzD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,gBAAgB,CAwBlB"}

package/dist/validator/zod.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * `RequestValidator` adapter for Zod 4. Implements `describeSchema` so
+ * `@ValidateRequest` can inject `scopeId` / `userId` from the active
+ * `ExecutionContext` into payloads whose schemas declare those keys.
+ *
+ * Handles the two common shapes:
+ *
+ * - Bare `ZodObject` — keys come straight from `schema.shape`.
+ * - `ZodPipe` over `ZodObject` — the shape produced by chaining
+ *   `.transform(...)` onto an object (e.g. the schema returned by
+ *   `createQueryParametersSchema` in `@quilla-be-kit/persistence/query-schema`).
+ *   The adapter walks the pipe's input side until it reaches a
+ *   `ZodObject` and enumerates that.
+ *
+ * Any other shape (unions, primitives, tuples) returns `null` — the
+ * decorator then skips auth-injection for that schema.
+ */
+export function createZodRequestValidator(options = {}) {
+    const extractIssues = options.extractIssues ?? ((error) => error.issues);
+    return {
+        validate(schema, input) {
+            const result = schema.safeParse(input);
+            if (result.success)
+                return { success: true, data: result.data };
+            return { success: false, error: extractIssues(result.error) };
+        },
+        describeSchema(schema) {
+            let current = schema;
+            // Walk `ZodPipe.in` — Zod 4's transform produces `pipe(source, transform)`,
+            // and the upstream object lives at `._zod.def.in`. Keep unwrapping so
+            // chained pipes (transform().refine(), etc.) are all penetrated.
+            while (current instanceof z.ZodPipe) {
+                current = current._zod.def.in;
+            }
+            if (current instanceof z.ZodObject) {
+                return { keys: Object.keys(current.shape) };
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=zod.js.map

package/dist/validator/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/validator/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,CAAC,EAAE,MAAM,KAAK,CAAC;AAYrD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAsC,EAAE;IAExC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzE,OAAO;QACL,QAAQ,CAAC,MAAM,EAAE,KAAK;YACpB,MAAM,MAAM,GAAI,MAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,CAAC;QAED,cAAc,CAAC,MAAM;YACnB,IAAI,OAAO,GAAY,MAAM,CAAC;YAC9B,4EAA4E;YAC5E,sEAAsE;YACtE,iEAAiE;YACjE,OAAO,OAAO,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpC,OAAO,GAAI,OAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAa,CAAC;YAC1D,CAAC;YACD,IAAI,OAAO,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;gBACnC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9C,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@quilla-be-kit/http",
+  "version": "0.2.0",
+  "description": "Framework-agnostic HTTP layer: decorators (@Controller/@Get/@Post/.../@AuthorizeScope/@ValidateRequest), framework-agnostic router, WebServer interface, and a Hono adapter sub-path.",
+  "license": "MIT",
+  "author": "Max Martinez",
+  "homepage": "https://github.com/quilla-kit/quilla-be-kit/tree/main/packages/http",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quilla-kit/quilla-be-kit.git",
+    "directory": "packages/http"
+  },
+  "bugs": {
+    "url": "https://github.com/quilla-kit/quilla-be-kit/issues"
+  },
+  "keywords": [
+    "http",
+    "decorators",
+    "controller",
+    "routing",
+    "hono",
+    "framework-agnostic",
+    "typescript"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": [
+    "./dist/decorator/route.metadata.js"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapter/hono": {
+      "types": "./dist/adapter/hono/index.d.ts",
+      "import": "./dist/adapter/hono/index.js"
+    },
+    "./validator/zod": {
+      "types": "./dist/validator/zod.d.ts",
+      "import": "./dist/validator/zod.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@quilla-be-kit/errors": "^0.2.0",
+    "@quilla-be-kit/execution-context": "^0.2.0",
+    "@quilla-be-kit/observability": "^0.2.0",
+    "@quilla-be-kit/runtime": "^0.2.0"
+  },
+  "peerDependencies": {
+    "hono": "4.x.x",
+    "zod": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hono": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "hono": "^4.12.0",
+    "vitest": "^2.1.3",
+    "zod": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}