@topolo/sdk 0.2.6 → 0.2.8

package/dist/index.js

@@ -64,8 +64,10 @@ var SERVICES = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://r2-media-manager-worker.topolo.workers.dev",
   calendar: "https://calendar.topolo.app",
+  capacity: "https://topolo-capacity.topolo.workers.dev",
   chat: "https://chat.topolo.app",
   commerce: "https://topolo-commerce-api.topolo.workers.dev",
+  compose: "https://compose.topolo.app",
   crm: "https://crm-api.topolo.app",
   customer_success: "https://customer-success.topolo.app",
   feed: "https://topolo-feed-api.topolo.app",
@@ -79,6 +81,7 @@ var SERVICES = {
   mdm: "https://topolo-mdm-api.topolo.app",
   messaging: "https://messages.topolo.app",
   nexus: "https://topolo-nexus-gateway.topolo.workers.dev",
+  notify: "https://notify.topolo.app",
   one: "https://one.topolo.app",
   pay: "https://topolo-pay.topolo.workers.dev",
   people: "https://people.topolo.app",
@@ -95,12 +98,14 @@ var SERVICES = {
 };
 var PLATFORM_SERVICE_IDS = {
   books: "srv_topolo_books",
+  compose: "srv_topolo_compose",
   crm: "srv_iCwM4jGXcwlj",
   customer_success: "srv_topolo_customer_success",
   flow: "srv_topolo_flow",
   forms: "srv_topolo_forms",
   insights: "srv_topolo_insights",
   inventory: "srv_topolo_inventory",
+  notify: "svc_topolo_notify",
   people: "srv_topolo_people",
   sign: "srv_topolo_sign",
   survey: "srv_topolo_survey",
@@ -279,6 +284,29 @@ var APPLICATIONS = {
       }
     ]
   },
+  "capacity": {
+    "id": "capacity",
+    "appDir": "TopoloCapacity",
+    "name": "topolo-capacity",
+    "packageName": "topolo-capacity",
+    "productionUrl": "https://capacity.topolo.app",
+    "services": [
+      "capacity"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-capacity",
+        "kind": "worker",
+        "apiUrl": "https://topolo-capacity.topolo.workers.dev",
+        "domains": [
+          "capacity.topolo.app",
+          "topolo-capacity.topolo.workers.dev"
+        ],
+        "routes": [],
+        "serviceId": "capacity"
+      }
+    ]
+  },
   "chat": {
     "id": "chat",
     "appDir": "TopoloChat",
@@ -376,6 +404,30 @@ var APPLICATIONS = {
       }
     ]
   },
+  "compose": {
+    "id": "compose",
+    "appDir": "TopoloCompose",
+    "name": "topolo-compose",
+    "packageName": "@topolo/compose",
+    "productionUrl": "https://compose.topolo.app",
+    "services": [
+      "compose"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-compose",
+        "kind": "worker",
+        "apiUrl": "https://compose.topolo.app",
+        "domains": [
+          "compose.topolo.app"
+        ],
+        "routes": [
+          "compose.topolo.app"
+        ],
+        "serviceId": "compose"
+      }
+    ]
+  },
   "crm": {
     "id": "crm",
     "appDir": "TopoloCRM",
@@ -793,6 +845,30 @@ var APPLICATIONS = {
       }
     ]
   },
