powr-sdk-web 6.2.1 → 6.4.0

package/dist/index.js

@@ -76,6 +76,12 @@ Object.defineProperty(exports, "POWR_DENSITIES", {
     return _theme.POWR_DENSITIES;
   }
 });
+Object.defineProperty(exports, "POWR_IMPERSONATOR_KEY", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.POWR_IMPERSONATOR_KEY;
+  }
+});
 Object.defineProperty(exports, "POWR_SCHEMES", {
   enumerable: true,
   get: function get() {
@@ -220,6 +226,12 @@ Object.defineProperty(exports, "PowrBaseTools", {
     return _tools["default"];
   }
 });
+Object.defineProperty(exports, "PowrBaseTracker", {
+  enumerable: true,
+  get: function get() {
+    return _track.PowrBaseTracker;
+  }
+});
 Object.defineProperty(exports, "PowrBaseUploader", {
   enumerable: true,
   get: function get() {
@@ -244,6 +256,18 @@ Object.defineProperty(exports, "PowrCalendarStrip", {
     return _calendar["default"];
   }
 });
+Object.defineProperty(exports, "PowrImpersonationBar", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.PowrImpersonationBar;
+  }
+});
+Object.defineProperty(exports, "PowrLoginAsDialog", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.PowrLoginAsDialog;
+  }
+});
 Object.defineProperty(exports, "PowrOnboardingProvider", {
   enumerable: true,
   get: function get() {
@@ -304,6 +328,18 @@ Object.defineProperty(exports, "buildPowrSsoUrl", {
     return _sso.buildPowrSsoUrl;
   }
 });
+Object.defineProperty(exports, "canStartLoginAs", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.canStartLoginAs;
+  }
+});
+Object.defineProperty(exports, "clearImpersonator", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.clearImpersonator;
+  }
+});
 Object.defineProperty(exports, "clearStoredSession", {
   enumerable: true,
   get: function get() {
@@ -328,12 +364,24 @@ Object.defineProperty(exports, "defineOptionalAppStep", {
     return _onboarding.defineOptionalAppStep;
   }
 });
+Object.defineProperty(exports, "enterLoginAs", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.enterLoginAs;
+  }
+});
 Object.defineProperty(exports, "evaluateSteps", {
   enumerable: true,
   get: function get() {
     return _onboarding.evaluateSteps;
   }
 });
