@zeph-to/hook-sdk 1.3.1 → 1.4.0

package/README.md

@@ -83,6 +83,21 @@ zeph notify --title "Hello" --json
 | `--json` | Output JSON format |
 | `--version` | Print version |
 
+### Mute
+
+Notifications are silently skipped when a mute file exists for the current project:
+
+```bash
+# Mute (created by /zeph-mute in Claude Code plugin)
+HASH=$(echo -n "$PROJECT_DIR" | cksum | cut -d' ' -f1)
+touch /tmp/zeph-muted-$HASH
+
+# Unmute
+rm /tmp/zeph-muted-$HASH
+```
+
+The CLI checks `CLAUDE_PROJECT_DIR`, `CURSOR_PROJECT_DIR`, `WINDSURF_PROJECT_DIR`, and falls back to `cwd`.
+
 ### Exit Codes
 
 | Code | Meaning |

package/dist/cli.js

@@ -1,10 +1,24 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const child_process_1 = require("child_process");
 const zeph_hook_js_1 = require("./zeph-hook.js");
 const errors_js_1 = require("./errors.js");
 const installer_js_1 = require("./installer.js");
 const config_js_1 = require("./config.js");
+const PROJECT_DIR_VARS = ['CLAUDE_PROJECT_DIR', 'CURSOR_PROJECT_DIR', 'WINDSURF_PROJECT_DIR'];
+const isMuted = () => {
+    try {
+        const dir = PROJECT_DIR_VARS.reduce((found, key) => found || process.env[key], undefined) ?? process.cwd();
+        const raw = (0, child_process_1.execFileSync)('cksum', { input: dir, encoding: 'utf-8' });
+        const hash = raw.split(' ')[0];
+        return (0, fs_1.existsSync)(`/tmp/zeph-muted-${hash}`);
+    }
+    catch {
+        return false;
+    }
+};
 // ── Arg Parser ──────────────────────────────────────────────────
 const parseArgs = (argv) => {
     const result = {};
@@ -85,13 +99,13 @@ const printJson = (data) => {
 // ── Commands ────────────────────────────────────────────────────
 const createHook = (args) => {
     const config = (0, config_js_1.loadConfig)();
-    const apiKey = args.key || process.env.ZEPH_API_KEY || config.apiKey;
+    const apiKey = args.key || (0, config_js_1.resolvedEnv)('ZEPH_API_KEY') || config.apiKey;
     const isJson = args.json === true;
     if (!apiKey) {
         printError('API key required. Run "zeph install" or set ZEPH_API_KEY', isJson);
         return null;
     }
-    const baseUrl = args['base-url'] || process.env.ZEPH_BASE_URL || config.baseUrl;
+    const baseUrl = args['base-url'] || (0, config_js_1.resolvedEnv)('ZEPH_BASE_URL') || config.baseUrl;
     return new zeph_hook_js_1.ZephHook({
         apiKey,
         ...(baseUrl && { baseUrl }),
@@ -99,6 +113,8 @@ const createHook = (args) => {
 };
 const handleNotify = async (args) => {
     const isJson = args.json === true;
+    if (isMuted())
+        return 0;
     const hook = createHook(args);
     if (!hook)
         return 3;

package/dist/config.d.ts

@@ -6,6 +6,7 @@ export interface ZephConfig {
     baseUrl?: string;
     deviceId?: string;
 }
+export declare const resolvedEnv: (key: string) => string | undefined;
 export declare const loadConfig: () => ZephConfig;
 export declare const saveConfig: (config: ZephConfig) => void;
 export declare const VERSION: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAAyC,CAAC;AACjE,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,UAAU,QAAO,UAM7B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU,KAAG,IAG/C,CAAC;AAEF,eAAO,MAAM,OAAO,QAOhB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAAyC,CAAC;AACjE,eAAO,MAAM,WAAW,QAAkC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGlD,CAAC;AAEF,eAAO,MAAM,UAAU,QAAO,UAM7B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU,KAAG,IAG/C,CAAC;AAEF,eAAO,MAAM,OAAO,QAOhB,CAAC"}

package/dist/config.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = exports.saveConfig = exports.loadConfig = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
+exports.VERSION = exports.saveConfig = exports.loadConfig = exports.resolvedEnv = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 exports.CONFIG_DIR = (0, path_1.join)(process.env.HOME ?? '~', '.zeph');
 exports.CONFIG_FILE = (0, path_1.join)(exports.CONFIG_DIR, 'config.json');
+const resolvedEnv = (key) => {
+    const val = process.env[key];
+    return val && !val.startsWith('${') ? val : undefined;
+};
+exports.resolvedEnv = resolvedEnv;
 const loadConfig = () => {
     try {
         return JSON.parse((0, fs_1.readFileSync)(exports.CONFIG_FILE, 'utf-8'));

package/dist/installer.js

@@ -218,19 +218,19 @@ const handleInstall = async (args) => {
     let hookId;
     let baseUrl;
     if (nonInteractive) {
-        apiKey = installArgs.key || process.env.ZEPH_API_KEY || existing.apiKey;
-        hookId = installArgs.hook === 'none' ? undefined : (installArgs.hook || process.env.ZEPH_HOOK_ID || existing.hookId);
-        baseUrl = installArgs['base-url'] || process.env.ZEPH_BASE_URL || existing.baseUrl;
+        apiKey = installArgs.key || (0, config_js_1.resolvedEnv)('ZEPH_API_KEY') || existing.apiKey;
+        hookId = installArgs.hook === 'none' ? undefined : (installArgs.hook || (0, config_js_1.resolvedEnv)('ZEPH_HOOK_ID') || existing.hookId);
+        baseUrl = installArgs['base-url'] || (0, config_js_1.resolvedEnv)('ZEPH_BASE_URL') || existing.baseUrl;
     }
     else {
         console.log('');
-        const currentKey = process.env.ZEPH_API_KEY || existing.apiKey;
+        const currentKey = (0, config_js_1.resolvedEnv)('ZEPH_API_KEY') || existing.apiKey;
         if (currentKey) {
             console.log(`  Current API Key: ${currentKey.slice(0, 12)}...`);
         }
         const keyInput = await promptInput(currentKey ? '  New API Key (Enter to keep): ' : '  API Key (from app > Settings > API Keys): ');
         apiKey = keyInput || currentKey;
-        const currentHook = process.env.ZEPH_HOOK_ID || existing.hookId;
+        const currentHook = (0, config_js_1.resolvedEnv)('ZEPH_HOOK_ID') || existing.hookId;
         if (currentHook) {
             console.log(`  Current Hook ID: ${currentHook}`);
         }

package/dist/zeph-hook.js

@@ -46,7 +46,7 @@ class ZephHook {
         const json = await this.request('POST', '/pushes/send', {
             ...payload,
             body: preview,
-            type: 'file',
+            type: payload.type ?? 'file',
             files: [{ fileKey: upload.fileKey, fileName, fileSize, fileType }],
         });
         const pushId = json.data?.pushId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/hook-sdk",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Zeph push notification SDK + CLI — zero dependencies",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",