@tiendanube/live-state 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tiendanube/Nuvemshop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# @tiendanube/live-state
+
+> React library for rendering dynamic, context-aware notifications based on backend-computed state
+
+[![npm version](https://img.shields.io/npm/v/@tiendanube/live-state.svg)](https://www.npmjs.com/package/@tiendanube/live-state)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A generic React library for rendering live state notifications (banners, alerts) driven entirely by backend-computed state. Built for the Tiendanube/Nuvemshop ecosystem using the Nimbus Design System.
+
+---
+
+## Features
+
+- **Backend-controlled** — all content and logic comes from the API, zero hardcoding
+- **Type-safe** — full TypeScript support with strict types
+- **Analytics built-in** — automatic Amplitude + Clarity tracking for view, click, and close events
+- **Graceful degradation** — fails silently, never breaks the host application
+- **Nimbus Design System** — uses `@nimbus-ds/components`
+
+---
+
+## Installation
+
+```bash
+yarn add @tiendanube/live-state
+```
+
+Install peer dependencies if not already present:
+
+```bash
+yarn add react react-dom @nimbus-ds/components @nimbus-ds/icons
+```
+
+---
+
+## Quick start
+
+### 1. Add the provider
+
+```tsx
+import { LiveStateProvider } from '@tiendanube/live-state';
+
+async function fetchLiveState() {
+  try {
+    const res = await fetch('/api/lending/live-state', {
+      headers: { Authorization: `Bearer ${token}` },
+    });
+    return res.status === 204 ? null : res.json();
+  } catch {
+    return null;
+  }
+}
+
+function App() {
+  return (
+    <LiveStateProvider
+      fetcher={fetchLiveState}
+      analytics={{
+        amplitudeKey: process.env.REACT_APP_AMPLITUDE_KEY,
+        clarityProjectId: process.env.REACT_APP_CLARITY_PROJECT_ID,
+      }}
+    >
+      <YourApp />
+    </LiveStateProvider>
+  );
+}
+```
+
+### 2. Render notifications
+
+```tsx
+import { useLiveState, LiveStateRenderer } from '@tiendanube/live-state';
+
+function LendingNotifications() {
+  const { liveState, isLoading } = useLiveState();
+
+  return (
+    <LiveStateRenderer
+      data={liveState}
+      loading={isLoading}
+      trackingConfig={{ prefix: 'lending_', page: 'dashboard' }}
+    />
+  );
+}
+```
+
+That's it. The library handles rendering, tracking, and CTA behavior automatically.
+
+---
+
+## Documentation
+
+- [Implementation Guide](./docs/IMPLEMENTATION_GUIDE.md) — full integration guide with usage patterns, API reference, and troubleshooting
+- [Architecture](./docs/ARCHITECTURE.md) — internal design decisions
+- [Versioning & Release](./docs/VERSIONING_AND_RELEASE.md) — how to publish new versions
+- [CircleCI Setup](./docs/CIRCLECI_SETUP.md) — CI/CD configuration
+- [Contributing](./CONTRIBUTING.md) — developer contribution guide
+
+---
+
+## Contributing
+
+This is an internal Tiendanube/Nuvemshop library. For questions or issues, contact the team.
+
+---
+
+## License
+
+MIT © Tiendanube/Nuvemshop

package/dist/clarity-BvtWdaMS.js

@@ -0,0 +1,45 @@
+//#region node_modules/@microsoft/clarity/src/utils.js
+function e(e) {
+	try {
+		(function(e, t, n, r, i, a, o) {
+			t.getElementById("clarity-script") || (e[n] = e[n] || function() {
+				(e[n].q = e[n].q || []).push(arguments);
+			}, a = t.createElement(r), a.async = 1, a.src = "https://www.clarity.ms/tag/" + i + "?ref=npm", a.id = "clarity-script", o = t.getElementsByTagName(r)[0], o.parentNode.insertBefore(a, o));
+		})(window, document, "clarity", "script", e);
+		return;
+	} catch {
+		return;
+	}
+}
+//#endregion
+//#region node_modules/@microsoft/clarity/index.js
+var t = {
+	init(t) {
+		e(t, "clarity-script");
+	},
+	setTag(e, t) {
+		window.clarity("set", e, t);
+	},
+	identify(e, t, n, r) {
+		window.clarity("identify", e, t, n, r);
+	},
+	consent(e = !0) {
+		window.clarity("consent", e);
+	},
+	consentV2(e = {
+		ad_Storage: "granted",
+		analytics_Storage: "granted"
+	}) {
+		window.clarity("consentv2", e);
+	},
+	upgrade(e) {
+		window.clarity("upgrade", e);
+	},
+	event(e) {
+		window.clarity("event", e);
+	}
+};
+//#endregion
+export { t as default };
+
+//# sourceMappingURL=clarity-BvtWdaMS.js.map

package/dist/clarity-BvtWdaMS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity-BvtWdaMS.js","names":[],"sources":["../node_modules/@microsoft/clarity/src/utils.js","../node_modules/@microsoft/clarity/index.js"],"sourcesContent":["export function injectScript(projectId) {\r\n  try {\r\n    (function (c, l, a, r, i, t, y) {\r\n      if (l.getElementById(\"clarity-script\")) {\r\n        return;\r\n      }\r\n      c[a] = c[a] ||\r\n        function () {\r\n          (c[a].q = c[a].q || []).push(arguments);\r\n        };\r\n      t = l.createElement(r);\r\n      t.async = 1;\r\n      t.src = \"https://www.clarity.ms/tag/\" + i + \"?ref=npm\";\r\n      t.id = \"clarity-script\"\r\n      y = l.getElementsByTagName(r)[0];\r\n      y.parentNode.insertBefore(t, y);\r\n    })(window, document, \"clarity\", \"script\", projectId);\r\n    return;\r\n  } catch (error) {\r\n    return;\r\n  }\r\n};\r\n","import { injectScript } from \"./src/utils.js\"\r\n\r\nconst Clarity = {\r\n    init(projectId) {\r\n        injectScript(projectId, 'clarity-script');\r\n    },\r\n\r\n    setTag(key, value) {\r\n        window.clarity('set', key, value);\r\n    },\r\n\r\n    identify(customerId, customSessionId, customPageId, friendlyName) {\r\n        window.clarity('identify', customerId, customSessionId, customPageId, friendlyName);\r\n    },\r\n\r\n    consent(consent = true) {\r\n        window.clarity('consent', consent);\r\n    },\r\n\r\n    consentV2(consentOptions = { ad_Storage: 'granted', analytics_Storage: 'granted' }) {\r\n        window.clarity('consentv2', consentOptions);\r\n    },\r\n\r\n    upgrade(reason) {\r\n        window.clarity('upgrade', reason);\r\n    },\r\n\r\n    event(eventName) {\r\n        window.clarity('event', eventName);\r\n    },\r\n};\r\n\r\nexport default Clarity;\r\n"],"x_google_ignoreList":[0,1],"mappings":";AAAA,SAAgB,EAAa,GAAW;AACtC,KAAI;AACF,GAAC,SAAU,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG;AAC1B,KAAE,eAAe,iBAAiB,KAGtC,EAAE,KAAK,EAAE,MACP,WAAY;AACV,KAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,UAAU;MAE3C,IAAI,EAAE,cAAc,EAAE,EACtB,EAAE,QAAQ,GACV,EAAE,MAAM,gCAAgC,IAAI,YAC5C,EAAE,KAAK,kBACP,IAAI,EAAE,qBAAqB,EAAE,CAAC,IAC9B,EAAE,WAAW,aAAa,GAAG,EAAE;KAC9B,QAAQ,UAAU,WAAW,UAAU,EAAU;AACpD;SACc;AACd;;;;;ACjBJ,IAAM,IAAU;CACZ,KAAK,GAAW;AACZ,IAAa,GAAW,iBAAiB;;CAG7C,OAAO,GAAK,GAAO;AACf,SAAO,QAAQ,OAAO,GAAK,EAAM;;CAGrC,SAAS,GAAY,GAAiB,GAAc,GAAc;AAC9D,SAAO,QAAQ,YAAY,GAAY,GAAiB,GAAc,EAAa;;CAGvF,QAAQ,IAAU,IAAM;AACpB,SAAO,QAAQ,WAAW,EAAQ;;CAGtC,UAAU,IAAiB;EAAE,YAAY;EAAW,mBAAmB;EAAW,EAAE;AAChF,SAAO,QAAQ,aAAa,EAAe;;CAG/C,QAAQ,GAAQ;AACZ,SAAO,QAAQ,WAAW,EAAO;;CAGrC,MAAM,GAAW;AACb,SAAO,QAAQ,SAAS,EAAU;;CAEzC"}

package/dist/clarity-Dc6nPh3X.cjs

@@ -0,0 +1,2 @@
+function e(e){try{(function(e,t,n,r,i,a,o){t.getElementById(`clarity-script`)||(e[n]=e[n]||function(){(e[n].q=e[n].q||[]).push(arguments)},a=t.createElement(r),a.async=1,a.src=`https://www.clarity.ms/tag/`+i+`?ref=npm`,a.id=`clarity-script`,o=t.getElementsByTagName(r)[0],o.parentNode.insertBefore(a,o))})(window,document,`clarity`,`script`,e);return}catch{return}}var t={init(t){e(t,`clarity-script`)},setTag(e,t){window.clarity(`set`,e,t)},identify(e,t,n,r){window.clarity(`identify`,e,t,n,r)},consent(e=!0){window.clarity(`consent`,e)},consentV2(e={ad_Storage:`granted`,analytics_Storage:`granted`}){window.clarity(`consentv2`,e)},upgrade(e){window.clarity(`upgrade`,e)},event(e){window.clarity(`event`,e)}};exports.default=t;
+//# sourceMappingURL=clarity-Dc6nPh3X.cjs.map

package/dist/clarity-Dc6nPh3X.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity-Dc6nPh3X.cjs","names":[],"sources":["../node_modules/@microsoft/clarity/src/utils.js","../node_modules/@microsoft/clarity/index.js"],"sourcesContent":["export function injectScript(projectId) {\r\n  try {\r\n    (function (c, l, a, r, i, t, y) {\r\n      if (l.getElementById(\"clarity-script\")) {\r\n        return;\r\n      }\r\n      c[a] = c[a] ||\r\n        function () {\r\n          (c[a].q = c[a].q || []).push(arguments);\r\n        };\r\n      t = l.createElement(r);\r\n      t.async = 1;\r\n      t.src = \"https://www.clarity.ms/tag/\" + i + \"?ref=npm\";\r\n      t.id = \"clarity-script\"\r\n      y = l.getElementsByTagName(r)[0];\r\n      y.parentNode.insertBefore(t, y);\r\n    })(window, document, \"clarity\", \"script\", projectId);\r\n    return;\r\n  } catch (error) {\r\n    return;\r\n  }\r\n};\r\n","import { injectScript } from \"./src/utils.js\"\r\n\r\nconst Clarity = {\r\n    init(projectId) {\r\n        injectScript(projectId, 'clarity-script');\r\n    },\r\n\r\n    setTag(key, value) {\r\n        window.clarity('set', key, value);\r\n    },\r\n\r\n    identify(customerId, customSessionId, customPageId, friendlyName) {\r\n        window.clarity('identify', customerId, customSessionId, customPageId, friendlyName);\r\n    },\r\n\r\n    consent(consent = true) {\r\n        window.clarity('consent', consent);\r\n    },\r\n\r\n    consentV2(consentOptions = { ad_Storage: 'granted', analytics_Storage: 'granted' }) {\r\n        window.clarity('consentv2', consentOptions);\r\n    },\r\n\r\n    upgrade(reason) {\r\n        window.clarity('upgrade', reason);\r\n    },\r\n\r\n    event(eventName) {\r\n        window.clarity('event', eventName);\r\n    },\r\n};\r\n\r\nexport default Clarity;\r\n"],"x_google_ignoreList":[0,1],"mappings":"AAAA,SAAgB,EAAa,EAAW,CACtC,GAAI,EACD,SAAU,EAAG,EAAG,EAAG,EAAG,EAAG,EAAG,EAAG,CAC1B,EAAE,eAAe,iBAAiB,GAGtC,EAAE,GAAK,EAAE,IACP,UAAY,EACT,EAAE,GAAG,EAAI,EAAE,GAAG,GAAK,EAAE,EAAE,KAAK,UAAU,EAE3C,EAAI,EAAE,cAAc,EAAE,CACtB,EAAE,MAAQ,EACV,EAAE,IAAM,8BAAgC,EAAI,WAC5C,EAAE,GAAK,iBACP,EAAI,EAAE,qBAAqB,EAAE,CAAC,GAC9B,EAAE,WAAW,aAAa,EAAG,EAAE,IAC9B,OAAQ,SAAU,UAAW,SAAU,EAAU,CACpD,YACc,CACd,QCjBJ,IAAM,EAAU,CACZ,KAAK,EAAW,CACZ,EAAa,EAAW,iBAAiB,EAG7C,OAAO,EAAK,EAAO,CACf,OAAO,QAAQ,MAAO,EAAK,EAAM,EAGrC,SAAS,EAAY,EAAiB,EAAc,EAAc,CAC9D,OAAO,QAAQ,WAAY,EAAY,EAAiB,EAAc,EAAa,EAGvF,QAAQ,EAAU,GAAM,CACpB,OAAO,QAAQ,UAAW,EAAQ,EAGtC,UAAU,EAAiB,CAAE,WAAY,UAAW,kBAAmB,UAAW,CAAE,CAChF,OAAO,QAAQ,YAAa,EAAe,EAG/C,QAAQ,EAAQ,CACZ,OAAO,QAAQ,UAAW,EAAO,EAGrC,MAAM,EAAW,CACb,OAAO,QAAQ,QAAS,EAAU,EAEzC"}