@kozojs/core 0.3.12 → 0.3.13

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;
@@ -2230,6 +2261,20 @@ var Kozo = class {
     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 });
     const compiled = SchemaCompiler.compile(schema);
@@ -2805,6 +2850,28 @@ function createFileSystemRouting(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)
@@ -2831,6 +2898,7 @@ export {
   UnauthorizedError2 as HttpUnauthorizedError,
   Kozo,
   KozoError,
+  KozoGroup,
   NotFoundError,
   OpenAPIGenerator,
   SchemaCompiler,
@@ -2847,6 +2915,7 @@ export {
   createKozo,
   createOpenAPIGenerator,
   createShutdownManager,
+  defineEnv,
   deletedSchema,
   errorHandler,
   fastCL,
@@ -2867,6 +2936,7 @@ export {
   internalErrorResponse,
   logger,
   notFoundResponse,
+  paginate,
   paginationSchema,
   rateLimit,
   trackRequest,