lunchmoney 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66fd4ba45ca3d30c32dea0c70f504714811980af2bf373b2412232da5e9d19da
-  data.tar.gz: 1a2becc26568423ff1b6fa70108400efa5cc366cd65e1ced013eb34084c65dee
+  metadata.gz: a66d419d272f25d940cb0ad8a5f5962b85aa3cb74deee1486e3f7ed9caf9f8ac
+  data.tar.gz: bd656eac78fd93d9979e3a86ab639f7f880f2e74fd2fb3a0e64889a7df8e6086
 SHA512:
-  metadata.gz: 5a3a997026a7ab6c541ef0cb4c8b1fb6fcf992ad91d2ae6cc1ba408007f88a7a001cb9703d7c15038f4ce87fa36d78a9580b4cd5010e3a36a747c4845ce5e96b
-  data.tar.gz: 3a4c3ec3283535b9829afd17427f89e7f88538826b4c30f02075e13807e925fac9070d90f9061ea7ec6cc8f135099dc43623929f83a322a48c987644083931d7
+  metadata.gz: d756dda147ed0c8cb492c2be68d40772a0d182513fbef4cdc326c7a5644b16f23e8a7ee5bb0228e030d6f16b9c8b396b1fd3cedc9bdfd9d389bdd9bddef37721
+  data.tar.gz: c9899675f397835b813d864db59db9e311cb1f99422349c901f8676a409bd22ce8be0a42e8bdc8c6ad77f341c23f7b67436966c4e10b09cc95eb9d8838dd3432

data/.github/workflows/check_pipeline.yml

@@ -0,0 +1,24 @@
+name: Check Pipeline
+
+on:
+  push:
+    branches-ignore:
+        - main
+    paths-ignore:
+        - ".gitignore"
+        - "README.md"
+    tags-ignore:
+        - v*
+
+jobs:
+  update-rbis:
+    name: RBI Updater
+    uses: mmenanno/lunchmoney/.github/workflows/dependabot-rbi-updater.yml@main
+    secrets: inherit
+
+  ci:
+    needs: update-rbis
+    if: always() && contains(needs.*.result, 'skipped')
+    name: "CI"
+    uses: mmenanno/lunchmoney/.github/workflows/ci.yml@main
+    secrets: inherit

data/.github/workflows/ci.yml

@@ -1,11 +1,8 @@
 name: CI
 
 on:
-  push:
-    paths-ignore:
-      - ".gitignore"
-      - "README.md"
   workflow_dispatch:
+  workflow_call:
   schedule:
     # Every day at 9pm
     - cron: '0 21 * * *'

data/.github/workflows/dependabot-rbi-updater.yml

@@ -1,9 +1,6 @@
 name: Dependabot RBI Updater
 on:
-  pull_request:
-    paths:
-      - 'Gemfile.lock'
-      - 'Gemfile'
+  workflow_call:
 
 jobs:
   update-rbis:
