core-outline 1.1.23 → 1.1.24

package/README.md

@@ -12,6 +12,17 @@ npm install core-outline
 yarn add core-outline
 ```
 
+## Prerequisites
+
+Before adding the component to your app, create an SDK data source through the Hermes API to obtain your credentials. This requires your Firebase authentication token.
+
+```sh
+curl -X POST https://atlas-orchestrator.atlas.coreoutline.com/api/ingest/sdk-sources \
+  -H "Authorization: Bearer <your-firebase-token>" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "My Website"}'
+```
+
 The response contains your `data_source_id`, `data_source_secret`, and `warehouse_id`. **The secret is shown once — store it securely.**
 
 ```json
@@ -79,3 +90,37 @@ flag_item_clicked('sku-123');
 // Track a purchase (price is optional, maps to value_num in ClickHouse)
 flag_item_purchased('sku-123', 49.99);
 ```
+
+## Data Pipeline
+
+Events flow through the following pipeline:
+
+```
+Browser → POST /api/ingest/events → RabbitMQ ({warehouse_id}.analytics.events)
+       → Consumer worker → ClickHouse atlas_analytics
+```
+
+The ClickHouse tables populated are:
+
+| Table | Populated by |
+|-------|-------------|
+| `fact_event` | All events except session start/end |
+| `fact_session` | `session_start` and `session_end` events |
+| `fact_pageview` | `pageview` events |
+| `stg_events_sdk_event` | All events (raw staging) |
+| `stg_rrweb_event` | Session recording chunks |
+
+These tables are queried by the [atlas-analytics](https://analytics.atlas.coreoutline.com) API under `/metrics/saas/traffic`, `/metrics/saas/engagement`, and related endpoints.
+
+## Anonymous vs Session Identity
+
+- **`anonymous_id`** — a UUID stored in `localStorage`; persists across browser sessions, used to stitch cross-session user journeys.
+- **`session_id`** — a UUID stored in `sessionStorage`; reset on each new tab or browser close, matching the standard session definition.
+
+## Service URLs
+
+| Service | URL |
+|---------|-----|
+| Hermes API (credential management) | `https://atlas-orchestrator.atlas.coreoutline.com` |
+| Maia (data engineering / pipelines) | `https://data-engineering.atlas.coreoutline.com` |
+| Atlas Analytics API | `https://analytics.atlas.coreoutline.com` |

package/dist/index.es.js

