@phala/cloud 0.0.1 → 0.0.2

package/dist/actions/provision_cvm.d.ts

@@ -0,0 +1,228 @@
+import { z } from "zod";
+import { type Client, type SafeResult } from "../client";
+import { ActionParameters, ActionReturnType } from "../types/common";
+/**
+ * Provision a CVM (Confidential Virtual Machine)
+ *
+ * This action provisions a new CVM on a specified node, returning the app_id, encryption public key, and other metadata required for secure deployment.
+ *
+ * @example
+ * ```typescript
+ * import { createClient, getAvailableNodes, provisionCvm } from '@phala/cloud'
+ *
+ * const client = createClient();
+ * const nodes = await getAvailableNodes(client);
+ * const node = nodes.nodes[0];
+ *
+ * const docker_compose = `
+ *version: '3'
+ *services:
+ *  demo:
+ *    image: leechael/phala-cloud-bun-starter:latest
+ *    container_name: demo
+ *    ports:
+ *      - "3000:3000"
+ *    volumes:
+ *      - /var/run/tappd.sock:/var/run/tappd.sock
+ *`;
+ *
+ * const app_compose = {
+ *   name: 'my-app',
+ *   node_id: node.node_id,
+ *   image: node.images[0].name,
+ *   vcpu: 1,
+ *   memory: 1024,
+ *   disk_size: 10,
+ *   compose_file: {
+ *     docker_compose_file: docker_compose,
+ *     name: 'my-app',
+ *   },
+ * };
+ *
+ * const result = await provisionCvm(client, app_compose);
+ * console.log(result.app_id);
+ * ```
+ *
+ * ## Safe Version
+ *
+ * Use `safeProvisionCvm` for error handling without exceptions:
+ *
+ * ```typescript
+ * const result = await safeProvisionCvm(client, app_compose);
+ * if (result.success) {
+ *   console.log(result.data.app_id);
+ * } else {
+ *   console.error('Failed to provision CVM:', result.error.message);
+ * }
+ * ```
+ */
+export declare const ProvisionCvmSchema: z.ZodObject<{
+    app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    app_env_encrypt_pubkey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compose_hash: z.ZodString;
+    fmspc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    device_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    os_image_hash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    node_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    app_env_encrypt_pubkey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compose_hash: z.ZodString;
+    fmspc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    device_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    os_image_hash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    node_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    app_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    app_env_encrypt_pubkey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    compose_hash: z.ZodString;
+    fmspc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    device_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    os_image_hash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    node_id: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ProvisionCvm = z.infer<typeof ProvisionCvmSchema>;
+export declare const ProvisionCvmRequestSchema: z.ZodObject<{
+    node_id: z.ZodOptional<z.ZodNumber>;
+    teepod_id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    image: z.ZodString;
+    vcpu: z.ZodNumber;
+    memory: z.ZodNumber;
+    disk_size: z.ZodNumber;
+    compose_file: z.ZodObject<{
+        allowed_envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pre_launch_script: z.ZodOptional<z.ZodString>;
+        docker_compose_file: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        kms_enabled: z.ZodOptional<z.ZodBoolean>;
+        public_logs: z.ZodOptional<z.ZodBoolean>;
+        public_sysinfo: z.ZodOptional<z.ZodBoolean>;
+        gateway_enabled: z.ZodOptional<z.ZodBoolean>;
+        tproxy_enabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }>;
+    listed: z.ZodOptional<z.ZodBoolean>;
+    instance_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kms_id: z.ZodOptional<z.ZodString>;
+    env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    node_id: z.ZodOptional<z.ZodNumber>;
+    teepod_id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    image: z.ZodString;
+    vcpu: z.ZodNumber;
+    memory: z.ZodNumber;
+    disk_size: z.ZodNumber;
+    compose_file: z.ZodObject<{
+        allowed_envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pre_launch_script: z.ZodOptional<z.ZodString>;
+        docker_compose_file: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        kms_enabled: z.ZodOptional<z.ZodBoolean>;
+        public_logs: z.ZodOptional<z.ZodBoolean>;
+        public_sysinfo: z.ZodOptional<z.ZodBoolean>;
+        gateway_enabled: z.ZodOptional<z.ZodBoolean>;
+        tproxy_enabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }>;
+    listed: z.ZodOptional<z.ZodBoolean>;
+    instance_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kms_id: z.ZodOptional<z.ZodString>;
+    env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    node_id: z.ZodOptional<z.ZodNumber>;
+    teepod_id: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodString;
+    image: z.ZodString;
+    vcpu: z.ZodNumber;
+    memory: z.ZodNumber;
+    disk_size: z.ZodNumber;
+    compose_file: z.ZodObject<{
+        allowed_envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        pre_launch_script: z.ZodOptional<z.ZodString>;
+        docker_compose_file: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        kms_enabled: z.ZodOptional<z.ZodBoolean>;
+        public_logs: z.ZodOptional<z.ZodBoolean>;
+        public_sysinfo: z.ZodOptional<z.ZodBoolean>;
+        gateway_enabled: z.ZodOptional<z.ZodBoolean>;
+        tproxy_enabled: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }, {
+        docker_compose_file?: string | undefined;
+        pre_launch_script?: string | undefined;
+        name?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+        gateway_enabled?: boolean | undefined;
+        tproxy_enabled?: boolean | undefined;
+    }>;
+    listed: z.ZodOptional<z.ZodBoolean>;
+    instance_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kms_id: z.ZodOptional<z.ZodString>;
+    env_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ProvisionCvmRequest = z.infer<typeof ProvisionCvmRequestSchema> & {
+    node_id?: number;
+    teepod_id?: number;
+    compose_file?: {
+        gateway_enabled?: boolean;
+        tproxy_enabled?: boolean;
+        [key: string]: unknown;
+    };
+};
+export type ProvisionCvmParameters<T = undefined> = ActionParameters<T>;
+export type ProvisionCvmReturnType<T = undefined> = ActionReturnType<ProvisionCvm, T>;
+export declare function provisionCvm<T extends z.ZodSchema | false | undefined = undefined>(client: Client, appCompose: ProvisionCvmRequest, parameters?: ProvisionCvmParameters<T>): Promise<ProvisionCvmReturnType<T>>;
+export declare function safeProvisionCvm<T extends z.ZodSchema | false | undefined = undefined>(client: Client, appCompose: ProvisionCvmRequest, parameters?: ProvisionCvmParameters<T>): Promise<SafeResult<ProvisionCvmReturnType<T>>>;
+//# sourceMappingURL=provision_cvm.d.ts.map

package/dist/actions/provision_cvm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision_cvm.d.ts","sourceRoot":"","sources":["../../src/actions/provision_cvm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAGH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;gCAUf,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAyBtB,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAAG;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE;QACb,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAExE,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,SAAS,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AA8DtF,wBAAsB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EACtF,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,mBAAmB,EAC/B,UAAU,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAuBpC;AAGD,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EAC1F,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,mBAAmB,EAC/B,UAAU,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CA4BhD"}

package/dist/actions/provision_cvm_compose_file_update.d.ts

@@ -0,0 +1,313 @@
+import { z } from "zod";
+import { type Client, type SafeResult } from "../client";
+import { ActionParameters, ActionReturnType } from "../types/common";
+/**
+ * Provision CVM compose file update
+ *
+ * Provisions a CVM compose file update by uploading the new compose file configuration.
+ * Returns a compose_hash that must be used with `commitCvmComposeFileUpdate` to finalize the update.
+ *
+ * @example
+ * ```typescript
+ * import { createClient, provisionCvmComposeFileUpdate } from '@phala/cloud'
+ *
+ * const client = createClient({ apiKey: 'your-api-key' })
+ * const result = await provisionCvmComposeFileUpdate(client, {
+ *   id: 'cvm-123',
+ *   app_compose: {
+ *     name: 'my-app',
+ *     docker_compose_file: 'version: "3.8"\nservices:\n  app:\n    image: nginx'
+ *   }
+ * })
+ * console.log(`Compose hash: ${result.compose_hash}`)
+ * ```
+ *
+ * ## Returns
+ *
+ * `ProvisionCvmComposeFileUpdateResult | unknown`
+ *
+ * Provision response including compose_hash and metadata needed for committing the update.
+ * Return type depends on schema parameter.
+ *
+ * ## Parameters
+ *
+ * ### request (required)
+ * - **Type:** `ProvisionCvmComposeFileUpdateRequest`
+ *
+ * Request parameters containing the CVM ID and compose file configuration.
+ *
+ * ### parameters (optional)
+ * - **Type:** `ProvisionCvmComposeFileUpdateParameters`
+ *
+ * Optional behavior parameters for schema validation.
+ *
+ * ```typescript
+ * // Use default schema
+ * const result = await provisionCvmComposeFileUpdate(client, {
+ *   id: 'cvm-123',
+ *   app_compose: { name: 'my-app', docker_compose_file: '...' }
+ * })
+ *
+ * // Return raw data without validation
+ * const raw = await provisionCvmComposeFileUpdate(client, request, { schema: false })
+ *
+ * // Use custom schema
+ * const customSchema = z.object({ compose_hash: z.string() })
+ * const custom = await provisionCvmComposeFileUpdate(client, request, { schema: customSchema })
+ * ```
+ *
+ * ## Safe Version
+ *
+ * Use `safeProvisionCvmComposeFileUpdate` for error handling without exceptions:
+ *
+ * ```typescript
+ * import { safeProvisionCvmComposeFileUpdate } from '@phala/cloud'
+ *
+ * const result = await safeProvisionCvmComposeFileUpdate(client, {
+ *   id: 'cvm-123',
+ *   app_compose: { name: 'my-app', docker_compose_file: '...' }
+ * })
+ * if (result.success) {
+ *   console.log(`Compose hash: ${result.data.compose_hash}`)
+ * } else {
+ *   if ("isRequestError" in result.error) {
+ *     console.error(`HTTP ${result.error.status}: ${result.error.message}`)
+ *   } else {
+ *     console.error(`Validation error: ${result.error.issues}`)
+ *   }
+ * }
+ * ```
+ */
+export declare const ProvisionCvmComposeFileUpdateRequestSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    uuid: z.ZodOptional<z.ZodString>;
+    app_id: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    instance_id: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    app_compose: z.ZodObject<{
+        allowed_envs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        docker_compose_file: z.ZodString;
+        name: z.ZodString;
+        kms_enabled: z.ZodOptional<z.ZodBoolean>;
+        public_logs: z.ZodOptional<z.ZodBoolean>;
+        public_sysinfo: z.ZodOptional<z.ZodBoolean>;
+        pre_launch_script: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    }, {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    app_compose: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    id?: string | undefined;
+    app_id?: string | undefined;
+    instance_id?: string | undefined;
+    uuid?: string | undefined;
+}, {
+    app_compose: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    id?: string | undefined;
+    app_id?: string | undefined;
+    instance_id?: string | undefined;
+    uuid?: string | undefined;
+}>, {
+    app_compose: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    id?: string | undefined;
+    app_id?: string | undefined;
+    instance_id?: string | undefined;
+    uuid?: string | undefined;
+}, {
+    app_compose: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    id?: string | undefined;
+    app_id?: string | undefined;
+    instance_id?: string | undefined;
+    uuid?: string | undefined;
+}>, {
+    cvmId: string | undefined;
+    request: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    _raw: {
+        app_compose: {
+            docker_compose_file: string;
+            name: string;
+            pre_launch_script?: string | undefined;
+            allowed_envs?: string[] | undefined;
+            kms_enabled?: boolean | undefined;
+            public_logs?: boolean | undefined;
+            public_sysinfo?: boolean | undefined;
+        };
+        id?: string | undefined;
+        app_id?: string | undefined;
+        instance_id?: string | undefined;
+        uuid?: string | undefined;
+    };
+}, {
+    app_compose: {
+        docker_compose_file: string;
+        name: string;
+        pre_launch_script?: string | undefined;
+        allowed_envs?: string[] | undefined;
+        kms_enabled?: boolean | undefined;
+        public_logs?: boolean | undefined;
+        public_sysinfo?: boolean | undefined;
+    };
+    id?: string | undefined;
+    app_id?: string | undefined;
+    instance_id?: string | undefined;
+    uuid?: string | undefined;
+}>;
+export declare const ProvisionCvmComposeFileUpdateResultSchema: z.ZodObject<{
+    app_id: z.ZodNullable<z.ZodString>;
+    device_id: z.ZodNullable<z.ZodString>;
+    compose_hash: z.ZodString;
+    kms_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    app_id: z.ZodNullable<z.ZodString>;
+    device_id: z.ZodNullable<z.ZodString>;
+    compose_hash: z.ZodString;
+    kms_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    app_id: z.ZodNullable<z.ZodString>;
+    device_id: z.ZodNullable<z.ZodString>;
+    compose_hash: z.ZodString;
+    kms_info: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        slug: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        version: z.ZodString;
+        chain_id: z.ZodNullable<z.ZodNumber>;
+        kms_contract_address: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+        gateway_app_id: z.ZodEffects<z.ZodNullable<z.ZodString>, `0x${string}`, string | null>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ProvisionCvmComposeFileUpdateRequest = z.input<typeof ProvisionCvmComposeFileUpdateRequestSchema>;
+export type ProvisionCvmComposeFileUpdateResult = z.infer<typeof ProvisionCvmComposeFileUpdateResultSchema>;
+export type ProvisionCvmComposeFileUpdateParameters<T = undefined> = ActionParameters<T>;
+export type ProvisionCvmComposeFileUpdateReturnType<T = undefined> = ActionReturnType<ProvisionCvmComposeFileUpdateResult, T>;
+/**
+ * Provision a CVM compose file update
+ *
+ * @param client - The API client
+ * @param request - Request parameters containing CVM ID and compose file configuration
+ * @param parameters - Optional behavior parameters
+ * @returns Update provision result
+ */
+export declare function provisionCvmComposeFileUpdate<T extends z.ZodSchema | false | undefined = undefined>(client: Client, request: ProvisionCvmComposeFileUpdateRequest, parameters?: ProvisionCvmComposeFileUpdateParameters<T>): Promise<ProvisionCvmComposeFileUpdateReturnType<T>>;
+/**
+ * Safe version of provisionCvmComposeFileUpdate that returns a Result type instead of throwing
+ */
+export declare function safeProvisionCvmComposeFileUpdate<T extends z.ZodSchema | false | undefined = undefined>(client: Client, request: ProvisionCvmComposeFileUpdateRequest, parameters?: ProvisionCvmComposeFileUpdateParameters<T>): Promise<SafeResult<ProvisionCvmComposeFileUpdateReturnType<T>>>;
+//# sourceMappingURL=provision_cvm_compose_file_update.d.ts.map

package/dist/actions/provision_cvm_compose_file_update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision_cvm_compose_file_update.d.ts","sourceRoot":"","sources":["../../src/actions/provision_cvm_compose_file_update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AAEH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyClD,CAAC;AAEN,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAOtC,CAAC;AAEjB,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CACxD,OAAO,0CAA0C,CAClD,CAAC;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AAEF,MAAM,MAAM,uCAAuC,CAAC,CAAC,GAAG,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AACzF,MAAM,MAAM,uCAAuC,CAAC,CAAC,GAAG,SAAS,IAAI,gBAAgB,CACnF,mCAAmC,EACnC,CAAC,CACF,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EAErD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oCAAoC,EAC7C,UAAU,CAAC,EAAE,uCAAuC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,uCAAuC,CAAC,CAAC,CAAC,CAAC,CAcrD;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,EAErD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oCAAoC,EAC7C,UAAU,CAAC,EAAE,uCAAuC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,UAAU,CAAC,uCAAuC,CAAC,CAAC,CAAC,CAAC,CAAC,CAwBjE"}

package/dist/client.d.ts

@@ -0,0 +1,80 @@
+import { ofetch, type FetchOptions, type FetchRequest } from "ofetch";
+import { type SafeResult, RequestError, type ClientConfig } from "./types/client";
+export type { SafeResult } from "./types/client";
+/**
+ * HTTP Client class with ofetch compatibility
+ */
+export declare class Client {
+    protected fetchInstance: typeof ofetch;
+    readonly config: ClientConfig;
+    constructor(config?: ClientConfig);
+    /**
+     * Get the underlying ofetch instance for advanced usage
+     */
+    get raw(): import("ofetch").$Fetch;
+    /**
+     * Perform GET request (throws on error)
+     */
+    get<T = unknown>(request: FetchRequest, options?: Omit<FetchOptions, "method">): Promise<T>;
+    /**
+     * Perform POST request (throws on error)
+     */
+    post<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<T>;
+    /**
+     * Perform PUT request (throws on error)
+     */
+    put<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<T>;
+    /**
+     * Perform PATCH request (throws on error)
+     */
+    patch<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<T>;
+    /**
+     * Perform DELETE request (throws on error)
+     */
+    delete<T = unknown>(request: FetchRequest, options?: Omit<FetchOptions, "method">): Promise<T>;
+    /**
+     * Safe wrapper for any request method (zod-style result)
+     */
+    private safeRequest;
+    /**
+     * Safe GET request (returns SafeResult)
+     */
+    safeGet<T = unknown>(request: FetchRequest, options?: Omit<FetchOptions, "method">): Promise<SafeResult<T, RequestError>>;
+    /**
+     * Safe POST request (returns SafeResult)
+     */
+    safePost<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<SafeResult<T, RequestError>>;
+    /**
+     * Safe PUT request (returns SafeResult)
+     */
+    safePut<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<SafeResult<T, RequestError>>;
+    /**
+     * Safe PATCH request (returns SafeResult)
+     */
+    safePatch<T = unknown>(request: FetchRequest, body?: RequestInit["body"] | Record<string, unknown>, options?: Omit<FetchOptions, "method" | "body">): Promise<SafeResult<T, RequestError>>;
+    /**
+     * Safe DELETE request (returns SafeResult)
+     */
+    safeDelete<T = unknown>(request: FetchRequest, options?: Omit<FetchOptions, "method">): Promise<SafeResult<T, RequestError>>;
+}
+/**
+ * Create a new HTTP client instance
+ *
+ * Configuration can be provided via parameters or environment variables:
+ * - PHALA_CLOUD_API_KEY: API key for authentication
+ * - PHALA_CLOUD_API_PREFIX: Base URL prefix for the API
+ *
+ * @example
+ * ```typescript
+ * // Using explicit configuration
+ * const client = createClient({
+ *   apiKey: 'your-api-key',
+ *   baseURL: 'https://custom-api.example.com'
+ * })
+ *
+ * // Using environment variables (set PHALA_CLOUD_API_KEY)
+ * const client = createClient()
+ * ```
+ */
+export declare function createClient(config?: ClientConfig): Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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