@@ -32,12 +29,12 @@ jobs:
           git config --local user.name "Dependabot RBI Updater"
           git config --local user.email action@github.com
           git add sorbet/*
-          git commit -m "[dependabot skip] Update RBIs"
+          git diff-index --cached --quiet HEAD || git commit -m "[dependabot skip] Update RBIs"
       -
         name: Push changes
         uses: ad-m/github-push-action@v0.8.0
         with:
           github_token: ${{ secrets.LUNCHMONEY_PAT_TOKEN }}
-          branch: ${{ github.head_ref }}
+          branch: ${{ github.ref }}
 
 

data/.github/workflows/publish_gem.yml

@@ -1,31 +1,29 @@
 name: Publish Gem
 
 on:
-  push:
-    tags:
-      - v*
+  workflow_call:
+  workflow_dispatch:
+
 jobs:
   build:
     name: Build & Release Gem
     runs-on: ubuntu-latest
+    environment: rubygems
+
+    permissions:
+      contents: write
+      id-token: write
 
     steps:
+      # Set up
       - uses: actions/checkout@v4
-
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.3.0
           bundler-cache: true
-      - name: Release Gem
-        if: contains(github.ref, 'refs/tags/v')
-        run: |
-          mkdir -p $HOME/.gem
-          touch $HOME/.gem/credentials
-          chmod 0600 $HOME/.gem/credentials
-          printf -- "---\n:rubygems_api_key: ${RUBYGEMS_API_KEY}\n" > $HOME/.gem/credentials
-          gem build *.gemspec
-          gem push *.gem
-        env:
-          RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+          ruby-version: ruby
+
+      # Release
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1
 

data/.github/workflows/release_pipeline.yml

@@ -0,0 +1,36 @@
+name: Release Pipeline
+
+on:
+    workflow_dispatch:
+    push:
+        tags:
+            - v*
+
+jobs:
+    ci:
+        name: "CI"
+        uses: mmenanno/lunchmoney/.github/workflows/ci.yml@main
+        secrets: inherit
+    release:
+        needs: ci
+        if: always() && !contains(needs.*.result, 'failed') && !contains(needs.*.result, 'cancelled')
+        name: Build & Release Gem
+        runs-on: ubuntu-latest
+        environment: rubygems
+
+        permissions:
+            contents: write
+            id-token: write
+
+        steps:
+            # Set up
+            - uses: actions/checkout@v4
+            - name: Set up Ruby
+              uses: ruby/setup-ruby@v1
+              with:
+                bundler-cache: true
+                ruby-version: ruby
+
+            # Release
+            - name: Publish to RubyGems
+              uses: rubygems/release-gem@v1

data/.rubocop.yml

@@ -22,16 +22,19 @@ Sorbet/FalseSigil:
 Sorbet/StrictSigil:
   Enabled: true
   Exclude:
-    - "test/*"
     - ".toys/**/*"
 
 Sorbet/ForbidTStruct:
+# Context for why this is preferable https://github.com/Shopify/rubocop-sorbet/pull/178#issuecomment-1739924189
   Enabled: true
-  # Context for why this is preferable https://github.com/Shopify/rubocop-sorbet/pull/178#issuecomment-1739924189
+
 
 Sorbet/RedundantExtendTSig:
   Enabled: true
 
+Sorbet/ForbidTUnsafe:
+  Enabled: true
+
 Minitest:
   Enabled: true
 

data/Gemfile

@@ -7,7 +7,7 @@ gemspec
 
 # Specify development dependencies here
 gem "toys"
-gem "minitest", "~> 5.21", require: false
+gem "minitest", "~> 5.22", require: false
 gem "mocha", "~> 2.1.0", require: false
 gem "webmock", require: false
 gem "vcr", require: false

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lunchmoney (1.0.0)
+    lunchmoney (1.1.1)
       activesupport (>= 6.1)
       faraday (>= 1.0.0)
       sorbet-runtime (>= 0.5)
@@ -31,7 +31,8 @@ GEM
     coderay (1.1.3)
     concurrent-ruby (1.2.3)
     connection_pool (2.4.1)
-    crack (0.4.5)
+    crack (1.0.0)
+      bigdecimal
       rexml
     dotenv (2.8.1)
     drb (2.2.0)
@@ -47,7 +48,7 @@ GEM
     json (2.7.1)
     language_server-protocol (3.17.0.3)
     method_source (1.0.0)
-    minitest (5.21.2)
+    minitest (5.22.2)
     mocha (2.1.0)
       ruby2_keywords (>= 0.0.5)
     mutex_m (0.2.0)
@@ -75,7 +76,7 @@ GEM
       sorbet-runtime (>= 0.5.9204)
     regexp_parser (2.9.0)
     rexml (3.2.6)
