p-dev-harness 0.3.1 → 0.4.0

package/dist/observability/adapters/posthog.js

@@ -0,0 +1,142 @@
+import { PostHog } from "posthog-node";
+import { OBSERVABILITY_MAX_QUEUE_SIZE } from "../constants.js";
+export function createPostHogAnalyticsTransport(options) {
+    if (!options.projectToken.trim()) {
+        throw new Error("PostHog adapter requires a non-empty project token.");
+    }
+    const host = options.host.replace(/\/$/, "");
+    const maxOperations = Math.max(1, options.maxOperations ?? OBSERVABILITY_MAX_QUEUE_SIZE);
+    const inFlight = new Set();
+    const pending = [];
+    let drainScheduled = false;
+    let active = true;
+    let client = new PostHog(options.projectToken, {
+        host,
+        flushAt: 1,
+        flushInterval: 0,
+        disableGeoip: true,
+        disableCompression: true,
+        persistence: "memory",
+        fetch: options.fetchImpl
+            ? async (url, fetchOptions) => {
+                const response = await options.fetchImpl(url, fetchOptions);
+                return {
+                    status: response.status,
+                    text: async () => response.text(),
+                    json: async () => response.json(),
+                };
+            }
+            : undefined,
+    });
+    async function deliver(event) {
+        const currentClient = client;
+        if (!active || !currentClient) {
+            return;
+        }
+        const initiatedAt = Date.now();
+        options.onRequestInitiated?.(initiatedAt);
+        try {
+            await currentClient.captureImmediate({
+                distinctId: String(event.properties.distinct_id ?? "unknown"),
+                event: event.event,
+                properties: {
+                    ...event.properties,
+                    $process_person_profile: false,
+                },
+                disableGeoip: true,
+            });
+            options.onRequestCompleted?.(Date.now());
+        }
+        catch {
+            // best-effort transport
+        }
+    }
+    function drainPending() {
+        drainScheduled = false;
+        while (active &&
+            client &&
+            pending.length > 0 &&
+            inFlight.size < maxOperations) {
+            const event = pending.shift();
+            if (!event) {
+                continue;
+            }
+            const operation = deliver(event).finally(() => {
+                inFlight.delete(operation);
+                if (active && pending.length > 0) {
+                    scheduleDrain();
+                }
+            });
+            inFlight.add(operation);
+        }
+        if (!active) {
+            pending.length = 0;
+        }
+    }
+    function scheduleDrain() {
+        if (drainScheduled) {
+            return;
+        }
+        drainScheduled = true;
+        queueMicrotask(drainPending);
+    }
+    async function waitForInFlight(deadlineMs) {
+        const started = Date.now();
+        while (inFlight.size > 0 && Date.now() - started < deadlineMs) {
+            const remaining = Math.max(0, deadlineMs - (Date.now() - started));
+            await Promise.race([
+                Promise.allSettled([...inFlight]),
+                new Promise((resolve) => setTimeout(resolve, Math.min(10, remaining))),
+            ]);
+            if (active) {
+                drainPending();
+            }
+        }
+    }
+    return {
+        capture(event) {
+            if (!active || !client) {
+                return;
+            }
+            if (pending.length + inFlight.size >= maxOperations) {
+                return;
+            }
+            pending.push(event);
+            scheduleDrain();
+        },
+        async flush(deadlineMs) {
+            drainPending();
+            await waitForInFlight(deadlineMs);
+        },
+        async shutdown(options) {
+            const deadlineMs = options?.deadlineMs ?? 2_000;
+            if (options?.flush !== false) {
+                await this.flush(deadlineMs);
+            }
+            active = false;
+            pending.length = 0;
+            if (client) {
+                try {
+                    await client.shutdown(deadlineMs);
+                }
+                catch {
+                    // vendor timeout/rejection must not fail product shutdown
+                }
+                client = null;
+            }
+            await waitForInFlight(deadlineMs);
+        },
+        async disableAndDrop(deadlineMs) {
+            active = false;
+            pending.length = 0;
+            if (client) {
+                client = null;
+            }
+            await waitForInFlight(deadlineMs);
+        },
+        isActive() {
+            return active;
+        },
+    };
+}
+//# sourceMappingURL=posthog.js.map

package/dist/observability/adapters/posthog.js.map

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

package/dist/observability/adapters/sentry.d.ts

