@zapier/zapier-sdk 1.0.0 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @zapier/zapier-sdk
 
+## 1.0.3
+
+### Patch Changes
+
+- e393401: Adds CLAUDE.md documentation files to the zapier-sdk and zapier-sdk-cli packages to help users get up to speed faster when using AI assistants like Claude, Cursor, etc.
+
+## 1.0.2
+
+### Patch Changes
+
+- 00ef417: Resolved confusing "Failed to read manifest from .zapierrc" error
+
+## 1.0.1
+
+### Patch Changes
+
+- aba842a: Updated docs to remove reference to deprecated token option.
+
 ## 1.0.0
 
 ### Minor Changes

package/README.md

@@ -69,12 +69,21 @@ npx zapier-sdk add slack google-sheets --types-output ./types
 import { createZapierSdk } from "@zapier/zapier-sdk";
 
 // ######## Initialize Zapier SDK ########
-// Running `zapier-sdk login` authenticates through your browser, automatically handling token management
+// Option 1: Running `zapier-sdk login` authenticates through your browser,
+// automatically handling token management.
 const zapier = createZapierSdk();
 
-// Option 2: Manually provide a token
+// Option 2: Manually provide a token.
 // const zapier = createZapierSdk({
-//   token: "your_zapier_token_here", // or use ZAPIER_TOKEN env var
+//   credentials: "your_zapier_token_here", // or use ZAPIER_CREDENTIALS env var
+// });
+
+// Option 3: Manually provide a client ID and client secret.
+// const zapier = createZapierSdk({
+//   credentials: {
+//     clientId: "your_client_id_here", // or use ZAPIER_CREDENTIALS_CLIENT_ID env var
+//     clientSecret: "your_client_secret_here", // or use ZAPIER_CREDENTIALS_CLIENT_SECRET env var
+//   },
 // });
 
 // ######## Access Apps ########

package/dist/index.cjs

@@ -2759,8 +2759,11 @@ async function readManifestFromFile(filePath) {
     const resolvedPath = await resolve(filePath);
     const content = await readFile(resolvedPath);
     return parseManifestContent(content, resolvedPath);
-  } catch {
-    console.warn(`\u26A0\uFE0F Failed to read manifest from ${filePath}`);
+  } catch (error) {
+    const isFileNotFound = error && typeof error === "object" && "code" in error && error.code === "ENOENT" || error instanceof Error && error.message.includes("File not found");
+    if (!isFileNotFound) {
+      console.warn(`\u26A0\uFE0F Failed to read manifest from ${filePath}`);
+    }
     return null;
   }
 }
@@ -4751,7 +4754,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "1.0.0"};
+  version: "1.0.3"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {

package/dist/index.mjs

@@ -2737,8 +2737,11 @@ async function readManifestFromFile(filePath) {
     const resolvedPath = await resolve(filePath);
     const content = await readFile(resolvedPath);
     return parseManifestContent(content, resolvedPath);
-  } catch {
-    console.warn(`\u26A0\uFE0F Failed to read manifest from ${filePath}`);
+  } catch (error) {
+    const isFileNotFound = error && typeof error === "object" && "code" in error && error.code === "ENOENT" || error instanceof Error && error.message.includes("File not found");
+    if (!isFileNotFound) {
+      console.warn(`\u26A0\uFE0F Failed to read manifest from ${filePath}`);
+    }
     return null;
   }
 }
