@genn-inc/cluebase-frontend-sdk 0.0.1

package/dist/_generated/otel-resource-keys.d.ts

@@ -0,0 +1,21 @@
+export declare const CLUEBASE_OTEL_REQUIRED_RESOURCE_KEYS: readonly ["service.name", "cluebase.project_key", "cluebase.runtime_language", "cluebase.service_type"];
+export declare const CLUEBASE_OTEL_SDK_SOURCE_REQUIRED_RESOURCE_KEYS: readonly ["service.name", "cluebase.project_key", "cluebase.runtime_language", "cluebase.service_type", "cluebase.producer_id"];
+export declare const CLUEBASE_OTEL_SDK_SOURCE_RESOURCE_KEYS: readonly ["service.name", "cluebase.project_key", "cluebase.runtime_language", "cluebase.service_type", "cluebase.producer_id", "service.version", "cluebase.sdk.type", "cluebase.sdk.version", "cluebase.sdk.collection_mode"];
+export declare const CLUEBASE_OTEL_ALLOWED_RESOURCE_KEYS: readonly ["service.name", "cluebase.project_key", "cluebase.runtime_language", "cluebase.service_type", "cluebase.producer_id", "service.version", "cluebase.sdk.type", "cluebase.sdk.version", "cluebase.sdk.collection_mode", "deployment.environment", "service.namespace", "cloud.region", "k8s.namespace.name", "k8s.pod.name", "container.id"];
+export declare const CLUEBASE_OTEL_RECOMMENDED_RESOURCE_KEYS: readonly ["deployment.environment", "service.version", "service.namespace", "cluebase.producer_id", "cloud.region", "k8s.namespace.name", "k8s.pod.name", "container.id"];
+export declare const CLUEBASE_OTEL_RESOURCE_KEYS: {
+    readonly serviceName: "service.name";
+    readonly deploymentEnvironment: "deployment.environment";
+    readonly projectKey: "cluebase.project_key";
+    readonly producerId: "cluebase.producer_id";
+    readonly runtimeLanguage: "cluebase.runtime_language";
+    readonly serviceType: "cluebase.service_type";
+    readonly serviceVersion: "service.version";
+    readonly serviceNamespace: "service.namespace";
+    readonly cloudRegion: "cloud.region";
+    readonly k8sNamespaceName: "k8s.namespace.name";
+    readonly k8sPodName: "k8s.pod.name";
+    readonly containerId: "container.id";
+};
+export type CluebaseOtelRequiredResourceKey = (typeof CLUEBASE_OTEL_REQUIRED_RESOURCE_KEYS)[number];
+export type CluebaseOtelRecommendedResourceKey = (typeof CLUEBASE_OTEL_RECOMMENDED_RESOURCE_KEYS)[number];

package/dist/_generated/otel-resource-keys.js