@@ -0,0 +1,12 @@
+import { NodeClient } from "@sentry/node";
+import type { ErrorTransport } from "../types.js";
+export interface SentryAdapterOptions {
+    dsn: string;
+    release: string;
+    environment?: string;
+    transport?: ConstructorParameters<typeof NodeClient>[0] extends {
+        transport?: infer T;
+    } ? T : never;
+}
+export declare function createSentryErrorTransport(options: SentryAdapterOptions): ErrorTransport;
+//# sourceMappingURL=sentry.d.ts.map

package/dist/observability/adapters/sentry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/sentry.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EACX,MAAM,cAAc,CAAC;AAUtB,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,aAAa,CAAC;AAgBrB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,qBAAqB,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GACnF,CAAC,GACD,KAAK,CAAC;CACX;AA6FD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CA0IhB"}

package/dist/observability/adapters/sentry.js

@@ -0,0 +1,217 @@
+import { defaultStackParser, makeNodeTransport, NodeClient, } from "@sentry/node";
+import { ALLOWED_SENTRY_TAG_KEYS } from "../privacy-schema.js";
+import { approvedProductErrorMessage } from "../product-error-messages.js";
+import { sanitizeExceptionCause, sanitizeFilename, sanitizeObservabilityString, sanitizeStackTrace, sanitizeTagRecord, } from "../redaction.js";
+import { P_DEV_SENTRY_ENVIRONMENT_ENV } from "../constants.js";
+import { scrubOutboundSentryEnvelope, scrubOutboundSentryEvent, } from "../sentry-outbound-privacy.js";
+function filterAllowedTags(tags) {
+    const allowed = new Set(ALLOWED_SENTRY_TAG_KEYS);
+    const filtered = {};
+    for (const [key, value] of Object.entries(tags)) {
+        if (allowed.has(key)) {
+            filtered[key] = sanitizeObservabilityString(value);
+        }
+    }
+    return filtered;
+}
+function safeStackFrames(stack) {
+    const sanitized = sanitizeStackTrace(stack);
+    if (!sanitized) {
+        return undefined;
+    }
+    return defaultStackParser(sanitized)
+        .slice(-20)
+        .map((frame) => ({
+        filename: sanitizeFilename(frame.filename),
+        function: frame.function
+            ? sanitizeObservabilityString(frame.function)
+            : undefined,
+        module: frame.module ? sanitizeObservabilityString(frame.module) : undefined,
+        lineno: frame.lineno,
+        colno: frame.colno,
+        in_app: frame.in_app,
+    }));
+}
+function buildApprovedEvent(input, context) {
+    const productErrorCode = sanitizeObservabilityString(input.productErrorCode);
+    const lifecyclePhase = input.lifecyclePhase;
+    const approvedMessage = approvedProductErrorMessage(productErrorCode);
+    const sanitizedCause = sanitizeExceptionCause(input.cause);
+    const tags = filterAllowedTags(sanitizeTagRecord({
+        ...context,
+        product_error_code: productErrorCode,
+        error_category: input.errorCategory,
+        lifecycle_phase: lifecyclePhase,
+        configure_step_id: input.configureStepId,
+        operation_resumed: input.operationResumed,
+        remote_mutation_begun: input.remoteMutationBegun,
+        durable_recovery_state_exists: input.durableRecoveryStateExists,
+        duration_bucket: input.durationBucket,
+        retry_count_bucket: input.retryCountBucket,
+        rate_limit_pause_count_bucket: input.rateLimitPauseCountBucket,
+    }));
+    return {
+        type: undefined,
+        platform: "node",
+        level: "error",
+        message: approvedMessage,
+        tags,
+        fingerprint: [productErrorCode, lifecyclePhase],
+        exception: {
+            values: [
+                {
+                    type: sanitizeObservabilityString(sanitizedCause.type || "Error"),
+                    value: approvedMessage,
+                    stacktrace: {
+                        frames: safeStackFrames(sanitizedCause.stack),
+                    },
+                },
+            ],
+        },
+    };
+}
+async function waitForInFlight(inFlight, deadlineMs) {
+    const started = Date.now();
+    while (inFlight.size > 0 && Date.now() - started < deadlineMs) {
+        const remaining = Math.max(0, deadlineMs - (Date.now() - started));
+        await Promise.race([
+            Promise.allSettled([...inFlight]),
+            new Promise((resolve) => setTimeout(resolve, Math.min(10, remaining))),
+        ]);
+    }
+}
+export function createSentryErrorTransport(options) {
+    if (!options.dsn.trim()) {
+        throw new Error("Sentry adapter requires a non-empty DSN.");
+    }
+    let active = true;
+    let drainScheduled = false;
+    const pending = [];
+    const inFlight = new Set();
+    const baseTransportFactory = options.transport ?? makeNodeTransport;
+    const trackingTransportFactory = (transportOptions) => {
+        const base = baseTransportFactory(transportOptions);
+        return {
+            send(envelope) {
+                let tracked;
+                const operation = Promise.resolve()
+                    .then(() => {
+                    try {
+                        return scrubOutboundSentryEnvelope(envelope);
+                    }
+                    catch {
+                        return null;
+                    }
+                })
+                    .then((scrubbedEnvelope) => {
+                    if (!scrubbedEnvelope) {
+                        return { statusCode: 200 };
+                    }
+                    return base.send(scrubbedEnvelope);
+                })
+                    .catch(() => ({ statusCode: 0 }))
+                    .then((response) => response)
+                    .finally(() => {
+                    inFlight.delete(tracked);
+                });
+                tracked = operation.then(() => undefined);
+                inFlight.add(tracked);
+                return operation;
+            },
+            flush(timeout) {
+                return base.flush(timeout);
+            },
+        };
+    };
+    const client = new NodeClient({
+        dsn: options.dsn,
+        release: options.release,
+        environment: options.environment ??
+            process.env[P_DEV_SENTRY_ENVIRONMENT_ENV]?.trim() ??
+            "packaged",
+        transport: trackingTransportFactory,
+        sendDefaultPii: false,
+        sendClientReports: false,
+        includeServerName: false,
+        stackParser: defaultStackParser,
+        enableLogs: false,
+        integrations: [],
+        registerEsmLoaderHooks: false,
+    });
+    client.init();
+    function drainPending() {
+        drainScheduled = false;
+        while (active && pending.length > 0) {
+            const event = pending.shift();
+            if (event) {
+                try {
+                    const scrubbedEvent = scrubOutboundSentryEvent(event);
+                    if (scrubbedEvent) {
+                        client.sendEvent(scrubbedEvent);
+                    }
+                }
+                catch {
+                    // best-effort telemetry must never interrupt product execution
+                }
+            }
+        }
+        if (!active) {
+            pending.length = 0;
+        }
+    }
+    function scheduleDrain() {
+        if (drainScheduled) {
+            return;
+        }
+        drainScheduled = true;
+        queueMicrotask(drainPending);
+    }
+    return {
+        captureError(input, context) {
+            if (!active) {
+                return;
+            }
+            pending.push(buildApprovedEvent(input, context));
+            scheduleDrain();
+        },
+        addBreadcrumb(_breadcrumb) {
+            if (!active) {
+                return;
+            }
+            // Sentry events are allowlist-only and intentionally omit breadcrumbs.
+        },
+        async flush(deadlineMs) {
+            if (!active) {
+                return;
+            }
+            drainPending();
+            await client.flush(deadlineMs);
+            await waitForInFlight(inFlight, deadlineMs);
+        },
+        async shutdown(options) {
+            if (!active) {
+                return;
+            }
+            if (options?.flush !== false) {
+                await this.flush(options?.deadlineMs ?? 1_000);
+            }
+            active = false;
+            pending.length = 0;
+            await client.close(options?.deadlineMs ?? 1_000);
+        },
+        async disableAndDrop(deadlineMs) {
+            active = false;
+            // Sentry Client.close() drains pending work before disabling. Consent
+            // withdrawal must instead drop adapter-queued events first, then wait
+            // only for sends already initiated through the transport wrapper.
+            pending.length = 0;
+            await waitForInFlight(inFlight, Math.min(deadlineMs, 1_000));
+            client.getOptions().enabled = false;
+            await client.close(0);
+        },
+        isActive() {
+            return active;
+        },
+    };
+}
+//# sourceMappingURL=sentry.js.map

