Changelog

Copy Markdown View Source

All notable changes to this project are documented in this file.

The format is based on Common Changelog.

0.3.0 - 2026-05-22

Changed

  • Breaking: remove library application configuration as public API. Stripe.client/0 no longer reads config :tiger_stripe; construct clients with Stripe.client(api_key) or read credentials from your own application before calling TigerStripe.
  • Breaking: stop auto-starting Stripe.Finch. Add Stripe to your application's supervision tree, or pass finch: MyApp.Finch when using an existing Finch pool.
  • Breaking: move test stubbing to an explicit client transport. Tests that use Stripe.Test.stub/1 should construct clients with Stripe.Test.client/2 or pass transport: Stripe.Test.transport().
  • Compute uname once at compile time for the client user-agent instead of shelling out on every request.
  • Generate concrete service success specs from each operation's actual response object — e.g. Stripe.Resources.PaymentMethod.t(), Stripe.ListObject.t(), Stripe.SearchResult.t() — instead of term(). Operations with a polymorphic union or non-JSON response keep term().
  • Update the Igniter installer to generate an application-owned Stripe wrapper module and add the default Finch pool to the supervision tree.

Added

Fixed

  • Return {:error, %Stripe.Error{}} for malformed webhook signature timestamps instead of raising on hostile input.

0.2.0 - 2026-04-25

Changed

  • Breaking: remove generated child modules for nested Stripe response, params, and event data shapes. Top-level resources, params, services, and event modules remain public; nested shapes are now local @type aliases and deserialize to atom-key maps.
  • Breaking: replace generated __inner_types__/0 metadata with internal __nested_fields__/0 metadata used by the deserializer.
  • Breaking: remove stale preview resources that are no longer emitted by the current vendored Stripe OpenAPI spec and Ruby SDK fixture: Stripe.Resources.Reserve.Hold, Stripe.Resources.Reserve.Plan, Stripe.Resources.Reserve.Release, Stripe.Resources.UPI, Stripe.Resources.UPIHandleRedirectOrDisplayQrCode, and Stripe.Resources.UPIQRCode.
  • Reduce the generated public module surface so clean compiles in consuming apps do not pay for thousands of nested JSON-shape modules.
  • Preserve top-level resource structs and recursively cast known nested response shapes to atom-key maps while preserving unknown Stripe fields as string keys.

Added

0.1.11 - 2026-04-16

Added

  • Add Stripe.Resources.Reserve.Hold, Stripe.Resources.Reserve.Plan, and Stripe.Resources.Reserve.Release resources, plus their event types (reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, reserve.release.created)
  • Add Stripe.Resources.UPI, Stripe.Resources.UPIHandleRedirectOrDisplayQrCode, and Stripe.Resources.UPIQRCode resources

Changed

  • Sync OpenAPI spec to v2239 — field and parameter updates across V1 and V2 APIs (229 files, +2117/-466)

0.1.10 - 2026-03-03

Changed

  • Sync OpenAPI spec to v2186 (API version 2026-01-28.clover) — spec content unchanged from v2169, no generated code differences

0.1.9 - 2026-02-17

Changed

  • Exclude code generator and mix stripe.generate task from hex package — the package is regenerated weekly from the latest Stripe OpenAPI spec, so end users only need the generated output; contributors who need immediate regeneration can use mix stripe.generate from the repo. This also drops the rustyjson transitive dependency

0.1.8 - 2026-02-16

Changed

  • Bump RustyJSON to 0.3.9
  • Eliminate dynamic atom creation in code generator to follow Elixir best practices

Fixed

  • Fix generated typespecs for deeply nested parameter modules — previously only first-level children were emitted, leaving ~960 Dialyzer warnings for missing types
  • Normalize error returns in WebhookPlug so the with chain handles a single consistent shape

0.1.7 - 2026-02-12

Fixed

  • Fix generator to produce strongly typed maps for additionalProperties fields (e.g., Price.currency_options now resolves to %{String.t() => CurrencyOptions.t()} instead of map())
  • Fix parameter generator to produce strongly typed maps for nested request parameters (e.g. Coupon.create currency_options now resolves to %{String.t() => CurrencyOptions.t()} instead of map())
  • Fix generator to support oneOf unions (polymorphism), enabling future support for disjoint types in V2 events

0.1.6 - 2026-02-11

Fixed

  • Remove dead resolve_params_class/1 override lookup — params_overrides() is empty, so the pattern match was flagged as unreachable by both Dialyzer and Elixir's type checker (d07dbf5)

0.1.5 - 2026-02-11

Fixed

  • Add missing :context field to all thin event structs — fetch_related_object/2 references Map.get(event, :context) but the field was absent from the generated struct, producing 18 compiler warnings on Elixir 1.18+ and silently dropping authentication context (0305b53)

0.1.4 - 2026-02-11

Fixed

  • Fix inner type deserialization for modules not yet loaded by the BEAM — function_exported?/3 does not trigger auto-loading, so __inner_types__ was silently skipped for nested structs like InvoiceLineItem.Parent.SubscriptionItemDetails, returning raw string-keyed maps instead of typed structs (Code.ensure_loaded!/1 is now called before the check)

0.1.3 - 2026-02-10

Typespecs across all 307 resource modules now reference actual struct types instead of map(), improving Dialyzer coverage, IDE autocomplete, and LLM-generated code accuracy.

Changed

  • Generate precise typespecs for resource structs — inner types now show Period.t() instead of map(), cross-resource refs resolve to Stripe.Resources.Invoice.t() (9c2c859)
  • Document string-key vs atom-key convention in usage-rules.md — request params use string keys, response structs use atom keys (9c2c859)

Fixed

  • Fix 36 expandable fields typed as map() instead of String.t() | Resource.t() — unions like anyOf: [string, customer, deleted_customer] now resolve correctly (9c2c859)

0.1.2 - 2026-02-10

Added

  • Add Stripe.Deserializer.from_json/1 for decoding JSON strings into typed structs (b0b2acf)
  • Add 500 typed inner modules for nested API objects (e.g. Charge.BillingDetails, Price.Recurring, InvoiceLineItem.Period) replacing untyped map() (a81f7bf)
  • Add field override mechanism for API fields missing from the OpenAPI spec (a81f7bf)
  • Add integration test suite against stripe-mock for field coverage validation (a81f7bf)

Fixed

  • Fix Charge.invoice returning nil — field was absent from generated struct because the OpenAPI spec omits it (a81f7bf)
  • Fix nested object deserialization losing type information — inner types now recurse through __inner_types__ at all nesting depths (a81f7bf)

0.1.1 - 2025-02-07

Fixed

  • Fix event.data deserialization: Webhook.construct_event/4 now returns event.data as a typed %EventData{} struct instead of a raw string-keyed map (1d30ea8)

0.1.0 - 2025-02-06

Initial release.

Added

  • Add full V1 + V2 API coverage (561 endpoints across 190 service modules)
  • Add typed Elixir structs for 307 resource types with inner type deserialization
  • Add auto-paging pagination for V1 lists, search results, and V2 lists
  • Add webhook signature verification via Webhook.construct_event/4
  • Add WebhookPlug for Plug/Phoenix integration
  • Add OAuth support (authorize_url, token, deauthorize)
  • Add multipart file uploads and streaming response support
  • Add per-event typed modules (21 event types with nested data structs)
  • Add process-scoped test stubs via Stripe.Test
  • Add retry with exponential backoff, jitter, and idempotency keys
  • Add telemetry events for request lifecycle observability
  • Add Finch HTTP client with connection pooling (Mint + NimblePool)