raffel 0.1.2

package/dist/http/context.js

@@ -0,0 +1,217 @@
+/**
+ * HttpContext - Hono-compatible HTTP Context
+ *
+ * Provides:
+ * - Request helpers: c.req.param(), c.req.query(), c.req.json(), c.req.header(), etc.
+ * - Response helpers: c.json(), c.text(), c.html(), c.body(), c.redirect()
+ * - Context storage: c.set(), c.get(), c.var
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// HttpRequest Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+class HttpRequestImpl {
+    raw;
+    params;
+    parsedUrl;
+    queryParams = null;
+    headersObj = null;
+    cachedBody = {};
+    constructor(request, params) {
+        this.raw = request;
+        this.params = params;
+        this.parsedUrl = new URL(request.url);
+    }
+    get method() {
+        return this.raw.method;
+    }
+    get url() {
+        return this.raw.url;
+    }
+    get path() {
+        return this.parsedUrl.pathname;
+    }
+    param(name) {
+        if (name === undefined) {
+            return { ...this.params };
+        }
+        return this.params[name];
+    }
+    query(name) {
+        if (this.queryParams === null) {
+            this.queryParams = {};
+            for (const [key, value] of this.parsedUrl.searchParams) {
+                this.queryParams[key] = value;
+            }
+        }
+        if (name === undefined) {
+            return { ...this.queryParams };
+        }
+        return this.queryParams[name];
+    }
+    header(name) {
+        if (this.headersObj === null) {
+            this.headersObj = {};
+            this.raw.headers.forEach((value, key) => {
+                this.headersObj[key.toLowerCase()] = value;
+            });
+        }
+        if (name === undefined) {
+            return { ...this.headersObj };
+        }
+        return this.headersObj[name.toLowerCase()];
+    }
+    async json() {
+        if ('json' in this.cachedBody) {
+            return this.cachedBody.json;
+        }
+        const text = await this.text();
+        const json = JSON.parse(text);
+        this.cachedBody.json = json;
+        return json;
+    }
+    async text() {
+        if ('text' in this.cachedBody && this.cachedBody.text !== undefined) {
+            return this.cachedBody.text;
+        }
+        const text = await this.raw.text();
+        this.cachedBody.text = text;
+        return text;
+    }
+    async arrayBuffer() {
+        return this.raw.arrayBuffer();
+    }
+    async blob() {
+        return this.raw.blob();
+    }
+    async formData() {
+        return this.raw.formData();
+    }
+    valid(target) {
+        if (target === 'json' && 'json' in this.cachedBody) {
+            return this.cachedBody.json;
+        }
+        throw new Error('No validated data available');
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// HttpContext Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+export class HttpContext {
+    req;
+    res;
+    event;
+    executionCtx;
+    variables = {};
+    responseHeaders = new Headers();
+    responseStatus = 200;
+    constructor(request, params = {}) {
+        this.req = new HttpRequestImpl(request, params);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Context Storage
+    // ───────────────────────────────────────────────────────────────────────────
+    set(key, value) {
+        this.variables[key] = value;
+    }
+    get(key) {
+        return this.variables[key];
+    }
+    get var() {
+        return this.variables;
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Response Helpers
+    // ───────────────────────────────────────────────────────────────────────────
+    header(name, value) {
+        this.responseHeaders.set(name, value);
+    }
+    status(code) {
+        this.responseStatus = code;
+    }
+    json(data, statusOrInit, headers) {
+        const body = JSON.stringify(data);
+        let status = this.responseStatus;
+        let initHeaders;
+        if (typeof statusOrInit === 'number') {
+            status = statusOrInit;
+            initHeaders = headers;
+        }
+        else if (statusOrInit) {
+            status = statusOrInit.status ?? this.responseStatus;
+            initHeaders = statusOrInit.headers;
+        }
+        const responseHeaders = new Headers(initHeaders);
+        responseHeaders.set('Content-Type', 'application/json; charset=UTF-8');
+        // Merge with response headers set via header()
+        this.responseHeaders.forEach((value, key) => {
+            if (!responseHeaders.has(key)) {
+                responseHeaders.set(key, value);
+            }
+        });
+        return new Response(body, {
+            status,
+            headers: responseHeaders,
+        });
+    }
+    text(data, status, headers) {
+        const responseHeaders = new Headers(headers);
+        responseHeaders.set('Content-Type', 'text/plain; charset=UTF-8');
+        this.responseHeaders.forEach((value, key) => {
+            if (!responseHeaders.has(key)) {
+                responseHeaders.set(key, value);
+            }
+        });
+        return new Response(data, {
+            status: status ?? this.responseStatus,
+            headers: responseHeaders,
+        });
+    }
+    html(data, status, headers) {
+        const responseHeaders = new Headers(headers);
+        responseHeaders.set('Content-Type', 'text/html; charset=UTF-8');
+        this.responseHeaders.forEach((value, key) => {
+            if (!responseHeaders.has(key)) {
+                responseHeaders.set(key, value);
+            }
+        });
+        return new Response(data, {
+            status: status ?? this.responseStatus,
+            headers: responseHeaders,
+        });
+    }
+    body(data, status, headers) {
+        const responseHeaders = new Headers(headers);
+        this.responseHeaders.forEach((value, key) => {
+            if (!responseHeaders.has(key)) {
+                responseHeaders.set(key, value);
+            }
+        });
+        return new Response(data, {
+            status: status ?? this.responseStatus,
+            headers: responseHeaders,
+        });
+    }
+    redirect(location, status = 302) {
+        return Response.redirect(location, status);
+    }
+    notFound() {
+        return new Response('Not Found', { status: 404 });
+    }
+    newResponse(body, init) {
+        const responseHeaders = new Headers(init?.headers);
+        this.responseHeaders.forEach((value, key) => {
+            if (!responseHeaders.has(key)) {
+                responseHeaders.set(key, value);
+            }
+        });
+        return new Response(body, {
+            ...init,
+            headers: responseHeaders,
+        });
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default HttpContext;
+//# sourceMappingURL=context.js.map

package/dist/http/context.js.map

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

package/dist/http/cookie.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Cookie Utilities
+ *
+ * Hono-compatible cookie helpers for HTTP handlers.
+ * Provides getCookie, setCookie, deleteCookie, and generateCookie functions.
+ *
+ * @example
+ * ```typescript
+ * import { getCookie, setCookie, deleteCookie } from 'raffel/http/cookie'
+ *
+ * // In a handler
+ * const session = getCookie(ctx, 'session')
+ * setCookie(ctx, 'token', 'abc123', { httpOnly: true, secure: true })
+ * deleteCookie(ctx, 'old-session')
+ * ```
+ */
+/**
+ * Cookie options for setCookie
+ */
+export interface CookieOptions {
+    /** Domain for the cookie */
+    domain?: string;
+    /** Expiration date */
+    expires?: Date;
+    /** HTTP only flag (not accessible via JavaScript) */
+    httpOnly?: boolean;
+    /** Max age in seconds */
+    maxAge?: number;
+    /** Cookie path */
+    path?: string;
+    /** Secure flag (HTTPS only) */
+    secure?: boolean;
+    /** SameSite attribute */
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    /** Partitioned attribute (CHIPS) */
+    partitioned?: boolean;
+    /** Priority hint */
+    priority?: 'Low' | 'Medium' | 'High';
+    /** Prefix (__Host- or __Secure-) */
+    prefix?: 'host' | 'secure';
+}
+/**
+ * Signed cookie options
+ */
+export interface SignedCookieOptions extends CookieOptions {
+    /** Secret for signing */
+    secret: string;
+}
+/**
+ * Context interface for cookie operations.
+ * Compatible with Hono's Context and Raffel's HttpContext.
+ */
+export interface CookieContext {
+    req: {
+        header(name: string): string | undefined;
+        raw?: {
+            headers?: {
+                cookie?: string;
+            };
+        };
+    };
+    header(name: string, value: string, options?: {
+        append?: boolean;
+    }): void;
+}
+/**
+ * Parse a cookie header string into key-value pairs
+ *
+ * @example
+ * ```typescript
+ * parseCookies('session=abc123; theme=dark')
+ * // => { session: 'abc123', theme: 'dark' }
+ * ```
+ */
+export declare function parseCookies(cookieHeader: string | undefined | null): Record<string, string>;
+/**
+ * Get a specific cookie value from the request
+ *
+ * @example
+ * ```typescript
+ * const session = getCookie(ctx, 'session')
+ * if (!session) {
+ *   return ctx.json({ error: 'Not authenticated' }, 401)
+ * }
+ * ```
+ */
+export declare function getCookie(ctx: CookieContext, name: string): string | undefined;
+/**
+ * Get all cookies from the request
+ *
+ * @example
+ * ```typescript
+ * const cookies = getCookies(ctx)
+ * console.log(cookies) // { session: 'abc', theme: 'dark' }
+ * ```
+ */
+export declare function getCookies(ctx: CookieContext): Record<string, string>;
+/**
+ * Generate a Set-Cookie header value string
+ *
+ * @example
+ * ```typescript
+ * const cookieStr = generateCookie('session', 'abc123', {
+ *   httpOnly: true,
+ *   secure: true,
+ *   sameSite: 'Lax',
+ *   maxAge: 3600
+ * })
+ * // => "session=abc123; HttpOnly; Secure; SameSite=Lax; Max-Age=3600"
+ * ```
+ */
+export declare function generateCookie(name: string, value: string, options?: CookieOptions): string;
+/**
+ * Set a cookie in the response
+ *
+ * @example
+ * ```typescript
+ * setCookie(ctx, 'session', 'abc123', {
+ *   httpOnly: true,
+ *   secure: true,
+ *   sameSite: 'Lax',
+ *   path: '/',
+ *   maxAge: 60 * 60 * 24 * 7 // 1 week
+ * })
+ * ```
+ */
+export declare function setCookie(ctx: CookieContext, name: string, value: string, options?: CookieOptions): void;
+/**
+ * Delete a cookie by setting it to expire immediately
+ *
+ * @example
+ * ```typescript
+ * deleteCookie(ctx, 'session')
+ * deleteCookie(ctx, 'token', { path: '/api', domain: '.example.com' })
+ * ```
+ */
+export declare function deleteCookie(ctx: CookieContext, name: string, options?: Pick<CookieOptions, 'domain' | 'path' | 'secure' | 'prefix'>): void;
+/**
+ * Set multiple cookies at once
+ *
+ * @example
+ * ```typescript
+ * setCookies(ctx, {
+ *   session: 'abc123',
+ *   theme: 'dark',
+ *   locale: 'en-US'
+ * }, { path: '/' })
+ * ```
+ */
+export declare function setCookies(ctx: CookieContext, cookies: Record<string, string>, options?: CookieOptions): void;
+/**
+ * Delete multiple cookies at once
+ *
+ * @example
+ * ```typescript
+ * deleteCookies(ctx, ['session', 'token', 'refresh'])
+ * ```
+ */
+export declare function deleteCookies(ctx: CookieContext, names: string[], options?: Pick<CookieOptions, 'domain' | 'path' | 'secure' | 'prefix'>): void;
+/**
+ * Get a signed cookie value (verifies signature)
+ *
+ * @example
+ * ```typescript
+ * const userId = await getSignedCookie(ctx, 'user_id', 'my-secret-key')
+ * if (!userId) {
+ *   // Cookie missing or signature invalid
+ * }
+ * ```
+ */
+export declare function getSignedCookie(ctx: CookieContext, name: string, secret: string): Promise<string | false>;
+/**
+ * Set a signed cookie (includes HMAC signature)
+ *
+ * @example
+ * ```typescript
+ * await setSignedCookie(ctx, 'user_id', '12345', 'my-secret-key', {
+ *   httpOnly: true,
+ *   secure: true
+ * })
+ * ```
+ */
+export declare function setSignedCookie(ctx: CookieContext, name: string, value: string, secret: string, options?: CookieOptions): Promise<void>;
+/**
+ * Set a __Host- prefixed cookie (most secure)
+ * Automatically sets: Secure, Path=/
+ * Cannot have Domain attribute
+ *
+ * @example
+ * ```typescript
+ * setHostCookie(ctx, 'session', 'abc123', { httpOnly: true })
+ * // Sets: __Host-session=abc123; Secure; Path=/; HttpOnly
+ * ```
+ */
+export declare function setHostCookie(ctx: CookieContext, name: string, value: string, options?: Omit<CookieOptions, 'prefix' | 'domain' | 'secure' | 'path'>): void;
+/**
+ * Set a __Secure- prefixed cookie
+ * Automatically sets: Secure
+ *
+ * @example
+ * ```typescript
+ * setSecureCookie(ctx, 'token', 'xyz789', { httpOnly: true, path: '/api' })
+ * // Sets: __Secure-token=xyz789; Secure; HttpOnly; Path=/api
+ * ```
+ */
+export declare function setSecureCookie(ctx: CookieContext, name: string, value: string, options?: Omit<CookieOptions, 'prefix' | 'secure'>): void;
+/**
+ * Details about a cookie chunk overflow
+ */
+export interface CookieChunkOverflowDetails {
+    cookieName: string;
+    chunkCount: number;
+    chunkLimit: number;
+    payloadBytes: number;
+}
+/**
+ * Error thrown when a cookie is too large to chunk
+ */
+export declare class CookieChunkOverflowError extends Error {
+    name: string;
+    code: string;
+    details: CookieChunkOverflowDetails;
+    constructor(details: CookieChunkOverflowDetails);
+}
+/**
+ * Options for chunked cookie operations
+ */
+export interface ChunkingOptions {
+    /** Handler called when chunk limit is exceeded. Return true to suppress error. */
+    onOverflow?: (details: CookieChunkOverflowDetails & {
+        value: string;
+    }) => boolean | void;
+    /** Maximum cookie size before chunking (default: 4000) */
+    maxCookieSize?: number;
+    /** Maximum number of chunks (default: 10) */
+    maxChunks?: number;
+}
+/**
+ * Set a chunked cookie (automatically splits large values)
+ *
+ * Use this for potentially large values like JWT tokens or session data.
+ * The cookie is split into multiple cookies with .0, .1, .2 suffixes,
+ * plus a .__chunks cookie to track the count.
+ *
+ * @example
+ * ```typescript
+ * // Set a large session cookie
+ * setChunkedCookie(ctx, 'session', largeJwtToken, {
+ *   httpOnly: true,
+ *   secure: true,
+ *   sameSite: 'Lax'
+ * })
+ *
+ * // Later, read it back
+ * const session = getChunkedCookie(ctx, 'session')
+ * ```
+ */
+export declare function setChunkedCookie(ctx: CookieContext, name: string, value: string | null | undefined, options?: CookieOptions, chunkingOptions?: ChunkingOptions): void;
+/**
+ * Get a chunked cookie (automatically reassembles chunks)
+ *
+ * @example
+ * ```typescript
+ * const session = getChunkedCookie(ctx, 'session')
+ * if (!session) {
+ *   return ctx.json({ error: 'No session' }, 401)
+ * }
+ * ```
+ */
+export declare function getChunkedCookie(ctx: CookieContext, name: string): string | null;
+/**
+ * Delete a chunked cookie (clears all chunks)
+ *
+ * @example
+ * ```typescript
+ * deleteChunkedCookie(ctx, 'session')
+ * ```
+ */
+export declare function deleteChunkedCookie(ctx: CookieContext, name: string, options?: Pick<CookieOptions, 'domain' | 'path' | 'secure'>): void;
+/**
+ * Check if a cookie is chunked
+ *
+ * @example
+ * ```typescript
+ * if (isChunkedCookie(ctx, 'session')) {
+ *   console.log('Session cookie is chunked')
+ * }
+ * ```
+ */
+export declare function isChunkedCookie(ctx: CookieContext, name: string): boolean;
+//# sourceMappingURL=cookie.d.ts.map

package/dist/http/cookie.d.ts.map

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