creem 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e7fe31044aee83bf2b64752085da9b27e4c3771e58ec40047cd83210f9fbcd45
+  data.tar.gz: 5f6dde7202667158a3bdfce8168afc8053d8cbf4a0885ec7cc75f21188abcbb2
+SHA512:
+  metadata.gz: 3265a96b388350d80792a5fc2b77a70cb0961561af66b1b0d7aa0ab200c1119d163a5e5fcae3846027016e85fda0d2e0d32250f82a11a7d9b2665a4bf7134b7f
+  data.tar.gz: '0749ef2eeeabc5d3a762bd58acbd548cf6dfa22cf9f5d9b1983d0f2ff1f4493758a9c4b25956430b42452155830ddeb78df076b712848cddc1e222b18fdc050d'

data/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: ['3.3', '3.4']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Ruby ${{ matrix.ruby-version }}
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+
+    - name: Run tests
+      run: bundle exec rspec
+
+    - name: Run RuboCop
+      run: bundle exec rubocop
+      continue-on-error: true
+  
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.4'
+        bundler-cache: true
+    
+    - name: Build gem
+      run: bundle exec rake build
+    
+    - name: Verify gem can be installed
+      run: gem install pkg/creem-*.gem

data/.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Release Gem
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.4'
+        bundler-cache: true
+    
+    - name: Run tests
+      run: bundle exec rspec
+    
+    - name: Build gem
+      run: bundle exec rake build
+    
+    - name: Publish to RubyGems
+      run: |
+        mkdir -p ~/.gem
+        echo ":rubygems_api_key: ${{ secrets.RUBYGEMS_API_KEY }}" > ~/.gem/credentials
+        chmod 0600 ~/.gem/credentials
+        gem push pkg/*.gem
+      env:
+        RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+    
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v2
+      with:
+        files: "pkg/*.gem"
+        body: |
+          Changes in this Release
+          - Check CHANGELOG.md for details
+        draft: false
+        prerelease: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle/
+pkg/
+tmp/
+.rspec_status
+coverage/

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,126 @@
+require: []
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.1
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
+    - "tmp/**/*"
+    - "pkg/**/*"
+
+# ── Style ──
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/GuardClause:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/Next:
+  Enabled: false
+
+Style/RaiseArgs:
+  EnforcedStyle: compact
+
+Style/RescueStandardError:
+  EnforcedStyle: implicit
+
+Style/StringConcatenation:
+  Enabled: false
+
+Style/IdenticalConditionalBranches:
+  Enabled: false
+
+Style/SymbolProc:
+  Enabled: false
+
+Style/ConditionalAssignment:
+  Enabled: false
+
+# ── Metrics ──
+
+Metrics/MethodLength:
+  Max: 30
+  Exclude:
+    - "spec/**/*"
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+    - "*.gemspec"
+
+Metrics/AbcSize:
+  Max: 35
+  Exclude:
+    - "spec/**/*"
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+Metrics/ClassLength:
+  Max: 250
+
+Metrics/ParameterLists:
+  Max: 8
+
+# ── Layout ──
+
+Layout/LineLength:
+  Max: 120
+  Exclude:
+    - "spec/**/*"
+
+Layout/FirstArrayElementIndentation:
+  EnforcedStyle: consistent
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+# ── Naming ──
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+Naming/MethodParameterName:
+  Enabled: false
+
+Naming/PredicateMethod:
+  Enabled: false
+
+# ── Lint ──
+
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+Lint/UnderscorePrefixedVariableName:
+  Enabled: false
+
+Lint/SharedMutableDefault:
+  Enabled: false
+
+# ── Gemspec ──
+
+Gemspec/RequireMFA:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+3.3

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## [0.1.0] - 2024-01-01
+
+### Added
+
+- Initial release
+- Products API (list, retrieve)
+- Checkouts API (create)
+- Subscriptions API (list, retrieve, update, cancel)
+- Customers API (list, retrieve, billing portal)
+- Transactions API (list)
+- Licenses API (list, validate, activate, deactivate)
+- Discounts API (list)
+- Webhook signature verification
+- Test mode support
+- Configurable timeouts

data/CLAUDE.md

