glasswork 0.5.0 → 0.6.0

package/dist/utils/pagination.d.ts

@@ -0,0 +1,48 @@
+import type { Context } from 'hono';
+/**
+ * Pagination input parameters
+ */
+export interface PaginationInput {
+    page: number;
+    limit: number;
+}
+/**
+ * Paginated output structure
+ */
+export interface PaginatedOutput<T> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Execute a paginated query and set response headers.
+ *
+ * This helper extracts pagination parameters from the query string,
+ * executes the provided function, and sets the appropriate response headers.
+ *
+ * @template T - The type of items in the result
+ * @param c - Hono context
+ * @param fn - Function that executes the paginated query
+ * @returns Array of items (headers are set as side effect)
+ *
+ * @example
+ * ```typescript
+ * router.get('/users', route({
+ *   paginate: true,
+ *   handler: async ({ context }) => {
+ *     return await paginate(context, (p) => userService.getUsers(p));
+ *   }
+ * }));
+ * ```
+ */
+export declare function paginate<T>(c: Context, fn: (p: PaginationInput) => Promise<PaginatedOutput<T>>): Promise<T[]>;
+/**
+ * Extract pagination parameters from Hono context.
+ *
+ * @param c - Hono context
+ * @param defaultLimit - Default limit if not provided (default: 100)
+ * @returns Pagination input with page and limit
+ */
+export declare function paginationInput(c: Context, defaultLimit?: number): PaginationInput;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,CAAC,EAAE,OAAO,EACV,EAAE,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,SAAM,GAAG,eAAe,CAI/E"}

package/dist/utils/pagination.js

@@ -0,0 +1,42 @@
+/**
+ * Execute a paginated query and set response headers.
+ *
+ * This helper extracts pagination parameters from the query string,
+ * executes the provided function, and sets the appropriate response headers.
+ *
+ * @template T - The type of items in the result
+ * @param c - Hono context
+ * @param fn - Function that executes the paginated query
+ * @returns Array of items (headers are set as side effect)
+ *
+ * @example
+ * ```typescript
+ * router.get('/users', route({
+ *   paginate: true,
+ *   handler: async ({ context }) => {
+ *     return await paginate(context, (p) => userService.getUsers(p));
+ *   }
+ * }));
+ * ```
+ */
+export async function paginate(c, fn) {
+    const pagination = paginationInput(c);
+    const result = await fn(pagination);
+    c.header('X-Total-Count', result.total.toString());
+    c.header('X-Page', result.page.toString());
+    c.header('X-Limit', result.limit.toString());
+    return result.data;
+}
+/**
+ * Extract pagination parameters from Hono context.
+ *
+ * @param c - Hono context
+ * @param defaultLimit - Default limit if not provided (default: 100)
+ * @returns Pagination input with page and limit
+ */
+export function paginationInput(c, defaultLimit = 100) {
+    const page = Number.parseInt(c.req.query('page') ?? '1', 10);
+    const limit = Number.parseInt(c.req.query('limit') ?? defaultLimit.toString(), 10);
+    return { page, limit };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,CAAU,EACV,EAAuD;IAEvD,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;IAEpC,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE7C,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,CAAU,EAAE,YAAY,GAAG,GAAG;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;IACnF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glasswork",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A transparent, Lambda-optimized web framework for building OpenAPI-compliant REST APIs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",