@topolo/sdk 0.9.7 → 0.9.9

package/dist/index.d.cts

@@ -42,6 +42,39 @@ interface TopoloActionValidationResult {
 }
 declare function validateTopoloActionInput(schema: Record<string, unknown>, input: unknown): TopoloActionValidationResult;
 
+interface TopoloInlineBase64UploadContract {
+    profile: 'inline-base64';
+    contentField: string;
+    contentTypeField: string;
+    fileNameField: string;
+    maxBytes: number;
+    acceptedContentTypes: string[];
+}
+interface TopoloUrlSessionUploadContract {
+    profile: 'url-session';
+    fileNameField: string;
+    contentTypeField: string;
+    sizeField: string;
+    maxBytes: number;
+    acceptedContentTypes: string[];
+    uploadUrlPath: string;
+    uploadMethod: 'PUT' | 'POST';
+    complete?: {
+        actionId: string;
+        inputField: string;
+        responsePath: string;
+    };
+}
+type TopoloActionUploadContract = TopoloInlineBase64UploadContract | TopoloUrlSessionUploadContract;
+interface TopoloActionUploadOptions {
+    fileName: string;
+    contentType: string;
+    completionInput?: Record<string, unknown>;
+}
+declare function parseTopoloActionUploadContract(value: unknown): TopoloActionUploadContract;
+declare function prepareTopoloActionUploadInput(contractValue: unknown, content: Uint8Array | ArrayBuffer, input: Record<string, unknown>, options: TopoloActionUploadOptions): Record<string, unknown>;
+declare function prepareTopoloActionBase64UploadInput(contractValue: unknown, contentBase64: string, input: Record<string, unknown>, options: TopoloActionUploadOptions): Record<string, unknown>;
+
 interface TopoloClientOptions {
     credential: TopoloCredential;
     agent: AgentIdentity;
@@ -113,6 +146,8 @@ interface RequestOptions {
     method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     query?: Record<string, string | number | boolean | undefined>;
     body?: unknown;
+    /** Raw body transport for upload-session URLs. Mutually exclusive with body. */
+    rawBody?: BodyInit;
     /** Workspace-boundary resource context for resource-scoped API keys. */
     resource?: {
         resourceType: string;
@@ -223,6 +258,7 @@ interface TopoloActionAgentContract {
         description?: string;
         input?: Record<string, unknown>;
     }>;
+    upload?: TopoloActionUploadContract;
     [key: string]: unknown;
 }
 interface TopoloActionPlan {
@@ -356,6 +392,22 @@ declare class TopoloClient {
             resourceId: string;
         };
     }): Promise<T>;
+    uploadAction<T = unknown>(action: string, content: Uint8Array | ArrayBuffer, input: Record<string, unknown>, options: TopoloActionUploadOptions & {
+        confirm?: boolean;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<T>;
+    uploadActionBase64<T = unknown>(action: string, contentBase64: string, input: Record<string, unknown>, options: TopoloActionUploadOptions & {
+        confirm?: boolean;
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<T>;
+    private executeUrlSessionUpload;
+    private putUrlSessionContent;
     validateActionInput(action: string, input?: Record<string, unknown>): Promise<{
         action: TopoloActionCatalogEntry;
         validation: TopoloActionValidationResult;
@@ -476,6 +528,7 @@ declare const APP_API_URLS: {
     readonly agent: "https://agent.topolo.app";
     readonly auth: "https://auth.topolo.app";
     readonly backup: "https://backup.topolo.app";
+    readonly blog: "https://blog.topolo.app";
     readonly books: "https://books.topolo.app";
     readonly brand: "https://brand.topolo.app";
     readonly bugfix: "https://bugfix.topolo.app";
@@ -488,6 +541,7 @@ declare const APP_API_URLS: {
     readonly compose: "https://compose.topolo.app";
     readonly consent: "https://consent.topolo.app";
     readonly crm: "https://crm.topolo.app";
+    readonly design: "https://design.topolo.app";
     readonly developers: "https://developers.topolo.app";
     readonly director: "https://director.topolo.app";
     readonly feed: "https://feed.topolo.app";
@@ -561,7 +615,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://agent.topolo.app";
             readonly domains: readonly ["agent.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["agent.topolo.app"];
             readonly appId: "agent";
         }, {
             readonly name: "topolo-agent-api";
@@ -604,6 +658,29 @@ declare const APPLICATIONS: {
             readonly appId: "backup";
         }];
     };
+    readonly blog: {
+        readonly id: "blog";
+        readonly appDir: "TopoloBlog";
+        readonly name: "topolo-blog";
+        readonly packageName: "topolo-blog";
+        readonly productionUrl: "https://blog.topolo.app";
+        readonly services: readonly ["blog"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-blog";
+            readonly kind: "worker";
+            readonly apiUrl: "https://blog.topolo.app";
+            readonly domains: readonly ["blog.topolo.app"];
+            readonly routes: readonly ["blog.topolo.app"];
+            readonly appId: "blog";
+        }, {
+            readonly name: "topolo-blog-api";
+            readonly kind: "worker";
+            readonly apiUrl: null;
+            readonly domains: readonly [];
+            readonly routes: readonly [];
+            readonly appId: null;
+        }];
+    };
     readonly books: {
         readonly id: "books";
         readonly appDir: "TopoloBooks";
@@ -616,7 +693,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://books.topolo.app";
             readonly domains: readonly ["books.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["books.topolo.app"];
             readonly appId: "books";
         }, {
             readonly name: "topolo-books-api";
@@ -639,7 +716,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://brand.topolo.app";
             readonly domains: readonly ["brand.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["brand.topolo.app"];
             readonly appId: "brand";
         }, {
             readonly name: "topolo-brand-api";
@@ -724,7 +801,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://campaigns.topolo.app";
             readonly domains: readonly ["campaigns.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["campaigns.topolo.app"];
             readonly appId: "campaigns";
         }, {
             readonly name: "topolo-campaigns-api";
@@ -763,7 +840,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://chat.topolo.app";
             readonly domains: readonly ["chat.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["chat.topolo.app"];
             readonly appId: "chat";
         }, {
             readonly name: "topolo-chat-api";
@@ -823,7 +900,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://compose.topolo.app";
             readonly domains: readonly ["compose.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["compose.topolo.app"];
             readonly appId: "compose";
         }, {
             readonly name: "topolo-compose-api";
@@ -846,7 +923,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://consent.topolo.app";
             readonly domains: readonly ["consent.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["consent.topolo.app"];
             readonly appId: "consent";
         }, {
             readonly name: "topolo-consent-api";
@@ -876,10 +953,33 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://crm.topolo.app";
             readonly domains: readonly ["crm.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["crm.topolo.app"];
             readonly appId: "crm";
         }];
     };
+    readonly design: {
+        readonly id: "design";
+        readonly appDir: "TopoloDesign";
+        readonly name: "topolo-design";
+        readonly packageName: "@topolo-io/design";
+        readonly productionUrl: "https://design.topolo.app";
+        readonly services: readonly ["design"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-design";
+            readonly kind: "worker";
+            readonly apiUrl: "https://design.topolo.app";
+            readonly domains: readonly ["design.topolo.app"];
+            readonly routes: readonly ["design.topolo.app"];
+            readonly appId: "design";
+        }, {
+            readonly name: "topolo-design-api";
+            readonly kind: "worker";
+            readonly apiUrl: null;
+            readonly domains: readonly [];
+            readonly routes: readonly [];
+            readonly appId: null;
+        }];
+    };
     readonly developers: {
         readonly id: "developers";
         readonly appDir: "TopoloDevelopers";
@@ -899,7 +999,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://developers.topolo.app";
             readonly domains: readonly ["developers.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["developers.topolo.app"];
             readonly appId: "developers";
         }, {
             readonly name: "topolo-developers-api";
@@ -922,7 +1022,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://director.topolo.app";
             readonly domains: readonly ["director.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["director.topolo.app"];
             readonly appId: "director";
         }, {
             readonly name: "topolo-director-api";
@@ -998,7 +1098,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://flow.topolo.app";
             readonly domains: readonly ["flow.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["flow.topolo.app"];
             readonly appId: "flow";
         }, {
             readonly name: "topolo-flow-api";
@@ -1021,7 +1121,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://forecast.topolo.app";
             readonly domains: readonly ["forecast.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["forecast.topolo.app"];
             readonly appId: "forecast";
         }, {
             readonly name: "topolo-forecast-api";
@@ -1044,7 +1144,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://forms.topolo.app";
             readonly domains: readonly ["forms.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["forms.topolo.app"];
             readonly appId: "forms";
         }, {
             readonly name: "topolo-forms-api";
@@ -1090,7 +1190,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://insights.topolo.app";
             readonly domains: readonly ["insights.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["insights.topolo.app"];
             readonly appId: "insights";
         }, {
             readonly name: "topolo-insights-api";
@@ -1113,7 +1213,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://inventory.topolo.app";
             readonly domains: readonly ["inventory.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["inventory.topolo.app"];
             readonly appId: "inventory";
         }, {
             readonly name: "topolo-inventory-api";
@@ -1175,7 +1275,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://mail.topolo.app";
             readonly domains: readonly ["mail.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["mail.topolo.app"];
             readonly appId: "mail";
         }, {
             readonly name: "topolo-mail-api";
@@ -1359,7 +1459,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://pay.topolo.app";
             readonly domains: readonly ["pay.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["pay.topolo.app"];
             readonly appId: "pay";
         }, {
             readonly name: "topolo-pay-api";
@@ -1382,7 +1482,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://people.topolo.app";
             readonly domains: readonly ["people.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["people.topolo.app"];
             readonly appId: "people";
         }, {
             readonly name: "topolo-people-api";
@@ -1419,7 +1519,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://quro.topolo.app";
             readonly domains: readonly ["quro.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["quro.topolo.app"];
             readonly appId: null;
         }];
     };
@@ -1435,7 +1535,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://roadmapper.topolo.app";
             readonly domains: readonly ["roadmapper.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["roadmapper.topolo.app"];
             readonly appId: "roadmapper";
         }, {
             readonly name: "topolo-roadmapper-api";
@@ -1458,7 +1558,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://sign.topolo.app";
             readonly domains: readonly ["sign.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["sign.topolo.app"];
             readonly appId: "sign";
         }, {
             readonly name: "topolo-sign-api";
@@ -1541,7 +1641,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://spaces.topolo.app";
             readonly domains: readonly ["spaces.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["spaces.topolo.app"];
             readonly appId: "spaces";
         }, {
             readonly name: "topolo-spaces-api";
@@ -1626,7 +1726,7 @@ declare const APPLICATIONS: {
             readonly kind: "worker";
             readonly apiUrl: "https://survey.topolo.app";
             readonly domains: readonly ["survey.topolo.app"];
-            readonly routes: readonly [];
+            readonly routes: readonly ["survey.topolo.app"];
             readonly appId: "survey";
         }, {
             readonly name: "topolo-survey-api";
@@ -1863,11 +1963,31 @@ declare class TopoloSdkError extends Error {
     constructor(code: string, message: string);
 }
 declare class TopoloAuthError extends TopoloSdkError {
-    constructor(message: string, code?: string);
+    readonly status: number;
+    readonly body: unknown;
+    readonly service?: string;
+    readonly path?: string;
+    readonly requestId?: string;
+    readonly retryAfter?: string;
+    constructor(message: string, code?: string, options?: HttpErrorContext);
 }
 declare class TopoloPermissionError extends TopoloSdkError {
     readonly required: string[];
-    constructor(message: string, required: string[]);
+    readonly status: number;
+    readonly body: unknown;
+    readonly service?: string;
+    readonly path?: string;
+    readonly requestId?: string;
+    readonly retryAfter?: string;
+    constructor(message: string, required: string[], options?: HttpErrorContext);
+}
+interface HttpErrorContext {
+    status?: number;
+    body?: unknown;
+    service?: string;
+    path?: string;
+    requestId?: string;
+    retryAfter?: string;
 }
 declare class TopoloConfirmationRequiredError extends TopoloSdkError {
     constructor(message: string);
@@ -1877,7 +1997,9 @@ declare class TopoloHttpError extends TopoloSdkError {
     readonly body: unknown;
     readonly service: string;
     readonly path: string;
-    constructor(service: string, path: string, status: number, body: unknown, message?: string);
+    readonly requestId?: string;
+    readonly retryAfter?: string;
+    constructor(service: string, path: string, status: number, body: unknown, message?: string, options?: HttpErrorContext);
 }
 
 interface CrmContactSummary {
@@ -2363,4 +2485,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, 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_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, 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, actionContractCompleteness, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, requirementsForApplication, resolveCatalogServiceUrl, resolveServiceUrl, validateTopoloActionInput, validateTopoloWidgetResponse };
+export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, 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_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, 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, actionContractCompleteness, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, requirementsForApplication, resolveCatalogServiceUrl, resolveServiceUrl, validateTopoloActionInput, validateTopoloWidgetResponse };