paubox_rails 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efb96c5633f721a96323beab83ed91499817cc05e7e740da733d2ea3db907988
-  data.tar.gz: 766ce4809c4a6a74dee3c9614ec50407f8daa04351b00c6b5834126b1a9b7eb3
+  metadata.gz: f68c141779c45bbf28b520f210535ef3ff6abe9535925b631256f3c582f1cc85
+  data.tar.gz: b1f1e5e738b0c4b4b0f1dc459302e9caf04de4c8d39fccb10e50777714e81fc8
 SHA512:
-  metadata.gz: bd37d1a222575dafaae87e3afd92fe5dd54874778c1dff2ec2ae00a78ad42278873e509d3ec00eeb5616416434d7a74f6cd25593e1f472dc565bb9d33c805e83
-  data.tar.gz: bb9f9c170c09bb5aa043db76acdece25fb1a4bf089f11b2e3ecde245408ea88663718e8e2480b4befd1d7c892a7c9b1507567efda15ead0d6febe5a7d3752a60
+  metadata.gz: 15998c19e36e66f59e0c0e7152d445e42d61d33cff4627375b66a07f7e1f0fe0aa50d16fc3d8366beef487045e5df2b4f5dec87f90177a1efe7f5c624c30794a
+  data.tar.gz: af6a73ed219c68acf1fbb58d05f9a827f49e9ed6e97d4e9c5274a4058b6330f58e96973f24df65156a195e5c03367257e32962c9d55ab8c179e02c42e9c56184

data/.github/scripts/route-check.sh

@@ -0,0 +1,43 @@
+#!/bin/sh
+# Probes each base URL with a junk token: api.paubox.com answers unrouted paths
+# with its own HTML 404 page, so a wrong base fails here without credentials.
+#
+# Usage: route-check.sh <url> [url ...]
+#        <command printing one URL per line> | route-check.sh
+set -eu
+
+MARKER='The resource could not be found'
+TOKEN='route-check-not-a-real-key'
+
+urls=$(mktemp)
+fails=$(mktemp)
+trap 'rm -f "$urls" "$fails"' EXIT
+
+if [ "$#" -gt 0 ]; then
+  for u in "$@"; do echo "$u"; done > "$urls"
+else
+  cat > "$urls"
+fi
+
+sed 's#/*$##' "$urls" | grep '^https://' | sort -u > "$urls.clean" || true
+mv "$urls.clean" "$urls"
+
+if [ ! -s "$urls" ]; then
+  echo "route-check: no URLs given" >&2
+  exit 1
+fi
+
+while IFS= read -r url; do
+  if curl -sS -m 20 -H "Authorization: Token token=$TOKEN" "$url" \
+       | grep -qF "$MARKER"; then
+    echo "FAIL $url  <- not routed"
+    echo "$url" >> "$fails"
+  else
+    echo "ok   $url"
+  fi
+done < "$urls"
+
+if [ -s "$fails" ]; then
+  echo "See https://docs.paubox.com for the documented base URLs." >&2
+  exit 1
+fi

data/.github/workflows/ci.yml

@@ -40,3 +40,14 @@ jobs:
 
       - name: Assert the suite actually executed
         run: ruby .github/scripts/assert_specs_ran.rb rspec-results.json
+
+  route-check:
+    name: Base URLs are routed
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Probe the Forms base URL the client uses
+        run: |
+          grep -hoE 'https://api\.paubox\.com[a-zA-Z0-9/_.-]*' lib/paubox_rails/forms.rb \
+            | .github/scripts/route-check.sh

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.0.0"
+  ".": "1.1.0"
 }

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.0](https://github.com/Paubox/paubox-rails/compare/v1.0.0...v1.1.0) (2026-09-10)
+
+
+### Features
+
+* add scheduled send support ([#23](https://github.com/Paubox/paubox-rails/issues/23)) ([f60f3e6](https://github.com/Paubox/paubox-rails/commit/f60f3e6d640631202273cba7c8ac6150f13f4752))
+
+
+### Bug Fixes
+
+* target the documented /v1/forms base URL ([#20](https://github.com/Paubox/paubox-rails/issues/20)) ([0bf2abf](https://github.com/Paubox/paubox-rails/commit/0bf2abf715f5e6b365b59cdb9f3003bf76467060))
+
 ## [1.0.0](https://github.com/Paubox/paubox-rails/compare/v0.1.6...v1.0.0) (2026-08-21)
 
 First stable release. RubyGems had been on `0.1.6` since September 2021.

data/CLAUDE.md

@@ -35,7 +35,7 @@ paubox-rails
 ├── Email path
 │   ActionMailer → Mail::Paubox (from paubox gem) → RestClient → api.paubox.com
 └── Forms path
-    PauboxRails::Forms::Client → Net::HTTP → api.paubox.com/forms
+    PauboxRails::Forms::Client → Net::HTTP → api.paubox.com/v1/forms
 ```
 
 - Email credentials (`api_key`) are configured via `Paubox.configure`.

data/README.md

@@ -74,6 +74,37 @@ class UserMailer < ApplicationMailer
 end
 ```
 
+## Scheduled send
+
+Schedule messages for future delivery using `Paubox::Client` directly. The scheduled send methods are provided by the [Paubox Ruby gem](https://github.com/Paubox/paubox-ruby), which this gem depends on.
+
+```ruby
+client = Paubox::Client.new
+
+message = Paubox::Message.new(
+  from:         'sender@yourdomain.com',
+  to:           ['recipient@example.com'],
+  subject:      'Scheduled message',
+  text_content: 'This will be delivered later.'
+)
+
+# Schedule a message
+response = client.schedule_mail(message, '2025-12-25T15:00:00Z')
+puts response['sourceTrackingId']
+
+# Check status
+status = client.get_scheduled(response['sourceTrackingId'])
+puts status['state']          # "pending", "sent", "cancelled"
+
+# Reschedule
+client.reschedule(response['sourceTrackingId'], '2025-12-26T10:00:00Z')
+
+# Cancel
+client.cancel_scheduled(response['sourceTrackingId'])
+```
+
+`scheduled_at` must be an ISO 8601 UTC datetime string in the future and within 30 days.
+
 ## Paubox Forms
 
 The gem includes a client for the [Paubox Forms API](https://docs.paubox.com/forms). The respondent-facing endpoints (fetching a form definition and submitting a response) are **public** — no API key or authentication is required. The form management endpoints (listing, creating, updating, exporting submissions, etc.) require a **scoped API key** — see [Authenticated usage](#authenticated-usage-form-management) below.

data/api.md

@@ -9,7 +9,7 @@ This document covers the API endpoints exposed by `paubox-rails`. The gem wraps
 
 ## Forms API
 
-**Base URL:** `https://api.paubox.com/forms`
+**Base URL:** `https://api.paubox.com/v1/forms`
 
 ### Authentication
 

data/lib/paubox_rails/forms.rb

@@ -2,7 +2,7 @@ require 'paubox_rails/forms/client'
 
 module PauboxRails
   module Forms
-    BASE_URL = 'https://api.paubox.com/forms'.freeze
+    BASE_URL = 'https://api.paubox.com/v1/forms'.freeze
 
     class Error < StandardError; end
     class NotFoundError < Error; end

data/lib/paubox_rails/version.rb

@@ -1,3 +1,3 @@
 module PauboxRails
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paubox_rails
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Paubox, Inc.
@@ -102,6 +102,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/scripts/assert_specs_ran.rb"
+- ".github/scripts/route-check.sh"
 - ".github/workflows/ci.yml"
 - ".github/workflows/pr-title.yml"
 - ".github/workflows/release-please.yml"