@topolo/sdk 0.2.6 → 0.2.7

package/dist/index.cjs

@@ -118,8 +118,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",
@@ -133,6 +135,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",
@@ -149,12 +152,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",
@@ -333,6 +338,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",
@@ -430,6 +458,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",
@@ -847,6 +899,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",
@@ -2023,6 +2099,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);
@@ -2053,6 +2130,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/dist/index.d.cts

@@ -38,8 +38,10 @@ declare const SERVICES: {
     readonly bugfix: "https://bugfix.topolo.app";
     readonly bytes: "https://r2-media-manager-worker.topolo.workers.dev";
     readonly calendar: "https://calendar.topolo.app";
+    readonly capacity: "https://topolo-capacity.topolo.workers.dev";
     readonly chat: "https://chat.topolo.app";
     readonly commerce: "https://topolo-commerce-api.topolo.workers.dev";
+    readonly compose: "https://compose.topolo.app";
     readonly crm: "https://crm-api.topolo.app";
     readonly customer_success: "https://customer-success.topolo.app";
     readonly feed: "https://topolo-feed-api.topolo.app";
@@ -53,6 +55,7 @@ declare const SERVICES: {
     readonly mdm: "https://topolo-mdm-api.topolo.app";
     readonly messaging: "https://messages.topolo.app";
     readonly nexus: "https://topolo-nexus-gateway.topolo.workers.dev";
+    readonly notify: "https://notify.topolo.app";
     readonly one: "https://one.topolo.app";
     readonly pay: "https://topolo-pay.topolo.workers.dev";
     readonly people: "https://people.topolo.app";
@@ -197,6 +200,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "calendar";
         }];
     };
+    readonly capacity: {
+        readonly id: "capacity";
+        readonly appDir: "TopoloCapacity";
+        readonly name: "topolo-capacity";
+        readonly packageName: "topolo-capacity";
+        readonly productionUrl: "https://capacity.topolo.app";
+        readonly services: readonly ["capacity"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-capacity";
+            readonly kind: "worker";
+            readonly apiUrl: "https://topolo-capacity.topolo.workers.dev";
+            readonly domains: readonly ["capacity.topolo.app", "topolo-capacity.topolo.workers.dev"];
+            readonly routes: readonly [];
+            readonly serviceId: "capacity";
+        }];
+    };
     readonly chat: {
         readonly id: "chat";
         readonly appDir: "TopoloChat";
@@ -268,6 +287,22 @@ declare const APPLICATIONS: {
             readonly serviceId: null;
         }];
     };
+    readonly compose: {
+        readonly id: "compose";
+        readonly appDir: "TopoloCompose";
+        readonly name: "topolo-compose";
+        readonly packageName: "@topolo/compose";
+        readonly productionUrl: "https://compose.topolo.app";
+        readonly services: readonly ["compose"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-compose";
+            readonly kind: "worker";
+            readonly apiUrl: "https://compose.topolo.app";
+            readonly domains: readonly ["compose.topolo.app"];
+            readonly routes: readonly ["compose.topolo.app"];
+            readonly serviceId: "compose";
+        }];
+    };
     readonly crm: {
         readonly id: "crm";
         readonly appDir: "TopoloCRM";
@@ -566,6 +601,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "nexus";
         }];
     };