@@ -0,0 +1,72 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-backend-contract/src/delivery/otel-resource-keys.v1.json
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+export const CLUEBASE_OTEL_REQUIRED_RESOURCE_KEYS = [
+    "service.name",
+    "cluebase.project_key",
+    "cluebase.runtime_language",
+    "cluebase.service_type",
+];
+export const CLUEBASE_OTEL_SDK_SOURCE_REQUIRED_RESOURCE_KEYS = [
+    "service.name",
+    "cluebase.project_key",
+    "cluebase.runtime_language",
+    "cluebase.service_type",
+    "cluebase.producer_id",
+];
+export const CLUEBASE_OTEL_SDK_SOURCE_RESOURCE_KEYS = [
+    "service.name",
+    "cluebase.project_key",
+    "cluebase.runtime_language",
+    "cluebase.service_type",
+    "cluebase.producer_id",
+    "service.version",
+    "cluebase.sdk.type",
+    "cluebase.sdk.version",
+    "cluebase.sdk.collection_mode",
+];
+export const CLUEBASE_OTEL_ALLOWED_RESOURCE_KEYS = [
+    "service.name",
+    "cluebase.project_key",
+    "cluebase.runtime_language",
+    "cluebase.service_type",
+    "cluebase.producer_id",
+    "service.version",
+    "cluebase.sdk.type",
+    "cluebase.sdk.version",
+    "cluebase.sdk.collection_mode",
+    "deployment.environment",
+    "service.namespace",
+    "cloud.region",
+    "k8s.namespace.name",
+    "k8s.pod.name",
+    "container.id",
+];
+export const CLUEBASE_OTEL_RECOMMENDED_RESOURCE_KEYS = [
+    "deployment.environment",
+    "service.version",
+    "service.namespace",
+    "cluebase.producer_id",
+    "cloud.region",
+    "k8s.namespace.name",
+    "k8s.pod.name",
+    "container.id",
+];
+export const CLUEBASE_OTEL_RESOURCE_KEYS = {
+    serviceName: "service.name",
+    deploymentEnvironment: "deployment.environment",
+    projectKey: "cluebase.project_key",
+    producerId: "cluebase.producer_id",
+    runtimeLanguage: "cluebase.runtime_language",
+    serviceType: "cluebase.service_type",
+    serviceVersion: "service.version",
+    serviceNamespace: "service.namespace",
+    cloudRegion: "cloud.region",
+    k8sNamespaceName: "k8s.namespace.name",
+    k8sPodName: "k8s.pod.name",
+    containerId: "container.id",
+};

package/dist/_generated/otel-span-conversion.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 計測の区間 (span) を送信の形へ移す時の、時刻と属性の読み方の**正本**。
+ *
+ * ここは配る部品 2 つ（サーバー側・画面側）へ**書き出される元**です。
+ * `scripts/generate-shared-contract-tables.mjs` が、この中身をそのまま
+ * 各部品の `src/_generated/otel-span-conversion.ts` へ出します。
+ * 出した先を手で直しても、`--check` が落とします。
+ *
+ * なぜ写しではなく生成なのか。配る部品は顧客の手元で `tsc` だけで組み立てられ、
+ * まとめ込み (bundle) をしません。社内の共有部品は `private` なので、
+ * 「配る部品から共有部品を取り込む」形は取れません（顧客の手元で解決できない
+ * 取り込みになります）。**これが写しが存在していた理由です。**
+ *
+ * 中身の型を計測の枠組みから取らず、必要な形だけを書いています。そうしないと、
+ * 出した先の 2 つで属性の型の名前が違う（`SdkSignalAttributes` と
+ * `CanonicalJsonObject`）ため、同じ 1 つの文章にできません。
+ */
+/** 計測の枠組みが渡す時刻。[秒, ナノ秒] の 2 つ組。 */
+type SpanHrTime = readonly [number, number] | undefined;
+/** 属性の入れ物。中身の型は読む側が決めるので、ここでは問いません。 */
+type SpanAttributes = {
+    readonly [key: string]: unknown;
+};
+/** 親の区間を持つかもしれない区間。 */
+type SpanWithParent = {
+    readonly parentSpanContext?: {
+        readonly spanId?: string;
+    };
+};
+/**
+ * 時刻をナノ秒の文字列にする。
+ *
+ * 時刻が無い・数でない場合は「いま」で埋める。**送る形が壊れるより、
+ * 近い時刻で送るほうがよい**（受け取る側は時刻の欠けを直せない）。
+ */
+export declare function hrTimeToUnixNano(time: SpanHrTime): string;
+/** ナノ秒の文字列を、読める時刻の文字列にする。 */
+export declare function nanosToIso(nanos: string): string;
+/** 属性から「中身のある文字列」を取り出す。空白だけなら無いものとして扱う。 */
+export declare function attrString(attributes: SpanAttributes, key: string): string | null;
+/**
+ * 親の区間の識別子。
+ *
+ * 属性に明示されていればそれを採る。計測の枠組みが持つ親より属性を優先するのは、
+ * 画面と受付をまたぐ繋がりを、こちらで組み直して入れているため。
+ */
+export declare function parentSpanId(span: SpanWithParent, attributes: SpanAttributes): string | null;
+export {};

package/dist/_generated/otel-span-conversion.js