-    rubocop (1.60.1)
+    rubocop (1.60.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
@@ -98,18 +99,18 @@ GEM
       rubocop-ast (>= 1.30.0, < 2.0)
     rubocop-shopify (2.14.0)
       rubocop (~> 1.51)
-    rubocop-sorbet (0.7.6)
+    rubocop-sorbet (0.7.7)
       rubocop (>= 0.90.0)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
-    sorbet (0.5.11219)
-      sorbet-static (= 0.5.11219)
-    sorbet-runtime (0.5.11219)
-    sorbet-static (0.5.11219-universal-darwin)
-    sorbet-static (0.5.11219-x86_64-linux)
-    sorbet-static-and-runtime (0.5.11219)
-      sorbet (= 0.5.11219)
-      sorbet-runtime (= 0.5.11219)
+    sorbet (0.5.11247)
+      sorbet-static (= 0.5.11247)
+    sorbet-runtime (0.5.11247)
+    sorbet-static (0.5.11247-universal-darwin)
+    sorbet-static (0.5.11247-x86_64-linux)
+    sorbet-static-and-runtime (0.5.11247)
+      sorbet (= 0.5.11247)
+      sorbet-runtime (= 0.5.11247)
     spoom (1.2.4)
       erubi (>= 1.10.0)
       sorbet-static-and-runtime (>= 0.5.10187)
@@ -127,15 +128,15 @@ GEM
       thor (>= 1.2.0)
       yard-sorbet
     thor (1.3.0)
-    toys (0.15.4)
-      toys-core (= 0.15.4)
-    toys-core (0.15.4)
+    toys (0.15.5)
+      toys-core (= 0.15.5)
+    toys-core (0.15.5)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)
     uri (0.13.0)
     vcr (6.2.0)
-    webmock (3.19.1)
+    webmock (3.20.0)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
@@ -154,7 +155,7 @@ DEPENDENCIES
   appraisal
   dotenv
   lunchmoney!
-  minitest (~> 5.21)
+  minitest (~> 5.22)
   mocha (~> 2.1.0)
   pry-sorbet (~> 0.2)
   rubocop-minitest