+  "notify": {
+    "id": "notify",
+    "appDir": "TopoloNotify",
+    "name": "topolo-notify",
+    "packageName": "@topolo/notify",
+    "productionUrl": "https://notify.topolo.app",
+    "services": [
+      "notify"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-notify",
+        "kind": "worker",
+        "apiUrl": "https://notify.topolo.app",
+        "domains": [
+          "notify.topolo.app"
+        ],
+        "routes": [
+          "notify.topolo.app"
+        ],
+        "serviceId": "notify"
+      }
+    ]
+  },
   "one": {
     "id": "one",
     "appDir": "TopoloOne",
@@ -1969,6 +2045,7 @@ function validateWidget(widget, path, errors) {
   validateNonEmptyString(widget.serviceId, `${path}.serviceId`, errors);
   validateNonEmptyString(widget.serviceName, `${path}.serviceName`, errors);
   validateNonEmptyString(widget.lastUpdated, `${path}.lastUpdated`, errors);
+  validateSnapshotMetadata(widget.snapshot, `${path}.snapshot`, errors);
   switch (widget.type) {
     case "stats":
       validateArray(widget.stats, `${path}.stats`, errors);
@@ -1999,6 +2076,40 @@ function validateWidget(widget, path, errors) {
       errors.push(`${path}.type must be a supported Topolo widget type`);
   }
 }
+function validateSnapshotMetadata(snapshot, path, errors) {
+  if (snapshot === void 0) {
+    return;
+  }
+  if (!isRecord(snapshot)) {
+    errors.push(`${path} must be an object when provided`);
+    return;
+  }
+  if (snapshot.defaultMetricKeys !== void 0 && !Array.isArray(snapshot.defaultMetricKeys)) {
+    errors.push(`${path}.defaultMetricKeys must be an array when provided`);
+  }
+  if (snapshot.highlights !== void 0 && !Array.isArray(snapshot.highlights)) {
+    errors.push(`${path}.highlights must be an array when provided`);
+  }
+  if (snapshot.availableMetrics === void 0) {
+    return;
+  }
+  if (!Array.isArray(snapshot.availableMetrics)) {
+    errors.push(`${path}.availableMetrics must be an array when provided`);
+    return;
+  }
+  snapshot.availableMetrics.forEach((metric, index) => {
+    const metricPath = `${path}.availableMetrics[${index}]`;
+    if (!isRecord(metric)) {
+      errors.push(`${metricPath} must be an object`);
+      return;
+    }
+    validateNonEmptyString(metric.key, `${metricPath}.key`, errors);
+    validateNonEmptyString(metric.label, `${metricPath}.label`, errors);
+    if (typeof metric.value !== "number" || Number.isNaN(metric.value)) {
+      errors.push(`${metricPath}.value must be a number`);
+    }
+  });
+}
 function validateNonEmptyString(value, path, errors) {
   if (typeof value !== "string" || value.trim().length === 0) {
     errors.push(`${path} must be a non-empty string`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/sdk",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Typed client SDK for the Topolo platform. Used by TopoloCli, TopoloMCP, and third-party agents.",
   "type": "module",
   "main": "./dist/index.js",

package/src/applications.generated.ts

@@ -173,6 +173,29 @@ export const APPLICATIONS = {
       }
     ]
   },
+  "capacity": {
+    "id": "capacity",
+    "appDir": "TopoloCapacity",
+    "name": "topolo-capacity",
+    "packageName": "topolo-capacity",
+    "productionUrl": "https://capacity.topolo.app",
+    "services": [
+      "capacity"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-capacity",
+        "kind": "worker",
+        "apiUrl": "https://topolo-capacity.topolo.workers.dev",
+        "domains": [
+          "capacity.topolo.app",
+          "topolo-capacity.topolo.workers.dev"
+        ],
+        "routes": [],
+        "serviceId": "capacity"
+      }
+    ]
+  },
   "chat": {
     "id": "chat",
     "appDir": "TopoloChat",
@@ -270,6 +293,30 @@ export const APPLICATIONS = {
       }
     ]
   },
+  "compose": {
+    "id": "compose",
+    "appDir": "TopoloCompose",
+    "name": "topolo-compose",
+    "packageName": "@topolo/compose",
+    "productionUrl": "https://compose.topolo.app",
+    "services": [
+      "compose"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-compose",
+        "kind": "worker",
+        "apiUrl": "https://compose.topolo.app",
+        "domains": [
+          "compose.topolo.app"
+        ],
+        "routes": [
+          "compose.topolo.app"
+        ],
+        "serviceId": "compose"
+      }
+    ]
+  },
   "crm": {
     "id": "crm",
     "appDir": "TopoloCRM",
@@ -687,6 +734,30 @@ export const APPLICATIONS = {
       }
     ]
   },