@@ -0,0 +1,69 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-backend-contract/src/delivery/otel-span-conversion.source.ts
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+/**
+ * 計測の区間 (span) を送信の形へ移す時の、時刻と属性の読み方の**正本**。
+ *
+ * ここは配る部品 2 つ（サーバー側・画面側）へ**書き出される元**です。
+ * `scripts/generate-shared-contract-tables.mjs` が、この中身をそのまま
+ * 各部品の `src/_generated/otel-span-conversion.ts` へ出します。
+ * 出した先を手で直しても、`--check` が落とします。
+ *
+ * なぜ写しではなく生成なのか。配る部品は顧客の手元で `tsc` だけで組み立てられ、
+ * まとめ込み (bundle) をしません。社内の共有部品は `private` なので、
+ * 「配る部品から共有部品を取り込む」形は取れません（顧客の手元で解決できない
+ * 取り込みになります）。**これが写しが存在していた理由です。**
+ *
+ * 中身の型を計測の枠組みから取らず、必要な形だけを書いています。そうしないと、
+ * 出した先の 2 つで属性の型の名前が違う（`SdkSignalAttributes` と
+ * `CanonicalJsonObject`）ため、同じ 1 つの文章にできません。
+ */
+/**
+ * 時刻をナノ秒の文字列にする。
+ *
+ * 時刻が無い・数でない場合は「いま」で埋める。**送る形が壊れるより、
+ * 近い時刻で送るほうがよい**（受け取る側は時刻の欠けを直せない）。
+ */
+export function hrTimeToUnixNano(time) {
+    if (!time)
+        return `${Date.now()}000000`;
+    const [seconds, nanos] = time;
+    if (typeof seconds !== "number" || typeof nanos !== "number") {
+        return `${Date.now()}000000`;
+    }
+    return (BigInt(seconds) * 1000000000n + BigInt(nanos)).toString();
+}
+/** ナノ秒の文字列を、読める時刻の文字列にする。 */
+export function nanosToIso(nanos) {
+    try {
+        const ms = Number(BigInt(nanos) / 1000000n);
+        if (Number.isFinite(ms) && ms > 0)
+            return new Date(ms).toISOString();
+    }
+    catch {
+        // 試験の身代わりが壊れた時刻を渡すことがある。送る形は保つ。
+    }
+    return new Date().toISOString();
+}
+/** 属性から「中身のある文字列」を取り出す。空白だけなら無いものとして扱う。 */
+export function attrString(attributes, key) {
+    const value = attributes[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value.trim()
+        : null;
+}
+/**
+ * 親の区間の識別子。
+ *
+ * 属性に明示されていればそれを採る。計測の枠組みが持つ親より属性を優先するのは、
+ * 画面と受付をまたぐ繋がりを、こちらで組み直して入れているため。
+ */
+export function parentSpanId(span, attributes) {
+    return (attrString(attributes, "cluebase.parent_span_id") ??
+        span.parentSpanContext?.spanId ??
+        null);
+}

package/dist/_generated/parameter-snapshot-leaf.d.ts

@@ -0,0 +1,11 @@
+/**
+ * その節は、値そのもの（葉）か。**降りる枝ではないか。**
+ *
+ * 誤ると、値のつもりだったものの中へ降り、その鍵を項目名として扱います。
+ * 降りる側の 1 つは伏せる判定なので、**間違いは伏せ漏れになります。**
+ *
+ * 型を受けずに `unknown` で受けるのは、この file が正本の型を取り込まないためです
+ * （取り込むと正本 → 生成物 → 正本の輪になります）。**型を付けるのは呼ぶ側**で、
+ * 受付側も配る部品も薄い包みを 1 つ書きます。
+ */
+export declare const hasParameterSnapshotLeafShape: (value: unknown) => boolean;

package/dist/_generated/parameter-snapshot-leaf.js

@@ -0,0 +1,37 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-schema/src/semantic/observation-classification.schema.ts
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+/**
+ * その節は、値そのもの（葉）か。**降りる枝ではないか。**
+ *
+ * 誤ると、値のつもりだったものの中へ降り、その鍵を項目名として扱います。
+ * 降りる側の 1 つは伏せる判定なので、**間違いは伏せ漏れになります。**
+ *
+ * 型を受けずに `unknown` で受けるのは、この file が正本の型を取り込まないためです
+ * （取り込むと正本 → 生成物 → 正本の輪になります）。**型を付けるのは呼ぶ側**で、
+ * 受付側も配る部品も薄い包みを 1 つ書きます。
+ */
+export const hasParameterSnapshotLeafShape = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const node = value;
+    // 自分が持つ鍵だけを見ます（受け継いだ鍵は葉の名乗りではありません）。
+    // **`Object.hasOwn` は使いません。** 配る部品は ES2020 を的にしており、
+    // 顧客の古い閲覧環境で落ちます。これは同じ意味で、どこでも動く書き方です
+    const owns = (key) => Object.prototype.hasOwnProperty.call(node, key);
+    if (!owns("type"))
+        return false;
+    if (!owns("value"))
+        return false;
+    if (!owns("capture_mode"))
+        return false;
+    if (typeof node["type"] !== "string")
+        return false;
+    if (typeof node["capture_mode"] !== "string")
+        return false;
+    return true;
+};