@@ -4411,25 +4411,57 @@ function getPagePath() {
 
 var INGEST_BASE = 'https://atlas-orchestrator.atlas.coreoutline.com';
 var FLUSH_INTERVAL_MS = 5000;
+// Refresh the token this many milliseconds before it actually expires.
+var TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes
+
 var _token = null;
 var _warehouseId = null;
 var _organizationId = null;
 var _dataSourceId = null;
+var _dataSourceSecret = null;
 var _buffer = [];
 var _flushInterval = null;
-function initIngest(_x, _x2, _x3) {
-  return _initIngest.apply(this, arguments);
-}
-function _initIngest() {
-  _initIngest = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(warehouseId, dataSourceId, dataSourceSecret) {
-    var res, data;
+var _refreshTimeout = null;
+function _scheduleTokenRefresh(expiresInSeconds) {
+  if (_refreshTimeout) {
+    clearTimeout(_refreshTimeout);
+    _refreshTimeout = null;
+  }
+  var refreshInMs = expiresInSeconds * 1000 - TOKEN_REFRESH_BUFFER_MS;
+  if (refreshInMs <= 0) {
+    // Token already near expiry — refresh immediately on next action.
+    return;
+  }
+  _refreshTimeout = setTimeout(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+    var ok;
     return _regeneratorRuntime().wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          _warehouseId = warehouseId;
-          _dataSourceId = dataSourceId;
-          _context.prev = 2;
-          _context.next = 5;
+          _context.next = 2;
+          return _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+        case 2:
+          ok = _context.sent;
+          if (!ok) {
+            console.warn('[CoreOutline] Proactive token refresh failed; will retry on next flush.');
+          }
+        case 4:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  })), refreshInMs);
+}
+function _doAuthorize(_x, _x2, _x3) {
+  return _doAuthorize2.apply(this, arguments);
+}
+function _doAuthorize2() {
+  _doAuthorize2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(warehouseId, dataSourceId, dataSourceSecret) {
+    var res, data, expiresIn;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.prev = 0;
+          _context2.next = 3;
           return fetch("".concat(INGEST_BASE, "/api/ingest/authorize"), {
             method: 'POST',
             headers: {
@@ -4441,35 +4473,85 @@ function _initIngest() {
               data_source_secret: dataSourceSecret
             })
           });
-        case 5:
-          res = _context.sent;
+        case 3:
+          res = _context2.sent;
           if (res.ok) {
-            _context.next = 9;
+            _context2.next = 7;
             break;
           }
           console.error('[CoreOutline] Authorization failed:', res.status);
-          return _context.abrupt("return", false);
-        case 9:
-          _context.next = 11;
+          return _context2.abrupt("return", false);
+        case 7:
+          _context2.next = 9;
           return res.json();
-        case 11:
-          data = _context.sent;
+        case 9:
+          data = _context2.sent;
           _token = data.access_token;
           _organizationId = data.organization_id;
-          return _context.abrupt("return", true);
+          expiresIn = data.expires_in || 24 * 3600;
+          _scheduleTokenRefresh(expiresIn);
+          return _context2.abrupt("return", true);
         case 17:
-          _context.prev = 17;
-          _context.t0 = _context["catch"](2);
-          console.error('[CoreOutline] Authorization error:', _context.t0);
-          return _context.abrupt("return", false);
+          _context2.prev = 17;
+          _context2.t0 = _context2["catch"](0);
+          console.error('[CoreOutline] Authorization error:', _context2.t0);
+          return _context2.abrupt("return", false);
         case 21:
         case "end":
-          return _context.stop();
+          return _context2.stop();
+      }
+    }, _callee2, null, [[0, 17]]);
+  }));
+  return _doAuthorize2.apply(this, arguments);
+}
+function initIngest(_x4, _x5, _x6) {
+  return _initIngest.apply(this, arguments);
+}
+function _initIngest() {
+  _initIngest = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3(warehouseId, dataSourceId, dataSourceSecret) {
+    return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          _warehouseId = warehouseId;
+          _dataSourceId = dataSourceId;
+          _dataSourceSecret = dataSourceSecret;
+          return _context3.abrupt("return", _doAuthorize(warehouseId, dataSourceId, dataSourceSecret));
+        case 4:
+        case "end":
+          return _context3.stop();
       }
-    }, _callee, null, [[2, 17]]);
+    }, _callee3);
   }));
   return _initIngest.apply(this, arguments);
 }
