square.rb 34.1.0.20231213 → 35.0.0.20240118

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b29bc50c5ee5bebc08ff29a066e77f35975336e71bbdad94416f59c58f4863f0
-  data.tar.gz: 4257fabf7ea4d1b49198744a53206ff4a6d21724267701c199a9ea7a7b58b734
+  metadata.gz: 249614d84c1818c028f583951e3fa380f1533985909801204a1ee94eb0a91733
+  data.tar.gz: 4ae2b2cceb63628934b529fff05bd58f2cd27d8f22ae10a44ec26e0bc40f087d
 SHA512:
-  metadata.gz: aa095d1d8cc6d0e8e7a84321bb9158dccb291105237a8b080c9033b946c314183c7c74e01467ba6f2c2e12684b45baaad28e33a55ebdf3395f2a2268b81410e8
-  data.tar.gz: f75abe542aef5e60c7166d9fd22db64db1d0f67e53fc2015e07a399624ba7575a161045a1858c1df46e61194bcbca75c21db8e647a26b46143fecbf0d9b4b9aa
+  metadata.gz: 7ebdb416a8041d2d70a9d8108ce432ec26f2558bc67589a5f5e5625625f4366f4998d20575e0a8ac9e872b11a37133180ee6b27d7fffc9147674ff89a638f05e
+  data.tar.gz: 8fe1a39713a031a36023433a9a84c7492654a28adbd1c02a5130513cfd936336ad2c9c7d53ec707623498f8fc4bc3972bd9a2c45756664d2b628350c45b0ee45

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2023 Square, Inc.
+Copyright 2024 Square, Inc.
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

data/lib/square/api/base_api.rb

@@ -4,7 +4,7 @@ module Square
     attr_accessor :config, :http_call_back
 
     def self.user_agent
-      'Square-Ruby-SDK/34.1.0.20231213 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
+      'Square-Ruby-SDK/35.0.0.20240118 ({api-version}) {engine}/{engine-version} ({os-info}) {detail}'
     end
 
     def self.user_agent_parameters

data/lib/square/api/customers_api.rb

@@ -177,7 +177,7 @@ module Square
     # Updates a customer profile. This endpoint supports sparse updates, so only
     # new or changed fields are required in the request.
     # To add or update a field, specify the new value. To remove a field,
-    # specify `null` and include the `X-Clear-Null` header set to `true`
+    # specify `null`
     # (recommended) or specify an empty string (string fields only).
     # As a best practice, include the `version` field in the request to enable
     # [optimistic

data/lib/square/api/invoices_api.rb

@@ -171,6 +171,71 @@ module Square
         .execute
     end
 
+    # Uploads a file and attaches it to an invoice. This endpoint accepts HTTP
+    # multipart/form-data file uploads
+    # with a JSON `request` part and a `file` part. The `file` part must be a
+    # `readable stream` that contains a file
+    # in a supported format: GIF, JPEG, PNG, TIFF, BMP, or PDF.
+    # Invoices can have up to 10 attachments with a total file size of 25 MB.
+    # Attachments can be added only to invoices
+    # in the `DRAFT`, `SCHEDULED`, `UNPAID`, or `PARTIALLY_PAID` state.
+    # @param [String] invoice_id Required parameter: The ID of the
+    # [invoice](entity:Invoice) to attach the file to.
+    # @param [CreateInvoiceAttachmentRequest] request Optional parameter:
+    # Represents a
+    # [CreateInvoiceAttachment]($e/Invoices/CreateInvoiceAttachment) request.
+    # @param [File | UploadIO] image_file Optional parameter: Example:
+    # @return [CreateInvoiceAttachmentResponse Hash] response from the API call
+    def create_invoice_attachment(invoice_id:,
+                                  request: nil,
+                                  image_file: nil)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v2/invoices/{invoice_id}/attachments',
+                                     'default')
+                   .template_param(new_parameter(invoice_id, key: 'invoice_id')
+                                    .should_encode(true))
+                   .multipart_param(new_parameter(StringIO.new(request.to_json), key: 'request')
+                                     .default_content_type('application/json; charset=utf-8'))
+                   .multipart_param(new_parameter(image_file, key: 'image_file')
+                                     .default_content_type('image/jpeg'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
+    # Removes an attachment from an invoice and permanently deletes the file.
+    # Attachments can be removed only
+    # from invoices in the `DRAFT`, `SCHEDULED`, `UNPAID`, or `PARTIALLY_PAID`
+    # state.
+    # @param [String] invoice_id Required parameter: The ID of the
+    # [invoice](entity:Invoice) to delete the attachment from.
+    # @param [String] attachment_id Required parameter: The ID of the
+    # [attachment](entity:InvoiceAttachment) to delete.
+    # @return [DeleteInvoiceAttachmentResponse Hash] response from the API call
+    def delete_invoice_attachment(invoice_id:,
+                                  attachment_id:)
+      new_api_call_builder
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v2/invoices/{invoice_id}/attachments/{attachment_id}',
+                                     'default')
+                   .template_param(new_parameter(invoice_id, key: 'invoice_id')
+                                    .should_encode(true))
+                   .template_param(new_parameter(attachment_id, key: 'attachment_id')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('global')))
+        .response(new_response_handler
+                   .deserializer(APIHelper.method(:json_deserialize))
+                   .is_api_response(true)
+                   .convertor(ApiResponse.method(:create)))
+        .execute
+    end
+
     # Cancels an invoice. The seller cannot collect payments for
     # the canceled invoice.
     # You cannot cancel an invoice in the `DRAFT` state or in a terminal state:

data/lib/square/client.rb

@@ -4,7 +4,7 @@ module Square
     attr_reader :config, :auth_managers
 
     def sdk_version
-      '34.1.0.20231213'
+      '35.0.0.20240118'
     end
 
     def square_version
@@ -267,7 +267,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-12-13', user_agent_detail: '',
+                   square_version: '2024-01-18', user_agent_detail: '',
                    additional_headers: {}, config: nil)
       @config = if config.nil?
                   Configuration.new(connection: connection, adapter: adapter,

data/lib/square/configuration.rb

@@ -19,7 +19,7 @@ module Square
                    retry_methods: %i[get put], http_callback: nil,
                    environment: 'production',
                    custom_url: 'https://connect.squareup.com', access_token: '',
-                   square_version: '2023-12-13', user_agent_detail: '',
+                   square_version: '2024-01-18', user_agent_detail: '',
                    additional_headers: {})
 
       super connection: connection, adapter: adapter, timeout: timeout,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: square.rb
 version: !ruby/object:Gem::Version
-  version: 34.1.0.20231213
+  version: 35.0.0.20240118
 platform: ruby
 authors:
 - Square Developer Platform
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-12 00:00:00.000000000 Z
+date: 2024-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: apimatic_core_interfaces