@glasstrace/sdk 1.15.1 → 1.17.0

package/dist/{index.d-BQIJ5Dvc.d.cts → index.d-3-cJoY8y.d.cts}

@@ -43,6 +43,10 @@ declare const CaptureConfigSchema: z.ZodObject<{
     consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     errorResponseBodies: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     sideEffectEvidence: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    captureFidelity: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        strict: "strict";
+        full: "full";
+    }>>>;
 }, z.core.$strip>;
 type CaptureConfig = z.infer<typeof CaptureConfigSchema>;
 /** Developer-facing config for registerGlasstrace(). */
@@ -112,6 +116,10 @@ declare const SdkInitResponseSchema: z.ZodObject<{
         consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         errorResponseBodies: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         sideEffectEvidence: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        captureFidelity: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            strict: "strict";
+            full: "full";
+        }>>>;
     }, z.core.$strip>;
     subscriptionStatus: z.ZodString;
     linkedAccountId: z.ZodOptional<z.ZodString>;
@@ -284,7 +292,7 @@ type SideEffectSemanticFieldKey = SideEffectSemanticFieldStableCoreKey | string;
  * wire. The set is fixed by SCHEMA-036; new reasons require a
  * coordinated cross-repo bump.
  */
-declare const SIDE_EFFECT_OMISSION_REASONS: readonly ["pii", "secret", "raw_payload", "unsupported_key", "value_too_long", "not_emitted", "capture_disabled"];
+declare const SIDE_EFFECT_OMISSION_REASONS: readonly ["pii", "secret", "raw_payload", "unsupported_key", "value_too_long", "not_emitted", "capture_disabled", "raw_timestamp", "unhashed_id", "non_finite"];
 /**
  * One of the allowlisted side-effect omission reasons.
  *
@@ -316,4 +324,4 @@ declare const SIDE_EFFECT_OPERATION_PHASES: readonly ["request", "post_response"
  */
 type SideEffectOperationPhase = (typeof SIDE_EFFECT_OPERATION_PHASES)[number];
 
-export { type AnonApiKey as A, type CaptureConfig as C, type GlasstraceEnvVars as G, type ImportGraphPayload as I, type SideEffectOperationKind as S, type SideEffectOperationStatus as a, type SideEffectOperationPhase as b, type SideEffectSemanticFieldKey as c, deriveSessionId as d, type SideEffectOmissionReason as e, type SideEffectSemanticFieldStableCoreKey as f, type SdkDiagnosticCode as g, type SessionId as h, isSideEffectSemanticFieldKey as i, type GlasstraceOptions as j, type SdkInitResponse as k, type SdkHealthReport as l, type SourceMapUploadResponse as m, type SourceMapManifestResponse as n };
+export { type AnonApiKey as A, type CaptureConfig as C, type GlasstraceEnvVars as G, type ImportGraphPayload as I, type SideEffectOperationKind as S, type SideEffectOperationStatus as a, type SideEffectOperationPhase as b, type SideEffectSemanticFieldKey as c, deriveSessionId as d, type SideEffectOmissionReason as e, type SideEffectSemanticFieldStableCoreKey as f, type SourceMapUploadResponse as g, type SourceMapManifestResponse as h, isSideEffectSemanticFieldKey as i, type SdkDiagnosticCode as j, type SessionId as k, type GlasstraceOptions as l, type SdkInitResponse as m, type SdkHealthReport as n };

package/dist/{index.d-BQIJ5Dvc.d.ts → index.d-3-cJoY8y.d.ts}

@@ -43,6 +43,10 @@ declare const CaptureConfigSchema: z.ZodObject<{
     consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     errorResponseBodies: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     sideEffectEvidence: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    captureFidelity: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        strict: "strict";
+        full: "full";
+    }>>>;
 }, z.core.$strip>;
 type CaptureConfig = z.infer<typeof CaptureConfigSchema>;
 /** Developer-facing config for registerGlasstrace(). */
@@ -112,6 +116,10 @@ declare const SdkInitResponseSchema: z.ZodObject<{
         consoleErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         errorResponseBodies: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         sideEffectEvidence: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        captureFidelity: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            strict: "strict";
+            full: "full";
+        }>>>;
     }, z.core.$strip>;
     subscriptionStatus: z.ZodString;
     linkedAccountId: z.ZodOptional<z.ZodString>;
