@dyrected/core 2.6.3 → 2.7.0

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

@@ -0,0 +1,9 @@
+import type { Context, Next } from 'hono';
+import type { DyrectedContext } from '../app.js';
+import type { DyrectedConfig } from '../types/index.js';
+export declare function createRateLimitMiddleware(config: DyrectedConfig): (c: Context<DyrectedContext>, next: Next) => Promise<void | (Response & import("hono").TypedResponse<{
+    error: true;
+    message: string;
+    retryAfterSeconds: number;
+}, 429, "json">)>;
+//# sourceMappingURL=rate-limit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAWzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,IAIhD,GAAG,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI;;;;kBA2DtD"}

package/dist/middleware/rate-limit.js

@@ -0,0 +1,75 @@
+import { resolveClientIp, toHookRequestContext } from '../network.js';
+const DEFAULT_WINDOW_MS = 15 * 60 * 1000;
+const DEFAULT_MAX_REQUESTS = 500;
+const DEFAULT_PATHS = ['/api'];
+export function createRateLimitMiddleware(config) {
+    const settings = normalizeRateLimitConfig(config.rateLimit);
+    const buckets = new Map();
+    return async (c, next) => {
+        const req = toHookRequestContext(c);
+        const ip = resolveClientIp(req, settings.trustProxy);
+        c.set('clientIp', ip);
+        if (!settings.enabled) {
+            return next();
+        }
+        const path = c.req.path;
+        if (!matchesLimitedPath(path, settings.paths)) {
+            return next();
+        }
+        if (settings.skip &&
+            (await settings.skip({
+                ip,
+                path,
+                method: c.req.method,
+                req,
+            }))) {
+            return next();
+        }
+        const now = Date.now();
+        const key = ip;
+        const existing = buckets.get(key);
+        const bucket = existing && existing.resetAt > now
+            ? existing
+            : { count: 0, resetAt: now + settings.window };
+        bucket.count += 1;
+        buckets.set(key, bucket);
+        pruneExpiredBuckets(buckets, now);
+        const remaining = Math.max(0, settings.max - bucket.count);
+        const resetSeconds = Math.max(1, Math.ceil((bucket.resetAt - now) / 1000));
+        c.res.headers.set('X-RateLimit-Limit', String(settings.max));
+        c.res.headers.set('X-RateLimit-Remaining', String(remaining));
+        c.res.headers.set('X-RateLimit-Reset', String(Math.ceil(bucket.resetAt / 1000)));
+        if (bucket.count > settings.max) {
+            c.res.headers.set('Retry-After', String(resetSeconds));
+            return c.json({
+                error: true,
+                message: 'Too many requests. Try again later.',
+                retryAfterSeconds: resetSeconds,
+            }, 429);
+        }
+        await next();
+    };
+}
+function normalizeRateLimitConfig(config) {
+    return {
+        enabled: config?.enabled ?? true,
+        window: config?.window ?? DEFAULT_WINDOW_MS,
+        max: config?.max ?? DEFAULT_MAX_REQUESTS,
+        paths: config?.paths?.length ? config.paths : DEFAULT_PATHS,
+        skip: config?.skip,
+        trustProxy: config?.trustProxy ?? false,
+    };
+}
+function matchesLimitedPath(path, prefixes) {
+    return prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
+}
+function pruneExpiredBuckets(buckets, now) {
+    if (buckets.size < 1_000)
+        return;
+    for (const [key, bucket] of buckets) {
+        if (bucket.resetAt <= now) {
+            buckets.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/middleware/rate-limit.js.map

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

package/dist/network.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from "hono";
+import type { DyrectedContext } from "./app.js";
+import type { HookRequestContext, TrustProxyConfig } from "./types/index.js";
+export declare function toHookRequestContext(c: Context<DyrectedContext>): HookRequestContext;
+export declare function resolveClientIp(req: HookRequestContext, trustProxy?: TrustProxyConfig): string;
+//# sourceMappingURL=network.d.ts.map

package/dist/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAW7E,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAC1B,kBAAkB,CAUpB;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,kBAAkB,EACvB,UAAU,GAAE,gBAAwB,GACnC,MAAM,CAYR"}

package/dist/network.js

@@ -0,0 +1,70 @@
+const DIRECT_IP_HEADERS = [
+    "cf-connecting-ip",
+    "fly-client-ip",
+    "true-client-ip",
+    "x-real-ip",
+    "x-client-ip",
+    "fastly-client-ip",
+];
+export function toHookRequestContext(c) {
+    const headers = Object.fromEntries(Object.entries(c.req.header()).map(([key, value]) => [key.toLowerCase(), value]));
+    return {
+        query: c.req.query(),
+        headers,
+        raw: c.req.raw,
+    };
+}
+export function resolveClientIp(req, trustProxy = false) {
+    for (const header of DIRECT_IP_HEADERS) {
+        const value = normalizeIp(req.headers[header]);
+        if (value)
+            return value;
+    }
+    if (trustProxy) {
+        const forwardedFor = pickForwardedFor(req.headers, trustProxy);
+        if (forwardedFor)
+            return forwardedFor;
+    }
+    return "127.0.0.1";
+}
+function pickForwardedFor(headers, trustProxy) {
+    const forwardedHeader = headers["x-forwarded-for"];
+    if (forwardedHeader) {
+        const chain = forwardedHeader
+            .split(",")
+            .map((entry) => normalizeIp(entry))
+            .filter((entry) => !!entry);
+        if (chain.length > 0) {
+            if (trustProxy === true)
+                return chain[0];
+            const trustedHops = Math.max(1, Math.floor(trustProxy));
+            const candidateIndex = Math.max(0, chain.length - trustedHops);
+            return chain[candidateIndex] ?? chain[0];
+        }
+    }
+    const forwarded = headers.forwarded;
+    if (!forwarded)
+        return null;
+    const matches = [...forwarded.matchAll(/for=(?:"?\[?([^;\],"]+)\]?"?)/gi)];
+    if (matches.length === 0)
+        return null;
+    const chain = matches
+        .map((match) => normalizeIp(match[1]))
+        .filter((entry) => !!entry);
+    if (chain.length === 0)
+        return null;
+    if (trustProxy === true)
+        return chain[0];
+    const trustedHops = Math.max(1, Math.floor(trustProxy));
+    const candidateIndex = Math.max(0, chain.length - trustedHops);
+    return chain[candidateIndex] ?? chain[0];
+}
+function normalizeIp(value) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.toLowerCase() === "unknown")
+        return null;
+    return trimmed.replace(/^\[(.*)\]$/, "$1");
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,113 @@
+import { type Attributes, type Counter, type Histogram, type Span, type Tracer } from "@opentelemetry/api";
+import { PrometheusExporter } from "@opentelemetry/exporter-prometheus";
+import type { Context } from "hono";
+import { type Logger } from "pino";
+import type { DyrectedContext } from "./app.js";
+import type { DyrectedConfig, DyrectedObservabilityConfig } from "./types/index.js";
+type RequestVars = DyrectedContext["Variables"];
+export interface ResolvedObservabilityConfig {
+    requestLogging: {
+        enabled: boolean;
+        logBodies: boolean;
+        maxBodyBytes: number;
+        redactPaths: string[];
+        includeHeaders: string[];
+        redactHeaders: string[];
+    };
+    sampling: {
+        successRate: number;
+        traceSuccessRate: number;
+        bodySuccessRate: number;
+        alwaysKeep4xx: boolean;
+        alwaysKeep5xx: boolean;
+    };
+    tracing: {
+        enabled: boolean;
+        serviceName: string;
+        exporter: "otlp" | "console" | "none";
+        headers: Record<string, string>;
+        endpoint?: string;
+    };
+    metrics: {
+        enabled: boolean;
+        exporter: "otlp" | "prometheus" | "none";
+        endpoint?: string;
+        path: string;
+    };
+    transports: {
+        targets: Array<{
+            type: "stdout";
+        } | {
+            type: "stderr";
+        } | {
+            type: "file";
+            path: string;
+        } | {
+            type: "otlp";
+            endpoint: string;
+            headers?: Record<string, string>;
+        }>;
+    };
+}
+export interface RequestTraceContext {
+    span: Span;
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+}
+export interface RequestBodyCapture {
+    attempted: boolean;
+    contentType?: string;
+    contentLength?: number;
+    truncated?: boolean;
+    parseFailed?: boolean;
+    body?: unknown;
+}
+interface MetricsRuntime {
+    requestCount: Counter<Attributes>;
+    authFailureCount: Counter<Attributes>;
+    uncaughtErrorCount: Counter<Attributes>;
+    auditWriteFailureCount: Counter<Attributes>;
+    emailSendFailureCount: Counter<Attributes>;
+    workflowHookFailureCount: Counter<Attributes>;
+    requestDuration: Histogram<Attributes>;
+}
+export interface DyrectedObservabilityRuntime {
+    logger: Logger;
+    config: ResolvedObservabilityConfig;
+    tracer?: Tracer;
+    metrics?: MetricsRuntime;
+    prometheusExporter?: PrometheusExporter;
+    shutdown: () => Promise<void>;
+    recordAuthFailure: (attributes?: Attributes) => void;
+    recordUncaughtError: (attributes?: Attributes) => void;
+    recordAuditWriteFailure: (attributes?: Attributes) => void;
+    recordEmailSendFailure: (attributes?: Attributes) => void;
+    recordWorkflowHookFailure: (attributes?: Attributes) => void;
+}
+export declare function resolveObservabilityConfig(config?: DyrectedObservabilityConfig): ResolvedObservabilityConfig;
+export declare function createObservabilityRuntime(config: DyrectedConfig): DyrectedObservabilityRuntime;
+export declare function bindObservabilityRuntime(config: DyrectedConfig, runtime: DyrectedObservabilityRuntime): void;
+export declare function getObservabilityRuntime(config: Pick<DyrectedConfig, "logger"> | undefined): DyrectedObservabilityRuntime | undefined;
+export declare function getConfigLogger(config: Pick<DyrectedConfig, "logger"> | undefined, component: string): Logger;
+export declare function getRequestLogger(c: Context<DyrectedContext>, component?: string): Logger;
+export declare function buildRequestLogger(runtime: DyrectedObservabilityRuntime, vars: RequestVars, requestId?: string): Logger;
+export declare function shouldSampleRequest(requestId: string | undefined, statusCode: number, sampling: ResolvedObservabilityConfig["sampling"], kind: "log" | "trace" | "body"): boolean;
+export declare function redactHeaders(headers: Record<string, string>, observability: ResolvedObservabilityConfig): Record<string, string>;
+export declare function captureRequestBody(request: Request, observability: ResolvedObservabilityConfig): Promise<RequestBodyCapture>;
+export declare function redactBody(value: unknown, redactPaths: string[]): unknown;
+export declare function createRequestSpan(runtime: DyrectedObservabilityRuntime, name: string, attributes: Attributes): RequestTraceContext | undefined;
+export declare function endRequestSpan(requestTrace: RequestTraceContext | undefined, statusCode: number, error?: unknown): void;
+export declare function attachRequestMetrics(runtime: DyrectedObservabilityRuntime, args: {
+    method: string;
+    route: string;
+    statusCode: number;
+    durationMs: number;
+}): void;
+export declare function renderPrometheusMetrics(exporter: PrometheusExporter): Promise<{
+    body: string;
+    headers: Record<string, string>;
+    statusCode: number;
+}>;
+export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

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