@tracelog/lib 3.1.1-rc.118.5 → 3.1.1-rc.120.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -189,8 +189,8 @@ await tracelog.init({
189
189
  integrations: {
190
190
  tracelog: {
191
191
  projectId: 'your-project-id',
192
- collectUrl: 'https://ingest.tracelog.io/p/your-project-id/collect', // Optional: explicit managed ingest endpoint
193
- shopify: false // Optional: enable Shopify cart attribute linking
192
+ shopify: false, // Optional: enable Shopify cart attribute linking
193
+ healthBeacon: true // Optional (default true): diagnostic beacon when ingest is blocked (403)
194
194
  }
195
195
  }
196
196
  });
@@ -278,17 +278,12 @@ Perfect for custom analytics pipelines, testing, or privacy-focused implementati
278
278
  ```typescript
279
279
  await tracelog.init({
280
280
  integrations: {
281
- tracelog: {
282
- projectId: 'your-project-id',
283
- collectUrl: 'https://ingest.tracelog.io/p/your-project-id/collect' // recommended
284
- }
281
+ tracelog: { projectId: 'your-project-id' }
285
282
  }
286
283
  });
287
284
  ```
288
285
 
289
- **`collectUrl` (recommended).** Optional HTTPS URL that explicitly sets the managed ingest endpoint. When present, the library uses it verbatim and skips both the CNAME-derived URL and the `localhost`/raw-IP restriction. The TraceLog dashboard surfaces the recommended value in the install snippet, so most users get it for free.
290
-
291
- **Domain requirement (CNAME fallback).** When `collectUrl` is omitted, the SaaS endpoint is derived from the host page's domain (`https://{projectId}.{rootDomain}/collect`), so `init()` rejects when called from `localhost` or a raw IP address. For local development, omit `integrations.tracelog` to run in standalone mode, or test against a staging domain mapped via `/etc/hosts`.
286
+ **Domain requirement.** The SaaS endpoint is derived from the host page's domain (`https://{projectId}.{rootDomain}/collect`), so `init()` rejects when called from `localhost` or a raw IP address. For local development, omit `integrations.tracelog` to run in standalone mode, or test against a staging domain mapped via `/etc/hosts`.
292
287
 
293
288
  **→ [Integration Reference](./API_REFERENCE.md#integration-configuration)**
294
289