@edraj/sauron-browser 1.0.0 → 1.3.0

package/dist/index.d.cts

@@ -74,6 +74,13 @@ interface ErrorItem {
      */
     user?: UserContext | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     screen?: string | null;
 }
 /** A product-analytics event (PostHog-style `track`). */
@@ -82,6 +89,13 @@ interface EventItem {
     name: string;
     distinct_id: string | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     screen?: string | null;
     timestamp: string;
     properties: Record<string, unknown>;
@@ -108,6 +122,13 @@ interface TransactionItem {
     url?: string | null;
     distinct_id?: string | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     timestamp: string;
 }
 /** An identity association (PostHog-style `identify`). */
@@ -163,7 +184,6 @@ interface EnvelopeHeader {
     dsn: string;
     sdk: SdkInfo;
     sent_at: string;
-    environment: string;
     release: string | null;
 }
 /** The complete, serializable envelope posted to the ingest gateway. */
@@ -191,6 +211,25 @@ interface CaptureOptions {
 interface TrackOptions extends CaptureOptions {
     screen?: string;
 }
+/**
+ * Outcome of `startWorkflow` / `endWorkflow` / `cancelWorkflow`. Telemetry
+ * never throws — every call resolves to one of these instead.
+ */
+type WorkflowStatus = 'ok' | 'already_active' | 'not_active' | 'name_mismatch' | 'invalid_name' | 'disabled';
+/** Result of a workflow lifecycle call. */
+interface WorkflowResult {
+    status: WorkflowStatus;
+    /** The workflow id involved, when `status` is `'ok'`. */
+    workflowId?: string;
+}
+/** The currently-active workflow, as returned by `getWorkflow()`. */
+interface ActiveWorkflow {
+    /** Client-generated UUID — the server rollup key is `(app_id, workflow_id)`. */
+    workflowId: string;
+    name: string;
+    /** ISO-8601 UTC timestamp of `startWorkflow()`. */
+    startedAt: string;
+}
 /** Value accepted by `setUser` — normalized into a `UserContext`. */
 type UserInput = (Partial<UserContext> & {
     id?: string | null;
@@ -211,7 +250,6 @@ interface TransportOptions {
 interface InitOptions {
     /** `https://<public_key>@<host>/<project_id>` */
     dsn: string;
-    environment?: string;
     release?: string;
     /** Error sample rate in [0, 1]. Default 1 (send everything). */
     sampleRate?: number;
@@ -244,7 +282,6 @@ interface InitOptions {
 /** Fully-resolved options with all defaults applied. */
 interface ResolvedOptions {
     dsn: string;
-    environment: string;
     release: string | null;
     sampleRate: number;
     maxBreadcrumbs: number;
@@ -361,6 +398,17 @@ declare class SauronClient {
     /** Install global handlers + auto-instrumentation and start the transport. */
     install(): void;
     getScope(): Scope;
+    /**
+     * False once this client was explicitly disabled/closed, OR once the
+     * transport has auto-disabled itself on a 401/403 (revoked/invalid DSN
+     * key) — computed from the transport's own state on every call, not a
+     * separately mirrored flag, so a propagation regression there cannot leave
+     * this predicate stale. `this.transport` always exists once a client
+     * exists (it is constructed synchronously in the constructor); the
+     * "nothing installed yet" case is instead handled one layer up, by every
+     * module-level API (`startWorkflow`, `track`, ...) treating `getClient() ===
+     * null` as the no-op/disabled case before it ever reaches here.
+     */
     isEnabled(): boolean;
     /** The current distinct id: the user id when identified, else an anon id. */
     getDistinctId(): string | null;
@@ -379,6 +427,23 @@ declare class SauronClient {
      * `event_id` is always minted so callers can correlate the report.
      */
     private enrichErrorItem;
+    /**
+     * Stamp the active workflow (if any) onto a signal item.
+     *
+     * Done HERE — the single choke point every capture path funnels through —
+     * rather than at each item-construction site, so a capture path added later
+     * is stamped by construction instead of by remembering to. The keys are
+     * ASSIGNED ONLY when a workflow is active: an item with no workflow keeps
+     * them absent entirely (not present-as-`undefined`), which is what makes
+     * `JSON.stringify` omit them and keeps the no-workflow wire bytes identical
+     * to pre-1.3.0.
+     *
+     * Only error/event/transaction carry `workflow_id`/`workflow_name` columns
+     * server-side — identify and breadcrumb_batch items are deliberately left
+     * alone. An item that already carries an explicit `workflow_id` is left
+     * untouched, matching how `enrichErrorItem` defers to caller-set fields.
+     */
+    private stampWorkflow;
     /**
      * Run an item through sampling (errors only) and `beforeSend`, then hand it to
      * the transport. Returns silently when dropped.
@@ -421,7 +486,7 @@ declare function parseError(err: unknown): Frame[];
 /** Small dependency-free helpers shared across the SDK. */
 /** SDK identity, embedded in every envelope header. */
 declare const SDK_NAME = "sauron.javascript";
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.3.0";
 
 /**
  * `@edraj/sauron-browser` — public API surface.
@@ -452,6 +517,23 @@ declare function trackTransaction(input: TransactionInput): void;
 declare function setScreen(name: string): void;
 /** The current screen name, or null. */
 declare function getScreen(): string | null;
+/**
+ * Start a named, explicitly-bounded workflow. `workflow_id` is a fresh
+ * client-generated UUID; the id + name are then stamped on every subsequent
+ * event/error/transaction until the workflow ends or is cancelled. Optional —
+ * an app that never calls this behaves exactly as before.
+ */
+declare function startWorkflow(name: string, options?: {
+    force?: boolean;
+}): WorkflowResult;
+/** End the active workflow (or the one named `name`, if given). */
+declare function endWorkflow(name?: string): WorkflowResult;
+/** Cancel the active workflow (or the one named `name`, if given). */
+declare function cancelWorkflow(name?: string, options?: {
+    reason?: string;
+}): WorkflowResult;
+/** The currently active workflow, or `null` when none is active. */
+declare function getWorkflow(): ActiveWorkflow | null;
 /** Record a breadcrumb. */
 declare function addBreadcrumb(breadcrumb: BreadcrumbInput, hint?: Hint): void;
 /** Set (or clear, with `null`) the current user. */
@@ -485,9 +567,13 @@ declare const Sauron: {
     setExtra: typeof setExtra;
     setScreen: typeof setScreen;
     getScreen: typeof getScreen;
+    startWorkflow: typeof startWorkflow;
+    endWorkflow: typeof endWorkflow;
+    cancelWorkflow: typeof cancelWorkflow;
+    getWorkflow: typeof getWorkflow;
     flush: typeof flush;
     close: typeof close;
     getClient: typeof getClient;
 };
 
-export { type AppContext, type BeforeBreadcrumb, type BeforeSend, type Breadcrumb, type BreadcrumbBatchItem, type BreadcrumbInput, type CaptureOptions, type Context, type DeviceContext, type Dsn, DsnError, type Envelope, type EnvelopeHeader, type EnvelopeItem, type ErrorItem, type EventItem, type ExceptionValue, type Frame, type Hint, type IdentifyItem, type InitOptions, type ItemType, type Level, type Mechanism, type OsContext, type ResolvedOptions, type RuntimeContext, SDK_NAME, SDK_VERSION, Sauron, SauronClient, type SdkInfo, type TrackOptions, type TransactionInput, type TransactionItem, type TransactionOp, type TransportOptions, type UserContext, type UserInput, addBreadcrumb, buildEnvelope, captureException, captureMessage, close, Sauron as default, flush, getClient, getScreen, identify, init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen, setTag, setTags, setUser, track, trackTransaction };
+export { type ActiveWorkflow, type AppContext, type BeforeBreadcrumb, type BeforeSend, type Breadcrumb, type BreadcrumbBatchItem, type BreadcrumbInput, type CaptureOptions, type Context, type DeviceContext, type Dsn, DsnError, type Envelope, type EnvelopeHeader, type EnvelopeItem, type ErrorItem, type EventItem, type ExceptionValue, type Frame, type Hint, type IdentifyItem, type InitOptions, type ItemType, type Level, type Mechanism, type OsContext, type ResolvedOptions, type RuntimeContext, SDK_NAME, SDK_VERSION, Sauron, SauronClient, type SdkInfo, type TrackOptions, type TransactionInput, type TransactionItem, type TransactionOp, type TransportOptions, type UserContext, type UserInput, type WorkflowResult, type WorkflowStatus, addBreadcrumb, buildEnvelope, cancelWorkflow, captureException, captureMessage, close, Sauron as default, endWorkflow, flush, getClient, getScreen, getWorkflow, identify, init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen, setTag, setTags, setUser, startWorkflow, track, trackTransaction };

package/dist/index.d.ts

@@ -74,6 +74,13 @@ interface ErrorItem {
      */
     user?: UserContext | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     screen?: string | null;
 }
 /** A product-analytics event (PostHog-style `track`). */
@@ -82,6 +89,13 @@ interface EventItem {
     name: string;
     distinct_id: string | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     screen?: string | null;
     timestamp: string;
     properties: Record<string, unknown>;
@@ -108,6 +122,13 @@ interface TransactionItem {
     url?: string | null;
     distinct_id?: string | null;
     session_id?: string | null;
+    /**
+     * The active workflow this item was stamped with, if any. A pair —
+     * always both present or both absent, never one without the other. See
+     * {@link ActiveWorkflow}.
+     */
+    workflow_id?: string;
+    workflow_name?: string;
     timestamp: string;
 }
 /** An identity association (PostHog-style `identify`). */
@@ -163,7 +184,6 @@ interface EnvelopeHeader {
     dsn: string;
     sdk: SdkInfo;
     sent_at: string;
-    environment: string;
     release: string | null;
 }
 /** The complete, serializable envelope posted to the ingest gateway. */
@@ -191,6 +211,25 @@ interface CaptureOptions {
 interface TrackOptions extends CaptureOptions {
     screen?: string;
 }
+/**
+ * Outcome of `startWorkflow` / `endWorkflow` / `cancelWorkflow`. Telemetry
+ * never throws — every call resolves to one of these instead.
+ */
+type WorkflowStatus = 'ok' | 'already_active' | 'not_active' | 'name_mismatch' | 'invalid_name' | 'disabled';
+/** Result of a workflow lifecycle call. */
+interface WorkflowResult {
+    status: WorkflowStatus;
+    /** The workflow id involved, when `status` is `'ok'`. */
+    workflowId?: string;
+}
+/** The currently-active workflow, as returned by `getWorkflow()`. */
+interface ActiveWorkflow {
+    /** Client-generated UUID — the server rollup key is `(app_id, workflow_id)`. */
+    workflowId: string;
+    name: string;
+    /** ISO-8601 UTC timestamp of `startWorkflow()`. */
+    startedAt: string;
+}
 /** Value accepted by `setUser` — normalized into a `UserContext`. */
 type UserInput = (Partial<UserContext> & {
     id?: string | null;
@@ -211,7 +250,6 @@ interface TransportOptions {
 interface InitOptions {
     /** `https://<public_key>@<host>/<project_id>` */
     dsn: string;
-    environment?: string;
     release?: string;
     /** Error sample rate in [0, 1]. Default 1 (send everything). */
     sampleRate?: number;
@@ -244,7 +282,6 @@ interface InitOptions {
 /** Fully-resolved options with all defaults applied. */
 interface ResolvedOptions {
     dsn: string;
-    environment: string;
     release: string | null;
     sampleRate: number;
     maxBreadcrumbs: number;
@@ -361,6 +398,17 @@ declare class SauronClient {
     /** Install global handlers + auto-instrumentation and start the transport. */
     install(): void;
     getScope(): Scope;
+    /**
+     * False once this client was explicitly disabled/closed, OR once the
+     * transport has auto-disabled itself on a 401/403 (revoked/invalid DSN
+     * key) — computed from the transport's own state on every call, not a
+     * separately mirrored flag, so a propagation regression there cannot leave
+     * this predicate stale. `this.transport` always exists once a client
+     * exists (it is constructed synchronously in the constructor); the
+     * "nothing installed yet" case is instead handled one layer up, by every
+     * module-level API (`startWorkflow`, `track`, ...) treating `getClient() ===
+     * null` as the no-op/disabled case before it ever reaches here.
+     */
     isEnabled(): boolean;
     /** The current distinct id: the user id when identified, else an anon id. */
     getDistinctId(): string | null;
@@ -379,6 +427,23 @@ declare class SauronClient {
      * `event_id` is always minted so callers can correlate the report.
      */
     private enrichErrorItem;
+    /**
+     * Stamp the active workflow (if any) onto a signal item.
+     *
+     * Done HERE — the single choke point every capture path funnels through —
+     * rather than at each item-construction site, so a capture path added later
+     * is stamped by construction instead of by remembering to. The keys are
+     * ASSIGNED ONLY when a workflow is active: an item with no workflow keeps
+     * them absent entirely (not present-as-`undefined`), which is what makes
+     * `JSON.stringify` omit them and keeps the no-workflow wire bytes identical
+     * to pre-1.3.0.
+     *
+     * Only error/event/transaction carry `workflow_id`/`workflow_name` columns
+     * server-side — identify and breadcrumb_batch items are deliberately left
+     * alone. An item that already carries an explicit `workflow_id` is left
+     * untouched, matching how `enrichErrorItem` defers to caller-set fields.
+     */
+    private stampWorkflow;
     /**
      * Run an item through sampling (errors only) and `beforeSend`, then hand it to
      * the transport. Returns silently when dropped.
@@ -421,7 +486,7 @@ declare function parseError(err: unknown): Frame[];
 /** Small dependency-free helpers shared across the SDK. */
 /** SDK identity, embedded in every envelope header. */
 declare const SDK_NAME = "sauron.javascript";
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.3.0";
 
 /**
  * `@edraj/sauron-browser` — public API surface.
@@ -452,6 +517,23 @@ declare function trackTransaction(input: TransactionInput): void;
 declare function setScreen(name: string): void;
 /** The current screen name, or null. */
 declare function getScreen(): string | null;
+/**
+ * Start a named, explicitly-bounded workflow. `workflow_id` is a fresh
+ * client-generated UUID; the id + name are then stamped on every subsequent
+ * event/error/transaction until the workflow ends or is cancelled. Optional —
+ * an app that never calls this behaves exactly as before.
+ */
+declare function startWorkflow(name: string, options?: {
+    force?: boolean;
+}): WorkflowResult;
+/** End the active workflow (or the one named `name`, if given). */
+declare function endWorkflow(name?: string): WorkflowResult;
+/** Cancel the active workflow (or the one named `name`, if given). */
+declare function cancelWorkflow(name?: string, options?: {
+    reason?: string;
+}): WorkflowResult;
+/** The currently active workflow, or `null` when none is active. */
+declare function getWorkflow(): ActiveWorkflow | null;
 /** Record a breadcrumb. */
 declare function addBreadcrumb(breadcrumb: BreadcrumbInput, hint?: Hint): void;
 /** Set (or clear, with `null`) the current user. */
@@ -485,9 +567,13 @@ declare const Sauron: {
     setExtra: typeof setExtra;
     setScreen: typeof setScreen;
     getScreen: typeof getScreen;
+    startWorkflow: typeof startWorkflow;
+    endWorkflow: typeof endWorkflow;
+    cancelWorkflow: typeof cancelWorkflow;
+    getWorkflow: typeof getWorkflow;
     flush: typeof flush;
     close: typeof close;
     getClient: typeof getClient;
 };
 
-export { type AppContext, type BeforeBreadcrumb, type BeforeSend, type Breadcrumb, type BreadcrumbBatchItem, type BreadcrumbInput, type CaptureOptions, type Context, type DeviceContext, type Dsn, DsnError, type Envelope, type EnvelopeHeader, type EnvelopeItem, type ErrorItem, type EventItem, type ExceptionValue, type Frame, type Hint, type IdentifyItem, type InitOptions, type ItemType, type Level, type Mechanism, type OsContext, type ResolvedOptions, type RuntimeContext, SDK_NAME, SDK_VERSION, Sauron, SauronClient, type SdkInfo, type TrackOptions, type TransactionInput, type TransactionItem, type TransactionOp, type TransportOptions, type UserContext, type UserInput, addBreadcrumb, buildEnvelope, captureException, captureMessage, close, Sauron as default, flush, getClient, getScreen, identify, init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen, setTag, setTags, setUser, track, trackTransaction };
+export { type ActiveWorkflow, type AppContext, type BeforeBreadcrumb, type BeforeSend, type Breadcrumb, type BreadcrumbBatchItem, type BreadcrumbInput, type CaptureOptions, type Context, type DeviceContext, type Dsn, DsnError, type Envelope, type EnvelopeHeader, type EnvelopeItem, type ErrorItem, type EventItem, type ExceptionValue, type Frame, type Hint, type IdentifyItem, type InitOptions, type ItemType, type Level, type Mechanism, type OsContext, type ResolvedOptions, type RuntimeContext, SDK_NAME, SDK_VERSION, Sauron, SauronClient, type SdkInfo, type TrackOptions, type TransactionInput, type TransactionItem, type TransactionOp, type TransportOptions, type UserContext, type UserInput, type WorkflowResult, type WorkflowStatus, addBreadcrumb, buildEnvelope, cancelWorkflow, captureException, captureMessage, close, Sauron as default, endWorkflow, flush, getClient, getScreen, getWorkflow, identify, init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen, setTag, setTags, setUser, startWorkflow, track, trackTransaction };

package/dist/index.js

@@ -4,7 +4,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 
 // src/utils.ts
 var SDK_NAME = "sauron.javascript";
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.3.0";
 function getGlobal() {
   return globalThis;
 }
@@ -832,6 +832,30 @@ var Scope = class {
   }
 };
 
+// src/workflow.ts
+var WORKFLOW_NAME_MAX = 120;
+var WORKFLOW_REASON_MAX = 120;
+var current = null;
+function getWorkflow() {
+  return current;
+}
+function setWorkflowState(workflow) {
+  current = workflow;
+}
+function resetWorkflow() {
+  current = null;
+}
+function normalizeWorkflowName(name) {
+  if (typeof name !== "string") return null;
+  const trimmed = name.trim();
+  if (trimmed.length === 0 || trimmed.length > WORKFLOW_NAME_MAX) return null;
+  return trimmed;
+}
+function normalizeReason(reason) {
+  if (typeof reason !== "string" || reason.trim().length === 0) return "user";
+  return reason.trim().slice(0, WORKFLOW_REASON_MAX);
+}
+
 // src/api/product.ts
 function track(name, properties = {}, options = {}) {
   const client = getClient();
@@ -902,6 +926,86 @@ function trackTransaction(input) {
   const item = buildTransactionItem(input, client.getDistinctId(), getSessionId());
   client.captureItem(item);
 }
+var NOOP_LOGGER = makeLogger(false);
+function emitWorkflowClose(active, eventName, reason, logger) {
+  const properties = {
+    workflow_id: active.workflowId,
+    workflow_name: active.name,
+    duration_ms: Math.max(0, Date.now() - Date.parse(active.startedAt))
+  };
+  if (eventName === "$workflow_cancel") {
+    properties.reason = normalizeReason(reason);
+  }
+  try {
+    track(eventName, properties);
+  } catch (err) {
+    logger.warn(`${eventName}: failed to emit the lifecycle event`, err);
+  } finally {
+    resetWorkflow();
+  }
+}
+function startWorkflow(name, options) {
+  let logger = NOOP_LOGGER;
+  try {
+    const client = getClient();
+    if (!client || !client.isEnabled()) return { status: "disabled" };
+    logger = makeLogger(client.options.debug);
+    const normalized = normalizeWorkflowName(name);
+    if (!normalized) {
+      logger.warn("startWorkflow: invalid name", name);
+      return { status: "invalid_name" };
+    }
+    const active = getWorkflow();
+    if (active && !options?.force) {
+      logger.warn(
+        `startWorkflow("${normalized}"): "${active.name}" is already active; pass { force: true } to replace it`
+      );
+      return { status: "already_active" };
+    }
+    const workflow = {
+      workflowId: uuidv4(),
+      name: normalized,
+      startedAt: nowIso()
+    };
+    if (active) emitWorkflowClose(active, "$workflow_cancel", "superseded", logger);
+    setWorkflowState(workflow);
+    try {
+      track("$workflow_start", { workflow_id: workflow.workflowId, workflow_name: workflow.name });
+    } catch (err) {
+      logger.warn("startWorkflow: failed to emit $workflow_start", err);
+    }
+    return { status: "ok", workflowId: workflow.workflowId };
+  } catch (err) {
+    logger.warn("startWorkflow failed", err);
+    return { status: "disabled" };
+  }
+}
+function closeWorkflow(eventName, name, reason) {
+  let logger = NOOP_LOGGER;
+  try {
+    const client = getClient();
+    if (!client || !client.isEnabled()) return { status: "disabled" };
+    logger = makeLogger(client.options.debug);
+    const active = getWorkflow();
+    if (!active) return { status: "not_active" };
+    if (name !== void 0 && normalizeWorkflowName(name) !== active.name) {
+      logger.warn(`${eventName}: "${name}" does not match active workflow "${active.name}"`);
+      return { status: "name_mismatch" };
+    }
+    const workflowId = active.workflowId;
+    emitWorkflowClose(active, eventName, reason, logger);
+    return { status: "ok", workflowId };
+  } catch (err) {
+    logger.warn(`${eventName} failed`, err);
+    return { status: "disabled" };
+  }
+}
+function endWorkflow(name) {
+  return closeWorkflow("$workflow_end", name);
+}
+function cancelWorkflow(name, options) {
+  return closeWorkflow("$workflow_cancel", name, options?.reason);
+}
 
 // src/integrations/performance.ts
 var PERF_FETCH = "__sauron_perf_fetch__";
@@ -1354,6 +1458,9 @@ var Transport = class {
     __publicField(this, "pending", []);
     __publicField(this, "timer", null);
     __publicField(this, "onlineHandler", null);
+    /** Permanent auto-disable latch, flipped by this transport itself the moment
+     * it classifies a response as 401/403 — it is the source of truth for
+     * {@link isEnabled}, not merely a mirror of something the client decided. */
     __publicField(this, "disabled", false);
     this.dsn = config.dsn;
     this.makeEnvelope = config.makeEnvelope;
@@ -1401,6 +1508,10 @@ var Transport = class {
     this.pending = [];
     this.stop();
   }
+  /** Whether the transport still accepts items (false once auth-disabled by a 401/403). */
+  isEnabled() {
+    return !this.disabled;
+  }
   /** Queue an item for the next batch; flush eagerly once the batch is full. */
   send(item) {
     if (this.disabled) return;
@@ -1443,6 +1554,7 @@ var Transport = class {
         return;
       case "disable":
         this.logger.warn("server rejected credentials; disabling client");
+        this.disable();
         this.onDisable();
         return;
       case "split": {
@@ -1480,6 +1592,7 @@ var Transport = class {
         outcome = { action: "retry_backoff" };
       }
       if (outcome.action === "disable") {
+        this.disable();
         this.onDisable();
         this.offline.enqueue(json);
         return;
@@ -1645,8 +1758,19 @@ var SauronClient = class {
   getScope() {
     return this.scope;
   }
+  /**
+   * False once this client was explicitly disabled/closed, OR once the
+   * transport has auto-disabled itself on a 401/403 (revoked/invalid DSN
+   * key) — computed from the transport's own state on every call, not a
+   * separately mirrored flag, so a propagation regression there cannot leave
+   * this predicate stale. `this.transport` always exists once a client
+   * exists (it is constructed synchronously in the constructor); the
+   * "nothing installed yet" case is instead handled one layer up, by every
+   * module-level API (`startWorkflow`, `track`, ...) treating `getClient() ===
+   * null` as the no-op/disabled case before it ever reaches here.
+   */
   isEnabled() {
-    return this.enabled;
+    return this.enabled && this.transport.isEnabled();
   }
   /** The current distinct id: the user id when identified, else an anon id. */
   getDistinctId() {
@@ -1668,7 +1792,6 @@ var SauronClient = class {
       dsn: this.dsn.raw,
       sdk: { name: SDK_NAME, version: SDK_VERSION },
       sent_at: nowIso(),
-      environment: this.options.environment,
       release: this.options.release
     };
     const context = buildContext(this.options.release, this.scope.getUser());
@@ -1714,6 +1837,39 @@ var SauronClient = class {
       item.user = this.scope.getUser();
     }
   }
+  /**
+   * Stamp the active workflow (if any) onto a signal item.
+   *
+   * Done HERE — the single choke point every capture path funnels through —
+   * rather than at each item-construction site, so a capture path added later
+   * is stamped by construction instead of by remembering to. The keys are
+   * ASSIGNED ONLY when a workflow is active: an item with no workflow keeps
+   * them absent entirely (not present-as-`undefined`), which is what makes
+   * `JSON.stringify` omit them and keeps the no-workflow wire bytes identical
+   * to pre-1.3.0.
+   *
+   * Only error/event/transaction carry `workflow_id`/`workflow_name` columns
+   * server-side — identify and breadcrumb_batch items are deliberately left
+   * alone. An item that already carries an explicit `workflow_id` is left
+   * untouched, matching how `enrichErrorItem` defers to caller-set fields.
+   */
+  stampWorkflow(item) {
+    if (item.type !== "error" && item.type !== "event" && item.type !== "transaction") return;
+    const hasId = item.workflow_id !== void 0;
+    const hasName = item.workflow_name !== void 0;
+    if (hasId || hasName) {
+      if (hasId !== hasName) {
+        this.logger.warn(
+          "item sets only one of workflow_id/workflow_name; the server treats them as a pair and will drop this attribution. Set both, or neither."
+        );
+      }
+      return;
+    }
+    const workflow = getWorkflow();
+    if (!workflow) return;
+    item.workflow_id = workflow.workflowId;
+    item.workflow_name = workflow.name;
+  }
   /**
    * Run an item through sampling (errors only) and `beforeSend`, then hand it to
    * the transport. Returns silently when dropped.
@@ -1727,6 +1883,7 @@ var SauronClient = class {
       }
       this.enrichErrorItem(item, hint);
     }
+    this.stampWorkflow(item);
     let processed = item;
     if (this.options.beforeSend) {
       try {
@@ -1763,6 +1920,7 @@ var SauronClient = class {
     }
     onNavigation(null);
     resetScreen();
+    resetWorkflow();
     unpatchAll();
     setDsnHost(null);
     this.installed = false;
@@ -1785,7 +1943,6 @@ function resolveOptions(options) {
   const t = options.transport ?? {};
   return {
     dsn: options.dsn,
-    environment: options.environment ?? "production",
     release: options.release ?? null,
     sampleRate: clamp(options.sampleRate ?? 1, 0, 1),
     maxBreadcrumbs: options.maxBreadcrumbs ?? 50,
@@ -1870,6 +2027,18 @@ function setScreen2(name) {
 function getScreen2() {
   return getScreen();
 }
+function startWorkflow2(name, options) {
+  return startWorkflow(name, options);
+}
+function endWorkflow2(name) {
+  return endWorkflow(name);
+}
+function cancelWorkflow2(name, options) {
+  return cancelWorkflow(name, options);
+}
+function getWorkflow2() {
+  return getWorkflow();
+}
 function addBreadcrumb2(breadcrumb, hint) {
   addBreadcrumb(breadcrumb, hint);
 }
@@ -1911,12 +2080,16 @@ var Sauron = {
   setExtra,
   setScreen: setScreen2,
   getScreen: getScreen2,
+  startWorkflow: startWorkflow2,
+  endWorkflow: endWorkflow2,
+  cancelWorkflow: cancelWorkflow2,
+  getWorkflow: getWorkflow2,
   flush,
   close,
   getClient
 };
 var index_default = Sauron;
 
-export { DsnError, SDK_NAME, SDK_VERSION, Sauron, SauronClient, addBreadcrumb2 as addBreadcrumb, buildEnvelope, captureException2 as captureException, captureMessage2 as captureMessage, close, index_default as default, flush, getClient, getScreen2 as getScreen, identify2 as identify, init2 as init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen2 as setScreen, setTag, setTags, setUser, track2 as track, trackTransaction2 as trackTransaction };
+export { DsnError, SDK_NAME, SDK_VERSION, Sauron, SauronClient, addBreadcrumb2 as addBreadcrumb, buildEnvelope, cancelWorkflow2 as cancelWorkflow, captureException2 as captureException, captureMessage2 as captureMessage, close, index_default as default, endWorkflow2 as endWorkflow, flush, getClient, getScreen2 as getScreen, getWorkflow2 as getWorkflow, identify2 as identify, init2 as init, isInAppFrame, parseDsn, parseError, parseStackString, setContext, setExtra, setScreen2 as setScreen, setTag, setTags, setUser, startWorkflow2 as startWorkflow, track2 as track, trackTransaction2 as trackTransaction };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map