+  "notify": {
+    "id": "notify",
+    "appDir": "TopoloNotify",
+    "name": "topolo-notify",
+    "packageName": "@topolo/notify",
+    "productionUrl": "https://notify.topolo.app",
+    "services": [
+      "notify"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-notify",
+        "kind": "worker",
+        "apiUrl": "https://notify.topolo.app",
+        "domains": [
+          "notify.topolo.app"
+        ],
+        "routes": [
+          "notify.topolo.app"
+        ],
+        "serviceId": "notify"
+      }
+    ]
+  },
   "one": {
     "id": "one",
     "appDir": "TopoloOne",

package/src/index.ts

@@ -4,8 +4,8 @@ export {
   type RequestOptions,
   type CredentialIntrospection,
   type TopoloDebugEvent,
-} from './client.js';
-export type { TopoloCredential, AgentIdentity } from './auth.js';
+} from "./client.js";
+export type { TopoloCredential, AgentIdentity } from "./auth.js";
 export {
   DEFAULT_SERVICE_URLS,
   APPLICATIONS,
@@ -29,21 +29,26 @@ export {
   type ApplicationRequirementStatus,
   type ApplicationRequirementsAuditReport,
   type ServiceId,
-} from './services.js';
+} from "./services.js";
 export {
   TopoloSdkError,
   TopoloAuthError,
   TopoloPermissionError,
   TopoloHttpError,
-} from './errors.js';
-export { CrmModule, type CrmContactSummary, type ListContactsOptions, type ListContactsResult } from './modules/crm.js';
-export { IdentityModule } from './modules/identity.js';
+} from "./errors.js";
+export {
+  CrmModule,
+  type CrmContactSummary,
+  type ListContactsOptions,
+  type ListContactsResult,
+} from "./modules/crm.js";
+export { IdentityModule } from "./modules/identity.js";
 export {
   TopoloOAuth,
   type OAuthHelperOptions,
   type DeviceAuthorizationResponse,
   type TokenResponse,
-} from './oauth.js';
+} from "./oauth.js";
 export {
   TOPOLO_WIDGET_ENDPOINT,
   TOPOLO_WIDGET_REFRESH_INTERVAL_MS,
@@ -70,13 +75,15 @@ export {
   type TopoloWidgetMetric,
   type TopoloWidgetNotificationItem,
   type TopoloWidgetResponseOptions,
+  type TopoloWidgetSnapshotMetadata,
+  type TopoloWidgetSnapshotMetric,
   type TopoloWidgetType,
   type TopoloWidgetValidationResult,
-} from './widgets.js';
+} from "./widgets.js";
 
