@topolo/sdk 0.2.5 → 0.2.7

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,25 +29,61 @@ 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,
+  createTopoloWidgetError,
+  createTopoloWidgetResponse,
+  defineTopoloChartWidget,
+  defineTopoloNotificationsWidget,
+  defineTopoloQuickActionsWidget,
+  defineTopoloRecentActivityWidget,
+  defineTopoloStatsWidget,
+  validateTopoloWidgetResponse,
+  type TopoloChartWidget,
+  type TopoloNotificationsWidget,
+  type TopoloQuickActionsWidget,
+  type TopoloRecentActivityWidget,
+  type TopoloStatsWidget,
+  type TopoloWidget,
+  type TopoloWidgetActionItem,
+  type TopoloWidgetActivityItem,
+  type TopoloWidgetApiResponse,
+  type TopoloWidgetBase,
+  type TopoloWidgetConfig,
+  type TopoloWidgetDraft,
+  type TopoloWidgetMetric,
+  type TopoloWidgetNotificationItem,
+  type TopoloWidgetResponseOptions,
+  type TopoloWidgetSnapshotMetadata,
+  type TopoloWidgetSnapshotMetric,
+  type TopoloWidgetType,
+  type TopoloWidgetValidationResult,
+} 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',
@@ -135,6 +138,9 @@ describe('application requirements', () => {
     expect(APPLICATION_REQUIREMENTS.map((requirement) => requirement.id)).toContain(
       'shared-auth-boundary',
     );
+    expect(APPLICATION_REQUIREMENTS.map((requirement) => requirement.id)).toContain(
+      'native-dashboard-widget',
+    );
   });
 
   it('derives browser and API scopes from app metadata', () => {
@@ -158,6 +164,7 @@ describe('application requirements', () => {
     expect(adminRequirementIds).not.toContain('organization-scoped-data');
     expect(mailRequirementIds).toContain('organization-scoped-data');
     expect(mailRequirementIds).toContain('service-registration-and-scopes');
+    expect(mailRequirementIds).toContain('native-dashboard-widget');
     expect(cliRequirementIds).toContain('agent-and-operator-surfaces');
     expect(cliRequirementIds).not.toContain('service-registration-and-scopes');
   });

package/src/widgets.test.ts

@@ -0,0 +1,162 @@
+import { describe, expect, it } from "vitest";
+import {
+  createTopoloWidgetError,
+  createTopoloWidgetResponse,
+  TOPOLO_WIDGET_ENDPOINT,
+  TOPOLO_WIDGET_REFRESH_INTERVAL_MS,
+  validateTopoloWidgetResponse,
+} from "./widgets.js";
+
+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", () => {
+    const response = createTopoloWidgetResponse({
+      serviceId: "srv_bytes",
+      serviceName: "Bytes",
+      now: "2026-04-25T00:00:00.000Z",
+      widgets: [
+        {
+          type: "stats",
+          stats: [{ label: "Files", value: 12 }],
+        },
+      ],
+    });
+
+    expect(response).toEqual({
+      success: true,
+      widgets: [
+        {
+          serviceId: "srv_bytes",
+          serviceName: "Bytes",
+          lastUpdated: "2026-04-25T00:00:00.000Z",
+          type: "stats",
+          stats: [{ label: "Files", value: 12 }],
+        },
+      ],
+    });
+  });
+
+  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",
+      widgets: [
+        {
+          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",
+    });
+  });
+
+  it("returns a stable error response shape", () => {
+    expect(createTopoloWidgetError("not configured")).toEqual({
+      success: false,
+      widgets: [],
+      error: "not configured",
+    });
+  });
+
+  it("validates a compliant response", () => {
+    const response = createTopoloWidgetResponse({
+      serviceId: "srv_crm",
+      serviceName: "CRM",
+      now: "2026-04-25T00:00:00.000Z",
+      widgets: [
+        {
+          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",
+              read: false,
+            },
+          ],
+        },
+      ],
+    });
+
+    expect(validateTopoloWidgetResponse(response)).toEqual({
+      ok: true,
+      errors: [],
+    });
+  });
+
+  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",
+        },
+      ],
+    });
+
+    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",
+    ]);
+  });
+});