toc_doc 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31301e5ab8d81e4a073f6a86da51671dd7d41673eff44b48373659831b971010
-  data.tar.gz: e308514b6009f7b703d8861e739d963ea0048ed930778329bd453b1f28f1e82c
+  metadata.gz: a6c39bc2d41f1be6ae2b12b23074de967614fc1c6067d217316c7cb8bb9f0c31
+  data.tar.gz: 6c3a8732a25916bb75ebb18c7f53a79ff272a0c8b646477160a8381890404dcf
 SHA512:
-  metadata.gz: c8936171d0c8228e3a1390ef3d164ab5ca08cccecb656087cc983d61c859eaed3153d63715e4fd6f4bcd3f6b62cea4c85c1a6410669925ef3c73185f550eb28b
-  data.tar.gz: 23ad7e64604e97d9c18a0b99b8917af0b97974f2c67d1dc842d16070650a3e97ef79e0902d96f4dd4f8e71f84bdc30d09811aa16fb61342bbdcacb6e7979b8fc
+  metadata.gz: dde234124b736d0149ac1f45bb6ab654487fb4e0c91bffb6c1b2462f51fa50a94cb59c5e9d4c4c5ef688eb12b9a8f8f321a0b5384b7d4bebe375506f81001b87
+  data.tar.gz: 1fd5632c3e5c73f89ae8db6f844269d5674141332ea9fd1956691695c3ae7242a7d7f706b3b0742f361df6b7a6a8ed931dc25f6d4b2c01426c6cc0ee379dacde

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 ## [Unreleased]
 
+## [1.3.0] - 2026-03-15
+
+### Added
+
+- **`TocDoc::Speciality`** — new `Resource`-based model representing a speciality returned by the autocomplete endpoint; exposes `#value`, `#slug`, and `#name` via dot-notation
+- **`TocDoc::Profile`** — new `Resource`-based model for search profile results; `Profile.build(attrs)` factory returns a `Profile::Practitioner` or `Profile::Organization` based on the `owner_type` field; provides `#practitioner?` and `#organization?` predicates
+- **`TocDoc::Profile::Practitioner`** and **`TocDoc::Profile::Organization`** — typed profile subclasses
+- **`TocDoc::Search`** — new service class for the autocomplete endpoint (`/api/searchbar/autocomplete.json`); `Search.where(query:, type: nil, **options)` fetches results and returns a `Search::Result`, or a filtered array when `type:` is one of `'profile'`, `'practitioner'`, `'organization'`, or `'speciality'`
+- **`TocDoc::Search::Result`** — envelope returned by `Search.where`; exposes `#profiles` (typed via `Profile.build`) and `#specialities`; `#filter_by_type` narrows to a specific kind
+- **`TocDoc.search`** — top-level shortcut delegating to `TocDoc::Search.where`
+
+## [1.2.0] - 2026-03-08
+
+### Added
+
+- **`TocDoc::Availability::Collection`** — new `Enumerable` collection class returned by `TocDoc::Availability.where`; provides `#total`, `#next_slot`, `#each`, `#raw_availabilities`, `#to_h`, and `#merge_page!`
+- **`TocDoc::Availability.where`** — class-level query method replacing `Client#availabilities`; automatically follows a `next_slot` response key with a second request before returning the collection
+- **`TocDoc.availabilities`** — top-level shortcut delegating to `TocDoc::Availability.where`
+- **Dependabot** — automated Bundler dependency updates via `.github/dependabot.yml`
+
+### Changed
+
+- **Connection** — `#get` and `#paginate` are now public on `TocDoc::Connection`, allowing model classes to call them directly via `TocDoc.client`
+- **`TocDoc::UriUtils`** — updated module-level example to reflect actual usage (`TocDoc::Availability` with `extend`, not the removed `Client::Availabilities`)
+
+### Removed
+
+- **`TocDoc::Client::Availabilities`** — endpoint module removed; availability querying now lives in `TocDoc::Availability.where` and `TocDoc::Availability::Collection`
+- **`TocDoc::Response::Availability`** — response wrapper model removed; replaced by `TocDoc::Availability::Collection`
+- **`auto_paginate`** — configuration key, default, and all related logic removed from `TocDoc::Configurable` and `TocDoc::Default`
+
 ## [1.1.0] - 2026-03-06
 
 ### Changed