+function _ensureFreshToken() {
+  return _ensureFreshToken2.apply(this, arguments);
+}
+function _ensureFreshToken2() {
+  _ensureFreshToken2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+    return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          if (!_token) {
+            _context4.next = 2;
+            break;
+          }
+          return _context4.abrupt("return");
+        case 2:
+          if (!(_warehouseId && _dataSourceId && _dataSourceSecret)) {
+            _context4.next = 5;
+            break;
+          }
+          _context4.next = 5;
+          return _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+        case 5:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return _ensureFreshToken2.apply(this, arguments);
+}
 function trackEvent(eventType, payload) {
   if (!_token) return;
   var event = _objectSpread2({
@@ -4483,49 +4565,75 @@ function trackEvent(eventType, payload) {
   }
 }
 function flush() {
-  if (!_token || _buffer.length === 0) return;
-  var events = _buffer.splice(0, _buffer.length);
-  var body = JSON.stringify({
-    warehouse_id: _warehouseId,
-    organization_id: _organizationId,
-    events: events
-  });
-  var headers = {
-    'Content-Type': 'application/json',
-    Authorization: "Bearer ".concat(_token)
-  };
-  if (navigator.sendBeacon) {
-    var blob = new Blob([body], {
-      type: 'application/json'
-    });
-    navigator.sendBeacon("".concat(INGEST_BASE, "/api/ingest/events"), blob);
-  } else {
-    fetch("".concat(INGEST_BASE, "/api/ingest/events"), {
-      method: 'POST',
-      headers: headers,
-      body: body,
-      keepalive: true
-    })["catch"](function (err) {
-      return console.error('[CoreOutline] Flush error:', err);
-    });
-  }
+  return _flush.apply(this, arguments);
+}
+function _flush() {
+  _flush = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
+    var events, body, headers, blob;
+    return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          _context5.next = 2;
+          return _ensureFreshToken();
+        case 2:
+          if (!(!_token || _buffer.length === 0)) {
+            _context5.next = 4;
+            break;
+          }
+          return _context5.abrupt("return");
+        case 4:
+          events = _buffer.splice(0, _buffer.length);
+          body = JSON.stringify({
+            warehouse_id: _warehouseId,
+            organization_id: _organizationId,
+            events: events
+          });
+          headers = {
+            'Content-Type': 'application/json',
+            Authorization: "Bearer ".concat(_token)
+          };
+          if (navigator.sendBeacon) {
+            blob = new Blob([body], {
+              type: 'application/json'
+            });
+            navigator.sendBeacon("".concat(INGEST_BASE, "/api/ingest/events"), blob);
+          } else {
+            fetch("".concat(INGEST_BASE, "/api/ingest/events"), {
+              method: 'POST',
+              headers: headers,
+              body: body,
+              keepalive: true
+            })["catch"](function (err) {
+              return console.error('[CoreOutline] Flush error:', err);
+            });
+          }
+        case 8:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  }));
+  return _flush.apply(this, arguments);
 }
-function sendRrwebBatch(_x4, _x5) {
+function sendRrwebBatch(_x7, _x8) {
   return _sendRrwebBatch.apply(this, arguments);
 }
 function _sendRrwebBatch() {
-  _sendRrwebBatch = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(chunks, sessionId) {
-    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-      while (1) switch (_context2.prev = _context2.next) {
+  _sendRrwebBatch = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee6(chunks, sessionId) {
+    return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
         case 0:
+          _context6.next = 2;
+          return _ensureFreshToken();
+        case 2:
           if (!(!_token || !chunks || chunks.length === 0)) {
-            _context2.next = 2;
+            _context6.next = 4;
             break;
           }
-          return _context2.abrupt("return");
-        case 2:
-          _context2.prev = 2;
-          _context2.next = 5;
+          return _context6.abrupt("return");
+        case 4:
+          _context6.prev = 4;
+          _context6.next = 7;
           return fetch("".concat(INGEST_BASE, "/api/ingest/rrweb"), {
             method: 'POST',
             headers: {
@@ -4541,18 +4649,18 @@ function _sendRrwebBatch() {
             }),
             keepalive: true
           });
-        case 5:
-          _context2.next = 10;
-          break;
         case 7:
-          _context2.prev = 7;
-          _context2.t0 = _context2["catch"](2);
-          console.error('[CoreOutline] rrweb upload error:', _context2.t0);
-        case 10:
+          _context6.next = 12;
+          break;
+        case 9:
+          _context6.prev = 9;
+          _context6.t0 = _context6["catch"](4);
+          console.error('[CoreOutline] rrweb upload error:', _context6.t0);
+        case 12:
         case "end":
-          return _context2.stop();
+          return _context6.stop();
       }
-    }, _callee2, null, [[2, 7]]);
+    }, _callee6, null, [[4, 9]]);
   }));
   return _sendRrwebBatch.apply(this, arguments);
 }

package/dist/index.js

