@nodaro/sdk 1.13.1 → 1.14.0

package/dist/index.cjs

@@ -592,12 +592,29 @@ var CharactersResource = class {
    * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
    * When `projectId` is set, only characters belonging to that project are
    * returned.
+   *
+   * Cursor-paginated: a response carrying a non-null `nextCursor` means more
+   * rows exist. Pass it back as `cursor` to fetch the next page, and keep going
+   * until `nextCursor` is `null` — a single call returns at most `limit` rows
+   * (default 100), so treating one call as "all characters" silently truncates
+   * the list for anyone past that count.
+   *
+   * ```ts
+   * const all: Character[] = []
+   * let cursor: string | undefined
+   * do {
+   *   const page = await client.characters.list({ cursor })
+   *   all.push(...page.characters)
+   *   cursor = page.nextCursor ?? undefined
+   * } while (cursor)
+   * ```
    */
   list(params = {}) {
     const query = {};
     if (params.projectId) query.projectId = params.projectId;
     if (params.archived) query.archived = "true";
     if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
     return this.client.request("GET", "/v1/characters", { query });
   }
   /**
@@ -2153,7 +2170,7 @@ var TutorialsResource = class {
 };
 
 // src/client.ts
-var SDK_VERSION = "1.13.1" ;
+var SDK_VERSION = "1.14.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class {