@@ -0,0 +1,38 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Common Commands
+
+Ruby is pinned to 3.3 via `.ruby-version` and commands are run through `mise exec -- bundle exec ...`. Use the Makefile rather than invoking `bundle`/`rspec`/`rubocop` directly so the right toolchain is used.
+
+- `make install` — install dependencies
+- `make test` — run the full RSpec suite
+- `make test TEST=spec/resources/checkouts_spec.rb` — run a single spec file (any path works; `TEST=.` is the default and means "everything")
+- `make lint` / `make format` — RuboCop check / autocorrect
+- `make console` — `irb -r creem`
+- `make build` — build the gem via `rake build`
+- `make tag` / `make tag VERSION=x.y.z` — bumps `lib/creem/version.rb`, commits "Release vX", tags, and pushes both branch and tag. Auto-increments the patch when `VERSION` is omitted; the `lib/creem/version.rb` write is done by `sed`, so the file's `VERSION = '...'` line format must stay matchable.
+
+A single test can also be run with `mise exec -- bundle exec rspec spec/path_spec.rb:LINE` if you need line-level focus.
+
+## Architecture
+
+This gem is a thin HTTP client over the Creem REST API. Three layers:
+
+1. **`Creem` module + `Configuration`** ([lib/creem.rb](lib/creem.rb), [lib/creem/configuration.rb](lib/creem/configuration.rb)) — holds the global `Creem.configuration` (api_key, test_mode, timeouts). `base_url` is derived from `test_mode` and switches between `PRODUCTION_BASE_URL` and `TEST_BASE_URL` constants defined on the module.
+2. **`Creem::Client`** ([lib/creem/client.rb](lib/creem/client.rb)) — owns its own `Configuration` copy (seeded from globals at init), exposes one memoized accessor per resource, and is the only place that talks `Net::HTTP`. Auth is sent as the `x-api-key` header. All requests go through `request → build_uri → build_http → build_request → handle_response`; `handle_response` is what maps HTTP status codes to the error hierarchy.
+3. **`Creem::Resources::*`** ([lib/creem/resources/](lib/creem/resources/)) — each resource subclasses `Resources::Base`, which only holds a reference to the client and forwards `get`/`post`. Resources are pure mappers from keyword args to request bodies/query params; they do not parse responses, they return the raw `Hash` from `JSON.parse`. When adding a new resource: subclass `Base`, register a memoized accessor on `Client`, and `require_relative` it from `lib/creem.rb`.
+
+**Endpoint quirks worth knowing before editing:**
+- Listing uses different paths per resource: `/subscriptions/search`, `/licenses/search`, `/customers/list`, but `/transactions/...`. Don't normalize these — they reflect the upstream API.
+- `retrieve` typically passes the id as a **query parameter** (e.g. `GET /subscriptions?subscription_id=...`), not as a path segment. `Subscriptions#update` and `#cancel` are the exceptions that use path segments.
+- `Subscriptions#cancel` sends camelCase `onExecute` while everything else is snake_case — intentional, matches the API.
+
+**Errors** ([lib/creem/errors.rb](lib/creem/errors.rb)) — `ApiError` (base) carries `status` and `body`. Subclasses are mapped by status code in `Client#handle_response`: 400→`BadRequestError`, 401→`AuthenticationError`, 404→`NotFoundError`, 429→`RateLimitError`, 5xx→`ServerError`. `ConfigurationError` and `WebhookSignatureError` are separate (`< Error`, not `< ApiError`).
+
+**Webhooks** ([lib/creem/webhook.rb](lib/creem/webhook.rb)) — HMAC-SHA256 over the raw payload, compared with `OpenSSL.fixed_length_secure_compare`. Use `Webhook.construct_event` (verifies + parses) as the public entry point.
+
+## Testing Conventions
+
+[spec/spec_helper.rb](spec/spec_helper.rb) resets `Creem.configuration` before every example and disables real network access via WebMock. Two helpers — `stub_creem_get` and `stub_creem_post` — should be used for all HTTP stubs; they assert the `x-api-key` header and JSON-encode the request body. `build_client` produces a client with a fixed test api_key. New resource specs should follow this pattern rather than rolling their own WebMock stubs.

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.12"
+  gem "rubocop", "~> 1.50"
+  gem "webmock", "~> 3.18"
+end

data/Gemfile.lock

@@ -0,0 +1,85 @@
+PATH
+  remote: .
+  specs:
+    creem (0.0.1)
+      net-http
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.1.2)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    hashdiff (1.2.1)
+    json (2.19.5)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    parallel (2.1.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.86.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    webmock (3.26.2)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  arm64-darwin
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  creem!
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.50)
+  webmock (~> 3.18)
+
+BUNDLED WITH
+   2.6.8

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Creem Contributors
+
+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/Makefile

