@topolo/sdk 0.8.2 → 0.8.4

package/dist/index.cjs

@@ -129,6 +129,7 @@ var APP_API_URLS = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://bytes.topolo.app",
   calendar: "https://calendar.topolo.app",
+  campaigns: "https://campaigns.topolo.app",
   capacity: "https://capacity.topolo.app",
   chat: "https://chat.topolo.app",
   commerce: "https://commerce.topolo.app",
@@ -389,6 +390,38 @@ var APPLICATIONS = {
       }
     ]
   },
+  "campaigns": {
+    "id": "campaigns",
+    "appDir": "TopoloCampaigns",
+    "name": "topolo-campaigns",
+    "packageName": "topolo-campaigns",
+    "productionUrl": "https://campaigns.topolo.app",
+    "services": [
+      "campaigns"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-campaigns",
+        "kind": "worker",
+        "apiUrl": "https://campaigns.topolo.app",
+        "domains": [
+          "campaigns.topolo.app"
+        ],
+        "routes": [
+          "campaigns.topolo.app"
+        ],
+        "appId": "campaigns"
+      },
+      {
+        "name": "topolo-campaigns-api",
+        "kind": "worker",
+        "apiUrl": null,
+        "domains": [],
+        "routes": [],
+        "appId": null
+      }
+    ]
+  },
   "capacity": {
     "id": "capacity",
     "appDir": "TopoloCapacity",
@@ -2570,6 +2603,20 @@ var TopoloClient = class _TopoloClient {
   }
   async callAction(action, input = {}, options = {}) {
     const entry = await this.getAction(action);
+    return this.executeResolvedAction(entry, input, options);
+  }
+  async readAction(action, input = {}, options = {}) {
+    const entry = await this.getAction(action);
+    const agentAccess = entry.agentAccess ?? (entry.destructive ? "off" : entry.readOnly && !entry.requiresConfirmation ? "auto" : "confirm");
+    if (entry.method !== "GET" || !entry.readOnly || entry.destructive || entry.requiresConfirmation || agentAccess !== "auto") {
+      throw new TopoloPermissionError(
+        `Topolo action "${entry.actionId}" is not an automatic read-only action.`,
+        entry.requiredPermission ? [entry.requiredPermission] : []
+      );
+    }
+    return this.executeResolvedAction(entry, input, options);
+  }
+  async executeResolvedAction(entry, input, options) {
     const agentAccess = entry.agentAccess ?? (entry.destructive ? "off" : entry.readOnly && !entry.requiresConfirmation ? "auto" : "confirm");
     if (agentAccess === "off") {
       throw new TopoloPermissionError(

package/dist/index.d.cts

@@ -267,6 +267,13 @@ declare class TopoloClient {
             resourceId: string;
         };
     }): Promise<T>;
+    readAction<T = unknown>(action: string, input?: Record<string, unknown>, options?: {
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<T>;
+    private executeResolvedAction;
     /**
      * Bundled generated registry for tooling that audits platform packaging, not
      * for deciding what the current credential may use.
@@ -326,6 +333,7 @@ declare const APP_API_URLS: {
     readonly bugfix: "https://bugfix.topolo.app";
     readonly bytes: "https://bytes.topolo.app";
     readonly calendar: "https://calendar.topolo.app";
+    readonly campaigns: "https://campaigns.topolo.app";
     readonly capacity: "https://capacity.topolo.app";
     readonly chat: "https://chat.topolo.app";
     readonly commerce: "https://commerce.topolo.app";
@@ -533,6 +541,29 @@ declare const APPLICATIONS: {
             readonly appId: null;
         }];
     };
+    readonly campaigns: {
+        readonly id: "campaigns";
+        readonly appDir: "TopoloCampaigns";
+        readonly name: "topolo-campaigns";
+        readonly packageName: "topolo-campaigns";
+        readonly productionUrl: "https://campaigns.topolo.app";
+        readonly services: readonly ["campaigns"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-campaigns";
+            readonly kind: "worker";
+            readonly apiUrl: "https://campaigns.topolo.app";
+            readonly domains: readonly ["campaigns.topolo.app"];
+            readonly routes: readonly ["campaigns.topolo.app"];
+            readonly appId: "campaigns";
+        }, {
+            readonly name: "topolo-campaigns-api";
+            readonly kind: "worker";
+            readonly apiUrl: null;
+            readonly domains: readonly [];
+            readonly routes: readonly [];
+            readonly appId: null;
+        }];
+    };
     readonly capacity: {
         readonly id: "capacity";
         readonly appDir: "TopoloCapacity";

package/dist/index.d.ts

@@ -267,6 +267,13 @@ declare class TopoloClient {
             resourceId: string;
         };
     }): Promise<T>;
+    readAction<T = unknown>(action: string, input?: Record<string, unknown>, options?: {
+        resource?: {
+            resourceType: string;
+            resourceId: string;
+        };
+    }): Promise<T>;
+    private executeResolvedAction;
     /**
      * Bundled generated registry for tooling that audits platform packaging, not
      * for deciding what the current credential may use.
@@ -326,6 +333,7 @@ declare const APP_API_URLS: {
     readonly bugfix: "https://bugfix.topolo.app";
     readonly bytes: "https://bytes.topolo.app";
     readonly calendar: "https://calendar.topolo.app";
+    readonly campaigns: "https://campaigns.topolo.app";
     readonly capacity: "https://capacity.topolo.app";
     readonly chat: "https://chat.topolo.app";
     readonly commerce: "https://commerce.topolo.app";
@@ -533,6 +541,29 @@ declare const APPLICATIONS: {
             readonly appId: null;
         }];
     };
+    readonly campaigns: {
+        readonly id: "campaigns";
+        readonly appDir: "TopoloCampaigns";
+        readonly name: "topolo-campaigns";
+        readonly packageName: "topolo-campaigns";
+        readonly productionUrl: "https://campaigns.topolo.app";
+        readonly services: readonly ["campaigns"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-campaigns";
+            readonly kind: "worker";
+            readonly apiUrl: "https://campaigns.topolo.app";
+            readonly domains: readonly ["campaigns.topolo.app"];
+            readonly routes: readonly ["campaigns.topolo.app"];
+            readonly appId: "campaigns";
+        }, {
+            readonly name: "topolo-campaigns-api";
+            readonly kind: "worker";
+            readonly apiUrl: null;
+            readonly domains: readonly [];
+            readonly routes: readonly [];
+            readonly appId: null;
+        }];
+    };
     readonly capacity: {
         readonly id: "capacity";
         readonly appDir: "TopoloCapacity";

package/dist/index.js

@@ -71,6 +71,7 @@ var APP_API_URLS = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://bytes.topolo.app",
   calendar: "https://calendar.topolo.app",
+  campaigns: "https://campaigns.topolo.app",
   capacity: "https://capacity.topolo.app",
   chat: "https://chat.topolo.app",
   commerce: "https://commerce.topolo.app",
@@ -331,6 +332,38 @@ var APPLICATIONS = {
       }
     ]
   },
+  "campaigns": {
+    "id": "campaigns",
+    "appDir": "TopoloCampaigns",
+    "name": "topolo-campaigns",
+    "packageName": "topolo-campaigns",
+    "productionUrl": "https://campaigns.topolo.app",
+    "services": [
+      "campaigns"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-campaigns",
+        "kind": "worker",
+        "apiUrl": "https://campaigns.topolo.app",
+        "domains": [
+          "campaigns.topolo.app"
+        ],
+        "routes": [
+          "campaigns.topolo.app"
+        ],
+        "appId": "campaigns"
+      },
+      {
+        "name": "topolo-campaigns-api",
+        "kind": "worker",
+        "apiUrl": null,
+        "domains": [],
+        "routes": [],
+        "appId": null
+      }
+    ]
+  },
   "capacity": {
     "id": "capacity",
     "appDir": "TopoloCapacity",
@@ -2512,6 +2545,20 @@ var TopoloClient = class _TopoloClient {
   }
   async callAction(action, input = {}, options = {}) {
     const entry = await this.getAction(action);
+    return this.executeResolvedAction(entry, input, options);
+  }
+  async readAction(action, input = {}, options = {}) {
+    const entry = await this.getAction(action);
+    const agentAccess = entry.agentAccess ?? (entry.destructive ? "off" : entry.readOnly && !entry.requiresConfirmation ? "auto" : "confirm");
+    if (entry.method !== "GET" || !entry.readOnly || entry.destructive || entry.requiresConfirmation || agentAccess !== "auto") {
+      throw new TopoloPermissionError(
+        `Topolo action "${entry.actionId}" is not an automatic read-only action.`,
+        entry.requiredPermission ? [entry.requiredPermission] : []
+      );
+    }
+    return this.executeResolvedAction(entry, input, options);
+  }
+  async executeResolvedAction(entry, input, options) {
     const agentAccess = entry.agentAccess ?? (entry.destructive ? "off" : entry.readOnly && !entry.requiresConfirmation ? "auto" : "confirm");
     if (agentAccess === "off") {
       throw new TopoloPermissionError(

package/dist/node/credential-store.cjs

@@ -31,6 +31,7 @@ __export(credential_store_exports, {
   normalizeEnvironment: () => normalizeEnvironment,
   profileForEnvironment: () => profileForEnvironment,
   readConfig: () => readConfig,
+  refreshContextCredentialIfNeeded: () => refreshContextCredentialIfNeeded,
   refreshCredentialIfNeeded: () => refreshCredentialIfNeeded,
   resolveAgentName: () => resolveAgentName,
   resolveCredential: () => resolveCredential,
@@ -86,6 +87,7 @@ var APP_API_URLS = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://bytes.topolo.app",
   calendar: "https://calendar.topolo.app",
+  campaigns: "https://campaigns.topolo.app",
   capacity: "https://capacity.topolo.app",
   chat: "https://chat.topolo.app",
   commerce: "https://commerce.topolo.app",
@@ -427,6 +429,46 @@ async function refreshCredentialIfNeeded(environment = selectedEnvironment(), op
     return cred;
   }
 }
+async function refreshContextCredentialIfNeeded(environment, key, options = {}) {
+  const config = await readConfig();
+  const profile = profileForEnvironment(config, environment);
+  const context = profile.contexts?.[key];
+  const credential = context?.credential;
+  if (!credential || credential.kind !== "access_token") return credential ?? null;
+  const oauthClientId = context.oauthClientId ?? profile.oauthClientId;
+  if (!credential.refreshToken || !credential.expiresAt || !oauthClientId) return credential;
+  const now = Math.floor(Date.now() / 1e3);
+  if (!options.force && credential.expiresAt - REFRESH_SKEW_SECONDS > now) return credential;
+  try {
+    const oauth = new TopoloOAuth({
+      serviceUrls: resolveServiceUrls(profile.serviceUrls, environment)
+    });
+    const tokens = await oauth.refreshToken({
+      clientId: oauthClientId,
+      refreshToken: credential.refreshToken
+    });
+    const refreshed = {
+      kind: "access_token",
+      accessToken: tokens.access_token,
+      ...tokens.refresh_token ? { refreshToken: tokens.refresh_token } : { refreshToken: credential.refreshToken },
+      expiresAt: Math.floor(Date.now() / 1e3) + tokens.expires_in
+    };
+    await writeConfig(writeProfileConfig(config, environment, {
+      ...profile.activeContext === key ? { credential: refreshed } : {},
+      contexts: {
+        ...profile.contexts ?? {},
+        [key]: {
+          ...context,
+          credential: refreshed,
+          oauthClientId
+        }
+      }
+    }));
+    return refreshed;
+  } catch {
+    return credential;
+  }
+}
 function resolveAgentName(configAgentName) {
   return process.env.TOPOLO_AGENT_NAME ?? configAgentName;
 }
@@ -470,6 +512,7 @@ function resolvedProfileConfig(config, environment = selectedEnvironment()) {
   normalizeEnvironment,
   profileForEnvironment,
   readConfig,
+  refreshContextCredentialIfNeeded,
   refreshCredentialIfNeeded,
   resolveAgentName,
   resolveCredential,

package/dist/node/credential-store.d.cts

@@ -103,8 +103,12 @@ declare function resolveCredential(environment?: TopoloEnvironment): Promise<Top
 declare function refreshCredentialIfNeeded(environment?: TopoloEnvironment, options?: {
     force?: boolean;
 }): Promise<TopoloCredential | null>;
+/** Refresh one stored context without changing which context is active. */
+declare function refreshContextCredentialIfNeeded(environment: TopoloEnvironment, key: string, options?: {
+    force?: boolean;
+}): Promise<TopoloCredential | null>;
 declare function resolveAgentName(configAgentName?: string): string | undefined;
 declare function resolveServiceUrls(configUrls?: Record<string, string>, environment?: TopoloEnvironment): Record<string, string> | undefined;
 declare function resolvedProfileConfig(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 
-export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };
+export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshContextCredentialIfNeeded, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };

package/dist/node/credential-store.d.ts

@@ -103,8 +103,12 @@ declare function resolveCredential(environment?: TopoloEnvironment): Promise<Top
 declare function refreshCredentialIfNeeded(environment?: TopoloEnvironment, options?: {
     force?: boolean;
 }): Promise<TopoloCredential | null>;
+/** Refresh one stored context without changing which context is active. */
+declare function refreshContextCredentialIfNeeded(environment: TopoloEnvironment, key: string, options?: {
+    force?: boolean;
+}): Promise<TopoloCredential | null>;
 declare function resolveAgentName(configAgentName?: string): string | undefined;
 declare function resolveServiceUrls(configUrls?: Record<string, string>, environment?: TopoloEnvironment): Record<string, string> | undefined;
 declare function resolvedProfileConfig(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 
-export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };
+export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshContextCredentialIfNeeded, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };

package/dist/node/credential-store.js

@@ -43,6 +43,7 @@ var APP_API_URLS = {
   bugfix: "https://bugfix.topolo.app",
   bytes: "https://bytes.topolo.app",
   calendar: "https://calendar.topolo.app",
+  campaigns: "https://campaigns.topolo.app",
   capacity: "https://capacity.topolo.app",
   chat: "https://chat.topolo.app",
   commerce: "https://commerce.topolo.app",
@@ -384,6 +385,46 @@ async function refreshCredentialIfNeeded(environment = selectedEnvironment(), op
     return cred;
   }
 }
+async function refreshContextCredentialIfNeeded(environment, key, options = {}) {
+  const config = await readConfig();
+  const profile = profileForEnvironment(config, environment);
+  const context = profile.contexts?.[key];
+  const credential = context?.credential;
+  if (!credential || credential.kind !== "access_token") return credential ?? null;
+  const oauthClientId = context.oauthClientId ?? profile.oauthClientId;
+  if (!credential.refreshToken || !credential.expiresAt || !oauthClientId) return credential;
+  const now = Math.floor(Date.now() / 1e3);
+  if (!options.force && credential.expiresAt - REFRESH_SKEW_SECONDS > now) return credential;
+  try {
+    const oauth = new TopoloOAuth({
+      serviceUrls: resolveServiceUrls(profile.serviceUrls, environment)
+    });
+    const tokens = await oauth.refreshToken({
+      clientId: oauthClientId,
+      refreshToken: credential.refreshToken
+    });
+    const refreshed = {
+      kind: "access_token",
+      accessToken: tokens.access_token,
+      ...tokens.refresh_token ? { refreshToken: tokens.refresh_token } : { refreshToken: credential.refreshToken },
+      expiresAt: Math.floor(Date.now() / 1e3) + tokens.expires_in
+    };
+    await writeConfig(writeProfileConfig(config, environment, {
+      ...profile.activeContext === key ? { credential: refreshed } : {},
+      contexts: {
+        ...profile.contexts ?? {},
+        [key]: {
+          ...context,
+          credential: refreshed,
+          oauthClientId
+        }
+      }
+    }));
+    return refreshed;
+  } catch {
+    return credential;
+  }
+}
 function resolveAgentName(configAgentName) {
   return process.env.TOPOLO_AGENT_NAME ?? configAgentName;
 }
@@ -426,6 +467,7 @@ export {
   normalizeEnvironment,
   profileForEnvironment,
   readConfig,
+  refreshContextCredentialIfNeeded,
   refreshCredentialIfNeeded,
   resolveAgentName,
   resolveCredential,

package/package.json

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