@@ -284,7 +292,7 @@ type SideEffectSemanticFieldKey = SideEffectSemanticFieldStableCoreKey | string;
  * wire. The set is fixed by SCHEMA-036; new reasons require a
  * coordinated cross-repo bump.
  */
-declare const SIDE_EFFECT_OMISSION_REASONS: readonly ["pii", "secret", "raw_payload", "unsupported_key", "value_too_long", "not_emitted", "capture_disabled"];
+declare const SIDE_EFFECT_OMISSION_REASONS: readonly ["pii", "secret", "raw_payload", "unsupported_key", "value_too_long", "not_emitted", "capture_disabled", "raw_timestamp", "unhashed_id", "non_finite"];
 /**
  * One of the allowlisted side-effect omission reasons.
  *
@@ -316,4 +324,4 @@ declare const SIDE_EFFECT_OPERATION_PHASES: readonly ["request", "post_response"
  */
 type SideEffectOperationPhase = (typeof SIDE_EFFECT_OPERATION_PHASES)[number];
 
-export { type AnonApiKey as A, type CaptureConfig as C, type GlasstraceEnvVars as G, type ImportGraphPayload as I, type SideEffectOperationKind as S, type SideEffectOperationStatus as a, type SideEffectOperationPhase as b, type SideEffectSemanticFieldKey as c, deriveSessionId as d, type SideEffectOmissionReason as e, type SideEffectSemanticFieldStableCoreKey as f, type SdkDiagnosticCode as g, type SessionId as h, isSideEffectSemanticFieldKey as i, type GlasstraceOptions as j, type SdkInitResponse as k, type SdkHealthReport as l, type SourceMapUploadResponse as m, type SourceMapManifestResponse as n };
+export { type AnonApiKey as A, type CaptureConfig as C, type GlasstraceEnvVars as G, type ImportGraphPayload as I, type SideEffectOperationKind as S, type SideEffectOperationStatus as a, type SideEffectOperationPhase as b, type SideEffectSemanticFieldKey as c, deriveSessionId as d, type SideEffectOmissionReason as e, type SideEffectSemanticFieldStableCoreKey as f, type SourceMapUploadResponse as g, type SourceMapManifestResponse as h, isSideEffectSemanticFieldKey as i, type SdkDiagnosticCode as j, type SessionId as k, type GlasstraceOptions as l, type SdkInitResponse as m, type SdkHealthReport as n };

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, a as SessionManager, c as captureCorrelationId, g as getDateString, b as getOrigin } from './correlation-id-CZ2bstzA.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-03qDnC5v.cjs';
-import { S as SideEffectOperationKind, a as SideEffectOperationStatus, b as SideEffectOperationPhase, c as SideEffectSemanticFieldKey } from './index.d-BQIJ5Dvc.cjs';
-export { e as SideEffectOmissionReason, f as SideEffectSemanticFieldStableCoreKey, d as deriveSessionId, i as isSideEffectSemanticFieldKey } from './index.d-BQIJ5Dvc.cjs';
+export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, a as SessionManager, c as captureCorrelationId, g as getDateString, b as getOrigin } from './correlation-id-CelUvw7j.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-B0txjNut.cjs';
+import { S as SideEffectOperationKind, a as SideEffectOperationStatus, b as SideEffectOperationPhase, c as SideEffectSemanticFieldKey } from './index.d-3-cJoY8y.cjs';
+export { e as SideEffectOmissionReason, f as SideEffectSemanticFieldStableCoreKey, d as deriveSessionId, i as isSideEffectSemanticFieldKey } from './index.d-3-cJoY8y.cjs';
 export { RequestMiddlewareFunction, TracedRequestMiddlewareOptions } from './middleware/index.cjs';
 export { WithAsyncCausalityOptions } from './async-context/index.cjs';
 import './export/ReadableSpan';
