@genn-inc/cluebase-frontend-sdk 0.0.6 → 0.0.8

package/dist/_generated/correlation-attribute-keys.d.ts

@@ -1,2 +1,5 @@
 /** 伏せる処理を通しても残す、相関のための属性名。 */
 export declare const CLUEBASE_CORRELATION_ATTRIBUTE_KEYS: ReadonlySet<string>;
+export declare const CLUEBASE_KEYS_NO_CUSTOMER_VALUE_REACHES: ReadonlySet<string>;
+export declare const CLUEBASE_KEYS_HASHED_WHEN_PERSONAL_INFORMATION_SHAPED: ReadonlySet<string>;
+export declare const CLUEBASE_VALUE_FORMATS_THAT_KEEP_THE_EXEMPTION_TRUE: Readonly<Record<string, readonly string[]>>;

package/dist/_generated/correlation-attribute-keys.js

@@ -35,3 +35,37 @@ export const CLUEBASE_CORRELATION_ATTRIBUTE_KEYS = new Set([
     "mcp.client.version",
     "mcp.session.id",
 ]);
+export const CLUEBASE_KEYS_NO_CUSTOMER_VALUE_REACHES = new Set([
+    "cluebase.span_id",
+    "gen_ai.agent.parent_step_id",
+    "gen_ai.agent.run_id",
+]);
+export const CLUEBASE_KEYS_HASHED_WHEN_PERSONAL_INFORMATION_SHAPED = new Set([
+    "cluebase.actor.anonymous_id",
+    "cluebase.actor.user_id",
+    "cluebase.action.id",
+    "cluebase.action_id",
+    "cluebase.interaction.id",
+    "cluebase.interaction_id",
+    "cluebase.organization.id",
+    "cluebase.organization_id",
+    "cluebase.origin_frontend_interaction.id",
+    "cluebase.request.id",
+    "cluebase.request_id",
+    "cluebase.session.id",
+    "cluebase.session_id",
+    "cluebase.subject.organization_id",
+    "cluebase.tab.id",
+    "cluebase.tab_id",
+    "http.request.header.x-cluebase-action-id",
+    "http.request.header.x_cluebase_action_id",
+    "enduser.id",
+    "mcp.session.id",
+]);
+export const CLUEBASE_VALUE_FORMATS_THAT_KEEP_THE_EXEMPTION_TRUE = {
+    "gen_ai.agent.run_id": [
+        "^[0-9a-f]{32}$",
+        "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
+        "^run_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+    ]
+};

package/dist/_generated/diagnostic-codes.d.ts

@@ -0,0 +1,4 @@
+export type DiagnosticCode = "batch_split" | "consent_persistence_failed" | "consent_purge" | "consent_purge_failed" | "consent_state_unavailable" | "delivered_directive_unreadable" | "duplicate_drop_details_unavailable" | "durable_outbox_unavailable" | "event_build_failed" | "event_lost" | "event_oversize" | "intentional_drop" | "invalid_response" | "legacy_bridge_capacity_reached" | "legacy_pre_revocation_event_blocked" | "legacy_writer_detected" | "non_canonical_success_status" | "outbox_key_collision" | "outbox_record_corrupt" | "protocol_redirect" | "queue_overflow" | "retry_exhausted" | "retry_scheduled" | "shutdown_failure" | "terminal_rejection" | "unknown_status";
+export declare const DIAGNOSTIC_CODES: readonly DiagnosticCode[];
+export type HostReportableDiagnosticCode = "consent_persistence_failed" | "consent_purge_failed" | "consent_state_unavailable" | "durable_outbox_unavailable" | "event_build_failed" | "legacy_bridge_capacity_reached" | "legacy_pre_revocation_event_blocked" | "legacy_writer_detected" | "outbox_key_collision" | "outbox_record_corrupt" | "shutdown_failure";
+export declare const HOST_REPORTABLE_DIAGNOSTIC_CODES: readonly HostReportableDiagnosticCode[];

package/dist/_generated/diagnostic-codes.js

@@ -0,0 +1,48 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-backend-contract/src/delivery/sdk-diagnostic-codes.v1.json
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+export const DIAGNOSTIC_CODES = [
+    "batch_split",
+    "consent_persistence_failed",
+    "consent_purge",
+    "consent_purge_failed",
+    "consent_state_unavailable",
+    "delivered_directive_unreadable",
+    "duplicate_drop_details_unavailable",
+    "durable_outbox_unavailable",
+    "event_build_failed",
+    "event_lost",
+    "event_oversize",
+    "intentional_drop",
+    "invalid_response",
+    "legacy_bridge_capacity_reached",
+    "legacy_pre_revocation_event_blocked",
+    "legacy_writer_detected",
+    "non_canonical_success_status",
+    "outbox_key_collision",
+    "outbox_record_corrupt",
+    "protocol_redirect",
+    "queue_overflow",
+    "retry_exhausted",
+    "retry_scheduled",
+    "shutdown_failure",
+    "terminal_rejection",
+    "unknown_status",
+];
+export const HOST_REPORTABLE_DIAGNOSTIC_CODES = [
+    "consent_persistence_failed",
+    "consent_purge_failed",
+    "consent_state_unavailable",
+    "durable_outbox_unavailable",
+    "event_build_failed",
+    "legacy_bridge_capacity_reached",
+    "legacy_pre_revocation_event_blocked",
+    "legacy_writer_detected",
+    "outbox_key_collision",
+    "outbox_record_corrupt",
+    "shutdown_failure",
+];

package/dist/_generated/drop-reasons.d.ts

@@ -0,0 +1,2 @@
+export declare const DROP_REASONS: readonly ["event_schema_invalid", "event_too_large", "fact_admission_filtered", "ingest_control", "privacy_blocked", "privacy_gate_rejected_field", "privacy_policy_rejected", "source_signal_transform_failed", "unreadable_occurred_at", "unsupported_span"];
+export declare const DROP_REASONS_EXCLUDED_BY_DESIGN: ReadonlySet<string>;

package/dist/_generated/drop-reasons.js

@@ -0,0 +1,25 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-backend-contract/src/delivery/delivery-response-vectors.v1.json
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+export const DROP_REASONS = [
+    "event_schema_invalid",
+    "event_too_large",
+    "fact_admission_filtered",
+    "ingest_control",
+    "privacy_blocked",
+    "privacy_gate_rejected_field",
+    "privacy_policy_rejected",
+    "source_signal_transform_failed",
+    "unreadable_occurred_at",
+    "unsupported_span",
+];
+export const DROP_REASONS_EXCLUDED_BY_DESIGN = new Set([
+    "fact_admission_filtered",
+    "privacy_blocked",
+    "privacy_gate_rejected_field",
+    "privacy_policy_rejected",
+]);

package/dist/_generated/ingest-routes.d.ts

@@ -0,0 +1,5 @@
+/** 取り込みの受け口の綴り。送信先の設定を伸ばせる形かどうかはこれで決まります。 */
+export declare const CLUEBASE_API_V1_PREFIX: "/api/v1";
+export declare const CANONICAL_BACKEND_INGEST_PATH: "/api/v1/ingest/backend";
+export declare const CANONICAL_BROWSER_INGEST_PATH: "/api/v1/ingest/browser";
+export declare const CANONICAL_BROWSER_TOKEN_PATH: "/api/v1/ingest/browser-tokens";

package/dist/_generated/ingest-routes.js

@@ -0,0 +1,12 @@
+// 自動生成です。**手で編集しないでください。**
+//
+// 正本: packages/cluebase-shared/src/ingest/routes.ts
+// 出し直す: node scripts/generate-shared-contract-tables.mjs
+//
+// 正本を直したらこの file も一緒に commit してください。CI が
+// `node scripts/generate-shared-contract-tables.mjs --check` で照合し、ずれていれば落とします。
+/** 取り込みの受け口の綴り。送信先の設定を伸ばせる形かどうかはこれで決まります。 */
+export const CLUEBASE_API_V1_PREFIX = "/api/v1";
+export const CANONICAL_BACKEND_INGEST_PATH = "/api/v1/ingest/backend";
+export const CANONICAL_BROWSER_INGEST_PATH = "/api/v1/ingest/browser";
+export const CANONICAL_BROWSER_TOKEN_PATH = "/api/v1/ingest/browser-tokens";

package/dist/context/trace.js

@@ -207,12 +207,10 @@ export class TraceManager {
             requestSpanId: generateRequestSpanId(),
             actionId: active?.actionId ?? null,
             interactionId: generateInteractionId(),
-            interactionInitiator: trigger?.interactionInitiator ??
-                active?.interactionInitiator ??
-                "background",
+            interactionInitiator: trigger?.interactionInitiator ?? active?.interactionInitiator ?? null,
             interactionStartEventKind: trigger?.interactionStartEventKind ??
                 active?.interactionStartEventKind ??
-                "background_request",
+                null,
             originFrontendInteractionId: active?.interactionId ?? null,
         };
     }