package/dist/_generated/sdk-runtime-policy.d.ts

@@ -0,0 +1,7 @@
+/** 送信をやり直す時の待ち方。数の持ち主は契約の正本 1 つだけです。 */
+export declare const SDK_RETRY_POLICY: {
+    readonly maxAttempts: 3;
+    readonly baseDelayMs: 300;
+    readonly maxDelayMs: 5000;
+    readonly maxAdditiveJitterMs: 200;
+};

package/dist/_generated/sdk-runtime-policy.js

@@ -0,0 +1,14 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-backend-contract/src/delivery/sdk-runtime-policy.v1.json
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+/** 送信をやり直す時の待ち方。数の持ち主は契約の正本 1 つだけです。 */
+export const SDK_RETRY_POLICY = {
+    maxAttempts: 3,
+    baseDelayMs: 300,
+    maxDelayMs: 5000,
+    maxAdditiveJitterMs: 200,
+};

package/dist/_generated/usage-governor-tables.d.ts

@@ -0,0 +1,15 @@
+/** 費用の上限に達したときに止める対象。 */
+export declare const COST_CAPABILITIES: readonly ["event_collection", "replay_storage", "ai_generation", "raw_observation_storage", "retention_growth"];
+export type CostCapability = (typeof COST_CAPABILITIES)[number];
+/** 上限の種類。 */
+export declare const LIMIT_KINDS: readonly ["monthly_overage_amount_limit", "internal_cost_limit", "internal_limit", "operator_global_monthly_cost_limit"];
+export type LimitKind = (typeof LIMIT_KINDS)[number];
+/** 上限へ近づいたことを知らせる段階。 */
+export declare const THRESHOLD_STAGES: readonly ["info", "warning", "urgent", "reached"];
+export type ThresholdStage = (typeof THRESHOLD_STAGES)[number];
+/** 顧客へ見せる請求の計器。 */
+export declare const CUSTOMER_BILLING_METER_KEYS: readonly ["monthly_base_fee", "cluebase_events", "replay_storage", "ai_credits", "data_retention"];
+export type CustomerBillingMeterKey = (typeof CUSTOMER_BILLING_METER_KEYS)[number];
+/** 使った分だけ請求される計器（上の一覧から、定額のものを引いたもの）。 */
+export declare const BILLABLE_USAGE_METER_KEYS: readonly ["cluebase_events", "replay_storage", "ai_credits", "data_retention"];
+export type BillableUsageMeterKey = (typeof BILLABLE_USAGE_METER_KEYS)[number];

package/dist/_generated/usage-governor-tables.js

