@glasstrace/sdk 1.3.9 → 1.5.0

package/dist/index.d.cts

@@ -1,459 +1,119 @@
-import { a as SessionManager } from './edge-entry-DyMWa6JK.cjs';
-export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, c as captureCorrelationId, g as getDateString, b as getOrigin } from './edge-entry-DyMWa6JK.cjs';
-import { G as GlasstraceEnvVars, a as GlasstraceOptions, A as AnonApiKey, S as SdkInitResponse, C as CaptureConfig, b as SdkHealthReport, I as ImportGraphPayload, c as SdkDiagnosticCode } from './index.d-Bo_Rxund.cjs';
-export { d as deriveSessionId } from './index.d-Bo_Rxund.cjs';
-import { ReadableSpan } from './export/ReadableSpan';
-import { SpanExporter } from './export/SpanExporter';
-import { ExportResult } from './ExportResult';
-import { SpanProcessor } from './SpanProcessor';
+export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, a as SessionManager, c as captureCorrelationId, g as getDateString, b as getOrigin } from './edge-entry-DaeG7D7S.cjs';
+export { F as FetchTarget, G as GlasstraceExporter, a as GlasstraceExporterOptions, I as InitClaimResult, R as ResolvedConfig, c as captureError, b as classifyFetchTarget, d as createGlasstraceSpanProcessor, g as getActiveConfig, e as getDiscoveryHandler, f as getLinkedAccountId, h as getOrCreateAnonKey, i as getStatus, j as isAnonymousMode, k as isProductionDisabled, l as isReady, m as loadCachedConfig, p as performInit, r as readAnonKey, n as readEnvVars, o as registerGlasstrace, q as resolveConfig, s as saveCachedConfig, t as sendInitRequest, w as waitForReady, u as withGlasstraceConfig } from './capture-error-BmQz7xF6.cjs';
+import { S as SideEffectOperationKind, a as SideEffectOperationStatus, b as SideEffectOperationPhase, c as SideEffectSemanticFieldKey } from './index.d-Dq33YwFT.cjs';
+export { e as SideEffectOmissionReason, d as deriveSessionId } from './index.d-Dq33YwFT.cjs';
+import './export/ReadableSpan';
 import './Span';
