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

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.
Files changed (2) hide show
  1. package/README.md +8 -2
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -189,6 +189,7 @@ 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
192
193
  shopify: false // Optional: enable Shopify cart attribute linking
193
194
  }
194
195
  }
@@ -277,12 +278,17 @@ Perfect for custom analytics pipelines, testing, or privacy-focused implementati
277
278
  ```typescript
278
279
  await tracelog.init({
279
280
  integrations: {
280
- tracelog: { projectId: 'your-project-id' }
281
+ tracelog: {
282
+ projectId: 'your-project-id',
283
+ collectUrl: 'https://ingest.tracelog.io/p/your-project-id/collect' // recommended
284
+ }
281
285
  }
282
286
  });
283
287
  ```
284
288
 
285
- **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`.
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
292
 
287
293
  **→ [Integration Reference](./API_REFERENCE.md#integration-configuration)**
288
294
 
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@tracelog/lib",
3
3
  "description": "JavaScript library for web analytics and real-time event tracking",
4
4
  "license": "MIT",
5
- "version": "3.1.1-rc.118.4",
5
+ "version": "3.1.1-rc.118.5",
6
6
  "main": "./dist/public-api.cjs",
7
7
  "module": "./dist/public-api.js",
8
8
  "types": "./dist/public-api.d.ts",