docs: pin install line to release, note unpinned-latest option

Signed-off-by: disqualifier <dev@disqualifier.me>

README.md

@@ -9,17 +9,19 @@ buttons) behind previous / jump / next navigation, with an optional cache button
 `requirements.txt`:
 
 ```
-dpy_paginator @ git+ssh://git@git.rethinkstudios.io/rethink-public/dpy_paginator.git@v0.1.1
+dpy_paginator @ git+ssh://git@git.rethinkstudios.io/rethink-public/dpy_paginator.git@v0.1.3
 ```
 
 Direct:
 
 ```bash
-pip install "dpy_paginator @ git+ssh://git@git.rethinkstudios.io/rethink-public/dpy_paginator.git@v0.1.1"
+pip install "dpy_paginator @ git+ssh://git@git.rethinkstudios.io/rethink-public/dpy_paginator.git@v0.1.3"
 ```
 
 Requires `discord.py` (pulled transitively).
 
+Drop the `@v0.1.3` suffix from the line above to install the latest unpinned.
+
 ## Basic usage
 
 Plain pages — just navigation:
@@ -139,4 +141,4 @@ in an embed). It may be sync or async.
 
 ## Versioning
 
-Tagged `vX.Y.Z`. Pin the tag in `requirements.txt`.
+Releases are tagged `vX.Y.Z`. The install line above pins a release; drop the `@vX.Y.Z` suffix to install the latest unpinned. Pin deliberately for reproducible installs.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dpy_paginator"
-version = "0.1.1"
+version = "0.1.3"
 description = "Button-navigated paginator for discord.py — config-free, injectable emojis, installable."
 requires-python = ">=3.10"
 dependencies = [

src/dpy_paginator/dpy_paginator.py

@@ -200,7 +200,7 @@ class ButtonPaginator(Generic[PageT_co], discord.ui.View):
 
     async def interaction_check(self, interaction: Interaction) -> bool:
         """restrict interaction to author_id when set"""
-        if not self.author_id or self.author_id == interaction.user.id:
+        if self.author_id is None or self.author_id == interaction.user.id:
             return True
         await interaction.response.send_message("You cannot interact with this menu.", ephemeral=True)
         return False
@@ -259,6 +259,14 @@ class ButtonPaginator(Generic[PageT_co], discord.ui.View):
                     if isinstance(value, discord.Attachment):
                         value = await value.to_file()
                     self._page_kwargs["files"].append(value)
+                elif key in ("embed", "embeds", "file", "files"):
+                    # a wrong-typed embed/file would otherwise fall to the catch-all and
+                    # be forwarded verbatim, colliding with the base embeds=[]/files=[]
+                    # and raising an opaque TypeError from inside discord.py — reject it
+                    # here with a clear, paginator-side message
+                    raise ValueError(
+                        f"page key {key!r} has unexpected type {type(value).__name__}"
+                    )
                 else:
                     self._page_kwargs[key] = value
         elif isinstance(formatted_page, str):
@@ -280,27 +288,34 @@ class ButtonPaginator(Generic[PageT_co], discord.ui.View):
 
         return self._page_kwargs
 
-    def update_buttons(self) -> None:
-        """rebuild the action row for the current page state"""
+    def update_buttons(self, nav: bool = True) -> None:
+        """rebuild the action row for the current page state
+
+        nav=False rebuilds with only the page's custom buttons and no navigation
+        items (prev/jump/cache/next) — a single-page result that still carries
+        custom buttons keeps them (and their live callbacks) without a nav row.
+        """
         self.clear_items()
 
-        self.previous_page.emoji = self.emojis["previous"]
-        self.previous_page.disabled = self.current_page <= 0
-        self.add_item(self.previous_page)
+        if nav:
+            self.previous_page.emoji = self.emojis["previous"]
+            self.previous_page.disabled = self.current_page <= 0
+            self.add_item(self.previous_page)
 
-        self.jump_button.label = self.page_text.format(self.current_page + 1, self.max_pages)
-        self.add_item(self.jump_button)
+            self.jump_button.label = self.page_text.format(self.current_page + 1, self.max_pages)
+            self.add_item(self.jump_button)
 
         for button in self.current_page_buttons:
             self.add_item(button)
 
-        if self.cache:
-            self.cache_button.emoji = self.emojis["cache"]
-            self.add_item(self.cache_button)
+        if nav:
+            if self.cache:
+                self.cache_button.emoji = self.emojis["cache"]
+                self.add_item(self.cache_button)
 
-        self.next_page.emoji = self.emojis["next"]
-        self.next_page.disabled = self.current_page >= self.max_pages - 1
-        self.add_item(self.next_page)
+            self.next_page.emoji = self.emojis["next"]
+            self.next_page.disabled = self.current_page >= self.max_pages - 1
+            self.add_item(self.next_page)
 
     async def _build_render_kwargs(self) -> Dict[str, Any]:
         """build the edit-ready kwargs for the current page (buttons + attachments)"""
@@ -370,8 +385,14 @@ class ButtonPaginator(Generic[PageT_co], discord.ui.View):
         self.update_buttons()
 
         if self.max_pages < 2:
-            self.stop()
-            kwargs.pop("view", None)
+            if self.current_page_buttons:
+                # single page WITH custom buttons: keep the view live so the
+                # buttons' callbacks still fire; strip only the navigation row
+                self.update_buttons(nav=False)
+            else:
+                # single page, no custom buttons: no interactive row at all
+                self.stop()
+                kwargs.pop("view", None)
 
         self.reset_files(kwargs)