@kozojs/core 0.3.10 → 0.3.12

package/lib/index.d.ts

@@ -301,10 +301,15 @@ declare class Kozo<TServices extends Services = Services> {
     loadRoutes(routesDir?: string): Promise<this>;
     generateClient(baseUrl?: string): string;
     generateClient(options?: ClientGeneratorOptions): string;
+    get(path: string, handler: KozoHandler<{}, TServices>): this;
     get<S extends RouteSchema>(path: string, schema: S, handler: KozoHandler<S, TServices>): this;
+    post(path: string, handler: KozoHandler<{}, TServices>): this;
     post<S extends RouteSchema>(path: string, schema: S, handler: KozoHandler<S, TServices>): this;
+    put(path: string, handler: KozoHandler<{}, TServices>): this;
     put<S extends RouteSchema>(path: string, schema: S, handler: KozoHandler<S, TServices>): this;
+    patch(path: string, handler: KozoHandler<{}, TServices>): this;
     patch<S extends RouteSchema>(path: string, schema: S, handler: KozoHandler<S, TServices>): this;
+    delete(path: string, handler: KozoHandler<{}, TServices>): this;
     delete<S extends RouteSchema>(path: string, schema: S, handler: KozoHandler<S, TServices>): this;
     private register;
     /**
@@ -336,6 +341,8 @@ declare function createKozo<TServices extends Services = Services>(config?: Kozo
 type ZValidatorErrors = {
     instancePath: string;
     message: string;
+    keyword?: string;
+    path?: (string | number)[];
 }[];
 type ZValidator = ((data: unknown) => boolean) & {
     errors: ZValidatorErrors | null;
@@ -416,6 +423,7 @@ declare function fastWriteError(err: unknown, res: ServerResponse): void;
  */
 interface ValidationError {
     field: string;
+    path?: (string | number)[];
     message: string;
     code: string;
     value?: unknown;
@@ -654,4 +662,46 @@ declare class OpenAPIGenerator {
 declare function generateSwaggerHtml(specUrl: string, title?: string): string;
 declare function createOpenAPIGenerator(config: OpenAPIConfig): OpenAPIGenerator;
 
-export { type ClientGeneratorOptions, type CompiledRoute, ERROR_RESPONSES, ForbiddenError, type InferResponse, type InferSchema, type InflightTracker, Kozo, type KozoConfig, type KozoContext, type KozoEnv, KozoError, type KozoHandler, type NativeKozoContext, type NativeKozoHandler, NotFoundError, type OpenAPIConfig, OpenAPIGenerator, type OpenAPIInfo, type OpenAPISpec, type Plugin, type ProblemDetails, type RouteInfo, type RouteSchema, SchemaCompiler, type Services, ShutdownManager, type ShutdownOptions, type ShutdownState, UnauthorizedError, type ValidationError, ValidationFailedError, buildNativeContext, compileRouteHandler, createInflightTracker, createKozo, createOpenAPIGenerator, createShutdownManager, fastCL, fastWrite400, fastWrite404, fastWrite500, fastWriteError, fastWriteHtml, fastWriteJson, fastWriteJsonStatus, fastWriteText, forbiddenResponse, formatAjvErrors, formatZodErrors, generateSwaggerHtml, generateTypedClient, internalErrorResponse, notFoundResponse, trackRequest, unauthorizedResponse, validationErrorResponse };
+/**
+ * Common pagination query schema.
+ * Use it directly as the `query` field to avoid repeating this pattern everywhere.
+ *
+ * @example
+ * app.get('/users', { query: paginationSchema }, (ctx) => {
+ *   const { page, limit } = ctx.query; // fully typed
+ * });
+ */
+declare const paginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * Route param schema for `:id` routes that expect a UUID.
+ *
+ * @example
+ * app.get('/users/:id', { params: uuidParams }, (ctx) => ctx.params.id);
+ */
+declare const uuidParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Route param schema for `:id` routes that expect a positive integer.
+ *
+ * @example
+ * app.get('/posts/:id', { params: idParams }, (ctx) => ctx.params.id);
+ */
+declare const idParams: z.ZodObject<{
+    id: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+/**
+ * Standard success/deleted response schema.
+ *
+ * @example
+ * app.delete('/users/:id', { params: uuidParams, response: deletedSchema }, ...);
+ */
+declare const deletedSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    deletedId: z.ZodString;
+}, z.core.$strip>;
+
+export { type ClientGeneratorOptions, type CompiledRoute, ERROR_RESPONSES, ForbiddenError, type InferResponse, type InferSchema, type InflightTracker, Kozo, type KozoConfig, type KozoContext, type KozoEnv, KozoError, type KozoHandler, type NativeKozoContext, type NativeKozoHandler, NotFoundError, type OpenAPIConfig, OpenAPIGenerator, type OpenAPIInfo, type OpenAPISpec, type Plugin, type ProblemDetails, type RouteInfo, type RouteSchema, SchemaCompiler, type Services, ShutdownManager, type ShutdownOptions, type ShutdownState, UnauthorizedError, type ValidationError, ValidationFailedError, buildNativeContext, compileRouteHandler, createInflightTracker, createKozo, createOpenAPIGenerator, createShutdownManager, deletedSchema, fastCL, fastWrite400, fastWrite404, fastWrite500, fastWriteError, fastWriteHtml, fastWriteJson, fastWriteJsonStatus, fastWriteText, forbiddenResponse, formatAjvErrors, formatZodErrors, generateSwaggerHtml, generateTypedClient, idParams, internalErrorResponse, notFoundResponse, paginationSchema, trackRequest, unauthorizedResponse, uuidParams, validationErrorResponse };

package/lib/index.js

@@ -257,6 +257,7 @@ function formatAjvErrors(errors) {
   if (!errors || errors.length === 0) return [];
   return errors.map((err) => ({
     field: err.instancePath?.replace(/^\//, "").replace(/\//g, ".") || err.params?.missingProperty || "unknown",
+    path: err.path,
     message: err.message || "Invalid value",
     code: err.keyword || "invalid",
     value: err.data
@@ -741,7 +742,9 @@ function makeZValidator(schema) {
     }
     fn.errors = r.error.issues.map((i) => ({
       instancePath: i.path.length ? "/" + i.path.join("/") : "",
-      message: i.message
+      message: i.message,
+      keyword: i.code,
+      path: i.path
     }));
     return false;
   };
@@ -2207,20 +2210,25 @@ var Kozo = class {
     }));
     return generateTypedClient(routeInfos, options);
   }
-  get(path, schema, handler) {
-    return this.register("get", path, schema, handler);
+  get(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") return this.register("get", path, {}, schemaOrHandler);
+    return this.register("get", path, schemaOrHandler, handler);
   }
-  post(path, schema, handler) {
-    return this.register("post", path, schema, handler);
+  post(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") return this.register("post", path, {}, schemaOrHandler);
+    return this.register("post", path, schemaOrHandler, handler);
   }
-  put(path, schema, handler) {
-    return this.register("put", path, schema, handler);
+  put(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") return this.register("put", path, {}, schemaOrHandler);
+    return this.register("put", path, schemaOrHandler, handler);
   }
-  patch(path, schema, handler) {
-    return this.register("patch", path, schema, handler);
+  patch(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") return this.register("patch", path, {}, schemaOrHandler);
+    return this.register("patch", path, schemaOrHandler, handler);
   }
-  delete(path, schema, handler) {
-    return this.register("delete", path, schema, handler);
+  delete(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") return this.register("delete", path, {}, schemaOrHandler);
+    return this.register("delete", path, schemaOrHandler, handler);
   }
   register(method, path, schema, handler) {
     this.routes.push({ method, path, schema });
@@ -2378,7 +2386,7 @@ function buildNativeContext(req, res, params, body, services, serialize) {
 }
 
 // src/index.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 
 // src/openapi.ts
 import { zodToJsonSchema as _zodToJsonSchema } from "zod-to-json-schema";
@@ -2794,6 +2802,23 @@ async function applyFileSystemRouting(app, options = {}) {
 function createFileSystemRouting(options = {}) {
   return (app) => applyFileSystemRouting(app, options);
 }
+
+// src/helpers.ts
+import { z } from "zod";
+var paginationSchema = z.object({
+  page: z.coerce.number().int().min(1).default(1),
+  limit: z.coerce.number().int().min(1).max(100).default(10)
+});
+var uuidParams = z.object({
+  id: z.string().uuid()
+});
+var idParams = z.object({
+  id: z.coerce.number().int().positive()
+});
+var deletedSchema = z.object({
+  success: z.boolean(),
+  deletedId: z.string()
+});
 export {
   ERROR_RESPONSES,
   ForbiddenError,
@@ -2822,6 +2847,7 @@ export {
   createKozo,
   createOpenAPIGenerator,
   createShutdownManager,
+  deletedSchema,
   errorHandler,
   fastCL,
   fastWrite400,
@@ -2837,13 +2863,16 @@ export {
   formatZodErrors,
   generateSwaggerHtml,
   generateTypedClient,
+  idParams,
   internalErrorResponse,
   logger,
   notFoundResponse,
+  paginationSchema,
   rateLimit,
   trackRequest,
   unauthorizedResponse,
+  uuidParams,
   validationErrorResponse,
-  z
+  z2 as z
 };
 //# sourceMappingURL=index.js.map