buezli-api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '094aa7cb35ecc313611cd66a86c777431461d8a8c8fdc9e6508f0a47d54bf5f5'
+  data.tar.gz: e0750a2351cf57f9fe1911373c41fc4a04946da03ef24fbd0dc76225af289122
+SHA512:
+  metadata.gz: 50b99f0e3d1aa8d1a9d5525f9aacbcb763347da6ad95835ea523794dfcb6020c22d72dd1bf812fb995142c4fa80342f51d5f5cf4483866cd2d2a3b2aab92bb91
+  data.tar.gz: 97e5011a61ac35e4867fccbbf9e022435ad2636b31bd7c3888090942c36bd198a996e2a92eba9050dfe560a1531e519b5b5d84a136d509bc296090fd1645edec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codegestalt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,107 @@
+# buezli-api
+
+The official schema-driven Ruby client for the read-only
+[Buezli API](https://buezli.app/api). Buezli is straightforward invoicing,
+time tracking, and project management for small service teams. Learn more at
+[buezli.app](https://buezli.app).
+
+The gem builds its methods from a bundled, date-versioned API schema. It
+supports records, expansions, delta polling, pagination, PDFs, and receipts.
+
+## Install
+
+```ruby
+gem "buezli-api"
+```
+
+`buezli-api` requires Ruby 3.2 or newer.
+
+## Quick start
+
+```ruby
+require "buezli/api"
+
+client = Buezli::Api::Client.new(
+  access_token: ENV.fetch("BUEZLI_API_TOKEN")
+)
+
+invoices = client.retrieve_invoices(limit: 50)
+invoice = client.retrieve_invoice(123, expand: ["client"])
+
+invoice.id
+invoice.issue_date       # Date
+invoice.updated_at       # Time
+invoice.total            # { "cents" => 10810, "currency" => "CHF" }
+invoice.client.name
+invoice.line_items.first.description
+```
+
+The default endpoint is `https://api.buezli.app`, and the newest bundled
+schema is selected automatically. Pin an API version when needed:
+
+```ruby
+client = Buezli::Api::Client.new(
+  access_token: ENV.fetch("BUEZLI_API_TOKEN"),
+  version: "2026-07-14"
+)
+```
+
+Schema-declared dates and timestamps become `Date` and `Time`. Decimal values
+remain strings and money remains a `cents`/`currency` hash, avoiding precision
+loss. Unknown record methods raise `NoMethodError`; declared but absent fields
+return `nil`.
+
+## Pagination and deltas
+
+Collections are enumerable and retain the original query when paging:
+
+```ruby
+invoices = client.retrieve_invoices(
+  updated_since: Time.utc(2026, 7, 14, 10),
+  expand: ["client"],
+  page: 1,
+  limit: 100
+)
+
+invoices.each do |invoice|
+  invoice.deleted? ? remove_local(invoice.id) : replace_local(invoice.to_h)
+end
+
+invoices.pagination
+next_page = invoices.next_page
+previous_page = next_page&.previous_page
+```
+
+## Downloads
+
+```ruby
+pdf = client.retrieve_invoice_pdf(123)
+receipt = client.retrieve_expense_receipt(456)
+
+pdf.body
+pdf.filename
+pdf.content_type
+pdf.headers
+```
+
+Save a download when needed:
+
+```ruby
+File.binwrite(pdf.filename, pdf.body)
+```
+
+## Schema and errors
+
+Inspect the selected API schema with `client.schema`, or fetch the schema
+currently served by Buezli with `client.retrieve_schema`.
+
+Failed requests raise `Buezli::Api::Client::Error`, exposing `status`, `code`,
+`message`, `details`, `response_body`, and `headers`. Access tokens are never
+included in errors or inspection output.
+
+See the [API documentation](https://buezli.app/api) for available resources,
+fields, expansions, and authentication.
+
+## License
+
+[MIT](LICENSE)

data/lib/buezli/api/client/download.rb

@@ -0,0 +1,16 @@
+module Buezli
+  module Api
+    class Client
+      class Download
+        attr_reader :body, :filename, :content_type, :headers
+
+        def initialize(body:, filename:, content_type:, headers:)
+          @body = body
+          @filename = filename
+          @content_type = content_type
+          @headers = headers
+        end
+      end
+    end
+  end
+end

data/lib/buezli/api/client/error.rb

@@ -0,0 +1,36 @@
+module Buezli
+  module Api
+    class Client
+      class Error < StandardError
+        attr_reader :status, :code, :details, :response_body, :headers
+
+        def initialize(response)
+          if response.is_a?(String)
+            @details = {}
+            @headers = {}.with_indifferent_access
+            return super(response)
+          end
+
+          @status = response.code.to_i
+          @response_body = response.body.to_s
+          @headers = response.each_header.to_h.with_indifferent_access
+          parsed = parse_json(response_body)
+          @code = parsed&.dig("error", "code")
+          @details = parsed&.dig("error", "details") || {}
+          message = parsed&.dig("error", "message") || response_body.presence ||
+            "#{response.code} #{response.message}"
+
+          super(message)
+        end
+
+        private
+
+        def parse_json(body)
+          JSON.parse(body)
+        rescue JSON::ParserError, TypeError
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/buezli/api/client/list.rb

@@ -0,0 +1,60 @@
+module Buezli
+  module Api
+    class Client
+      class List
+        include Enumerable
+
+        attr_reader :data, :meta
+
+        def initialize(data:, meta:, client:, request_context:)
+          @data = data
+          @meta = (meta || {}).with_indifferent_access
+          @client = client
+          @request_context = request_context
+        end
+
+        def each(&block)
+          data.each(&block)
+        end
+
+        def empty?
+          data.empty?
+        end
+
+        def size
+          data.size
+        end
+
+        alias length size
+
+        def [](index)
+          data[index]
+        end
+
+        def pagination
+          meta.fetch(:pagination, {})
+        end
+
+        def next_page
+          request_page(pagination[:next])
+        end
+
+        def previous_page
+          request_page(pagination[:prev])
+        end
+
+        private
+
+        def request_page(page)
+          return if page.nil?
+
+          current_page = pagination[:page] || @request_context[:params][:page]
+          raise Error, "Infinite pagination loop detected" if current_page.to_s == page.to_s
+
+          params = @request_context[:params].merge(page:)
+          @client.send(:perform_request, **@request_context.merge(params:))
+        end
+      end
+    end
+  end
+end

data/lib/buezli/api/client/record.rb

@@ -0,0 +1,78 @@
+module Buezli
+  module Api
+    class Client
+      class Record
+        attr_reader :raw_attributes, :model_name, :client, :schema
+
+        def initialize(attributes:, model_name:, client:, schema:)
+          @raw_attributes = (attributes || {}).with_indifferent_access
+          @model_name = model_name
+          @client = client
+          @schema = schema
+        end
+
+        def id
+          raw_attributes[:id]
+        end
+
+        def deleted?
+          raw_attributes[:_deleted] == true
+        end
+
+        def [](key)
+          raw_attributes[key]
+        end
+
+        def to_h
+          raw_attributes.to_h
+        end
+
+        def method_missing(method, *args, &block)
+          return super unless args.empty? && block.nil? && schema.declared_field?(model_name, method)
+
+          read_value(method.to_s)
+        end
+
+        def respond_to_missing?(method, include_private = false)
+          schema.declared_field?(model_name, method) || super
+        end
+
+        private
+
+        def read_value(name)
+          value = raw_attributes[name]
+          return build_association(name, value) if schema.association?(model_name, name)
+
+          case schema.attribute_type(model_name, name).to_s
+          when "datetime" then parse_time(value)
+          when "date" then parse_date(value)
+          else value
+          end
+        end
+
+        def build_association(name, value)
+          return if value.nil?
+
+          target_model = schema.association_class_name(model_name, name)
+          if schema.association_collection?(model_name, name)
+            Array(value).map { |attributes| client.build_record(target_model, attributes) }
+          else
+            client.build_record(target_model, value)
+          end
+        end
+
+        def parse_time(value)
+          Time.parse(value.to_s) if value.present?
+        rescue ArgumentError
+          value
+        end
+
+        def parse_date(value)
+          Date.parse(value.to_s) if value.present?
+        rescue Date::Error
+          value
+        end
+      end
+    end
+  end
+end

data/lib/buezli/api/client.rb

@@ -0,0 +1,168 @@
+module Buezli
+  module Api
+    class Client
+      DEFAULT_ENDPOINT = "https://api.buezli.app"
+
+      attr_reader :access_token, :endpoint, :version, :schema, :host
+
+      def initialize(access_token:, endpoint: DEFAULT_ENDPOINT, version: nil, schema: nil, host: nil)
+        @access_token = access_token
+        @endpoint = endpoint.chomp("/")
+        @schema = schema || load_schema(version)
+        @version = version || @schema.version
+        @host = host
+        raise ArgumentError, "Schema version does not match requested version" if @schema.version != @version
+
+        define_methods_from_schema
+      end
+
+      def build_record(model_name, attributes)
+        Record.new(attributes:, model_name:, client: self, schema:)
+      end
+
+      def inspect
+        "#<#{self.class.name} endpoint=#{endpoint.inspect} version=#{version.inspect} host=#{host.inspect}>"
+      end
+
+      private
+
+      def load_schema(version)
+        requested_version = version || latest_schema_version
+        Schema.load(schema_directory.join("#{requested_version}.json"))
+      end
+
+      def schema_directory
+        Pathname(__dir__).join("../../../schemas").expand_path
+      end
+
+      def latest_schema_version
+        schema_directory.glob("*.json").map { |path| path.basename(".json").to_s }.max ||
+          raise(ArgumentError, "No bundled API schemas found")
+      end
+
+      def define_methods_from_schema
+        schema.endpoints.each do |resource, endpoints|
+          endpoints.each do |endpoint_config|
+            define_singleton_method(method_name_for(resource, endpoint_config.fetch("action"))) do |*path_values, **params|
+              perform_endpoint(resource, endpoint_config, path_values, params)
+            end
+          end
+        end
+      end
+
+      def method_name_for(resource, action)
+        return "retrieve_#{resource}" if action == "index"
+        return "retrieve_#{resource.singularize}" if action == "show"
+
+        "retrieve_#{resource.singularize}_#{action}"
+      end
+
+      def perform_endpoint(resource, endpoint_config, path_values, params)
+        path = endpoint_config.fetch("path").dup
+        query = params.with_indifferent_access
+
+        path.scan(/:(\w+)/).flatten.each do |key|
+          value = query.delete(key) || path_values.shift
+          raise ArgumentError, "Missing required path parameter: #{key}" if value.nil?
+
+          path.sub!(":#{key}", value.to_s)
+        end
+        raise ArgumentError, "Too many path parameters" if path_values.any?
+
+        perform_request(
+          resource:,
+          action: endpoint_config.fetch("action"),
+          verb: endpoint_config.fetch("verb"),
+          path:,
+          params: query
+        )
+      end
+
+      def perform_request(resource:, action:, verb:, path:, params:)
+        raise ArgumentError, "Unsupported API verb: #{verb}" unless verb == "GET"
+
+        uri = URI("#{endpoint}#{path}")
+        uri.query = encode_query(params) if params.present?
+        request = Net::HTTP::Get.new(uri)
+        request["Authorization"] = "Bearer #{access_token}"
+        request["Accept"] = "application/json, */*"
+        request["Host"] = host if host
+
+        response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
+          http.request(request)
+        end
+        raise Error.new(response) unless response.is_a?(Net::HTTPSuccess)
+
+        parse_response(
+          response,
+          resource:,
+          request_context: { resource:, action:, verb:, path:, params: params.dup }
+        )
+      end
+
+      def parse_response(response, resource:, request_context:)
+        content_type = response["Content-Type"].to_s.split(";").first
+        return build_download(response) unless content_type == "application/json" || content_type.end_with?("+json")
+
+        payload = JSON.parse(response.body)
+        return Schema.new(payload) if resource == "schema"
+
+        data = payload.key?("data") ? payload["data"] : payload
+        model_name = schema.model_name_for_resource(resource)
+        return payload unless model_name
+
+        if data.is_a?(Array)
+          List.new(
+            data: data.map { |attributes| build_record(model_name, attributes) },
+            meta: payload["meta"],
+            client: self,
+            request_context:
+          )
+        elsif data.is_a?(Hash)
+          build_record(model_name, data)
+        else
+          data
+        end
+      end
+
+      def build_download(response)
+        headers = response.each_header.to_h.with_indifferent_access
+        Download.new(
+          body: response.body,
+          filename: response_filename(response["Content-Disposition"]),
+          content_type: response["Content-Type"].to_s.split(";").first,
+          headers:
+        )
+      end
+
+      def response_filename(disposition)
+        encoded = disposition.to_s[/filename\*=(?:UTF-8'')?([^;]+)/i, 1]
+        return URI.decode_www_form_component(encoded.delete_prefix('"').delete_suffix('"')) if encoded
+
+        disposition.to_s[/filename="([^"]+)"/i, 1] ||
+          disposition.to_s[/filename=([^;]+)/i, 1]&.strip
+      end
+
+      def encode_query(params, prefix = nil)
+        params.flat_map do |key, value|
+          full_key = prefix ? "#{prefix}[#{key}]" : key.to_s
+          if value.is_a?(Hash)
+            encode_query(value, full_key)
+          elsif value.is_a?(Array)
+            value.map { |item| encoded_pair("#{full_key}[]", item) }
+          else
+            encoded_pair(full_key, value)
+          end
+        end.join("&")
+      end
+
+      def encoded_pair(key, value)
+        encoded_value = case value
+        when Time, Date then value.iso8601
+        else value.to_s
+        end
+        "#{URI.encode_www_form_component(key)}=#{URI.encode_www_form_component(encoded_value)}"
+      end
+    end
+  end
+end

data/lib/buezli/api/schema.rb

@@ -0,0 +1,57 @@
+module Buezli
+  module Api
+    class Schema
+      attr_reader :version, :config
+
+      def self.load(path)
+        new(JSON.parse(Pathname(path).read))
+      end
+
+      def initialize(config)
+        @config = config.with_indifferent_access
+        @version = @config.fetch(:version)
+      end
+
+      def endpoints
+        config.fetch(:endpoints, {})
+      end
+
+      def for(model_name)
+        config.dig(:models, model_name.to_s)
+      end
+
+      def model_name_for_resource(resource_name)
+        config.fetch(:models).find do |_model_name, model|
+          model[:resource_name] == resource_name.to_s
+        end&.first
+      end
+
+      def declared_field?(model_name, field_name)
+        model = self.for(model_name)
+        model&.fetch(:attributes, {})&.key?(field_name.to_s) ||
+          model&.fetch(:associations, {})&.key?(field_name.to_s)
+      end
+
+      def attribute_type(model_name, attribute)
+        self.for(model_name)&.dig(:attributes, attribute.to_s)
+      end
+
+      def association?(model_name, association)
+        self.for(model_name)&.fetch(:associations, {})&.key?(association.to_s)
+      end
+
+      def association_metadata(model_name, association)
+        self.for(model_name)&.dig(:associations, association.to_s) || {}.with_indifferent_access
+      end
+
+      def association_class_name(model_name, association)
+        association_metadata(model_name, association)[:class_name] ||
+          association.to_s.singularize.classify
+      end
+
+      def association_collection?(model_name, association)
+        association_metadata(model_name, association)[:type].to_s.include?("many")
+      end
+    end
+  end
+end

data/lib/buezli/api/version.rb

@@ -0,0 +1,5 @@
+module Buezli
+  module Api
+    VERSION = "0.1.0"
+  end
+end

data/lib/buezli/api.rb

@@ -0,0 +1,18 @@
+require "active_support"
+require "active_support/core_ext/hash/indifferent_access"
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/string/inflections"
+require "date"
+require "json"
+require "net/http"
+require "pathname"
+require "time"
+require "uri"
+
+require_relative "api/version"
+require_relative "api/schema"
+require_relative "api/client/download"
+require_relative "api/client/error"
+require_relative "api/client/list"
+require_relative "api/client/record"
+require_relative "api/client"

data/schemas/2026-07-14.json

@@ -0,0 +1,563 @@
+{
+  "version": "2026-07-14",
+  "models": {
+    "Client": {
+      "resource_name": "clients",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "name": "string",
+        "address": "string",
+        "currency": "string",
+        "locale": "string",
+        "archived_at": "datetime"
+      },
+      "associations": {}
+    },
+    "Contact": {
+      "resource_name": "contacts",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "first_name": "string",
+        "last_name": "string",
+        "title": "string",
+        "email": "string",
+        "phone_office": "string",
+        "phone_mobile": "string",
+        "archived_at": "datetime"
+      },
+      "associations": {
+        "client": {
+          "type": "belongs_to",
+          "class_name": "Client",
+          "inline": false
+        }
+      }
+    },
+    "Estimate": {
+      "resource_name": "estimates",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "number": "string",
+        "status": "string",
+        "issue_date": "date",
+        "subject": "string",
+        "notes": "string",
+        "currency": "string",
+        "locale": "string",
+        "recipient_name": "string",
+        "recipient_address": "string",
+        "sender_name": "string",
+        "sender_address": "string",
+        "sender_email": "string",
+        "sender_phone": "string",
+        "sender_vat_number": "string",
+        "discount_rate": "decimal",
+        "tax_rate": "decimal",
+        "subtotal": "money",
+        "discount": "money",
+        "tax": "money",
+        "tax_breakdown": "array",
+        "total": "money",
+        "sent_at": "datetime",
+        "accepted_at": "datetime",
+        "declined_at": "datetime",
+        "archived_at": "datetime",
+        "pdf": "download"
+      },
+      "associations": {
+        "client": {
+          "type": "belongs_to",
+          "class_name": "Client",
+          "inline": false
+        },
+        "line_items": {
+          "type": "has_many",
+          "class_name": "EstimateLineItem",
+          "inline": true
+        }
+      }
+    },
+    "EstimateLineItem": {
+      "resource_name": "estimate_line_items",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "description": "string",
+        "quantity": "decimal",
+        "unit_price": "money",
+        "amount": "money",
+        "tax_rate_override": "decimal",
+        "effective_tax_rate": "decimal"
+      },
+      "associations": {}
+    },
+    "Expense": {
+      "resource_name": "expenses",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "project_id": "integer",
+        "expense_category_id": "integer",
+        "invoice_id": "integer",
+        "spent_on": "date",
+        "calculation_type": "string",
+        "quantity": "decimal",
+        "unit": "string",
+        "unit_rate": "money",
+        "total": "money",
+        "currency": "string",
+        "notes": "string",
+        "billable": "boolean",
+        "billed": "boolean",
+        "reimbursed": "boolean",
+        "archived_at": "datetime",
+        "receipt": "download"
+      },
+      "associations": {
+        "client": {
+          "type": "has_one",
+          "class_name": "Client",
+          "inline": false
+        },
+        "project": {
+          "type": "belongs_to",
+          "class_name": "Project",
+          "inline": false
+        },
+        "expense_category": {
+          "type": "belongs_to",
+          "class_name": "ExpenseCategory",
+          "inline": false
+        },
+        "invoice": {
+          "type": "belongs_to",
+          "class_name": "Invoice",
+          "inline": false
+        }
+      }
+    },
+    "ExpenseCategory": {
+      "resource_name": "expense_categories",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "name": "string",
+        "archived_at": "datetime"
+      },
+      "associations": {}
+    },
+    "Invoice": {
+      "resource_name": "invoices",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "source_estimate_id": "integer",
+        "number": "string",
+        "status": "string",
+        "issue_date": "date",
+        "due_date": "date",
+        "subject": "string",
+        "notes": "string",
+        "currency": "string",
+        "locale": "string",
+        "recipient_name": "string",
+        "recipient_address": "string",
+        "sender_name": "string",
+        "sender_address": "string",
+        "sender_email": "string",
+        "sender_phone": "string",
+        "sender_vat_number": "string",
+        "sender_iban": "string",
+        "payment_reference": "string",
+        "tax_rate": "decimal",
+        "discount_rate": "decimal",
+        "subtotal": "money",
+        "discount": "money",
+        "tax": "money",
+        "tax_breakdown": "array",
+        "total": "money",
+        "paid": "money",
+        "due": "money",
+        "sent_at": "datetime",
+        "paid_at": "datetime",
+        "voided_at": "datetime",
+        "void_reason": "string",
+        "archived_at": "datetime",
+        "recurring_invoice_template_id": "integer",
+        "recurring_occurrence_on": "date",
+        "pdf": "download"
+      },
+      "associations": {
+        "client": {
+          "type": "belongs_to",
+          "class_name": "Client",
+          "inline": false
+        },
+        "source_estimate": {
+          "type": "belongs_to",
+          "class_name": "Estimate",
+          "inline": false
+        },
+        "recurring_invoice_template": {
+          "type": "belongs_to",
+          "class_name": "RecurringInvoiceTemplate",
+          "inline": false
+        },
+        "line_items": {
+          "type": "has_many",
+          "class_name": "InvoiceLineItem",
+          "inline": true
+        },
+        "payments": {
+          "type": "has_many",
+          "class_name": "Payment",
+          "inline": true
+        }
+      }
+    },
+    "InvoiceLineItem": {
+      "resource_name": "invoice_line_items",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "description": "string",
+        "quantity": "decimal",
+        "unit_price": "money",
+        "amount": "money",
+        "tax_rate_override": "decimal",
+        "effective_tax_rate": "decimal",
+        "project_id": "integer",
+        "source_kind": "string"
+      },
+      "associations": {
+        "project": {
+          "type": "belongs_to",
+          "class_name": "Project",
+          "inline": false
+        }
+      }
+    },
+    "Payment": {
+      "resource_name": "payments",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "invoice_id": "integer",
+        "reversal_of_id": "integer",
+        "amount": "money",
+        "paid_on": "date",
+        "notes": "string"
+      },
+      "associations": {
+        "invoice": {
+          "type": "belongs_to",
+          "class_name": "Invoice",
+          "inline": false
+        },
+        "reversal_of": {
+          "type": "belongs_to",
+          "class_name": "Payment",
+          "inline": false
+        }
+      }
+    },
+    "Project": {
+      "resource_name": "projects",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "name": "string",
+        "notes": "string",
+        "currency": "string",
+        "project_type": "string",
+        "starts_on": "date",
+        "ends_on": "date",
+        "archived_at": "datetime"
+      },
+      "associations": {
+        "client": {
+          "type": "belongs_to",
+          "class_name": "Client",
+          "inline": false
+        }
+      }
+    },
+    "RecurringInvoiceLineItem": {
+      "resource_name": "recurring_invoice_line_items",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "description": "string",
+        "quantity": "decimal",
+        "unit_price": "money",
+        "amount": "money",
+        "tax_rate_override": "decimal",
+        "effective_tax_rate": "decimal"
+      },
+      "associations": {}
+    },
+    "RecurringInvoiceTemplate": {
+      "resource_name": "recurring_invoice_templates",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "name": "string",
+        "currency": "string",
+        "locale": "string",
+        "subject": "string",
+        "notes": "string",
+        "discount_rate": "decimal",
+        "tax_rate": "decimal",
+        "interval_unit": "string",
+        "interval_count": "integer",
+        "starts_on": "date",
+        "next_issue_on": "date",
+        "ends_on": "date",
+        "due_days": "integer",
+        "paused_at": "datetime",
+        "archived_at": "datetime"
+      },
+      "associations": {
+        "client": {
+          "type": "belongs_to",
+          "class_name": "Client",
+          "inline": false
+        },
+        "line_items": {
+          "type": "has_many",
+          "class_name": "RecurringInvoiceLineItem",
+          "inline": true
+        }
+      }
+    },
+    "Task": {
+      "resource_name": "tasks",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "name": "string",
+        "archived_at": "datetime"
+      },
+      "associations": {}
+    },
+    "TimeEntry": {
+      "resource_name": "time_entries",
+      "attributes": {
+        "id": "integer",
+        "created_at": "datetime",
+        "updated_at": "datetime",
+        "client_id": "integer",
+        "project_id": "integer",
+        "task_id": "integer",
+        "invoice_id": "integer",
+        "spent_on": "date",
+        "duration_seconds": "integer",
+        "notes": "string",
+        "billable": "boolean",
+        "billed": "boolean",
+        "billable_rate": "money",
+        "cost_rate": "money"
+      },
+      "associations": {
+        "client": {
+          "type": "has_one",
+          "class_name": "Client",
+          "inline": false
+        },
+        "project": {
+          "type": "belongs_to",
+          "class_name": "Project",
+          "inline": false
+        },
+        "task": {
+          "type": "belongs_to",
+          "class_name": "Task",
+          "inline": false
+        },
+        "invoice": {
+          "type": "belongs_to",
+          "class_name": "Invoice",
+          "inline": false
+        }
+      }
+    }
+  },
+  "endpoints": {
+    "clients": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/clients"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/clients/:id"
+      }
+    ],
+    "contacts": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/contacts"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/contacts/:id"
+      }
+    ],
+    "estimates": [
+      {
+        "action": "pdf",
+        "verb": "GET",
+        "path": "/2026-07-14/estimates/:id/pdf"
+      },
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/estimates"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/estimates/:id"
+      }
+    ],
+    "expense_categories": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/expense_categories"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/expense_categories/:id"
+      }
+    ],
+    "expenses": [
+      {
+        "action": "receipt",
+        "verb": "GET",
+        "path": "/2026-07-14/expenses/:id/receipt"
+      },
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/expenses"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/expenses/:id"
+      }
+    ],
+    "invoices": [
+      {
+        "action": "pdf",
+        "verb": "GET",
+        "path": "/2026-07-14/invoices/:id/pdf"
+      },
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/invoices"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/invoices/:id"
+      }
+    ],
+    "payments": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/payments"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/payments/:id"
+      }
+    ],
+    "projects": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/projects"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/projects/:id"
+      }
+    ],
+    "recurring_invoice_templates": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/recurring_invoice_templates"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/recurring_invoice_templates/:id"
+      }
+    ],
+    "schema": [
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/schema"
+      }
+    ],
+    "tasks": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/tasks"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/tasks/:id"
+      }
+    ],
+    "time_entries": [
+      {
+        "action": "index",
+        "verb": "GET",
+        "path": "/2026-07-14/time_entries"
+      },
+      {
+        "action": "show",
+        "verb": "GET",
+        "path": "/2026-07-14/time_entries/:id"
+      }
+    ]
+  }
+}

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: buezli-api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Codegestalt
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: A read-only Ruby client generated from Buezli's versioned API schema.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/buezli/api.rb
+- lib/buezli/api/client.rb
+- lib/buezli/api/client/download.rb
+- lib/buezli/api/client/error.rb
+- lib/buezli/api/client/list.rb
+- lib/buezli/api/client/record.rb
+- lib/buezli/api/schema.rb
+- lib/buezli/api/version.rb
+- schemas/2026-07-14.json
+homepage: https://buezli.app/api
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/codegestalt/buezli-api
+  documentation_uri: https://buezli.app/api
+  bug_tracker_uri: https://github.com/codegestalt/buezli-api/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.17
+specification_version: 4
+summary: Schema-driven Ruby client for the Buezli API
+test_files: []