@topolo/sdk 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/sdk",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "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

@@ -15,7 +15,9 @@ export const APPLICATIONS = {
         "name": "topoloadmin",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "admin.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       }
@@ -35,15 +37,19 @@ export const APPLICATIONS = {
         "name": "topolo-agent",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "agent.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
       {
         "name": "topolo-agent-worker",
         "kind": "worker",
-        "apiUrl": "https://topolo-agent-worker.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://agent-api.topolo.app",
+        "domains": [
+          "agent-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "agent"
       }
@@ -135,15 +141,19 @@ export const APPLICATIONS = {
         "name": "bytes",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "bytes.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
       {
         "name": "r2-media-manager-worker",
         "kind": "worker",
-        "apiUrl": "https://r2-media-manager-worker.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://bytes-api.topolo.app",
+        "domains": [
+          "bytes-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "bytes"
       }
@@ -186,10 +196,9 @@ export const APPLICATIONS = {
       {
         "name": "topolo-capacity",
         "kind": "worker",
-        "apiUrl": "https://topolo-capacity.topolo.workers.dev",
+        "apiUrl": "https://capacity.topolo.app",
         "domains": [
-          "capacity.topolo.app",
-          "topolo-capacity.topolo.workers.dev"
+          "capacity.topolo.app"
         ],
         "routes": [],
         "serviceId": "capacity"
@@ -251,9 +260,9 @@ export const APPLICATIONS = {
       {
         "name": "topolo-commerce-api",
         "kind": "worker",
-        "apiUrl": "https://topolo-commerce-api.topolo.workers.dev",
+        "apiUrl": "https://commerce-api.topolo.app",
         "domains": [
-          "topolo-commerce-api.topolo.workers.dev"
+          "commerce-api.topolo.app"
         ],
         "routes": [],
         "serviceId": "commerce"
@@ -263,8 +272,7 @@ export const APPLICATIONS = {
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "guest.topolo.app",
-          "topolo-commerce-guest-web.pages.dev"
+          "guest.topolo.app"
         ],
         "routes": [],
         "serviceId": null
@@ -274,8 +282,7 @@ export const APPLICATIONS = {
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "commerce.topolo.app",
-          "topolo-commerce-ops-web.pages.dev"
+          "commerce.topolo.app"
         ],
         "routes": [],
         "serviceId": null
@@ -285,8 +292,7 @@ export const APPLICATIONS = {
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "station-commerce.topolo.app",
-          "topolo-commerce-station-web.pages.dev"
+          "station-commerce.topolo.app"
         ],
         "routes": [],
         "serviceId": null
@@ -331,7 +337,9 @@ export const APPLICATIONS = {
         "name": "topolo-crm-frontend",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "crm.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
@@ -339,7 +347,9 @@ export const APPLICATIONS = {
         "name": "topolo-crm-worker",
         "kind": "worker",
         "apiUrl": "https://crm-api.topolo.app",
-        "domains": [],
+        "domains": [
+          "crm-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "crm"
       }
@@ -413,8 +423,8 @@ export const APPLICATIONS = {
     "id": "feed",
     "appDir": "TopoloFeed",
     "name": "TopoloFeed",
-    "packageName": null,
-    "productionUrl": "https://topolo-feed-api.topolo.app",
+    "packageName": "topolo-feed",
+    "productionUrl": "https://feed-api.topolo.app",
     "services": [
       "feed"
     ],
@@ -422,24 +432,24 @@ export const APPLICATIONS = {
       {
         "name": "topolo-feed-analytics-api",
         "kind": "worker",
-        "apiUrl": "https://topolo-feed-analytics-api.topolo.app",
+        "apiUrl": "https://feed-analytics-api.topolo.app",
         "domains": [
-          "topolo-feed-analytics-api.topolo.app"
+          "feed-analytics-api.topolo.app"
         ],
         "routes": [
-          "topolo-feed-analytics-api.topolo.app"
+          "feed-analytics-api.topolo.app"
         ],
         "serviceId": null
       },
       {
         "name": "topolo-feed-api",
         "kind": "worker",
-        "apiUrl": "https://topolo-feed-api.topolo.app",
+        "apiUrl": "https://feed-api.topolo.app",
         "domains": [
-          "topolo-feed-api.topolo.app"
+          "feed-api.topolo.app"
         ],
         "routes": [
-          "topolo-feed-api.topolo.app"
+          "feed-api.topolo.app"
         ],
         "serviceId": "feed"
       }
@@ -483,15 +493,19 @@ export const APPLICATIONS = {
         "name": "forecast",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "forecast.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
       {
         "name": "forecast-worker-production",
         "kind": "worker",
-        "apiUrl": "https://forecast-worker-production.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://forecast-api.topolo.app",
+        "domains": [
+          "forecast-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "forecast"
       }
@@ -592,9 +606,9 @@ export const APPLICATIONS = {
       {
         "name": "topololearn-api",
         "kind": "worker",
-        "apiUrl": "https://topololearn-api.topolo.workers.dev",
+        "apiUrl": "https://learn-api.topolo.app",
         "domains": [
-          "topololearn-api.topolo.workers.dev"
+          "learn-api.topolo.app"
         ],
         "routes": [],
         "serviceId": "learn"
@@ -647,12 +661,12 @@ export const APPLICATIONS = {
       {
         "name": "topolo-mdm-api",
         "kind": "worker",
-        "apiUrl": "https://topolo-mdm-api.topolo.app",
+        "apiUrl": "https://mdm-api.topolo.app",
         "domains": [
-          "topolo-mdm-api.topolo.app"
+          "mdm-api.topolo.app"
         ],
         "routes": [
-          "topolo-mdm-api.topolo.app"
+          "mdm-api.topolo.app"
         ],
         "serviceId": "mdm"
       },
@@ -661,8 +675,7 @@ export const APPLICATIONS = {
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "mdm.topolo.app",
-          "topolo-mdm-console.pages.dev"
+          "mdm.topolo.app"
         ],
         "routes": [
           "mdm.topolo.app"
@@ -716,8 +729,7 @@ export const APPLICATIONS = {
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "nexus.topolo.app",
-          "topolo-nexus-dashboard.pages.dev"
+          "nexus.topolo.app"
         ],
         "routes": [],
         "serviceId": null
@@ -725,9 +737,9 @@ export const APPLICATIONS = {
       {
         "name": "topolo-nexus-gateway",
         "kind": "worker",
-        "apiUrl": "https://topolo-nexus-gateway.topolo.workers.dev",
+        "apiUrl": "https://nexus-api.topolo.app",
         "domains": [
-          "topolo-nexus-gateway.topolo.workers.dev"
+          "nexus-api.topolo.app"
         ],
         "routes": [],
         "serviceId": "nexus"
@@ -765,25 +777,26 @@ export const APPLICATIONS = {
     "packageName": "topolo-oneclick-sso",
     "productionUrl": "https://one.topolo.app",
     "services": [
-      "one"
+      "one",
+      "one.ai"
     ],
     "deployTargets": [
       {
         "name": "ai-chat-rag",
         "kind": "worker",
-        "apiUrl": null,
+        "apiUrl": "https://ai.one.topolo.app",
         "domains": [
-          "ai-chat-rag.topolo.workers.dev"
+          "ai.one.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "one.ai"
       },
       {
         "name": "topoloone",
         "kind": "pages",
         "apiUrl": null,
         "domains": [
-          "oneclick-dashboard.pages.dev"
+          "one.topolo.app"
         ],
         "routes": [],
         "serviceId": null
@@ -804,7 +817,9 @@ export const APPLICATIONS = {
         "name": "topoloone-worker",
         "kind": "worker",
         "apiUrl": "https://one.topolo.app",
-        "domains": [],
+        "domains": [
+          "one.topolo.app"
+        ],
         "routes": [
           "one.topolo.app/*"
         ],
@@ -812,6 +827,30 @@ export const APPLICATIONS = {
       }
     ]
   },
+  "p2p": {
+    "id": "p2p",
+    "appDir": "TopoloP2P",
+    "name": "topolo-p2p",
+    "packageName": "topolo-p2p",
+    "productionUrl": "https://p2p.topolo.app",
+    "services": [
+      "p2p"
+    ],
+    "deployTargets": [
+      {
+        "name": "topolo-p2p",
+        "kind": "worker",
+        "apiUrl": "https://p2p.topolo.app",
+        "domains": [
+          "p2p.topolo.app"
+        ],
+        "routes": [
+          "p2p.topolo.app"
+        ],
+        "serviceId": "p2p"
+      }
+    ]
+  },
   "pay": {
     "id": "pay",
     "appDir": "TopoloPay",
@@ -825,8 +864,10 @@ export const APPLICATIONS = {
       {
         "name": "topolo-pay",
         "kind": "worker",
-        "apiUrl": "https://topolo-pay.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://pay.topolo.app",
+        "domains": [
+          "pay.topolo.app"
+        ],
         "routes": [],
         "serviceId": "pay"
       }
@@ -871,7 +912,9 @@ export const APPLICATIONS = {
         "name": "quro-api",
         "kind": "worker",
         "apiUrl": "https://api.ol0.me",
-        "domains": [],
+        "domains": [
+          "api.ol0.me"
+        ],
         "routes": [],
         "serviceId": "quro.api"
       },
@@ -879,7 +922,9 @@ export const APPLICATIONS = {
         "name": "quro-redirect-system",
         "kind": "worker",
         "apiUrl": "https://ol0.me",
-        "domains": [],
+        "domains": [
+          "ol0.me"
+        ],
         "routes": [
           "ol0.me/*"
         ],
@@ -889,7 +934,9 @@ export const APPLICATIONS = {
         "name": "quro-ui",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "quro.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       }
@@ -965,15 +1012,19 @@ export const APPLICATIONS = {
         "name": "topolo-social-studio",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "studio.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
       {
         "name": "topolo-social-studio-api",
         "kind": "worker",
-        "apiUrl": "https://topolo-social-studio-api.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://studio-api.topolo.app",
+        "domains": [
+          "studio-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "social_studio"
       },
@@ -1001,15 +1052,19 @@ export const APPLICATIONS = {
         "name": "socialize",
         "kind": "pages",
         "apiUrl": null,
-        "domains": [],
+        "domains": [
+          "socialize.topolo.app"
+        ],
         "routes": [],
         "serviceId": null
       },
       {
         "name": "socialize-prod-api",
         "kind": "worker",
-        "apiUrl": "https://socialize-prod-api.topolo.workers.dev",
-        "domains": [],
+        "apiUrl": "https://socialize-api.topolo.app",
+        "domains": [
+          "socialize-api.topolo.app"
+        ],
         "routes": [],
         "serviceId": "socialize"
       },

package/src/index.ts

@@ -43,6 +43,23 @@ export {
   type ListContactsResult,
 } from "./modules/crm.js";
 export { IdentityModule } from "./modules/identity.js";
+export {
+  P2PModule,
+  type P2PCapability,
+  type P2PPricingModel,
+  type PublishCapabilityInput,
+  type P2PActionRow,
+  type P2PActionRun,
+  type P2PActionRequestInput,
+  type P2PActionRequestResult,
+  type P2PActionDetail,
+  type P2PHold,
+  type P2PLedgerEntry,
+  type P2PPolicy,
+  type P2PConnection,
+  type P2PSettlementGroup,
+  type P2PSettlementBatch,
+} from "./modules/p2p.js";
 export {
   TopoloOAuth,
   type OAuthHelperOptions,

package/src/modules/p2p.test.ts

@@ -0,0 +1,218 @@
+import { describe, expect, it, vi } from 'vitest';
+import { TopoloClient } from '../client.js';
+import { P2PModule } from './p2p.js';
+
+const AGENT = { clientName: 'topolo-sdk-test', clientVersion: '0.0.0' };
+
+function stubFetch(responses: Array<{ status?: number; body?: unknown }>) {
+  const calls: Array<{ url: string; init: RequestInit }> = [];
+  const impl = vi.fn(async (url: string, init: RequestInit) => {
+    calls.push({ url, init });
+    const next = responses.shift() ?? { status: 200, body: { success: true, data: {} } };
+    return new Response(JSON.stringify(next.body ?? { success: true, data: {} }), {
+      status: next.status ?? 200,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  });
+  return { impl: impl as unknown as typeof fetch, calls };
+}
+
+function clientWith(impl: typeof fetch) {
+  return new TopoloClient({
+    credential: { kind: 'access_token', accessToken: 'tok_test' },
+    agent: AGENT,
+    fetch: impl,
+  });
+}
+
+describe('P2PModule.listDirectory', () => {
+  it('GETs /api/directory/capabilities and unwraps the envelope', async () => {
+    const { impl, calls } = stubFetch([
+      {
+        body: {
+          success: true,
+          data: {
+            capabilities: [
+              {
+                capability_id: 'cap_1',
+                publisher_org_id: 'org_a',
+                app_id: 'app_x',
+                service_id: 'srv_x',
+                name: 'Demo',
+                description: 'A capability',
+                category: 'other',
+                pricing_model: 'free',
+                pricing_amount_minor: null,
+                currency: null,
+                requires_human_approval: false,
+                supported_contexts: ['agent'],
+                trust_level: 'standard',
+                source_revision: 'rev_1',
+                synced_at: 1,
+              },
+            ],
+          },
+        },
+      },
+    ]);
+    const p2p = new P2PModule(clientWith(impl));
+
+    const capabilities = await p2p.listDirectory({ limit: 10 });
+    expect(capabilities).toHaveLength(1);
+    expect(capabilities[0]!.capability_id).toBe('cap_1');
+    const url = new URL(calls[0]!.url);
+    expect(url.pathname).toBe('/api/directory/capabilities');
+    expect(url.searchParams.get('limit')).toBe('10');
+    expect((calls[0]!.init.method ?? 'GET').toUpperCase()).toBe('GET');
+  });
+});
+
+describe('P2PModule.publishCapability', () => {
+  it('POSTs to the internal sync route with the publisher_org_id and acting_for_org_id default', async () => {
+    const { impl, calls } = stubFetch([
+      {
+        body: {
+          success: true,
+          data: {
+            capability: {
+              capability_id: 'cap_z',
+              publisher_org_id: 'org_p',
+              app_id: 'app_x',
+              service_id: 'srv_x',
+              name: 'Demo',
+              description: 'A capability',
+              category: 'other',
+              pricing_model: 'fixed',
+              pricing_amount_minor: 500,
+              currency: 'USD',
+              requires_human_approval: false,
+              supported_contexts: ['agent'],
+              trust_level: 'standard',
+              source_revision: 'rev_2',
+              synced_at: 1,
+            },
+          },
+        },
+      },
+    ]);
+    const p2p = new P2PModule(clientWith(impl));
+
+    const capability = await p2p.publishCapability({
+      capability_id: 'cap_z',
+      publisher_org_id: 'org_p',
+      app_id: 'app_x',
+      service_id: 'srv_x',
+      name: 'Demo',
+      description: 'A capability',
+      category: 'other',
+      pricing_model: 'fixed',
+      pricing_amount_minor: 500,
+      currency: 'USD',
+      supported_contexts: ['agent'],
+      public_directory_visible: true,
+      source_revision: 'rev_2',
+    });
+    expect(capability.capability_id).toBe('cap_z');
+
+    const sent = JSON.parse(String(calls[0]!.init.body));
+    expect(sent.publisher_org_id).toBe('org_p');
+    expect(sent.acting_for_org_id).toBe('org_p');
+    expect(sent.public_directory_visible).toBe(true);
+    expect(sent.requires_human_approval).toBe(false);
+    expect(sent.trust_level).toBe('standard');
+    const url = new URL(calls[0]!.url);
+    expect(url.pathname).toBe('/api/p2p/internal/capabilities/sync');
+    expect((calls[0]!.init.method ?? '').toUpperCase()).toBe('POST');
+  });
+
+  it('honours an explicit acting_for_org_id when the platform key is publishing for another org', async () => {
+    const { impl, calls } = stubFetch([
+      { body: { success: true, data: { capability: null } } },
+    ]);
+    const p2p = new P2PModule(clientWith(impl));
+    await p2p.publishCapability({
+      capability_id: 'cap_other',
+      publisher_org_id: 'org_target',
+      app_id: 'app_x',
+      service_id: 'srv_x',
+      name: 'Demo',
+      description: '...',
+      category: 'other',
+      pricing_model: 'free',
+      supported_contexts: ['agent'],
+      public_directory_visible: true,
+      source_revision: 'rev_1',
+      acting_for_org_id: 'org_target',
+    });
+    const sent = JSON.parse(String(calls[0]!.init.body));
+    expect(sent.acting_for_org_id).toBe('org_target');
+  });
+});
+
+describe('P2PModule.requestAction', () => {
+  it('rejects without an idempotency_key', async () => {
+    const { impl } = stubFetch([]);
+    const p2p = new P2PModule(clientWith(impl));
+    await expect(
+      p2p.requestAction({ capability_id: 'cap_1', idempotency_key: '', inputs: {} }),
+    ).rejects.toThrow(/idempotency_key/);
+  });
+
+  it('returns the worker decision payload', async () => {
+    const { impl } = stubFetch([
+      {
+        body: {
+          success: true,
+          data: {
+            decision: 'auto_accepted',
+            idempotent: false,
+            request: { request_id: 'req_1', state: 'auto_accepted' },
+            run: null,
+          },
+        },
+      },
+    ]);
+    const p2p = new P2PModule(clientWith(impl));
+    const result = await p2p.requestAction({
+      capability_id: 'cap_1',
+      idempotency_key: 'key_1',
+      inputs: { foo: 'bar' },
+    });
+    expect(result.decision).toBe('auto_accepted');
+    expect(result.idempotent).toBe(false);
+    expect(result.request.request_id).toBe('req_1');
+  });
+});
+
+describe('P2PModule.getCapability', () => {
+  it('returns null on a 404 from the worker', async () => {
+    const { impl } = stubFetch([{ status: 404, body: { success: false, error: 'capability_not_found' } }]);
+    const p2p = new P2PModule(clientWith(impl));
+    const capability = await p2p.getCapability('cap_missing');
+    expect(capability).toBeNull();
+  });
+});
+
+describe('P2PModule.releaseHold', () => {
+  it('POSTs the resolution + reason and returns hold + cancel entries', async () => {
+    const { impl, calls } = stubFetch([
+      {
+        body: {
+          success: true,
+          data: {
+            hold: { hold_id: 'hold_1', status: 'released' },
+            resolution: 'seller',
+            cancel_entries: [{ entry_id: 'led_1', amount_minor: 500 }],
+          },
+        },
+      },
+    ]);
+    const p2p = new P2PModule(clientWith(impl));
+    const result = await p2p.releaseHold('hold_1', 'seller', { reason: 'arbitration' });
+    expect(result.resolution).toBe('seller');
+    expect(result.cancel_entries[0]!.entry_id).toBe('led_1');
+    const sent = JSON.parse(String(calls[0]!.init.body));
+    expect(sent.resolution).toBe('seller');
+    expect(sent.reason).toBe('arbitration');
+  });
+});