ras-stack 0.34.1 → 0.35.0

package/dist/posthog/server.d.ts

@@ -1,4 +1,43 @@
 import type { PostHog, PostHogOptions } from 'posthog-node';
+import type { RpcErrorContext, RpcLogger } from '../server/rpc.js';
 import type { PostHogEnvironment } from './config.js';
+export type PostHogLogValue = string | number | boolean | null | PostHogLogValue[];
+export type PostHogLogRecord = {
+    body: string;
+    severityText?: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+    timestamp?: number;
+    attributes?: Record<string, unknown>;
+};
+export type ManagedPostHogServerTelemetryOptions = {
+    environment: PostHogEnvironment | undefined;
+    serviceName: string;
+    serviceVersion?: string;
+    deploymentEnvironment?: string;
+    clientOptions?: Omit<PostHogOptions, 'host'>;
+    onError?: (error: unknown) => void;
+};
+export type PostHogServerTelemetry = ReturnType<typeof createManagedPostHogServerTelemetry>;
+export type PostHogRpcLoggerOptions = {
+    logError?: (error: unknown, context: RpcErrorContext) => void;
+    resolveAuthenticatedDistinctId?: (request: Request) => string | undefined | Promise<string | undefined>;
+    allowAnonymousDistinctId?: boolean;
+    fallbackDistinctId?: string;
+};
+type PostHogShutdownProcess = {
+    pid: number;
+    on(signal: 'SIGINT' | 'SIGTERM', listener: () => void): void;
+    off(signal: 'SIGINT' | 'SIGTERM', listener: () => void): void;
+    kill(pid: number, signal: 'SIGINT' | 'SIGTERM'): void;
+};
 export declare function createPostHogServerClient(environment: PostHogEnvironment | undefined, options?: Omit<PostHogOptions, 'host'>): Promise<PostHog | undefined>;
 export declare function shutdownPostHogServerClient(client: PostHog | undefined, timeoutMs?: number): Promise<void>;
+export declare function createManagedPostHogServerTelemetry(options: ManagedPostHogServerTelemetryOptions): {
+    start(): Promise<void>;
+    capture(distinctId: string, event: string, properties?: Record<string, unknown>): Promise<void>;
+    exception(error: unknown, distinctId?: string, properties?: Record<string, unknown>): Promise<void>;
+    log(record: PostHogLogRecord): Promise<void>;
+    shutdown(timeoutMs?: number): Promise<void>;
+};
+export declare function createPostHogRpcLogger(telemetry: PostHogServerTelemetry, options?: PostHogRpcLoggerOptions): RpcLogger;
+export declare function installPostHogServerTelemetryShutdown(telemetry: Pick<PostHogServerTelemetry, 'shutdown'>, target?: PostHogShutdownProcess): () => void;
+export {};

package/dist/posthog/server.js

@@ -1,3 +1,4 @@
+import { postHogRequestContext } from './request.js';
 export async function createPostHogServerClient(environment, options = {}) {
     if (!environment)
         return undefined;
@@ -9,9 +10,236 @@ export async function createPostHogServerClient(environment, options = {}) {
     });
 }
 export async function shutdownPostHogServerClient(client, timeoutMs = 10_000) {
-    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
-        throw new Error('timeoutMs must be a non-negative integer');
+    assertShutdownTimeout(timeoutMs);
     // oxlint-disable-next-line no-underscore-dangle -- posthog-node's async shutdown API is named `_shutdown`.
     await client?._shutdown(timeoutMs);
 }
