@zapier/zapier-sdk 0.97.0 → 0.98.0

package/dist/{chunk-H24FJYFA.cjs → chunk-XZU6XQNV.cjs}

@@ -68,6 +68,13 @@ function getNegatable(schema) {
 function openEnum(values, description) {
   return zod.z.union([zod.z.enum(values), zod.z.string()]).describe(description);
 }
+var STABILITY_LEVELS = ["stable", "beta", "experimental"];
+function normalizeStability(meta) {
+  if (meta.stability !== void 0) {
+    return STABILITY_LEVELS.includes(meta.stability) ? meta.stability : "experimental";
+  }
+  return meta.experimental ? "experimental" : "stable";
+}
 function resolveCategoryDefinition(ref) {
   const def = typeof ref === "string" ? { key: ref } : ref;
   const title = def.title ?? toTitleCase(def.key);
@@ -111,6 +118,7 @@ function buildRegistry({
     return typeof rootProperty === "object" && rootProperty !== null;
   }).map((key) => {
     const m = meta[key];
+    const stability = normalizeStability(m);
     return {
       name: key,
       description: m.description,
@@ -126,7 +134,11 @@ function buildRegistry({
       ),
       resolvers: resolvers?.[key],
       formatter: formatters?.[key],
-      experimental: m.experimental,
+      stability,
+      // Deprecated derived read, literal by name: only the experimental
+      // tier reads true. Beta reads false — the "not stable" warning duty
+      // lives in `stability` and the runtime notice, not this boolean.
+      experimental: stability === "experimental",
       packages: m.packages,
       confirm: m.confirm ?? (m.type === "delete" ? "delete" : void 0),
       deprecation: m.deprecation,
@@ -211,6 +223,20 @@ function createDeprecationLogger(tag) {
   };
 }
 var { logDeprecation} = createDeprecationLogger("core");
+function createStabilityNoticeLogger(tag) {
+  const loggedNotices = /* @__PURE__ */ new Set();
+  return {
+    logStabilityNotice(message) {
+      if (loggedNotices.has(message)) return;
+      loggedNotices.add(message);
+      console.warn(`[${tag}] ${message}`);
+    },
+    resetStabilityNotices() {
+      loggedNotices.clear();
+    }
+  };
+}
+var { logStabilityNotice} = createStabilityNoticeLogger("core");
 var CORE_ERROR_SYMBOL = Symbol.for("kitcore.error");
 var CoreErrorCode = {
   Validation: "VALIDATION_ERROR",
@@ -622,6 +648,19 @@ function defaultLogDeprecation({
 }) {
   logDeprecation(`${methodName}() is deprecated. ${deprecation.message}`);
 }
+var STABILITY_NOTICE_DETAILS = {
+  beta: "Its API shape is settled, but it is not yet covered by stable-tier guarantees.",
+  experimental: "It may change shape or disappear without notice."
+};
+function defaultLogStabilityNotice({
+  methodName,
+  stability
+}) {
+  if (stability === "stable") return;
+  logStabilityNotice(
+    `${methodName}() is a ${stability} API. ${STABILITY_NOTICE_DETAILS[stability]}`
+  );
+}
 var CORE_OPTIONS_ID = "kitcore/coreOptions";
 function resolveCoreOptions(context) {
   const entry = context.plugins?.[CORE_OPTIONS_ID];
@@ -668,6 +707,18 @@ function signalDeprecation(context, methodName, getDeprecation) {
   const handler = resolveCoreOptions(context)?.logDeprecation ?? defaultLogDeprecation;
   runIsolatedObserver(() => handler(warning));
 }
+function signalStability(context, methodName, getStability) {
+  if (isInsideObserver()) return;
+  const stability = getStability?.();
+  if (!stability || stability === "stable") return;
+  const notice = {
+    type: "stability",
+    methodName,
+    stability
+  };
+  const handler = resolveCoreOptions(context)?.logStabilityNotice ?? defaultLogStabilityNotice;
+  runIsolatedObserver(() => handler(notice));
+}
 function normalizeError(error, adaptError) {
   if (error instanceof Error) return error;
   const message = typeof error === "object" && error !== null && "message" in error && typeof error.message === "string" ? error.message : String(error);
@@ -681,7 +732,7 @@ function normalizeError(error, adaptError) {
   );
 }
 function createFunction(coreFn, options) {
-  const { sdk, schema, name, annotator, getDeprecation } = options;
+  const { sdk, schema, name, annotator, getDeprecation, getStability } = options;
   const functionName = name || coreFn.name;
   const namedFunctions = {
     [functionName]: async function(callOptions) {
@@ -689,6 +740,7 @@ function createFunction(coreFn, options) {
       const context = resolveCallContext(internal);
       if (!isCallContext(internal) && internal !== INTERNAL_CALL) {
         signalDeprecation(sdk.context, functionName, getDeprecation);
+        signalStability(sdk.context, functionName, getStability);
       }
       return runInMethodScope(async () => {
         const startTime = Date.now();
@@ -755,12 +807,21 @@ function createFunction(coreFn, options) {
   return namedFunctions[functionName];
 }
 function createRawFunction(coreFn, options) {
-  const { sdk, name, schema, positional, annotator, getDeprecation } = options;
+  const {
+    sdk,
+    name,
+    schema,
+    positional,
+    annotator,
+    getDeprecation,
+    getStability
+  } = options;
   return function(rawInput) {
     const internal = arguments[1];
     const context = resolveCallContext(internal);
     if (!isCallContext(internal) && internal !== INTERNAL_CALL) {
       signalDeprecation(sdk.context, name, getDeprecation);
+      signalStability(sdk.context, name, getStability);
     }
     return runInMethodScope(() => {
       const startTime = Date.now();
@@ -866,7 +927,8 @@ function createPaginatedFunction(coreFn, options) {
     adaptPage,
     annotator,
     finalizePage,
-    getDeprecation
+    getDeprecation,
+    getStability
   } = options;
   const pageFunction = createPageFunction(coreFn, {
     sdk,
@@ -880,6 +942,7 @@ function createPaginatedFunction(coreFn, options) {
       const context = resolveCallContext(internal);
       if (!isCallContext(internal) && internal !== INTERNAL_CALL) {
         signalDeprecation(sdk.context, functionName, getDeprecation);
+        signalStability(sdk.context, functionName, getStability);
       }
       return runInMethodScope(() => {
         const startTime = Date.now();
@@ -1318,6 +1381,7 @@ var LEAF_META_KEYS = [
   "returnType",
   "outputSchema",
   "packages",
+  "stability",
   "experimental",
   "confirm",
   "deprecation",
@@ -2543,7 +2607,8 @@ function buildMethodEntries(descriptors, context, states) {
           // (item mode's sibling); dropped paths surface as `[].x` in the page's
           // `meta`, unioned across items.
           finalizePage: (page) => applyListOutputPolicy(page, outputPolicy()),
-          getDeprecation: () => entry.meta?.deprecation
+          getDeprecation: () => entry.meta?.deprecation,
+          getStability: () => entry.meta ? normalizeStability(entry.meta) : void 0
         }
       );
     } else if (out.type === "item") {
@@ -2555,7 +2620,8 @@ function buildMethodEntries(descriptors, context, states) {
           schema: descriptor.inputSchema,
           name: descriptor.name,
           annotator: boundAnnotator,
-          getDeprecation: () => entry.meta?.deprecation
+          getDeprecation: () => entry.meta?.deprecation,
+          getStability: () => entry.meta ? normalizeStability(entry.meta) : void 0
         }
       );
     } else {
@@ -2569,8 +2635,10 @@ function buildMethodEntries(descriptors, context, states) {
           annotator: boundAnnotator,
           // The boundary reads the deprecation LIVE off the entry, so a
           // deprecation merged after build (defineMethodOverride, addPlugin)
-          // fires too.
-          getDeprecation: () => entry.meta?.deprecation
+          // fires too. Same for the stability level, normalized from the
+          // entry meta (declared level or legacy `experimental` boolean).
+          getDeprecation: () => entry.meta?.deprecation,
+          getStability: () => entry.meta ? normalizeStability(entry.meta) : void 0
         }
       );
     }
@@ -6514,7 +6582,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.97.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.98.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -6911,11 +6979,16 @@ var ZapierApiClient = class {
         if (!approvalContext) {
           return { response };
         }
+        const askStatementIdsHeader = response.headers.get(
+          "x-zapier-ask-statement-ids"
+        );
+        const askStatementIds = askStatementIdsHeader ? JSON.parse(askStatementIdsHeader) : void 0;
         try {
           await this.runOneApprovalRound(
             approvalContext,
             approvalMode,
-            init?.signal ?? void 0
+            init?.signal ?? void 0,
+            askStatementIds
           );
         } catch (error) {
           return { response, approvalRoundError: error };
@@ -7518,7 +7591,7 @@ var ZapierApiClient = class {
    * Caller is responsible for passing a non-"disabled" mode; this method
    * unconditionally creates an approval.
    */
-  async runOneApprovalRound(buildContext, mode, signal) {
+  async runOneApprovalRound(buildContext, mode, signal, askStatementIds) {
     const context = buildContext();
     let approvalResponse;
     try {
@@ -7528,7 +7601,10 @@ var ZapierApiClient = class {
           "Content-Type": "application/json",
           Accept: "application/json"
         },
-        body: JSON.stringify({ context }),
+        body: JSON.stringify({
+          context,
+          ...askStatementIds?.length ? { ask_statement_ids: askStatementIds } : {}
+        }),
         signal
       });
     } catch (err) {
@@ -11856,14 +11932,24 @@ var ListConnectionsQuerySchema = connections.ListConnectionsQuerySchema.omit({
   includeShared: zod.z.boolean().optional().describe(
     "Include connections shared with you. By default, only your own connections are returned (owner=me). Set to true to also include shared connections."
   ),
-  /** @deprecated Use `expired` instead */
+  // Filters on connection expiry. Not a mirror of a server-side status
+  // field: the API expresses this as the is_expired filter, which we send as
+  // false for "active", true for "expired", and omit for "all".
+  status: zod.z.enum(["active", "expired", "all"]).optional().describe(
+    "Filter connections by expiry: 'active' (default) returns only non-expired connections, 'expired' only expired ones, and 'all' returns both."
+  ),
+  /** @deprecated Use `status` instead */
   isExpired: zod.z.boolean().optional().describe("Filter by expired status").meta({
     deprecated: true,
-    deprecationMessage: "Use --expired instead to show only expired connections."
+    deprecationMessage: "Use --status expired instead to show only expired connections, or --status all for both."
   }),
+  /** @deprecated Use `status` instead */
   expired: zod.z.boolean().optional().describe(
     "Show only expired connections (default: only non-expired connections are returned)"
-  ),
+  ).meta({
+    deprecated: true,
+    deprecationMessage: "Use --status expired instead to show only expired connections, or --status all for both."
+  }),
   // Override pageSize to make optional
   pageSize: zod.z.number().min(1).optional().describe("Number of connections per page"),
   // SDK specific property for pagination/iterable helpers
@@ -11989,10 +12075,15 @@ var listConnectionsPlugin = defineMethod({
     if (owner) {
       searchParams.owner = owner;
     }
-    if (input.isExpired !== void 0) {
-      searchParams.is_expired = input.isExpired.toString();
-    } else {
-      searchParams.is_expired = (input.expired ?? false).toString();
+    const expiredFilter = input.isExpired ?? input.expired;
+    if (input.status !== void 0 && expiredFilter !== void 0) {
+      throw new ZapierValidationError(
+        'The "status" option replaces "expired" and "isExpired", so it cannot be combined with either.'
+      );
+    }
+    const status = input.status ?? (expiredFilter ? "expired" : "active");
+    if (status !== "all") {
+      searchParams.is_expired = (status === "expired").toString();
     }
     if (input.cursor) {
       searchParams.offset = input.cursor;