@@ -0,0 +1,108 @@
+.PHONY: all install format lint test test_watch clean build console tag help
+
+all: help
+
+######################
+# SETUP
+######################
+
+install: ## Install dependencies
+	mise exec -- bundle install
+
+######################
+# TESTING AND COVERAGE
+######################
+
+TEST ?= .
+
+test: ## Run the test suite (TEST=path/to/spec.rb to run a specific file)
+	mise exec -- bundle exec rspec $(if $(filter-out .,$(TEST)),$(TEST),)
+
+######################
+# LINTING AND FORMATTING
+######################
+
+format: ## Run code formatters
+	mise exec -- bundle exec rubocop -a
+
+lint: ## Run linters
+	mise exec -- bundle exec rubocop
+
+######################
+# BUILD AND RELEASE
+######################
+
+build: ## Build the gem
+	mise exec -- bundle exec rake build
+
+clean: ## Remove build artifacts
+	rm -f *.gem
+	rm -f creem-*.gem
+	rm -rf pkg/ tmp/ coverage/ .rspec_status
+
+console: ## Start an interactive console with the gem loaded
+	mise exec -- bundle exec irb -r creem
+
+tag: ## Create and push a version tag. Usage: make tag [VERSION=x.y.z]
+	@git fetch --tags; \
+	if [ -z "$(VERSION)" ]; then \
+		LATEST=$$(git tag -l 'v[0-9]*' --sort=-v:refname | head -n1); \
+		if [ -z "$$LATEST" ]; then \
+			NEW_TAG="v0.0.1"; \
+		else \
+			MAJOR=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f1); \
+			MINOR=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f2); \
+			PATCH=$$(echo $$LATEST | sed 's/^v//' | cut -d. -f3); \
+			PATCH=$$((PATCH + 1)); \
+			NEW_TAG="v$$MAJOR.$$MINOR.$$PATCH"; \
+		fi; \
+	else \
+		NEW_TAG="v$(VERSION)"; \
+		LATEST=$$(git tag -l 'v[0-9]*' --sort=-v:refname | head -n1); \
+		if [ "$$LATEST" = "$$NEW_TAG" ]; then \
+			echo "Tag $$NEW_TAG already exists on remote, deleting and re-pushing..."; \
+			git tag -d "$$NEW_TAG" 2>/dev/null || true; \
+			git push origin --delete "$$NEW_TAG" 2>/dev/null || true; \
+		elif git tag -l "$$NEW_TAG" | grep -q "$$NEW_TAG"; then \
+			echo "Error: Tag $$NEW_TAG exists but is not the latest tag (latest: $$LATEST). Aborting."; \
+			exit 1; \
+		fi; \
+	fi; \
+	NEW_VERSION=$$(echo $$NEW_TAG | sed 's/^v//'); \
+	echo "Updating version to $$NEW_VERSION ..."; \
+	sed -i '' "s/VERSION = [\"'].*[\"']/VERSION = '$$NEW_VERSION'/" lib/creem/version.rb; \
+	mise exec -- bundle install; \
+	git add lib/creem/version.rb Gemfile.lock; \
+	git commit -m "Release $$NEW_TAG" --allow-empty; \
+	git tag "$$NEW_TAG"; \
+	echo "Pushing tag $$NEW_TAG ..."; \
+	git push origin HEAD; \
+	git push origin "$$NEW_TAG"; \
+	echo "Done! Tagged and pushed $$NEW_TAG"
+
+######################
+# HELP
+######################
+
+help: ## Show this help
+	@echo '=========================='
+	@echo '  Creem SDK — Makefile'
+	@echo '=========================='
+	@echo ''
+	@echo 'SETUP'
+	@echo '  make install              — install dependencies'
+	@echo ''
+	@echo 'TESTING'
+	@echo '  make test                 — run the full test suite'
+	@echo '  make test TEST=spec/...   — run a specific test file'
+	@echo ''
+	@echo 'LINTING & FORMATTING'
+	@echo '  make format               — run code formatters'
+	@echo '  make lint                 — run linters'
+	@echo ''
+	@echo 'BUILD & RELEASE'
+	@echo '  make build                — build the gem'
+	@echo '  make clean                — remove build artifacts'
+	@echo '  make console              — start interactive console'
+	@echo '  make tag                  — auto-increment patch version, tag & push'
+	@echo '  make tag VERSION=x.y.z    — tag a specific version & push'