@strata-ds/core 2.1.21 → 2.2.1

package/README.md

@@ -259,6 +259,9 @@ Wrap your application's root component with `StrataProvider`. This provider mana
 | `userDesignSystem` |                          `DesignSystemData`                          | Override design system data — useful for storybook, testing, or static mode. Takes precedence over `initialData`.                                                                                                                                            |
 | `onSyncError`      | `(error: { code: number; message: string; source: string }) => void` | Callback invoked when a sync cycle fails. `code` is the HTTP status (0 for non-HTTP errors), `message` is a human-readable description, and `source` is `"cdn"` or `"sync"`.                                                                                 |
 | `onSyncSuccess`    |                  `(data: DesignSystemData) => void`                  | Callback invoked whenever a sync cycle succeeds with new data.                                                                                                                                                                                               |
+| `reportUsage`      |                              `boolean`                               | Whether to send non-sensitive usage telemetry to power "See It in the Wild" in the dashboard. Defaults to `true` in production. Set to `false` to opt out.                                                                                           |
+| `appName`          |                               `string`                               | Optional human-readable display name for your app in the Strata dashboard (e.g. `"Storefront Web"`).                                                                                                                                                         |
+| `environment`      |                               `string`                               | Override automatic environment detection (`"production"`, `"staging"`, `"development"`). Heartbeat is paused when set to `"development"`.                                                                                                                   |
 
 ```tsx
 // app/layout.tsx (Next.js App Router)
@@ -307,6 +310,55 @@ Projects with `syncToken` set are only readable by clients that present the corr
 </StrataProvider>
 ```
 
+### Connected Apps Telemetry ("See It in the Wild")
+
+By default in production environments, `<StrataProvider>` sends a lightweight telemetry heartbeat every 5 minutes to report active design system surface integrations.
+
+#### What is "Connected Apps"?
+"Connected Apps" (featured as "See It in the Wild" on your public project page and Settings dashboard) provides real-time visibility into which live applications are consuming your design system, their active SDK version, environment, and health status (`Live`, `Stale`, or `Dormant`).
+
+#### Data Transmitted
+The telemetry heartbeat contains **only** non-sensitive metadata:
+- Application origin / hostname (e.g. `https://app.example.com`)
+- Strata SDK version (e.g. `2.2.0`)
+- Sync mode (`cdn`, `legacy`, `static`) and polling interval
+- User Agent string (browser family)
+- Optional `appName` prop value
+
+#### How to Opt Out
+To disable telemetry heartbeats entirely, set `reportUsage={false}`:
+
+```tsx
+<StrataProvider
+  syncEnabled={true}
+  projectId="YOUR_PROJECT_ID"
+  snapshotCdnBase="https://cdn.strata.charisol.io"
+  reportUsage={false}
+>
+  {children}
+</StrataProvider>
+```
+
+#### CLI Setup & Build-Time Registration
+You can also initialize project configuration using `npx strata init`:
+
+```bash
+npx strata init
+```
+
+This generates a `strata.json` configuration file:
+
+```json
+{
+  "projectId": "YOUR_PROJECT_ID",
+  "snapshotCdnBase": "https://cdn.strata.charisol.io",
+  "appName": "Storefront Web",
+  "reportUsage": true
+}
+```
+
+When `strata.json` is present, the `@strata-ds/core` `postinstall` script automatically registers build-time presence for your application.
+
 ## Using Design System Components
 
 `@strata-ds/core` provides dynamic access to your components defined in Strata.

package/dist/cli/postinstall.js

@@ -175,7 +175,7 @@ async function run() {
             const headers = { 'Content-Type': 'application/json' };
             if (syncToken)
                 headers['Authorization'] = `Bearer ${syncToken}`;
-            let sdkVersion = '2.1.20';
+            let sdkVersion = '2.2.0';
             try {
                 const pkgPath = path.resolve(__dirname, '../../package.json');
                 if (fs.existsSync(pkgPath)) {

package/dist/cli/snapshot.js

@@ -173,13 +173,20 @@ async function runInit() {
     const outputCss = (await askQuestion('Enter path to write CSS fallback file (default: ./src/styles/strata-fallbacks.css): ')) || './src/styles/strata-fallbacks.css';
     const varsOnlyInput = await askQuestion('Only output variables in snapshot JSON? (Y/n): ');
     const variablesOnly = varsOnlyInput.toLowerCase() !== 'n';
+    const appNameInput = await askQuestion('Enter Application Name (optional, e.g. "Storefront Web"): ');
+    const reportUsageInput = await askQuestion('Report usage telemetry to Strata Dashboard? (Y/n): ');
+    const reportUsage = reportUsageInput.toLowerCase() !== 'n';
     const config = {
         projectId,
         snapshotCdnBase: cdnBase,
         output,
         outputCss,
         variablesOnly,
+        reportUsage,
     };
+    if (appNameInput) {
+        config.appName = appNameInput;
+    }
     const strataJsonPath = path.join(process.cwd(), 'strata.json');
     fs.writeFileSync(strataJsonPath, JSON.stringify(config, null, 2), 'utf8');
     console.log(`\nConfig file written successfully to: ${strataJsonPath}`);

package/dist/index.esm.js

@@ -1166,7 +1166,7 @@ var HeartbeatReporter = /*#__PURE__*/function () {
               if (this.config.syncToken) {
                 headers["Authorization"] = "Bearer ".concat(this.config.syncToken);
               }
-              version = "2.1.21" ;
+              version = "2.2.1" ;
               body = {
                 origin: window.location.origin,
                 sdkVersion: version,

package/dist/index.js

@@ -1168,7 +1168,7 @@ var HeartbeatReporter = /*#__PURE__*/function () {
               if (this.config.syncToken) {
                 headers["Authorization"] = "Bearer ".concat(this.config.syncToken);
               }
-              version = "2.1.21" ;
+              version = "2.2.1" ;
               body = {
                 origin: window.location.origin,
                 sdkVersion: version,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@strata-ds/core",
-	"version": "2.1.21",
+	"version": "2.2.1",
 	"type": "module",
 	"description": "The runtime component library for Strata — design once, sync everywhere.",
 	"homepage": "https://strata.charisol.io",