@gojinko/cli 2.23.0 → 2.24.0

package/dist/output/remedies.d.ts

@@ -0,0 +1,30 @@
+/**
+ * One-line remedies for the public error codes that have an actionable next
+ * step (JIN-2117, JIN-2118 / contracts C13, C14, C15).
+ *
+ * `error.code` is a closed enum on the public contract, so a caller is meant to
+ * branch on it. The CLI is a human surface as well as a scripting one, and a
+ * bare code plus the server's message leaves a developer to go and look the
+ * code up. These lines are the condensed form of the remedy column on
+ * https://docs.gojinko.com/concepts/errors — deliberately the same advice, so
+ * the terminal and the docs never disagree.
+ *
+ * Eleven of the twenty public codes appear here, plus `PRICE_CHANGED`, which the
+ * published enum does not list. The other nine are omitted rather than given
+ * invented prose: `BAD_REQUEST`, `NOT_FOUND`, `CONFLICT`, `INTERNAL` and the
+ * four `UPSTREAM_*` codes carry a server message that is already the specific
+ * part, so a generic "try again" line would add noise without adding
+ * information; `AUTH_REQUIRED` is omitted because `AuthError` already carries a
+ * full self-describing message naming where to get a key.
+ *
+ * NOTE: jinko-api now publishes a machine-readable table of all twenty codes
+ * with statuses, summaries and remedies at `docs/error-codes.json`. Only
+ * `public-api.yaml` is vendored here, so this list is still hand-kept and its
+ * wording is a close paraphrase rather than a copy. Deriving it from that file
+ * would remove the drift risk entirely — worth doing, but it is a design change
+ * beyond the contract this round settles.
+ */
+export declare const ERROR_REMEDIES: Readonly<Record<string, string>>;
+/** The remedy for a code, or undefined when it has no actionable next step. */
+export declare function remedyFor(code: string | undefined): string | undefined;
+//# sourceMappingURL=remedies.d.ts.map

package/dist/output/remedies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remedies.d.ts","sourceRoot":"","sources":["../../src/output/remedies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB1D,CAAC;AAEH,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtE"}

package/dist/output/remedies.js

@@ -0,0 +1,45 @@
+/**
+ * One-line remedies for the public error codes that have an actionable next
+ * step (JIN-2117, JIN-2118 / contracts C13, C14, C15).
+ *
+ * `error.code` is a closed enum on the public contract, so a caller is meant to
+ * branch on it. The CLI is a human surface as well as a scripting one, and a
+ * bare code plus the server's message leaves a developer to go and look the
+ * code up. These lines are the condensed form of the remedy column on
+ * https://docs.gojinko.com/concepts/errors — deliberately the same advice, so
+ * the terminal and the docs never disagree.
+ *
+ * Eleven of the twenty public codes appear here, plus `PRICE_CHANGED`, which the
+ * published enum does not list. The other nine are omitted rather than given
+ * invented prose: `BAD_REQUEST`, `NOT_FOUND`, `CONFLICT`, `INTERNAL` and the
+ * four `UPSTREAM_*` codes carry a server message that is already the specific
+ * part, so a generic "try again" line would add noise without adding
+ * information; `AUTH_REQUIRED` is omitted because `AuthError` already carries a
+ * full self-describing message naming where to get a key.
+ *
+ * NOTE: jinko-api now publishes a machine-readable table of all twenty codes
+ * with statuses, summaries and remedies at `docs/error-codes.json`. Only
+ * `public-api.yaml` is vendored here, so this list is still hand-kept and its
+ * wording is a close paraphrase rather than a copy. Deriving it from that file
+ * would remove the drift risk entirely — worth doing, but it is a design change
+ * beyond the contract this round settles.
+ */
+export const ERROR_REMEDIES = Object.freeze({
+    PRICE_CHANGED: 'Read `items` for what moved, then call `checkout` again without `--fail-on-price-change` to accept the new price. Nothing was charged.',
+    GONE: 'Re-acquire what this command named — search again, or `checkout` again to re-quote — then retry with the new identifier. Repeating this one cannot succeed.',
+    QUOTE_EXPIRED: 'Call `checkout` again for a fresh quote and re-mint the payment token. Nothing was charged.',
+    TRIP_EXPIRED: 'This trip lapsed after 24 hours idle and cannot be revived. Start a new trip and add the items again.',
+    TRIP_STATE_CONFLICT: 'The trip is busy or already finished — read `status` to see which. Nothing was written.',
+    OFFER_EXPIRED: 'The offer token is no longer cached. Search again and add the item with a fresh token.',
+    OFFER_UNAVAILABLE: 'Search again for the occupancy you intend to book and pick a rate that covers it; this one cannot be quoted at any price.',
+    MISSING_CUSTOMER_DETAILS: 'Attach travelers and a contact carrying both an email and a phone, then check out again.',
+    CURRENCY_UNSUPPORTED: 'Retry in a supported currency. Agent payment in particular is dollar-only.',
+    FORBIDDEN: 'Do not rotate the key — it is working. Check that it is entitled to this operation, and on this environment.',
+    PAYMENT_REQUIRED: 'Your wallet is out of balance. Top it up in the dashboard, then retry.',
+    RATE_LIMITED: 'You are sending requests too fast. Back off, then retry.',
+});
+/** The remedy for a code, or undefined when it has no actionable next step. */
+export function remedyFor(code) {
+    return code ? ERROR_REMEDIES[code] : undefined;
+}
+//# sourceMappingURL=remedies.js.map

package/dist/output/remedies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remedies.js","sourceRoot":"","sources":["../../src/output/remedies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC5E,aAAa,EACX,wIAAwI;IAC1I,IAAI,EACF,6JAA6J;IAC/J,aAAa,EACX,6FAA6F;IAC/F,YAAY,EACV,uGAAuG;IACzG,mBAAmB,EACjB,yFAAyF;IAC3F,aAAa,EACX,wFAAwF;IAC1F,iBAAiB,EACf,2HAA2H;IAC7H,wBAAwB,EACtB,0FAA0F;IAC5F,oBAAoB,EAClB,4EAA4E;IAC9E,SAAS,EACP,8GAA8G;IAChH,gBAAgB,EAAE,wEAAwE;IAC1F,YAAY,EAAE,0DAA0D;CACzE,CAAC,CAAC;AAEH,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gojinko/cli",
-  "version": "2.23.0",
+  "version": "2.24.0",
   "type": "module",
   "bin": {
     "jinko": "./dist/bin/jinko.js"
@@ -17,7 +17,7 @@
     "docs:gen": "tsx scripts/gen-cli-docs.ts"
   },
   "dependencies": {
-    "@gojinko/api-client": "2.23.0",
+    "@gojinko/api-client": "2.24.0",
     "commander": "^12.1.0",
     "chalk": "^5.4.1"
   },