prelude-sdk 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdd2764aef5a2905ae9ff686383745a878831c2402b1858f60025c4185f9fce1
-  data.tar.gz: be34c995e5c189bd7bfc38a03f30d0e399376ffdbb70f42c3776f64df56de7e4
+  metadata.gz: 0442af375a6b077b348b680c39f073a48a66ff185d57f5f20ee53300531a8bf7
+  data.tar.gz: 60d8b444c65e5e55b487f61d158c9531fcb02435c66a1f9eaa3688640789d08f
 SHA512:
-  metadata.gz: 953de3f45bdc0854d720388783118e6daff94fcfda5fa3de09bace85598b61e7165f87ac2439f1c275822e80f6811d711c055d2d8b5399824aec74f2dd715208
-  data.tar.gz: c7b590b961d3bcdb03aafbcc97fa3d4c80e0ac59a70a2dd79451000fe300b702c90a1cb30f7a6fa8c0604c73365f4e5fbb0da7a05e0df2aa77a1ee672ce5e008
+  metadata.gz: 6c337ee4e3c9f6d13391ae942cda76beaef0ff292b14b5416f66450005908bfe09d250fad09444635eaabf1fb3e02eb3ad8d356740218a0a7188729487c65639
+  data.tar.gz: cb6ae9f844d4a6d5313e001802b40b0624e93da2cfdbbefaec0cfa68f2cd14f74a0397dd8ac51d338f52b24c478f350d19d9eb77a8cf4d17d12e9fe7778ffcea