+    readonly notify: {
+        readonly id: "notify";
+        readonly appDir: "TopoloNotify";
+        readonly name: "topolo-notify";
+        readonly packageName: "@topolo/notify";
+        readonly productionUrl: "https://notify.topolo.app";
+        readonly services: readonly ["notify"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-notify";
+            readonly kind: "worker";
+            readonly apiUrl: "https://notify.topolo.app";
+            readonly domains: readonly ["notify.topolo.app"];
+            readonly routes: readonly ["notify.topolo.app"];
+            readonly serviceId: "notify";
+        }];
+    };
     readonly one: {
         readonly id: "one";
         readonly appDir: "TopoloOne";
@@ -1244,13 +1295,14 @@ declare class TopoloOAuth {
 
 declare const TOPOLO_WIDGET_ENDPOINT = "/api/widget";
 declare const TOPOLO_WIDGET_REFRESH_INTERVAL_MS = 60000;
-type TopoloWidgetType = 'stats' | 'recent-activity' | 'quick-actions' | 'notifications' | 'chart';
+type TopoloWidgetType = "stats" | "recent-activity" | "quick-actions" | "notifications" | "chart";
 interface TopoloWidgetBase {
     serviceId: string;
     serviceName: string;
     serviceIcon?: string;
     type: TopoloWidgetType;
     lastUpdated: string;
+    snapshot?: TopoloWidgetSnapshotMetadata;
 }
 interface TopoloWidgetMetric {
     label: string;
@@ -1259,8 +1311,27 @@ interface TopoloWidgetMetric {
     changeLabel?: string;
     icon?: string;
 }
+interface TopoloWidgetSnapshotMetric {
+    key: string;
+    label: string;
+    value: number;
+    unit?: string;
+    change?: number;
+    changeLabel?: string;
+}
+interface TopoloWidgetSnapshotMetadata {
+    presetKey?: string;
+    audience?: string;
+    scope?: string;
+    scopeLabel?: string;
+    generatedAt?: string;
+    summary?: string;
+    defaultMetricKeys?: string[];
+    availableMetrics?: TopoloWidgetSnapshotMetric[];
+    highlights?: string[];
+}
 interface TopoloStatsWidget extends TopoloWidgetBase {
-    type: 'stats';
+    type: "stats";
     stats: TopoloWidgetMetric[];
 }
 interface TopoloWidgetActivityItem {
@@ -1272,7 +1343,7 @@ interface TopoloWidgetActivityItem {
     link?: string;
 }
 interface TopoloRecentActivityWidget extends TopoloWidgetBase {
-    type: 'recent-activity';
+    type: "recent-activity";
     activities: TopoloWidgetActivityItem[];
 }
 interface TopoloWidgetActionItem {
@@ -1283,26 +1354,26 @@ interface TopoloWidgetActionItem {
     primary?: boolean;
 }
 interface TopoloQuickActionsWidget extends TopoloWidgetBase {
-    type: 'quick-actions';
+    type: "quick-actions";
     actions: TopoloWidgetActionItem[];
 }
 interface TopoloWidgetNotificationItem {
     id: string;
     title: string;
     message: string;
-    type: 'info' | 'warning' | 'error' | 'success';
+    type: "info" | "warning" | "error" | "success";
     timestamp: string;
     read: boolean;
     link?: string;
 }
 interface TopoloNotificationsWidget extends TopoloWidgetBase {
-    type: 'notifications';
+    type: "notifications";
     notifications: TopoloWidgetNotificationItem[];
     unreadCount: number;
 }
 interface TopoloChartWidget extends TopoloWidgetBase {
-    type: 'chart';
-    chartType: 'line' | 'bar' | 'pie' | 'donut';
+    type: "chart";
+    chartType: "line" | "bar" | "pie" | "donut";
     title: string;
     data: {
         labels: string[];
@@ -1310,7 +1381,7 @@ interface TopoloChartWidget extends TopoloWidgetBase {
     };
 }
 type TopoloWidget = TopoloStatsWidget | TopoloRecentActivityWidget | TopoloQuickActionsWidget | TopoloNotificationsWidget | TopoloChartWidget;
-type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, 'serviceId' | 'serviceName' | 'lastUpdated'> & Partial<Pick<TopoloWidgetBase, 'serviceId' | 'serviceName' | 'lastUpdated'>>;
+type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, "serviceId" | "serviceName" | "lastUpdated"> & Partial<Pick<TopoloWidgetBase, "serviceId" | "serviceName" | "lastUpdated">>;
 type TopoloWidgetDraft = TopoloWidget extends infer Widget ? Widget extends TopoloWidget ? TopoloWidgetWithOptionalMetadata<Widget> : never : never;
 interface TopoloWidgetApiResponse {
     success: boolean;
@@ -1335,11 +1406,11 @@ interface TopoloWidgetConfig {
     enabled: boolean;
     refreshInterval: number;
 }
-declare function defineTopoloStatsWidget(widget: Omit<TopoloStatsWidget, 'type'>): TopoloStatsWidget;
-declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActivityWidget, 'type'>): TopoloRecentActivityWidget;
-declare function defineTopoloQuickActionsWidget(widget: Omit<TopoloQuickActionsWidget, 'type'>): TopoloQuickActionsWidget;
-declare function defineTopoloNotificationsWidget(widget: Omit<TopoloNotificationsWidget, 'type'>): TopoloNotificationsWidget;
-declare function defineTopoloChartWidget(widget: Omit<TopoloChartWidget, 'type'>): TopoloChartWidget;
+declare function defineTopoloStatsWidget(widget: Omit<TopoloStatsWidget, "type">): TopoloStatsWidget;
+declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActivityWidget, "type">): TopoloRecentActivityWidget;
+declare function defineTopoloQuickActionsWidget(widget: Omit<TopoloQuickActionsWidget, "type">): TopoloQuickActionsWidget;
+declare function defineTopoloNotificationsWidget(widget: Omit<TopoloNotificationsWidget, "type">): TopoloNotificationsWidget;
+declare function defineTopoloChartWidget(widget: Omit<TopoloChartWidget, "type">): TopoloChartWidget;
 declare function createTopoloWidgetResponse({ serviceId, serviceName, widgets, now, }: TopoloWidgetResponseOptions): TopoloWidgetApiResponse;
 declare function createTopoloWidgetError(error: string): TopoloWidgetApiResponse;
 declare function validateTopoloWidgetResponse(response: unknown): TopoloWidgetValidationResult;
@@ -1358,4 +1429,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetType, type TopoloWidgetValidationResult, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveServiceUrl, validateTopoloWidgetResponse };
+export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, 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, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveServiceUrl, validateTopoloWidgetResponse };

package/dist/index.d.ts

@@ -38,8 +38,10 @@ declare const SERVICES: {
     readonly bugfix: "https://bugfix.topolo.app";
     readonly bytes: "https://r2-media-manager-worker.topolo.workers.dev";
     readonly calendar: "https://calendar.topolo.app";
+    readonly capacity: "https://topolo-capacity.topolo.workers.dev";
     readonly chat: "https://chat.topolo.app";
     readonly commerce: "https://topolo-commerce-api.topolo.workers.dev";
+    readonly compose: "https://compose.topolo.app";
     readonly crm: "https://crm-api.topolo.app";
     readonly customer_success: "https://customer-success.topolo.app";
     readonly feed: "https://topolo-feed-api.topolo.app";
@@ -53,6 +55,7 @@ declare const SERVICES: {
     readonly mdm: "https://topolo-mdm-api.topolo.app";
     readonly messaging: "https://messages.topolo.app";
     readonly nexus: "https://topolo-nexus-gateway.topolo.workers.dev";
+    readonly notify: "https://notify.topolo.app";
     readonly one: "https://one.topolo.app";
     readonly pay: "https://topolo-pay.topolo.workers.dev";
     readonly people: "https://people.topolo.app";
@@ -197,6 +200,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "calendar";
         }];
     };
+    readonly capacity: {
+        readonly id: "capacity";
+        readonly appDir: "TopoloCapacity";
+        readonly name: "topolo-capacity";
+        readonly packageName: "topolo-capacity";
+        readonly productionUrl: "https://capacity.topolo.app";
+        readonly services: readonly ["capacity"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-capacity";
+            readonly kind: "worker";
+            readonly apiUrl: "https://topolo-capacity.topolo.workers.dev";
+            readonly domains: readonly ["capacity.topolo.app", "topolo-capacity.topolo.workers.dev"];
+            readonly routes: readonly [];
+            readonly serviceId: "capacity";
+        }];
+    };
     readonly chat: {
         readonly id: "chat";
         readonly appDir: "TopoloChat";
@@ -268,6 +287,22 @@ declare const APPLICATIONS: {
             readonly serviceId: null;
         }];
     };
