takos-common 1.0.0

package/dist/errors.js

@@ -0,0 +1,271 @@
+/**
+ * Standardized Error Handling for Takos Platform
+ *
+ * This module provides a consistent error handling pattern across all takos packages.
+ * All errors extend from AppError and include:
+ * - code: A unique error code for client-side handling
+ * - message: A user-safe message (no internal details)
+ * - statusCode: The HTTP status code to return
+ * - details: Optional field-level or additional details
+ */
+/**
+ * Standard error codes for consistent client handling
+ */
+export const ErrorCodes = {
+    // 4xx Client Errors
+    BAD_REQUEST: 'BAD_REQUEST',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    PAYMENT_REQUIRED: 'PAYMENT_REQUIRED',
+    FORBIDDEN: 'FORBIDDEN',
+    NOT_FOUND: 'NOT_FOUND',
+    CONFLICT: 'CONFLICT',
+    GONE: 'GONE',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    RATE_LIMITED: 'RATE_LIMITED',
+    PAYLOAD_TOO_LARGE: 'PAYLOAD_TOO_LARGE',
+    // 5xx Server Errors
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    NOT_IMPLEMENTED: 'NOT_IMPLEMENTED',
+    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+    BAD_GATEWAY: 'BAD_GATEWAY',
+    GATEWAY_TIMEOUT: 'GATEWAY_TIMEOUT',
+};
+/**
+ * Base application error class
+ * All custom errors should extend from this class
+ */
+export class AppError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code = ErrorCodes.INTERNAL_ERROR, statusCode = 500, details) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        // Maintains proper stack trace for where error was thrown
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+    /**
+     * Convert error to API response format
+     * This ensures no internal details leak to clients
+     */
+    toResponse() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                ...(this.details !== undefined && { details: this.details }),
+            },
+        };
+    }
+}
+/**
+ * 400 Bad Request - Invalid request syntax or parameters
+ */
+export class BadRequestError extends AppError {
+    constructor(message = 'Bad request', details) {
+        super(message, ErrorCodes.BAD_REQUEST, 400, details);
+    }
+}
+/**
+ * 401 Unauthorized - Authentication required or invalid
+ */
+export class AuthenticationError extends AppError {
+    constructor(message = 'Authentication required', details) {
+        super(message, ErrorCodes.UNAUTHORIZED, 401, details);
+    }
+}
+/**
+ * 402 Payment Required - Payment is required to access the resource
+ */
+export class PaymentRequiredError extends AppError {
+    constructor(message = 'Payment required', details) {
+        super(message, ErrorCodes.PAYMENT_REQUIRED, 402, details);
+    }
+}
+/**
+ * 403 Forbidden - Authenticated but not authorized
+ */
+export class AuthorizationError extends AppError {
+    constructor(message = 'Access denied', details) {
+        super(message, ErrorCodes.FORBIDDEN, 403, details);
+    }
+}
+/**
+ * 404 Not Found - Resource does not exist
+ */
+export class NotFoundError extends AppError {
+    constructor(resource = 'Resource', details) {
+        super(`${resource} not found`, ErrorCodes.NOT_FOUND, 404, details);
+    }
+}
+/**
+ * 409 Conflict - Resource conflict (e.g., duplicate)
+ */
+export class ConflictError extends AppError {
+    constructor(message = 'Resource conflict', details) {
+        super(message, ErrorCodes.CONFLICT, 409, details);
+    }
+}
+/**
+ * 410 Gone - Resource no longer available
+ */
+export class GoneError extends AppError {
+    constructor(message = 'Resource is no longer available', details) {
+        super(message, ErrorCodes.GONE, 410, details);
+    }
+}
+/**
+ * 413 Payload Too Large - Request payload exceeds limit
+ */
+export class PayloadTooLargeError extends AppError {
+    constructor(message = 'Payload too large', details) {
+        super(message, ErrorCodes.PAYLOAD_TOO_LARGE, 413, details);
+    }
+}
+/**
+ * 422 Unprocessable Entity - Validation failed
+ */
+export class ValidationError extends AppError {
+    fieldErrors;
+    constructor(message = 'Validation failed', fieldErrors = []) {
+        super(message, ErrorCodes.VALIDATION_ERROR, 422, fieldErrors.length > 0 ? { fields: fieldErrors } : undefined);
+        this.fieldErrors = fieldErrors;
+    }
+}
+/**
+ * 429 Too Many Requests - Rate limit exceeded
+ */
+export class RateLimitError extends AppError {
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', retryAfter) {
+        super(message, ErrorCodes.RATE_LIMITED, 429);
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * 500 Internal Server Error - Unexpected server error
+ */
+export class InternalError extends AppError {
+    constructor(message = 'Internal server error', details) {
+        super(message, ErrorCodes.INTERNAL_ERROR, 500, details);
+    }
+}
+/**
+ * 501 Not Implemented - Functionality not implemented
+ */
+export class NotImplementedError extends AppError {
+    constructor(message = 'Not implemented', details) {
+        super(message, ErrorCodes.NOT_IMPLEMENTED, 501, details);
+    }
+}
+/**
+ * 502 Bad Gateway - Invalid response from upstream service
+ */
+export class BadGatewayError extends AppError {
+    constructor(message = 'Bad gateway', details) {
+        super(message, ErrorCodes.BAD_GATEWAY, 502, details);
+    }
+}
+/**
+ * 503 Service Unavailable - Service temporarily unavailable
+ */
+export class ServiceUnavailableError extends AppError {
+    constructor(message = 'Service temporarily unavailable', details) {
+        super(message, ErrorCodes.SERVICE_UNAVAILABLE, 503, details);
+    }
+}
+/**
+ * 504 Gateway Timeout - Upstream service timeout
+ */
+export class GatewayTimeoutError extends AppError {
+    constructor(message = 'Gateway timeout', details) {
+        super(message, ErrorCodes.GATEWAY_TIMEOUT, 504, details);
+    }
+}
+/**
+ * Type guard to check if an error is an AppError
+ */
+export function isAppError(error) {
+    return error instanceof AppError;
+}
+/**
+ * Convert unknown error to AppError
+ * Use this to normalize errors before sending responses
+ */
+export function normalizeError(error, logger) {
+    if (isAppError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        if (logger) {
+            logger.error('Converting Error to AppError', { error });
+        }
+        else {
+            console.error('[normalizeError] Converting Error to AppError:', error);
+        }
+        return new InternalError('An unexpected error occurred');
+    }
+    if (logger) {
+        logger.error('Converting unknown to AppError', { value: String(error) });
+    }
+    else {
+        console.error('[normalizeError] Converting unknown to AppError:', error);
+    }
+    return new InternalError('An unexpected error occurred');
+}
+/**
+ * Extract a human-readable message from an unknown thrown value.
+ *
+ * When called with a single argument the behaviour matches the former
+ * `runtime-service/utils/error-message` helper (`String(err)` for
+ * non-Error values).  When a `fallback` string is supplied the
+ * behaviour matches the former `control/web/lib/errors` helper
+ * (returns the fallback when no meaningful message can be extracted).
+ */
+export function getErrorMessage(error, fallback) {
+    if (typeof error === 'string' && error.trim()) {
+        return error;
+    }
+    if (error instanceof Error && error.message.trim()) {
+        return error.message;
+    }
+    if (typeof error === 'object' && error !== null) {
+        const candidate = error.message;
+        if (typeof candidate === 'string' && candidate.trim()) {
+            return candidate;
+        }
+    }
+    return fallback !== undefined ? fallback : String(error);
+}
+/**
+ * Log error with full details for server-side debugging
+ */
+export function logError(error, context, logger) {
+    const errorInfo = isAppError(error)
+        ? {
+            name: error.name,
+            code: error.code,
+            message: error.message,
+            statusCode: error.statusCode,
+            details: error.details,
+            stack: error.stack,
+        }
+        : {
+            message: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        };
+    if (logger) {
+        logger.error('Error', { ...errorInfo, ...context });
+    }
+    else {
+        console.error('[Error]', {
+            ...errorInfo,
+            context,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/id.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ID Generation Utilities
+ *
+ * Provides cryptographically secure random ID generation
+ * for use across all takos packages.
+ */
+/**
+ * Generate a cryptographically secure random ID using alphanumeric characters.
+ *
+ * Uses crypto.getRandomValues() for secure randomness.
+ * Character set: lowercase letters and digits (36 chars).
+ *
+ * @param length - Length of the ID (default: 12)
+ * @returns Random alphanumeric string
+ *
+ * @example
+ * ```typescript
+ * const id = generateId(); // e.g., "a1b2c3d4e5f6"
+ * const longId = generateId(24); // e.g., "a1b2c3d4e5f6g7h8i9j0k1l2"
+ * ```
+ */
+export declare function generateId(length?: number): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAStD"}

package/dist/id.js

@@ -0,0 +1,32 @@
+/**
+ * ID Generation Utilities
+ *
+ * Provides cryptographically secure random ID generation
+ * for use across all takos packages.
+ */
+/**
+ * Generate a cryptographically secure random ID using alphanumeric characters.
+ *
+ * Uses crypto.getRandomValues() for secure randomness.
+ * Character set: lowercase letters and digits (36 chars).
+ *
+ * @param length - Length of the ID (default: 12)
+ * @returns Random alphanumeric string
+ *
+ * @example
+ * ```typescript
+ * const id = generateId(); // e.g., "a1b2c3d4e5f6"
+ * const longId = generateId(24); // e.g., "a1b2c3d4e5f6g7h8i9j0k1l2"
+ * ```
+ */
+export function generateId(length = 12) {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    const array = new Uint8Array(length);
+    crypto.getRandomValues(array);
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars[array[i] % chars.length];
+    }
+    return result;
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE;IAC5C,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * takos-common - Shared utilities for Takos services
+ *
+ * This package provides common utilities used across all takos packages:
+ * - ID generation (generateId)
+ * - Validation helpers (isLocalhost, isPrivateIP)
+ * - Error handling (AppError, ValidationError, etc.)
+ * - Structured logging (createLogger)
+ * - Hono middleware
+ */
+export { generateId, } from './id.js';
+export { isLocalhost, isPrivateIP, } from './validation.js';
+export { createLogger, type Logger, type LogLevel } from './logger.js';
+export { throwIfAborted } from './abort.js';
+export { parseIntEnv, parseIntEnvRequired, parseIntValue, parseFloatEnv, parseFloatValue, } from './env-parse.js';
+export { ErrorCodes, type ErrorCode, AppError, BadRequestError, AuthenticationError, PaymentRequiredError, AuthorizationError, NotFoundError, ConflictError, GoneError, PayloadTooLargeError, ValidationError, RateLimitError, InternalError, NotImplementedError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, isAppError, normalizeError, logError, getErrorMessage, type ErrorResponse, type ValidationErrorDetail, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EACL,UAAU,GACX,MAAM,SAAS,CAAC;AAKjB,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAEL,UAAU,EACV,KAAK,SAAS,EAEd,QAAQ,EAER,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EAEnB,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,EAEf,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * takos-common - Shared utilities for Takos services
+ *
+ * This package provides common utilities used across all takos packages:
+ * - ID generation (generateId)
+ * - Validation helpers (isLocalhost, isPrivateIP)
+ * - Error handling (AppError, ValidationError, etc.)
+ * - Structured logging (createLogger)
+ * - Hono middleware
+ */
+// =============================================================================
+// ID Generation Utilities
+// =============================================================================
+export { generateId, } from './id.js';
+// =============================================================================
+// Validation Utilities
+// =============================================================================
+export { isLocalhost, isPrivateIP, } from './validation.js';
+// =============================================================================
+// Structured Logging
+// =============================================================================
+export { createLogger } from './logger.js';
+// =============================================================================
+// Abort Signal Utilities
+// =============================================================================
+export { throwIfAborted } from './abort.js';
+// =============================================================================
+// Environment Variable Parsing
+// =============================================================================
+export { parseIntEnv, parseIntEnvRequired, parseIntValue, parseFloatEnv, parseFloatValue, } from './env-parse.js';
+// =============================================================================
+// Error Handling
+// =============================================================================
+export { 
+// Error codes
+ErrorCodes, 
+// Base errors
+AppError, 
+// HTTP errors
+BadRequestError, AuthenticationError, PaymentRequiredError, AuthorizationError, NotFoundError, ConflictError, GoneError, PayloadTooLargeError, ValidationError, RateLimitError, InternalError, NotImplementedError, BadGatewayError, ServiceUnavailableError, GatewayTimeoutError, 
+// Utility functions
+isAppError, normalizeError, logError, getErrorMessage, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAChF,OAAO,EACL,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAChF,OAAO,EACL,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAA8B,MAAM,aAAa,CAAC;AAEvE,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAChF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAChF,OAAO;AACL,cAAc;AACd,UAAU;AAEV,cAAc;AACd,QAAQ;AACR,cAAc;AACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,mBAAmB;AACnB,oBAAoB;AACpB,UAAU,EACV,cAAc,EACd,QAAQ,EACR,eAAe,GAIhB,MAAM,aAAa,CAAC"}

package/dist/jwt.d.ts

@@ -0,0 +1,54 @@
+/**
+ * JWT utilities for service-to-service authentication
+ * Uses RS256 (RSA with SHA-256) for asymmetric signing
+ */
+/**
+ * Service token JWT payload structure
+ */
+export interface ServiceTokenPayload {
+    iss: string;
+    sub: string;
+    aud: string;
+    exp: number;
+    iat: number;
+    jti: string;
+}
+/**
+ * Extended payload with optional custom claims
+ */
+export interface ServiceTokenPayloadWithClaims extends ServiceTokenPayload {
+    [key: string]: unknown;
+}
+/**
+ * Options for verifying a service token
+ */
+export interface VerifyServiceTokenOptions {
+    /** JWT token string */
+    token: string;
+    /** Public key in PEM format (used as default/fallback) */
+    publicKey: string;
+    /** Additional public keys for rotation, keyed by kid (optional) */
+    publicKeys?: Record<string, string>;
+    /** Expected audience (required) */
+    expectedAudience: string;
+    /** Expected issuer (required) */
+    expectedIssuer: string;
+    /** Clock tolerance in seconds for exp/iat checks (default: 30) */
+    clockToleranceSeconds?: number;
+}
+/**
+ * Result of token verification
+ */
+export interface VerifyServiceTokenResult {
+    valid: boolean;
+    payload?: ServiceTokenPayloadWithClaims;
+    error?: string;
+}
+/**
+ * Verify a service token using RS256 algorithm
+ *
+ * @param options - Verification options including token and public key
+ * @returns Verification result with payload if valid
+ */
+export declare function verifyServiceToken(options: VerifyServiceTokenOptions): VerifyServiceTokenResult;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../src/jwt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,6BAA6B,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB,CAiI/F"}

package/dist/jwt.js

@@ -0,0 +1,149 @@
+/**
+ * JWT utilities for service-to-service authentication
+ * Uses RS256 (RSA with SHA-256) for asymmetric signing
+ */
+import * as crypto from 'crypto';
+// Base64URL encoding/decoding utilities
+function base64UrlEncode(data) {
+    const buffer = typeof data === 'string' ? Buffer.from(data) : data;
+    return buffer.toString('base64')
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=+$/, '');
+}
+function base64UrlDecode(str) {
+    // Add padding back
+    let padded = str.replace(/-/g, '+').replace(/_/g, '/');
+    const padding = (4 - (padded.length % 4)) % 4;
+    padded += '='.repeat(padding);
+    const buf = Buffer.from(padded, 'base64');
+    if (buf.length === 0 && str.length > 0) {
+        throw new Error('Invalid base64url encoding');
+    }
+    return buf;
+}
+/**
+ * Generate a unique JWT ID (jti)
+ */
+function generateJTI() {
+    const bytes = crypto.randomBytes(16);
+    return base64UrlEncode(bytes);
+}
+/**
+ * Verify a service token using RS256 algorithm
+ *
+ * @param options - Verification options including token and public key
+ * @returns Verification result with payload if valid
+ */
+export function verifyServiceToken(options) {
+    const { token, publicKey, publicKeys = {}, expectedAudience, expectedIssuer, clockToleranceSeconds = 30, } = options;
+    try {
+        // Split token
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            return { valid: false, error: 'Invalid token format' };
+        }
+        const [encodedHeader, encodedPayload, encodedSignature] = parts;
+        // Decode header
+        let header;
+        try {
+            header = JSON.parse(base64UrlDecode(encodedHeader).toString('utf-8'));
+        }
+        catch {
+            return { valid: false, error: 'Invalid header encoding' };
+        }
+        // Verify algorithm
+        if (header.alg !== 'RS256') {
+            return { valid: false, error: `Unsupported algorithm: ${header.alg}` };
+        }
+        // Resolve which public key(s) to try based on kid.
+        // When kid is present, use only the matching key (strict rotation).
+        // When kid is absent, use only the default public key (latest/current key)
+        // to prevent accepting tokens signed with any older rotation key.
+        const keysToTry = [];
+        if (header.kid) {
+            if (publicKeys[header.kid]) {
+                // Token has a kid and we have a matching key - use it exclusively
+                keysToTry.push(publicKeys[header.kid]);
+            }
+            else {
+                // kid is present but unknown - reject immediately
+                return { valid: false, error: `Unknown key ID: ${header.kid}` };
+            }
+        }
+        else {
+            // No kid: only try the default (latest) public key
+            keysToTry.push(publicKey);
+        }
+        // Try each key for signature verification
+        const signingInput = `${encodedHeader}.${encodedPayload}`;
+        const signature = base64UrlDecode(encodedSignature);
+        let isValidSignature = false;
+        for (const key of keysToTry) {
+            const verify = crypto.createVerify('RSA-SHA256');
+            verify.update(signingInput);
+            verify.end();
+            if (verify.verify(key, signature)) {
+                isValidSignature = true;
+                break;
+            }
+        }
+        if (!isValidSignature) {
+            return { valid: false, error: 'Invalid signature' };
+        }
+        // Decode payload
+        let payload;
+        try {
+            payload = JSON.parse(base64UrlDecode(encodedPayload).toString('utf-8'));
+        }
+        catch {
+            return { valid: false, error: 'Invalid payload encoding' };
+        }
+        // Required verification config
+        if (!expectedAudience || !expectedIssuer) {
+            return { valid: false, error: 'expectedAudience and expectedIssuer are required' };
+        }
+        // Required claims
+        if (typeof payload.iss !== 'string' || payload.iss.length === 0) {
+            return { valid: false, error: 'Missing or invalid iss claim' };
+        }
+        if (typeof payload.aud !== 'string' || payload.aud.length === 0) {
+            return { valid: false, error: 'Missing or invalid aud claim' };
+        }
+        if (typeof payload.sub !== 'string' || payload.sub.length === 0) {
+            return { valid: false, error: 'Missing or invalid sub claim' };
+        }
+        if (typeof payload.jti !== 'string' || payload.jti.length === 0) {
+            return { valid: false, error: 'Missing or invalid jti claim' };
+        }
+        if (typeof payload.exp !== 'number' || !Number.isFinite(payload.exp)) {
+            return { valid: false, error: 'Missing or invalid exp claim' };
+        }
+        if (typeof payload.iat !== 'number' || !Number.isFinite(payload.iat)) {
+            return { valid: false, error: 'Missing or invalid iat claim' };
+        }
+        // Verify expiration
+        const now = Math.floor(Date.now() / 1000);
+        if (payload.exp + clockToleranceSeconds < now) {
+            return { valid: false, error: 'Token has expired' };
+        }
+        // Verify not-before (iat - tolerance)
+        if (payload.iat - clockToleranceSeconds > now) {
+            return { valid: false, error: 'Token issued in the future' };
+        }
+        // Verify audience
+        if (payload.aud !== expectedAudience) {
+            return { valid: false, error: `Invalid audience: expected ${expectedAudience}, got ${payload.aud}` };
+        }
+        // Verify issuer
+        if (payload.iss !== expectedIssuer) {
+            return { valid: false, error: `Invalid issuer: expected ${expectedIssuer}, got ${payload.iss}` };
+        }
+        return { valid: true, payload };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        return { valid: false, error: `Verification failed: ${message}` };
+    }
+}
+//# sourceMappingURL=jwt.js.map

package/dist/jwt.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Structured Logger for Takos Platform
+ *
+ * Zero-dependency structured logging compatible with Cloudflare Workers.
+ * Outputs JSON to console methods so CF observability picks up the correct level.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface LoggerOptions {
+    service?: string;
+    level?: LogLevel;
+    defaultFields?: Record<string, unknown>;
+}
+export interface Logger {
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+    child(fields: Record<string, unknown>): Logger;
+}
+export declare function createLogger(opts?: LoggerOptions): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAiB3D,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAChD;AAiGD,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAEzD"}