@cargo-ai/api 1.0.22 → 1.0.24

package/README.md

@@ -54,7 +54,9 @@ The package exports typed **domain** namespaces and API modules for:
 - **Ai** – AI resources, agents, MCP servers, files
 - **Billing** – subscriptions and billing
 - **Connection** – connectors, integrations, filters
+- **Context** – context repository, runtime sandbox, knowledge graph
 - **Expression** – expressions and formula helpers
+- **Hosting** – Cargo Hosting apps, workers, deployments, env vars, custom domains
 - **Orchestration** – workflows, plays, tools, templates
 - **RevenueOrganization** – members, capacities, territories
 - **Segmentation** – segments, changes
@@ -70,7 +72,9 @@ Each domain exposes **sub-areas** on the API instance. Examples:
 | **Ai**                        | template, agent, release, chat, message, vote, document, mcpServer, mcpClient, prompt, memory, file, suggestedAction |
 | **Billing**                   | usage, subscription                                                                                                  |
 | **Connection**                | connector, integration, nativeIntegration                                                                            |
+| **Context**                   | repository, runtime, graph                                                                                           |
 | **Expression**                | favoriteRecipe, recipe, expression                                                                                   |
+| **Hosting**                   | app, worker, deployment, envVars, customDomain                                                                       |
 | **Orchestration**             | batch, workflow, play, tool, release, draftRelease, run, record, node, template                                      |
 | **RevenueOrganization**       | allocation, capacity, member, territory                                                                              |
 | **Segmentation**              | segment, change, record                                                                                              |

package/build/src/api/connection/index.d.ts

@@ -20,10 +20,18 @@ export interface ConnectionApi {
         getDocumentation: (slug: string) => Promise<string>;
         list: (payload: Connection.Api.ListIntegrationsPayload) => Promise<Connection.Api.ListIntegrationsResult>;
         completeOauth(payload: Connection.Api.CompleteIntegrationOauthPayload): Promise<Connection.Api.CompleteIntegrationOauthResult>;
+        initiateOauth(payload: Connection.Api.InitiateIntegrationOauthPayload): Promise<Connection.Api.InitiateIntegrationOauthResult>;
     };
     nativeIntegration: {
         get: () => Promise<Connection.Api.GetNativeIntegrationResult>;
     };
+    customIntegration: {
+        create: (payload: Connection.Api.CreateCustomIntegrationPayload) => Promise<Connection.Api.CreateCustomIntegrationResult>;
+        list: () => Promise<Connection.Api.ListCustomIntegrationsResult>;
+        get: (payload: Connection.Api.GetCustomIntegrationPayload) => Promise<Connection.Api.GetCustomIntegrationResult>;
+        update: (payload: Connection.Api.UpdateCustomIntegrationPayload) => Promise<Connection.Api.UpdateCustomIntegrationResult>;
+        remove: (uuid: string) => Promise<void>;
+    };
 }
 export declare const buildConnectionApi: ({ fetcher, }: ConnectionApiDependencies) => ConnectionApi;
 export {};

package/build/src/api/connection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/connection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,UAAU,yBAAyB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE;QACT,YAAY,EAAE,CACZ,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,4BAA4B,KACjD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzD,gBAAgB,EAAE,CAChB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,gCAAgC,KACrD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7D,iBAAiB,EAAE,CACjB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,iCAAiC,KACtD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9D,MAAM,EAAE,CACN,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,sBAAsB,KAC3C,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnD,GAAG,EAAE,CACH,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,mBAAmB,KACxC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChD,IAAI,EAAE,CACJ,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,qBAAqB,KAC1C,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,EAAE,CACN,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,sBAAsB,KAC3C,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnD,YAAY,EAAE,CACZ,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,4BAA4B,KACjD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;KAC1D,CAAC;IACF,WAAW,EAAE;QACX,GAAG,EAAE,CACH,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,qBAAqB,KAC1C,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClD,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,EAAE,CACJ,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,uBAAuB,KAC5C,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpD,aAAa,CACX,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,+BAA+B,GACtD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;KAC3D,CAAC;IACF,iBAAiB,EAAE;QACjB,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;KAC/D,CAAC;CACH;AAED,eAAO,MAAM,kBAAkB,iBAE5B,yBAAyB,KAAG,aA6R9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/connection/index.ts"],"names":[],"mappings":"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"}