data/POTENTIAL_ENDPOINTS.md

@@ -0,0 +1,31 @@
+# Potential Endpoints
+
+- Interesting JSONs [GET]
+  - [x] Availabilities
+    - https://www.doctolib.fr/availabilities.json?visit_motive_ids=7767829&agenda_ids=1101600&practice_ids=377272&telehealth=false&start_date=2026-03-06&limit=5
+  - Practitioner ? 
+    - https://www.doctolib.fr/pharmacie/paris/pharmacie-faidherbe.json
+    - https://www.doctolib.fr/dentiste/bordeaux/mathilde-devun-lesparre-medoc.json
+    - https://www.doctolib.fr/a/b/mathilde-devun-lesparre-medoc.json
+    - https://www.doctolib.fr/profiles/mathilde-devun-lesparre-medoc.json
+  - Rassemblement practiciens / Place Practitioners collection
+    - https://www.doctolib.fr/profiles/pavillon-de-la-mutualite-bordeaux-rue-vital-carles.json
+  - Places
+    - https://www.doctolib.fr/patient_app/place_autocomplete.json?query=47300
+  - Booking context
+    - https://www.doctolib.fr/online_booking/api/slot_selection_funnel/v1/info.json?profile_slug=brigitte-devun-pujols&locale=fr
+    - https://www.doctolib.fr/online_booking/api/slot_selection_funnel/v1/info.json?profile_slug=926388&locale=fr
+- Interesting NON JSONs
+  - City practitioners (❗️JSON-LD in a script tag of an HTML page - data-id="removable-json-ld")
+    - https://www.doctolib.fr/dentiste/bordeaux/
+    - https://www.doctolib.fr/medecin-generaliste/bordeaux/
+    - https://www.doctolib.fr/medecin-generaliste/villeneuve-sur-lot
+- Non-interesting 
+  - Legal links
+    - https://www.doctolib.fr/search/footer_legal_links.json
+  - FAQ
+    - https://www.doctolib.fr/search/footer_public_content.json?hub_search=false&display_faq=true&speciality_id=2&place_id=18733 
+  - Social media links
+    - https://www.doctolib.fr/search/footer_social_media_links.json
+  - New Booking [POST]
+    - online_booking/draft/new.json

data/README.md

@@ -1,6 +1,6 @@
 # TocDoc
 