data/LICENSE

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) 2021 halorrr
+Copyright (c) 2021 mmenanno
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -6,7 +6,7 @@
 
 This gem is a API client library of the [LunchMoney API](https://lunchmoney.dev/) for the wonderful [LunchMoney](http://lunchmoney.app/) web app for personal finance & budgeting.
 
-Documentation is still a work in process, but you can find the yard docs for this gem [here](https://halorrr.github.io/lunchmoney/) as well as some write ups of the basics below.
+Documentation is still a work in process, but you can find the yard docs for this gem [here](https://halorrr.github.io/lunchmoney/) as well as some write ups of the basics below. An example of every call is listed on the [Api class in the yard docs](https://halorrr.github.io/lunchmoney/LunchMoney/Api.html).
 
 ## Usage
 

data/Rakefile

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'toys' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("toys", "toys")

data/lib/lunchmoney/api.rb

@@ -4,22 +4,25 @@
 require_relative "exceptions"
 require_relative "configuration"
 
-require_relative "api_call"
-require_relative "data_object"
-require_relative "user/user_calls"
-require_relative "categories/category_calls"
-require_relative "tags/tag_calls"
-require_relative "transactions/transaction_calls"
-require_relative "recurring_expenses/recurring_expense_calls"
-require_relative "budget/budget_calls"
-require_relative "assets/asset_calls"
-require_relative "plaid_accounts/plaid_account_calls"
-require_relative "crypto/crypto_calls"
+require_relative "calls/base"
+require_relative "objects/object"
+require_relative "calls/users"
+require_relative "calls/categories"
+require_relative "calls/tags"
+require_relative "calls/transactions"
+require_relative "calls/recurring_expenses"
+require_relative "calls/budgets"
+require_relative "calls/assets"
+require_relative "calls/plaid_accounts"
+require_relative "calls/crypto"
 
 module LunchMoney
-  # The main API class that a user should interface through the method of any individual call is delegated through here
-  # so that it is never necessary to go through things like `LunchMoney::UserCalls.new.user` instead you can directly
+  # The main API class that a user should interface through. The method of any individual call is delegated through here
+  # so that it is never necessary to go through things like `LunchMoney::Calls::Users.new.user` instead you can directly
   # call the endpoint with LunchMoney::Api.new.user and it will be delegated to the correct call.
+  # @example
+  #   api = LunchMoney::Api.new
+  #   api.categories # This will be delegated to LunchMoney::Calls::Categories#categories
   class Api
     sig { returns(T.nilable(String)) }
     attr_reader :api_key
@@ -31,10 +34,14 @@ module LunchMoney
 
     delegate :me, to: :user_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [user call types](https://lunchmoney.dev/#user) come through here.
+    # @example [Get User](https://lunchmoney.dev/#get-user)
+    #   api = LunchMoney::Api.new
+    #   api.me
+    sig { returns(LunchMoney::Calls::Base) }
     def user_calls
       with_valid_api_key do
-        @user_calls ||= T.let(LunchMoney::UserCalls.new(api_key:), T.nilable(LunchMoney::UserCalls))
+        @user_calls ||= T.let(LunchMoney::Calls::Users.new(api_key:), T.nilable(LunchMoney::Calls::Users))
       end
     end
 
@@ -48,19 +55,49 @@ module LunchMoney
       :force_delete_category,
       to: :category_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [category call types](https://lunchmoney.dev/#categories) come through here. Reference the docs for
+    # available parameters for each call
+    # @example [Get All Categories](https://lunchmoney.dev/#get-all-categories)
+    #   api = LunchMoney::Api.new
+    #   api.categories
+    # @example [Get Single Category](https://lunchmoney.dev/#get-single-category)
+    #   api = LunchMoney::Api.new
+    #   api.category(1234567)
+    # @example [Create Category](https://lunchmoney.dev/#create-category)
+    #   api = LunchMoney::Api.new
+    #   api.create_category(name: "New Category Name")
+    # @example [Create Category Group](https://lunchmoney.dev/#create-category-group)
+    #   api = LunchMoney::Api.new
+    #   api.create_category_group(name: "New Category Group Name")
+    # @example [Update Category](https://lunchmoney.dev/#update-category)
+    #   api = LunchMoney::Api.new
+    #   api.update_category(1234567, "Updated Category Name")
+    # @example [Add to Category Group](https://lunchmoney.dev/#add-to-category-group)
+    #   api = LunchMoney::Api.new
+    #   api.add_to_category_group(7654321, category_ids: [1234567], new_categories: ["Another Category"])
+    # @example [Delete Category](https://lunchmoney.dev/#delete-category)
+    #   api = LunchMoney::Api.new
+    #   api.delete_category(1234567)
+    # @example [Force Delete Category](https://lunchmoney.dev/#force-delete-category)
+    #   api = LunchMoney::Api.new
+    #   api.force_delete_category(1234567)
+    sig { returns(LunchMoney::Calls::Base) }
     def category_calls
       with_valid_api_key do
-        @category_calls ||= T.let(LunchMoney::CategoryCalls.new(api_key:), T.nilable(LunchMoney::CategoryCalls))
+        @category_calls ||= T.let(LunchMoney::Calls::Categories.new(api_key:), T.nilable(LunchMoney::Calls::Categories))
       end
     end
 
     delegate :tags, to: :tag_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [tags call types](https://lunchmoney.dev/#tags) come through here.
+    # @example [Get All Tags](https://lunchmoney.dev/#get-all-tags)
+    #   api = LunchMoney::Api.new
+    #   api.tags
+    sig { returns(LunchMoney::Calls::Base) }
     def tag_calls
       with_valid_api_key do
-        @tag_calls ||= T.let(LunchMoney::TagCalls.new(api_key:), T.nilable(LunchMoney::TagCalls))
+        @tag_calls ||= T.let(LunchMoney::Calls::Tags.new(api_key:), T.nilable(LunchMoney::Calls::Tags))
       end
     end
 
@@ -74,70 +111,158 @@ module LunchMoney
       :delete_transaction_group,
       to: :transaction_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [transaction call types](https://lunchmoney.dev/#transactions) come through here.
+    # @example [Get All Transactions](https://lunchmoney.dev/#get-all-transactions)
+    #   api = LunchMoney::Api.new
+    #   api.transactions
+    # @example [Get Single Transaction](https://lunchmoney.dev/#get-single-transaction)
+    #   api = LunchMoney::Api.new
+    #   api.transaction(123456789)
+    # @example [Insert Transactions](https://lunchmoney.dev/#insert-transactions)
+    #   api = LunchMoney::Api.new
+    #   transaction = LunchMoney::Objects::UpdateTransaction.new(
+    #     date: "2024-01-01",
+    #     amount: "10.99",
+    #     payee: "Example Payee",
+    #     currency: "cad",
+    #     status: "cleared"
+    #   )
+    #   api.insert_transactions([transaction])
+    # @example Regular [Update Transactions](https://lunchmoney.dev/#update-transactions)
+    #   api = LunchMoney::Api.new
+    #   transaction = LunchMoney::Objects::UpdateTransaction.new(
+    #     date: "2024-01-01",
+    #     amount: "10.99",
+    #     payee: "Example Payee",
+    #     currency: "cad",
+    #     status: "cleared"
+    #   )
+    #   api.update_transaction(123456789, transaction: transaction)
+    # @example Split [Update Transactions](https://lunchmoney.dev/#update-transactions)
+    #   api = LunchMoney::Api.new
+    #   split = [
+    #     LunchMoney::Objects::Split.new(amount: "10.00"),
+    #     LunchMoney::Objects::Split.new(amount: "47.54"),
+    #   ]
+    #   api.update_transaction(12345678, split: split)
+    # @example [Unsplit Transactions](https://lunchmoney.dev/#unsplit-transactions)
+    #   api = LunchMoney::Api.new
+    #   api.unsplit_transaction([123456789])
+    # @example [Get Transaction Group](https://lunchmoney.dev/#get-transaction-group)
+    #   api = LunchMoney::Api.new
+    #   api.transaction_group(987654321)
+    # @example [Create Transaction Group](https://lunchmoney.dev/#create-transaction-group)
+    #   api = LunchMoney::Api.new
+    #   api.create_transaction_group(date: "2024-01-01", payee: "Group", transactions: [123456789, 987654321])
+    # @example [Delete Transaction Group](https://lunchmoney.dev/#delete-transaction-group)
+    #   api = LunchMoney::Api.new
+    #   api.delete_transaction_group(905483362)
+    sig { returns(LunchMoney::Calls::Base) }
     def transaction_calls
       with_valid_api_key do
         @transaction_calls ||= T.let(
-          LunchMoney::TransactionCalls.new(api_key:),
-          T.nilable(LunchMoney::TransactionCalls),
+          LunchMoney::Calls::Transactions.new(api_key:),
+          T.nilable(LunchMoney::Calls::Transactions),
         )
       end
     end
 
     delegate :recurring_expenses, to: :recurring_expense_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [recurring expenses call types](https://lunchmoney.dev/#recurring-expenses) come through here.
+    # @example [Get Recurring Expenses](https://lunchmoney.dev/#get-recurring-expenses)
+    #   api = LunchMoney::Api.new
+    #   api.recurring_expenses
+    sig { returns(LunchMoney::Calls::Base) }
     def recurring_expense_calls
       with_valid_api_key do
         @recurring_expense_calls ||= T.let(
-          LunchMoney::RecurringExpenseCalls.new(api_key:),
-          T.nilable(LunchMoney::RecurringExpenseCalls),
+          LunchMoney::Calls::RecurringExpenses.new(api_key:),
+          T.nilable(LunchMoney::Calls::RecurringExpenses),
         )
       end
     end
 
     delegate :budgets, :upsert_budget, :remove_budget, to: :budget_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [budget call types](https://lunchmoney.dev/#budget) come through here.
+    # @example [Get Budget Summary](https://lunchmoney.dev/#get-budget-summary)
+    #   api = LunchMoney::Api.new
+    #   api.budgets(start_date: "2023-01-01", end_date: "2024-01-01")
+    # @example [Upsert Budget](https://lunchmoney.dev/#upsert-budget)
+    #   api = LunchMoney::Api.new
+    #   api.upsert_budget(start_date: "2023-01-01", category_id: 777052, amount: 400.99)
+    # @example [Remove Budget(https://lunchmoney.dev/#remove-budget)
+    #   api = LunchMoney::Api.new
+    #   api.remove_budget(start_date: "2023-01-01", category_id: 777052)
+    sig { returns(LunchMoney::Calls::Base) }
     def budget_calls
       with_valid_api_key do
-        @budget_calls ||= T.let(LunchMoney::BudgetCalls.new(api_key:), T.nilable(LunchMoney::BudgetCalls))
+        @budget_calls ||= T.let(LunchMoney::Calls::Budgets.new(api_key:), T.nilable(LunchMoney::Calls::Budgets))
       end
     end
 
     delegate :assets, :create_asset, :update_asset, to: :asset_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [assets call types](https://lunchmoney.dev/#assets) come through here.
+    # @example [Get All Assets](https://lunchmoney.dev/#get-all-assets)
+    #   api = LunchMoney::Api.new
+    #   api.assets
+    # @example [Create Asset](https://lunchmoney.dev/#create-asset)
+    #   api = LunchMoney::Api.new
+    #   api.create_asset(
+    #     type_name: "cash",
+    #     name: "Create Asset Test",
+    #     balance: "10.00",
+    #   )
+    # @example [Update Asset](https://lunchmoney.dev/#update-asset)
+    #   api = LunchMoney::Api.new
+    #   api.update_asset(93746, balance: "99.99")
+    sig { returns(LunchMoney::Calls::Base) }
     def asset_calls
       with_valid_api_key do
-        @asset_calls ||= T.let(LunchMoney::AssetCalls.new(api_key:), T.nilable(LunchMoney::AssetCalls))
+        @asset_calls ||= T.let(LunchMoney::Calls::Assets.new(api_key:), T.nilable(LunchMoney::Calls::Assets))
       end
     end
 
     delegate :plaid_accounts, :plaid_accounts_fetch, to: :plaid_account_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [Plaid accounts call types](https://lunchmoney.dev/#plaid-accounts) come through here.
+    # @example [Get All Plaid Accounts](https://lunchmoney.dev/#get-all-plaid-accounts)
+    #   api = LunchMoney::Api.new
+    #   api.plaid_accounts
+    # @example [Trigger Fetch from Plaid](https://lunchmoney.dev/#trigger-fetch-from-plaid)
+    #   api = LunchMoney::Api.new
+    #   api.plaid_accounts_fetch
+    sig { returns(LunchMoney::Calls::Base) }
     def plaid_account_calls
       with_valid_api_key do
         @plaid_account_calls ||= T.let(
-          LunchMoney::PlaidAccountCalls.new(api_key:),
-          T.nilable(LunchMoney::PlaidAccountCalls),
+          LunchMoney::Calls::PlaidAccounts.new(api_key:),
+          T.nilable(LunchMoney::Calls::PlaidAccounts),
         )
       end
     end
 
     delegate :crypto, :update_crypto, to: :crypto_calls
 
-    sig { returns(LunchMoney::ApiCall) }
+    # All [crypto call types](https://lunchmoney.dev/#crypto) come through here.
+    # @example [Get All Crypto](https://lunchmoney.dev/#get-all-crypto)
+    #   api = LunchMoney::Api.new
+    #   api.crypto
+    # @example [Update Manual Crypto Asset](https://lunchmoney.dev/#update-manual-crypto-asset)
+    #   api = LunchMoney::Api.new
+    #   api.update_crypto(1234567, name: "New Crypto Name")
+    sig { returns(LunchMoney::Calls::Base) }
     def crypto_calls
       with_valid_api_key do
-        @crypto_calls ||= T.let(LunchMoney::CryptoCalls.new(api_key:), T.nilable(LunchMoney::CryptoCalls))
+        @crypto_calls ||= T.let(LunchMoney::Calls::Crypto.new(api_key:), T.nilable(LunchMoney::Calls::Crypto))
       end
     end
 
     private
 
-    sig { params(block: T.proc.returns(LunchMoney::ApiCall)).returns(LunchMoney::ApiCall) }
+    sig { params(block: T.proc.returns(LunchMoney::Calls::Base)).returns(LunchMoney::Calls::Base) }
     def with_valid_api_key(&block)
       raise(InvalidApiKey, "API key is missing or invalid") if api_key.blank?