cetustek 0.8.0 → 0.10.0

data/lib/cetustek/soap.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'savon'
+
+module Cetustek
+  # Shared SOAP plumbing: every operation hits the same WSDL and authenticates
+  # with 網站代碼+APIPassword (source) and the 租賃者統編 (rentid).
+  module Soap
+    def soap_client
+      Savon.client(wsdl: Cetustek.config.url, open_timeout: 300, read_timeout: 300)
+    end
+
+    def source
+      Cetustek.config.site_id + Cetustek.config.password
+    end
+
+    def rentid
+      Cetustek.config.username
+    end
+
+    def soap_call(operation, message)
+      soap_client.call(operation, message: message.merge(source: source, rentid: rentid))
+    end
+
+    def soap_return(response, operation)
+      response.body[:"#{operation}_response"][:return]
+    end
+  end
+end

data/lib/cetustek/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cetustek
-  VERSION = "0.8.0"
+  VERSION = "0.10.0"
 end

data/lib/cetustek/xml.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require 'ox'
+require 'cgi'
+
+module Cetustek
+  # Every request document in the spec is the same shape: a UTF-8 declaration
+  # and a single <Invoice>/<Allowance> root carrying XSDVersion.
+  module Xml
+    XSD_VERSION = '2.8'
+
+    module_function
+
+    def document(root_name)
+      doc = Ox::Document.new
+      instruct = Ox::Instruct.new(:xml)
+      instruct[:version] = '1.0'
+      instruct[:encoding] = 'UTF-8'
+      doc << instruct
+
+      root = Ox::Element.new(root_name)
+      root[:XSDVersion] = XSD_VERSION
+      doc << root
+      yield root
+
+      Ox.dump(doc).force_encoding('UTF-8')
+    end
+
+    # Values are HTML-escaped so that special characters (&, <, >, ", ') in any
+    # dynamic field cannot break the XML or be used for injection.
+    def tag(name, value)
+      Ox::Raw.new("<#{name}>#{CGI.escapeHTML(value.to_s)}</#{name}>")
+    end
+
+    # Fields whose 備註 says "若未填，預設 X" are left out entirely when nil, so
+    # the platform applies its own default instead of parsing an empty value.
+    def append(element, name, value, skip_nil: false)
+      return if skip_nil && value.nil?
+
+      element << tag(name, value)
+    end
+
+    # Shared guard every Query* class needs before it can parse a response
+    # body: nil for an empty answer or one of the documented sentinel strings
+    # (e.g. "nodata"); ResultError for a bare result code; otherwise the
+    # parsed root element, ready for parse_fields.
+    def parse_response(body, nil_values: [])
+      text = body.to_s.strip
+      return nil if text.empty? || nil_values.include?(text)
+
+      ResultCode.raise!(text, ResultCode::COMMON) unless text.start_with?('<')
+
+      root = Ox.parse(text)
+      root.is_a?(Ox::Document) ? root.root : root
+    end
+
+    # Shared response-parsing side: every Query* class turns a response
+    # element into a Hash of snake_case keys, so this lives here once instead
+    # of once per query class.
+    def parse_fields(element, fields)
+      fields.to_h { |field| [snake_case(field), text_of(element, field)] }
+    end
+
+    def text_of(element, name)
+      element&.locate(name)&.first&.text
+    end
+
+    def snake_case(name)
+      name.gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase.to_sym
+    end
+  end
+end

data/lib/cetustek.rb

@@ -3,11 +3,13 @@
 require_relative "cetustek/version"
 require_relative "cetustek/errors"
 require_relative "cetustek/configuration"
+require_relative "cetustek/xml"
+require_relative "cetustek/soap"
 require_relative "cetustek/models/allowance_data"
 require_relative "cetustek/create_invoice"
 require_relative "cetustek/cancel_invoice"
-require_relative "cetustek/query_invoice_by_order_id"
 require_relative "cetustek/queries"
+require_relative "cetustek/query_invoice_by_order_id"
 require_relative "cetustek/create_allowance"
 require_relative "cetustek/cancel_allowance"
 require_relative "cetustek/phone_barcode"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cetustek
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Zac
@@ -90,10 +90,11 @@ files:
 - lib/cetustek/phone_barcode.rb
 - lib/cetustek/queries.rb
 - lib/cetustek/query_invoice_by_order_id.rb
-- lib/cetustek/services/invoice_service.rb
 - lib/cetustek/services/invoice_xml_builder.rb
 - lib/cetustek/services/response_handler.rb
+- lib/cetustek/soap.rb
 - lib/cetustek/version.rb
+- lib/cetustek/xml.rb
 - sig/cetustek.rbs
 homepage: https://github.com/7a6163/cetustek
 licenses:

data/lib/cetustek/services/invoice_service.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require 'savon'
-
-module Cetustek
-  module Services
-    # 2.1 CreateInvoiceV3(invoicexml, hastax, rentid, source)
-    class InvoiceService
-      def initialize(xml, hastax = 1)
-        @xml = xml
-        @hastax = hastax
-      end
-
-      def create
-        Savon.client(
-          wsdl: Cetustek.config.url,
-          open_timeout: 300,
-          read_timeout: 300
-        ).call(:create_invoice_v3, message: {
-                 invoicexml: @xml,
-                 source: Cetustek.config.site_id + Cetustek.config.password,
-                 rentid: Cetustek.config.username,
-                 hastax: @hastax
-               })
-      end
-    end
-  end
-end