@@ -4419,25 +4419,57 @@ function getPagePath() {
 
 var INGEST_BASE = 'https://atlas-orchestrator.atlas.coreoutline.com';
 var FLUSH_INTERVAL_MS = 5000;
+// Refresh the token this many milliseconds before it actually expires.
+var TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes
+
 var _token = null;
 var _warehouseId = null;
 var _organizationId = null;
 var _dataSourceId = null;
+var _dataSourceSecret = null;
 var _buffer = [];
 var _flushInterval = null;
-function initIngest(_x, _x2, _x3) {
-  return _initIngest.apply(this, arguments);
-}
-function _initIngest() {
-  _initIngest = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee(warehouseId, dataSourceId, dataSourceSecret) {
-    var res, data;
+var _refreshTimeout = null;
+function _scheduleTokenRefresh(expiresInSeconds) {
+  if (_refreshTimeout) {
+    clearTimeout(_refreshTimeout);
+    _refreshTimeout = null;
+  }
+  var refreshInMs = expiresInSeconds * 1000 - TOKEN_REFRESH_BUFFER_MS;
+  if (refreshInMs <= 0) {
+    // Token already near expiry — refresh immediately on next action.
+    return;
+  }
+  _refreshTimeout = setTimeout(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+    var ok;
     return _regeneratorRuntime().wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          _warehouseId = warehouseId;
-          _dataSourceId = dataSourceId;
-          _context.prev = 2;
-          _context.next = 5;
+          _context.next = 2;
+          return _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+        case 2:
+          ok = _context.sent;
+          if (!ok) {
+            console.warn('[CoreOutline] Proactive token refresh failed; will retry on next flush.');
+          }
+        case 4:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  })), refreshInMs);
+}
+function _doAuthorize(_x, _x2, _x3) {
+  return _doAuthorize2.apply(this, arguments);
+}
+function _doAuthorize2() {
+  _doAuthorize2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(warehouseId, dataSourceId, dataSourceSecret) {
+    var res, data, expiresIn;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.prev = 0;
+          _context2.next = 3;
           return fetch("".concat(INGEST_BASE, "/api/ingest/authorize"), {
             method: 'POST',
             headers: {
@@ -4449,35 +4481,85 @@ function _initIngest() {
               data_source_secret: dataSourceSecret
             })
           });
-        case 5:
-          res = _context.sent;
+        case 3:
+          res = _context2.sent;
           if (res.ok) {
-            _context.next = 9;
+            _context2.next = 7;
             break;
           }
           console.error('[CoreOutline] Authorization failed:', res.status);
-          return _context.abrupt("return", false);
-        case 9:
-          _context.next = 11;
+          return _context2.abrupt("return", false);
+        case 7:
+          _context2.next = 9;
           return res.json();
-        case 11:
-          data = _context.sent;
+        case 9:
+          data = _context2.sent;
           _token = data.access_token;
           _organizationId = data.organization_id;
-          return _context.abrupt("return", true);
+          expiresIn = data.expires_in || 24 * 3600;
+          _scheduleTokenRefresh(expiresIn);
+          return _context2.abrupt("return", true);
         case 17:
-          _context.prev = 17;
-          _context.t0 = _context["catch"](2);
-          console.error('[CoreOutline] Authorization error:', _context.t0);
-          return _context.abrupt("return", false);
+          _context2.prev = 17;
+          _context2.t0 = _context2["catch"](0);
+          console.error('[CoreOutline] Authorization error:', _context2.t0);
+          return _context2.abrupt("return", false);
         case 21:
         case "end":
-          return _context.stop();
+          return _context2.stop();
+      }
+    }, _callee2, null, [[0, 17]]);
+  }));
+  return _doAuthorize2.apply(this, arguments);
+}
+function initIngest(_x4, _x5, _x6) {
+  return _initIngest.apply(this, arguments);
+}
+function _initIngest() {
+  _initIngest = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3(warehouseId, dataSourceId, dataSourceSecret) {
+    return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          _warehouseId = warehouseId;
+          _dataSourceId = dataSourceId;
+          _dataSourceSecret = dataSourceSecret;
+          return _context3.abrupt("return", _doAuthorize(warehouseId, dataSourceId, dataSourceSecret));
+        case 4:
+        case "end":
+          return _context3.stop();
       }
-    }, _callee, null, [[2, 17]]);
+    }, _callee3);
   }));
   return _initIngest.apply(this, arguments);
 }