+export function createManagedPostHogServerTelemetry(options) {
+    let client;
+    let logProvider;
+    let closed = false;
+    const report = (error) => {
+        try {
+            options.onError?.(error);
+        }
+        catch { }
+    };
+    const getClient = () => {
+        if (closed || !options.environment)
+            return undefined;
+        if (!client) {
+            const pending = createPostHogServerClient(options.environment, options.clientOptions);
+            client = pending;
+            void pending.catch(() => {
+                if (client === pending)
+                    client = undefined;
+            });
+        }
+        return client;
+    };
+    const getLogProvider = () => {
+        if (closed || !options.environment)
+            return undefined;
+        if (!logProvider) {
+            const pending = createPostHogLogProvider(options);
+            logProvider = pending;
+            void pending.catch(() => {
+                if (logProvider === pending)
+                    logProvider = undefined;
+            });
+        }
+        return logProvider;
+    };
+    const safely = async (work) => {
+        if (closed || !options.environment)
+            return;
+        try {
+            await work();
+        }
+        catch (error) {
+            report(error);
+        }
+    };
+    return {
+        async start() {
+            await safely(async () => {
+                await Promise.all([getClient(), getLogProvider()]);
+            });
+        },
+        async capture(distinctId, event, properties) {
+            await safely(async () => {
+                const value = await getClient();
+                value?.capture({ distinctId, event, ...(properties ? { properties } : {}) });
+            });
+        },
+        async exception(error, distinctId = 'server', properties) {
+            await safely(async () => {
+                const value = await getClient();
+                value?.captureException(error, distinctId, properties);
+            });
+        },
+        async log(record) {
+            await safely(async () => {
+                const provider = await getLogProvider();
+                const attributes = boundedAttributes(record.attributes);
+                provider?.getLogger(options.serviceName).emit({
+                    body: boundedString(record.body),
+                    ...(record.severityText ? { severityText: record.severityText } : {}),
+                    ...(record.timestamp === undefined ? {} : { timestamp: record.timestamp }),
+                    ...(attributes ? { attributes } : {}),
+                });
+            });
+        },
+        async shutdown(timeoutMs = 10_000) {
+            if (closed)
+                return;
+            assertShutdownTimeout(timeoutMs);
+            closed = true;
+            const results = await Promise.allSettled([
+                client?.then((value) => shutdownPostHogServerClient(value, timeoutMs)),
+                logProvider?.then((value) => shutdownPostHogLogProvider(value, timeoutMs)),
+            ]);
+            for (const result of results)
+                if (result.status === 'rejected')
+                    report(result.reason);
+        },
+    };
+}
+export function createPostHogRpcLogger(telemetry, options = {}) {
+    return async (error, context, request) => {
+        try {
+            options.logError?.(error, context);
+        }
+        catch { }
+        let authenticatedDistinctId;
+        if (request && options.resolveAuthenticatedDistinctId) {
+            try {
+                authenticatedDistinctId = await options.resolveAuthenticatedDistinctId(request);
+            }
+            catch { }
+        }
+        const correlation = request
+            ? postHogRequestContext(request, {
+                ...(authenticatedDistinctId ? { authenticatedDistinctId } : {}),
+                ...(options.allowAnonymousDistinctId === undefined ? {} : { allowAnonymousDistinctId: options.allowAnonymousDistinctId }),
+            })
+            : { properties: {} };
+        const distinctId = correlation.distinctId ?? options.fallbackDistinctId ?? 'server';
+        const properties = {
+            ...correlation.properties,
+            ...(context.method ? { request_method: context.method } : {}),
+            ...(context.path ? { request_path: context.path } : {}),
+        };
+        await Promise.all([
+            telemetry.exception(error, distinctId, properties),
+            telemetry.log({
+                body: 'server function failed',
+                severityText: 'error',
+                attributes: { ...properties, posthogDistinctId: distinctId },
+            }),
+        ]);
+    };
+}
+export function installPostHogServerTelemetryShutdown(telemetry, target = process) {
+    let shuttingDown = false;
+    const listeners = new Map();
+    const remove = () => {
+        for (const [signal, listener] of listeners)
+            target.off(signal, listener);
+        listeners.clear();
+    };
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        const listener = () => {
+            if (shuttingDown)
+                return;
+            shuttingDown = true;
+            void telemetry
+                .shutdown()
+                .catch(() => undefined)
+                .finally(() => {
+                remove();
+                target.kill(target.pid, signal);
+            });
+        };
+        listeners.set(signal, listener);
+        target.on(signal, listener);
+    }
+    return remove;
+}
+async function createPostHogLogProvider(options) {
+    if (!options.environment)
+        return undefined;
+    const [{ OTLPLogExporter }, { resourceFromAttributes }, { BatchLogRecordProcessor, LoggerProvider }] = await Promise.all([
+        import('@opentelemetry/exporter-logs-otlp-http'),
+        import('@opentelemetry/resources'),
+        import('@opentelemetry/sdk-logs'),
+    ]);
+    const exporter = new OTLPLogExporter({
+        url: `${options.environment.host.replace(/\/$/, '')}/i/v1/logs`,
+        headers: { Authorization: `Bearer ${options.environment.projectToken}` },
+    });
+    return new LoggerProvider({
+        resource: resourceFromAttributes({
+            'service.name': options.serviceName,
+            ...(options.serviceVersion ? { 'service.version': options.serviceVersion } : {}),
+            ...(options.deploymentEnvironment ? { 'deployment.environment': options.deploymentEnvironment } : {}),
+        }),
+        processors: [new BatchLogRecordProcessor({ exporter })],
+    });
+}
+function boundedAttributes(attributes) {
+    if (!attributes)
+        return undefined;
+    return Object.fromEntries(Object.entries(attributes)
+        .slice(0, 64)
+        .map(([key, value]) => [key.slice(0, 128), boundedLogValue(value, 0)])
+        .filter((entry) => entry[1] !== undefined));
+}
+function boundedLogValue(value, depth) {
+    if (value === null || typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'string')
+        return boundedString(value);
+    if (depth >= 3)
+        return '[Truncated]';
+    if (Array.isArray(value)) {
+        return value
+            .slice(0, 32)
+            .map((entry) => boundedLogValue(entry, depth + 1))
+            .filter((entry) => entry !== undefined);
+    }
+    if (value === undefined)
+        return undefined;
+    try {
+        return boundedString(JSON.stringify(value));
+    }
+    catch {
+        return '[Unserializable value]';
+    }
+}
+function boundedString(value) {
+    return value.slice(0, 2_048);
+}
+async function shutdownPostHogLogProvider(provider, timeoutMs) {
+    if (!provider)
+        return;
+    let timeout;
+    try {
+        await Promise.race([
+            provider.shutdown(),
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => reject(new Error(`PostHog log shutdown timed out after ${timeoutMs}ms`)), timeoutMs);
+                timeout.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+function assertShutdownTimeout(timeoutMs) {
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0)
+        throw new Error('timeoutMs must be a non-negative integer');
+}
 //# sourceMappingURL=server.js.map

package/dist/posthog/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/posthog/server.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAA2C,EAC3C,OAAO,GAAiC,EAAE;IAE1C,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IAClC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IAChD,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE;QAC3C,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,0BAA0B,EAAE,IAAI;QAChC,GAAG,OAAO;KACX,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAA2B,EAAE,SAAS,GAAG,MAAM;IAC/F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAClH,2GAA2G;IAC3G,MAAM,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;AACpC,CAAC","sourcesContent":["import type { PostHog, PostHogOptions } from 'posthog-node'\nimport type { PostHogEnvironment } from './config.js'\n\nexport async function createPostHogServerClient(\n  environment: PostHogEnvironment | undefined,\n  options: Omit<PostHogOptions, 'host'> = {},\n): Promise<PostHog | undefined> {\n  if (!environment) return undefined\n  const { PostHog } = await import('posthog-node')\n  return new PostHog(environment.projectToken, {\n    host: environment.host,\n    enableExceptionAutocapture: true,\n    ...options,\n  })\n}\n\nexport async function shutdownPostHogServerClient(client: PostHog | undefined, timeoutMs = 10_000) {\n  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0) throw new Error('timeoutMs must be a non-negative integer')\n  // oxlint-disable-next-line no-underscore-dangle -- posthog-node's async shutdown API is named `_shutdown`.\n  await client?._shutdown(timeoutMs)\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/posthog/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAsCpD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAA2C,EAC3C,OAAO,GAAiC,EAAE;IAE1C,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IAClC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;IAChD,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE;QAC3C,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,0BAA0B,EAAE,IAAI;QAChC,GAAG,OAAO;KACX,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAA2B,EAAE,SAAS,GAAG,MAAM;IAC/F,qBAAqB,CAAC,SAAS,CAAC,CAAA;IAChC,2GAA2G;IAC3G,MAAM,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,OAA6C;IAC/F,IAAI,MAAgD,CAAA;IACpD,IAAI,WAAyD,CAAA;IAC7D,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAC1B,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAO,SAAS,CAAA;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;YACrF,MAAM,GAAG,OAAO,CAAA;YAChB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,IAAI,MAAM,KAAK,OAAO;oBAAE,MAAM,GAAG,SAAS,CAAA;YAC5C,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAO,SAAS,CAAA;QACpD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAA;YACjD,WAAW,GAAG,OAAO,CAAA;YACrB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACtB,IAAI,WAAW,KAAK,OAAO;oBAAE,WAAW,GAAG,SAAS,CAAA;YACtD,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,WAAW,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,KAAK,EAAE,IAAgC,EAAE,EAAE;QACxD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAM;QAC1C,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,CAAA;QACf,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,CAAA;YACpD,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,KAAa,EAAE,UAAoC;YACnF,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAA;gBAC/B,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC9E,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,KAAc,EAAE,UAAU,GAAG,QAAQ,EAAE,UAAoC;YACzF,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAA;gBAC/B,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;YACxD,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAwB;YAChC,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;gBACtB,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAA;gBACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;gBACvD,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;oBAC5C,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;oBAChC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrE,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;oBAC1E,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,SAAS,GAAG,MAAM;YAC/B,IAAI,MAAM;gBAAE,OAAM;YAClB,qBAAqB,CAAC,SAAS,CAAC,CAAA;YAChC,MAAM,GAAG,IAAI,CAAA;YACb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;gBACvC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBACtE,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;aAC3E,CAAC,CAAA;YACF,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;oBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvF,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiC,EAAE,OAAO,GAA4B,EAAE;IAC7G,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,IAAI,uBAA2C,CAAA;QAC/C,IAAI,OAAO,IAAI,OAAO,CAAC,8BAA8B,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,uBAAuB,GAAG,MAAM,OAAO,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAA;YACjF,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QACD,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,qBAAqB,CAAC,OAAO,EAAE;gBAC7B,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,OAAO,CAAC,wBAAwB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,wBAAwB,EAAE,CAAC;aAC1H,CAAC;YACJ,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;QACtB,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,IAAI,OAAO,CAAC,kBAAkB,IAAI,QAAQ,CAAA;QACnF,MAAM,UAAU,GAAG;YACjB,GAAG,WAAW,CAAC,UAAU;YACzB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAA;QACD,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC;YAClD,SAAS,CAAC,GAAG,CAAC;gBACZ,IAAI,EAAE,wBAAwB;gBAC9B,YAAY,EAAE,OAAO;gBACrB,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE;aAC7D,CAAC;SACH,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,SAAmD,EACnD,MAAM,GAA2B,OAAO;IAExC,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAA;IAC7D,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACxE,SAAS,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC,CAAA;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,YAAY;gBAAE,OAAM;YACxB,YAAY,GAAG,IAAI,CAAA;YACnB,KAAK,SAAS;iBACX,QAAQ,EAAE;iBACV,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;iBACtB,OAAO,CAAC,GAAG,EAAE;gBACZ,MAAM,EAAE,CAAA;gBACR,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACjC,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QACD,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,OAA6C;IACnF,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,OAAO,SAAS,CAAA;IAC1C,MAAM,CAAC,EAAE,eAAe,EAAE,EAAE,EAAE,sBAAsB,EAAE,EAAE,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvH,MAAM,CAAC,wCAAwC,CAAC;QAChD,MAAM,CAAC,0BAA0B,CAAC;QAClC,MAAM,CAAC,yBAAyB,CAAC;KAClC,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACnC,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY;QAC/D,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE;KACzE,CAAC,CAAA;IACF,OAAO,IAAI,cAAc,CAAC;QACxB,QAAQ,EAAE,sBAAsB,CAAC;YAC/B,cAAc,EAAE,OAAO,CAAC,WAAW;YACnC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtG,CAAC;QACF,UAAU,EAAE,CAAC,IAAI,uBAAuB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;KACxD,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA+C;IACxE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAA;IACjC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;SACrE,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CACjF,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa;IACpD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC3F,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC1D,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,aAAa,CAAA;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK;aACT,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;aACjD,MAAM,CAAC,CAAC,KAAK,EAA4B,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAA;IACrE,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,wBAAwB,CAAA;IACjC,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,QAAiC,EAAE,SAAiB;IAC5F,IAAI,CAAC,QAAQ;QAAE,OAAM;IACrB,IAAI,OAAkD,CAAA;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,QAAQ,CAAC,QAAQ,EAAE;YACnB,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACtC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wCAAwC,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;gBAC/G,OAAO,CAAC,KAAK,EAAE,EAAE,CAAA;YACnB,CAAC,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;AACpH,CAAC","sourcesContent":["import type { PostHog, PostHogOptions } from 'posthog-node'\nimport type { RpcErrorContext, RpcLogger } from '../server/rpc.js'\nimport type { PostHogEnvironment } from './config.js'\nimport { postHogRequestContext } from './request.js'\n\ntype LogProvider = InstanceType<(typeof import('@opentelemetry/sdk-logs'))['LoggerProvider']>\n\nexport type PostHogLogValue = string | number | boolean | null | PostHogLogValue[]\n\nexport type PostHogLogRecord = {\n  body: string\n  severityText?: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'\n  timestamp?: number\n  attributes?: Record<string, unknown>\n}\n\nexport type ManagedPostHogServerTelemetryOptions = {\n  environment: PostHogEnvironment | undefined\n  serviceName: string\n  serviceVersion?: string\n  deploymentEnvironment?: string\n  clientOptions?: Omit<PostHogOptions, 'host'>\n  onError?: (error: unknown) => void\n}\n\nexport type PostHogServerTelemetry = ReturnType<typeof createManagedPostHogServerTelemetry>\n\nexport type PostHogRpcLoggerOptions = {\n  logError?: (error: unknown, context: RpcErrorContext) => void\n  resolveAuthenticatedDistinctId?: (request: Request) => string | undefined | Promise<string | undefined>\n  allowAnonymousDistinctId?: boolean\n  fallbackDistinctId?: string\n}\n\ntype PostHogShutdownProcess = {\n  pid: number\n  on(signal: 'SIGINT' | 'SIGTERM', listener: () => void): void\n  off(signal: 'SIGINT' | 'SIGTERM', listener: () => void): void\n  kill(pid: number, signal: 'SIGINT' | 'SIGTERM'): void\n}\n\nexport async function createPostHogServerClient(\n  environment: PostHogEnvironment | undefined,\n  options: Omit<PostHogOptions, 'host'> = {},\n): Promise<PostHog | undefined> {\n  if (!environment) return undefined\n  const { PostHog } = await import('posthog-node')\n  return new PostHog(environment.projectToken, {\n    host: environment.host,\n    enableExceptionAutocapture: true,\n    ...options,\n  })\n}\n\nexport async function shutdownPostHogServerClient(client: PostHog | undefined, timeoutMs = 10_000) {\n  assertShutdownTimeout(timeoutMs)\n  // oxlint-disable-next-line no-underscore-dangle -- posthog-node's async shutdown API is named `_shutdown`.\n  await client?._shutdown(timeoutMs)\n}\n\nexport function createManagedPostHogServerTelemetry(options: ManagedPostHogServerTelemetryOptions) {\n  let client: Promise<PostHog | undefined> | undefined\n  let logProvider: Promise<LogProvider | undefined> | undefined\n  let closed = false\n\n  const report = (error: unknown) => {\n    try {\n      options.onError?.(error)\n    } catch {}\n  }\n\n  const getClient = () => {\n    if (closed || !options.environment) return undefined\n    if (!client) {\n      const pending = createPostHogServerClient(options.environment, options.clientOptions)\n      client = pending\n      void pending.catch(() => {\n        if (client === pending) client = undefined\n      })\n    }\n    return client\n  }\n\n  const getLogProvider = () => {\n    if (closed || !options.environment) return undefined\n    if (!logProvider) {\n      const pending = createPostHogLogProvider(options)\n      logProvider = pending\n      void pending.catch(() => {\n        if (logProvider === pending) logProvider = undefined\n      })\n    }\n    return logProvider\n  }\n\n  const safely = async (work: () => void | Promise<void>) => {\n    if (closed || !options.environment) return\n    try {\n      await work()\n    } catch (error) {\n      report(error)\n    }\n  }\n\n  return {\n    async start() {\n      await safely(async () => {\n        await Promise.all([getClient(), getLogProvider()])\n      })\n    },\n    async capture(distinctId: string, event: string, properties?: Record<string, unknown>) {\n      await safely(async () => {\n        const value = await getClient()\n        value?.capture({ distinctId, event, ...(properties ? { properties } : {}) })\n      })\n    },\n    async exception(error: unknown, distinctId = 'server', properties?: Record<string, unknown>) {\n      await safely(async () => {\n        const value = await getClient()\n        value?.captureException(error, distinctId, properties)\n      })\n    },\n    async log(record: PostHogLogRecord) {\n      await safely(async () => {\n        const provider = await getLogProvider()\n        const attributes = boundedAttributes(record.attributes)\n        provider?.getLogger(options.serviceName).emit({\n          body: boundedString(record.body),\n          ...(record.severityText ? { severityText: record.severityText } : {}),\n          ...(record.timestamp === undefined ? {} : { timestamp: record.timestamp }),\n          ...(attributes ? { attributes } : {}),\n        })\n      })\n    },\n    async shutdown(timeoutMs = 10_000) {\n      if (closed) return\n      assertShutdownTimeout(timeoutMs)\n      closed = true\n      const results = await Promise.allSettled([\n        client?.then((value) => shutdownPostHogServerClient(value, timeoutMs)),\n        logProvider?.then((value) => shutdownPostHogLogProvider(value, timeoutMs)),\n      ])\n      for (const result of results) if (result.status === 'rejected') report(result.reason)\n    },\n  }\n}\n\nexport function createPostHogRpcLogger(telemetry: PostHogServerTelemetry, options: PostHogRpcLoggerOptions = {}): RpcLogger {\n  return async (error, context, request) => {\n    try {\n      options.logError?.(error, context)\n    } catch {}\n    let authenticatedDistinctId: string | undefined\n    if (request && options.resolveAuthenticatedDistinctId) {\n      try {\n        authenticatedDistinctId = await options.resolveAuthenticatedDistinctId(request)\n      } catch {}\n    }\n    const correlation = request\n      ? postHogRequestContext(request, {\n          ...(authenticatedDistinctId ? { authenticatedDistinctId } : {}),\n          ...(options.allowAnonymousDistinctId === undefined ? {} : { allowAnonymousDistinctId: options.allowAnonymousDistinctId }),\n        })\n      : { properties: {} }\n    const distinctId = correlation.distinctId ?? options.fallbackDistinctId ?? 'server'\n    const properties = {\n      ...correlation.properties,\n      ...(context.method ? { request_method: context.method } : {}),\n      ...(context.path ? { request_path: context.path } : {}),\n    }\n    await Promise.all([\n      telemetry.exception(error, distinctId, properties),\n      telemetry.log({\n        body: 'server function failed',\n        severityText: 'error',\n        attributes: { ...properties, posthogDistinctId: distinctId },\n      }),\n    ])\n  }\n}\n\nexport function installPostHogServerTelemetryShutdown(\n  telemetry: Pick<PostHogServerTelemetry, 'shutdown'>,\n  target: PostHogShutdownProcess = process,\n) {\n  let shuttingDown = false\n  const listeners = new Map<'SIGINT' | 'SIGTERM', () => void>()\n  const remove = () => {\n    for (const [signal, listener] of listeners) target.off(signal, listener)\n    listeners.clear()\n  }\n  for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n    const listener = () => {\n      if (shuttingDown) return\n      shuttingDown = true\n      void telemetry\n        .shutdown()\n        .catch(() => undefined)\n        .finally(() => {\n          remove()\n          target.kill(target.pid, signal)\n        })\n    }\n    listeners.set(signal, listener)\n    target.on(signal, listener)\n  }\n  return remove\n}\n\nasync function createPostHogLogProvider(options: ManagedPostHogServerTelemetryOptions): Promise<LogProvider | undefined> {\n  if (!options.environment) return undefined\n  const [{ OTLPLogExporter }, { resourceFromAttributes }, { BatchLogRecordProcessor, LoggerProvider }] = await Promise.all([\n    import('@opentelemetry/exporter-logs-otlp-http'),\n    import('@opentelemetry/resources'),\n    import('@opentelemetry/sdk-logs'),\n  ])\n  const exporter = new OTLPLogExporter({\n    url: `${options.environment.host.replace(/\\/$/, '')}/i/v1/logs`,\n    headers: { Authorization: `Bearer ${options.environment.projectToken}` },\n  })\n  return new LoggerProvider({\n    resource: resourceFromAttributes({\n      'service.name': options.serviceName,\n      ...(options.serviceVersion ? { 'service.version': options.serviceVersion } : {}),\n      ...(options.deploymentEnvironment ? { 'deployment.environment': options.deploymentEnvironment } : {}),\n    }),\n    processors: [new BatchLogRecordProcessor({ exporter })],\n  })\n}\n\nfunction boundedAttributes(attributes: Record<string, unknown> | undefined) {\n  if (!attributes) return undefined\n  return Object.fromEntries(\n    Object.entries(attributes)\n      .slice(0, 64)\n      .map(([key, value]) => [key.slice(0, 128), boundedLogValue(value, 0)])\n      .filter((entry): entry is [string, PostHogLogValue] => entry[1] !== undefined),\n  )\n}\n\nfunction boundedLogValue(value: unknown, depth: number): PostHogLogValue | undefined {\n  if (value === null || typeof value === 'number' || typeof value === 'boolean') return value\n  if (typeof value === 'string') return boundedString(value)\n  if (depth >= 3) return '[Truncated]'\n  if (Array.isArray(value)) {\n    return value\n      .slice(0, 32)\n      .map((entry) => boundedLogValue(entry, depth + 1))\n      .filter((entry): entry is PostHogLogValue => entry !== undefined)\n  }\n  if (value === undefined) return undefined\n  try {\n    return boundedString(JSON.stringify(value))\n  } catch {\n    return '[Unserializable value]'\n  }\n}\n\nfunction boundedString(value: string) {\n  return value.slice(0, 2_048)\n}\n\nasync function shutdownPostHogLogProvider(provider: LogProvider | undefined, timeoutMs: number) {\n  if (!provider) return\n  let timeout: ReturnType<typeof setTimeout> | undefined\n  try {\n    await Promise.race([\n      provider.shutdown(),\n      new Promise<never>((_resolve, reject) => {\n        timeout = setTimeout(() => reject(new Error(`PostHog log shutdown timed out after ${timeoutMs}ms`)), timeoutMs)\n        timeout.unref?.()\n      }),\n    ])\n  } finally {\n    if (timeout) clearTimeout(timeout)\n  }\n}\n\nfunction assertShutdownTimeout(timeoutMs: number) {\n  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0) throw new Error('timeoutMs must be a non-negative integer')\n}\n"]}

package/dist/server/rpc.d.ts

@@ -1,7 +1,8 @@
-export type RpcLogger = (error: unknown, context: {
+export type RpcErrorContext = {
     method?: string;
     path?: string;
-}) => void;
+};
+export type RpcLogger = (error: unknown, context: RpcErrorContext, request?: Request) => void | Promise<void>;
 export type RpcOptions = {
     getRequest?: () => Request;
     requireMutation?: (request: Request) => void;

package/dist/server/rpc.js

@@ -6,7 +6,11 @@ export function createRpc(options = {}) {
         catch (error) {
             if (error instanceof Response)
                 throw new Error((await error.text()) || `request failed (${error.status})`, { cause: error });
-            options.logError?.(error, requestContext(options.getRequest));
+            const request = resolveRequest(options.getRequest);
+            try {
+                await options.logError?.(error, requestContext(request), request);
+            }
+            catch { }
             throw error;
         }
     }
@@ -20,13 +24,15 @@ export function createRpc(options = {}) {
     }
     return { rpc, mutationRpc };
 }
-function requestContext(getRequest) {
+function resolveRequest(getRequest) {
     try {
-        const request = getRequest?.();
-        return request ? { method: request.method, path: new URL(request.url).pathname } : {};
+        return getRequest?.();
     }
     catch {
-        return {};
+        return undefined;
     }
 }
+function requestContext(request) {
+    return request ? { method: request.method, path: new URL(request.url).pathname } : {};
+}
 //# sourceMappingURL=rpc.js.map

package/dist/server/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/server/rpc.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,SAAS,CAAC,OAAO,GAAe,EAAE;IAChD,KAAK,UAAU,GAAG,CAAI,IAA0B;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,mBAAmB,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YAC5H,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;YAC7D,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,SAAS,WAAW,CAAI,IAA0B,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,EAAE;QAClF,OAAO,GAAG,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YAChE,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAA;YAClC,OAAO,IAAI,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA;AAC7B,CAAC;AAED,SAAS,cAAc,CAAC,UAAuC;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,EAAE,EAAE,CAAA;QAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC","sourcesContent":["export type RpcLogger = (error: unknown, context: { method?: string; path?: string }) => void\n\nexport type RpcOptions = {\n  getRequest?: () => Request\n  requireMutation?: (request: Request) => void\n  logError?: RpcLogger\n}\n\nexport function createRpc(options: RpcOptions = {}) {\n  async function rpc<T>(work: () => Promise<T> | T): Promise<T> {\n    try {\n      return await work()\n    } catch (error) {\n      if (error instanceof Response) throw new Error((await error.text()) || `request failed (${error.status})`, { cause: error })\n      options.logError?.(error, requestContext(options.getRequest))\n      throw error\n    }\n  }\n\n  function mutationRpc<T>(work: () => Promise<T> | T, request = options.getRequest?.()) {\n    return rpc(() => {\n      if (!request) throw new Error('mutation request is unavailable')\n      options.requireMutation?.(request)\n      return work()\n    })\n  }\n\n  return { rpc, mutationRpc }\n}\n\nfunction requestContext(getRequest: (() => Request) | undefined) {\n  try {\n    const request = getRequest?.()\n    return request ? { method: request.method, path: new URL(request.url).pathname } : {}\n  } catch {\n    return {}\n  }\n}\n"]}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/server/rpc.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,SAAS,CAAC,OAAO,GAAe,EAAE;IAChD,KAAK,UAAU,GAAG,CAAI,IAA0B;QAC9C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,mBAAmB,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;YAC5H,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YAClD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;YACnE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACV,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,SAAS,WAAW,CAAI,IAA0B,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,EAAE;QAClF,OAAO,GAAG,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YAChE,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,CAAA;YAClC,OAAO,IAAI,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA;AAC7B,CAAC;AAED,SAAS,cAAc,CAAC,UAAuC;IAC7D,IAAI,CAAC;QACH,OAAO,UAAU,EAAE,EAAE,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,OAA4B;IAClD,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACvF,CAAC","sourcesContent":["export type RpcErrorContext = { method?: string; path?: string }\nexport type RpcLogger = (error: unknown, context: RpcErrorContext, request?: Request) => void | Promise<void>\n\nexport type RpcOptions = {\n  getRequest?: () => Request\n  requireMutation?: (request: Request) => void\n  logError?: RpcLogger\n}\n\nexport function createRpc(options: RpcOptions = {}) {\n  async function rpc<T>(work: () => Promise<T> | T): Promise<T> {\n    try {\n      return await work()\n    } catch (error) {\n      if (error instanceof Response) throw new Error((await error.text()) || `request failed (${error.status})`, { cause: error })\n      const request = resolveRequest(options.getRequest)\n      try {\n        await options.logError?.(error, requestContext(request), request)\n      } catch {}\n      throw error\n    }\n  }\n\n  function mutationRpc<T>(work: () => Promise<T> | T, request = options.getRequest?.()) {\n    return rpc(() => {\n      if (!request) throw new Error('mutation request is unavailable')\n      options.requireMutation?.(request)\n      return work()\n    })\n  }\n\n  return { rpc, mutationRpc }\n}\n\nfunction resolveRequest(getRequest: (() => Request) | undefined) {\n  try {\n    return getRequest?.()\n  } catch {\n    return undefined\n  }\n}\n\nfunction requestContext(request: Request | undefined): RpcErrorContext {\n  return request ? { method: request.method, path: new URL(request.url).pathname } : {}\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.34.1",
+  "version": "0.35.0",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",
@@ -156,6 +156,10 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.1",
+    "@opentelemetry/api-logs": "^0.221.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "^0.221.0",
     "@playwright/test": "1.62.1",
     "@posthog/react": "^1.10.3",
     "@tanstack/react-query": "^5.101.4",
@@ -183,6 +187,10 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
+    "@opentelemetry/api-logs": "^0.221.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "^0.221.0",
     "@posthog/react": ">=1 <2",
     "@tanstack/react-query": ">=5 <6",
     "@tanstack/react-start": ">=1 <2",
@@ -197,6 +205,18 @@
     "tus-js-client": ">=4 <5"
   },
   "peerDependenciesMeta": {
+    "@opentelemetry/api-logs": {
+      "optional": true
+    },
+    "@opentelemetry/exporter-logs-otlp-http": {
+      "optional": true
+    },
+    "@opentelemetry/resources": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-logs": {
+      "optional": true
+    },
     "@posthog/react": {
       "optional": true
     },