-A Ruby gem for interacting with the (unofficial) Doctolib API. A thin, Faraday-based client with modular resource endpoints, configurable defaults, optional auto-pagination, and a clean error hierarchy.
+A Ruby gem for interacting with the (unofficial) Doctolib API. A thin, Faraday-based client with configurable defaults, model-driven resource querying, and a clean error hierarchy.
 
 [![Gem Version](https://badge.fury.io/rb/toc_doc.svg)](https://badge.fury.io/rb/toc_doc)
 [![CI](https://github.com/01max/toc_doc/actions/workflows/main.yml/badge.svg)](https://github.com/01max/toc_doc/actions)
@@ -27,6 +27,7 @@ A Ruby gem for interacting with the (unofficial) Doctolib API. A thin, Faraday-b
    - [ENV variables](#environment-variable-overrides)
 4. [Endpoints](#endpoints)
    - [Availabilities](#availabilities)
+   - [Search](#search)
 5. [Response objects](#response-objects)
 6. [Pagination](#pagination)
 7. [Error handling](#error-handling)
@@ -65,18 +66,17 @@ gem install toc_doc
 ```ruby
 require 'toc_doc'
 
-# Use the pre-configured module-level client …
-response = TocDoc.availabilities(
+collection = TocDoc::Availability.where(
   visit_motive_ids: 7_767_829,
   agenda_ids:       1_101_600,
   practice_ids:     377_272,
   telehealth:       false
 )
 
-response.total      # => 5
-response.next_slot  # => "2026-02-28T10:00:00.000+01:00"
+collection.total      # => 5
+collection.next_slot  # => "2026-02-28T10:00:00.000+01:00"
 
-response.availabilities.each do |avail|
+collection.each do |avail|
   puts "#{avail.date}: #{avail.slots.map { |s| s.strftime('%H:%M') }.join(', ')}"
 end
 ```
@@ -95,7 +95,7 @@ TocDoc.configure do |config|
   config.per_page     = 10
 end
 
-TocDoc.availabilities(visit_motive_ids: 123, agenda_ids: 456)
+TocDoc::Availability.where(visit_motive_ids: 123, agenda_ids: 456)
 ```
 
 Calling `TocDoc.reset!` restores all options to their defaults.  
@@ -103,14 +103,24 @@ Use `TocDoc.options` to inspect the current configuration hash.
 
 ### Per-client configuration
 
-Instantiate independent clients with different options:
+Instantiate independent clients with different options and query via `TocDoc::Availability.where`:
 
 ```ruby
-de_client = TocDoc::Client.new(api_endpoint: 'https://www.doctolib.de')
-it_client = TocDoc::Client.new(api_endpoint: 'https://www.doctolib.it', per_page: 3)
+# Germany
+TocDoc.configure { |c| c.api_endpoint = 'https://www.doctolib.de'; c.per_page = 3 }
+TocDoc::Availability.where(visit_motive_ids: 123, agenda_ids: 456)
+
+# Reset and switch to Italy
+TocDoc.reset!
+TocDoc.configure { |c| c.api_endpoint = 'https://www.doctolib.it' }
+TocDoc::Availability.where(visit_motive_ids: 789, agenda_ids: 101)
+```
+
+Alternatively, use `TocDoc::Client` directly for lower-level access ().
 
-de_client.availabilities(visit_motive_ids: 123, agenda_ids: 456)
-it_client.availabilities(visit_motive_ids: 789, agenda_ids: 101)
+```ruby
+client = TocDoc::Client.new(api_endpoint: 'https://www.doctolib.de', per_page: 5)
+client.get('/availabilities.json', query: { visit_motive_ids: '123', agenda_ids: '456', start_date: Date.today.to_s, limit: 5 })
 ```
 
 ### All configuration options
@@ -118,10 +128,9 @@ it_client.availabilities(visit_motive_ids: 789, agenda_ids: 101)
 | Option | Default | Description |
 |---|---|---|
 | `api_endpoint` | `https://www.doctolib.fr` | Base URL. Change to `.de` / `.it` for other countries. |
-| `user_agent` | `TocDoc Ruby Gem 0.1.0` | `User-Agent` header sent with every request. |
+| `user_agent` | `TocDoc Ruby Gem 1.3.0` | `User-Agent` header sent with every request. |
 | `default_media_type` | `application/json` | `Accept` and `Content-Type` headers. |
-| `per_page` | `5` | Default number of results returned per request, platform's max is currently at `15`. |
-| `auto_paginate` | `false` | When `true`, automatically fetches all pages and merges results. |
+| `per_page` | `15` | Default number of availability dates per request (capped at `15`). |
 | `middleware` | Retry + RaiseError + JSON + adapter | Full Faraday middleware stack. Override to customise completely. |
 | `connection_options` | `{}` | Options passed directly to `Faraday.new`. |
 
@@ -135,7 +144,6 @@ All primary options can be set via environment variables before the gem is loade
 | `TOCDOC_USER_AGENT` | `user_agent` |
 | `TOCDOC_MEDIA_TYPE` | `default_media_type` |
 | `TOCDOC_PER_PAGE` | `per_page` |
-| `TOCDOC_AUTO_PAGINATE` | `auto_paginate` (`"true"` / anything else) |
 | `TOCDOC_RETRY_MAX` | Maximum Faraday retry attempts (default `3`) |
 
 ---
@@ -147,7 +155,7 @@ All primary options can be set via environment variables before the gem is loade
 Retrieve open appointment slots for a given visit motive and agenda.
 
 ```ruby
-client.availabilities(
+TocDoc::Availability.where(
   visit_motive_ids: visit_motive_id,   # Integer, String, or Array
   agenda_ids:       agenda_id,         # Integer, String, or Array
   start_date:       Date.today,        # Date or String (default: today)
@@ -158,18 +166,48 @@ client.availabilities(
 )
 ```
 
+`TocDoc.availabilities(...)` is a module-level shortcut with the same signature.
+
 **Multiple IDs** are accepted as arrays; the gem serialises them with the
 dash-separated format Doctolib expects:
 
 ```ruby
-client.availabilities(
+TocDoc::Availability.where(
   visit_motive_ids: [7_767_829, 7_767_830],
   agenda_ids:       [1_101_600, 1_101_601]
 )
 # → GET /availabilities.json?visit_motive_ids=7767829-7767830&agenda_ids=1101600-1101601&…
 ```
 
-**Return value:** a `TocDoc::Response::Availability` (see [Response objects](#response-objects)).
+**Return value:** a `TocDoc::Availability::Collection` (see [Response objects](#response-objects)).
+
+### Search
+
+Query the Doctolib autocomplete endpoint to look up practitioners, organizations, and specialities.
+
+```ruby
+result = TocDoc::Search.where(query: 'dentiste')
+result.profiles      # => [#<TocDoc::Profile::Practitioner ...>, ...]
+result.specialities  # => [#<TocDoc::Speciality ...>, ...]
+```
+
+Pass `type:` to receive a filtered array directly:
+
+```ruby
+# Only specialities
+TocDoc::Search.where(query: 'cardio', type: 'speciality')
+# => [#<TocDoc::Speciality name="Cardiologue">, ...]
+
+# Only practitioners
+TocDoc::Search.where(query: 'dupont', type: 'practitioner')
+# => [#<TocDoc::Profile::Practitioner ...>, ...]
+```
+
+Valid `type:` values: `'profile'` (all profiles), `'practitioner'`, `'organization'`, `'speciality'`.
+
+`TocDoc.search(...)` is a module-level shortcut with the same signature.
+
+**Return value:** a `TocDoc::Search::Result` when `type:` is omitted, or a filtered `Array` otherwise (see [Response objects](#response-objects)).
 
 ---
 
@@ -178,20 +216,22 @@ client.availabilities(
 All API responses are wrapped in lightweight Ruby objects that provide
 dot-notation access and a `#to_h` round-trip helper.
 
-### `TocDoc::Response::Availability`
+### `TocDoc::Availability::Collection`
 
-Returned by `#availabilities`.
+Returned by `TocDoc::Availability.where`; also accessible via the `TocDoc.availabilities` module-level shortcut.
+Implements `Enumerable`, yielding `TocDoc::Availability` instances that have at least one slot.
 
 | Method | Type | Description |
 |---|---|---|
 | `#total` | `Integer` | Total number of available slots across all dates. |
 | `#next_slot` | `String \| nil` | ISO 8601 datetime of the nearest available slot. `nil` when none remain. |
-| `#availabilities` | `Array<TocDoc::Availability>` | One entry per date. |
-| `#to_h` | `Hash` | Plain-hash representation including expanded availability entries. |
+| `#each` | — | Yields each `TocDoc::Availability` that has at least one slot (excludes empty-slot dates). |
+| `#raw_availabilities` | `Array<TocDoc::Availability>` | All date entries, including those with no slots. |
+| `#to_h` | `Hash` | Plain-hash representation (only dates with slots in the `availabilities` key). |
 
 ### `TocDoc::Availability`
 
-Each element of `Response::Availability#availabilities`.
+Represents a single availability date entry. Each element yielded by the collection.
 
 | Method | Type | Description |
 |---|---|---|
@@ -202,15 +242,15 @@ Each element of `Response::Availability#availabilities`.
 **Example:**
 
 ```ruby
-response = TocDoc.availabilities(visit_motive_ids: 123, agenda_ids: 456)
+collection = TocDoc::Availability.where(visit_motive_ids: 123, agenda_ids: 456)
 
-response.total      # => 5
-response.next_slot  # => "2026-02-28T10:00:00.000+01:00"
+collection.total      # => 5
+collection.next_slot  # => "2026-02-28T10:00:00.000+01:00"
 
-response.availabilities.first.date   # => #<Date: 2026-02-28>
-response.availabilities.first.slots  # => [#<DateTime: 2026-02-28T10:00:00+01:00>, ...]
+collection.first.date   # => #<Date: 2026-02-28>
+collection.first.slots  # => [#<DateTime: 2026-02-28T10:00:00+01:00>, ...]
 
-response.to_h
+collection.to_h
 # => {
 #      "total"          => 5,
 #      "next_slot"      => "2026-02-28T10:00:00.000+01:00",
@@ -218,39 +258,85 @@ response.to_h
 #    }
 ```
 
----
+### `TocDoc::Search::Result`
 
-## Pagination
+Returned by `TocDoc::Search.where` when `type:` is omitted.
+
+| Method | Type | Description |
+|---|---|---|
+| `#profiles` | `Array<TocDoc::Profile::Practitioner, TocDoc::Profile::Organization>` | All profile results, typed via `Profile.build`. |
+| `#specialities` | `Array<TocDoc::Speciality>` | All speciality results. |
+| `#filter_by_type(type)` | `Array` | Narrows results to `'profile'`, `'practitioner'`, `'organization'`, or `'speciality'`. |
+
+### `TocDoc::Profile`
+
+Represents a search profile result (practitioner or organization). Use `Profile.build(attrs)` to obtain the correctly typed subclass instance.
 
-The Doctolib availability endpoint is paginated by `start_date` and `limit`.
-TocDoc can manage this automatically.
+| Method | Type | Description |
+|---|---|---|
+| `Profile.build(attrs)` | `Profile::Practitioner \| Profile::Organization` | Factory: returns `Practitioner` when `owner_type` is `"Account"`, `Organization` otherwise. |
+| `#practitioner?` | `Boolean` | `true` when this is a `Profile::Practitioner`. |
+| `#organization?` | `Boolean` | `true` when this is a `Profile::Organization`. |
+
+`TocDoc::Profile::Practitioner` and `TocDoc::Profile::Organization` are thin subclasses that inherit dot-notation attribute access from `TocDoc::Resource`.
 
-### Automatic pagination
+### `TocDoc::Speciality`
+
+Represents a speciality returned by the autocomplete endpoint. Inherits dot-notation attribute access from `TocDoc::Resource`.
+
+| Method | Type | Description |
+|---|---|---|
+| `#value` | `Integer` | Numeric speciality identifier. |
+| `#slug` | `String` | URL-friendly identifier. |
+| `#name` | `String` | Human-readable speciality name. |
 
-Set `auto_paginate: true` on the client (or at module level) to fetch all pages
-and have results merged into a single `Response::Availability` object:
+**Example:**
 
 ```ruby
-client = TocDoc::Client.new(auto_paginate: true, per_page: 5)
+result = TocDoc::Search.where(query: 'dermato')
 
-all_slots = client.availabilities(
-  visit_motive_ids: 7_767_829,
-  agenda_ids:       1_101_600,
-  start_date:       Date.today
-)
+result.profiles.first.class          # => TocDoc::Profile::Practitioner
+result.profiles.first.practitioner?  # => true
+result.profiles.first.name           # => "Dr. Jane Smith"
 
-all_slots.total             # total across every page
-all_slots.availabilities    # every date entry, concatenated
+result.specialities.first.slug   # => "dermatologue"
+result.specialities.first.name   # => "Dermatologue"
 ```
 
-Pagination stops automatically when the API returns `next_slot: null`.
+---
+
+## Pagination
+
+The Doctolib availability endpoint is window-based: each request returns up to
+`limit` dates starting from `start_date`.
+
+### Automatic next-slot resolution
+
+`TocDoc::Availability.where` automatically follows `next_slot` once: if the
+first API response contains a `next_slot` key (indicating no available slots in
+the requested window), a second request is issued transparently from that date
+before the collection is returned.
 
-### Module-level toggle
+### Manual window advancement
+
+To fetch additional date windows, call `TocDoc::Availability.where` again with a
+later `start_date`:
 
 ```ruby
-TocDoc.configure { |c| c.auto_paginate = true }
+first_page = TocDoc::Availability.where(
+  visit_motive_ids: 7_767_829,
+  agenda_ids:       1_101_600,
+  start_date:       Date.today
+)
 
-TocDoc.availabilities(visit_motive_ids: 123, agenda_ids: 456)
+if first_page.any?
+  next_start = first_page.raw_availabilities.last.date + 1
+  next_page  = TocDoc::Availability.where(
+    visit_motive_ids: 7_767_829,
+    agenda_ids:       1_101_600,
+    start_date:       next_start
+  )
+end
 ```
 
 ---
@@ -262,7 +348,7 @@ so you can rescue the whole hierarchy with a single clause:
 
 ```ruby
 begin
-  TocDoc.availabilities(visit_motive_ids: 0, agenda_ids: 0)
+  TocDoc::Availability.where(visit_motive_ids: 0, agenda_ids: 0)
 rescue TocDoc::Error => e
   puts "Doctolib error: #{e.message}"
 end
@@ -319,13 +405,14 @@ bundle exec rake install
 
 ### Adding new endpoints
 
-1. Create `lib/toc_doc/client/<resource>.rb` and define a module
-   `TocDoc::Client::<Resource>` with your endpoint methods.
-2. Call `get`/`post`/`paginate` (from `TocDoc::Connection`) to issue requests.
-3. Create `lib/toc_doc/models/response/<resource>.rb` (and any model classes)
-   inheriting from `TocDoc::Resource`.
-4. Include the new module in `TocDoc::Client` (`lib/toc_doc/client.rb`).
-5. Add corresponding specs under `spec/toc_doc/client/`.
+1. Create `lib/toc_doc/models/<resource>.rb` with a model class inheriting from
+   `TocDoc::Resource`. Add a class-level `.where` (or equivalent) query method
+   that calls `TocDoc.client.get` / `.post` to issue requests.
+2. If the endpoint is paginated, create
+   `lib/toc_doc/models/<resource>/collection.rb` with an `Enumerable` collection
+   class (see `TocDoc::Availability::Collection` for the pattern).
+3. Require the new files from `lib/toc_doc/models.rb`.
+4. Add specs under `spec/toc_doc/models/`.
 
 ### Generating documentation
 

data/TODO.md

@@ -1,52 +1,53 @@
 # PLAN
 
-### Extra Endpoints
-- [x] Identify additional endpoints
-- [ ] Prioritize implementation of resource modules for those endpoints
+[POTENTIAL_ENDPOINTS][POTENTIAL_ENDPOINTS.md]
 
-## 1.2
+## 1.4
+
+- [ ] Profile
+  - slug : https://www.doctolib.fr/profiles/mathilde-devun-lesparre-medoc.json
+  - id : https://www.doctolib.fr/profiles/926388.json
+
+## 1.5
+
+- [ ] Booking context
+  - https://www.doctolib.fr/online_booking/api/slot_selection_funnel/v1/info.json?profile_slug=926388
+
+## 1.6
 
 ### Better API usage
 - [ ] Rate limiting
 - [ ] Caching
 - [ ] Logging
 
-## 1.4
+## 2.0
 
 ### Auth / User-based actions
 - [ ] Research auth scheme
 - [ ] Authentication module + headers
 - [ ] Auth specs
 
-# Potential Endpoints
-
-- Interesting JSONs [GET]
-  - Practitioner ? 
-    - https://www.doctolib.fr/pharmacie/paris/pharmacie-faidherbe.json
-    - https://www.doctolib.fr/dentiste/bordeaux/mathilde-devun-lesparre-medoc.json
-    - https://www.doctolib.fr/a/b/mathilde-devun-lesparre-medoc.json
-    - https://www.doctolib.fr/profiles/mathilde-devun-lesparre-medoc.json
-  - Rassemblement practiciens / Place Practitioners collection
-    - https://www.doctolib.fr/profiles/pavillon-de-la-mutualite-bordeaux-rue-vital-carles.json
-  - Places
-    - https://www.doctolib.fr/patient_app/place_autocomplete.json?query=47300
-- Interesting NON JSONs
-  - City practitioners (❗️JSON-LD in a script tag of an HTML page - data-id="removable-json-ld")
-    - https://www.doctolib.fr/dentiste/bordeaux/
-    - https://www.doctolib.fr/medecin-generaliste/bordeaux/
-    - https://www.doctolib.fr/medecin-generaliste/villeneuve-sur-lot
-- Non-interesting 
-  - Legal links
-    - https://www.doctolib.fr/search/footer_legal_links.json
-  - FAQ
-    - https://www.doctolib.fr/search/footer_public_content.json?hub_search=false&display_faq=true&speciality_id=2&place_id=18733 
-  - Social media links
-    - https://www.doctolib.fr/search/footer_social_media_links.json
-  - New Booking [POST]
-    - online_booking/draft/new.json
+# ???
+
+- [ ] Figure what is `organization_statuses` in the autocomplete endpoint and what to do with it.
 
 # DONE & RELEASED
 
+## 1.3
+
+- [x] Search (autocomplete)
+  - [x] search profile : https://www.doctolib.fr/api/searchbar/autocomplete.json?search=devun
+  - [x] search specialty : https://www.doctolib.fr/api/searchbar/autocomplete.json?search=dentiste
+
+## 1.2
+
+- [x] Rework Availability's client, model and collection architecture.
+
+## 1.1
+
+### Parse raw API data
+- [x] Parse date / datetime
+
 ## 1.0
 
 ### 1 – Skeleton & Tooling
@@ -100,9 +101,4 @@
   - [x] on rubygem
   - [x] release on GH
   - [x] gem.coop/@maxime
-- [x] Add test coverage tool
-
-## 1.1
-
-### Parse raw API data
-- [x] Parse date / datetime
+- [x] Add test coverage tool

data/lib/toc_doc/client.rb

@@ -3,7 +3,6 @@
 require 'toc_doc/core/configurable'
 require 'toc_doc/core/connection'
 require 'toc_doc/core/uri_utils'
-require 'toc_doc/client/availabilities'
 
 module TocDoc
   # The main entry-point for interacting with the Doctolib API.
@@ -16,18 +15,14 @@ module TocDoc
   #     api_endpoint: 'https://www.doctolib.de',
   #     per_page: 5
   #   )
-  #   client.availabilities(visit_motive_ids: 123, agenda_ids: 456)
   #
   # @see TocDoc::Configurable
   # @see TocDoc::Connection
-  # @see TocDoc::Client::Availabilities
   class Client
     include TocDoc::Configurable
     include TocDoc::Connection
     include TocDoc::UriUtils
 
-    include TocDoc::Client::Availabilities
-
     # Creates a new client instance.
     #
     # Options are merged on top of the module-level {TocDoc::Default} values.
@@ -39,7 +34,6 @@ module TocDoc
     # @option options [String]  :user_agent         User-Agent header value
     # @option options [String]  :default_media_type Accept / Content-Type header
     # @option options [Integer] :per_page           Results per page
-    # @option options [Boolean] :auto_paginate      Follow pagination automatically
     # @option options [Faraday::RackBuilder] :middleware Custom Faraday middleware
     # @option options [Hash]    :connection_options Additional Faraday options
     #

data/lib/toc_doc/core/configurable.rb

@@ -29,7 +29,6 @@ module TocDoc
       connection_options
       default_media_type
       per_page
-      auto_paginate
     ].freeze
 
     # @!attribute [rw] api_endpoint
@@ -42,8 +41,6 @@ module TocDoc
     #   @return [Hash] additional Faraday connection options
     # @!attribute [rw] default_media_type
     #   @return [String] the Accept / Content-Type header value
-    # @!attribute [rw] auto_paginate
-    #   @return [Boolean] whether to follow pagination automatically
     attr_accessor(*VALID_CONFIG_KEYS)
 
     # Set the number of results per page, clamped to

data/lib/toc_doc/core/connection.rb

@@ -9,8 +9,9 @@ module TocDoc
   # (`get`, `post`, `put`, `patch`, `delete`, `head`), a memoised
   # Faraday connection, pagination support, and response tracking.
   #
-  # All HTTP methods are **private** — callers interact with them through
-  # higher-level endpoint modules (e.g. {TocDoc::Client::Availabilities}).
+  # {#get} and {#paginate} are public so that model classes (e.g.
+  # {TocDoc::Availability}) can call them via `TocDoc.client`; all other
+  # HTTP verb methods remain private.
   #
   # @see TocDoc::Client
   module Connection
@@ -107,12 +108,11 @@ module TocDoc
 
     # Performs a paginated GET, accumulating results across pages.
     #
-    # When {Configurable#auto_paginate} is disabled or no block is given,
-    # behaves exactly like {#get}.
+    # Behaves exactly like {#get} when no block is given.
     #
-    # When +auto_paginate+ is +true+ **and** a block is provided, the block is
-    # yielded after every page fetch — including the first — with
-    # +(accumulator, last_response)+.  The block must:
+    # When a block is provided, it is yielded after every page fetch —
+    # including the first — with +(accumulator, last_response)+.  The block
+    # must:
     #
     # 1. Detect whether it is a continuation call by comparing object identity:
     #    `acc.equal?(last_response.body)` is `true` only on the first yield,
@@ -129,7 +129,7 @@ module TocDoc
     # @return [Object] the fully-accumulated response body
     def paginate(path, options = {}, &)
       data = get(path, options)
-      return data unless block_given? && auto_paginate
+      return data unless block_given?
 
       loop do
         next_options = yield(data, last_response)
@@ -192,5 +192,7 @@ module TocDoc
 
       [query || {}, explicit_headers]
     end
+
+    public :get, :paginate
   end
 end

data/lib/toc_doc/core/default.rb

@@ -28,9 +28,6 @@ module TocDoc
     # @return [Integer] the hard upper limit for per_page
     MAX_PER_PAGE   = 15
 
-    # @return [Boolean] whether to auto-paginate by default
-    AUTO_PAGINATE  = false
-
     # @return [Integer] the default maximum number of retries
     MAX_RETRY      = 3
 
@@ -45,7 +42,6 @@ module TocDoc
           user_agent: user_agent,
           default_media_type: default_media_type,
           per_page: per_page,
-          auto_paginate: auto_paginate,
           middleware: middleware,
           connection_options: connection_options
         }
@@ -93,19 +89,6 @@ module TocDoc
         PER_PAGE
       end
 
-      # Whether to follow pagination automatically.
-      #
-      # Falls back to the `TOCDOC_AUTO_PAGINATE` environment variable (set to
-      # `"true"` to enable), then {AUTO_PAGINATE}.
-      #
-      # @return [Boolean]
-      def auto_paginate
-        env_val = ENV.fetch('TOCDOC_AUTO_PAGINATE', nil)
-        return AUTO_PAGINATE if env_val.nil?
-
-        env_val.casecmp('true').zero?
-      end
-
       # The default Faraday middleware stack.
       #
       # Includes retry logic, error raising, JSON parsing, and the default