package/dist/observability/adapters/sentry.js.map

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

package/dist/observability/analytics-schemas.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import type { AnalyticsEvent } from "./types.js";
+export declare const GUIDED_DISPLAY_STEP_IDS: readonly ["connect-services", "linear-workspace", "vercel-bridge", "choose-target-repos", "local-readiness", "cloud-secrets", "target-workflow", "ready-for-first-run"];
+export type GuidedDisplayStepId = (typeof GUIDED_DISPLAY_STEP_IDS)[number];
+export declare function guidedDisplayStepNumber(stepId: GuidedDisplayStepId): number;
+declare const clientAnalyticsEventSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"p_dev_configure_step_viewed">;
+    stepId: z.ZodEnum<["connect-services", "linear-workspace", "vercel-bridge", "choose-target-repos", "local-readiness", "cloud-secrets", "target-workflow", "ready-for-first-run"]>;
+    stepNumber: z.ZodNumber;
+    resumed: z.ZodLiteral<false>;
+    revisited: z.ZodLiteral<false>;
+}, "strict", z.ZodTypeAny, {
+    type: "p_dev_configure_step_viewed";
+    resumed: false;
+    stepId: "connect-services" | "linear-workspace" | "vercel-bridge" | "choose-target-repos" | "local-readiness" | "cloud-secrets" | "target-workflow" | "ready-for-first-run";
+    stepNumber: number;
+    revisited: false;
+}, {
+    type: "p_dev_configure_step_viewed";
+    resumed: false;
+    stepId: "connect-services" | "linear-workspace" | "vercel-bridge" | "choose-target-repos" | "local-readiness" | "cloud-secrets" | "target-workflow" | "ready-for-first-run";
+    stepNumber: number;
+    revisited: false;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"p_dev_configure_step_completed">;
+    stepId: z.ZodEnum<["connect-services", "linear-workspace", "vercel-bridge", "choose-target-repos", "local-readiness", "cloud-secrets", "target-workflow", "ready-for-first-run"]>;
+    stepNumber: z.ZodNumber;
+    resumed: z.ZodLiteral<false>;
+    revisited: z.ZodLiteral<false>;
+    durationBucket: z.ZodEnum<["lt_10s", "10s_30s", "30s_2m", "2m_5m", "gt_5m", "lt_1m", "1m_3m", "3m_10m", "gt_10m", "unknown"]>;
+    completionOutcome: z.ZodEnum<["success", "skipped_already_complete", "user_correctable_blocked", "operational_failure", "unknown"]>;
+}, "strict", z.ZodTypeAny, {
+    type: "p_dev_configure_step_completed";
+    resumed: false;
+    stepId: "connect-services" | "linear-workspace" | "vercel-bridge" | "choose-target-repos" | "local-readiness" | "cloud-secrets" | "target-workflow" | "ready-for-first-run";
+    stepNumber: number;
+    revisited: false;
+    durationBucket: "unknown" | "lt_10s" | "10s_30s" | "30s_2m" | "2m_5m" | "gt_5m" | "lt_1m" | "1m_3m" | "3m_10m" | "gt_10m";
+    completionOutcome: "unknown" | "success" | "skipped_already_complete" | "user_correctable_blocked" | "operational_failure";
+}, {
+    type: "p_dev_configure_step_completed";
+    resumed: false;
+    stepId: "connect-services" | "linear-workspace" | "vercel-bridge" | "choose-target-repos" | "local-readiness" | "cloud-secrets" | "target-workflow" | "ready-for-first-run";
+    stepNumber: number;
+    revisited: false;
+    durationBucket: "unknown" | "lt_10s" | "10s_30s" | "30s_2m" | "2m_5m" | "gt_5m" | "lt_1m" | "1m_3m" | "3m_10m" | "gt_10m";
+    completionOutcome: "unknown" | "success" | "skipped_already_complete" | "user_correctable_blocked" | "operational_failure";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"p_dev_setup_completed">;
+}, "strict", z.ZodTypeAny, {
+    type: "p_dev_setup_completed";
+}, {
+    type: "p_dev_setup_completed";
+}>]>;
+export type ClientAnalyticsEvent = z.infer<typeof clientAnalyticsEventSchema>;
+export declare function parseClientAnalyticsEventBody(input: unknown): ClientAnalyticsEvent;
+export declare function toAnalyticsEvent(event: ClientAnalyticsEvent): AnalyticsEvent;
+export {};
+//# sourceMappingURL=analytics-schemas.d.ts.map

