@zapier/zapier-sdk 0.84.3 → 0.85.0

package/dist/experimental.mjs

@@ -408,51 +408,36 @@ function decodeConcatCursor(incoming) {
   }
   return { index: 0, cursor: incoming };
 }
-function concatPaginated({
+async function concatLists({
   sources,
   pageSize = 100,
   cursor
 }) {
   if (sources.length === 0) {
-    const empty = { data: [] };
-    return Object.assign(Promise.resolve(empty), {
-      [Symbol.asyncIterator]: async function* () {
-        yield empty;
-      }
-    });
+    return { data: [] };
   }
   const pageFunction = async (options) => {
-    let { index, cursor: sourceCursor } = decodeConcatCursor(options.cursor);
+    let { index, cursor: listCursor } = decodeConcatCursor(options.cursor);
     while (index < sources.length) {
-      const page = await sources[index]({ cursor: sourceCursor });
-      const hasMoreInSource = page.nextCursor != null;
-      if (page.data.length === 0 && !hasMoreInSource) {
+      const page = await sources[index]({ cursor: listCursor });
+      const hasMoreInList = page.nextCursor != null;
+      if (page.data.length === 0 && !hasMoreInList) {
         index++;
-        sourceCursor = void 0;
+        listCursor = void 0;
         continue;
       }
       return {
         data: page.data,
-        nextCursor: hasMoreInSource ? encodeConcatCursor(index, page.nextCursor) : index < sources.length - 1 ? encodeConcatCursor(index + 1, void 0) : void 0
+        nextCursor: hasMoreInList ? encodeConcatCursor(index, page.nextCursor) : index < sources.length - 1 ? encodeConcatCursor(index + 1, void 0) : void 0
       };
     }
     return { data: [] };
   };
-  const iterator = paginateBuffered(pageFunction, { pageSize, cursor });
-  const firstPagePromise = iterator.next().then((result) => {
-    if (result.done) {
-      return { data: [] };
-    }
-    return result.value;
-  });
-  return Object.assign(firstPagePromise, {
-    [Symbol.asyncIterator]: async function* () {
-      yield await firstPagePromise;
-      for await (const page of { [Symbol.asyncIterator]: () => iterator }) {
-        yield page;
-      }
-    }
-  });
+  const result = await paginateBuffered(pageFunction, {
+    pageSize,
+    cursor
+  }).next();
+  return result.done ? { data: [] } : result.value;
 }
 var parseOrThrow = (schema, input, { adaptError } = {}) => {
   const result = schema.safeParse(input);
@@ -787,6 +772,13 @@ function createPaginatedFunction(coreFn, options) {
             [Symbol.asyncIterator]() {
               return pageStream;
             },
+            pages: function() {
+              return {
+                [Symbol.asyncIterator]() {
+                  return pageStream;
+                }
+              };
+            },
             items: function() {
               return {
                 [Symbol.asyncIterator]: async function* () {
@@ -5281,7 +5273,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.84.3" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.85.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -7016,6 +7008,7 @@ function transformConnectionItem(item) {
     is_private: item.is_private,
     shared_with_all: item.shared_with_all,
     title: item.title,
+    slug: item.slug,
     lastchanged: item.lastchanged,
     is_stale: item.is_stale,
     is_shared: item.is_shared,
@@ -8587,13 +8580,13 @@ var tableIdResolver = defineResolver({
   listItems: ({ imports, context, cursor }) => {
     const includeShared = context?.includeShared;
     if (includeShared) {
-      return concatPaginated({
+      return concatLists({
         sources: [
-          ({ cursor: sourceCursor }) => imports.listTablesInternal({ cursor: sourceCursor }),
-          ({ cursor: sourceCursor }) => imports.listTablesInternal({
+          ({ cursor: listCursor }) => imports.listTablesInternal({ cursor: listCursor }),
+          ({ cursor: listCursor }) => imports.listTablesInternal({
             includeShared: true,
             includePersonal: false,
-            cursor: sourceCursor
+            cursor: listCursor
           })
         ],
         cursor
@@ -10038,6 +10031,11 @@ var ConnectionItemSchema = ConnectionItemSchema$1;
 // src/formatters/connection.ts
 function formatConnectionItem(item) {
   const details = [];
+  const appKey = item.app_key ?? "unknown";
+  details.push({
+    text: item.slug ? `App: ${appKey} | App Slug: ${item.slug}` : `App: ${appKey}`,
+    style: "accent"
+  });
   if (item.identifier) {
     details.push({
       text: `Identifier: ${item.identifier}`,

package/dist/{index-B6Hbs-2p.d.mts → index-BxgeAXDh.d.mts}

@@ -62,6 +62,7 @@ declare const ConnectionItemSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     date: z.ZodString;
     is_invite_only: z.ZodBoolean;
+    slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     lastchanged: z.ZodOptional<z.ZodString>;
     destination_selected_api: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     is_private: z.ZodBoolean;
@@ -228,27 +229,43 @@ interface SdkPage<T = unknown> {
     nextCursor?: string;
 }
 /**
- * Return type of every paginated SDK method. The same value is both:
+ * Return type of every paginated SDK method. The documented surface is:
  *
- *   - a Promise that resolves to the first page (`SdkPage<TItem>`), and
- *   - an AsyncIterable that yields each page in turn,
+ *   - `await` the result for the first page (`SdkPage<TItem>`),
+ *   - `.pages()` for an AsyncIterable over pages, and
+ *   - `.items()` for an AsyncIterable over individual items across pages.
  *
- * with an `.items()` method that returns an AsyncIterable over individual
- * items across all pages. Named so paginated plugin signatures serialize
- * as `PaginatedSdkResult<AppItem>` in `.d.ts` rather than expanding the
- * full triple-intersection at every callsite.
+ * `.pages()` and `.items()` return plain iterables (not thenables), so they
+ * survive being returned from an `async` function; the result itself is a
+ * thenable, so an `async` boundary silently collapses it to the first page.
+ * Named so paginated plugin signatures serialize as
+ * `PaginatedSdkResult<AppItem>` in `.d.ts` rather than expanding the full
+ * intersection at every callsite.
  *
  * The faces share one underlying cursor, so a result is consumed once:
  *
  *   - `await` / `.then()` read the buffered first page without starting the
  *     stream, so awaiting is a repeatable peek and you can still iterate the
  *     result afterward.
- *   - The page-iterable and `.items()` are two views over one page stream, so
- *     consuming either drains the other: the second view yields nothing (it
- *     does not replay page 1). To read a result more than once, call the
- *     method again for a fresh result.
+ *   - `.pages()`, `.items()`, and the deprecated bare iteration are views
+ *     over one page stream, so consuming any view drains the others: the
+ *     second view yields nothing (it does not replay page 1). To read a
+ *     result more than once, call the method again for a fresh result.
  */
-interface PaginatedSdkResult<TItem> extends Promise<SdkPage<TItem>>, AsyncIterable<SdkPage<TItem>> {
+interface PaginatedSdkResult<TItem> extends Promise<SdkPage<TItem>> {
+    /**
+     * @deprecated Iterate `.pages()` instead. Bare iteration works but is easy
+     * to break: because the result is also a thenable, an `async` boundary
+     * collapses it to its first page and the iterable is silently lost.
+     *
+     * Deliberately no runtime deprecation warning: this face is not scheduled
+     * for deletion (removing it is a breaking change deferred to a separate
+     * decision), and structural consumers such as the CLI's page streaming
+     * detect pagination via `Symbol.asyncIterator`, so a warning would fire on
+     * the SDK's own machinery.
+     */
+    [Symbol.asyncIterator](): AsyncIterator<SdkPage<TItem>>;
+    pages(): AsyncIterable<SdkPage<TItem>>;
     items(): AsyncIterable<TItem>;
 }
 type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => PaginatedSdkResult<TItem>;
@@ -5904,6 +5921,7 @@ declare const listConnectionsPlugin: MethodPlugin<"listConnections", {
     id: string;
     account_id: string;
     title?: string | null | undefined;
+    slug?: string | null | undefined;
     lastchanged?: string | undefined;
     destination_selected_api?: string | null | undefined;
     is_stale?: string | undefined;
@@ -6152,6 +6170,7 @@ declare const getConnectionPlugin: MethodPlugin<"getConnection", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -6195,6 +6214,7 @@ declare const findFirstConnectionPlugin: MethodPlugin<"findFirstConnection", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -6246,6 +6266,7 @@ declare const findFirstConnectionPlugin: MethodPlugin<"findFirstConnection", {
     id: string;
     account_id: string;
     title?: string | null | undefined;
+    slug?: string | null | undefined;
     lastchanged?: string | undefined;
     destination_selected_api?: string | null | undefined;
     is_stale?: string | undefined;
@@ -6288,6 +6309,7 @@ declare const findUniqueConnectionPlugin: MethodPlugin<"findUniqueConnection", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -6339,6 +6361,7 @@ declare const findUniqueConnectionPlugin: MethodPlugin<"findUniqueConnection", {
     id: string;
     account_id: string;
     title?: string | null | undefined;
+    slug?: string | null | undefined;
     lastchanged?: string | undefined;
     destination_selected_api?: string | null | undefined;
     is_stale?: string | undefined;
@@ -7557,6 +7580,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -7593,6 +7617,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -7635,6 +7660,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -7677,6 +7703,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -7729,6 +7756,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -7765,6 +7793,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -7807,6 +7836,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -7849,6 +7879,7 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9092,6 +9123,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9129,6 +9161,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9172,6 +9205,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9223,6 +9257,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9265,6 +9300,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9316,6 +9352,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9368,6 +9405,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9418,6 +9456,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9455,6 +9494,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9491,6 +9531,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9534,6 +9575,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9575,6 +9617,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9626,6 +9669,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -9668,6 +9712,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9709,6 +9754,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -9760,6 +9806,7 @@ declare const zapierSdkPlugin: AggregatePlugin<"sdk", {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -11741,6 +11788,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -11777,6 +11825,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -11819,6 +11868,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -11861,6 +11911,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -11913,6 +11964,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
         id: string;
         account_id: string;
         title?: string | null | undefined;
+        slug?: string | null | undefined;
         lastchanged?: string | undefined;
         destination_selected_api?: string | null | undefined;
         is_stale?: string | undefined;
@@ -11949,6 +12001,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -11991,6 +12044,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;
@@ -12033,6 +12087,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): {
             id: string;
             account_id: string;
             title?: string | null | undefined;
+            slug?: string | null | undefined;
             lastchanged?: string | undefined;
             destination_selected_api?: string | null | undefined;
             is_stale?: string | undefined;