yungle-client 0.3.0 → 0.3.2

package/README.md

@@ -85,12 +85,12 @@ refused. No public URL? Create the endpoint with `url: null` and poll `listWebho
 
 Your vault and end-to-end encrypted transfers, because their keys are derived in
 the client and never sent to Yungle. See
-<https://yungle.co/developers/unsupported>.
+<https://docs.yungle.co/unsupported>.
 
 ## Related
 
 - [`yungle-cli`](https://www.npmjs.com/package/yungle-cli) — resumable uploads from your terminal
 - [`yungle-mcp`](https://www.npmjs.com/package/yungle-mcp) — connect Claude or Cursor to Yungle
-- [API reference](https://yungle.co/developers/reference?ref=npm) · [OpenAPI spec](https://yungle.co/api/v1/openapi.json)
+- [API reference](https://docs.yungle.co/api-reference?ref=npm) · [OpenAPI spec](https://yungle.co/api/v1/openapi.json)
 
 MIT

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { Collection, CollectionFile, CollectionSummary, Contact, ContactInput, DownloadEvent, DownloadLinks, ImportInput, ImportStatus, Submission, UploadRequest, UploadRequestInput, FileInput, Folder, Guest, Me, PulledWebhookEvent, RecipientStatus, Transfer, TransferFile, TransferSummary, UploadTargets, WebhookDelivery, WebhookEndpoint, WebhookEventType } from './types.js';
+import type { Collection, CollectionFile, CollectionSummary, Contact, ContactInput, DownloadEvent, DownloadLinks, ImportInput, ImportStatus, Submission, UploadRequest, UploadRequestInput, FileInput, Folder, Guest, Me, Referral, PulledWebhookEvent, RecipientStatus, Transfer, TransferFile, TransferSummary, UploadTargets, WebhookDelivery, WebhookEndpoint, WebhookEventType } from './types.js';
 import { type RenewOutcome as Renewal } from './upload-token.js';
 import { type UploadFileOptions } from './upload.js';
 export { chunkSize, uploadFile, UploadError, type UploadFileOptions } from './upload.js';
@@ -106,6 +106,8 @@ export declare class YungleClient {
         uploadUrl: string;
     }>;
     me(): Promise<Me>;
+    /** Your invite code and link, and the free months it has earned. */
+    getReferral(): Promise<Referral>;
     /**
      * One page of transfers, newest first — 100 by default, up to 500. Pass the
      * returned `nextCursor` back as `cursor` for the next page; it is null on the

package/dist/index.mjs

@@ -220,7 +220,7 @@ function pageQuery(page, extra = {}) {
   const q = params.toString();
   return q ? `?${q}` : "";
 }
-var CLIENT_VERSION = true ? "0.3.0" : "dev";
+var CLIENT_VERSION = true ? "0.3.2" : "dev";
 var YungleClient = class {
   baseUrl;
   apiKey;
@@ -260,6 +260,10 @@ var YungleClient = class {
   me() {
     return this.request("GET", "/me");
   }
+  /** Your invite code and link, and the free months it has earned. */
+  getReferral() {
+    return this.request("GET", "/me/referral");
+  }
   // ── Transfers ─────────────────────────────────────────────────────────────
   /**
    * One page of transfers, newest first — 100 by default, up to 500. Pass the
@@ -504,22 +508,31 @@ var YungleClient = class {
     const safe = method === "GET" || method === "DELETE" || idempotencyKey !== void 0 || opts?.idempotent === true;
     let attempt = 0;
     for (; ; ) {
-      const res = await this.doFetch(`${this.baseUrl}${path}`, {
-        method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          Accept: "application/json",
-          "User-Agent": this.userAgent,
-          ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
-          ...body === void 0 ? {} : { "Content-Type": "application/json" }
-        },
-        ...body === void 0 ? {} : { body: JSON.stringify(body) }
-      });
+      let res;
+      try {
+        res = await this.doFetch(`${this.baseUrl}${path}`, {
+          method,
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            "User-Agent": this.userAgent,
+            ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+            ...body === void 0 ? {} : { "Content-Type": "application/json" }
+          },
+          ...body === void 0 ? {} : { body: JSON.stringify(body) }
+        });
+      } catch (err) {
+        const aborted = err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError");
+        if (aborted || !safe || attempt >= this.maxRetries) throw err;
+        await sleep(backoffMs(attempt, null));
+        attempt++;
+        continue;
+      }
       if (res.ok) return await res.json();
       const error = await toError(res);
       const mayRetry = error.status === 429 || safe && error.retryable;
       if (!mayRetry || attempt >= this.maxRetries) throw error;
-      await sleep(backoffMs(attempt, error));
+      await sleep(backoffMs(attempt, error.retryAfterSeconds));
       attempt++;
     }
   }
@@ -555,8 +568,7 @@ function parseRetryAfter(value, now = Date.now()) {
   const seconds = Math.ceil((at - now) / 1e3);
   return seconds >= 0 ? seconds : null;
 }
-function backoffMs(attempt, error) {
-  const stated = error.retryAfterSeconds;
+function backoffMs(attempt, stated) {
   if (stated !== null) return stated * 1e3;
   return Math.min(2 ** attempt * 500, 8e3) + Math.floor(Math.random() * 250);
 }

package/dist/types.d.ts

@@ -40,6 +40,23 @@ export interface KeyInfo {
     /** Whether this credential may make Yungle email anyone. Absent on older servers. */
     canEmail?: boolean;
 }
+/** Your invite code and what it has earned (`GET /me/referral`). */
+export interface Referral {
+    /** Your invite code. A friend can type it in Settings › Plan. */
+    code: string;
+    /** Your invite link: the same code, as a page that signs them up. */
+    url: string;
+    /** Free months earned so far. */
+    earnedMonths: number;
+    /** Free months still available to earn. */
+    remainingMonths: number;
+    /** The most free months one person can earn, ever. */
+    cap: number;
+    /** True once `earnedMonths` reached `cap`. The link still gives friends their month. */
+    capped: boolean;
+    /** Friends in their free month, or inside the 14 days after their first payment. */
+    pending: number;
+}
 export interface Me {
     workspace: Workspace;
     plan: PlanInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yungle-client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "exports": {
     ".": {
@@ -22,7 +22,7 @@
     "type": "git",
     "url": "git+https://github.com/heindewilde/yungle-clients.git"
   },
-  "homepage": "https://yungle.co/developers/reference?ref=npm",
+  "homepage": "https://docs.yungle.co/api-reference?ref=npm",
   "bugs": {
     "url": "https://github.com/heindewilde/yungle-clients/issues"
   },