package/dist/observability/analytics-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-schemas.d.ts","sourceRoot":"","sources":["../../src/observability/analytics-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,YAAY,CAAC;AAEpF,eAAO,MAAM,uBAAuB,yKAS1B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AA8B3E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAE3E;AA0CD,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,oBAAoB,CAyBtB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,cAAc,CAsB5E"}

package/dist/observability/analytics-schemas.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+export const GUIDED_DISPLAY_STEP_IDS = [
+    "connect-services",
+    "linear-workspace",
+    "vercel-bridge",
+    "choose-target-repos",
+    "local-readiness",
+    "cloud-secrets",
+    "target-workflow",
+    "ready-for-first-run",
+];
+const guidedStepIdSchema = z.enum(GUIDED_DISPLAY_STEP_IDS);
+const durationBucketSchema = z.enum([
+    "lt_10s",
+    "10s_30s",
+    "30s_2m",
+    "2m_5m",
+    "gt_5m",
+    "lt_1m",
+    "1m_3m",
+    "3m_10m",
+    "gt_10m",
+    "unknown",
+]);
+const completionOutcomeSchema = z.enum([
+    "success",
+    "skipped_already_complete",
+    "user_correctable_blocked",
+    "operational_failure",
+    "unknown",
+]);
+const finiteStepNumberSchema = z
+    .number()
+    .int("stepNumber must be an integer")
+    .finite("stepNumber must be finite");
+export function guidedDisplayStepNumber(stepId) {
+    return GUIDED_DISPLAY_STEP_IDS.indexOf(stepId) + 1;
+}
+function assertExpectedStepNumber(stepId, stepNumber) {
+    const expected = guidedDisplayStepNumber(stepId);
+    if (stepNumber !== expected) {
+        throw new Error("Invalid analytics event payload.");
+    }
+}
+const fixedResumeSchema = z.literal(false);
+const stepViewedSchema = z
+    .object({
+    type: z.literal("p_dev_configure_step_viewed"),
+    stepId: guidedStepIdSchema,
+    stepNumber: finiteStepNumberSchema,
+    resumed: fixedResumeSchema,
+    revisited: fixedResumeSchema,
+})
+    .strict();
+const stepCompletedSchema = z
+    .object({
+    type: z.literal("p_dev_configure_step_completed"),
+    stepId: guidedStepIdSchema,
+    stepNumber: finiteStepNumberSchema,
+    resumed: fixedResumeSchema,
+    revisited: fixedResumeSchema,
+    durationBucket: durationBucketSchema,
+    completionOutcome: completionOutcomeSchema,
+})
+    .strict();
+const setupCompletedSchema = z
+    .object({
+    type: z.literal("p_dev_setup_completed"),
+})
+    .strict();
+const clientAnalyticsEventSchema = z.union([
+    stepViewedSchema,
+    stepCompletedSchema,
+    setupCompletedSchema,
+]);
+const MAX_CLIENT_ANALYTICS_BODY_BYTES = 4_096;
+export function parseClientAnalyticsEventBody(input) {
+    if (typeof input === "string" && input.length > MAX_CLIENT_ANALYTICS_BODY_BYTES) {
+        throw new Error("Analytics payload is too large.");
+    }
+    if (input !== null &&
+        typeof input === "object" &&
+        JSON.stringify(input).length > MAX_CLIENT_ANALYTICS_BODY_BYTES) {
+        throw new Error("Analytics payload is too large.");
+    }
+    const parsed = clientAnalyticsEventSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new Error("Invalid analytics event payload.");
+    }
+    if (parsed.data.type === "p_dev_configure_step_viewed" ||
+        parsed.data.type === "p_dev_configure_step_completed") {
+        assertExpectedStepNumber(parsed.data.stepId, parsed.data.stepNumber);
+    }
+    return parsed.data;
+}
+export function toAnalyticsEvent(event) {
+    if (event.type === "p_dev_configure_step_viewed") {
+        return {
+            type: event.type,
+            stepId: event.stepId,
+            stepNumber: event.stepNumber,
+            resumed: event.resumed,
+            revisited: event.revisited,
+        };
+    }
+    if (event.type === "p_dev_configure_step_completed") {
+        return {
+            type: event.type,
+            stepId: event.stepId,
+            stepNumber: event.stepNumber,
+            resumed: event.resumed,
+            revisited: event.revisited,
+            durationBucket: event.durationBucket,
+            completionOutcome: event.completionOutcome,
+        };
+    }
+    return { type: "p_dev_setup_completed" };
+}
+//# sourceMappingURL=analytics-schemas.js.map