@@ -0,0 +1,44 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-shared/src/ingest/usage-governor-policy.v1.json
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+/** 費用の上限に達したときに止める対象。 */
+export const COST_CAPABILITIES = [
+    "event_collection",
+    "replay_storage",
+    "ai_generation",
+    "raw_observation_storage",
+    "retention_growth",
+];
+/** 上限の種類。 */
+export const LIMIT_KINDS = [
+    "monthly_overage_amount_limit",
+    "internal_cost_limit",
+    "internal_limit",
+    "operator_global_monthly_cost_limit",
+];
+/** 上限へ近づいたことを知らせる段階。 */
+export const THRESHOLD_STAGES = [
+    "info",
+    "warning",
+    "urgent",
+    "reached",
+];
+/** 顧客へ見せる請求の計器。 */
+export const CUSTOMER_BILLING_METER_KEYS = [
+    "monthly_base_fee",
+    "cluebase_events",
+    "replay_storage",
+    "ai_credits",
+    "data_retention",
+];
+/** 使った分だけ請求される計器（上の一覧から、定額のものを引いたもの）。 */
+export const BILLABLE_USAGE_METER_KEYS = [
+    "cluebase_events",
+    "replay_storage",
+    "ai_credits",
+    "data_retention",
+];

package/dist/context/browser-storage.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 画面側の保管先を 1 か所で決める。
+ *
+ * 4 つの入れ物（利用者・組織・滞在・タブ）が同じ「使えるか試して、駄目なら
+ * メモリへ落とす」規則をそれぞれ持っていた。規則が 4 通りに分かれると、
+ * 5 つ目の入れ物を足す人がどれを写すか選べない（CLAUDE.md §3）。
+ */
+export type StorageLike = Pick<Storage, "getItem" | "setItem" | "removeItem">;
+/** 保管先が使えないときの落とし先。ページを離れると消える。 */
+export declare const createMemoryStorage: () => StorageLike;
+/**
+ * 実際に 1 度書いて消してみてから返す。存在の確認だけでは足りない
+ * （private browsing や容量上限では、存在しても `setItem` が投げる）。
+ */
+export declare const resolveWebStorage: (kind: "local" | "session", probeKey: string) => StorageLike;

package/dist/context/browser-storage.js

@@ -0,0 +1,38 @@
+/**
+ * 画面側の保管先を 1 か所で決める。
+ *
+ * 4 つの入れ物（利用者・組織・滞在・タブ）が同じ「使えるか試して、駄目なら
+ * メモリへ落とす」規則をそれぞれ持っていた。規則が 4 通りに分かれると、
+ * 5 つ目の入れ物を足す人がどれを写すか選べない（CLAUDE.md §3）。
+ */
+/** 保管先が使えないときの落とし先。ページを離れると消える。 */
+export const createMemoryStorage = () => {
+    const store = new Map();
+    return {
+        getItem: (key) => store.get(key) ?? null,
+        setItem: (key, value) => {
+            store.set(key, value);
+        },
+        removeItem: (key) => {
+            store.delete(key);
+        },
+    };
+};
+/**
+ * 実際に 1 度書いて消してみてから返す。存在の確認だけでは足りない
+ * （private browsing や容量上限では、存在しても `setItem` が投げる）。
+ */
+export const resolveWebStorage = (kind, probeKey) => {
+    try {
+        const storage = kind === "local" ? globalThis.localStorage : globalThis.sessionStorage;
+        if (typeof storage !== "undefined") {
+            storage.setItem(probeKey, "1");
+            storage.removeItem(probeKey);
+            return storage;
+        }
+    }
+    catch {
+        // Ignore and fallback.
+    }
+    return createMemoryStorage();
+};

package/dist/context/environment.d.ts