+import './SpanProcessor';
+import './export/SpanExporter';
+import './ExportResult';
 import './v4/classic/external.cjs';
 
 /**
- * Resolved configuration after merging explicit options with environment variables.
- */
-interface ResolvedConfig {
-    apiKey: string | undefined;
-    endpoint: string;
-    forceEnable: boolean;
-    verbose: boolean;
-    environment: string | undefined;
-    coverageMapEnabled: boolean;
-    nodeEnv: string | undefined;
-    vercelEnv: string | undefined;
-}
-/**
- * Reads all recognized Glasstrace environment variables from process.env.
- * Returns undefined for any variable not set. Never throws.
- */
-declare function readEnvVars(): GlasstraceEnvVars;
-/**
- * Merges explicit GlasstraceOptions with environment variables.
- * Explicit options take precedence over environment variables.
- */
-declare function resolveConfig(options?: GlasstraceOptions): ResolvedConfig;
-/**
- * Returns true when the SDK should be inactive (production detected without force-enable).
- * Logic order:
- *   1. forceEnable === true → return false (override)
- *   2. NODE_ENV === 'production' → return true
- *   3. VERCEL_ENV === 'production' → return true
- *   4. Otherwise → return false
- */
-declare function isProductionDisabled(config: ResolvedConfig): boolean;
-/**
- * Returns true when no API key is configured (anonymous mode).
- * Treats undefined, empty string, whitespace-only, and gt_anon_* keys as anonymous.
- */
-declare function isAnonymousMode(config: ResolvedConfig): boolean;
-
-/**
- * The set of recognized fetch target categories.
- */
-type FetchTarget = "supabase" | "stripe" | "internal" | "unknown";
-/**
- * Classifies an outbound fetch target URL into a known category.
- * Classification is case-insensitive and based on the URL hostname.
- * Uses dot-boundary matching to avoid false positives (e.g. evilstripe.com).
- *
- * Returns one of: 'supabase', 'stripe', 'internal', or 'unknown'.
- */
-declare function classifyFetchTarget(url: string): FetchTarget;
-
-/**
- * Reads an existing anonymous key from the filesystem.
- * Returns the key if valid, or null if:
- * - The file does not exist
- * - The file content is invalid
- * - An I/O error occurs
- * - `node:fs` is unavailable (non-Node environment)
- */
-declare function readAnonKey(projectRoot?: string): Promise<AnonApiKey | null>;
-/**
- * Gets an existing anonymous key from the filesystem, or creates a new one.
- *
- * - If file exists and contains a valid key, returns it
- * - If file does not exist or content is invalid, generates a new key via createAnonApiKey()
- * - Writes the new key to `.glasstrace/anon_key`, creating the directory if needed
- * - On file write failure: logs a warning, caches an ephemeral in-memory key so
- *   repeated calls in the same process return the same key
- * - In non-Node environments: returns an ephemeral in-memory key
- */
-declare function getOrCreateAnonKey(projectRoot?: string): Promise<AnonApiKey>;
-
-/**
- * Reads and validates a cached config file from `.glasstrace/config`.
- * Returns the parsed `SdkInitResponse` or `null` on any failure,
- * including when `node:fs` is unavailable (non-Node environments).
- */
-declare function loadCachedConfig(projectRoot?: string): SdkInitResponse | null;
-/**
- * Persists the init response to `.glasstrace/config` using the SDK 2.0
- * atomic-write protocol (`tmp + fsync(tmp) + rename + fsync(parent)`).
- * Silently skipped when `node:fs` is unavailable (non-Node environments).
- * On I/O failure, logs a warning.
+ * Public side-effect evidence emission API (SDK-049).
  *
- * Atomicity: the payload is written to `.glasstrace/config.tmp`, fsynced
- * to durable storage, then renamed into place; the parent directory is
- * fsynced last so the rename survives an immediate crash. `rename` is
- * atomic on POSIX filesystems, so readers either see the previous valid
- * config or the new valid config — never a truncated or partially-written
- * file (DISC-1247 Scenario 5). If any step fails, the temp file is
- * cleaned up on a best-effort basis.
- */
-declare function saveCachedConfig(response: SdkInitResponse, projectRoot?: string): Promise<void>;
-/**
- * Sends a POST request to `/v1/sdk/init`.
- * Validates the response against `SdkInitResponseSchema`.
- *
- * Uses `node:https` via {@link httpsPostJson} rather than the global
- * `fetch` because Next.js 16 patches `fetch` for caching/revalidation
- * and can cause the init request to silently hang (DISC-493 Issue 3).
- * Retries transport-level failures (DNS, TCP, TLS) twice with 500ms +
- * 1500ms backoff, capped at a 20-second total deadline. Server responses
- * (HTTP 4xx/5xx) are never retried and are surfaced immediately.
- */
-declare function sendInitRequest(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string, importGraph?: ImportGraphPayload, healthReport?: SdkHealthReport, diagnostics?: Array<{
-    code: SdkDiagnosticCode;
-    message: string;
-    timestamp: number;
-}>, signal?: AbortSignal): Promise<SdkInitResponse>;
-/**
- * Result returned by {@link performInit} when the backend reports an
- * account claim transition. `null` means no claim was present.
- */
-interface InitClaimResult {
-    claimResult: NonNullable<SdkInitResponse["claimResult"]>;
-}
-/**
- * Orchestrates the full init flow: send request, update config, cache result.
- * This function MUST NOT throw.
- *
- * Returns the claim result when the backend reports an account claim
- * transition, or `null` when no claim result is available (including
- * when init is skipped due to rate-limit backoff, missing API key,
- * or request failure). Callers that do not need claim information
- * can safely ignore the return value.
- */
-declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string, healthReport?: SdkHealthReport | null): Promise<InitClaimResult | null>;
-/**
- * Returns the current capture config from the three-tier fallback chain:
- * 1. In-memory config from latest init response
- * 2. File cache (read at most once per process lifetime)
- * 3. DEFAULT_CAPTURE_CONFIG
- *
- * The disk read is cached via `configCacheChecked` to avoid repeated
- * synchronous I/O on the hot path (called by GlasstraceExporter on
- * every span export batch).
- */
-declare function getActiveConfig(): CaptureConfig;
-/**
- * Returns the `linkedAccountId` from the current in-memory init response,
- * or `undefined` if no init response is available or no account is linked.
+ * Exposes {@link recordSideEffect} as a single user-callable function
+ * that attaches allowlisted, non-sensitive semantic metadata about a
+ * side-effect operation (email, calendar_link, webhook, external_api,
+ * queue, after_callback) to the current active OTel span.
  *
- * Used by the discovery endpoint to determine whether `claimed: true`
- * should be included in the response.
+ * The behavior contract is observational only: this function never
+ * executes a side effect, never retries, never delays, never throws.
+ * All failure modes (no active span, ended span, NonRecordingSpan,
+ * capture-config disabled, allowlist rejection, per-span budget
+ * exhausted, OTel attribute slot exhaustion) silently route to a
+ * no-op or to an omission-counter increment that carries no rejected
+ * input.
  */