@@ -4729,7 +4732,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "1.0.0"};
+  version: "1.0.3"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {

package/dist/plugins/manifest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/index.ts"],"names":[],"mappings":"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"}

package/dist/plugins/manifest/index.js

@@ -35,8 +35,16 @@ export async function readManifestFromFile(filePath) {
         const content = await readFile(resolvedPath);
         return parseManifestContent(content, resolvedPath);
     }
-    catch {
-        console.warn(`⚠️ Failed to read manifest from ${filePath}`);
+    catch (error) {
+        // Silently return null for "file not found" errors (expected for first-time users)
+        const isFileNotFound = (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT") ||
+            (error instanceof Error && error.message.includes("File not found"));
+        if (!isFileNotFound) {
+            console.warn(`⚠️ Failed to read manifest from ${filePath}`);
+        }
         return null;
     }
 }

package/dist/plugins/manifest/index.test.js

@@ -247,14 +247,35 @@ describe("manifestPlugin", () => {
             expect(mockResolve).toHaveBeenCalledWith("manifest.json");
             expect(mockReadFile).toHaveBeenCalledWith("/resolved/manifest.json");
         });
-        it("should handle file read errors gracefully", async () => {
-            mockReadFile.mockRejectedValue(new Error("File not found"));
+        it("should silently return null when file does not exist (ENOENT)", async () => {
+            const enoentError = Object.assign(new Error("ENOENT: no such file"), {
+                code: "ENOENT",
+            });
+            mockReadFile.mockRejectedValue(enoentError);
             const sdk = createTestSdk({ manifestPath: "nonexistent.json" });
             const context = sdk.getContext();
             // Trigger file loading by calling a function
             await context.getVersionedImplementationId("slack");
-            // Verify file loading errors are handled gracefully
-            expect(console.warn).toHaveBeenCalledWith(expect.stringContaining("Failed to read manifest from nonexistent.json"));
+            // Verify no warning is logged when file simply doesn't exist
+            expect(console.warn).not.toHaveBeenCalled();
+        });
+        it("should silently return null when file does not exist (browser fallback)", async () => {
+            mockReadFile.mockRejectedValue(new Error("File not found: /some/path"));
+            const sdk = createTestSdk({ manifestPath: "nonexistent.json" });
+            const context = sdk.getContext();
+            // Trigger file loading by calling a function
+            await context.getVersionedImplementationId("slack");
+            // Verify no warning is logged when file simply doesn't exist
+            expect(console.warn).not.toHaveBeenCalled();
+        });
+        it("should handle file read errors gracefully", async () => {
+            mockReadFile.mockRejectedValue(new Error("Permission denied"));
+            const sdk = createTestSdk({ manifestPath: "protected.json" });
+            const context = sdk.getContext();
+            // Trigger file loading by calling a function
+            await context.getVersionedImplementationId("slack");
+            // Verify file loading errors (other than file not found) are logged
+            expect(console.warn).toHaveBeenCalledWith(expect.stringContaining("Failed to read manifest from protected.json"));
         });
         it("should handle invalid JSON gracefully", async () => {
             mockReadFile.mockResolvedValue("invalid json content");
@@ -558,10 +579,29 @@ describe("readManifestFromFile", () => {
             },
         });
     });
-    it("should handle file read errors", async () => {
-        mockReadFile.mockRejectedValue(new Error("File not found"));
+    it("should return null without warning when file does not exist (ENOENT)", async () => {
+        vi.spyOn(console, "warn").mockImplementation(() => { });
+        const enoentError = Object.assign(new Error("ENOENT: no such file"), {
+            code: "ENOENT",
+        });
+        mockReadFile.mockRejectedValue(enoentError);
+        const result = await readManifestFromFile("nonexistent.json");
+        expect(result).toBeNull();
+        expect(console.warn).not.toHaveBeenCalled();
+    });
+    it("should return null without warning when file does not exist (browser fallback)", async () => {
+        vi.spyOn(console, "warn").mockImplementation(() => { });
+        mockReadFile.mockRejectedValue(new Error("File not found: /some/path"));
         const result = await readManifestFromFile("nonexistent.json");
         expect(result).toBeNull();
+        expect(console.warn).not.toHaveBeenCalled();
+    });
+    it("should handle file read errors with warning", async () => {
+        vi.spyOn(console, "warn").mockImplementation(() => { });
+        mockReadFile.mockRejectedValue(new Error("Permission denied"));
+        const result = await readManifestFromFile("protected.json");
+        expect(result).toBeNull();
+        expect(console.warn).toHaveBeenCalledWith(expect.stringContaining("Failed to read manifest from protected.json"));
     });
     it("should handle invalid JSON content", async () => {
         mockReadFile.mockResolvedValue("invalid json");

package/package.json

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