amaprice 1.0.15 → 1.0.16
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.
- package/README.md +49 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -29,13 +29,13 @@ npx amaprice price "https://www.amazon.de/dp/B0DZ5P7JD6"
|
|
|
29
29
|
## Quickstart
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
# one-shot lookup
|
|
32
|
+
# one-shot lookup (no subscription)
|
|
33
33
|
amaprice price "https://www.amazon.de/dp/B0DZ5P7JD6"
|
|
34
34
|
|
|
35
|
-
# start tracking
|
|
35
|
+
# start tracking + subscribe current user + auto-start background collector
|
|
36
36
|
amaprice track B0DZ5P7JD6 --tier daily
|
|
37
37
|
|
|
38
|
-
# subscribe
|
|
38
|
+
# or subscribe directly to an existing shared catalog product
|
|
39
39
|
amaprice subscribe B0DZ5P7JD6
|
|
40
40
|
|
|
41
41
|
# show history
|
|
@@ -43,6 +43,16 @@ amaprice history B0DZ5P7JD6 --limit 30
|
|
|
43
43
|
|
|
44
44
|
# list tracked products
|
|
45
45
|
amaprice list
|
|
46
|
+
|
|
47
|
+
# list all subscriptions for current user (including paused)
|
|
48
|
+
amaprice subscriptions --all
|
|
49
|
+
|
|
50
|
+
# stop one product subscription for current user
|
|
51
|
+
amaprice unsubscribe B0DZ5P7JD6
|
|
52
|
+
|
|
53
|
+
# stop/start background collector service
|
|
54
|
+
amaprice background off
|
|
55
|
+
amaprice background on
|
|
46
56
|
```
|
|
47
57
|
|
|
48
58
|
## Input Modes
|
|
@@ -59,19 +69,47 @@ Short links from Amazon apps (for example `amzn.eu`, `amzn.to`, `a.co`) are acce
|
|
|
59
69
|
| Command | Description |
|
|
60
70
|
|---|---|
|
|
61
71
|
| `amaprice [url\|asin]` | Shortcut for `amaprice price [url\|asin]` |
|
|
62
|
-
| `amaprice price [url\|asin]` | One-shot lookup and silent history insert |
|
|
63
|
-
| `amaprice track [url\|asin]` | Track product + current
|
|
72
|
+
| `amaprice price [url\|asin]` | One-shot lookup (no subscription) and silent history insert |
|
|
73
|
+
| `amaprice track [url\|asin]` | Track product + subscribe current user + auto-start background (`--tier`, `--manual-tier`, `--auto-tier`, `--inactive`) |
|
|
64
74
|
| `amaprice subscribe [url\|asin]` | Subscribe current user to shared product catalog entry |
|
|
65
75
|
| `amaprice unsubscribe <url\|asin>` | Disable current user subscription |
|
|
66
76
|
| `amaprice subscriptions` | List user subscriptions with latest known prices |
|
|
67
77
|
| `amaprice history <url\|asin>` | Show history (`--limit N`) |
|
|
68
|
-
| `amaprice list` | List
|
|
78
|
+
| `amaprice list` | List current user subscriptions + latest price (default view) |
|
|
79
|
+
| `amaprice list --global` | List global shared catalog tracked products |
|
|
69
80
|
| `amaprice sync --limit <n>` | Run background sync for due products |
|
|
70
81
|
| `amaprice background <on\|off\|status>` | Manage true background collector service |
|
|
71
82
|
| `amaprice tier <url\|asin> <hourly\|daily\|weekly>` | Set tier/status (`--auto`, `--manual`, `--activate`, `--deactivate`) |
|
|
72
83
|
|
|
73
84
|
All commands support `--json`.
|
|
74
85
|
|
|
86
|
+
## Most Common User Flows
|
|
87
|
+
|
|
88
|
+
### One-time Price Check (No Subscription)
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
amaprice price B0DZ5P7JD6
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
This returns the current price immediately and does not create a user subscription.
|
|
95
|
+
|
|
96
|
+
### Subscribe + Run in Background
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
amaprice track B0DZ5P7JD6
|
|
100
|
+
amaprice background status --json
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
`track` (and `subscribe`) auto-starts the background collector on macOS (`launchd`).
|
|
104
|
+
You can close your terminal after this; the service keeps running.
|
|
105
|
+
|
|
106
|
+
### Stop Product + Stop Background Service
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
amaprice unsubscribe B0DZ5P7JD6
|
|
110
|
+
amaprice background off
|
|
111
|
+
```
|
|
112
|
+
|
|
75
113
|
## Background Service (Auto)
|
|
76
114
|
|
|
77
115
|
`track` and `subscribe` automatically ensure a true background collector service is running.
|
|
@@ -145,7 +183,11 @@ Run this SQL in Supabase SQL Editor:
|
|
|
145
183
|
|
|
146
184
|
`supabase/migrations/20260220_add_price_history_currency.sql`
|
|
147
185
|
|
|
148
|
-
|
|
186
|
+
`supabase/migrations/20260222_add_hybrid_orchestration.sql`
|
|
187
|
+
|
|
188
|
+
`supabase/migrations/20260223_enforce_collector_first_claiming.sql`
|
|
189
|
+
|
|
190
|
+
These migrations add tier fields, indexes, telemetry, worker health rollups, `price_history.currency`, collector orchestration tables/functions, and strict collector-first claim policy.
|
|
149
191
|
|
|
150
192
|
Note: these files are additive migrations and expect existing `products` + `price_history` tables.
|
|
151
193
|
|