data/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## 0.3.0 (2026-03-23)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/prelude-so/ruby-sdk/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** api update ([24553b3](https://github.com/prelude-so/ruby-sdk/commit/24553b346bf3e424aa565b58dfc0a5ff339d0ffd))
+* **api:** api update ([c8e488b](https://github.com/prelude-so/ruby-sdk/commit/c8e488bc5106f22fd3c3e1e996aa865bf51ff3a1))
+* **api:** api update ([bc9d8d4](https://github.com/prelude-so/ruby-sdk/commit/bc9d8d41c941879192c531c1b5f07d619d4bfc7b))
+* **api:** api update ([1e8ea21](https://github.com/prelude-so/ruby-sdk/commit/1e8ea213c96c039d76722d6bc522e84e0ff0278f))
+* **api:** api update ([c339306](https://github.com/prelude-so/ruby-sdk/commit/c3393069dc67ed5ecaecb276b26c2308a00356d1))
+* **api:** api update ([ec6ca20](https://github.com/prelude-so/ruby-sdk/commit/ec6ca2085c7628b495b9486bd46c27656432e9eb))
+* **api:** api update ([64ca50e](https://github.com/prelude-so/ruby-sdk/commit/64ca50eae743d655d253c2ab6564eade851b60be))
+* **api:** api update ([240811f](https://github.com/prelude-so/ruby-sdk/commit/240811ffbc8caabaad46ce164bdb9ac3c6cbf9b0))
+
+
+### Bug Fixes
+
+* calling `break` out of streams should be instantaneous ([a880e79](https://github.com/prelude-so/ruby-sdk/commit/a880e79694d57969c34395666edbd365d5a65483))
+* **client:** add types for path params, and update structure of unions nested in params ([dff25fc](https://github.com/prelude-so/ruby-sdk/commit/dff25fc4134005a9e8a7f84d8fc6fbd5f9ac8098))
+* **client:** always add content-length to post body, even when empty ([73b8b98](https://github.com/prelude-so/ruby-sdk/commit/73b8b98d2f14602fb5b297a697d3894699659b84))
+* **client:** loosen json header parsing ([144e10b](https://github.com/prelude-so/ruby-sdk/commit/144e10bb50679a7748df724edf574a86fc8fbc9e))
+* **client:** serialize query parameters properly ([e59d46e](https://github.com/prelude-so/ruby-sdk/commit/e59d46eaa39b1033807c4c000cfb4220b1c8d0ff))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([5960180](https://github.com/prelude-so/ruby-sdk/commit/59601805484363ad564d640ae2dec6a2eff08f26))
+* properly mock time in ruby ci tests ([19a7259](https://github.com/prelude-so/ruby-sdk/commit/19a7259d6c21e24e6773487981154c17215846f0))
+
+
+### Chores
+
+* **ci:** add build step ([9517e54](https://github.com/prelude-so/ruby-sdk/commit/9517e54b4ad0cf6bfeefdb9c227217f5f732cf27))
+* **ci:** skip uploading artifacts on stainless-internal branches ([b239f23](https://github.com/prelude-so/ruby-sdk/commit/b239f237e3b67cc6a01f992028fc5885336f6538))
+* **docs:** add missing descriptions ([874587d](https://github.com/prelude-so/ruby-sdk/commit/874587d45083a9a5e0fc188b378a9b8d58dd39a5))
+* **docs:** remove www prefix ([9c41466](https://github.com/prelude-so/ruby-sdk/commit/9c41466d86710318107d52692f8efb93515e9738))
+* **internal:** codegen related update ([4721c32](https://github.com/prelude-so/ruby-sdk/commit/4721c32fbc82220da55e561f4ad10ac22223108b))
+* **internal:** codegen related update ([d227583](https://github.com/prelude-so/ruby-sdk/commit/d227583e5a4a92a1cbc4bd75ed70b18df8a2f0ff))
+* **internal:** tweak CI branches ([1a3bb89](https://github.com/prelude-so/ruby-sdk/commit/1a3bb8905066138aec8da0bba42d3f699da7144f))
+* **internal:** update `actions/checkout` version ([dd49de2](https://github.com/prelude-so/ruby-sdk/commit/dd49de2c037b0f622d7cdead21ab464a1455363f))
+* **internal:** update gitignore ([603a4c6](https://github.com/prelude-so/ruby-sdk/commit/603a4c69350448463dae3f8d99d6aa09d0c48b1b))
+* **test:** do not count install time for mock server timeout ([77b5e70](https://github.com/prelude-so/ruby-sdk/commit/77b5e70ec2a773c70e55ca4cb3e527e8d2446459))
+* **tests:** bump steady to v0.19.4 ([001f050](https://github.com/prelude-so/ruby-sdk/commit/001f050d338b3015dba4527bc278795fadb04ac2))
+* **tests:** bump steady to v0.19.5 ([e824cb0](https://github.com/prelude-so/ruby-sdk/commit/e824cb0c8e2f3f601a4e07f7c36afeafcfff9b28))
+* update mock server docs ([6fa353c](https://github.com/prelude-so/ruby-sdk/commit/6fa353cd9d0112786119b6a50d96fc48c77253c3))
+
+
+### Refactors
+
+* **tests:** switch from prism to steady ([4f1499f](https://github.com/prelude-so/ruby-sdk/commit/4f1499f85472caac00731960ba4a9623131c57f6))
+
+## 0.2.0 (2025-12-05)
+
+Full Changelog: [v0.1.0...v0.2.0](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0...v0.2.0)
+
+### Features
+
+* **api:** add Notify API methods ([8ce7793](https://github.com/prelude-so/ruby-sdk/commit/8ce7793912b2b074deaa66c32e4cc2b7d0873623))
+
+
+### Chores
+
+* explicitly require "base64" gem ([ce6be23](https://github.com/prelude-so/ruby-sdk/commit/ce6be23941786dfe0ed1356b31eb65014da48407))
+
 ## 0.1.0 (2025-11-17)
 
 Full Changelog: [v0.1.0-alpha.3...v0.1.0](https://github.com/prelude-so/ruby-sdk/compare/v0.1.0-alpha.3...v0.1.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "prelude-sdk", "~> 0.1.0"
+gem "prelude-sdk", "~> 0.3.0"
 ```
 
 <!-- x-release-please-end -->
@@ -207,25 +207,25 @@ prelude.verification.create(**params)
 Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
 
 ```ruby
-# :allow
-puts(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW)
+# :SUB
+puts(PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State::SUB)
 
-# Revealed type: `T.all(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action, Symbol)`
-T.reveal_type(PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW)
+# Revealed type: `T.all(PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State, Symbol)`
+T.reveal_type(PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State::SUB)
 ```
 
 Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
 
 ```ruby
 # Using the enum constants preserves the tagged type information:
-prelude.verification_management.delete_phone_number(
-  action: PreludeSDK::VerificationManagementDeletePhoneNumberParams::Action::ALLOW,
+prelude.notify.list_subscription_phone_numbers(
+  state: PreludeSDK::NotifyListSubscriptionPhoneNumbersParams::State::SUB,
   # …
 )
 
 # Literal values are also permissible:
-prelude.verification_management.delete_phone_number(
-  action: :allow,
+prelude.notify.list_subscription_phone_numbers(
+  state: :SUB,
   # …
 )
 ```

data/lib/prelude_sdk/client.rb

@@ -19,18 +19,28 @@ module PreludeSDK
     # @return [String]
     attr_reader :api_token
 
+    # Retrieve detailed information about a phone number including carrier data, line
+    # type, and portability status.
     # @return [PreludeSDK::Resources::Lookup]
     attr_reader :lookup
 
+    # Send transactional and marketing messages with compliance enforcement.
+    # @return [PreludeSDK::Resources::Notify]
+    attr_reader :notify
+
+    # Send transactional messages (deprecated - use Notify API instead).
     # @return [PreludeSDK::Resources::Transactional]
     attr_reader :transactional
 
+    # Verify phone numbers.
     # @return [PreludeSDK::Resources::Verification]
     attr_reader :verification
 
+    # Verify phone numbers.
     # @return [PreludeSDK::Resources::VerificationManagement]
     attr_reader :verification_management
 
+    # Evaluate email addresses and phone numbers for trustworthiness.
     # @return [PreludeSDK::Resources::Watch]
     attr_reader :watch
 
@@ -82,6 +92,7 @@ module PreludeSDK
       )
 
       @lookup = PreludeSDK::Resources::Lookup.new(client: self)
+      @notify = PreludeSDK::Resources::Notify.new(client: self)
       @transactional = PreludeSDK::Resources::Transactional.new(client: self)
       @verification = PreludeSDK::Resources::Verification.new(client: self)
       @verification_management = PreludeSDK::Resources::VerificationManagement.new(client: self)

data/lib/prelude_sdk/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module PreludeSDK
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = PreludeSDK::Internal::Util::ReadIOAdapter.new(body, &blk)
@@ -153,17 +153,19 @@ module PreludeSDK
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure

data/lib/prelude_sdk/internal/util.rb

@@ -485,11 +485,42 @@ module PreludeSDK
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -657,7 +688,8 @@ module PreludeSDK
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in PreludeSDK::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +699,11 @@ module PreludeSDK
           in PreludeSDK::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/prelude_sdk/models/lookup_lookup_params.rb

@@ -7,6 +7,12 @@ module PreludeSDK
       extend PreludeSDK::Internal::Type::RequestParameters::Converter
       include PreludeSDK::Internal::Type::RequestParameters
 
+      # @!attribute phone_number
+      #   An E.164 formatted phone number to look up.
+      #
+      #   @return [String]
+      required :phone_number, String
+
       # @!attribute type
       #   Optional features. Possible values are:
       #
@@ -16,10 +22,12 @@ module PreludeSDK
       #   @return [Array<Symbol, PreludeSDK::Models::LookupLookupParams::Type>, nil]
       optional :type, -> { PreludeSDK::Internal::Type::ArrayOf[enum: PreludeSDK::LookupLookupParams::Type] }
 
-      # @!method initialize(type: nil, request_options: {})
+      # @!method initialize(phone_number:, type: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PreludeSDK::Models::LookupLookupParams} for more details.
       #
+      #   @param phone_number [String] An E.164 formatted phone number to look up.
+      #
       #   @param type [Array<Symbol, PreludeSDK::Models::LookupLookupParams::Type>] Optional features. Possible values are:
       #
       #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]

data/lib/prelude_sdk/models/notify_get_subscription_config_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#get_subscription_config
+    class NotifyGetSubscriptionConfigParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!method initialize(config_id:, request_options: {})
+      #   @param config_id [String]
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_get_subscription_config_response.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#get_subscription_config
+    class NotifyGetSubscriptionConfigResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute id
+      #   The subscription configuration ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute callback_url
+      #   The URL to call when subscription status changes.
+      #
+      #   @return [String]
+      required :callback_url, String
+
+      # @!attribute created_at
+      #   The date and time when the configuration was created.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute messages
+      #   The subscription messages configuration.
+      #
+      #   @return [PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::Messages]
+      required :messages, -> { PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::Messages }
+
+      # @!attribute name
+      #   The human-readable name for the subscription configuration.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute updated_at
+      #   The date and time when the configuration was last updated.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute mo_phone_numbers
+      #   A list of phone numbers for receiving inbound messages.
+      #
+      #   @return [Array<PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::MoPhoneNumber>, nil]
+      optional :mo_phone_numbers,
+               -> { PreludeSDK::Internal::Type::ArrayOf[PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::MoPhoneNumber] }
+
+      # @!method initialize(id:, callback_url:, created_at:, messages:, name:, updated_at:, mo_phone_numbers: nil)
+      #   @param id [String] The subscription configuration ID.
+      #
+      #   @param callback_url [String] The URL to call when subscription status changes.
+      #
+      #   @param created_at [Time] The date and time when the configuration was created.
+      #
+      #   @param messages [PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::Messages] The subscription messages configuration.
+      #
+      #   @param name [String] The human-readable name for the subscription configuration.
+      #
+      #   @param updated_at [Time] The date and time when the configuration was last updated.
+      #
+      #   @param mo_phone_numbers [Array<PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::MoPhoneNumber>] A list of phone numbers for receiving inbound messages.
+
+      # @see PreludeSDK::Models::NotifyGetSubscriptionConfigResponse#messages
+      class Messages < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute help_message
+        #   Message sent when user requests help.
+        #
+        #   @return [String, nil]
+        optional :help_message, String
+
+        # @!attribute start_message
+        #   Message sent when user subscribes.
+        #
+        #   @return [String, nil]
+        optional :start_message, String
+
+        # @!attribute stop_message
+        #   Message sent when user unsubscribes.
+        #
+        #   @return [String, nil]
+        optional :stop_message, String
+
+        # @!method initialize(help_message: nil, start_message: nil, stop_message: nil)
+        #   The subscription messages configuration.
+        #
+        #   @param help_message [String] Message sent when user requests help.
+        #
+        #   @param start_message [String] Message sent when user subscribes.
+        #
+        #   @param stop_message [String] Message sent when user unsubscribes.
+      end
+
+      class MoPhoneNumber < PreludeSDK::Internal::Type::BaseModel
+        # @!attribute country_code
+        #   The ISO 3166-1 alpha-2 country code.
+        #
+        #   @return [String]
+        required :country_code, String
+
+        # @!attribute phone_number
+        #   The phone number in E.164 format for long codes, or short code format for short
+        #   codes.
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!method initialize(country_code:, phone_number:)
+        #   Some parameter documentations has been truncated, see
+        #   {PreludeSDK::Models::NotifyGetSubscriptionConfigResponse::MoPhoneNumber} for
+        #   more details.
+        #
+        #   @param country_code [String] The ISO 3166-1 alpha-2 country code.
+        #
+        #   @param phone_number [String] The phone number in E.164 format for long codes, or short code format for short
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_get_subscription_phone_number_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#get_subscription_phone_number
+    class NotifyGetSubscriptionPhoneNumberParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute config_id
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!attribute phone_number
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!method initialize(config_id:, phone_number:, request_options: {})
+      #   @param config_id [String]
+      #   @param phone_number [String]
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_get_subscription_phone_number_response.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#get_subscription_phone_number
+    class NotifyGetSubscriptionPhoneNumberResponse < PreludeSDK::Internal::Type::BaseModel
+      # @!attribute config_id
+      #   The subscription configuration ID.
+      #
+      #   @return [String]
+      required :config_id, String
+
+      # @!attribute phone_number
+      #   The phone number in E.164 format.
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!attribute source
+      #   How the subscription state was changed:
+      #
+      #   - `MO_KEYWORD` - User sent a keyword (STOP/START)
+      #   - `API` - Changed via API
+      #   - `CSV_IMPORT` - Imported from CSV
+      #   - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+      #
+      #   @return [Symbol, PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::Source]
+      required :source, enum: -> { PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::Source }
+
+      # @!attribute state
+      #   The subscription state:
+      #
+      #   - `SUB` - Subscribed (user can receive marketing messages)
+      #   - `UNSUB` - Unsubscribed (user has opted out)
+      #
+      #   @return [Symbol, PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::State]
+      required :state, enum: -> { PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::State }
+
+      # @!attribute updated_at
+      #   The date and time when the subscription status was last updated.
+      #
+      #   @return [Time]
+      required :updated_at, Time
+
+      # @!attribute reason
+      #   Additional context about the state change (e.g., the keyword that was sent).
+      #
+      #   @return [String, nil]
+      optional :reason, String
+
+      # @!method initialize(config_id:, phone_number:, source:, state:, updated_at:, reason: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse} for more details.
+      #
+      #   @param config_id [String] The subscription configuration ID.
+      #
+      #   @param phone_number [String] The phone number in E.164 format.
+      #
+      #   @param source [Symbol, PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::Source] How the subscription state was changed:
+      #
+      #   @param state [Symbol, PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse::State] The subscription state:
+      #
+      #   @param updated_at [Time] The date and time when the subscription status was last updated.
+      #
+      #   @param reason [String] Additional context about the state change (e.g., the keyword that was sent).
+
+      # How the subscription state was changed:
+      #
+      # - `MO_KEYWORD` - User sent a keyword (STOP/START)
+      # - `API` - Changed via API
+      # - `CSV_IMPORT` - Imported from CSV
+      # - `CARRIER_DISCONNECT` - Automatically unsubscribed due to carrier disconnect
+      #
+      # @see PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse#source
+      module Source
+        extend PreludeSDK::Internal::Type::Enum
+
+        MO_KEYWORD = :MO_KEYWORD
+        API = :API
+        CSV_IMPORT = :CSV_IMPORT
+        CARRIER_DISCONNECT = :CARRIER_DISCONNECT
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # The subscription state:
+      #
+      # - `SUB` - Subscribed (user can receive marketing messages)
+      # - `UNSUB` - Unsubscribed (user has opted out)
+      #
+      # @see PreludeSDK::Models::NotifyGetSubscriptionPhoneNumberResponse#state
+      module State
+        extend PreludeSDK::Internal::Type::Enum
+
+        SUB = :SUB
+        UNSUB = :UNSUB
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/prelude_sdk/models/notify_list_subscription_configs_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module PreludeSDK
+  module Models
+    # @see PreludeSDK::Resources::Notify#list_subscription_configs
+    class NotifyListSubscriptionConfigsParams < PreludeSDK::Internal::Type::BaseModel
+      extend PreludeSDK::Internal::Type::RequestParameters::Converter
+      include PreludeSDK::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #   Pagination cursor from the previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #   Maximum number of configurations to return per page
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   @param cursor [String] Pagination cursor from the previous response
+      #
+      #   @param limit [Integer] Maximum number of configurations to return per page
+      #
+      #   @param request_options [PreludeSDK::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end