@@ -71,6 +71,39 @@ interface RecordSideEffectInput {
      * omission counter.
      */
     fields?: Partial<Record<SideEffectSemanticFieldKey, string>>;
+    /**
+     * Optional value-fidelity scalars emitted on the off-summary
+     * `glasstrace.side_effect.scalar.*` channel. Keys must be camelCase
+     * ending in `Ms` / `Amount` / `Bytes` / `Ratio` / `Id` / `Value` /
+     * `Flag` (`Count` routes to the categorical `fields` channel instead).
+     * Values are native `number` / `boolean` / `string`.
+     *
+     * Under the default `strict` capture posture the SDK rejects raw
+     * wall-clock timestamps (a `Date`, or a raw epoch on a `*Ms` key) and
+     * unhashed `*Id` values at emit time — send bounded deltas as numbers,
+     * and pre-hash identifiers with `hashId` (`@glasstrace/sdk/node`). At
+     * most
+     * {@link MAX_SIDE_EFFECT_SCALARS_PER_OPERATION} scalars are recorded
+     * per call; rejected values route to the matching omission counter and
+     * the raw value never reaches the wire. The same key may also appear
+     * in `fields` — the two channels are distinct (selected by attribute
+     * prefix), so a categorical and a scalar facet can share a name.
+     */
+    scalars?: Record<string, unknown>;
+    /**
+     * Optional producer-asserted boolean relations (invariants) emitted on
+     * the categorical field channel. Keys must be camelCase ending in
+     * `Holds` (e.g. `timezonePreservedHolds`); values are real `boolean`s,
+     * coerced to `"true"`/`"false"` on the wire. A non-`Holds` key, a
+     * non-boolean value, or a key already attached by `fields` (a
+     * same-channel collision — `fields` wins) is dropped with the matching
+     * omission counter. Relations count against the same product-side
+     * per-operation field budget as `fields` (enforced at projection).
+     *
+     * Use {@link invariant} / {@link isNullInvariant} to compute the
+     * boolean from a comparison.
+     */
+    relations?: Record<string, boolean>;
 }
 /**
  * Record allowlisted side-effect evidence on the current active OTel
@@ -114,9 +147,73 @@ interface RecordSideEffectInput {
  *     locale: "en-US",
  *     timezone: "Europe/Paris",
  *   },
+ *   scalars: {
+ *     // Bounded delta (not a wall-clock epoch) and a boolean flag.
+ *     renderMs: 42,
+ *     hadAttachmentFlag: false,
+ *   },
  * });
  * ```
  */
 declare function recordSideEffect(input: RecordSideEffectInput): void;
 