package/build/src/api/connection/index.js

@@ -146,6 +146,23 @@ export const buildConnectionApi = ({ fetcher, }) => {
         });
         return result;
     }
+    async function initiateIntegrationOauth(payload) {
+        const { slug } = payload;
+        try {
+            const result = await fetcher.fetch({
+                method: "post",
+                endpoint: `connection/integrations/${slug}/initiateOauth`,
+            });
+            return result;
+        }
+        catch (error) {
+            throw getErrorWithReasonErrorMessage(error, Connection.Api.zodInitiateIntegrationOauthErrorReason, {
+                integrationNotFound: "Integration not found",
+                initiateOauthNotSupported: "This integration does not support OAuth initiation",
+                failedToInitiateOauth: "Failed to initiate OAuth flow",
+            });
+        }
+    }
     async function getNativeIntegration() {
         const result = await fetcher.fetch({
             method: "get",
@@ -153,6 +170,77 @@ export const buildConnectionApi = ({ fetcher, }) => {
         });
         return result;
     }
+    async function createCustomIntegration(payload) {
+        try {
+            const result = await fetcher.fetch({
+                method: "post",
+                endpoint: "connection/customIntegrations",
+                payload,
+            });
+            return result;
+        }
+        catch (error) {
+            throw getErrorWithReasonErrorMessage(error, Connection.Api.zodCreateCustomIntegrationErrorReason, {
+                workerNotFound: "Worker not found",
+            });
+        }
+    }
+    async function listCustomIntegrations() {
+        const result = await fetcher.fetch({
+            method: "get",
+            endpoint: "connection/customIntegrations/list",
+        });
+        return result;
+    }
+    async function getCustomIntegration(payload) {
+        const { uuid } = payload;
+        try {
+            const result = await fetcher.fetch({
+                method: "get",
+                endpoint: `connection/customIntegrations/${uuid}`,
+            });
+            return result;
+        }
+        catch (error) {
+            throw getErrorWithReasonErrorMessage(error, Connection.Api.zodGetCustomIntegrationErrorReason, {
+                customIntegrationNotFound: "Custom integration not found",
+            });
+        }
+    }
+    async function updateCustomIntegration(payload) {
+        const { uuid, ...other } = payload;
+        try {
+            const result = await fetcher.fetch({
+                method: "put",
+                endpoint: `connection/customIntegrations/${uuid}`,
+                payload: other,
+            });
+            return result;
+        }
+        catch (error) {
+            throw getErrorWithReasonErrorMessage(error, Connection.Api.zodUpdateCustomIntegrationErrorReason, {
+                customIntegrationNotFound: "Custom integration not found",
+                workerNotFound: "Worker not found",
+                customIntegrationNotWorker: "Custom integration is not backed by a worker",
+                customIntegrationNotExternal: "Custom integration is not externally hosted",
+                unknown: "Failed to update custom integration",
+            });
+        }
+    }
+    async function removeCustomIntegration(uuid) {
+        try {
+            await fetcher.fetch({
+                method: "delete",
+                endpoint: `connection/customIntegrations/${uuid}`,
+            });
+        }
+        catch (error) {
+            throw getErrorWithReasonErrorMessage(error, Connection.Api.zodRemoveCustomIntegrationErrorReason, {
+                customIntegrationNotFound: "Custom integration not found",
+                unknown: "Failed to remove custom integration",
+            });
+        }
+    }
     return {
         connector: {
             autocomplete: autocompleteConnector,
@@ -197,9 +285,17 @@ export const buildConnectionApi = ({ fetcher, }) => {
                 return result.replaceAll("./", `${fetcher.baseUrl}/v1/connection/integrations/${slug}/documentation/`);
             },
             completeOauth: completeIntegrationOauth,
+            initiateOauth: initiateIntegrationOauth,
         },
         nativeIntegration: {
             get: getNativeIntegration,
         },
+        customIntegration: {
+            create: createCustomIntegration,
+            list: listCustomIntegrations,
+            get: getCustomIntegration,
+            update: updateCustomIntegration,
+            remove: removeCustomIntegration,
+        },
     };
 };

package/build/src/api/context/index.d.ts

@@ -8,14 +8,16 @@ export interface ContextApi {
         get: () => Promise<Context.Api.GetRepositoryResult>;
         update: (payload: Context.Api.UpdateRepositoryPayload) => Promise<Context.Api.UpdateRepositoryResult>;
     };