+    readonly compose: {
+        readonly id: "compose";
+        readonly appDir: "TopoloCompose";
+        readonly name: "topolo-compose";
+        readonly packageName: "@topolo/compose";
+        readonly productionUrl: "https://compose.topolo.app";
+        readonly services: readonly ["compose"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-compose";
+            readonly kind: "worker";
+            readonly apiUrl: "https://compose.topolo.app";
+            readonly domains: readonly ["compose.topolo.app"];
+            readonly routes: readonly ["compose.topolo.app"];
+            readonly serviceId: "compose";
+        }];
+    };
     readonly crm: {
         readonly id: "crm";
         readonly appDir: "TopoloCRM";
@@ -566,6 +601,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "nexus";
         }];
     };
+    readonly notify: {
+        readonly id: "notify";
+        readonly appDir: "TopoloNotify";
+        readonly name: "topolo-notify";
+        readonly packageName: "@topolo/notify";
+        readonly productionUrl: "https://notify.topolo.app";
+        readonly services: readonly ["notify"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-notify";
+            readonly kind: "worker";
+            readonly apiUrl: "https://notify.topolo.app";
+            readonly domains: readonly ["notify.topolo.app"];
+            readonly routes: readonly ["notify.topolo.app"];
+            readonly serviceId: "notify";
+        }];
+    };
     readonly one: {
         readonly id: "one";
         readonly appDir: "TopoloOne";
@@ -1244,13 +1295,14 @@ declare class TopoloOAuth {
 
 declare const TOPOLO_WIDGET_ENDPOINT = "/api/widget";
 declare const TOPOLO_WIDGET_REFRESH_INTERVAL_MS = 60000;
-type TopoloWidgetType = 'stats' | 'recent-activity' | 'quick-actions' | 'notifications' | 'chart';
+type TopoloWidgetType = "stats" | "recent-activity" | "quick-actions" | "notifications" | "chart";
 interface TopoloWidgetBase {
     serviceId: string;
     serviceName: string;
     serviceIcon?: string;
     type: TopoloWidgetType;
     lastUpdated: string;
+    snapshot?: TopoloWidgetSnapshotMetadata;
 }
 interface TopoloWidgetMetric {
     label: string;
@@ -1259,8 +1311,27 @@ interface TopoloWidgetMetric {
     changeLabel?: string;
     icon?: string;
 }
+interface TopoloWidgetSnapshotMetric {
+    key: string;
+    label: string;
+    value: number;
+    unit?: string;
+    change?: number;
+    changeLabel?: string;
+}
+interface TopoloWidgetSnapshotMetadata {
+    presetKey?: string;
+    audience?: string;
+    scope?: string;
+    scopeLabel?: string;
+    generatedAt?: string;
+    summary?: string;
+    defaultMetricKeys?: string[];
+    availableMetrics?: TopoloWidgetSnapshotMetric[];
+    highlights?: string[];
+}
 interface TopoloStatsWidget extends TopoloWidgetBase {
-    type: 'stats';
+    type: "stats";
     stats: TopoloWidgetMetric[];
 }
 interface TopoloWidgetActivityItem {
@@ -1272,7 +1343,7 @@ interface TopoloWidgetActivityItem {
     link?: string;
 }
 interface TopoloRecentActivityWidget extends TopoloWidgetBase {
-    type: 'recent-activity';
+    type: "recent-activity";
     activities: TopoloWidgetActivityItem[];
 }
 interface TopoloWidgetActionItem {
@@ -1283,26 +1354,26 @@ interface TopoloWidgetActionItem {
     primary?: boolean;
 }
 interface TopoloQuickActionsWidget extends TopoloWidgetBase {
-    type: 'quick-actions';
+    type: "quick-actions";
     actions: TopoloWidgetActionItem[];
 }
 interface TopoloWidgetNotificationItem {
     id: string;
     title: string;
     message: string;
-    type: 'info' | 'warning' | 'error' | 'success';
+    type: "info" | "warning" | "error" | "success";
     timestamp: string;
     read: boolean;
     link?: string;
 }
 interface TopoloNotificationsWidget extends TopoloWidgetBase {
-    type: 'notifications';
+    type: "notifications";
     notifications: TopoloWidgetNotificationItem[];
     unreadCount: number;
 }
 interface TopoloChartWidget extends TopoloWidgetBase {
-    type: 'chart';
-    chartType: 'line' | 'bar' | 'pie' | 'donut';
+    type: "chart";
+    chartType: "line" | "bar" | "pie" | "donut";
     title: string;
     data: {
         labels: string[];
@@ -1310,7 +1381,7 @@ interface TopoloChartWidget extends TopoloWidgetBase {
     };
 }
 type TopoloWidget = TopoloStatsWidget | TopoloRecentActivityWidget | TopoloQuickActionsWidget | TopoloNotificationsWidget | TopoloChartWidget;
-type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, 'serviceId' | 'serviceName' | 'lastUpdated'> & Partial<Pick<TopoloWidgetBase, 'serviceId' | 'serviceName' | 'lastUpdated'>>;
+type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, "serviceId" | "serviceName" | "lastUpdated"> & Partial<Pick<TopoloWidgetBase, "serviceId" | "serviceName" | "lastUpdated">>;
 type TopoloWidgetDraft = TopoloWidget extends infer Widget ? Widget extends TopoloWidget ? TopoloWidgetWithOptionalMetadata<Widget> : never : never;
 interface TopoloWidgetApiResponse {
     success: boolean;
@@ -1335,11 +1406,11 @@ interface TopoloWidgetConfig {
     enabled: boolean;
     refreshInterval: number;
 }
-declare function defineTopoloStatsWidget(widget: Omit<TopoloStatsWidget, 'type'>): TopoloStatsWidget;
-declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActivityWidget, 'type'>): TopoloRecentActivityWidget;
-declare function defineTopoloQuickActionsWidget(widget: Omit<TopoloQuickActionsWidget, 'type'>): TopoloQuickActionsWidget;
-declare function defineTopoloNotificationsWidget(widget: Omit<TopoloNotificationsWidget, 'type'>): TopoloNotificationsWidget;
-declare function defineTopoloChartWidget(widget: Omit<TopoloChartWidget, 'type'>): TopoloChartWidget;
+declare function defineTopoloStatsWidget(widget: Omit<TopoloStatsWidget, "type">): TopoloStatsWidget;
+declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActivityWidget, "type">): TopoloRecentActivityWidget;
+declare function defineTopoloQuickActionsWidget(widget: Omit<TopoloQuickActionsWidget, "type">): TopoloQuickActionsWidget;
+declare function defineTopoloNotificationsWidget(widget: Omit<TopoloNotificationsWidget, "type">): TopoloNotificationsWidget;
+declare function defineTopoloChartWidget(widget: Omit<TopoloChartWidget, "type">): TopoloChartWidget;
 declare function createTopoloWidgetResponse({ serviceId, serviceName, widgets, now, }: TopoloWidgetResponseOptions): TopoloWidgetApiResponse;
 declare function createTopoloWidgetError(error: string): TopoloWidgetApiResponse;
 declare function validateTopoloWidgetResponse(response: unknown): TopoloWidgetValidationResult;
@@ -1358,4 +1429,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetType, type TopoloWidgetValidationResult, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveServiceUrl, validateTopoloWidgetResponse };
+export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, 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, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveServiceUrl, validateTopoloWidgetResponse };