package/dist/observability/analytics-schemas.js.map

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

package/dist/observability/consent.d.ts

@@ -0,0 +1,14 @@
+import type { ConsentPreference, EffectiveConsent } from "./types.js";
+export declare function isGlobalObservabilityDisabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function isAnalyticsDisabledByEnvironment(env?: NodeJS.ProcessEnv): boolean;
+export declare function isErrorReportingDisabledByEnvironment(env?: NodeJS.ProcessEnv): boolean;
+export declare function resolveEffectiveConsent(input: {
+    analyticsPreference: ConsentPreference;
+    errorReportingPreference: ConsentPreference;
+    env?: NodeJS.ProcessEnv;
+}): EffectiveConsent;
+export declare function hasUndecidedConsent(input: {
+    analyticsPreference: ConsentPreference;
+    errorReportingPreference: ConsentPreference;
+}): boolean;
+//# sourceMappingURL=consent.d.ts.map

package/dist/observability/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/observability/consent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOtE,wBAAgB,6BAA6B,CAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,qCAAqC,CACnD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,wBAAwB,EAAE,iBAAiB,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,gBAAgB,CAgBnB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,wBAAwB,EAAE,iBAAiB,CAAC;CAC7C,GAAG,OAAO,CAKV"}

package/dist/observability/consent.js

