glasswork 0.1.0

package/dist/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/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/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,CAUd;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,SAAM,GAAG,eAAe,CAI/E"}

package/dist/pagination.js

@@ -0,0 +1,43 @@
+/**
+ * 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);
+    // Set pagination headers
+    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/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/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,yBAAyB;IACzB,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/dist/pick.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Creates a new object by picking specified keys from the source object.
+ *
+ * This implementation preserves the object's prototype, making it suitable
+ * for use with class instances and objects with custom prototypes.
+ *
+ * @template T - The type of the source object
+ * @template K - The type of keys to pick (must be keys of T)
+ * @param obj - The source object to pick keys from
+ * @param paths - Array of keys to pick from the object
+ * @returns A new object containing only the specified keys
+ *
+ * @example
+ * ```typescript
+ * const user = { id: 1, name: 'John', email: 'john@example.com', password: 'secret' };
+ * const publicUser = pick(user, ['id', 'name']); // { id: 1, name: 'John' }
+ * ```
+ */
+export declare function pick<T extends object, K extends keyof T>(obj: T, paths: K[]): Pick<T, K>;
+//# sourceMappingURL=pick.d.ts.map

package/dist/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../src/pick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAUxF"}

package/dist/pick.js

@@ -0,0 +1,28 @@
+/**
+ * Creates a new object by picking specified keys from the source object.
+ *
+ * This implementation preserves the object's prototype, making it suitable
+ * for use with class instances and objects with custom prototypes.
+ *
+ * @template T - The type of the source object
+ * @template K - The type of keys to pick (must be keys of T)
+ * @param obj - The source object to pick keys from
+ * @param paths - Array of keys to pick from the object
+ * @returns A new object containing only the specified keys
+ *
+ * @example
+ * ```typescript
+ * const user = { id: 1, name: 'John', email: 'john@example.com', password: 'secret' };
+ * const publicUser = pick(user, ['id', 'name']); // { id: 1, name: 'John' }
+ * ```
+ */
+export function pick(obj, paths) {
+    const result = Object.create(Object.getPrototypeOf(obj));
+    for (const key of paths) {
+        if (Object.hasOwn(obj, key)) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=pick.js.map

package/dist/pick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.js","sourceRoot":"","sources":["../src/pick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAsC,GAAM,EAAE,KAAU;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAe,CAAC;IAEvE,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/rate-limit.d.ts

@@ -0,0 +1,7 @@
+import type { MiddlewareHandler } from 'hono';
+import type { RateLimitOptions } from './types.js';
+/**
+ * Create rate limiting middleware
+ */
+export declare function createRateLimitMiddleware(options: RateLimitOptions): MiddlewareHandler;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkKnD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAuDtF"}

package/dist/rate-limit.js

@@ -0,0 +1,180 @@
+/**
+ * In-memory rate limiter storage
+ */
+class MemoryStore {
+    store = new Map();
+    async get(key) {
+        const item = this.store.get(key);
+        if (!item) {
+            return null;
+        }
+        if (item.windowEnd < Date.now()) {
+            this.store.delete(key);
+            return null;
+        }
+        return item;
+    }
+    async set(key, value) {
+        this.store.set(key, value);
+    }
+    async increment(key) {
+        const item = this.store.get(key);
+        if (item) {
+            item.count += 1;
+        }
+    }
+    // Cleanup expired entries periodically
+    startCleanup(intervalMs = 60000) {
+        setInterval(() => {
+            const now = Date.now();
+            for (const [key, item] of this.store.entries()) {
+                if (item.windowEnd < now) {
+                    this.store.delete(key);
+                }
+            }
+        }, intervalMs);
+    }
+}
+/**
+ * DynamoDB rate limiter storage
+ */
+class DynamoDBStore {
+    client;
+    tableName;
+    constructor(tableName, region) {
+        this.tableName = tableName;
+        // Lazy load AWS SDK only when needed
+        this.initClient(region);
+    }
+    async initClient(region) {
+        const { DynamoDBClient } = await import('@aws-sdk/client-dynamodb');
+        const { DynamoDBDocumentClient } = await import('@aws-sdk/lib-dynamodb');
+        const dynamoClient = new DynamoDBClient(region ? { region } : {});
+        this.client = DynamoDBDocumentClient.from(dynamoClient);
+    }
+    async get(key) {
+        const { GetCommand } = await import('@aws-sdk/lib-dynamodb');
+        const client = this.client;
+        try {
+            // @ts-expect-error - client type is complex
+            const { Item } = await client.send(new GetCommand({
+                TableName: this.tableName,
+                Key: { bucketId: key },
+            }));
+            if (!Item || Item.windowEnd < Date.now()) {
+                return null;
+            }
+            return {
+                count: Item.count,
+                windowEnd: Item.windowEnd,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        const { PutCommand } = await import('@aws-sdk/lib-dynamodb');
+        const client = this.client;
+        const expiresAt = Math.floor(value.windowEnd / 1000);
+        try {
+            // @ts-expect-error - client type is complex
+            await client.send(new PutCommand({
+                TableName: this.tableName,
+                Item: {
+                    bucketId: key,
+                    count: value.count,
+                    windowEnd: value.windowEnd,
+                    expiresAt,
+                },
+            }));
+        }
+        catch (error) {
+            console.error('[Glasswork] DynamoDB rate limit set failed:', error);
+        }
+    }
+    async increment(key) {
+        const { UpdateCommand } = await import('@aws-sdk/lib-dynamodb');
+        const client = this.client;
+        try {
+            // @ts-expect-error - client type is complex
+            await client.send(new UpdateCommand({
+                TableName: this.tableName,
+                Key: { bucketId: key },
+                UpdateExpression: 'SET #c = #c + :inc',
+                ExpressionAttributeNames: { '#c': 'count' },
+                ExpressionAttributeValues: { ':inc': 1 },
+            }));
+        }
+        catch (error) {
+            console.error('[Glasswork] DynamoDB rate limit increment failed:', error);
+        }
+    }
+}
+/**
+ * Extract client IP from request context
+ */
+function getClientIdentifier(context) {
+    // Check various headers for client IP
+    const forwarded = context.req.header('x-forwarded-for');
+    if (forwarded) {
+        return forwarded.split(',')[0].trim();
+    }
+    const realIp = context.req.header('x-real-ip');
+    if (realIp) {
+        return realIp;
+    }
+    return 'unknown';
+}
+/**
+ * Create rate limiting middleware
+ */
+export function createRateLimitMiddleware(options) {
+    const { storage, windowMs = 60000, maxRequests = 100, dynamodb } = options;
+    // Create appropriate storage backend
+    const store = storage === 'dynamodb' && dynamodb
+        ? new DynamoDBStore(dynamodb.tableName, dynamodb.region)
+        : new MemoryStore();
+    // Start cleanup for memory store
+    if (store instanceof MemoryStore) {
+        store.startCleanup();
+    }
+    return async (context, next) => {
+        const clientId = getClientIdentifier(context);
+        const now = Date.now();
+        const windowEnd = now + windowMs;
+        const setHeaders = (remaining, resetMs) => {
+            context.header('RateLimit-Limit', String(maxRequests));
+            context.header('RateLimit-Remaining', String(Math.max(0, remaining)));
+            context.header('RateLimit-Reset', String(Math.ceil(resetMs / 1000)));
+        };
+        try {
+            const item = await store.get(clientId);
+            // New window or expired
+            if (!item) {
+                await store.set(clientId, { count: 1, windowEnd });
+                setHeaders(maxRequests - 1, windowMs);
+                await next();
+                return;
+            }
+            // Rate limit exceeded
+            if (item.count >= maxRequests) {
+                const retryMs = item.windowEnd - now;
+                setHeaders(0, retryMs);
+                context.header('Retry-After', String(Math.ceil(retryMs / 1000)));
+                return context.json({ error: 'Too Many Requests' }, 429);
+            }
+            // Increment counter
+            await store.increment(clientId);
+            setHeaders(maxRequests - (item.count + 1), item.windowEnd - now);
+            await next();
+        }
+        catch (error) {
+            console.error('[Glasswork] Rate limiter error:', error);
+            // Fail open - allow request
+            setHeaders(maxRequests, windowMs);
+            await next();
+        }
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"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"}

package/dist/route-helpers.d.ts

@@ -0,0 +1,172 @@
+import type { Context, Hono, MiddlewareHandler } from 'hono';
+import type { DescribeRouteOptions } from 'hono-openapi';
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, InferOutput } from 'valibot';
+import type { OpenAPIResponseHook } from './types.js';
+/**
+ * Set the global OpenAPI response hooks.
+ * This is called during bootstrap and makes hooks available to route definitions.
+ *
+ * @internal
+ */
+export declare function setGlobalResponseHooks(hooks: OpenAPIResponseHook[]): void;
+/**
+ * Get the current global OpenAPI response hooks.
+ *
+ * @internal
+ */
+export declare function getGlobalResponseHooks(): OpenAPIResponseHook[];
+/**
+ * Valibot schema type (compatible with both sync and async schemas)
+ */
+export type ValibotSchema = BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>;
+/**
+ * Helper type to infer the output type from a Valibot schema
+ */
+type InferSchemaType<T> = T extends ValibotSchema ? InferOutput<T> : never;
+/**
+ * Helper type to infer the response type from the 200/201 status code schema
+ *
+ * Prisma client extension converts Date → string at the database layer,
+ * so handlers return string-based entities that match the response schema output type.
+ */
+type InferResponseType<T> = T extends {
+    200: infer TSchema;
+} ? TSchema extends ValibotSchema ? InferOutput<TSchema> : unknown : T extends {
+    201: infer TSchema;
+} ? TSchema extends ValibotSchema ? InferOutput<TSchema> : unknown : unknown;
+/**
+ * HTTP status codes with descriptions
+ */
+declare const STATUS_DESCRIPTIONS: {
+    readonly 200: "Success";
+    readonly 201: "Created";
+    readonly 204: "No Content";
+    readonly 400: "Bad Request";
+    readonly 401: "Unauthorized";
+    readonly 403: "Forbidden";
+    readonly 404: "Not Found";
+    readonly 409: "Conflict";
+    readonly 422: "Unprocessable Entity";
+    readonly 429: "Too Many Requests";
+    readonly 500: "Internal Server Error";
+};
+/**
+ * Route factory function type.
+ * Receives a real Hono instance and services from DI container.
+ */
+export type RouteFactory = (router: Hono, services: Record<string, unknown>) => void;
+/**
+ * Create routes with typed service injection.
+ *
+ * @template TServices - The shape of services required by these routes
+ *
+ * @example
+ * ```typescript
+ * interface AuthRoutesServices {
+ *   authService: AuthService;
+ *   userService: UserService;
+ * }
+ *
+ * export const authRoutes = createRoutes<AuthRoutesServices>((router, services) => {
+ *   // services.authService is typed as AuthService!
+ *   // services.userService is typed as UserService!
+ *   router.post('/login', ...);
+ * });
+ * ```
+ */
+export declare function createRoutes<TServices = Record<string, unknown>>(factory: (router: Hono, services: TServices) => void): RouteFactory;
+/**
+ * Route configuration with automatic type inference from Valibot schemas
+ *
+ * @template TBody - The body schema (automatically inferred)
+ * @template TResponses - The responses object (automatically inferred)
+ */
+export interface RouteConfig<TBody extends ValibotSchema | undefined = undefined, TResponses extends Partial<Record<keyof typeof STATUS_DESCRIPTIONS, ValibotSchema | undefined>> = Record<never, never>, TPublic extends boolean = false> {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    operationId?: string;
+    /**
+     * Whether this is a public route (no authentication required)
+     * - false (default): Session is required and typed as non-nullable
+     * - true: Session is optional and typed as nullable
+     */
+    public?: TPublic;
+    body?: TBody;
+    query?: ValibotSchema;
+    params?: ValibotSchema;
+    responses?: TResponses;
+    openapi?: Partial<Omit<DescribeRouteOptions, 'responses' | 'operationId' | 'tags' | 'summary' | 'description'>>;
+    /**
+     * Custom middleware to apply before validation and handler
+     */
+    middleware?: MiddlewareHandler[];
+    /**
+     * Enable pagination - adds pagination query params and response headers to OpenAPI spec
+     */
+    paginate?: boolean;
+    /**
+     * Route handler - body and return types are automatically inferred from schemas
+     * Session is required by default (unless public: true)
+     *
+     * Prisma client extension converts Date → string at the database layer,
+     * so handler return types match the response schema output type.
+     */
+    handler: (context: RouteContext<TBody extends ValibotSchema ? InferSchemaType<TBody> : never, TPublic extends true ? false : true>) => Promise<InferResponseType<TResponses>> | InferResponseType<TResponses>;
+}
+/**
+ * Route handler context with typed body
+ *
+ * Leverages Hono's ContextVariableMap for session typing.
+ * If your middleware extends ContextVariableMap (e.g., auth middleware),
+ * the session will be automatically typed in route handlers.
+ *
+ * @template TBody - The typed body (inferred from schema)
+ * @template TSessionRequired - Whether session is guaranteed to exist (true by default, false for public routes)
+ */
+export interface RouteContext<TBody = never, TSessionRequired extends boolean = true> {
+    body: TBody;
+    query: Record<string, string>;
+    params: Record<string, string>;
+    services: Record<string, unknown>;
+    /**
+     * Session from context variables (typed via Hono's ContextVariableMap)
+     * - Required by default (for authenticated routes)
+     * - Optional only for public routes (public: true)
+     */
+    session: TSessionRequired extends true ? NonNullable<Context['var']['session']> : Context['var']['session'];
+    /**
+     * Client IP address (extracted from headers and connection info)
+     */
+    ip: string;
+    /**
+     * User agent string from request headers
+     */
+    userAgent: string | undefined;
+    /**
+     * Original Hono context (for advanced use cases)
+     */
+    context: Context;
+}
+/**
+ * Create a route handler with validation and OpenAPI metadata.
+ *
+ * Type inference works automatically:
+ * - Body type is inferred from the `body` schema
+ * - Return type is inferred from the `responses[200]` schema
+ *
+ * @example
+ * ```typescript
+ * route({
+ *   body: StartSessionDto,
+ *   responses: { 200: StartSessionResponseDto },
+ *   handler: async ({ body }) => {
+ *     // body is typed as InferOutput<typeof StartSessionDto>
+ *     return { email: body.email }; // Must match StartSessionResponseDto
+ *   }
+ * })
+ * ```
+ */
+export declare function route<TBody extends ValibotSchema | undefined = undefined, TResponses extends Partial<Record<keyof typeof STATUS_DESCRIPTIONS, ValibotSchema | undefined>> = Record<never, never>, TPublic extends boolean = false>(config: RouteConfig<TBody, TResponses, TPublic>): MiddlewareHandler[];
+export {};
+//# sourceMappingURL=route-helpers.d.ts.map

package/dist/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../src/route-helpers.ts"],"names":[],"mappings":"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"}