@zapier/zapier-sdk 0.70.3 → 0.71.0

package/dist/types/sdk.js

@@ -73,7 +73,11 @@ export const BaseSdkOptionsSchema = z.object({
     approvalMode: z
         .enum(["disabled", "poll", "throw"])
         .optional()
-        .describe('Approval flow behavior. "poll" creates the approval, opens it in a browser, polls until resolved, and retries the original request. "throw" creates the approval and throws a ZapierApprovalError with the approval URL so the caller can surface it. "disabled" throws a ZapierApprovalError on approval-required responses without creating an approval. Resolution order is: explicit option, then ZAPIER_APPROVAL_MODE, then the default behavior (poll for interactive TTY, throw otherwise).'),
+        .describe('Approval flow behavior for manual approvals. "poll" creates the approval, opens it in a browser, polls until resolved, and retries the original request. "throw" creates the manual approval and throws a ZapierApprovalError with the approval URL so the caller can surface it. Server-created auto-mode approvals always poll until they reach a terminal status and retry the original request on approval, even when this option is "throw". "disabled" throws a ZapierApprovalError on approval-required responses without creating an approval. Resolution order is: explicit option, then ZAPIER_APPROVAL_MODE, then the default behavior (poll for interactive TTY, throw otherwise).'),
+    openAutoModeApprovalsInBrowser: z
+        .boolean()
+        .optional()
+        .describe("By default, auto-mode approvals do not open in a browser. Enable this option to open the approval URL and watch the approval process. Resolution order is: explicit option, then ZAPIER_OPEN_AUTO_MODE_APPROVALS_IN_BROWSER, then false."),
     // Internal
     manifestPath: z
         .string()

package/dist/utils/open-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-url.d.ts","sourceRoot":"","sources":["../../src/utils/open-url.ts"],"names":[],"mappings":"AAmBA,QAAA,MAAM,OAAO,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAgEhD,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"open-url.d.ts","sourceRoot":"","sources":["../../src/utils/open-url.ts"],"names":[],"mappings":"AAmBA,QAAA,MAAM,OAAO,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,IAAI,CAsEhD,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/utils/open-url.js

@@ -58,6 +58,13 @@ const openUrl = async (url) => {
         command = "rundll32";
         args = ["url.dll,FileProtocolHandler", target];
     }
+    else if (platform === "linux") {
+        // xdg-open hands the URL to the desktop's default handler. On a headless
+        // host it exits non-zero (no handler / no display); the `error` handler
+        // below and the caller's stderr fallback cover that case.
+        command = "xdg-open";
+        args = [target];
+    }
     else {
         throw new Error(`Unsupported platform: ${platform}`);
     }

package/dist/utils/should-open-browser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Decide whether `createConnection` should attempt to auto-open a browser
+ * tab. Used as the default for `browser: "auto"`. Callers can always force
+ * with `browser: "always"` or `browser: "never"`.
+ *
+ * Returns `false` only when we're confident the open would land somewhere
+ * the user can't act on:
+ *
+ *   1. CI — no human at the keyboard.
+ *   2. SSH session — the browser would launch on the remote host, not on
+ *      the user's local machine.
+ *   3. Headless Linux — no display server means there's nowhere for a
+ *      browser to land. (macOS / Windows are assumed to have a display.)
+ *
+ * Otherwise returns `true`. Notably this does NOT branch on `isTTY` or
+ * any agent env-var allowlist — the URL is always printed to stderr
+ * regardless, so a failed or skipped auto-open degrades gracefully to
+ * "user copies the printed URL." We bias toward opening because the cost
+ * of a false negative (user has to copy/paste) is small, while the cost
+ * of a false positive (browser opens in the wrong place) only really
+ * matters for the three scenarios above.
+ */
+export declare function shouldOpenBrowser(): boolean;
+//# sourceMappingURL=should-open-browser.d.ts.map

package/dist/utils/should-open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"should-open-browser.d.ts","sourceRoot":"","sources":["../../src/utils/should-open-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/dist/utils/should-open-browser.js

@@ -0,0 +1,55 @@
+/**
+ * Decide whether `createConnection` should attempt to auto-open a browser
+ * tab. Used as the default for `browser: "auto"`. Callers can always force
+ * with `browser: "always"` or `browser: "never"`.
+ *
+ * Returns `false` only when we're confident the open would land somewhere
+ * the user can't act on:
+ *
+ *   1. CI — no human at the keyboard.
+ *   2. SSH session — the browser would launch on the remote host, not on
+ *      the user's local machine.
+ *   3. Headless Linux — no display server means there's nowhere for a
+ *      browser to land. (macOS / Windows are assumed to have a display.)
+ *
+ * Otherwise returns `true`. Notably this does NOT branch on `isTTY` or
+ * any agent env-var allowlist — the URL is always printed to stderr
+ * regardless, so a failed or skipped auto-open degrades gracefully to
+ * "user copies the printed URL." We bias toward opening because the cost
+ * of a false negative (user has to copy/paste) is small, while the cost
+ * of a false positive (browser opens in the wrong place) only really
+ * matters for the three scenarios above.
+ */
+export function shouldOpenBrowser() {
+    if (isCiEnv())
+        return false;
+    const env = globalThis.process?.env;
+    if (env?.SSH_TTY || env?.SSH_CONNECTION)
+        return false;
+    if (globalThis.process?.platform === "linux" &&
+        !env?.DISPLAY &&
+        !env?.WAYLAND_DISPLAY) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Inlined copy of `plugins/eventEmission/utils.ts`'s `isCi()`. Inlined
+ * rather than imported so `should-open-browser.ts` (a general util) doesn't
+ * reach into a peer plugin's internals — no other `utils/` file does that.
+ * Reads `globalThis.process?.env` to match `isCi()` and the rest of the core
+ * package's universal-SDK access pattern (safe in browser bundles).
+ */
+function isCiEnv() {
+    const env = globalThis.process?.env;
+    return !!(env?.CI ||
+        env?.CONTINUOUS_INTEGRATION ||
+        env?.GITHUB_ACTIONS ||
+        env?.JENKINS_URL ||
+        env?.GITLAB_CI ||
+        env?.CIRCLECI ||
+        env?.TRAVIS ||
+        env?.BUILDKITE ||
+        env?.DRONE ||
+        env?.BITBUCKET_PIPELINES_UUID);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.70.3",
+  "version": "0.71.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",