-export { type RecordSideEffectInput, SideEffectOperationKind, SideEffectOperationPhase, SideEffectOperationStatus, SideEffectSemanticFieldKey, recordSideEffect };
+/**
+ * Producer-sugar for computing boolean relations to emit as `*Holds`
+ * side-effect evidence.
+ *
+ * These helpers turn a comparison into the boolean a producer passes to
+ * `recordSideEffect({ relations: { …Holds: invariant(a, "eq", b) } })`.
+ * They are pure (no I/O, no Node built-ins) and edge-safe, so they live
+ * on the root barrel. The operator set is intentionally minimal and
+ * fixed — six binary comparisons plus a separate unary null check — and
+ * is not a general expression DSL.
+ */
+/**
+ * The six supported binary comparison operators. `isNull` is **not** an
+ * operator here — use {@link isNullInvariant} for the unary case.
+ */
+type InvariantOp = "eq" | "neq" | "lt" | "lte" | "gt" | "gte";
+/**
+ * Evaluate a binary comparison invariant and return the boolean result.
+ *
+ * Both operands are constrained to the same primitive type. `eq`/`neq`
+ * use strict equality; the ordering operators (`lt`/`lte`/`gt`/`gte`)
+ * use the language relational operators (numeric for numbers/bigints,
+ * lexical for strings). Intended for producing a `*Holds` relation, e.g.
+ * `invariant(emittedDurationMinutes, "eq", declaredDurationMinutes)`.
+ *
+ * Operands should be comparable primitives. `NaN` follows IEEE-754
+ * (unequal to everything; all orderings `false`), so screen `NaN` before
+ * asserting a relation. Passing a non-primitive (e.g. a `Symbol`, or an
+ * object with a throwing `valueOf`) to an ordering operator throws per
+ * JS semantics — the type signature prevents this for typed callers.
+ *
+ * @param left - The left operand.
+ * @param op - One of the six {@link InvariantOp} comparisons.
+ * @param right - The right operand (same primitive type as `left`).
+ * @returns The boolean result of `left <op> right`.
+ *
+ * @example
+ * recordSideEffect({
+ *   kind: "calendar_link",
+ *   operation: "invite.create",
+ *   relations: {
+ *     durationMatchesHolds: invariant(emittedMinutes, "eq", declaredMinutes),
+ *   },
+ * });
+ */
+declare function invariant<T extends number | string | bigint | boolean>(left: T, op: InvariantOp, right: T): boolean;
+/**
+ * Unary null/undefined invariant — `true` when `value` is `null` or
+ * `undefined`. Kept separate from {@link invariant} because nullishness
+ * is a unary predicate, not a binary comparison (there is no `isNull`
+ * operator). Use for a `*Holds` relation asserting a value's absence,
+ * e.g. `relations: { recipientMissingHolds: isNullInvariant(recipient) }`.
+ *
+ * @param value - The value to test.
+ * @returns `true` when `value` is `null` or `undefined`, else `false`
+ *   (falsy-but-present values like `0`, `""`, `false`, `NaN` are `false`).
+ */
+declare function isNullInvariant(value: unknown): boolean;
+
+export { type InvariantOp, type RecordSideEffectInput, SideEffectOperationKind, SideEffectOperationPhase, SideEffectOperationStatus, SideEffectSemanticFieldKey, invariant, isNullInvariant, recordSideEffect };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, a as SessionManager, c as captureCorrelationId, g as getDateString, b as getOrigin } from './correlation-id-YcfcqOru.js';
-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-CAfFUyIU.js';
-import { S as SideEffectOperationKind, a as SideEffectOperationStatus, b as SideEffectOperationPhase, c as SideEffectSemanticFieldKey } from './index.d-BQIJ5Dvc.js';
-export { e as SideEffectOmissionReason, f as SideEffectSemanticFieldStableCoreKey, d as deriveSessionId, i as isSideEffectSemanticFieldKey } from './index.d-BQIJ5Dvc.js';
+export { C as CorrelationIdRequest, G as GlasstraceSpanProcessor, S as SdkError, a as SessionManager, c as captureCorrelationId, g as getDateString, b as getOrigin } from './correlation-id-B9YYmoZw.js';
+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-Dc01rYNR.js';
+import { S as SideEffectOperationKind, a as SideEffectOperationStatus, b as SideEffectOperationPhase, c as SideEffectSemanticFieldKey } from './index.d-3-cJoY8y.js';
+export { e as SideEffectOmissionReason, f as SideEffectSemanticFieldStableCoreKey, d as deriveSessionId, i as isSideEffectSemanticFieldKey } from './index.d-3-cJoY8y.js';
 export { RequestMiddlewareFunction, TracedRequestMiddlewareOptions } from './middleware/index.js';
 export { WithAsyncCausalityOptions } from './async-context/index.js';
 import './export/ReadableSpan';
@@ -71,6 +71,39 @@ interface RecordSideEffectInput {
      * omission counter.
      */
     fields?: Partial<Record<SideEffectSemanticFieldKey, string>>;
+    /**
+     * Optional value-fidelity scalars emitted on the off-summary
+     * `glasstrace.side_effect.scalar.*` channel. Keys must be camelCase
+     * ending in `Ms` / `Amount` / `Bytes` / `Ratio` / `Id` / `Value` /
+     * `Flag` (`Count` routes to the categorical `fields` channel instead).
+     * Values are native `number` / `boolean` / `string`.
+     *
+     * Under the default `strict` capture posture the SDK rejects raw
+     * wall-clock timestamps (a `Date`, or a raw epoch on a `*Ms` key) and
+     * unhashed `*Id` values at emit time — send bounded deltas as numbers,
+     * and pre-hash identifiers with `hashId` (`@glasstrace/sdk/node`). At
+     * most
+     * {@link MAX_SIDE_EFFECT_SCALARS_PER_OPERATION} scalars are recorded
+     * per call; rejected values route to the matching omission counter and
+     * the raw value never reaches the wire. The same key may also appear
+     * in `fields` — the two channels are distinct (selected by attribute
+     * prefix), so a categorical and a scalar facet can share a name.
+     */
+    scalars?: Record<string, unknown>;
+    /**
+     * Optional producer-asserted boolean relations (invariants) emitted on
+     * the categorical field channel. Keys must be camelCase ending in
+     * `Holds` (e.g. `timezonePreservedHolds`); values are real `boolean`s,
+     * coerced to `"true"`/`"false"` on the wire. A non-`Holds` key, a
+     * non-boolean value, or a key already attached by `fields` (a
+     * same-channel collision — `fields` wins) is dropped with the matching
+     * omission counter. Relations count against the same product-side
+     * per-operation field budget as `fields` (enforced at projection).
+     *
+     * Use {@link invariant} / {@link isNullInvariant} to compute the
+     * boolean from a comparison.
+     */
+    relations?: Record<string, boolean>;
 }
 /**
  * Record allowlisted side-effect evidence on the current active OTel
@@ -114,9 +147,73 @@ interface RecordSideEffectInput {
  *     locale: "en-US",
  *     timezone: "Europe/Paris",
  *   },
+ *   scalars: {
+ *     // Bounded delta (not a wall-clock epoch) and a boolean flag.
+ *     renderMs: 42,
+ *     hadAttachmentFlag: false,
+ *   },
  * });
  * ```
  */
 declare function recordSideEffect(input: RecordSideEffectInput): void;
 
