zavudev 0.9.1 → 0.11.0

data/lib/zavudev/models/me_retrieve_response.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Me#retrieve
+    class MeRetrieveResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute api_key
+      #
+      #   @return [Zavudev::Models::MeRetrieveResponse::APIKey]
+      required :api_key, -> { Zavudev::Models::MeRetrieveResponse::APIKey }, api_name: :apiKey
+
+      # @!attribute is_test_mode
+      #
+      #   @return [Boolean]
+      required :is_test_mode, Zavudev::Internal::Type::Boolean, api_name: :isTestMode
+
+      # @!attribute project
+      #
+      #   @return [Zavudev::Models::MeRetrieveResponse::Project]
+      required :project, -> { Zavudev::Models::MeRetrieveResponse::Project }
+
+      # @!attribute team
+      #
+      #   @return [Zavudev::Models::MeRetrieveResponse::Team]
+      required :team, -> { Zavudev::Models::MeRetrieveResponse::Team }
+
+      # @!method initialize(api_key:, is_test_mode:, project:, team:)
+      #   @param api_key [Zavudev::Models::MeRetrieveResponse::APIKey]
+      #   @param is_test_mode [Boolean]
+      #   @param project [Zavudev::Models::MeRetrieveResponse::Project]
+      #   @param team [Zavudev::Models::MeRetrieveResponse::Team]
+
+      # @see Zavudev::Models::MeRetrieveResponse#api_key
+      class APIKey < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!method initialize(id:)
+        #   @param id [String]
+      end
+
+      # @see Zavudev::Models::MeRetrieveResponse#project
+      class Project < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute is_sub_account
+        #
+        #   @return [Boolean]
+        required :is_sub_account, Zavudev::Internal::Type::Boolean, api_name: :isSubAccount
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!method initialize(id:, is_sub_account:, name:)
+        #   @param id [String]
+        #   @param is_sub_account [Boolean]
+        #   @param name [String, nil]
+      end
+
+      # @see Zavudev::Models::MeRetrieveResponse#team
+      class Team < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        required :name, String, nil?: true
+
+        # @!method initialize(id:, name:)
+        #   @param id [String]
+        #   @param name [String, nil]
+      end
+    end
+  end
+end

data/lib/zavudev/models/message_show_typing_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#show_typing
+    class MessageShowTypingParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute message_id
+      #
+      #   @return [String]
+      required :message_id, String
+
+      # @!attribute zavu_sender
+      #
+      #   @return [String, nil]
+      optional :zavu_sender, String
+
+      # @!method initialize(message_id:, zavu_sender: nil, request_options: {})
+      #   @param message_id [String]
+      #   @param zavu_sender [String]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/message_show_typing_response.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Messages#show_typing
+    class MessageShowTypingResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute success
+      #
+      #   @return [Boolean]
+      required :success, Zavudev::Internal::Type::Boolean
+
+      # @!method initialize(success:)
+      #   @param success [Boolean]
+    end
+  end
+end

data/lib/zavudev/models/senders/agent/execution_retrieve_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module Senders
+      module Agent
+        # @see Zavudev::Resources::Senders::Agent::Executions#retrieve
+        class ExecutionRetrieveParams < Zavudev::Internal::Type::BaseModel
+          extend Zavudev::Internal::Type::RequestParameters::Converter
+          include Zavudev::Internal::Type::RequestParameters
+
+          # @!attribute sender_id
+          #
+          #   @return [String]
+          required :sender_id, String
+
+          # @!attribute execution_id
+          #
+          #   @return [String]
+          required :execution_id, String
+
+          # @!method initialize(sender_id:, execution_id:, request_options: {})
+          #   @param sender_id [String]
+          #   @param execution_id [String]
+          #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/senders/agent/execution_retrieve_response.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module Senders
+      module Agent
+        # @see Zavudev::Resources::Senders::Agent::Executions#retrieve
+        class ExecutionRetrieveResponse < Zavudev::Internal::Type::BaseModel
+          # @!attribute execution
+          #
+          #   @return [Zavudev::Models::Senders::AgentExecution]
+          required :execution, -> { Zavudev::Senders::AgentExecution }
+
+          # @!method initialize(execution:)
+          #   @param execution [Zavudev::Models::Senders::AgentExecution]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/webhook_event.rb

@@ -35,6 +35,13 @@ module Zavudev
     #
     # - `invitation.status_changed`: A partner invitation status changed (pending,
     #   in_progress, completed, cancelled)
+    #
+    # **Custom domain events:**
+    #
+    # - `domain.verified`: A custom email domain passed verification (DKIM, and
+    #   SPF/DMARC/MAIL FROM if enhanced records are enabled)
+    # - `domain.failed`: A custom email domain failed verification or is partially
+    #   verified
     module WebhookEvent
       extend Zavudev::Internal::Type::Enum
 
@@ -49,6 +56,8 @@ module Zavudev
       CONVERSATION_NEW = :"conversation.new"
       TEMPLATE_STATUS_CHANGED = :"template.status_changed"
       INVITATION_STATUS_CHANGED = :"invitation.status_changed"
+      DOMAIN_VERIFIED = :"domain.verified"
+      DOMAIN_FAILED = :"domain.failed"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/zavudev/models.rb

@@ -103,6 +103,8 @@ module Zavudev
 
   ContactCreateParams = Zavudev::Models::ContactCreateParams
 
+  ContactDeleteParams = Zavudev::Models::ContactDeleteParams
+
   ContactDismissMergeSuggestionParams = Zavudev::Models::ContactDismissMergeSuggestionParams
 
   ContactListParams = Zavudev::Models::ContactListParams
@@ -125,6 +127,22 @@ module Zavudev
 
   ExportRetrieveParams = Zavudev::Models::ExportRetrieveParams
 
+  FunctionCreateParams = Zavudev::Models::FunctionCreateParams
+
+  FunctionDeleteParams = Zavudev::Models::FunctionDeleteParams
+
+  FunctionDeployParams = Zavudev::Models::FunctionDeployParams
+
+  FunctionGetDeploymentParams = Zavudev::Models::FunctionGetDeploymentParams
+
+  FunctionRetrieveParams = Zavudev::Models::FunctionRetrieveParams
+
+  Functions = Zavudev::Models::Functions
+
+  FunctionTailLogsParams = Zavudev::Models::FunctionTailLogsParams
+
+  FunctionUpdateParams = Zavudev::Models::FunctionUpdateParams
+
   IntrospectValidatePhoneParams = Zavudev::Models::IntrospectValidatePhoneParams
 
   Invitation = Zavudev::Models::Invitation
@@ -139,6 +157,8 @@ module Zavudev
 
   LineType = Zavudev::Models::LineType
 
+  MeRetrieveParams = Zavudev::Models::MeRetrieveParams
+
   Message = Zavudev::Models::Message
 
   MessageContent = Zavudev::Models::MessageContent
@@ -153,6 +173,8 @@ module Zavudev
 
   MessageSendParams = Zavudev::Models::MessageSendParams
 
+  MessageShowTypingParams = Zavudev::Models::MessageShowTypingParams
+
   MessageStatus = Zavudev::Models::MessageStatus
 
   MessageType = Zavudev::Models::MessageType

data/lib/zavudev/resources/contacts.rb

@@ -102,6 +102,30 @@ module Zavudev
         )
       end
 