@@ -0,0 +1,37 @@
+import type { CanonicalJsonValue } from "../provider/types.js";
+type EnvironmentOptions = {
+    frontendRelease: string | null;
+    contextTraitsProvider?: () => Record<string, CanonicalJsonValue>;
+};
+export type EnvironmentContextValue = {
+    frontendRelease: string | null;
+    contextTraits: Record<string, CanonicalJsonValue>;
+    locale: string | null;
+    country: string | null;
+    deviceType: string | null;
+    browser: string | null;
+    os: string | null;
+    referrer: string | null;
+    browserFamily: string | null;
+    browserMajorVersion: string | null;
+    browserEngine: string | null;
+    osFamily: string | null;
+    osMajorVersion: string | null;
+    timezone: string | null;
+    pointerTypeCandidate: string | null;
+    touchCapable: boolean | null;
+    cookiesEnabled: boolean | null;
+    localStorageAvailable: boolean | null;
+    sessionStorageAvailable: boolean | null;
+    serviceWorkerSupported: boolean | null;
+    webglSupported: boolean | null;
+    reducedMotion: string | null;
+    colorScheme: string | null;
+};
+export declare class EnvironmentManager {
+    private readonly options;
+    constructor(options: EnvironmentOptions);
+    getContext(): EnvironmentContextValue;
+    private safeContextTraits;
+}
+export {};

package/dist/context/environment.js

