@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
129 lines (119 loc) • 3.6 kB
text/typescript
import type { OcxTelemetryConfig, OcxTelemetryDecision } from "../types/telemetry";
export type TelemetryStatusReason =
| "env-ocx-telemetry"
| "env-do-not-track"
| "declined"
| "accepted"
| "default-on"
| "awaiting-notice";
export type TelemetryEnvOverride = "OCX_TELEMETRY" | "DO_NOT_TRACK" | null;
export interface TelemetryConsentStatus {
effective: boolean;
reason: TelemetryStatusReason;
decision: OcxTelemetryDecision | null;
decidedAt: string | null;
noticeShownAt: string | null;
envOverride: TelemetryEnvOverride;
}
const OCX_TELEMETRY_OFF_VALUES = new Set(["0", "false", "off", "no"]);
const DO_NOT_TRACK_ON_VALUES = new Set(["1", "true", "yes"]);
/**
* Consent lives only in the config's `telemetry` block. A whole config is never read as a block, so
* a top-level key such as `noticeShownAt` (which `ocx config set` can write) is not consent.
*/
function extractTelemetryConfig(
input: { telemetry?: OcxTelemetryConfig | null } | null | undefined,
): OcxTelemetryConfig | undefined {
if (!input || typeof input !== "object") return undefined;
const nested = (input as { telemetry?: unknown }).telemetry;
return nested && typeof nested === "object" && !Array.isArray(nested)
? (nested as OcxTelemetryConfig)
: undefined;
}
function validIsoString(value: unknown): string | null {
if (typeof value !== "string") return null;
const trimmed = value.trim();
if (!trimmed || Number.isNaN(Date.parse(trimmed))) return null;
return trimmed;
}
export function isTelemetryEnvOptOut(env: Record<string, string | undefined> = process.env): TelemetryEnvOverride {
const ocx = env.OCX_TELEMETRY?.trim().toLowerCase();
if (ocx !== undefined && OCX_TELEMETRY_OFF_VALUES.has(ocx)) {
return "OCX_TELEMETRY";
}
const dnt = env.DO_NOT_TRACK?.trim().toLowerCase();
if (dnt !== undefined && DO_NOT_TRACK_ON_VALUES.has(dnt)) {
return "DO_NOT_TRACK";
}
return null;
}
export function resolveTelemetryStatus(
config: { telemetry?: OcxTelemetryConfig | null } | null | undefined,
env: Record<string, string | undefined> = process.env,
): TelemetryConsentStatus {
const telemetry = extractTelemetryConfig(config);
const decision = telemetry?.decision === "accepted" || telemetry?.decision === "declined"
? telemetry.decision
: null;
const decidedAt = validIsoString(telemetry?.decidedAt);
const noticeShownAt = validIsoString(telemetry?.noticeShownAt);
const envOverride = isTelemetryEnvOptOut(env);
if (envOverride === "OCX_TELEMETRY") {
return {
effective: false,
reason: "env-ocx-telemetry",
decision,
decidedAt,
noticeShownAt,
envOverride,
};
}
if (envOverride === "DO_NOT_TRACK") {
return {
effective: false,
reason: "env-do-not-track",
decision,
decidedAt,
noticeShownAt,
envOverride,
};
}
if (decision === "declined") {
return {
effective: false,
reason: "declined",
decision,
decidedAt,
noticeShownAt,
envOverride: null,
};
}
if (decision === "accepted") {
return {
effective: true,
reason: "accepted",
decision,
decidedAt,
noticeShownAt,
envOverride: null,
};
}
if (noticeShownAt !== null) {
return {
effective: true,
reason: "default-on",
decision: null,
decidedAt,
noticeShownAt,
envOverride: null,
};
}
return {
effective: false,
reason: "awaiting-notice",
decision: null,
decidedAt,
noticeShownAt: null,
envOverride: null,
};
}