+function _ensureFreshToken() {
+  return _ensureFreshToken2.apply(this, arguments);
+}
+function _ensureFreshToken2() {
+  _ensureFreshToken2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+    return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          if (!_token) {
+            _context4.next = 2;
+            break;
+          }
+          return _context4.abrupt("return");
+        case 2:
+          if (!(_warehouseId && _dataSourceId && _dataSourceSecret)) {
+            _context4.next = 5;
+            break;
+          }
+          _context4.next = 5;
+          return _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+        case 5:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return _ensureFreshToken2.apply(this, arguments);
+}
 function trackEvent(eventType, payload) {
   if (!_token) return;
   var event = _objectSpread2({
@@ -4491,49 +4573,75 @@ function trackEvent(eventType, payload) {
   }
 }
 function flush() {
-  if (!_token || _buffer.length === 0) return;
-  var events = _buffer.splice(0, _buffer.length);
-  var body = JSON.stringify({
-    warehouse_id: _warehouseId,
-    organization_id: _organizationId,
-    events: events
-  });
-  var headers = {
-    'Content-Type': 'application/json',
-    Authorization: "Bearer ".concat(_token)
-  };
-  if (navigator.sendBeacon) {
-    var blob = new Blob([body], {
-      type: 'application/json'
-    });
-    navigator.sendBeacon("".concat(INGEST_BASE, "/api/ingest/events"), blob);
-  } else {
-    fetch("".concat(INGEST_BASE, "/api/ingest/events"), {
-      method: 'POST',
-      headers: headers,
-      body: body,
-      keepalive: true
-    })["catch"](function (err) {
-      return console.error('[CoreOutline] Flush error:', err);
-    });
-  }
+  return _flush.apply(this, arguments);
+}
+function _flush() {
+  _flush = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee5() {
+    var events, body, headers, blob;
+    return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          _context5.next = 2;
+          return _ensureFreshToken();
+        case 2:
+          if (!(!_token || _buffer.length === 0)) {
+            _context5.next = 4;
+            break;
+          }
+          return _context5.abrupt("return");
+        case 4:
+          events = _buffer.splice(0, _buffer.length);
+          body = JSON.stringify({
+            warehouse_id: _warehouseId,
+            organization_id: _organizationId,
+            events: events
+          });
+          headers = {
+            'Content-Type': 'application/json',
+            Authorization: "Bearer ".concat(_token)
+          };
+          if (navigator.sendBeacon) {
+            blob = new Blob([body], {
+              type: 'application/json'
+            });
+            navigator.sendBeacon("".concat(INGEST_BASE, "/api/ingest/events"), blob);
+          } else {
+            fetch("".concat(INGEST_BASE, "/api/ingest/events"), {
+              method: 'POST',
+              headers: headers,
+              body: body,
+              keepalive: true
+            })["catch"](function (err) {
+              return console.error('[CoreOutline] Flush error:', err);
+            });
+          }
+        case 8:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  }));
+  return _flush.apply(this, arguments);
 }
-function sendRrwebBatch(_x4, _x5) {
+function sendRrwebBatch(_x7, _x8) {
   return _sendRrwebBatch.apply(this, arguments);
 }
 function _sendRrwebBatch() {
-  _sendRrwebBatch = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2(chunks, sessionId) {
-    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
-      while (1) switch (_context2.prev = _context2.next) {
+  _sendRrwebBatch = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime().mark(function _callee6(chunks, sessionId) {
+    return _regeneratorRuntime().wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
         case 0:
+          _context6.next = 2;
+          return _ensureFreshToken();
+        case 2:
           if (!(!_token || !chunks || chunks.length === 0)) {
-            _context2.next = 2;
+            _context6.next = 4;
             break;
           }
-          return _context2.abrupt("return");
-        case 2:
-          _context2.prev = 2;
-          _context2.next = 5;
+          return _context6.abrupt("return");
+        case 4:
+          _context6.prev = 4;
+          _context6.next = 7;
           return fetch("".concat(INGEST_BASE, "/api/ingest/rrweb"), {
             method: 'POST',
             headers: {
@@ -4549,18 +4657,18 @@ function _sendRrwebBatch() {
             }),
             keepalive: true
           });
-        case 5:
-          _context2.next = 10;
-          break;
         case 7:
-          _context2.prev = 7;
-          _context2.t0 = _context2["catch"](2);
-          console.error('[CoreOutline] rrweb upload error:', _context2.t0);
-        case 10:
+          _context6.next = 12;
+          break;
+        case 9:
+          _context6.prev = 9;
+          _context6.t0 = _context6["catch"](4);
+          console.error('[CoreOutline] rrweb upload error:', _context6.t0);
+        case 12:
         case "end":
-          return _context2.stop();
+          return _context6.stop();
       }
-    }, _callee2, null, [[2, 7]]);
+    }, _callee6, null, [[4, 9]]);
   }));
   return _sendRrwebBatch.apply(this, arguments);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-outline",
