@glasstrace/sdk 1.15.1 → 1.16.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,25 @@ 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>;
 }
 /**
  * Record allowlisted side-effect evidence on the current active OTel
@@ -114,6 +133,11 @@ interface RecordSideEffectInput {
  *     locale: "en-US",
  *     timezone: "Europe/Paris",
  *   },
+ *   scalars: {
+ *     // Bounded delta (not a wall-clock epoch) and a boolean flag.
+ *     renderMs: 42,
+ *     hadAttachmentFlag: false,
+ *   },
  * });
  * ```
  */

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,25 @@ 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>;
 }
 /**
  * Record allowlisted side-effect evidence on the current active OTel
@@ -114,6 +133,11 @@ interface RecordSideEffectInput {
  *     locale: "en-US",
  *     timezone: "Europe/Paris",
  *   },
+ *   scalars: {
+ *     // Bounded delta (not a wall-clock epoch) and a boolean flag.
+ *     renderMs: 42,
+ *     hadAttachmentFlag: false,
+ *   },
  * });
  * ```
  */

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   recordSideEffect,
   registerGlasstrace,
   withGlasstraceConfig
-} from "./chunk-T4ETJJSK.js";
+} from "./chunk-EWW3TZ52.js";
 import {
   getStatus,
   isReady,
@@ -20,7 +20,7 @@ import {
   GlasstraceSpanProcessor,
   SdkError,
   captureCorrelationId
-} from "./chunk-HMEHYSTS.js";
+} from "./chunk-KM4UNN3Q.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-T7B752NF.js";
 import {
   isAnonymousMode,
   isProductionDisabled,
@@ -41,11 +41,11 @@ import {
 import {
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-F7A3QXCT.js";
+} from "./chunk-774XIOZG.js";
 import {
   deriveSessionId,
   isSideEffectSemanticFieldKey
-} from "./chunk-7LE2O4ZJ.js";
+} from "./chunk-GBVMPMVV.js";
 import "./chunk-YIEXKQYP.js";
 import "./chunk-NSBPE2FW.js";
 export {

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;