@@ -0,0 +1,35 @@
+import { P_DEV_ANALYTICS_DISABLED_ENV, P_DEV_OBSERVABILITY_DISABLED_ENV, P_DEV_SENTRY_DISABLED_ENV, } from "./constants.js";
+function isTruthyEnv(value) {
+    const normalized = value?.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+export function isGlobalObservabilityDisabled(env = process.env) {
+    return (isTruthyEnv(env.DO_NOT_TRACK) ||
+        isTruthyEnv(env[P_DEV_OBSERVABILITY_DISABLED_ENV]));
+}
+export function isAnalyticsDisabledByEnvironment(env = process.env) {
+    return (isGlobalObservabilityDisabled(env) ||
+        isTruthyEnv(env[P_DEV_ANALYTICS_DISABLED_ENV]));
+}
+export function isErrorReportingDisabledByEnvironment(env = process.env) {
+    return (isGlobalObservabilityDisabled(env) ||
+        isTruthyEnv(env[P_DEV_SENTRY_DISABLED_ENV]));
+}
+export function resolveEffectiveConsent(input) {
+    const env = input.env ?? process.env;
+    const analyticsBlockedByEnvironment = isAnalyticsDisabledByEnvironment(env);
+    const errorReportingBlockedByEnvironment = isErrorReportingDisabledByEnvironment(env);
+    return {
+        analyticsEnabled: !analyticsBlockedByEnvironment &&
+            input.analyticsPreference === "enabled",
+        errorReportingEnabled: !errorReportingBlockedByEnvironment &&
+            input.errorReportingPreference === "enabled",
+        analyticsBlockedByEnvironment,
+        errorReportingBlockedByEnvironment,
+    };
+}
+export function hasUndecidedConsent(input) {
+    return (input.analyticsPreference === null &&
+        input.errorReportingPreference === null);
+}
+//# sourceMappingURL=consent.js.map

package/dist/observability/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/observability/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,SAAS,WAAW,CAAC,KAAyB;IAC5C,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,CACL,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;QAC7B,WAAW,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,CACL,6BAA6B,CAAC,GAAG,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,CACL,6BAA6B,CAAC,GAAG,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAIvC;IACC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,MAAM,6BAA6B,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC;IAC5E,MAAM,kCAAkC,GACtC,qCAAqC,CAAC,GAAG,CAAC,CAAC;IAE7C,OAAO;QACL,gBAAgB,EACd,CAAC,6BAA6B;YAC9B,KAAK,CAAC,mBAAmB,KAAK,SAAS;QACzC,qBAAqB,EACnB,CAAC,kCAAkC;YACnC,KAAK,CAAC,wBAAwB,KAAK,SAAS;QAC9C,6BAA6B;QAC7B,kCAAkC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAGnC;IACC,OAAO,CACL,KAAK,CAAC,mBAAmB,KAAK,IAAI;QAClC,KAAK,CAAC,wBAAwB,KAAK,IAAI,CACxC,CAAC;AACJ,CAAC"}