@limitry/sdk 1.0.0-rc.5 → 1.0.0-rc.6

package/CHANGELOG.md

@@ -2,11 +2,20 @@
 
 What changed in the Limitry TypeScript SDK (`@limitry/sdk`). Generated from the source on each release; newest first.
 
+## 1.0.0-rc.6 (2026-10-19)
+
+### Changed
+
+- `LimitExceeded` says which limit refused, by name, and when to try
+  again: "Refused by AI replies per day: 0 replies left, resets
+  2026-10-20T00:00:00.000Z. Try again in 60 s." It used to show only the
+  limit's id. `error.limit` (`limit` in Python) is still the id.
+
 ## 1.0.0-rc.5 (2026-10-16)
 
 ### Changed
 
-- The TypeScript SDK's guide is at `/docs/typescript/` (beside `/docs/python/` and `/docs/cli/`); the old `/docs/sdk/` address redirects there.
+- The TypeScript SDK's guide is at `/docs/typescript/`, beside `/docs/python/` and `/docs/cli/`.
 
 ## 1.0.0-rc.4 (2026-10-16)
 

package/README.md

@@ -91,9 +91,12 @@ idempotency key, so a retried request happens once.
 - [Discord](https://limitry.com/discord)
 - [Report a security issue](https://limitry.com/security/)
 
-## About this package
+## Contributing
 
 This repository is generated from Limitry's source on each
 release, so pull requests are ported there and credited (see
 [CONTRIBUTING.md](https://github.com/limitry/limitry-typescript/blob/main/CONTRIBUTING.md)).
+
+## License
+
 Licensed under the Apache License 2.0.

package/dist/product/limits.js

@@ -1,3 +1,19 @@
+/**
+ * A refusal in the CLI's words, naming the limit rather than its id:
+ * "Refused by AI replies per day: 0 replies left, resets …. Try again in
+ * 42 s."
+ */
+function refusal(decision) {
+    const id = decision?.reason?.limit ?? null;
+    const limit = decision?.remaining.find((r) => r.limit === id);
+    const retry = decision?.retryAfterSeconds != null
+        ? ` Try again in ${decision.retryAfterSeconds} s.`
+        : "";
+    if (!limit)
+        return `Refused: limit ${id ?? "(unknown)"} is used up.${retry}`;
+    const resets = limit.resetsAt ? `, resets ${limit.resetsAt}` : "";
+    return `Refused by ${limit.name}: ${limit.remaining} ${limit.unit} left${resets}.${retry}`;
+}
 /** Not allowed: a limit is used up — or Limitry is unreachable and a limit fails closed. */
 export class LimitExceeded extends Error {
     reason;
@@ -11,7 +27,7 @@ export class LimitExceeded extends Error {
             ? "Limitry could not be reached and a limit denies when unreachable"
             : reason === "too_many_reservations"
                 ? "Too many open reservations for this subject"
-                : `Limit ${decision?.reason?.limit ?? ""} exceeded`.trim());
+                : refusal(decision));
         this.name = "LimitExceeded";
         this.reason = reason;
         this.limit = decision?.reason?.limit ?? null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limitry/sdk",
-  "version": "1.0.0-rc.5",
+  "version": "1.0.0-rc.6",
   "description": "Limitry API client",
   "type": "module",
   "exports": {