-    file: {
-        browse: (payload: Context.Api.BrowseFilesPayload) => Promise<Context.Api.BrowseFilesResult>;
-        read: (payload: Context.Api.ReadFilePayload) => Promise<Context.Api.ReadFileResult>;
-        write: (payload: Context.Api.WriteFilePayload) => Promise<Context.Api.WriteFileResult>;
+    runtime: {
+        browse: (payload?: Context.Api.BrowseRuntimePayload) => Promise<Context.Api.BrowseRuntimeResult>;
+        read: (payload: Context.Api.ReadRuntimePayload) => Promise<Context.Api.ReadRuntimeResult>;
+        readBytes: (payload: Context.Api.ReadBytesRuntimePayload) => Promise<Blob>;
+        write: (payload: Context.Api.WriteRuntimePayload) => Promise<Context.Api.WriteRuntimeResult>;
+        edit: (payload: Context.Api.EditRuntimePayload) => Promise<Context.Api.EditRuntimeResult>;
+        execute: (payload: Context.Api.ExecuteRuntimePayload) => Promise<Context.Api.ExecuteRuntimeResult>;
     };
-    skill: {
-        list: () => Promise<Context.Api.ListSkillsResult>;
-        get: (payload: Context.Api.GetSkillPayload) => Promise<Context.Api.GetSkillResult>;
+    graph: {
+        get: () => Promise<Context.Api.GetGraphResult>;
     };
 }
 export declare const buildContextApi: ({ fetcher, }: ContextApiDependencies) => ContextApi;

package/build/src/api/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACpD,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KACzC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;KAClD,CAAC;IACF,IAAI,EAAE;QACJ,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC5C,IAAI,EAAE,CACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KACjC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACzC,KAAK,EAAE,CACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAClC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;KAC3C,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClD,GAAG,EAAE,CACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KACjC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,eAAO,MAAM,eAAe,iBAEzB,sBAAsB,KAAG,UAsF3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACpD,MAAM,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KACzC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;KAClD,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,CACN,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KACvC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAC9C,IAAI,EAAE,CACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3E,KAAK,EAAE,CACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KACrC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC7C,IAAI,EAAE,CACJ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KACpC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC5C,OAAO,EAAE,CACP,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,KACvC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;KAChD,CAAC;IACF,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;KAChD,CAAC;CACH;AAED,eAAO,MAAM,eAAe,iBAEzB,sBAAsB,KAAG,UA2F3B,CAAC"}

package/build/src/api/context/index.js

@@ -1,71 +1,79 @@
 export const buildContextApi = ({ fetcher, }) => {
     async function getRepository() {
-        const result = await fetcher.fetch({
+        return fetcher.fetch({
             method: "get",
             endpoint: "/context/repository",
         });
-        return result;
     }
     async function updateRepository(payload) {
-        const result = await fetcher.fetch({
+        return fetcher.fetch({
             method: "patch",
             endpoint: "/context/repository",
             payload,
         });
-        return result;
     }
-    async function browseFiles(payload) {
-        const result = await fetcher.fetch({
+    async function browseRuntime(payload) {
+        return fetcher.fetch({
             method: "get",
-            endpoint: "/context/files",
+            endpoint: "/context/runtime",
             params: payload,
         });
-        return result;
     }
-    async function readFile(payload) {
-        const result = await fetcher.fetch({
-            method: "get",
-            endpoint: "/context/files/content",
-            params: payload,
+    async function readRuntime(payload) {
+        return fetcher.fetch({
+            method: "post",
+            endpoint: "/context/runtime/content",
+            payload,
         });
-        return result;
     }
-    async function writeFile(payload) {
-        const result = await fetcher.fetch({
+    async function readRuntimeBytes(payload) {
+        return fetcher.fetchBlob({
+            endpoint: "/context/runtime/raw",
+            params: { path: payload.path },
+        });
+    }
+    async function writeRuntime(payload) {
+        return fetcher.fetch({
             method: "put",
-            endpoint: "/context/files/content",
+            endpoint: "/context/runtime/content",
             payload,
         });
-        return result;
     }
-    async function listSkills() {
-        const result = await fetcher.fetch({
-            method: "get",
-            endpoint: "/context/skills",
+    async function editRuntime(payload) {
+        return fetcher.fetch({
+            method: "patch",
+            endpoint: "/context/runtime/content",
+            payload,
+        });
+    }
+    async function executeRuntime(payload) {
+        return fetcher.fetch({
+            method: "post",
+            endpoint: "/context/runtime/execute",
+            payload,
         });
-        return result;
     }
-    async function getSkill(payload) {
-        const result = await fetcher.fetch({
+    async function getGraph() {
+        return fetcher.fetch({
             method: "get",
-            endpoint: "/context/skills/content",
-            params: { path: payload.slug },
+            endpoint: "/context/graph",
         });
-        return result;
     }
     return {
         repository: {
             get: getRepository,
             update: updateRepository,
         },
-        file: {
-            browse: browseFiles,
-            read: readFile,
-            write: writeFile,
+        runtime: {
+            browse: browseRuntime,
+            read: readRuntime,
+            readBytes: readRuntimeBytes,
+            write: writeRuntime,
+            edit: editRuntime,
+            execute: executeRuntime,
         },
-        skill: {
-            list: listSkills,
-            get: getSkill,
+        graph: {
+            get: getGraph,
         },
     };
 };

package/build/src/api/hosting/index.d.ts

@@ -0,0 +1,47 @@
+import type { Hosting } from "../../domains/index.js";
+import type { Fetcher } from "../../fetcher/index.js";
+interface HostingApiDependencies {
+    fetcher: Fetcher;
+}
+export interface HostingApi {
+    app: {
+        list: (payload?: Hosting.Api.ListAppsPayload) => Promise<Hosting.Api.ListAppsResult>;
+        get: (uuid: string) => Promise<Hosting.Api.GetAppResult>;
+        create: (payload: Hosting.Api.CreateAppPayload) => Promise<Hosting.Api.CreateAppResult>;
+        update: (payload: Hosting.Api.UpdateAppPayload) => Promise<Hosting.Api.UpdateAppResult>;
+        remove: (uuid: string) => Promise<void>;
+    };
+    worker: {
+        list: (payload?: Hosting.Api.ListWorkersPayload) => Promise<Hosting.Api.ListWorkersResult>;
+        get: (uuid: string) => Promise<Hosting.Api.GetWorkerResult>;
+        create: (payload: Hosting.Api.CreateWorkerPayload) => Promise<Hosting.Api.CreateWorkerResult>;
+        update: (payload: Hosting.Api.UpdateWorkerPayload) => Promise<Hosting.Api.UpdateWorkerResult>;
+        remove: (uuid: string) => Promise<void>;
+    };
+    deployment: {
+        list: (payload: Hosting.Api.ListDeploymentsPayload) => Promise<Hosting.Api.ListDeploymentsResult>;
+        count: (payload: Hosting.Api.CountDeploymentsPayload) => Promise<Hosting.Api.CountDeploymentsResult>;
+        get: (uuid: string) => Promise<Hosting.Api.GetDeploymentResult>;
+        getPromoted: (payload: Hosting.Api.GetPromotedDeploymentPayload) => Promise<Hosting.Api.GetPromotedDeploymentResult>;
+        getBuildLogUrl: (payload: Hosting.Api.GetDeploymentBuildLogUrlPayload) => Promise<Hosting.Api.GetDeploymentBuildLogUrlResult>;
+        create: (payload: Hosting.Api.CreateDeploymentPayload) => Promise<Hosting.Api.CreateDeploymentResult>;
+        promote: (payload: Hosting.Api.PromoteDeploymentPayload) => Promise<Hosting.Api.PromoteDeploymentResult>;
+        cancel: (payload: Hosting.Api.CancelDeploymentPayload) => Promise<Hosting.Api.CancelDeploymentResult>;
+    };
+    envVars: {
+        list: (payload: Hosting.Api.ListEnvVarsPayload) => Promise<Hosting.Api.ListEnvVarsResult>;
+        create: (payload: Hosting.Api.CreateEnvVarPayload) => Promise<Hosting.Api.CreateEnvVarResult>;
+        update: (payload: Hosting.Api.UpdateEnvVarPayload) => Promise<Hosting.Api.UpdateEnvVarResult>;
+        remove: (payload: Hosting.Api.RemoveEnvVarPayload) => Promise<void>;
+    };
+    customDomain: {
+        list: (payload: Hosting.Api.ListCustomDomainsPayload) => Promise<Hosting.Api.ListCustomDomainsResult>;
+        get: (payload: Hosting.Api.GetCustomDomainPayload) => Promise<Hosting.Api.GetCustomDomainResult>;
+        attach: (payload: Hosting.Api.AttachCustomDomainPayload) => Promise<Hosting.Api.AttachCustomDomainResult>;
+        refreshStatus: (payload: Hosting.Api.RefreshCustomDomainStatusPayload) => Promise<Hosting.Api.RefreshCustomDomainStatusResult>;
+        detach: (payload: Hosting.Api.DetachCustomDomainPayload) => Promise<Hosting.Api.DetachCustomDomainResult>;
+    };
+}
+export declare const buildHostingApi: ({ fetcher, }: HostingApiDependencies) => HostingApi;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/src/api/hosting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/hosting/index.ts"],"names":[],"mappings":"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"}

package/build/src/api/hosting/index.js

@@ -0,0 +1,225 @@
+export const buildHostingApi = ({ fetcher, }) => {
+    async function listApps(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/apps/list",
+            payload: payload !== undefined ? payload : {},
+        });
+    }
+    async function getApp(uuid) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: `/hosting/apps/${uuid}`,
+        });
+    }
+    async function createApp(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/apps",
+            payload,
+        });
+    }
+    async function updateApp(payload) {
+        const { uuid, ...other } = payload;
+        return await fetcher.fetch({
+            method: "put",
+            endpoint: `/hosting/apps/${uuid}`,
+            payload: other,
+        });
+    }
+    async function removeApp(uuid) {
+        await fetcher.fetch({
+            method: "delete",
+            endpoint: `/hosting/apps/${uuid}`,
+            payload: {},
+        });
+    }
+    async function listWorkers(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/workers/list",
+            payload: payload !== undefined ? payload : {},
+        });
+    }
+    async function getWorker(uuid) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: `/hosting/workers/${uuid}`,
+        });
+    }
+    async function createWorker(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/workers",
+            payload,
+        });
+    }
+    async function updateWorker(payload) {
+        const { uuid, ...other } = payload;
+        return await fetcher.fetch({
+            method: "put",
+            endpoint: `/hosting/workers/${uuid}`,
+            payload: other,
+        });
+    }
+    async function removeWorker(uuid) {
+        await fetcher.fetch({
+            method: "delete",
+            endpoint: `/hosting/workers/${uuid}`,
+            payload: {},
+        });
+    }
+    async function listDeployments(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/deployments/list",
+            payload,
+        });
+    }
+    async function countDeployments(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/deployments/count",
+            payload,
+        });
+    }
+    async function getDeployment(uuid) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: `/hosting/deployments/${uuid}`,
+        });
+    }
+    async function getPromotedDeployment(payload) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: "/hosting/deployments/promoted",
+            params: payload,
+        });
+    }
+    async function createDeployment(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/deployments",
+            payload,
+        });
+    }
+    async function promoteDeployment(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/deployments/promote",
+            payload,
+        });
+    }
+    async function cancelDeployment(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/deployments/cancel",
+            payload,
+        });
+    }
+    async function getDeploymentBuildLogUrl(payload) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: `/hosting/deployments/${encodeURIComponent(payload.uuid)}/build-log-url`,
+        });
+    }
+    async function listEnvVars(payload) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: "/hosting/env-vars",
+            params: payload,
+        });
+    }
+    async function createEnvVar(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/env-vars",
+            payload,
+        });
+    }
+    async function updateEnvVar(payload) {
+        const { uuid, ...body } = payload;
+        return await fetcher.fetch({
+            method: "patch",
+            endpoint: `/hosting/env-vars/${encodeURIComponent(uuid)}`,
+            payload: body,
+        });
+    }
+    async function removeEnvVar(payload) {
+        await fetcher.fetch({
+            method: "delete",
+            endpoint: `/hosting/env-vars/${encodeURIComponent(payload.uuid)}`,
+        });
+    }
+    async function listCustomDomains(payload) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: "/hosting/custom-domains/list",
+            params: payload,
+        });
+    }
+    async function getCustomDomain(payload) {
+        return await fetcher.fetch({
+            method: "get",
+            endpoint: `/hosting/custom-domains/${encodeURIComponent(payload.uuid)}`,
+        });
+    }
+    async function attachCustomDomain(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: "/hosting/custom-domains",
+            payload,
+        });
+    }
+    async function refreshCustomDomainStatus(payload) {
+        return await fetcher.fetch({
+            method: "post",
+            endpoint: `/hosting/custom-domains/${encodeURIComponent(payload.uuid)}/refresh-status`,
+        });
+    }
+    async function detachCustomDomain(payload) {
+        return await fetcher.fetch({
+            method: "delete",
+            endpoint: `/hosting/custom-domains/${encodeURIComponent(payload.uuid)}`,
+        });
+    }
+    return {
+        app: {
+            list: listApps,
+            get: getApp,
+            create: createApp,
+            update: updateApp,
+            remove: removeApp,
+        },
+        worker: {
+            list: listWorkers,
+            get: getWorker,
+            create: createWorker,
+            update: updateWorker,
+            remove: removeWorker,
+        },
+        deployment: {
+            list: listDeployments,
+            count: countDeployments,
+            get: getDeployment,
+            getPromoted: getPromotedDeployment,
+            getBuildLogUrl: getDeploymentBuildLogUrl,
+            create: createDeployment,
+            promote: promoteDeployment,
+            cancel: cancelDeployment,
+        },
+        envVars: {
+            list: listEnvVars,
+            create: createEnvVar,
+            update: updateEnvVar,
+            remove: removeEnvVar,
+        },
+        customDomain: {
+            list: listCustomDomains,
+            get: getCustomDomain,
+            attach: attachCustomDomain,
+            refreshStatus: refreshCustomDomainStatus,
+            detach: detachCustomDomain,
+        },
+    };
+};