-declare function getLinkedAccountId(): string | undefined;
 
 /**
- * Options for constructing a {@link GlasstraceExporter}.
- */
-interface GlasstraceExporterOptions {
-    getApiKey: () => string;
-    sessionManager: SessionManager;
-    getConfig: () => CaptureConfig;
-    environment: string | undefined;
-    endpointUrl: string;
-    createDelegate: ((url: string, headers: Record<string, string>) => SpanExporter) | null;
-    /** When true, logs diagnostic details about enrichment decisions via sdkLog. */
-    verbose?: boolean;
-}
-/**
- * A SpanExporter that enriches spans with glasstrace.* attributes at export
- * time, then delegates to a real OTLP exporter.
+ * Input shape for {@link recordSideEffect}.
  *
- * This design resolves three issues:
- * - Spans emitted before the API key resolves are buffered (not dropped)
- *   and flushed once the key is available.
- * - Enrichment happens in the exporter (not onEnding), so it works
- *   on Vercel where CompositeSpanProcessor does not forward onEnding().
- * - Session ID is computed at export time using the resolved API key,
- *   not the "pending" placeholder.
+ * All fields except `kind` and `operation` are optional. The SDK
+ * silently drops unknown fields and unsafe values, surfacing only an
+ * integer omission count under the matching
+ * `glasstrace.side_effect.omitted.*` attribute on the active span.
  */