-export { type RecordSideEffectInput, SideEffectOperationKind, SideEffectOperationPhase, SideEffectOperationStatus, SideEffectSemanticFieldKey, recordSideEffect };
+/**
+ * Producer-sugar for computing boolean relations to emit as `*Holds`
+ * side-effect evidence.
+ *
+ * These helpers turn a comparison into the boolean a producer passes to
+ * `recordSideEffect({ relations: { …Holds: invariant(a, "eq", b) } })`.
+ * They are pure (no I/O, no Node built-ins) and edge-safe, so they live
+ * on the root barrel. The operator set is intentionally minimal and
+ * fixed — six binary comparisons plus a separate unary null check — and
+ * is not a general expression DSL.
+ */
+/**
+ * The six supported binary comparison operators. `isNull` is **not** an
+ * operator here — use {@link isNullInvariant} for the unary case.
+ */
+type InvariantOp = "eq" | "neq" | "lt" | "lte" | "gt" | "gte";
+/**
+ * Evaluate a binary comparison invariant and return the boolean result.
+ *
+ * Both operands are constrained to the same primitive type. `eq`/`neq`
+ * use strict equality; the ordering operators (`lt`/`lte`/`gt`/`gte`)
+ * use the language relational operators (numeric for numbers/bigints,
+ * lexical for strings). Intended for producing a `*Holds` relation, e.g.
+ * `invariant(emittedDurationMinutes, "eq", declaredDurationMinutes)`.
+ *
+ * Operands should be comparable primitives. `NaN` follows IEEE-754
+ * (unequal to everything; all orderings `false`), so screen `NaN` before
+ * asserting a relation. Passing a non-primitive (e.g. a `Symbol`, or an
+ * object with a throwing `valueOf`) to an ordering operator throws per
+ * JS semantics — the type signature prevents this for typed callers.
+ *
+ * @param left - The left operand.
+ * @param op - One of the six {@link InvariantOp} comparisons.
+ * @param right - The right operand (same primitive type as `left`).
+ * @returns The boolean result of `left <op> right`.
+ *
+ * @example
+ * recordSideEffect({
+ *   kind: "calendar_link",
+ *   operation: "invite.create",
+ *   relations: {
+ *     durationMatchesHolds: invariant(emittedMinutes, "eq", declaredMinutes),
+ *   },
+ * });
+ */
+declare function invariant<T extends number | string | bigint | boolean>(left: T, op: InvariantOp, right: T): boolean;
+/**
+ * Unary null/undefined invariant — `true` when `value` is `null` or
+ * `undefined`. Kept separate from {@link invariant} because nullishness
+ * is a unary predicate, not a binary comparison (there is no `isNull`
+ * operator). Use for a `*Holds` relation asserting a value's absence,
+ * e.g. `relations: { recipientMissingHolds: isNullInvariant(recipient) }`.
+ *
+ * @param value - The value to test.
+ * @returns `true` when `value` is `null` or `undefined`, else `false`
+ *   (falsy-but-present values like `0`, `""`, `false`, `NaN` are `false`).
+ */
+declare function isNullInvariant(value: unknown): boolean;
+
+export { type InvariantOp, type RecordSideEffectInput, SideEffectOperationKind, SideEffectOperationPhase, SideEffectOperationStatus, SideEffectSemanticFieldKey, invariant, isNullInvariant, recordSideEffect };

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   recordSideEffect,
   registerGlasstrace,
   withGlasstraceConfig
-} from "./chunk-T4ETJJSK.js";
+} from "./chunk-F2IPBTDJ.js";
 import {
   getStatus,
   isReady,
@@ -20,7 +20,7 @@ import {
   GlasstraceSpanProcessor,
   SdkError,
   captureCorrelationId
-} from "./chunk-HMEHYSTS.js";
+} from "./chunk-EVX6D2TX.js";
 import "./chunk-CL3OVHPO.js";
 import "./chunk-DQ25VOKK.js";
 import "./chunk-YG3X7TUI.js";