package/build/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import type { Ai, Billing, Connection, Orchestration, RevenueOrganization, Segmentation, Storage, SystemOfRecordIntegration, WorkspaceManagement } from "../domains/index.js";
+import type { Ai, Billing, Connection, Hosting, Orchestration, RevenueOrganization, Segmentation, Storage, SystemOfRecordIntegration, WorkspaceManagement } from "../domains/index.js";
 import type { FetcherOrigin } from "../fetcher/index.js";
 import type { ApiType } from "../types.js";
 import type { AiApi } from "./ai/index.js";
@@ -6,6 +6,7 @@ import type { BillingApi } from "./billing/index.js";
 import type { ConnectionApi } from "./connection/index.js";
 import type { ContextApi } from "./context/index.js";
 import type { ExpressionApi } from "./expression/index.js";
+import type { HostingApi } from "./hosting/index.js";
 import type { OrchestrationApi } from "./orchestration/index.js";
 import type { RevenueOrganizationApi } from "./revenueOrganization/index.js";
 import type { SegmentationApi } from "./segmentation/index.js";
@@ -18,6 +19,7 @@ export * from "./billing/index.js";
 export * from "./connection/index.js";
 export * from "./context/index.js";
 export * from "./expression/index.js";
+export * from "./hosting/index.js";
 export * from "./orchestration/index.js";
 export * from "./revenueOrganization/index.js";
 export * from "./segmentation/index.js";