-import { TopoloClient, type TopoloClientOptions } from './client.js';
-import { CrmModule } from './modules/crm.js';
-import { IdentityModule } from './modules/identity.js';
+import { TopoloClient, type TopoloClientOptions } from "./client.js";
+import { CrmModule } from "./modules/crm.js";
+import { IdentityModule } from "./modules/identity.js";
 
 /**
  * Convenience factory that returns a ready-to-use typed Topolo client plus

package/src/services.generated.ts

@@ -9,8 +9,10 @@ export const SERVICES = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://r2-media-manager-worker.topolo.workers.dev",
   calendar: "https://calendar.topolo.app",
+  capacity: "https://topolo-capacity.topolo.workers.dev",
   chat: "https://chat.topolo.app",
   commerce: "https://topolo-commerce-api.topolo.workers.dev",
+  compose: "https://compose.topolo.app",
   crm: "https://crm-api.topolo.app",
   customer_success: "https://customer-success.topolo.app",
   feed: "https://topolo-feed-api.topolo.app",
@@ -24,6 +26,7 @@ export const SERVICES = {
   mdm: "https://topolo-mdm-api.topolo.app",
   messaging: "https://messages.topolo.app",
   nexus: "https://topolo-nexus-gateway.topolo.workers.dev",
+  notify: "https://notify.topolo.app",
   one: "https://one.topolo.app",
   pay: "https://topolo-pay.topolo.workers.dev",
   people: "https://people.topolo.app",
@@ -43,12 +46,14 @@ export type ServiceId = keyof typeof SERVICES;
 
 export const PLATFORM_SERVICE_IDS: Partial<Record<ServiceId, string>> = {
   books: "srv_topolo_books",
+  compose: "srv_topolo_compose",
   crm: "srv_iCwM4jGXcwlj",
   customer_success: "srv_topolo_customer_success",
   flow: "srv_topolo_flow",
   forms: "srv_topolo_forms",
   insights: "srv_topolo_insights",
   inventory: "srv_topolo_inventory",
+  notify: "svc_topolo_notify",
   people: "srv_topolo_people",
   sign: "srv_topolo_sign",
   survey: "srv_topolo_survey",

package/src/services.test.ts

@@ -18,10 +18,12 @@ const EXPECTED_APPLICATION_IDS = [
   'bugfix',
   'bytes',
   'calendar',
+  'capacity',
   'chat',
   'cli',
   'cloudcontrol',
   'commerce',
+  'compose',
   'crm',
   'customer_success',
   'developers',
@@ -38,6 +40,7 @@ const EXPECTED_APPLICATION_IDS = [
   'mdm',
   'messaging',
   'nexus',
+  'notify',
   'one',
   'pay',
   'people',

package/src/widgets.test.ts

@@ -1,27 +1,27 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it } from "vitest";
 import {
   createTopoloWidgetError,
   createTopoloWidgetResponse,
   TOPOLO_WIDGET_ENDPOINT,
   TOPOLO_WIDGET_REFRESH_INTERVAL_MS,
   validateTopoloWidgetResponse,
-} from './widgets.js';
+} from "./widgets.js";
 
-describe('Topolo widget contract', () => {
-  it('exports the platform widget endpoint defaults', () => {
-    expect(TOPOLO_WIDGET_ENDPOINT).toBe('/api/widget');
+describe("Topolo widget contract", () => {
+  it("exports the platform widget endpoint defaults", () => {
+    expect(TOPOLO_WIDGET_ENDPOINT).toBe("/api/widget");
     expect(TOPOLO_WIDGET_REFRESH_INTERVAL_MS).toBe(60_000);
   });
 
-  it('stamps service metadata and timestamp onto widget drafts', () => {
+  it("stamps service metadata and timestamp onto widget drafts", () => {
     const response = createTopoloWidgetResponse({
-      serviceId: 'srv_bytes',
-      serviceName: 'Bytes',
-      now: '2026-04-25T00:00:00.000Z',
+      serviceId: "srv_bytes",
+      serviceName: "Bytes",
+      now: "2026-04-25T00:00:00.000Z",
       widgets: [
         {
-          type: 'stats',
-          stats: [{ label: 'Files', value: 12 }],
+          type: "stats",
+          stats: [{ key: "files", label: "Files", value: 12 }],
         },
       ],
     });
@@ -30,63 +30,63 @@ describe('Topolo widget contract', () => {
       success: true,
       widgets: [
         {
-          serviceId: 'srv_bytes',
-          serviceName: 'Bytes',
-          lastUpdated: '2026-04-25T00:00:00.000Z',
-          type: 'stats',
-          stats: [{ label: 'Files', value: 12 }],
+          serviceId: "srv_bytes",
+          serviceName: "Bytes",
+          lastUpdated: "2026-04-25T00:00:00.000Z",
+          type: "stats",
+          stats: [{ key: "files", label: "Files", value: 12 }],
         },
       ],
     });
   });
 
-  it('keeps explicit widget metadata when an app needs multiple service cards', () => {
+  it("keeps explicit widget metadata when an app needs multiple service cards", () => {
     const response = createTopoloWidgetResponse({
-      serviceId: 'srv_platform',
-      serviceName: 'Platform',
-      now: '2026-04-25T00:00:00.000Z',
+      serviceId: "srv_platform",
+      serviceName: "Platform",
+      now: "2026-04-25T00:00:00.000Z",
       widgets: [
         {
-          serviceId: 'srv_crm',
-          serviceName: 'CRM',
-          lastUpdated: '2026-04-24T23:00:00.000Z',
-          type: 'stats',
-          stats: [{ label: 'Contacts', value: 3 }],
+          serviceId: "srv_crm",
+          serviceName: "CRM",
+          lastUpdated: "2026-04-24T23:00:00.000Z",
+          type: "stats",
+          stats: [{ label: "Contacts", value: 3 }],
         },
       ],
     });
 
     expect(response.widgets[0]).toMatchObject({
-      serviceId: 'srv_crm',
-      serviceName: 'CRM',
-      lastUpdated: '2026-04-24T23:00:00.000Z',
+      serviceId: "srv_crm",
+      serviceName: "CRM",
+      lastUpdated: "2026-04-24T23:00:00.000Z",
     });
   });
 
-  it('returns a stable error response shape', () => {
-    expect(createTopoloWidgetError('not configured')).toEqual({
+  it("returns a stable error response shape", () => {
+    expect(createTopoloWidgetError("not configured")).toEqual({
       success: false,
       widgets: [],
-      error: 'not configured',
+      error: "not configured",
     });
   });
 
-  it('validates a compliant response', () => {
+  it("validates a compliant response", () => {
     const response = createTopoloWidgetResponse({
-      serviceId: 'srv_crm',
-      serviceName: 'CRM',
-      now: '2026-04-25T00:00:00.000Z',
+      serviceId: "srv_crm",
+      serviceName: "CRM",
+      now: "2026-04-25T00:00:00.000Z",
       widgets: [
         {
-          type: 'notifications',
+          type: "notifications",
           unreadCount: 1,
           notifications: [
             {
-              id: 'n_1',
-              title: 'New lead',
-              message: 'A lead was created.',
-              type: 'info',
-              timestamp: '2026-04-25T00:00:00.000Z',
+              id: "n_1",
+              title: "New lead",
+              message: "A lead was created.",
+              type: "info",
+              timestamp: "2026-04-25T00:00:00.000Z",
               read: false,
             },
           ],
@@ -100,24 +100,63 @@ describe('Topolo widget contract', () => {
     });
   });
 
-  it('reports missing metadata and unsupported widget types', () => {
+  it("keeps optional snapshot metadata for configurable TopoloOne datapoints", () => {
+    const response = createTopoloWidgetResponse({
+      serviceId: "srv_admin",
+      serviceName: "Admin",
+      now: "2026-04-28T00:00:00.000Z",
+      widgets: [
+        {
+          type: "stats",
+          stats: [{ label: "Team Members", value: 5 }],
+          snapshot: {
+            presetKey: "admin_morning_snapshot",
+            defaultMetricKeys: ["team_members"],
+            availableMetrics: [
+              {
+                key: "team_members",
+                label: "Team Members",
+                value: 5,
+                unit: "count",
+              },
+            ],
+          },
+        },
+      ],
+    });
+
+    expect(validateTopoloWidgetResponse(response)).toEqual({
+      ok: true,
+      errors: [],
+    });
+    expect(response.widgets[0]).toMatchObject({
+      snapshot: {
+        defaultMetricKeys: ["team_members"],
+        availableMetrics: [
+          { key: "team_members", label: "Team Members", value: 5 },
+        ],
+      },
+    });
+  });
+
+  it("reports missing metadata and unsupported widget types", () => {
     const result = validateTopoloWidgetResponse({
       success: true,
       widgets: [
         {
-          serviceId: '',
-          serviceName: 'Bad App',
-          lastUpdated: '',
-          type: 'calendar',
+          serviceId: "",
+          serviceName: "Bad App",
+          lastUpdated: "",
+          type: "calendar",
         },
       ],
     });
 
     expect(result.ok).toBe(false);
     expect(result.errors).toEqual([
-      'widgets[0].serviceId must be a non-empty string',
-      'widgets[0].lastUpdated must be a non-empty string',
-      'widgets[0].type must be a supported Topolo widget type',
+      "widgets[0].serviceId must be a non-empty string",
+      "widgets[0].lastUpdated must be a non-empty string",
+      "widgets[0].type must be a supported Topolo widget type",
     ]);
   });
 });