@edraj/sauron-node 1.0.0 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 All notable changes to `@edraj/sauron-node` are documented here.
 
+## 1.4.0
+
+### Fixed
+
+- **`trackTransaction` shipped transactions with no duration, silently.** This
+  SDK's input field is `duration_ms`; the browser SDK's is `durationMs`. A
+  snippet moved between the two — or any plain-JavaScript caller, where the type
+  checker is not there to object — produced a transaction item missing the one
+  field it exists to carry, and nothing anywhere complained: the item validated,
+  shipped, and looked delivered.
+
+  `durationMs` is now accepted as an alias, and a transaction with no usable
+  duration is **dropped with a debug log line rather than sent**. Refusing is the
+  point: sending it anyway is what let the misspelling survive unnoticed.
+  `duration_ms: 0` is a legitimate duration and is still sent.
+
+### Changed
+
+- `TransactionInput.duration_ms` is now optional, since `durationMs` may supply
+  it instead. Supply exactly one — `duration_ms` wins if both are present.
+  Supplying neither is the drop above, not a compile error.
+
+## 1.3.0
+
+### Added
+
+- **Workflows** — bound a named span of activity with `startWorkflow(name,
+  { force? })` / `endWorkflow(name?)` / `cancelWorkflow(name?, { reason? })`,
+  and read the active one with `getWorkflow()`. Every event, error and
+  transaction captured while a workflow is active is stamped with its
+  `workflow_id` / `workflow_name`, so the dashboard can group a whole flow
+  (`checkout`, `password_reset`, …) as one unit. The three lifecycle events
+  `$workflow_start` / `$workflow_end` / `$workflow_cancel` are emitted
+  automatically, carrying `duration_ms` (and `reason` on cancel).
+- New exported types: `WorkflowStatus`, `WorkflowResult`, `ActiveWorkflow`.
+- `SauronClient.isEnabled()` — `false` once the transport has auto-disabled
+  itself on a 401/403.
+
+Workflows are entirely **optional**: an app that never calls them emits
+byte-identical telemetry to 1.2.0 — the two fields are omitted from the wire
+JSON, never sent as `null`.
+
+The active workflow is **request-scoped**, held on the current `Scope` and
+isolated by the same `AsyncLocalStorage` that already isolates
+`user`/`tags`/`breadcrumbs`. Concurrent requests never observe or clobber each
+other's workflow. None of the three methods ever throws — each returns one of
+six statuses (`ok`, `already_active`, `not_active`, `name_mismatch`,
+`invalid_name`, `disabled`).
+
+## 1.2.0
+
+- **Breaking: the `environment` option has been removed.** An environment is now
+  identified by the ingest key it belongs to, not by a string the client sends.
+  Create environments in the dashboard under app settings; each one has its own
+  DSN. Delete `environment` from your `init` call and swap in the DSN of the
+  environment you want to report to.
+
 ## 1.0.0 - 2026-07-27
 
 First public release. Prior `0.x` versions were internal-only and were never