+Object.defineProperty(exports, "exitLoginAs", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.exitLoginAs;
+  }
+});
 Object.defineProperty(exports, "fetchThemePreference", {
   enumerable: true,
   get: function get() {
@@ -496,6 +544,12 @@ Object.defineProperty(exports, "profileNameStep", {
     return _onboarding.profileNameStep;
   }
 });
+Object.defineProperty(exports, "readImpersonator", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.readImpersonator;
+  }
+});
 Object.defineProperty(exports, "readStoredSession", {
   enumerable: true,
   get: function get() {
@@ -556,6 +610,12 @@ Object.defineProperty(exports, "usePowrThemeHost", {
     return _theme.usePowrThemeHost;
   }
 });
+Object.defineProperty(exports, "viewAsLabel", {
+  enumerable: true,
+  get: function get() {
+    return _impersonate.viewAsLabel;
+  }
+});
 Object.defineProperty(exports, "writeStoredSession", {
   enumerable: true,
   get: function get() {
@@ -591,5 +651,7 @@ var _sessionMessages = require("./utils/sessionMessages");
 var _theme = require("./theme");
 var _session = require("./session");
 var _shell = require("./shell");
+var _impersonate = require("./impersonate");
+var _track = require("./track");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }

package/dist/session/index.js

@@ -16,6 +16,7 @@ exports.usePowrSession = usePowrSession;
 exports.writeStoredSession = writeStoredSession;
 var _react = _interopRequireWildcard(require("react"));
 var _jwt = require("../utils/jwt");
+var _storage = require("../impersonate/storage");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
@@ -29,16 +30,16 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * Powr session — the file every new app used to copy (`utils/store.ts`).
- *
- * Owns `localStorage['auth-store']` in the zustand-persist shape
- * `{ state: { user, token }, version }` so:
- *  - `apiCall` (utils/auth.getAuthToken) keeps reading the bearer from it
- *  - apps that already run a zustand `auth-store` can pass `user`/`token`
- *    as props (controlled) and nothing moves.
- *
- * No zustand dependency. Plain React context.
+/**
+ * Powr session — the file every new app used to copy (`utils/store.ts`).
+ *
+ * Owns `localStorage['auth-store']` in the zustand-persist shape
+ * `{ state: { user, token }, version }` so:
+ *  - `apiCall` (utils/auth.getAuthToken) keeps reading the bearer from it
+ *  - apps that already run a zustand `auth-store` can pass `user`/`token`
+ *    as props (controlled) and nothing moves.
+ *
+ * No zustand dependency. Plain React context.
  */
 
 var POWR_SESSION_STORAGE_KEY = exports.POWR_SESSION_STORAGE_KEY = "auth-store";
@@ -111,14 +112,14 @@ var PowrSessionContext = /*#__PURE__*/(0, _react.createContext)(_objectSpread(_o
   clear: function clear() {}
 }));
 
-/**
- * @param {object} props
- * @param {object|null} [props.user] - Controlled mode: app's own store is truth.
- * @param {string|null} [props.token] - Controlled mode.
- * @param {string|null} [props.refreshToken]
- * @param {(session: {user, token, refreshToken}) => void} [props.onChange] - After setSession / clear.
- * @param {() => void} [props.onLogout] - Controlled mode: clear your store here.
- * @param {boolean} [props.persist=true] - Uncontrolled mode: write `auth-store`.
+/**
+ * @param {object} props
+ * @param {object|null} [props.user] - Controlled mode: app's own store is truth.
+ * @param {string|null} [props.token] - Controlled mode.
+ * @param {string|null} [props.refreshToken]
+ * @param {(session: {user, token, refreshToken}) => void} [props.onChange] - After setSession / clear.
+ * @param {() => void} [props.onLogout] - Controlled mode: clear your store here.
+ * @param {boolean} [props.persist=true] - Uncontrolled mode: write `auth-store`.
  */
 function PowrSessionProvider(_ref2) {
   var userProp = _ref2.user,
@@ -183,6 +184,7 @@ function PowrSessionProvider(_ref2) {
   }, [controlled, persist]);
   var clear = (0, _react.useCallback)(function () {
     var _onChangeRef$current2;
+    (0, _storage.clearImpersonator)();
     if (!controlled) {
       setLocal(EMPTY);
       clearStoredSession();

package/dist/shell/PowrBaseAppWrapper.js

@@ -16,6 +16,7 @@ var _PowrOnboardingProvider = _interopRequireDefault(require("../onboarding/Powr
 var _useMediaQuery = _interopRequireDefault(require("../utils/useMediaQuery"));
 var _styles = require("./styles");
 var _parts = require("./parts");
+var _impersonate = require("../impersonate");
 var _excluded = ["theme", "presets", "scheme", "density", "preset", "persistTheme", "user", "token", "refreshToken", "onSessionChange", "onLogout"];
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
@@ -36,16 +37,16 @@ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t =
 var config = require("../config");
 var POWR_SHELL_MODES = exports.POWR_SHELL_MODES = Object.freeze(["sidebar", "topbar"]);
 
-/**
- * PowrBaseAppWrapper — the one root mount for a Powr web app.
- *
- * Replaces the files every new app copied: auth store, route guards, top bar /
- * sidebar, login page glue, providers. Chrome + selectors live here; palette,
- * presets, logo, nav items, product roles and public pages stay in the product.
- *
- * Guardrails: no colours of its own (every colour is `var(--powr-*)`), more
- * than one shape (`sidebar` | `topbar`), no `next/*` import — `Link` and
- * `pathname` come in as props, like `apiUrl` does elsewhere.
+/**
+ * PowrBaseAppWrapper — the one root mount for a Powr web app.
+ *
+ * Replaces the files every new app copied: auth store, route guards, top bar /
+ * sidebar, login page glue, providers. Chrome + selectors live here; palette,
+ * presets, logo, nav items, product roles and public pages stay in the product.
+ *
+ * Guardrails: no colours of its own (every colour is `var(--powr-*)`), more
+ * than one shape (`sidebar` | `topbar`), no `next/*` import — `Link` and
+ * `pathname` come in as props, like `apiUrl` does elsewhere.
  */
 function PowrBaseAppWrapper(props) {
   var theme = props.theme,
@@ -82,6 +83,7 @@ function PowrBaseAppWrapper(props) {
   }, shell);
 }
 function Shell(_ref) {
+  var _readImpersonator;
   var _ref$mode = _ref.mode,
     mode = _ref$mode === void 0 ? "topbar" : _ref$mode,
     _ref$brand = _ref.brand,
@@ -136,6 +138,20 @@ function Shell(_ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     settingsOpen = _useState4[0],
     setSettingsOpen = _useState4[1];
+  var _useState5 = (0, _react.useState)(false),
+    _useState6 = _slicedToArray(_useState5, 2),
+    loginAsOpen = _useState6[0],
+    setLoginAsOpen = _useState6[1];
+  var viewingAs = Boolean(((_readImpersonator = (0, _impersonate.readImpersonator)()) === null || _readImpersonator === void 0 ? void 0 : _readImpersonator.token) && session.token);
+  var chromeOffset = _styles.HEADER_HEIGHT + (viewingAs ? 36 : 0);
+  var leaveAndSignOut = (0, _react.useCallback)(function () {
+    var pending = (0, _impersonate.notifyImpersonationExit)({
+      apiUrl: apiUrl,
+      projectId: projectId
+    });
+    session.clear();
+    pending["catch"](function () {});
+  }, [apiUrl, projectId, session]);
   var closeNav = (0, _react.useCallback)(function () {
     return setNavOpen(false);
   }, []);
@@ -214,8 +230,20 @@ function Shell(_ref) {
   var showBurger = narrow && nav.length > 0;
   var content = /*#__PURE__*/_react["default"].createElement("div", {
     style: _styles.s.root
-  }, /*#__PURE__*/_react["default"].createElement("header", {
-    style: _styles.s.header
+  }, /*#__PURE__*/_react["default"].createElement("div", {
+    style: {
+      position: "sticky",
+      top: 0,
+      zIndex: 40
+    }
+  }, /*#__PURE__*/_react["default"].createElement(_impersonate.PowrImpersonationBar, {
+    apiUrl: apiUrl,
+    projectId: projectId
+  }), /*#__PURE__*/_react["default"].createElement("header", {
+    style: _objectSpread(_objectSpread({}, _styles.s.header), {}, {
+      position: "relative",
+      top: "auto"
+    })
   }, showBurger ? /*#__PURE__*/_react["default"].createElement("button", {
     type: "button",
     "aria-label": "Menu",
@@ -247,16 +275,22 @@ function Shell(_ref) {
     onOpenSettings: showThemeSettings ? function () {
       return setSettingsOpen(true);
     } : null,
-    onLogout: session.clear
+    onLoginAs: (0, _impersonate.canStartLoginAs)(session) ? function () {
+      return setLoginAsOpen(true);
+    } : null,
+    onLogout: leaveAndSignOut
   }) : /*#__PURE__*/_react["default"].createElement(Link, {
     href: loginHref,
     style: _objectSpread(_objectSpread({}, _styles.s.navItem(false, false)), {}, {
       border: "1px solid ".concat(_styles.v.border)
     })
-  }, "Sign in"))), /*#__PURE__*/_react["default"].createElement("div", {
+  }, "Sign in")))), /*#__PURE__*/_react["default"].createElement("div", {
     style: _styles.s.body
   }, vertical && nav.length ? /*#__PURE__*/_react["default"].createElement("aside", {
-    style: _styles.s.sidebar
+    style: _objectSpread(_objectSpread({}, _styles.s.sidebar), {}, {
+      top: chromeOffset,
+      height: "calc(100vh - ".concat(chromeOffset, "px)")
+    })
   }, /*#__PURE__*/_react["default"].createElement(_parts.NavList, {
     items: nav,
     pathname: pathname,
@@ -281,6 +315,13 @@ function Shell(_ref) {
     open: settingsOpen,
     onClose: closeSettings,
     host: syncThemeWithHost && session.token ? themeHost : null
+  }), /*#__PURE__*/_react["default"].createElement(_impersonate.PowrLoginAsDialog, {
+    open: loginAsOpen,
+    onClose: function onClose() {
+      return setLoginAsOpen(false);
+    },
+    apiUrl: apiUrl,
+    projectId: projectId
   }));
   if (onboarding === false || !session.user) return content;
   return /*#__PURE__*/_react["default"].createElement(_PowrOnboardingProvider["default"], _extends({

package/dist/shell/parts.js

@@ -99,6 +99,7 @@ function ProfileMenu(_ref3) {
     adminHref = _ref3.adminHref,
     Link = _ref3.Link,
     onOpenSettings = _ref3.onOpenSettings,
+    onLoginAs = _ref3.onLoginAs,
     onLogout = _ref3.onLogout,
     _ref3$extraItems = _ref3.extraItems,
     extraItems = _ref3$extraItems === void 0 ? [] : _ref3$extraItems;
@@ -171,7 +172,17 @@ function ProfileMenu(_ref3) {
     }, item.icon ? /*#__PURE__*/_react["default"].createElement("span", {
       "aria-hidden": true
     }, item.icon) : null, " ", item.label);
-  }), onOpenSettings ? /*#__PURE__*/_react["default"].createElement("button", {
+  }), onLoginAs ? /*#__PURE__*/_react["default"].createElement("button", {
+    type: "button",
+    role: "menuitem",
+    onClick: function onClick() {
+      setOpen(false);
+      onLoginAs();
+    },
+    style: _styles.s.menuItem(false)
+  }, /*#__PURE__*/_react["default"].createElement("span", {
+    "aria-hidden": true
+  }, "\u21AA"), " Login as") : null, onOpenSettings ? /*#__PURE__*/_react["default"].createElement("button", {
     type: "button",
     role: "menuitem",
     onClick: function onClick() {

package/dist/shell/styles.js

@@ -9,9 +9,9 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * Shell styles. Every colour is a `--powr-*` var with today's neutral as the
- * fallback — the wrapper has no palette of its own (clone-leak guardrail).
+/**
+ * Shell styles. Every colour is a `--powr-*` var with today's neutral as the
+ * fallback — the wrapper has no palette of its own (clone-leak guardrail).
  */
 
 var v = exports.v = {

package/dist/sso/api.js

@@ -27,21 +27,21 @@ function safeNextPath(next) {
   return fallback;
 }
 
-/**
- * Issue a one-time login code (caller must already be authenticated).
- * Host `injectProjectId` needs destination `projectId` on the body.
- * @param {string} apiUrl - Powr API base
- * @param {string} bearerToken
- * @param {{ projectId?: string }} [opts]
+/**
+ * Issue a one-time login code (caller must already be authenticated).
+ * Host `injectProjectId` needs destination `projectId` on the body.
+ * @param {string} apiUrl - Powr API base
+ * @param {string} bearerToken
+ * @param {{ projectId?: string }} [opts]
  */
 function issueLoginCode(_x, _x2) {
   return _issueLoginCode.apply(this, arguments);
 }
-/**
- * Exchange loginId for session (same shape as /login).
- * @param {string} apiUrl
- * @param {string} loginId
- * @param {{ projectId?: string }} [opts]
+/**
+ * Exchange loginId for session (same shape as /login).
+ * @param {string} apiUrl
+ * @param {string} loginId
+ * @param {{ projectId?: string }} [opts]
  */
 function _issueLoginCode() {
   _issueLoginCode = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(apiUrl, bearerToken) {

package/dist/sso/index.js

@@ -145,22 +145,22 @@ var btnStyle = {
   cursor: "pointer"
 };
 
-/**
- * Cross-app SSO handoff UI (UrbanStall → Powr apps).
- * Apps keep a thin `/sso` page that renders this with `apiUrl` + `onSuccess`.
- *
- * @param {object} props
- * @param {string} [props.apiUrl] - Powr host. Defaults to https://powr-api.lawazia.tech
- * @param {string} [props.projectId] - Destination Powr id. Defaults to NEXT_PUBLIC_PROJECT_ID
- * @param {string} [props.appName]
- * @param {boolean} [props.ready=true] - Wait (e.g. auth hydrate) before exchanging code
- * @param {string} [props.loginHref="/login"]
- * @param {string} [props.loginId] - Defaults to ?loginId=
- * @param {string} [props.next] - Defaults to ?next=
- * @param {(data: object, ctx: { next: string, safeNext: string }) => void | Promise<void>} props.onSuccess
- * @param {string} [props.signingInTitle]
- * @param {string} [props.signingInMessage]
- * @param {string} [props.errorTitle]
+/**
+ * Cross-app SSO handoff UI (UrbanStall → Powr apps).
+ * Apps keep a thin `/sso` page that renders this with `apiUrl` + `onSuccess`.
+ *
+ * @param {object} props
+ * @param {string} [props.apiUrl] - Powr host. Defaults to https://powr-api.lawazia.tech
+ * @param {string} [props.projectId] - Destination Powr id. Defaults to NEXT_PUBLIC_PROJECT_ID
+ * @param {string} [props.appName]
+ * @param {boolean} [props.ready=true] - Wait (e.g. auth hydrate) before exchanging code
+ * @param {string} [props.loginHref="/login"]
+ * @param {string} [props.loginId] - Defaults to ?loginId=
+ * @param {string} [props.next] - Defaults to ?next=
+ * @param {(data: object, ctx: { next: string, safeNext: string }) => void | Promise<void>} props.onSuccess
+ * @param {string} [props.signingInTitle]
+ * @param {string} [props.signingInMessage]
+ * @param {string} [props.errorTitle]
  */
 function PowrBaseSso(_ref) {
   var apiUrl = _ref.apiUrl,

package/dist/sso/openPowrLogin.js

@@ -79,10 +79,10 @@ function resolvePowrApiUrl(apiUrl) {
   return "";
 }
 
-/**
- * @param {string} url
- * @param {string[]|Array<{url?: string, projectId?: string}>} [origins] - sibling card list or origins
- * @returns {{ origin: string, pathname: string, search: string, hash: string, projectId: string } | null}
+/**
+ * @param {string} url
+ * @param {string[]|Array<{url?: string, projectId?: string}>} [origins] - sibling card list or origins
+ * @returns {{ origin: string, pathname: string, search: string, hash: string, projectId: string } | null}
  */
 function matchPowrTarget(url, origins) {
   var dest = parseDest(url);
@@ -98,13 +98,13 @@ function matchPowrTarget(url, origins) {
   return dest;
 }
 
-/**
- * @deprecated Product `/powr` URLs are gone. Pass `apiUrl` + the card list as `origins`.
+/**
+ * @deprecated Product `/powr` URLs are gone. Pass `apiUrl` + the card list as `origins`.
  */
 var DEFAULT_POWR_TARGETS = exports.DEFAULT_POWR_TARGETS = [];
 
-/**
- * Build destination `/sso?loginId=` (+ optional `next`) on the sibling app.
+/**
+ * Build destination `/sso?loginId=` (+ optional `next`) on the sibling app.
  */
 function buildPowrSsoUrl(target, loginId) {
   var _ref = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {},
@@ -124,16 +124,16 @@ function openPlain(url) {
   window.open(url, "_blank", "noopener,noreferrer");
 }
 
-/**
- * Issue a login code and navigate to `/sso?loginId=`.
- * Host is the SDK default. Omit `apiUrl` unless this call is a real override.
- *
- * @param {string} url - Destination app URL (from the sibling card / banner)
- * @param {string|null|undefined} token
- * @param {object} [options]
- * @param {string} [options.apiUrl] - Override host. Do not pass product `/powr`.
- * @param {string} [options.projectId] - Destination Powr id (else from matched card)
- * @param {string[]|Array<{url?: string, projectId?: string}>} [options.origins] - The card list
+/**
+ * Issue a login code and navigate to `/sso?loginId=`.
+ * Host is the SDK default. Omit `apiUrl` unless this call is a real override.
+ *
+ * @param {string} url - Destination app URL (from the sibling card / banner)
+ * @param {string|null|undefined} token
+ * @param {object} [options]
+ * @param {string} [options.apiUrl] - Override host. Do not pass product `/powr`.
+ * @param {string} [options.projectId] - Destination Powr id (else from matched card)
+ * @param {string[]|Array<{url?: string, projectId?: string}>} [options.origins] - The card list
  */
 function openPowrLogin(_x, _x2) {
   return _openPowrLogin.apply(this, arguments);

package/dist/theme/PowrThemeProvider.js

@@ -54,25 +54,25 @@ function systemPrefersDark() {
   return window.matchMedia(DARK_QUERY).matches;
 }
 
-/**
- * Root of the Powr theme. Mount once per app (the future `PowrBaseAppWrapper`
- * mounts it for you). Structure (light / dark / density) is the SDK's;
- * colours come from the product via `theme` and `presets`.
- *
- * With no props it writes today's neutral values, so SDK components render
- * exactly as before.
- *
- * @param {object} props
- * @param {object} [props.theme] - Product tokens. Flat `{ primary, bg, … }` (light) or `{ light: {…}, dark: {…} }`.
- * @param {Array<{id: string, label?: string, tokens?: object, dark?: object}>} [props.presets] - Product-named presets users may pick.
- * @param {"light"|"dark"|"system"} [props.scheme="light"] - Starting scheme; the user can change it (card 2 panel).
- * @param {"comfortable"|"compact"} [props.density="comfortable"] - Starting density.
- * @param {string} [props.preset] - Starting preset id.
- * @param {string} [props.projectId] - Cache key scope. Defaults to NEXT_PUBLIC_PROJECT_ID.
- * @param {boolean} [props.persist=true] - Cache choices in localStorage (cache, not truth — host save is card 3).
- * @param {"root"|"scoped"} [props.attach="root"] - `root` writes vars on <html>; `scoped` wraps children in one div carrying the vars.
- * @param {string} [props.className] - For `scoped` only.
- * @param {(value: {scheme: string, density: string, preset: string|null}) => void} [props.onChange] - Fires when a selector changes.
+/**
+ * Root of the Powr theme. Mount once per app (the future `PowrBaseAppWrapper`
+ * mounts it for you). Structure (light / dark / density) is the SDK's;
+ * colours come from the product via `theme` and `presets`.
+ *
+ * With no props it writes today's neutral values, so SDK components render
+ * exactly as before.
+ *
+ * @param {object} props
+ * @param {object} [props.theme] - Product tokens. Flat `{ primary, bg, … }` (light) or `{ light: {…}, dark: {…} }`.
+ * @param {Array<{id: string, label?: string, tokens?: object, dark?: object}>} [props.presets] - Product-named presets users may pick.
+ * @param {"light"|"dark"|"system"} [props.scheme="light"] - Starting scheme; the user can change it (card 2 panel).
+ * @param {"comfortable"|"compact"} [props.density="comfortable"] - Starting density.
+ * @param {string} [props.preset] - Starting preset id.
+ * @param {string} [props.projectId] - Cache key scope. Defaults to NEXT_PUBLIC_PROJECT_ID.
+ * @param {boolean} [props.persist=true] - Cache choices in localStorage (cache, not truth — host save is card 3).
+ * @param {"root"|"scoped"} [props.attach="root"] - `root` writes vars on <html>; `scoped` wraps children in one div carrying the vars.
+ * @param {string} [props.className] - For `scoped` only.
+ * @param {(value: {scheme: string, density: string, preset: string|null}) => void} [props.onChange] - Fires when a selector changes.
  */
 function PowrThemeProvider(_ref) {
   var theme = _ref.theme,
@@ -304,10 +304,10 @@ var UNMOUNTED_THEME = function () {
   });
 }();
 
-/**
- * Read the theme. Outside a provider returns the neutral defaults and no-op
- * setters (`mounted: false`), so SDK components work in apps that have not
- * adopted the theme yet.
+/**
+ * Read the theme. Outside a provider returns the neutral defaults and no-op
+ * setters (`mounted: false`), so SDK components work in apps that have not
+ * adopted the theme yet.
  */
 function usePowrTheme() {
   var ctx = (0, _react.useContext)(PowrThemeContext);

package/dist/theme/PowrThemeSettings.js

@@ -24,16 +24,16 @@ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r)
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-/**
- * User-level theme selectors: scheme · density · product preset.
- *
- * Reads and writes through `usePowrTheme()`, so it needs a `PowrThemeProvider`
- * above it. Legacy apps mount this inside their own Settings page; the
- * wrapper opens it in a drawer. Presets come from the product — this panel
- * never invents colours (no colour wheel).
- *
- * `onSave` is the hook for card 3 (host `/users/me/preferences`). Until then
- * changes are live + cached in localStorage by the provider.
+/**
+ * User-level theme selectors: scheme · density · product preset.
+ *
+ * Reads and writes through `usePowrTheme()`, so it needs a `PowrThemeProvider`
+ * above it. Legacy apps mount this inside their own Settings page; the
+ * wrapper opens it in a drawer. Presets come from the product — this panel
+ * never invents colours (no colour wheel).
+ *
+ * `onSave` is the hook for card 3 (host `/users/me/preferences`). Until then
+ * changes are live + cached in localStorage by the provider.
  */
 
 var SCHEME_LABELS = {
@@ -169,15 +169,15 @@ function presetSwatches(preset, dark) {
   return [t.bg, t.surface, t.primary, t.text].filter(Boolean);
 }
 
-/**
- * @param {object} props
- * @param {string} [props.title="Appearance"]
- * @param {boolean} [props.showScheme=true]
- * @param {boolean} [props.showDensity=true]
- * @param {boolean} [props.showPresets=true] - Hidden automatically when the product passed no presets.
- * @param {(value: {scheme, density, preset}) => void|Promise<void>} [props.onSave] - Card 3: host save. Shows a Save button when given.
- * @param {boolean} [props.saving]
- * @param {string} [props.saveLabel="Save"]
+/**
+ * @param {object} props
+ * @param {string} [props.title="Appearance"]
+ * @param {boolean} [props.showScheme=true]
+ * @param {boolean} [props.showDensity=true]
+ * @param {boolean} [props.showPresets=true] - Hidden automatically when the product passed no presets.
+ * @param {(value: {scheme, density, preset}) => void|Promise<void>} [props.onSave] - Card 3: host save. Shows a Save button when given.
+ * @param {boolean} [props.saving]
+ * @param {string} [props.saveLabel="Save"]
  */
 function PowrThemeSettings(_ref2) {
   var _ref2$title = _ref2.title,

package/dist/theme/host.js

@@ -19,13 +19,13 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-/**
- * Theme preference on the Powr host — `GET/PUT /users/me/preferences`.
- *
- * localStorage is the cache before first paint; the host is the truth once
- * the user is logged in. Pull once per token, apply what the host has, and
- * write on Save. Same thesis as login: host stores, SDK reads/writes,
- * products omit `apiUrl`.
+/**
+ * Theme preference on the Powr host — `GET/PUT /users/me/preferences`.
+ *
+ * localStorage is the cache before first paint; the host is the truth once
+ * the user is logged in. Pull once per token, apply what the host has, and
+ * write on Save. Same thesis as login: host stores, SDK reads/writes,
+ * products omit `apiUrl`.
  */
 
 var ENDPOINT = "/users/me/preferences";
@@ -80,15 +80,15 @@ function _fetchThemePreference() {
 function saveThemePreference() {
   return _saveThemePreference.apply(this, arguments);
 }
-/**
- * Keep the mounted `PowrThemeProvider` in sync with the host for one user.
- *
- * @param {object} opts
- * @param {string|null} [opts.token] - Powr JWT. No token → nothing happens (cache only).
- * @param {string} [opts.apiUrl] - Leave unset; SDK default host.
- * @param {string} [opts.projectId] - Defaults to NEXT_PUBLIC_PROJECT_ID.
- * @param {boolean} [opts.enabled=true]
- * @returns {{ loaded: boolean, saving: boolean, error: string|null, save: (theme?) => Promise<void>, refresh: () => Promise<void> }}
+/**
+ * Keep the mounted `PowrThemeProvider` in sync with the host for one user.
+ *
+ * @param {object} opts
+ * @param {string|null} [opts.token] - Powr JWT. No token → nothing happens (cache only).
+ * @param {string} [opts.apiUrl] - Leave unset; SDK default host.
+ * @param {string} [opts.projectId] - Defaults to NEXT_PUBLIC_PROJECT_ID.
+ * @param {boolean} [opts.enabled=true]
+ * @returns {{ loaded: boolean, saving: boolean, error: string|null, save: (theme?) => Promise<void>, refresh: () => Promise<void> }}
  */
 function _saveThemePreference() {
   _saveThemePreference = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {