zavudev 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac627d26a28d5901c971cff42e8d371b2d3d7dd0e33cce968fec7ed022b5e313
-  data.tar.gz: 8ae1361683e68009bdf39773686a547d8b52e9f09a03c51bc5cf0760e94cb2cd
+  metadata.gz: c816f9f292a722353051f15021fa10ecd35fa46e4c9875dd7233413793fe35b8
+  data.tar.gz: 06105ce64497bd6c8880a5faba2149ae0e666a931eab453bd89461bb133a97e2
 SHA512:
-  metadata.gz: 8d404f2e36a900ead47771f278bc535196df248578a09eb2e1f60aee91b748c3715dff3c54b69583d243d8b5f6552eeeb9cc33e47d9d6af432bfce1acb2a7d59
-  data.tar.gz: a1bcb630fc1cd3cd1211d21a2683cc5e643aca7cf13b192df10ec38c42ca806844e4ec5c100c6354c2b141db05b3ba64f1a06c0008a76531df68b0c64e1ca8f1
+  metadata.gz: acad7a45105f7224f636557539bddd3d1de2906b5ba7fc5b8986aeae84dc939507d44649d4f7c79f1c03a137e9d3170f76418c12a9eb5df41c118b174abc0c4c
+  data.tar.gz: 3c894b958050647adc91b001bbec1b21212f9de083f7211a4cdbf04cac3b108b11436fc892fa3aa790b879dea34f1c649ceca890828e6df7dec4daf91b270438

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.20.0 (2026-08-11)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/zavudev/sdk-ruby/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** api update ([bfbfdb3](https://github.com/zavudev/sdk-ruby/commit/bfbfdb30beabe539011761e0dbe5e6300bf84fc3))
+* **api:** api update ([3dd2f9a](https://github.com/zavudev/sdk-ruby/commit/3dd2f9ae33f97e322260043770b81046fbcfa86c))
+* **api:** api update ([047bf1a](https://github.com/zavudev/sdk-ruby/commit/047bf1add6b64c168649d72d649aa4f80d9b4783))
+* **api:** api update ([83ac772](https://github.com/zavudev/sdk-ruby/commit/83ac772861fac6e29983becf6ddfa399dbaa3561))
+* **api:** api update ([996f9ab](https://github.com/zavudev/sdk-ruby/commit/996f9ab52620b2ce5052530307e67e593da01f72))
+* **api:** api update ([3c61529](https://github.com/zavudev/sdk-ruby/commit/3c61529d5dac9a675e26719fc5e281805b4c7c6a))
+* **api:** api update ([258a1e6](https://github.com/zavudev/sdk-ruby/commit/258a1e6fff0b2264f4311fcb8bd7c9432256ea41))
+* **api:** api update ([e95c2eb](https://github.com/zavudev/sdk-ruby/commit/e95c2eba76c5a8f947c5e7fa72971908a1be90fe))
+* **api:** api update ([a7c2d4a](https://github.com/zavudev/sdk-ruby/commit/a7c2d4a72c856a10d30d4b59b9e88112459d3ce4))
+* **api:** api update ([4b5e9b6](https://github.com/zavudev/sdk-ruby/commit/4b5e9b6a2057514d9237fac1a37117126ad3fede))
+* **api:** api update ([37619ee](https://github.com/zavudev/sdk-ruby/commit/37619eeff5efc9cb775abc80f6e630cae4b06de1))
+* **api:** api update ([d361391](https://github.com/zavudev/sdk-ruby/commit/d361391e924c3f76eea26c2546495a96c88d86be))
+* **api:** api update ([62a0a2d](https://github.com/zavudev/sdk-ruby/commit/62a0a2d5729c99e9c51dcbe6f76467eb0f469c99))
+* **api:** api update ([554c6f2](https://github.com/zavudev/sdk-ruby/commit/554c6f26bbab79f4958f2478460c1801349d0f02))
+* **api:** api update ([b10ac2f](https://github.com/zavudev/sdk-ruby/commit/b10ac2ff0c6d73e830861515aca2456e042747ea))
+* **api:** api update ([ff8052b](https://github.com/zavudev/sdk-ruby/commit/ff8052b6c5e59819c7a51578209a51064d8c8427))
+* **api:** api update ([e44827f](https://github.com/zavudev/sdk-ruby/commit/e44827f9c758e460194e28a82c29ac57767dcdb9))
+* **api:** api update ([5167496](https://github.com/zavudev/sdk-ruby/commit/516749617b929620cf63104d3f972505c75222f6))
+* **api:** api update ([72b2d6a](https://github.com/zavudev/sdk-ruby/commit/72b2d6aedb40dde4995f5d4d2a7f98b2dd56e686))
+
 ## 0.19.0 (2026-07-23)
 
 Full Changelog: [v0.18.0...v0.19.0](https://github.com/zavudev/sdk-ruby/compare/v0.18.0...v0.19.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "zavudev", "~> 0.19.0"
+gem "zavudev", "~> 0.20.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/zavudev/models/function_create_params.rb

@@ -29,6 +29,25 @@ module Zavudev
       #   @return [String, nil]
       optional :description, String
 
+      # @!attribute entrypoint
+      #   Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @return [String, nil]
+      optional :entrypoint, String
+
+      # @!attribute files
+      #   The project's source files, keyed by path relative to the project root (e.g.
+      #   `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      #   function is built, so a function can be split across as many files as it needs.
+      #
+      #   Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      #   `package.json` are rejected. npm packages are not uploaded here — declare them
+      #   under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      #   for the whole tree.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :files, Zavudev::Internal::Type::HashOf[String]
+
       # @!attribute http_enabled
       #   Whether to expose a public HTTPS URL for this function.
       #
@@ -47,17 +66,26 @@ module Zavudev
       optional :runtime, enum: -> { Zavudev::FunctionCreateParams::Runtime }
 
       # @!attribute source_code
-      #   TypeScript source code for the function entry point (max ~900KB).
+      #   Shortcut for a single-file function: exactly equivalent to sending `files` with
+      #   one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      #   use whichever fits. If both are sent, `files` wins.
       #
       #   @return [String, nil]
       optional :source_code, String, api_name: :sourceCode
 
       # @!attribute timeout_sec
+      #   Per-invocation timeout in seconds. Event and cron invocations are asynchronous,
+      #   so a long timeout only bounds cost; a tool called during a live conversation
+      #   holds up the reply, and a function exposed over HTTP is additionally bounded by
+      #   the platform's HTTP response limit.
       #
       #   @return [Integer, nil]
       optional :timeout_sec, Integer, api_name: :timeoutSec
 
-      # @!method initialize(name:, slug:, dependencies: nil, description: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
+      # @!method initialize(name:, slug:, dependencies: nil, description: nil, entrypoint: nil, files: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::FunctionCreateParams} for more details.
+      #
       #   @param name [String]
       #
       #   @param slug [String] URL-safe identifier (lowercase, digits, hyphens). Must be unique per project.
@@ -66,15 +94,19 @@ module Zavudev
       #
       #   @param description [String]
       #
+      #   @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
       #   @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 source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
-      #   @param timeout_sec [Integer]
+      #   @param timeout_sec [Integer] Per-invocation timeout in seconds. Event and cron invocations are asynchronous,
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
 

data/lib/zavudev/models/function_create_response.rb

@@ -94,7 +94,9 @@ module Zavudev
         optional :description, String, nil?: true
 
         # @!attribute public_url
-        #   HTTPS endpoint when httpEnabled is true.
+        #   HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+        #   including for a function that was previously exposed — the stored URL stops
+        #   serving the moment HTTP is turned off, so it is never returned.
         #
         #   @return [String, nil]
         optional :public_url, String, api_name: :publicUrl, nil?: true
@@ -132,7 +134,7 @@ module Zavudev
         #
         #   @param description [String, nil]
         #
-        #   @param public_url [String, nil] HTTPS endpoint when httpEnabled is true.
+        #   @param public_url [String, nil] HTTPS endpoint, present only while httpEnabled is true. Null otherwise, includin
 
         # Runtime the function is deployed on.
         #

data/lib/zavudev/models/function_deploy_params.rb

@@ -18,18 +18,46 @@ module Zavudev
       #   @return [Hash{Symbol=>String}, nil]
       optional :dependencies, Zavudev::Internal::Type::HashOf[String]
 
+      # @!attribute entrypoint
+      #   Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @return [String, nil]
+      optional :entrypoint, String
+
+      # @!attribute files
+      #   The project's source files, keyed by path relative to the project root (e.g.
+      #   `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      #   function is built, so a function can be split across as many files as it needs.
+      #
+      #   Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      #   `package.json` are rejected. npm packages are not uploaded here — declare them
+      #   under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      #   for the whole tree.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :files, Zavudev::Internal::Type::HashOf[String]
+
       # @!attribute source_code
-      #   New source code to publish (replaces the draft).
+      #   Shortcut for a single-file function: exactly equivalent to sending `files` with
+      #   one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      #   use whichever fits. If both are sent, `files` wins.
       #
       #   @return [String, nil]
       optional :source_code, String, api_name: :sourceCode
 
-      # @!method initialize(function_id:, dependencies: nil, source_code: nil, request_options: {})
+      # @!method initialize(function_id:, dependencies: nil, entrypoint: nil, files: nil, source_code: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::FunctionDeployParams} for more details.
+      #
       #   @param function_id [String]
       #
       #   @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
       #
-      #   @param source_code [String] New source code to publish (replaces the draft).
+      #   @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
+      #   @param source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/zavudev/models/function_deploy_response.rb

@@ -41,7 +41,18 @@ module Zavudev
         #   @return [Integer]
         required :version, Integer
 
+        # @!attribute build_logs
+        #   What the build printed: dependency installation, the bundler's output, and the
+        #   compiler's message when it failed. Returned when fetching a single deployment,
+        #   omitted from the list. Read this first when a deploy fails — `errorMessage` is
+        #   often the outer wrapper's summary, and the line that names the broken import or
+        #   the syntax error is here.
+        #
+        #   @return [String, nil]
+        optional :build_logs, String, api_name: :buildLogs, nil?: true
+
         # @!attribute bundle_bytes
+        #   Size of the built bundle in bytes. Null until the build finishes.
         #
         #   @return [Integer, nil]
         optional :bundle_bytes, Integer, api_name: :bundleBytes, nil?: true
@@ -58,11 +69,15 @@ module Zavudev
         optional :error_message, String, api_name: :errorMessage, nil?: true
 
         # @!attribute source_code_bytes
+        #   Total size of the deployed source tree in bytes.
         #
         #   @return [Integer, nil]
         optional :source_code_bytes, Integer, api_name: :sourceCodeBytes, nil?: true
 
-        # @!method initialize(id:, created_at:, function_id:, status:, version:, bundle_bytes: nil, deployed_at: nil, error_message: nil, source_code_bytes: nil)
+        # @!method initialize(id:, created_at:, function_id:, status:, version:, build_logs: nil, bundle_bytes: nil, deployed_at: nil, error_message: nil, source_code_bytes: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::FunctionDeployResponse::Deployment} for more details.
+        #
         #   @param id [String]
         #
         #   @param created_at [Time]
@@ -73,13 +88,15 @@ module Zavudev
         #
         #   @param version [Integer] Monotonically increasing deployment version, starting at 1.
         #
-        #   @param bundle_bytes [Integer, nil]
+        #   @param build_logs [String, nil] What the build printed: dependency installation, the bundler's output, and the c
+        #
+        #   @param bundle_bytes [Integer, nil] Size of the built bundle in bytes. Null until the build finishes.
         #
         #   @param deployed_at [Time, nil]
         #
         #   @param error_message [String, nil] Failure reason when status is 'failed'.
         #
-        #   @param source_code_bytes [Integer, nil]
+        #   @param source_code_bytes [Integer, nil] Total size of the deployed source tree in bytes.
 
         # Stage of a function deployment.
         #

data/lib/zavudev/models/function_get_deployment_response.rb

@@ -41,7 +41,18 @@ module Zavudev
         #   @return [Integer]
         required :version, Integer
 
+        # @!attribute build_logs
+        #   What the build printed: dependency installation, the bundler's output, and the
+        #   compiler's message when it failed. Returned when fetching a single deployment,
+        #   omitted from the list. Read this first when a deploy fails — `errorMessage` is
+        #   often the outer wrapper's summary, and the line that names the broken import or
+        #   the syntax error is here.
+        #
+        #   @return [String, nil]
+        optional :build_logs, String, api_name: :buildLogs, nil?: true
+
         # @!attribute bundle_bytes
+        #   Size of the built bundle in bytes. Null until the build finishes.
         #
         #   @return [Integer, nil]
         optional :bundle_bytes, Integer, api_name: :bundleBytes, nil?: true
@@ -58,11 +69,15 @@ module Zavudev
         optional :error_message, String, api_name: :errorMessage, nil?: true
 
         # @!attribute source_code_bytes
+        #   Total size of the deployed source tree in bytes.
         #
         #   @return [Integer, nil]
         optional :source_code_bytes, Integer, api_name: :sourceCodeBytes, nil?: true
 
-        # @!method initialize(id:, created_at:, function_id:, status:, version:, bundle_bytes: nil, deployed_at: nil, error_message: nil, source_code_bytes: nil)
+        # @!method initialize(id:, created_at:, function_id:, status:, version:, build_logs: nil, bundle_bytes: nil, deployed_at: nil, error_message: nil, source_code_bytes: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::FunctionGetDeploymentResponse::Deployment} for more details.
+        #
         #   @param id [String]
         #
         #   @param created_at [Time]
@@ -73,13 +88,15 @@ module Zavudev
         #
         #   @param version [Integer] Monotonically increasing deployment version, starting at 1.
         #
-        #   @param bundle_bytes [Integer, nil]
+        #   @param build_logs [String, nil] What the build printed: dependency installation, the bundler's output, and the c
+        #
+        #   @param bundle_bytes [Integer, nil] Size of the built bundle in bytes. Null until the build finishes.
         #
         #   @param deployed_at [Time, nil]
         #
         #   @param error_message [String, nil] Failure reason when status is 'failed'.
         #
-        #   @param source_code_bytes [Integer, nil]
+        #   @param source_code_bytes [Integer, nil] Total size of the deployed source tree in bytes.
 
         # Stage of a function deployment.
         #

data/lib/zavudev/models/function_retrieve_response.rb

@@ -94,7 +94,9 @@ module Zavudev
         optional :description, String, nil?: true
 
         # @!attribute public_url
-        #   HTTPS endpoint when httpEnabled is true.
+        #   HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+        #   including for a function that was previously exposed — the stored URL stops
+        #   serving the moment HTTP is turned off, so it is never returned.
         #
         #   @return [String, nil]
         optional :public_url, String, api_name: :publicUrl, nil?: true
@@ -132,7 +134,7 @@ module Zavudev
         #
         #   @param description [String, nil]
         #
-        #   @param public_url [String, nil] HTTPS endpoint when httpEnabled is true.
+        #   @param public_url [String, nil] HTTPS endpoint, present only while httpEnabled is true. Null otherwise, includin
 
         # Runtime the function is deployed on.
         #

data/lib/zavudev/models/function_update_params.rb

@@ -18,18 +18,56 @@ module Zavudev
       #   @return [Hash{Symbol=>String}, nil]
       optional :dependencies, Zavudev::Internal::Type::HashOf[String]
 
+      # @!attribute entrypoint
+      #   Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @return [String, nil]
+      optional :entrypoint, String
+
+      # @!attribute files
+      #   The project's source files, keyed by path relative to the project root (e.g.
+      #   `index.ts`, `lib/orders.ts`). Imports between them are resolved when the
+      #   function is built, so a function can be split across as many files as it needs.
+      #
+      #   Paths must be relative and use forward slashes; `..`, `node_modules/` and
+      #   `package.json` are rejected. npm packages are not uploaded here — declare them
+      #   under `dependencies` and Zavu installs them. Limits: 200 files and 900,000 bytes
+      #   for the whole tree.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :files, Zavudev::Internal::Type::HashOf[String]
+
+      # @!attribute http_enabled
+      #   Expose the function on its public HTTPS URL, or take it down. Applies to the
+      #   already-deployed function without redeploying; the URL is returned as
+      #   `publicUrl`.
+      #
+      #   @return [Boolean, nil]
+      optional :http_enabled, Zavudev::Internal::Type::Boolean, api_name: :httpEnabled
+
       # @!attribute source_code
-      #   New source code to publish (replaces the draft).
+      #   Shortcut for a single-file function: exactly equivalent to sending `files` with
+      #   one entry named after `entrypoint` (`index.ts` by default). Fully supported —
+      #   use whichever fits. If both are sent, `files` wins.
       #
       #   @return [String, nil]
       optional :source_code, String, api_name: :sourceCode
 
-      # @!method initialize(function_id:, dependencies: nil, source_code: nil, request_options: {})
+      # @!method initialize(function_id:, dependencies: nil, entrypoint: nil, files: nil, http_enabled: nil, source_code: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::FunctionUpdateParams} for more details.
+      #
       #   @param function_id [String]
       #
       #   @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
       #
-      #   @param source_code [String] New source code to publish (replaces the draft).
+      #   @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      #   @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
+      #   @param http_enabled [Boolean] Expose the function on its public HTTPS URL, or take it down. Applies to the alr
+      #
+      #   @param source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/zavudev/models/function_update_response.rb

@@ -94,7 +94,9 @@ module Zavudev
         optional :description, String, nil?: true
 
         # @!attribute public_url
-        #   HTTPS endpoint when httpEnabled is true.
+        #   HTTPS endpoint, present only while httpEnabled is true. Null otherwise,
+        #   including for a function that was previously exposed — the stored URL stops
+        #   serving the moment HTTP is turned off, so it is never returned.
         #
         #   @return [String, nil]
         optional :public_url, String, api_name: :publicUrl, nil?: true
@@ -132,7 +134,7 @@ module Zavudev
         #
         #   @param description [String, nil]
         #
-        #   @param public_url [String, nil] HTTPS endpoint when httpEnabled is true.
+        #   @param public_url [String, nil] HTTPS endpoint, present only while httpEnabled is true. Null otherwise, includin
 
         # Runtime the function is deployed on.
         #

data/lib/zavudev/models/invitation.rb

@@ -28,6 +28,11 @@ module Zavudev
       # @!attribute status
       #   Current status of the partner invitation.
       #
+      #   `failed` means the client started the connection and it did not finish (they
+      #   cancelled Meta's dialog, denied a permission, or abandoned the tab). A failed
+      #   invitation is still usable: the same link can be retried, and it moves back to
+      #   `in_progress` when the client tries again.
+      #
       #   @return [Symbol, Zavudev::Models::Invitation::Status]
       required :status, enum: -> { Zavudev::Invitation::Status }
 
@@ -62,15 +67,43 @@ module Zavudev
       #   @return [Time, nil]
       optional :completed_at, Time, api_name: :completedAt, nil?: true
 
+      # @!attribute connected_account
+      #   The account the client linked, populated once the invitation is `completed`.
+      #   Null before that. Use it to show the partner what was connected without fetching
+      #   the sender.
+      #
+      #   @return [Zavudev::Models::Invitation::ConnectedAccount, nil]
+      optional :connected_account,
+               -> { Zavudev::Invitation::ConnectedAccount },
+               api_name: :connectedAccount,
+               nil?: true
+
       # @!attribute connection_type
-      #   How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      #   embedded signup).
+      #   Which Meta channel the client connects: `whatsapp_waba` (official WhatsApp Cloud
+      #   API via embedded signup) or `messenger` (a Facebook Page's Messenger inbox,
+      #   including Marketplace chats).
       #
       #   @return [Symbol, Zavudev::Models::Invitation::ConnectionType, nil]
       optional :connection_type, enum: -> { Zavudev::Invitation::ConnectionType }, api_name: :connectionType
 
+      # @!attribute failed_at
+      #
+      #   @return [Time, nil]
+      optional :failed_at, Time, api_name: :failedAt, nil?: true
+
+      # @!attribute failure_reason
+      #   Stable code for why the last attempt failed, present when `status` is `failed`.
+      #   Values include `fb_cancelled` (client closed Meta's dialog), `fb_not_authorized`
+      #   (permission denied), `signup_abandoned` (started but never finished),
+      #   `meta_no_pages` (the client administers no Facebook Page), and `internal_error`.
+      #   Treat unknown codes as a generic failure.
+      #
+      #   @return [String, nil]
+      optional :failure_reason, String, api_name: :failureReason, nil?: true
+
       # @!attribute phone_number_id
-      #   ID of a pre-assigned Zavu phone number for WhatsApp registration.
+      #   ID of a pre-assigned Zavu phone number for WhatsApp registration. Always null
+      #   for `messenger` invitations.
       #
       #   @return [String, nil]
       optional :phone_number_id, String, api_name: :phoneNumberId, nil?: true
@@ -91,7 +124,7 @@ module Zavudev
       #   @return [Time, nil]
       optional :viewed_at, Time, api_name: :viewedAt, nil?: true
 
-      # @!method initialize(id:, token:, created_at:, expires_at:, status:, updated_at:, url:, client_email: nil, client_name: nil, client_phone: nil, completed_at: nil, connection_type: nil, phone_number_id: nil, sender_id: nil, started_at: nil, viewed_at: nil)
+      # @!method initialize(id:, token:, created_at:, expires_at:, status:, updated_at:, url:, client_email: nil, client_name: nil, client_phone: nil, completed_at: nil, connected_account: nil, connection_type: nil, failed_at: nil, failure_reason: nil, phone_number_id: nil, sender_id: nil, started_at: nil, viewed_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Zavudev::Models::Invitation} for more details.
       #
@@ -117,9 +150,15 @@ module Zavudev
       #
       #   @param completed_at [Time, nil]
       #
-      #   @param connection_type [Symbol, Zavudev::Models::Invitation::ConnectionType] How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via embedd
+      #   @param connected_account [Zavudev::Models::Invitation::ConnectedAccount, nil] The account the client linked, populated once the invitation is `completed`. Nul
+      #
+      #   @param connection_type [Symbol, Zavudev::Models::Invitation::ConnectionType] Which Meta channel the client connects: `whatsapp_waba` (official WhatsApp Cloud
+      #
+      #   @param failed_at [Time, nil]
+      #
+      #   @param failure_reason [String, nil] Stable code for why the last attempt failed, present when `status` is `failed`.
       #
-      #   @param phone_number_id [String, nil] ID of a pre-assigned Zavu phone number for WhatsApp registration.
+      #   @param phone_number_id [String, nil] ID of a pre-assigned Zavu phone number for WhatsApp registration. Always null fo
       #
       #   @param sender_id [String, nil] ID of the sender created when invitation is completed.
       #
@@ -129,6 +168,11 @@ module Zavudev
 
       # Current status of the partner invitation.
       #
+      # `failed` means the client started the connection and it did not finish (they
+      # cancelled Meta's dialog, denied a permission, or abandoned the tab). A failed
+      # invitation is still usable: the same link can be retried, and it moves back to
+      # `in_progress` when the client tries again.
+      #
       # @see Zavudev::Models::Invitation#status
       module Status
         extend Zavudev::Internal::Type::Enum
@@ -138,19 +182,68 @@ module Zavudev
         COMPLETED = :completed
         EXPIRED = :expired
         CANCELLED = :cancelled
+        FAILED = :failed
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
 
-      # How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
-      # embedded signup).
+      # @see Zavudev::Models::Invitation#connected_account
+      class ConnectedAccount < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #   Provider-side identifier: the WhatsApp phone number ID, or the Facebook Page ID.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute channel
+        #
+        #   @return [Symbol, Zavudev::Models::Invitation::ConnectedAccount::Channel]
+        required :channel, enum: -> { Zavudev::Invitation::ConnectedAccount::Channel }
+
+        # @!attribute name
+        #   Display name of the connected account: the WhatsApp verified name, or the
+        #   Facebook Page name.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!method initialize(id:, channel:, name: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::Invitation::ConnectedAccount} for more details.
+        #
+        #   The account the client linked, populated once the invitation is `completed`.
+        #   Null before that. Use it to show the partner what was connected without fetching
+        #   the sender.
+        #
+        #   @param id [String] Provider-side identifier: the WhatsApp phone number ID, or the Facebook Page ID.
+        #
+        #   @param channel [Symbol, Zavudev::Models::Invitation::ConnectedAccount::Channel]
+        #
+        #   @param name [String, nil] Display name of the connected account: the WhatsApp verified name, or the Facebo
+
+        # @see Zavudev::Models::Invitation::ConnectedAccount#channel
+        module Channel
+          extend Zavudev::Internal::Type::Enum
+
+          WHATSAPP = :whatsapp
+          MESSENGER = :messenger
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Which Meta channel the client connects: `whatsapp_waba` (official WhatsApp Cloud
+      # API via embedded signup) or `messenger` (a Facebook Page's Messenger inbox,
+      # including Marketplace chats).
       #
       # @see Zavudev::Models::Invitation#connection_type
       module ConnectionType
         extend Zavudev::Internal::Type::Enum
 
         WHATSAPP_WABA = :whatsapp_waba
+        MESSENGER = :messenger
 
         # @!method self.values
         #   @return [Array<Symbol>]