@@ -0,0 +1,229 @@
+import { toPathTemplate } from "../exporter/path-template.js";
+import { detectIdentityPII } from "../exporter/sanitize.js";
+import { stripQueryAndHashFromUrl } from "../provider/sdk-input-normalization.js";
+const firstMatch = (userAgent, pattern) => {
+    const match = pattern.exec(userAgent);
+    return match?.[1] ?? null;
+};
+const detectBrowserInfo = (userAgent) => {
+    if (/Edg\//.test(userAgent)) {
+        return {
+            family: "edge",
+            majorVersion: firstMatch(userAgent, /Edg\/(\d+)/),
+            engine: "blink",
+        };
+    }
+    if (/Chrome\//.test(userAgent)) {
+        return {
+            family: "chrome",
+            majorVersion: firstMatch(userAgent, /Chrome\/(\d+)/),
+            engine: "blink",
+        };
+    }
+    if (/Safari\//.test(userAgent) && /Version\//.test(userAgent)) {
+        return {
+            family: "safari",
+            majorVersion: firstMatch(userAgent, /Version\/(\d+)/),
+            engine: "webkit",
+        };
+    }
+    if (/Firefox\//.test(userAgent)) {
+        return {
+            family: "firefox",
+            majorVersion: firstMatch(userAgent, /Firefox\/(\d+)/),
+            engine: "gecko",
+        };
+    }
+    return {
+        family: null,
+        majorVersion: null,
+        engine: null,
+    };
+};
+const detectOsInfo = (userAgent) => {
+    if (/Windows/.test(userAgent)) {
+        return {
+            family: "windows",
+            majorVersion: firstMatch(userAgent, /Windows NT (\d+)/),
+        };
+    }
+    if (/Mac OS X/.test(userAgent)) {
+        return {
+            family: "macos",
+            majorVersion: firstMatch(userAgent, /Mac OS X (\d+)[_.]/),
+        };
+    }
+    if (/Android/.test(userAgent)) {
+        return {
+            family: "android",
+            majorVersion: firstMatch(userAgent, /Android (\d+)/),
+        };
+    }
+    if (/(iPhone|iPad|iPod)/.test(userAgent)) {
+        return {
+            family: "ios",
+            majorVersion: firstMatch(userAgent, /OS (\d+)[_.]/),
+        };
+    }
+    if (/Linux/.test(userAgent)) {
+        return {
+            family: "linux",
+            majorVersion: null,
+        };
+    }
+    return {
+        family: null,
+        majorVersion: null,
+    };
+};
+const detectDeviceType = (userAgent) => {
+    if (/Tablet|iPad/.test(userAgent)) {
+        return "tablet";
+    }
+    if (/Mobile|Android|iPhone|iPod/.test(userAgent)) {
+        return "mobile";
+    }
+    return "desktop";
+};
+const detectTimezone = () => {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone || null;
+    }
+    catch {
+        return null;
+    }
+};
+const storageAvailable = (storageName) => {
+    try {
+        const storage = globalThis[storageName];
+        if (!storage) {
+            return false;
+        }
+        const key = "__cluebase_storage_probe__";
+        storage.setItem(key, "1");
+        storage.removeItem(key);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const detectPointerType = () => {
+    if (typeof globalThis.matchMedia !== "function") {
+        return null;
+    }
+    if (globalThis.matchMedia("(pointer: coarse)").matches) {
+        return "coarse";
+    }
+    if (globalThis.matchMedia("(pointer: fine)").matches) {
+        return "fine";
+    }
+    return "unknown";
+};
+const detectMediaPreference = (query, matchesValue, fallbackValue) => {
+    if (typeof globalThis.matchMedia !== "function") {
+        return null;
+    }
+    return globalThis.matchMedia(query).matches ? matchesValue : fallbackValue;
+};
+const sanitizeReferrer = (value) => {
+    const stripped = stripQueryAndHashFromUrl(value);
+    if (stripped === null)
+        return null;
+    try {
+        const url = new URL(stripped);
+        const maskedPath = url.pathname
+            .split("/")
+            .map((segment) => {
+            try {
+                return detectIdentityPII(decodeURIComponent(segment)) === null
+                    ? segment
+                    : ":id";
+            }
+            catch {
+                return ":id";
+            }
+        })
+            .join("/");
+        return `${url.origin}${toPathTemplate(maskedPath)}`;
+    }
+    catch {
+        return toPathTemplate(stripped);
+    }
+};
+const detectWebglSupport = () => {
+    try {
+        if (typeof globalThis.document === "undefined") {
+            return null;
+        }
+        if (!("WebGLRenderingContext" in globalThis) &&
+            !("WebGL2RenderingContext" in globalThis)) {
+            return false;
+        }
+        const canvas = globalThis.document.createElement("canvas");
+        return Boolean(canvas.getContext("webgl"));
+    }
+    catch {
+        return false;
+    }
+};
+export class EnvironmentManager {
+    constructor(options) {
+        this.options = options;
+    }
+    getContext() {
+        const userAgent = typeof globalThis.navigator !== "undefined"
+            ? globalThis.navigator.userAgent
+            : "";
+        const locale = typeof globalThis.navigator !== "undefined"
+            ? globalThis.navigator.language || null
+            : null;
+        const referrer = sanitizeReferrer(typeof globalThis.document !== "undefined"
+            ? globalThis.document.referrer || null
+            : null);
+        const browserInfo = detectBrowserInfo(userAgent);
+        const osInfo = detectOsInfo(userAgent);
+        return {
+            frontendRelease: this.options.frontendRelease,
+            contextTraits: this.safeContextTraits(),
+            locale,
+            country: null,
+            deviceType: detectDeviceType(userAgent),
+            browser: browserInfo.family,
+            os: osInfo.family,
+            referrer,
+            browserFamily: browserInfo.family,
+            browserMajorVersion: browserInfo.majorVersion,
+            browserEngine: browserInfo.engine,
+            osFamily: osInfo.family,
+            osMajorVersion: osInfo.majorVersion,
+            timezone: detectTimezone(),
+            pointerTypeCandidate: detectPointerType(),
+            touchCapable: typeof globalThis.navigator !== "undefined"
+                ? globalThis.navigator.maxTouchPoints > 0
+                : null,
+            cookiesEnabled: typeof globalThis.navigator !== "undefined"
+                ? globalThis.navigator.cookieEnabled
+                : null,
+            localStorageAvailable: storageAvailable("localStorage"),
+            sessionStorageAvailable: storageAvailable("sessionStorage"),
+            serviceWorkerSupported: typeof globalThis.navigator !== "undefined"
+                ? "serviceWorker" in globalThis.navigator
+                : null,
+            webglSupported: detectWebglSupport(),
+            reducedMotion: detectMediaPreference("(prefers-reduced-motion: reduce)", "reduce", "no-preference"),
+            colorScheme: detectMediaPreference("(prefers-color-scheme: dark)", "dark", "light"),
+        };
+    }
+    safeContextTraits() {
+        try {
+            const traits = this.options.contextTraitsProvider?.() ?? {};
+            return typeof traits === "object" && traits !== null && !Array.isArray(traits)
+                ? traits
+                : {};
+        }
+        catch {
+            return {};
+        }
+    }
+}