@@ -27,6 +29,13 @@ export * from "./workspaceManagement/index.js";
 export interface ApiDependencies {
     baseUrl?: string;
     workspaceUuid?: string;
+    /**
+     * If the API client runs inside a Cargo Hosted app, set this to the
+     * `VITE_CARGO_APP_UUID` so every request carries an `x-cargo-app-uuid`
+     * header. The backend uses it for usage attribution and as defence in depth
+     * on top of the user's own permissions.
+     */
+    appUuid?: string;
     getAccessToken?: (refresh?: boolean | undefined) => Promise<string>;
     accessToken?: string;
     origin?: FetcherOrigin;
@@ -43,6 +52,7 @@ export interface Api {
     expression: ExpressionApi;
     systemOfRecordIntegration: SystemOfRecordIntegrationApi;
     orchestration: OrchestrationApi;
+    hosting: HostingApi;
     userManagement: UserManagementApi;
     ai: AiApi;
 }
@@ -70,6 +80,8 @@ export type InitialisationResult = {
     systemOfRecords: SystemOfRecordIntegration.SystemOfRecord[];
     subscription: Billing.EnrichedSubscription;
     files: Ai.File[];
+    apps: Hosting.App[];
+    workers: Hosting.Worker[];
 };
 export declare const buildApi: (dependencies: ApiDependencies) => Api;
 //# sourceMappingURL=index.d.ts.map