-declare class GlasstraceExporter implements SpanExporter {
-    private readonly getApiKey;
-    private readonly sessionManager;
-    private readonly getConfig;
-    private readonly environment;
-    private readonly endpointUrl;
-    private readonly createDelegateFn;
-    private readonly verbose;
-    private delegate;
-    private delegateKey;
-    private pendingBatches;
-    private pendingSpanCount;
-    private overflowLogged;
-    constructor(options: GlasstraceExporterOptions);
-    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+interface RecordSideEffectInput {
     /**
-     * Called when the API key transitions from "pending" to a resolved value.
-     * Creates the delegate exporter and flushes all buffered spans.
+     * One of the allowlisted v1 operation kinds. Calls with any other
+     * value (typo, unsupported kind, non-string) silently drop without
+     * recording an omission, because there is no kind to attach the
+     * counter to.
      */
-    notifyKeyResolved(): void;
-    shutdown(): Promise<void>;
+    kind: SideEffectOperationKind;
     /**
-     * Flushes any pending buffered spans (if the API key has resolved) and
-     * delegates to the underlying exporter's forceFlush to drain its queue.
+     * Compact, normalized operation label (max 96 chars). Must match
+     * `^[A-Za-z0-9][A-Za-z0-9_.:-]*$`. Free-form prose, URLs, query
+     * strings, and email-shaped values are silently dropped and routed
+     * to the matching omission counter.
      */
-    forceFlush(): Promise<void>;
+    operation: string;
     /**
-     * Enriches a ReadableSpan with all glasstrace.* attributes.
-     * Returns a new ReadableSpan wrapper; the original span is not mutated.
-     *
-     * Only {@link SessionManager.getSessionId} is individually guarded because
-     * it calls into crypto and schema validation — a session ID failure should
-     * not prevent the rest of enrichment. The other helper calls
-     * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
-     * {@link classifyFetchTarget}) are pure functions on typed string inputs
-     * and rely on the outer catch for any unexpected failure.
-     *
-     * On total failure, returns the original span unchanged.
+     * Optional operation lifecycle status. Defaults to omitted. Values
+     * outside the v1 allowlist are silently dropped.
      */
-    private enrichSpan;
+    status?: SideEffectOperationStatus;
     /**
-     * Lazily creates the delegate OTLP exporter once the API key is resolved.
-     * Recreates the delegate if the key has changed (e.g., after key rotation)
-     * so the Authorization header stays current.
+     * Optional operation execution phase (request / post_response /
+     * background / unknown). Defaults to omitted.
      */
-    private ensureDelegate;
+    phase?: SideEffectOperationPhase;
     /**
-     * Buffers raw (unenriched) spans while the API key is pending.
-     * Evicts oldest batches if the buffer exceeds MAX_PENDING_SPANS.
-     * Re-checks the key after buffering to close the race window where
-     * the key resolves between the caller's check and this buffer call.
+     * Optional allowlisted semantic fields. Keys outside the v1
+     * allowlist (`templateKey`, `providerOperation`, `role`, `locale`,
+     * `timezone`, `status`, `phase`) and values matching unsafe
+     * patterns (URLs, emails, tokens, headers, prose-shaped
+     * whitespace) are silently dropped and routed to the matching
+     * omission counter.
      */
-    private bufferSpans;
-    /**
-     * Flushes all buffered spans through the delegate exporter.
-     * Enriches spans at flush time (not buffer time) so that session IDs
-     * are computed with the resolved API key instead of the "pending" sentinel.
-     */
-    private flushPending;
+    fields?: Partial<Record<SideEffectSemanticFieldKey, string>>;
 }
-
-/**
- * The primary SDK entry point called by developers in their `instrumentation.ts`.
- * Orchestrates OTel setup, span processor, init client, anon key, and discovery endpoint.
- *
- * This function is synchronous and MUST NOT throw. The developer's server is never blocked.
- * Background work (key resolution, init call) happens via fire-and-forget promises.
- *
- * @param options - Optional SDK configuration. Environment variables are used as fallbacks.
- *
- * @example
- * ```ts
- * // instrumentation.ts
- * import { registerGlasstrace } from "@glasstrace/sdk";
- * registerGlasstrace(); // uses env vars
- * ```
- */
-declare function registerGlasstrace(options?: GlasstraceOptions): void;
-/**
- * Returns the registered discovery handler, or null if not registered.
- */
-declare function getDiscoveryHandler(): ((request: Request) => Promise<Response | null>) | null;
-
-/**
- * Structural view of Next.js's `NextConfig`. The SDK does not import Next's
- * type directly because Next is not a peer dependency — this wrapper must
- * type-check regardless of which Next.js version the consumer has installed.
- *
- * The constraint is `object` rather than `Record<string, unknown>` because
- * Next's actual `NextConfig` is an interface *without* a string index
- * signature. Requiring `[key: string]: unknown` would fail the assignability
- * check that caused DISC-1256, reported by Next 16 consumers as:
- *   > Argument of type 'NextConfig' is not assignable to parameter of type
- *   > 'NextConfig'. Index signature for type 'string' is missing in type
- *   > 'NextConfig'.
- *
- * `object` accepts every non-primitive value, which is what the wrapper
- * actually handles at runtime (it shallow-copies the input and reads a few
- * known properties defensively). Combined with the generic signature on
- * `withGlasstraceConfig`, callers preserve their exact config subtype.
- */
-type NextConfig = object;
-/**
- * Wraps the developer's Next.js config to enable source map generation
- * and upload .map files to the ingestion API at build time.
- *
- * The build NEVER fails because of Glasstrace — all errors are caught
- * and logged as warnings.
- *
- * ## What the wrapper configures for you
- *
- * - `experimental.serverSourceMaps: true` — enables server-side source maps
- *   so Glasstrace can resolve stack traces back to your source.
- * - `serverExternalPackages: ["@glasstrace/sdk"]` — tells Next to load the
- *   SDK via Node's `require()` at runtime instead of bundling it through
- *   webpack or Turbopack on the RSC / Route Handler paths. This is the same
- *   pattern Prisma, `@vercel/otel`, Sentry, `sharp`, and `bcrypt` ship with.
- * - A webpack `externals` entry that marks every Node.js built-in import
- *   (both `node:*` and bare forms like `zlib` or `stream`) as a runtime
- *   `commonjs` require. `serverExternalPackages` does not apply to the
- *   instrumentation path under `next dev --webpack`
- *   (vercel/next.js#58003, #28774), so any bundled SDK chunk that imports
- *   `node:child_process` or the bare `zlib` specifier used by
- *   `@opentelemetry/otlp-exporter-base` would otherwise crash with
- *   `UnhandledSchemeError` or `Can't resolve 'zlib'`. This entry is the
- *   actual DISC-1257 fix for the dev-webpack path. Turbopack is
- *   unaffected — it ignores `config.webpack` and resolves Node built-ins
- *   natively.
- * - An empty `turbopack: {}` when none is set, so Next 16 does not reject
- *   the config for setting `webpack` without a companion `turbopack` key
- *   (DISC-1256).
- * - A `webpack` hook that collects and uploads `.map` files on client-side
- *   production builds.
- *
- * ## Turbopack
- *
- * Next.js 16 made Turbopack the default bundler for `next build`, and Next
- * rejects configs that set `webpack` without also setting `turbopack`. This
- * wrapper therefore seeds an empty `turbopack: {}` when the user has not set
- * one themselves, preserving existing behaviour for explicit Turbopack configs.
- *
- * **Source-map upload is currently webpack-only.** Under Turbopack the build
- * succeeds, but the afterEmit hook that collects and uploads `.map` files does
- * not fire. Run `next build --webpack` to get source-map uploads, or wait for
- * a follow-up release that ports the plugin to Turbopack.
- *
- * @param nextConfig - The developer's existing Next.js configuration object.
- * @returns A new config object with source map generation and upload enabled.
- *   The return type mirrors the input type so that caller-side config
- *   properties are preserved. The `object` constraint (rather than
- *   `Record<string, unknown>`) is what makes the wrapper accept Next's
- *   real `NextConfig` interface (DISC-1256).
- */
-declare function withGlasstraceConfig<T extends NextConfig>(nextConfig: T): T;
-
-/**
- * Returns true when the SDK is in ACTIVE or ACTIVE_DEGRADED state.
- */
-declare function isReady(): boolean;
-/**
- * Resolves when the SDK reaches ACTIVE or ACTIVE_DEGRADED.
- * Rejects on PRODUCTION_DISABLED, REGISTRATION_FAILED, or timeout.
- *
- * Checks current state synchronously first — resolves/rejects immediately
- * if the SDK has already reached a terminal or ready state.
- */
-declare function waitForReady(timeoutMs?: number): Promise<void>;
-/**
- * Simplified public state query for external consumers.
- * Hides implementation details like coexistence scenarios.
- *
- * The returned `tracing` field is the canonical user-observable signal
- * for OTel coexistence outcomes:
- *
- * - `"active"` — the SDK owns the OTel provider and is exporting spans.
- * - `"coexistence"` — another OTel provider was detected and the SDK
- *   either auto-attached its span processor or found one already
- *   present. Spans are exported through the existing pipeline.
- * - `"degraded"` — the SDK is exporting but the core lifecycle entered
- *   `ACTIVE_DEGRADED` (e.g., a non-fatal export failure).
- * - `"not-configured"` — the SDK could not configure tracing. Covers
- *   `OtelState.UNCONFIGURED`, `OtelState.CONFIGURING`, and
- *   `OtelState.COEXISTENCE_FAILED` (the DISC-1556 Next 16 production
- *   "auto-attach returned null" path). When the value is
- *   `"not-configured"` after `registerGlasstrace()` has resolved,
- *   spans are NOT reaching the Glasstrace exporter and the manual
- *   `createGlasstraceSpanProcessor()` workaround should be applied.
- *   See `runtime-state.json`'s `lastError` field for the structured
- *   failure record.
- */
-declare function getStatus(): {
-    ready: boolean;
-    mode: "anonymous" | "authenticated" | "claiming" | "disabled";
-    tracing: "active" | "degraded" | "not-configured" | "coexistence";
-};
-
 /**
- * OTel Coexistence Public API
- *
- * Provides createGlasstraceSpanProcessor() for developers who want to
- * manually integrate Glasstrace with their existing OTel provider
- * (e.g., Sentry's openTelemetrySpanProcessors config option).
- *
- * Also provides the auto-attach path (tryAutoAttachGlasstraceProcessor)
- * that configureOtel() uses when it detects a pre-registered provider
- * at runtime (Next.js 16 production, Sentry, Datadog, New Relic). Both
- * entry points reuse the same span-processor factory so the manual and
- * automatic paths stay in lockstep.
- *
- * Design: sdk-otel-coexistence.md Sections 3, 4, 5, 6
- */
-
-/**
- * Creates a Glasstrace span processor for manual integration with an
- * existing OTel provider.
- *
- * Use this when another tool (e.g., Sentry) owns the OTel provider and
- * you want to add Glasstrace to their processor list:
- *
- * @example
+ * Record allowlisted side-effect evidence on the current active OTel
+ * span (SDK-049).
+ *
+ * Behavior is observational only: this function never executes,
+ * retries, or duplicates a side effect. The default capture-config
+ * flag `sideEffectEvidence` is `false`; callers must opt in via
+ * account configuration before any attribute reaches the wire.
+ *
+ * Edge cases (all silent no-ops):
+ *  - capture-config flag is `false` ⇒ no-op (no allowlist evaluation)
+ *  - input is not a plain object ⇒ no-op
+ *  - `kind` is not in the v1 allowlist ⇒ no-op
+ *  - no active span ⇒ no-op
+ *  - active span has already ended or is `NonRecordingSpan` ⇒ no-op
+ *  - per-span operation budget exhausted (5 ops max) ⇒ records a
+ *    `value_too_long` omission count, no operation attributes
+ *  - OTel attribute slot exhaustion ⇒ silently drops the attribute
+ *    write
+ *
+ * The SDK guards only callers of this function. Direct
+ * `span.setAttribute("glasstrace.side_effect.<...>", ...)` writes
+ * bypass the SDK and rely on the product's storage filter (ING-023)
+ * as the second defense layer; this is intentional defense-in-depth,
+ * not a gap.
+ *
+ * @example Recording a successful cancellation email
  * ```ts
- * import * as Sentry from "@sentry/nextjs";
- * import { createGlasstraceSpanProcessor } from "@glasstrace/sdk";
- *
- * Sentry.init({
- *   dsn: "...",
- *   openTelemetrySpanProcessors: [createGlasstraceSpanProcessor()],
+ * import { recordSideEffect } from "@glasstrace/sdk";
+ *
+ * await mailer.send({ to: recipient, template: "EventCanceledEmail" });
+ * recordSideEffect({
+ *   kind: "email",
+ *   operation: "email.send",
+ *   status: "succeeded",
+ *   phase: "request",
+ *   fields: {
+ *     templateKey: "EventCanceledEmail",
+ *     role: "invitee",
+ *     locale: "en-US",
+ *     timezone: "Europe/Paris",
+ *   },
  * });
  * ```
- *
- * **Important:** `registerGlasstrace()` is still required even when using
- * this function. The processor handles span transport (enrichment and
- * export). `registerGlasstrace()` handles everything else: init calls,
- * config sync, session management, anonymous key generation, discovery
- * endpoint, and health reporting.
- *
- * @param options - Optional SDK configuration. If omitted, uses the same
- *   config as registerGlasstrace() (environment variables).
- * @returns A BatchSpanProcessor wrapping a GlasstraceExporter with the
- *   branded Symbol.for('glasstrace.exporter') for coexistence detection.
- */
-declare function createGlasstraceSpanProcessor(options?: GlasstraceOptions): SpanProcessor;
-
-/**
- * Manual error capture API.
- *
- * Provides a simple function for developers to manually record errors
- * as span events, independent of the `consoleErrors` config flag.
- */
-/**
- * Records an error as a span event on the currently active OTel span.
- *
- * Works regardless of the `consoleErrors` configuration — this is an
- * explicit, opt-in API for manual error reporting. If no span is active
- * or OTel is not available, the call is silently ignored.
- *
- * On the first captured error, may display a one-time diagnostic nudge
- * to stderr if the MCP connection marker is absent (dev environments only).
- *
- * @param error - The error to capture. Accepts `Error` objects, strings, or any value.
- *
- * @example
- * ```ts
- * import { captureError } from "@glasstrace/sdk";
- *
- * try {
- *   await riskyOperation();
- * } catch (err) {
- *   captureError(err);
- *   // handle error normally...
- * }
- * ```
  */
-declare function captureError(error: unknown): void;
+declare function recordSideEffect(input: RecordSideEffectInput): void;
 
-export { type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, type InitClaimResult, type ResolvedConfig, SessionManager, captureError, classifyFetchTarget, createGlasstraceSpanProcessor, getActiveConfig, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getStatus, isAnonymousMode, isProductionDisabled, isReady, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, waitForReady, withGlasstraceConfig };
+export { type RecordSideEffectInput, SideEffectOperationKind, SideEffectOperationPhase, SideEffectOperationStatus, SideEffectSemanticFieldKey, recordSideEffect };