@kozojs/core 0.3.11 → 0.3.13

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

@@ -2144,6 +2144,37 @@ function routeScore(path) {
 }
 
 // src/app.ts
+var KozoGroup = class {
+  constructor(prefix, parent) {
+    this.prefix = prefix;
+    this.parent = parent;
+  }
+  get(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") this.parent.get(this.prefix + path, schemaOrHandler);
+    else this.parent.get(this.prefix + path, schemaOrHandler, handler);
+    return this;
+  }
+  post(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") this.parent.post(this.prefix + path, schemaOrHandler);
+    else this.parent.post(this.prefix + path, schemaOrHandler, handler);
+    return this;
+  }
+  put(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") this.parent.put(this.prefix + path, schemaOrHandler);
+    else this.parent.put(this.prefix + path, schemaOrHandler, handler);
+    return this;
+  }
+  patch(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") this.parent.patch(this.prefix + path, schemaOrHandler);
+    else this.parent.patch(this.prefix + path, schemaOrHandler, handler);
+    return this;
+  }
+  delete(path, schemaOrHandler, handler) {
+    if (typeof schemaOrHandler === "function") this.parent.delete(this.prefix + path, schemaOrHandler);
+    else this.parent.delete(this.prefix + path, schemaOrHandler, handler);
+    return this;
+  }
+};
 var Kozo = class {
   app;
   services;
@@ -2210,20 +2241,39 @@ 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);
+  }
+  /**
+   * Group routes under a common path prefix.
+   *
+   * @example
+   * app.group('/users', (r) => {
+   *   r.get('/',    { query: paginationSchema }, (ctx) => listUsers(ctx.query));
+   *   r.get('/:id', { params: uuidParams },     (ctx) => getUser(ctx.params.id));
+   *   r.post('/',   { body: CreateUserSchema }, (ctx) => createUser(ctx.body));
+   * });
+   */
+  group(prefix, fn) {
+    fn(new KozoGroup(prefix, this));
+    return this;
   }
   register(method, path, schema, handler) {
     this.routes.push({ method, path, schema });
@@ -2381,7 +2431,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 +2847,45 @@ async function applyFileSystemRouting(app, options = {}) {
 function createFileSystemRouting(options = {}) {
   return (app) => applyFileSystemRouting(app, options);
 }
+
+// src/helpers.ts
+import { z } from "zod";
+function defineEnv(shape) {
+  const schema = z.object(shape);
+  const result = schema.safeParse(process.env);
+  if (!result.success) {
+    const errors = result.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(`[Kozo] Invalid environment variables:
+${errors}`);
+  }
+  return result.data;
+}
+function paginate(items, page, limit) {
+  const start = (page - 1) * limit;
+  return {
+    data: items.slice(start, start + limit),
+    total: items.length,
+    page,
+    limit,
+    totalPages: Math.ceil(items.length / limit),
+    hasNext: start + limit < items.length,
+    hasPrev: page > 1
+  };
+}
+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,
@@ -2809,6 +2898,7 @@ export {
   UnauthorizedError2 as HttpUnauthorizedError,
   Kozo,
   KozoError,
+  KozoGroup,
   NotFoundError,
   OpenAPIGenerator,
   SchemaCompiler,
@@ -2825,6 +2915,8 @@ export {
   createKozo,
   createOpenAPIGenerator,
   createShutdownManager,
+  defineEnv,
+  deletedSchema,
   errorHandler,
   fastCL,
   fastWrite400,
@@ -2840,13 +2932,17 @@ export {
   formatZodErrors,
   generateSwaggerHtml,
   generateTypedClient,
+  idParams,
   internalErrorResponse,
   logger,
   notFoundResponse,
+  paginate,
+  paginationSchema,
   rateLimit,
   trackRequest,
   unauthorizedResponse,
+  uuidParams,
   validationErrorResponse,
-  z
+  z2 as z
 };
 //# sourceMappingURL=index.js.map