@@ -31,7 +31,7 @@ import {
   performInit,
   saveCachedConfig,
   sendInitRequest
-} from "./chunk-6ST4QV7T.js";
+} from "./chunk-VEQX2YSQ.js";
 import {
   isAnonymousMode,
   isProductionDisabled,
@@ -41,13 +41,36 @@ import {
 import {
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-F7A3QXCT.js";
+} from "./chunk-UOAG72NR.js";
 import {
   deriveSessionId,
   isSideEffectSemanticFieldKey
-} from "./chunk-7LE2O4ZJ.js";
+} from "./chunk-MKT54VEH.js";
 import "./chunk-YIEXKQYP.js";
 import "./chunk-NSBPE2FW.js";
+
+// src/side-effect/invariant.ts
+function invariant(left, op, right) {
+  switch (op) {
+    case "eq":
+      return left === right;
+    case "neq":
+      return left !== right;
+    case "lt":
+      return left < right;
+    case "lte":
+      return left <= right;
+    case "gt":
+      return left > right;
+    case "gte":
+      return left >= right;
+  }
+  op;
+  return false;
+}
+function isNullInvariant(value) {
+  return value === null || value === void 0;
+}
 export {
   GlasstraceExporter,
   GlasstraceSpanProcessor,
@@ -65,7 +88,9 @@ export {
   getOrCreateAnonKey,
   getOrigin,
   getStatus,
+  invariant,
   isAnonymousMode,
+  isNullInvariant,
   isProductionDisabled,
   isReady,
   isSideEffectSemanticFieldKey,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/side-effect/invariant.ts"],"sourcesContent":["/**\n * Producer-sugar for computing boolean relations to emit as `*Holds`\n * side-effect evidence.\n *\n * These helpers turn a comparison into the boolean a producer passes to\n * `recordSideEffect({ relations: { …Holds: invariant(a, \"eq\", b) } })`.\n * They are pure (no I/O, no Node built-ins) and edge-safe, so they live\n * on the root barrel. The operator set is intentionally minimal and\n * fixed — six binary comparisons plus a separate unary null check — and\n * is not a general expression DSL.\n */\n\n/**\n * The six supported binary comparison operators. `isNull` is **not** an\n * operator here — use {@link isNullInvariant} for the unary case.\n */\nexport type InvariantOp = \"eq\" | \"neq\" | \"lt\" | \"lte\" | \"gt\" | \"gte\";\n\n/**\n * Evaluate a binary comparison invariant and return the boolean result.\n *\n * Both operands are constrained to the same primitive type. `eq`/`neq`\n * use strict equality; the ordering operators (`lt`/`lte`/`gt`/`gte`)\n * use the language relational operators (numeric for numbers/bigints,\n * lexical for strings). Intended for producing a `*Holds` relation, e.g.\n * `invariant(emittedDurationMinutes, \"eq\", declaredDurationMinutes)`.\n *\n * Operands should be comparable primitives. `NaN` follows IEEE-754\n * (unequal to everything; all orderings `false`), so screen `NaN` before\n * asserting a relation. Passing a non-primitive (e.g. a `Symbol`, or an\n * object with a throwing `valueOf`) to an ordering operator throws per\n * JS semantics — the type signature prevents this for typed callers.\n *\n * @param left - The left operand.\n * @param op - One of the six {@link InvariantOp} comparisons.\n * @param right - The right operand (same primitive type as `left`).\n * @returns The boolean result of `left <op> right`.\n *\n * @example\n * recordSideEffect({\n *   kind: \"calendar_link\",\n *   operation: \"invite.create\",\n *   relations: {\n *     durationMatchesHolds: invariant(emittedMinutes, \"eq\", declaredMinutes),\n *   },\n * });\n */\nexport function invariant<T extends number | string | bigint | boolean>(\n  left: T,\n  op: InvariantOp,\n  right: T,\n): boolean {\n  switch (op) {\n    case \"eq\":\n      return left === right;\n    case \"neq\":\n      return left !== right;\n    case \"lt\":\n      return left < right;\n    case \"lte\":\n      return left <= right;\n    case \"gt\":\n      return left > right;\n    case \"gte\":\n      return left >= right;\n  }\n  // For well-typed callers `op` is `never` here, so this `satisfies`\n  // enforces switch exhaustiveness at compile time (adding an\n  // `InvariantOp` member without a case is a type error). The `return`\n  // is the runtime fallback for an untyped (JS) caller passing an\n  // out-of-domain op — it yields a `boolean`, never `undefined`.\n  op satisfies never;\n  return false;\n}\n\n/**\n * Unary null/undefined invariant — `true` when `value` is `null` or\n * `undefined`. Kept separate from {@link invariant} because nullishness\n * is a unary predicate, not a binary comparison (there is no `isNull`\n * operator). Use for a `*Holds` relation asserting a value's absence,\n * e.g. `relations: { recipientMissingHolds: isNullInvariant(recipient) }`.\n *\n * @param value - The value to test.\n * @returns `true` when `value` is `null` or `undefined`, else `false`\n *   (falsy-but-present values like `0`, `\"\"`, `false`, `NaN` are `false`).\n */\nexport function isNullInvariant(value: unknown): boolean {\n  return value === null || value === undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CO,SAAS,UACd,MACA,IACA,OACS;AACT,UAAQ,IAAI;AAAA,IACV,KAAK;AACH,aAAO,SAAS;AAAA,IAClB,KAAK;AACH,aAAO,SAAS;AAAA,IAClB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,QAAQ;AAAA,EACnB;AAMA;AACA,SAAO;AACT;AAaO,SAAS,gBAAgB,OAAyB;AACvD,SAAO,UAAU,QAAQ,UAAU;AACrC;","names":[]}

package/dist/middleware/index.cjs

@@ -15294,7 +15294,20 @@ var CaptureConfigSchema = external_exports.object({
    * client-side allowlist enforcement layered with the product's
    * storage-time filter as defense-in-depth.
    */
-  sideEffectEvidence: external_exports.boolean().optional().default(false)
+  sideEffectEvidence: external_exports.boolean().optional().default(false),
+  /**
+   * Per-account value-fidelity capture posture (server-pushed).
+   *
+   * `strict` (default) is fail-closed: the SDK rejects raw wall-clock
+   * timestamps and unhashed identifiers from the `scalar.*` channel at
+   * emit time. `full` relaxes those rejections so raw magnitudes can be
+   * surfaced — but only in conjunction with an explicit producer opt-in
+   * (so a `full`-configured account still emits strict-shaped scalars
+   * unless the producer also opts in). The operator owns this flag; it
+   * is never derived from producer or request input. Absent on the wire
+   * ⇒ `strict`.
+   */
+  captureFidelity: external_exports.enum(["strict", "full"]).optional().default("strict")
 });
 var SdkCachedConfigSchema = external_exports.object({
   response: external_exports.record(external_exports.string(), external_exports.unknown()),
@@ -15485,7 +15498,13 @@ var GLASSTRACE_ATTRIBUTE_NAMES = {
   SIDE_EFFECT_OMITTED_UNSUPPORTED_KEY: "glasstrace.side_effect.omitted.unsupported_key",
   SIDE_EFFECT_OMITTED_VALUE_TOO_LONG: "glasstrace.side_effect.omitted.value_too_long",
   SIDE_EFFECT_OMITTED_NOT_EMITTED: "glasstrace.side_effect.omitted.not_emitted",
-  SIDE_EFFECT_OMITTED_CAPTURE_DISABLED: "glasstrace.side_effect.omitted.capture_disabled"
+  SIDE_EFFECT_OMITTED_CAPTURE_DISABLED: "glasstrace.side_effect.omitted.capture_disabled",
+  // Value-fidelity scalar-channel omission reasons. Counts only; the
+  // rejected raw value (timestamp, unhashed id, non-finite number) is
+  // never echoed. Mirror the product omission enum verbatim.
+  SIDE_EFFECT_OMITTED_RAW_TIMESTAMP: "glasstrace.side_effect.omitted.raw_timestamp",
+  SIDE_EFFECT_OMITTED_UNHASHED_ID: "glasstrace.side_effect.omitted.unhashed_id",
+  SIDE_EFFECT_OMITTED_NON_FINITE: "glasstrace.side_effect.omitted.non_finite"
 };
 var MAX_SOURCE_MAP_FILE_PATH_LENGTH = 512;
 var MAX_SOURCE_MAP_FILE_SIZE = 50 * 1024 * 1024;