@effectstream/log 0.100.15 → 0.100.16

package/README.md

@@ -5,6 +5,11 @@ OpenTelemetry-instrumented structured logging for EffectStream. Wraps
 both pretty console output (`log.local`) and OTLP traces/logs to your
 collector (`log.remote`).
 
+- OpenTelemetry-instrumented structured logging on top of `tslog`.
+- Pretty console output and OTLP traces / logs from one `log` object.
+- Used by every package in the framework so the node emits one trace tree.
+- `ComponentNames` constants tag log records by component, powering per-component log views.
+
 ## Install
 
 ```bash
@@ -62,16 +67,16 @@ powers the orchestrator's per-component log views.
 
 ## Key exports
 
-- `log.local(component, namespace, level, deferred)` — console-only logging. `level` is `SeverityNumber`; `deferred = (l) => l(...args)` is called only if the level passes the filter.
-- `log.localForce(...)` — bypasses level filtering.
-- `log.remote(...)` — console + OpenTelemetry log record. Same signature as `local`.
-- `log.remoteForce(...)` — `remote` without level filtering.
+- `log.local(component, namespace, level, deferred)`: console-only logging. `level` is `SeverityNumber`; `deferred = (l) => l(...args)` is called only if the level passes the filter.
+- `log.localForce(...)` bypasses level filtering.
+- `log.remote(...)`: console + OpenTelemetry log record. Same signature as `local`.
+- `log.remoteForce(...)` is `remote` without level filtering.
 - `log.formatMessage(...)` — the formatter used internally; useful for custom transports.
-- `defaultOtelSetup(opts)` — one-call OpenTelemetry SDK setup with sensible defaults.
-- `attachTransport(transport)` — register a custom tslog transport (e.g. ship logs to a file).
-- `SeverityNumber` — re-export of OpenTelemetry severity levels.
-- `ComponentNames` — string-enum constants used to tag logs by component.
-- `Namespace` — `string | string[]` for log namespacing.
+- `defaultOtelSetup(opts)`: one-call OpenTelemetry SDK setup with sensible defaults.
+- `attachTransport(transport)` registers a custom tslog transport (e.g. ship logs to a file).
+- `SeverityNumber`: re-export of OpenTelemetry severity levels.
+- `ComponentNames`: string-enum constants used to tag logs by component.
+- `Namespace`: `string | string[]` for log namespacing.
 
 ## Examples
 
@@ -80,4 +85,4 @@ Runnable: [`test/examples.test.ts`](./test/examples.test.ts).
 ## Links
 
 - Docs: https://effectstream.github.io/docs/packages/sdk/log
-- Source: https://github.com/PaimaStudios/paima-engine/tree/main/packages/effectstream-sdk/log
+- Source: https://github.com/effectstream/effectstream/tree/main/packages/effectstream-sdk/log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effectstream/log",
-  "version": "0.100.15",
+  "version": "0.100.16",
   "license": "MIT",
   "homepage": "https://effectstream.github.io/docs/",
   "repository": {
@@ -13,7 +13,7 @@
   },
   "exports": "./src/mod.ts",
   "dependencies": {
-    "@effectstream/utils": "0.100.15",
+    "@effectstream/utils": "0.100.16",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/api-logs": "0.56.0",
     "@opentelemetry/exporter-logs-otlp-http": "0.56.0",