@kozojs/core 0.3.11 → 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;
     /**
@@ -657,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

@@ -2210,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 });
@@ -2381,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";
@@ -2797,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,
@@ -2825,6 +2847,7 @@ export {
   createKozo,
   createOpenAPIGenerator,
   createShutdownManager,
+  deletedSchema,
   errorHandler,
   fastCL,
   fastWrite400,
@@ -2840,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