package/dist/exporter/batch.d.ts

@@ -1,10 +1,10 @@
 import type { InternalMetricsStore } from "../internal/metrics.js";
-import type { CluebaseConsentState, IngestUsageGovernorFeedback } from "../provider/types.js";
-import { type CollectionPermit } from "./browser-outbox.js";
+import type { CluebaseConsentState } from "../provider/types.js";
 import type { IngestClient } from "./client.js";
 import { DiagnosticStore, type DiagnosticsSnapshot } from "./diagnostics.js";
+import type { CollectionPermit } from "./sdk-core-delivery.js";
 import type { BrowserSourceEvent } from "./source-event.js";
-export type BatchIngestClient = Pick<IngestClient, "send" | "hasUsableBrowserToken" | "createBatchEnvelopeMetadata" | "measurePayloadBytes">;
+export type BatchIngestClient = Pick<IngestClient, "perform" | "abortAttempt" | "ensureDeliveryToken" | "hasUsableBrowserToken" | "createBatchEnvelopeMetadata" | "measurePayloadBytes" | "stringifyPayload" | "diagnosticCanonicalPayload">;
 export type BatchTransportOptions = {
     enabled: boolean;
     flushIntervalMs: number;
@@ -16,9 +16,13 @@ export type BatchTransportOptions = {
     queueMaxBytes?: number;
     queueMaxItems?: number;
     projectKey?: string;
+    endpoint: string;
+    sdkVersion: string;
+    sourceSchemaVersion: string;
+    sdkRequest: string;
+    requestTimeoutMs?: number;
     initialConsent?: CluebaseConsentState;
     diagnostics?: DiagnosticStore;
-    onGovernorFeedback?: (feedback: IngestUsageGovernorFeedback) => void;
 };
 export type FlushDeadline = {
     readonly signal: AbortSignal;
@@ -26,6 +30,7 @@ export type FlushDeadline = {
 };
 export declare class BatchTransport {
     private readonly outbox;
+    private readonly pipeline;
     private readonly client;
     private readonly enabled;
     private readonly flushIntervalMs;
@@ -34,24 +39,19 @@ export declare class BatchTransport {
     private readonly maxSize;
     private readonly metrics;
     private readonly diagnostics;
-    private readonly onGovernorFeedback;
     private idleHandle;
     private flushing;
     private flushAgainAfterCurrent;
-    private activeSendController;
-    private closeDeadlineController;
-    private closeDeadlineTimer;
     private closeDeadlineAt;
-    private closePermitOrdinal;
-    private flushDeadlineController;
-    private flushDeadlineTimer;
-    private flushDeadlineAt;
+    private clearedAt;
+    private disposed;
+    private closeDeadlineTimer;
     private lifecycle;
     private closeHadTerminalDisposition;
+    private restored;
+    private tokenRefusedForGood;
     private activeFlushPromise;
     private enqueueTail;
-    private readonly seenEventIds;
-    private static readonly DEDUP_CAPACITY;
     constructor(options: BatchTransportOptions);
     getDiagnostics(): DiagnosticsSnapshot;
     start(): void;
@@ -61,24 +61,21 @@ export declare class BatchTransport {
     capturePermit(): CollectionPermit;
     setConsent(consent: CluebaseConsentState): void;
     enqueue(event: BrowserSourceEvent, permit?: CollectionPermit): void;
-    private scheduleFlushDeadline;
-    beginFlushDeadline(): FlushDeadline | null;
-    endFlushDeadline(deadline: FlushDeadline | null | undefined): void;
-    flush(deadline?: FlushDeadline | null): Promise<void>;
+    flush(): Promise<void>;
     private runFlushUntilIdle;
-    beginClose(): AbortSignal | null;
+    beginClose(): void;
     close(): Promise<void>;
-    private runFlushCycle;
-    private sendBatchWhilePermitted;
-    private applyDeliveryResult;
-    private applyFailedDelivery;
-    private applySuccessfulDelivery;
     flushOnUnload(): void;
     clear(): void;
+    private runFlushCycle;
+    private serializeBatch;
+    private applyObservation;
+    private adoptStoredRecords;
+    private ensureDeliveryToken;
+    private envelopeOverheadBytes;
+    private scheduleFlushDeadline;
     private abortActiveSendForConsent;
     private recordPendingBatchCount;
     private clearCloseDeadline;
-    private currentDeadline;
     private queueOutboxMutation;
-    private shouldRetainFailedBatch;
 }