p-dev-harness 0.3.0 → 0.4.0

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"}

package/dist/observability/constants.d.ts

@@ -0,0 +1,18 @@
+export declare const OBSERVABILITY_SCHEMA_VERSION: 1;
+export declare const OBSERVABILITY_LOCAL_FILE = ".harness/observability.local.json";
+export declare const P_DEV_OBSERVABILITY_SESSION_ID_ENV = "P_DEV_OBSERVABILITY_SESSION_ID";
+export declare const P_DEV_OBSERVABILITY_NONCE_ENV = "P_DEV_OBSERVABILITY_NONCE";
+export declare const P_DEV_OBSERVABILITY_DISABLED_ENV = "P_DEV_OBSERVABILITY_DISABLED";
+export declare const P_DEV_SENTRY_DISABLED_ENV = "P_DEV_SENTRY_DISABLED";
+export declare const P_DEV_ANALYTICS_DISABLED_ENV = "P_DEV_ANALYTICS_DISABLED";
+export declare const P_DEV_SENTRY_DSN_ENV = "P_DEV_SENTRY_DSN";
+export declare const P_DEV_POSTHOG_PROJECT_TOKEN_ENV = "P_DEV_POSTHOG_PROJECT_TOKEN";
+export declare const P_DEV_POSTHOG_HOST_ENV = "P_DEV_POSTHOG_HOST";
+export declare const P_DEV_SENTRY_ENVIRONMENT_ENV = "P_DEV_SENTRY_ENVIRONMENT";
+export declare const P_DEV_RELEASE_SHA_ENV = "P_DEV_RELEASE_SHA";
+export declare const OBSERVABILITY_PUBLIC_CONFIG_FILENAME = "observability.public.json";
+export declare const TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE = "config/observability.public.json";
+export declare const OBSERVABILITY_FLUSH_DEADLINE_MS = 1000;
+export declare const OBSERVABILITY_MAX_QUEUE_SIZE = 32;
+export declare const OBSERVABILITY_REQUEST_MAX_BYTES = 8192;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/observability/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,eAAO,MAAM,kCAAkC,mCACb,CAAC;AACnC,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAEzE,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAEvE,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAChF,eAAO,MAAM,4CAA4C,qCACrB,CAAC;AAErC,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AACrD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,+BAA+B,OAAQ,CAAC"}

package/dist/observability/constants.js

@@ -0,0 +1,18 @@
+export const OBSERVABILITY_SCHEMA_VERSION = 1;
+export const OBSERVABILITY_LOCAL_FILE = ".harness/observability.local.json";
+export const P_DEV_OBSERVABILITY_SESSION_ID_ENV = "P_DEV_OBSERVABILITY_SESSION_ID";
+export const P_DEV_OBSERVABILITY_NONCE_ENV = "P_DEV_OBSERVABILITY_NONCE";
+export const P_DEV_OBSERVABILITY_DISABLED_ENV = "P_DEV_OBSERVABILITY_DISABLED";
+export const P_DEV_SENTRY_DISABLED_ENV = "P_DEV_SENTRY_DISABLED";
+export const P_DEV_ANALYTICS_DISABLED_ENV = "P_DEV_ANALYTICS_DISABLED";
+export const P_DEV_SENTRY_DSN_ENV = "P_DEV_SENTRY_DSN";
+export const P_DEV_POSTHOG_PROJECT_TOKEN_ENV = "P_DEV_POSTHOG_PROJECT_TOKEN";
+export const P_DEV_POSTHOG_HOST_ENV = "P_DEV_POSTHOG_HOST";
+export const P_DEV_SENTRY_ENVIRONMENT_ENV = "P_DEV_SENTRY_ENVIRONMENT";
+export const P_DEV_RELEASE_SHA_ENV = "P_DEV_RELEASE_SHA";
+export const OBSERVABILITY_PUBLIC_CONFIG_FILENAME = "observability.public.json";
+export const TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE = "config/observability.public.json";
+export const OBSERVABILITY_FLUSH_DEADLINE_MS = 1_000;
+export const OBSERVABILITY_MAX_QUEUE_SIZE = 32;
+export const OBSERVABILITY_REQUEST_MAX_BYTES = 8_192;
+//# sourceMappingURL=constants.js.map

package/dist/observability/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/observability/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAE5E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gCAAgC,CAAC;AACnC,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AACjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAChF,MAAM,CAAC,MAAM,4CAA4C,GACvD,kCAAkC,CAAC;AAErC,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC"}

package/dist/observability/context.d.ts

@@ -0,0 +1,21 @@
+import type { CpuArchFamily, ObservabilityContext, OsFamily, WorkspaceKind } from "./types.js";
+export declare function resolveOsFamily(platform?: NodeJS.Platform): OsFamily;
+export declare function resolveCpuArchFamily(arch?: string): CpuArchFamily;
+export declare function resolveNodeMajorVersion(version?: string): number;
+export declare function validateReleaseSha(value: string | undefined): string | null;
+export declare function readReleaseShaFromPackageRoot(packageRoot: string): string;
+export declare function resolveReleaseSha(input: {
+    env?: NodeJS.ProcessEnv;
+    moduleUrl?: string;
+}): string;
+export declare function resolvePackagedReleaseShaFromPackageRoot(packageRoot: string): string;
+export interface BuildObservabilityContextInput {
+    sessionId: string;
+    installationId?: string;
+    firstLaunchForPDevHome: boolean;
+    workspaceKind?: WorkspaceKind;
+    moduleUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function buildObservabilityContext(input: BuildObservabilityContextInput): ObservabilityContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/observability/context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,wBAAgB,eAAe,CAAC,QAAQ,kBAAmB,GAAG,QAAQ,CAWrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAqB,GAAG,aAAa,CAW/E;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAwB,GAC9B,MAAM,CAGR;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM3E;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAazE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAqBT;AAED,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,GAClB,MAAM,CAUR;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,oBAAoB,CA0BtB"}