showroom 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +23 -0
  3. data/LICENSE +674 -0
  4. data/README.md +200 -0
  5. data/lib/showroom/client.rb +95 -0
  6. data/lib/showroom/core/configurable.rb +77 -0
  7. data/lib/showroom/core/connection.rb +88 -0
  8. data/lib/showroom/core/countable.rb +79 -0
  9. data/lib/showroom/core/default.rb +61 -0
  10. data/lib/showroom/core/error.rb +53 -0
  11. data/lib/showroom/core/store_url.rb +60 -0
  12. data/lib/showroom/core/version.rb +9 -0
  13. data/lib/showroom/http/middleware/raise_error.rb +81 -0
  14. data/lib/showroom/models/collection.rb +67 -0
  15. data/lib/showroom/models/product.rb +142 -0
  16. data/lib/showroom/models/product_image.rb +12 -0
  17. data/lib/showroom/models/product_option.rb +13 -0
  18. data/lib/showroom/models/product_variant.rb +39 -0
  19. data/lib/showroom/models/resource.rb +143 -0
  20. data/lib/showroom/models/search/article_suggestion.rb +14 -0
  21. data/lib/showroom/models/search/collection_suggestion.rb +19 -0
  22. data/lib/showroom/models/search/page_suggestion.rb +16 -0
  23. data/lib/showroom/models/search/product_suggestion.rb +20 -0
  24. data/lib/showroom/models/search/query_suggestion.rb +14 -0
  25. data/lib/showroom/models/search/result.rb +55 -0
  26. data/lib/showroom/models/search/suggestion.rb +50 -0
  27. data/lib/showroom/models/search.rb +28 -0
  28. data/lib/showroom/models.rb +20 -0
  29. data/lib/showroom.rb +106 -0
  30. metadata +93 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 7c08f4e39bf588bda99e07cb1310c9e56628914a6cdb79d4a0b6e89b92a048e3
4
+ data.tar.gz: 0de4e4be0d0a10eaa891c512daa622b80724b022d320709e021453b213e98647
5
+ SHA512:
6
+ metadata.gz: 118d905ece1c93e675e63ce0efcc6f553a22fbca8b09a255057ea3a5b55a8f36fae9b4d93855962d621f879aa5841729ee69b88bb197420aec85b847e08027b8
7
+ data.tar.gz: 98659d1aa63513b1c2e22eb8f54dca17ee70d27b1ec9d02feb6b6f4aaa3800e9e386c002e83ca460782807fb5ea92e35a0439873df2715c28fe2b910d59f866f
data/CHANGELOG.md ADDED
@@ -0,0 +1,23 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.1.0] - 2026-04-11
11
+
12
+ ### Added
13
+
14
+ - `Showroom::Product` — fetch, find, and paginate products from public Shopify stores
15
+ - `Showroom::Collection` — fetch and find collections, with nested `CollectionProduct` support
16
+ - `Showroom::Product.all` / `Showroom::Product.each_page` — lazy Enumerator-based full-catalog pagination with `max_pages:` or `force_all_without_limit:` guard
17
+ - `Showroom::Core::Countable` — binary-search based total-count estimation (`Product.count`, `Collection.count`) with a configurable `max_count` ceiling
18
+ - `Showroom::Client` — per-instance client for multi-store usage with configurable `per_page` (default 250, capped at `MAX_PER_PAGE`)
19
+ - `Showroom.search` / `Showroom::Search.suggest` — search suggest endpoint with typed result objects (`ProductSuggestion`, `CollectionSuggestion`, `PageSuggestion`, `ArticleSuggestion`, `QuerySuggestion`)
20
+ - Loadable suggestions: `result.products.first.load` fetches the full `Product` record
21
+ - Full error hierarchy: `ConfigurationError`, `ConnectionError`, `InvalidResponse`, `NotFound`, `TooManyRequests`, `ServerError`, and more
22
+ - Module-level configuration via `Showroom.configure` with environment-variable fallbacks
23
+ - Custom Faraday middleware hook via `c.middleware`