+      # Permanently delete a contact and its communication channels. Implements
+      # right-to-erasure obligations under GDPR Art. 17, Ley 19.628 (Chile) Art. 12,
+      # CCPA § 1798.105, and LGPD Art. 18.VI. The contact, its channels, and any
+      # associated agent flow sessions and conversation threads are removed. Past
+      # message records and broadcast delivery logs are retained for billing/audit but
+      # no longer reference the deleted contact.
+      #
+      # @overload delete(contact_id, request_options: {})
+      #
+      # @param contact_id [String]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Zavudev::Models::ContactDeleteParams
+      def delete(contact_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/contacts/%1$s", contact_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
       # Dismiss the merge suggestion for a contact.
       #
       # @overload dismiss_merge_suggestion(contact_id, request_options: {})

data/lib/zavudev/resources/functions/secrets.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Functions
+      class Secrets
+        # Lists every secret key set on the function. Plaintext is NEVER returned — only
+        # the last 4 characters of each value, for visual confirmation.
+        #
+        # @overload list(function_id, request_options: {})
+        #
+        # @param function_id [String] Zavu Function ID.
+        #
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Zavudev::Models::Functions::SecretListResponse]
+        #
+        # @see Zavudev::Models::Functions::SecretListParams
+        def list(function_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["v1/functions/%1$s/secrets", function_id],
+            model: Zavudev::Models::Functions::SecretListResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Create or update a secret on a function. Marks the function out-of-sync; the
+        # next `POST /deploy` re-publishes the Lambda with the new env. Keys must match
+        # `[A-Z_][A-Z0-9_]*` (uppercase env-var style) and cannot start with reserved
+        # prefixes (AWS*, LAMBDA*, etc).
+        #
+        # @overload set(key, function_id:, value:, request_options: {})
+        #
+        # @param key [String] Path param
+        #
+        # @param function_id [String] Path param: Zavu Function ID.
+        #
+        # @param value [String] Body param
+        #
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Object]
+        #
+        # @see Zavudev::Models::Functions::SecretSetParams
+        def set(key, params)
+          parsed, options = Zavudev::Functions::SecretSetParams.dump_request(params)
+          function_id =
+            parsed.delete(:function_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :put,
+            path: ["v1/functions/%1$s/secrets/%2$s", function_id, key],
+            body: parsed,
+            model: Zavudev::Internal::Type::Unknown,
+            options: options
+          )
+        end
+
+        # Remove a secret from a function. Doesn't take effect on the running Lambda until
+        # the next deploy.
+        #
+        # @overload unset(key, function_id:, request_options: {})
+        #
+        # @param key [String]
+        #
+        # @param function_id [String] Zavu Function ID.
+        #
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Zavudev::Models::Functions::SecretUnsetParams
+        def unset(key, params)
+          parsed, options = Zavudev::Functions::SecretUnsetParams.dump_request(params)
+          function_id =
+            parsed.delete(:function_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/functions/%1$s/secrets/%2$s", function_id, key],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Zavudev::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/resources/functions.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Functions
+      # @return [Zavudev::Resources::Functions::Secrets]
+      attr_reader :secrets
+
+      # Create a new Zavu Function. The function starts in `draft` status. A dedicated
+      # API key is auto-provisioned and injected as the `ZAVU_API_KEY` secret so the
+      # function can call back into the Zavu API without manual setup.
+      #
+      # Provide `sourceCode` to seed the draft. Call
+      # `POST /v1/functions/{functionId}/deploy` afterwards to publish.
+      #
+      # @overload create(name:, slug:, dependencies: nil, description: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
+      #
+      # @param name [String]
+      #
+      # @param slug [String] URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.
+      #
+      # @param dependencies [Hash{Symbol=>String}] npm dependencies. Keys are package names, values are semver ranges.
+      #
+      # @param description [String]
+      #
+      # @param http_enabled [Boolean] Whether to expose a public HTTPS URL for this function.
+      #
+      # @param memory_mb [Integer, Zavudev::Models::FunctionCreateParams::MemoryMB]
+      #
+      # @param runtime [Symbol, Zavudev::Models::FunctionCreateParams::Runtime] Runtime the function is deployed on.
+      #
+      # @param source_code [String] TypeScript source code for the function entry point (max ~900KB).
+      #
+      # @param timeout_sec [Integer]
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionCreateResponse]
+      #
+      # @see Zavudev::Models::FunctionCreateParams
+      def create(params)
+        parsed, options = Zavudev::FunctionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/functions",
+          body: parsed,
+          model: Zavudev::Models::FunctionCreateResponse,
+          options: options
+        )
+      end
+
+      # Get function
+      #
+      # @overload retrieve(function_id, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionRetrieveResponse]
+      #
+      # @see Zavudev::Models::FunctionRetrieveParams
+      def retrieve(function_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/functions/%1$s", function_id],
+          model: Zavudev::Models::FunctionRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Update the draft source code and/or dependency map without triggering a build.
+      # Visible in the dashboard immediately, but the live (deployed) function does not
+      # change until `POST /v1/functions/{functionId}/deploy` runs.
+      #
+      # @overload update(function_id, dependencies: nil, source_code: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
+      #
+      # @param source_code [String] New source code to publish (replaces the draft).
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionUpdateResponse]
+      #
+      # @see Zavudev::Models::FunctionUpdateParams
+      def update(function_id, params = {})
+        parsed, options = Zavudev::FunctionUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/functions/%1$s", function_id],
+          body: parsed,
+          model: Zavudev::Models::FunctionUpdateResponse,
+          options: options
+        )
+      end
+
+      # Permanently delete a function and cascade: triggers, secrets, deployment
+      # history, managed agents+tools, and revoke the auto-provisioned API key. The AWS
+      # Lambda + log group are torn down asynchronously.
+      #
+      # @overload delete(function_id, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionDeleteResponse]
+      #
+      # @see Zavudev::Models::FunctionDeleteParams
+      def delete(function_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/functions/%1$s", function_id],
+          model: Zavudev::Models::FunctionDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Publish the function. If `sourceCode` or `dependencies` are provided in the
+      # body, they replace the current draft before deployment. Returns immediately with
+      # a deployment ID — poll `GET /v1/functions/deployments/{deploymentId}` until
+      # status is `active` or `failed`.
+      #
+      # @overload deploy(function_id, dependencies: nil, source_code: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
+      #
+      # @param source_code [String] New source code to publish (replaces the draft).
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionDeployResponse]
+      #
+      # @see Zavudev::Models::FunctionDeployParams
+      def deploy(function_id, params = {})
+        parsed, options = Zavudev::FunctionDeployParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/functions/%1$s/deploy", function_id],
+          body: parsed,
+          model: Zavudev::Models::FunctionDeployResponse,
+          options: options
+        )
+      end
+
+      # Fetch a deployment to poll its status during a deploy.
+      #
+      # @overload get_deployment(deployment_id, request_options: {})
+      #
+      # @param deployment_id [String] Function deployment ID.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionGetDeploymentResponse]
+      #
+      # @see Zavudev::Models::FunctionGetDeploymentParams
+      def get_deployment(deployment_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/functions/deployments/%1$s", deployment_id],
+          model: Zavudev::Models::FunctionGetDeploymentResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Fetch invocation logs for a function. Logs are paginated via `nextToken`. Pass
+      # `startTime` / `endTime` (Unix epoch milliseconds) to bound the window, or
+      # `filterPattern` to filter messages.
+      #
+      # @overload tail_logs(function_id, end_time: nil, filter_pattern: nil, limit: nil, next_token: nil, start_time: nil, request_options: {})
+      #
+      # @param function_id [String] Zavu Function ID.
+      #
+      # @param end_time [Integer] End of the log window in Unix epoch milliseconds.
+      #
+      # @param filter_pattern [String]
+      #
+      # @param limit [Integer]
+      #
+      # @param next_token [String]
+      #
+      # @param start_time [Integer] Start of the log window in Unix epoch milliseconds.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::FunctionTailLogsResponse]
+      #
+      # @see Zavudev::Models::FunctionTailLogsParams
+      def tail_logs(function_id, params = {})
+        parsed, options = Zavudev::FunctionTailLogsParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/functions/%1$s/logs", function_id],
+          query: query.transform_keys(
+            end_time: "endTime",
+            filter_pattern: "filterPattern",
+            next_token: "nextToken",
+            start_time: "startTime"
+          ),
+          model: Zavudev::Models::FunctionTailLogsResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+        @secrets = Zavudev::Resources::Functions::Secrets.new(client: client)
+      end
+    end
+  end
+end

data/lib/zavudev/resources/me.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Me
+      # Returns the project, team, and API key metadata bound to the current Bearer
+      # token. Used by CLIs and SDKs to confirm which project they will operate on.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::MeRetrieveResponse]
+      #
+      # @see Zavudev::Models::MeRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "v1/me",
+          model: Zavudev::Models::MeRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/zavudev/resources/messages.rb

@@ -155,6 +155,37 @@ module Zavudev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::MessageShowTypingParams} for more details.
+      #
+      # Mark an inbound WhatsApp message as read and display a typing indicator to the
+      # user while you prepare a response. The indicator is automatically dismissed when
+      # you send a reply, or after 25 seconds — whichever comes first. Only valid for
+      # inbound WhatsApp messages. Use this when a reply will take more than a couple of
+      # seconds (LLM agent, tool call, lookup) to improve the recipient's experience.
+      #
+      # @overload show_typing(message_id, zavu_sender: nil, request_options: {})
+      #
+      # @param message_id [String]
+      #
+      # @param zavu_sender [String] Optional sender profile ID. If omitted, the project's default sender will be use
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::MessageShowTypingResponse]
+      #
+      # @see Zavudev::Models::MessageShowTypingParams
+      def show_typing(message_id, params = {})
+        parsed, options = Zavudev::MessageShowTypingParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/messages/%1$s/typing", message_id],
+          headers: parsed.transform_keys(zavu_sender: "zavu-sender"),
+          model: Zavudev::Models::MessageShowTypingResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Zavudev::Client]