@xivdyetools/test-utils 1.0.0

package/LICENSE

@@ -0,0 +1,37 @@
+MIT License
+
+Copyright (c) 2025 Flash Galatine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+FINAL FANTASY XIV © SQUARE ENIX CO., LTD. All Rights Reserved.
+
+This project is a fan-made tool and is not affiliated with, endorsed by, or
+sponsored by Square Enix Co., Ltd. FINAL FANTASY is a registered trademark
+of Square Enix Holdings Co., Ltd.
+
+Game data, including dye names, colors, and acquisition methods, are property
+of Square Enix Co., Ltd. and are used under fair use for educational and
+informational purposes only.
+
+Market board data is provided by Universalis (https://universalis.app/),
+an independent third-party service not affiliated with Square Enix.
+

package/README.md

@@ -0,0 +1,144 @@
+# @xivdyetools/test-utils
+
+Shared testing utilities for the xivdyetools ecosystem. Provides mocks for Cloudflare Workers bindings, authentication helpers, domain object factories, and DOM utilities.
+
+## Installation
+
+```bash
+npm install -D @xivdyetools/test-utils
+```
+
+## Features
+
+- **Cloudflare Workers Mocks**: D1Database, KVNamespace, R2Bucket, AnalyticsEngineDataset, Fetcher (Service Bindings)
+- **Auth Helpers**: JWT creation/verification, HMAC signatures, auth context factories
+- **Domain Factories**: Preset, Category, Vote, User mock data factories
+- **DOM Utilities**: localStorage mock, Canvas mock, ResizeObserver mock
+- **Assertions**: Response assertion helpers for API testing
+
+## Usage
+
+### Cloudflare Mocks
+
+```typescript
+import { createMockD1Database, createMockKV, createMockFetcher } from '@xivdyetools/test-utils/cloudflare';
+
+// D1 Database mock with query tracking
+const db = createMockD1Database();
+db._setupMock((query, bindings) => {
+  if (query.includes('SELECT')) return { id: 1, name: 'Test' };
+  return null;
+});
+
+// Use in your tests
+const env = { DB: db as unknown as D1Database };
+
+// Check what queries were executed
+console.log(db._queries);    // ['SELECT ...']
+console.log(db._bindings);   // [['param1', 'param2']]
+
+// Reset between tests
+db._reset();
+```
+
+### Auth Helpers
+
+```typescript
+import { createTestJWT, createBotSignature, createAuthContext } from '@xivdyetools/test-utils/auth';
+
+// Create a valid JWT for testing
+const jwt = await createTestJWT('your-secret', {
+  sub: 'user-123',
+  username: 'TestUser',
+  global_name: 'Test User',
+});
+
+// Create HMAC signature for bot auth
+const signature = await createBotSignature(
+  timestamp,
+  'user-discord-id',
+  'username',
+  'signing-secret'
+);
+
+// Create auth context for middleware testing
+const ctx = createAuthContext({ isModerator: true });
+```
+
+### Domain Factories
+
+```typescript
+import {
+  createMockPreset,
+  createMockPresetRow,
+  createMockSubmission,
+  createMockUser,
+  resetCounters,
+} from '@xivdyetools/test-utils/factories';
+
+// Create mock domain objects
+const preset = createMockPreset({ name: 'Custom Name' });
+const row = createMockPresetRow({ status: 'pending' });
+const submission = createMockSubmission();
+
+// Reset auto-increment counters between tests
+beforeEach(() => resetCounters());
+```
+
+### DOM Utilities
+
+```typescript
+import { MockLocalStorage, setupCanvasMocks, setupResizeObserverMock } from '@xivdyetools/test-utils/dom';
+
+// Mock localStorage
+const storage = new MockLocalStorage();
+global.localStorage = storage;
+
+// Setup canvas mocks for chart testing
+setupCanvasMocks();
+
+// Setup ResizeObserver mock
+setupResizeObserverMock();
+```
+
+### Assertions
+
+```typescript
+import { assertJsonResponse } from '@xivdyetools/test-utils/assertions';
+
+const response = await app.request('/api/v1/presets');
+const body = await assertJsonResponse<{ presets: Preset[] }>(response, 200);
+expect(body.presets).toHaveLength(1);
+```
+
+### Constants
+
+```typescript
+import { VALID_CODE_VERIFIER, VALID_CODE_CHALLENGE } from '@xivdyetools/test-utils/constants';
+
+// RFC 7636 compliant PKCE test values
+const params = new URLSearchParams({
+  code_verifier: VALID_CODE_VERIFIER,
+  code_challenge: VALID_CODE_CHALLENGE,
+});
+```
+
+## Subpath Exports
+
+| Import Path | Contents |
+|-------------|----------|
+| `@xivdyetools/test-utils` | All exports |
+| `@xivdyetools/test-utils/cloudflare` | Cloudflare Workers mocks |
+| `@xivdyetools/test-utils/auth` | Authentication helpers |
+| `@xivdyetools/test-utils/factories` | Domain object factories |
+| `@xivdyetools/test-utils/dom` | DOM/browser utilities |
+| `@xivdyetools/test-utils/assertions` | Response assertions |
+| `@xivdyetools/test-utils/constants` | Test constants (PKCE, etc.) |
+
+## TypeScript
+
+This package includes full TypeScript support. Cloudflare Workers types are included via `@cloudflare/workers-types`.
+
+## License
+
+MIT

package/dist/assertions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Assertion helpers for testing
+ *
+ * Provides assertion utilities for testing API responses.
+ */
+export * from './response.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/assertions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assertions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC"}

package/dist/assertions/index.js

@@ -0,0 +1,7 @@
+/**
+ * Assertion helpers for testing
+ *
+ * Provides assertion utilities for testing API responses.
+ */
+export * from './response.js';
+//# sourceMappingURL=index.js.map

package/dist/assertions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assertions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC"}

package/dist/assertions/response.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Response assertion helpers for API testing
+ *
+ * Provides utilities for asserting HTTP response status and body.
+ *
+ * @example
+ * ```typescript
+ * const response = await app.request('/api/presets');
+ *
+ * // Assert status and get typed body
+ * const body = await assertJsonResponse<{ presets: Preset[] }>(response, 200);
+ * expect(body.presets).toHaveLength(1);
+ *
+ * // Assert error response
+ * const error = await assertErrorResponse(response, 400);
+ * expect(error.error).toBe('Validation failed');
+ * ```
+ */
+/**
+ * Assert response has expected status and return JSON body
+ *
+ * @param response - The Response object
+ * @param expectedStatus - Expected HTTP status code
+ * @returns The parsed JSON body
+ * @throws If status doesn't match
+ */
+export declare function assertJsonResponse<T>(response: Response, expectedStatus: number): Promise<T>;
+/**
+ * Error response shape
+ */
+export interface ErrorResponse {
+    error: string;
+    code?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Assert response is an error with expected status
+ *
+ * @param response - The Response object
+ * @param expectedStatus - Expected HTTP status code
+ * @returns The parsed error body
+ * @throws If status doesn't match
+ */
+export declare function assertErrorResponse(response: Response, expectedStatus: number): Promise<ErrorResponse>;
+/**
+ * Assert response is OK (2xx status)
+ *
+ * @param response - The Response object
+ * @returns The parsed JSON body
+ * @throws If status is not 2xx
+ */
+export declare function assertOkResponse<T>(response: Response): Promise<T>;
+/**
+ * Assert response is a redirect
+ *
+ * @param response - The Response object
+ * @param expectedLocation - Optional expected Location header value
+ * @returns The Location header value
+ * @throws If not a redirect or location doesn't match
+ */
+export declare function assertRedirectResponse(response: Response, expectedLocation?: string): string;
+/**
+ * Assert response has specific headers
+ *
+ * @param response - The Response object
+ * @param expectedHeaders - Headers to check
+ * @throws If any header is missing or doesn't match
+ */
+export declare function assertHeaders(response: Response, expectedHeaders: Record<string, string>): void;
+/**
+ * Assert response has CORS headers
+ *
+ * @param response - The Response object
+ * @param origin - Expected allowed origin
+ */
+export declare function assertCorsHeaders(response: Response, origin?: string): void;
+/**
+ * Assert response is JSON content type
+ *
+ * @param response - The Response object
+ * @throws If Content-Type is not application/json
+ */
+export declare function assertJsonContentType(response: Response): void;
+//# sourceMappingURL=response.d.ts.map

package/dist/assertions/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/assertions/response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,CAsBR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,IAAI,CASN;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAY3E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQ9D"}

package/dist/assertions/response.js

@@ -0,0 +1,125 @@
+/**
+ * Response assertion helpers for API testing
+ *
+ * Provides utilities for asserting HTTP response status and body.
+ *
+ * @example
+ * ```typescript
+ * const response = await app.request('/api/presets');
+ *
+ * // Assert status and get typed body
+ * const body = await assertJsonResponse<{ presets: Preset[] }>(response, 200);
+ * expect(body.presets).toHaveLength(1);
+ *
+ * // Assert error response
+ * const error = await assertErrorResponse(response, 400);
+ * expect(error.error).toBe('Validation failed');
+ * ```
+ */
+// Note: We use a dynamic import approach to avoid hard dependency on vitest
+// Tests should import { expect } from 'vitest' separately
+/**
+ * Assert response has expected status and return JSON body
+ *
+ * @param response - The Response object
+ * @param expectedStatus - Expected HTTP status code
+ * @returns The parsed JSON body
+ * @throws If status doesn't match
+ */
+export async function assertJsonResponse(response, expectedStatus) {
+    if (response.status !== expectedStatus) {
+        const body = await response.text();
+        throw new Error(`Expected status ${expectedStatus}, got ${response.status}. Body: ${body}`);
+    }
+    return response.json();
+}
+/**
+ * Assert response is an error with expected status
+ *
+ * @param response - The Response object
+ * @param expectedStatus - Expected HTTP status code
+ * @returns The parsed error body
+ * @throws If status doesn't match
+ */
+export async function assertErrorResponse(response, expectedStatus) {
+    return assertJsonResponse(response, expectedStatus);
+}
+/**
+ * Assert response is OK (2xx status)
+ *
+ * @param response - The Response object
+ * @returns The parsed JSON body
+ * @throws If status is not 2xx
+ */
+export async function assertOkResponse(response) {
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Expected OK response, got ${response.status}. Body: ${body}`);
+    }
+    return response.json();
+}
+/**
+ * Assert response is a redirect
+ *
+ * @param response - The Response object
+ * @param expectedLocation - Optional expected Location header value
+ * @returns The Location header value
+ * @throws If not a redirect or location doesn't match
+ */
+export function assertRedirectResponse(response, expectedLocation) {
+    const redirectStatuses = [301, 302, 303, 307, 308];
+    if (!redirectStatuses.includes(response.status)) {
+        throw new Error(`Expected redirect status (3xx), got ${response.status}`);
+    }
+    const location = response.headers.get('Location');
+    if (!location) {
+        throw new Error('Expected Location header in redirect response');
+    }
+    if (expectedLocation && location !== expectedLocation) {
+        throw new Error(`Expected location "${expectedLocation}", got "${location}"`);
+    }
+    return location;
+}
+/**
+ * Assert response has specific headers
+ *
+ * @param response - The Response object
+ * @param expectedHeaders - Headers to check
+ * @throws If any header is missing or doesn't match
+ */
+export function assertHeaders(response, expectedHeaders) {
+    for (const [key, value] of Object.entries(expectedHeaders)) {
+        const actual = response.headers.get(key);
+        if (actual !== value) {
+            throw new Error(`Expected header "${key}" to be "${value}", got "${actual}"`);
+        }
+    }
+}
+/**
+ * Assert response has CORS headers
+ *
+ * @param response - The Response object
+ * @param origin - Expected allowed origin
+ */
+export function assertCorsHeaders(response, origin) {
+    const acao = response.headers.get('Access-Control-Allow-Origin');
+    if (!acao) {
+        throw new Error('Expected Access-Control-Allow-Origin header');
+    }
+    if (origin && acao !== origin && acao !== '*') {
+        throw new Error(`Expected CORS origin "${origin}" or "*", got "${acao}"`);
+    }
+}
+/**
+ * Assert response is JSON content type
+ *
+ * @param response - The Response object
+ * @throws If Content-Type is not application/json
+ */
+export function assertJsonContentType(response) {
+    const contentType = response.headers.get('Content-Type');
+    if (!contentType?.includes('application/json')) {
+        throw new Error(`Expected Content-Type application/json, got "${contentType}"`);
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/assertions/response.js.map

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

package/dist/auth/context.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Auth context factories for testing middleware and handlers
+ *
+ * Provides factory functions to create authentication contexts
+ * for testing protected endpoints.
+ *
+ * @example
+ * ```typescript
+ * // Regular authenticated user
+ * const userCtx = createAuthContext({ userDiscordId: '123456789' });
+ *
+ * // Moderator context
+ * const modCtx = createModeratorContext();
+ *
+ * // Unauthenticated context
+ * const anonCtx = createUnauthenticatedContext();
+ * ```
+ */
+import type { AuthContext, AuthSource } from '@xivdyetools/types/auth';
+export type { AuthContext, AuthSource };
+/**
+ * Creates an authenticated user context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for an authenticated user
+ */
+export declare function createAuthContext(overrides?: Partial<AuthContext>): AuthContext;
+/**
+ * Creates a moderator context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a moderator
+ */
+export declare function createModeratorContext(overrides?: Partial<AuthContext>): AuthContext;
+/**
+ * Creates an unauthenticated context
+ *
+ * @returns An AuthContext for an unauthenticated request
+ */
+export declare function createUnauthenticatedContext(): AuthContext;
+/**
+ * Creates a web-authenticated context (JWT auth)
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a web-authenticated user
+ */
+export declare function createWebAuthContext(overrides?: Partial<AuthContext>): AuthContext;
+/**
+ * Creates a bot-authenticated context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a bot-authenticated user
+ */
+export declare function createBotAuthContext(overrides?: Partial<AuthContext>): AuthContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/auth/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/auth/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGvE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CASnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CASxF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,WAAW,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAStF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAStF"}

package/dist/auth/context.js

@@ -0,0 +1,95 @@
+/**
+ * Auth context factories for testing middleware and handlers
+ *
+ * Provides factory functions to create authentication contexts
+ * for testing protected endpoints.
+ *
+ * @example
+ * ```typescript
+ * // Regular authenticated user
+ * const userCtx = createAuthContext({ userDiscordId: '123456789' });
+ *
+ * // Moderator context
+ * const modCtx = createModeratorContext();
+ *
+ * // Unauthenticated context
+ * const anonCtx = createUnauthenticatedContext();
+ * ```
+ */
+/**
+ * Creates an authenticated user context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for an authenticated user
+ */
+export function createAuthContext(overrides = {}) {
+    return {
+        isAuthenticated: true,
+        isModerator: false,
+        userDiscordId: '123456789',
+        userName: 'TestUser',
+        authSource: 'bot',
+        ...overrides,
+    };
+}
+/**
+ * Creates a moderator context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a moderator
+ */
+export function createModeratorContext(overrides = {}) {
+    return {
+        isAuthenticated: true,
+        isModerator: true,
+        userDiscordId: '123456789',
+        userName: 'ModeratorUser',
+        authSource: 'bot',
+        ...overrides,
+    };
+}
+/**
+ * Creates an unauthenticated context
+ *
+ * @returns An AuthContext for an unauthenticated request
+ */
+export function createUnauthenticatedContext() {
+    return {
+        isAuthenticated: false,
+        isModerator: false,
+        authSource: 'none',
+    };
+}
+/**
+ * Creates a web-authenticated context (JWT auth)
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a web-authenticated user
+ */
+export function createWebAuthContext(overrides = {}) {
+    return {
+        isAuthenticated: true,
+        isModerator: false,
+        userDiscordId: '123456789',
+        userName: 'WebUser',
+        authSource: 'web',
+        ...overrides,
+    };
+}
+/**
+ * Creates a bot-authenticated context
+ *
+ * @param overrides - Optional overrides for the default values
+ * @returns An AuthContext for a bot-authenticated user
+ */
+export function createBotAuthContext(overrides = {}) {
+    return {
+        isAuthenticated: true,
+        isModerator: false,
+        userDiscordId: '123456789',
+        userName: 'BotUser',
+        authSource: 'bot',
+        ...overrides,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/auth/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/auth/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAkC,EAAE;IACpE,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,WAAW;QAC1B,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,KAAK;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAkC,EAAE;IACzE,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,WAAW;QAC1B,QAAQ,EAAE,eAAe;QACzB,UAAU,EAAE,KAAK;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAkC,EAAE;IACvE,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,WAAW;QAC1B,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,KAAK;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAkC,EAAE;IACvE,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,WAAW;QAC1B,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,KAAK;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/auth/headers.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Request header builders for testing API authentication
+ *
+ * Provides helper functions to build authentication headers
+ * for testing API endpoints.
+ *
+ * @example
+ * ```typescript
+ * // JWT auth headers
+ * const headers = authHeaders(jwt);
+ *
+ * // Bot auth headers with signature
+ * const botHeaders = await authHeadersWithSignature(
+ *   'bot-token',
+ *   'user-id',
+ *   'username'
+ * );
+ *
+ * // Use in requests
+ * const response = await fetch('/api/protected', { headers });
+ * ```
+ */
+/**
+ * Creates basic auth headers with a bearer token
+ *
+ * @param token - The bearer token (JWT or API key)
+ * @param userId - Optional Discord user ID
+ * @param userName - Optional Discord username
+ * @returns Headers object
+ */
+export declare function authHeaders(token: string, userId?: string, userName?: string): Record<string, string>;
+/**
+ * Creates auth headers with HMAC signature for bot authentication
+ *
+ * @param token - The bot API token
+ * @param userId - Discord user ID (optional)
+ * @param userName - Discord username (optional)
+ * @param signingSecret - The signing secret (defaults to TEST_SIGNING_SECRET)
+ * @returns Headers object with signature
+ */
+export declare function authHeadersWithSignature(token: string, userId?: string, userName?: string, signingSecret?: string): Promise<Record<string, string>>;
+/**
+ * Creates JSON content headers
+ *
+ * @returns Headers object with Content-Type: application/json
+ */
+export declare function jsonHeaders(): Record<string, string>;
+/**
+ * Merges multiple header objects
+ *
+ * @param headerObjects - Header objects to merge
+ * @returns Merged headers object
+ */
+export declare function mergeHeaders(...headerObjects: Record<string, string>[]): Record<string, string>;
+/**
+ * Creates authenticated JSON request headers
+ *
+ * @param token - The bearer token
+ * @param userId - Optional Discord user ID
+ * @param userName - Optional Discord username
+ * @returns Headers object with auth and content-type
+ */
+export declare function authenticatedJsonHeaders(token: string, userId?: string, userName?: string): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/auth/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/auth/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,GAAE,MAA4B,GAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA2BjC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}