-  "version": "1.1.23",
+  "version": "1.1.24",
   "description": "A React component for Core&Outline",
   "main": "dist/index.js",
   "module": "dist/index.es.js",

package/src/components/CoreOutline/ingest.js

@@ -2,18 +2,39 @@ import { v4 as uuidv4 } from 'uuid';
 
 const INGEST_BASE = 'https://atlas-orchestrator.atlas.coreoutline.com';
 const FLUSH_INTERVAL_MS = 5000;
+// Refresh the token this many milliseconds before it actually expires.
+const TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes
 
 let _token = null;
 let _warehouseId = null;
 let _organizationId = null;
 let _dataSourceId = null;
+let _dataSourceSecret = null;
 let _buffer = [];
 let _flushInterval = null;
+let _refreshTimeout = null;
 
-export async function initIngest(warehouseId, dataSourceId, dataSourceSecret) {
-  _warehouseId = warehouseId;
-  _dataSourceId = dataSourceId;
+function _scheduleTokenRefresh(expiresInSeconds) {
+  if (_refreshTimeout) {
+    clearTimeout(_refreshTimeout);
+    _refreshTimeout = null;
+  }
+
+  const refreshInMs = expiresInSeconds * 1000 - TOKEN_REFRESH_BUFFER_MS;
+  if (refreshInMs <= 0) {
+    // Token already near expiry — refresh immediately on next action.
+    return;
+  }
 
+  _refreshTimeout = setTimeout(async () => {
+    const ok = await _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+    if (!ok) {
+      console.warn('[CoreOutline] Proactive token refresh failed; will retry on next flush.');
+    }
+  }, refreshInMs);
+}
+
+async function _doAuthorize(warehouseId, dataSourceId, dataSourceSecret) {
   try {
     const res = await fetch(`${INGEST_BASE}/api/ingest/authorize`, {
       method: 'POST',
@@ -33,6 +54,9 @@ export async function initIngest(warehouseId, dataSourceId, dataSourceSecret) {
     const data = await res.json();
     _token = data.access_token;
     _organizationId = data.organization_id;
+
+    const expiresIn = data.expires_in || 24 * 3600;
+    _scheduleTokenRefresh(expiresIn);
     return true;
   } catch (err) {
     console.error('[CoreOutline] Authorization error:', err);
@@ -40,6 +64,21 @@ export async function initIngest(warehouseId, dataSourceId, dataSourceSecret) {
   }
 }
 
+export async function initIngest(warehouseId, dataSourceId, dataSourceSecret) {
+  _warehouseId = warehouseId;
+  _dataSourceId = dataSourceId;
+  _dataSourceSecret = dataSourceSecret;
+
+  return _doAuthorize(warehouseId, dataSourceId, dataSourceSecret);
+}
+
+async function _ensureFreshToken() {
+  if (_token) return;
+  if (_warehouseId && _dataSourceId && _dataSourceSecret) {
+    await _doAuthorize(_warehouseId, _dataSourceId, _dataSourceSecret);
+  }
+}
+
 export function trackEvent(eventType, payload) {
   if (!_token) return;
 
@@ -56,7 +95,8 @@ export function trackEvent(eventType, payload) {
   }
 }
 
-export function flush() {
+export async function flush() {
+  await _ensureFreshToken();
   if (!_token || _buffer.length === 0) return;
 
   const events = _buffer.splice(0, _buffer.length);
@@ -85,6 +125,7 @@ export function flush() {
 }
 
 export async function sendRrwebBatch(chunks, sessionId) {
+  await _ensureFreshToken();
   if (!_token || !chunks || chunks.length === 0) return;
 
   try {