@zeph-to/hook-sdk 0.1.1 → 0.3.0

package/README.md

@@ -1,39 +1,124 @@
-# @zeph/hook-sdk
+# @zeph-to/hook-sdk
 
 Push notification SDK + CLI for [Zeph](https://zeph.to). Zero dependencies — uses native `fetch`.
 
 ## Installation
 
 ```bash
-npm install @zeph/hook-sdk
+npm install @zeph-to/hook-sdk
+# or
+npx @zeph-to/hook-sdk notify --title "Hello"
 ```
 
+## CLI Usage
+
+```bash
+# Send a notification
+zeph notify --title "Deploy done" --body "v2.1.0 shipped"
+
+# Send with priority
+zeph notify --title "Build failed" --priority high --url https://ci.example.com/123
+
+# List recent pushes
+zeph list
+zeph list --limit 10 --type note
+
+# Dismiss a push
+zeph dismiss push_01JXY...
+zeph dismiss --all
+
+# Test connection
+zeph test
+
+# JSON output
+zeph notify --title "Hello" --json
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `notify` | Send a push notification |
+| `list` | List recent push notifications |
+| `dismiss <id>` | Dismiss a push (or `--all`) |
+| `test` | Send a test notification to verify setup |
+
+### Notify Options
+
+| Flag | Description |
+|------|-------------|
+| `--title <text>` | Push title |
+| `--body <text>` | Push body |
+| `--url <url>` | URL to include |
+| `--type <type>` | Push type: `note`, `link`, `file` |
+| `--priority <p>` | Priority: `low`, `normal`, `high`, `urgent` |
+| `--device <id>` | Target device ID |
+
+### List Options
+
+| Flag | Description |
+|------|-------------|
+| `--limit <n>` | Number of pushes (1-20, default 5) |
+| `--type <type>` | Filter by push type |
+
+### Global Options
+
+| Flag | Description |
+|------|-------------|
+| `--key <api-key>` | API key (or set `ZEPH_API_KEY` env) |
+| `--base-url <url>` | API base URL (or set `ZEPH_BASE_URL` env) |
+| `--json` | Output JSON format |
+| `--version` | Print version |
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Quota exceeded |
+| 3 | Authentication failed |
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ZEPH_API_KEY` | API key (fallback when `--key` not provided) |
+| `ZEPH_BASE_URL` | API base URL (default: `https://api.zeph.to/v1`) |
+
 ## SDK Usage
 
 ```typescript
-import { ZephHook } from '@zeph/hook-sdk';
+import { ZephHook } from '@zeph-to/hook-sdk';
 
 const hook = new ZephHook({ apiKey: 'ak_...' });
 
+// Notify
 const result = await hook.notify({
   title: 'Build Complete',
   body: 'Deploy succeeded',
   url: 'https://example.com/deploy/123',
+  priority: 'high',
 });
-
 console.log(result.pushId); // 'push_01JXY...'
-```
 
-### Options
+// List
+const list = await hook.list({ limit: 5 });
+console.log(list.pushes);
 
-```typescript
-const hook = new ZephHook({
-  apiKey: 'ak_...',          // Required — API key from Zeph settings
-  baseUrl: 'https://...',    // Optional — API base URL (default: https://api.zeph.to)
-  timeout: 30000,            // Optional — request timeout in ms (default: 30000)
-});
+// Dismiss
+await hook.dismiss('push_01JXY...');
+await hook.dismissAll();
 ```
 
+### Constructor Options
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `apiKey` | `string` | Required — API key from Zeph settings |
+| `baseUrl` | `string?` | API base URL (default: `https://api.zeph.to/v1`) |
+| `timeout` | `number?` | Request timeout in ms (default: 30000) |
+
 ### Notify Payload
 
 | Field | Type | Description |
@@ -42,12 +127,13 @@ const hook = new ZephHook({
 | `body` | `string?` | Push body |
 | `url` | `string?` | URL to include |
 | `type` | `'note' \| 'link' \| 'file'?` | Push type (default: `note`) |
+| `priority` | `'low' \| 'normal' \| 'high' \| 'urgent'?` | Priority (default: `normal`) |
 | `targetDeviceId` | `string?` | Send to specific device |
 
 ### Error Handling
 
 ```typescript
-import { ZephHook, AuthenticationError, QuotaExceededError, ZephError } from '@zeph/hook-sdk';
+import { ZephHook, AuthenticationError, QuotaExceededError, ZephError } from '@zeph-to/hook-sdk';
 
 try {
   await hook.notify({ title: 'Hello' });
@@ -58,43 +144,6 @@ try {
 }
 ```
 
-## CLI Usage
-
-```bash
-# With API key flag
-zeph notify --key ak_... --title "Deploy done" --body "v2.1.0 shipped"
-
-# With environment variable
-export ZEPH_API_KEY=ak_...
-zeph notify --title "Build failed" --url https://ci.example.com/123
-
-# JSON output
-zeph notify --title "Hello" --json
-```
-
-### CLI Options
-
-| Flag | Description |
-|------|-------------|
-| `--key <api-key>` | API key (or set `ZEPH_API_KEY` env) |
-| `--title <text>` | Push title |
-| `--body <text>` | Push body |
-| `--url <url>` | URL to include |
-| `--type <type>` | Push type: `note`, `link`, `file` |
-| `--device <id>` | Target device ID |
-| `--base-url <url>` | API base URL |
-| `--json` | Output JSON format |
-| `--version` | Print version |
-
-### Exit Codes
-
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | Quota exceeded |
-| 3 | Authentication failed |
-
 ## Requirements
 
 - Node.js >= 18 (uses native `fetch`)

package/dist/cli.js

@@ -3,9 +3,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = require("fs");
 const path_1 = require("path");
+const readline_1 = require("readline");
 const zeph_hook_js_1 = require("./zeph-hook.js");
 const errors_js_1 = require("./errors.js");
-const getVersion = () => {
+const CONFIG_DIR = (0, path_1.join)(process.env.HOME ?? '~', '.zeph');
+const CONFIG_FILE = (0, path_1.join)(CONFIG_DIR, 'config.json');
+const VERSION = (() => {
     try {
         const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf-8'));
         return pkg.version;
@@ -13,16 +16,16 @@ const getVersion = () => {
     catch {
         return '0.0.0';
     }
-};
+})();
 // ── Arg Parser ──────────────────────────────────────────────────
 const parseArgs = (argv) => {
     const result = {};
+    const positional = [];
     const args = argv.slice(2);
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (!arg.startsWith('--')) {
-            if (!result._command)
-                result._command = arg;
+            positional.push(arg);
             continue;
         }
         const key = arg.slice(2);
@@ -35,21 +38,41 @@ const parseArgs = (argv) => {
             i++;
         }
     }
+    result._command = positional[0] ?? '';
+    result._arg1 = positional[1] ?? '';
     return result;
 };
 // ── Output ──────────────────────────────────────────────────────
 const printUsage = () => {
-    console.log(`Usage: zeph notify [options]
+    console.log(`Usage: zeph <command> [options]
 
-Options:
-  --key <api-key>    API key (or set ZEPH_API_KEY env)
+Commands:
+  setup           Interactive configuration (API key, Hook ID)
+  notify          Send a push notification
+  list            List recent push notifications
+  dismiss <id>    Dismiss a push notification (or --all)
+  test            Send a test notification to verify setup
+
+Notify options:
   --title <text>     Push title
   --body <text>      Push body
   --url <url>        URL to include
   --type <type>      Push type (note|link|file) [default: note]
+  --priority <p>     Priority (low|normal|high|urgent) [default: normal]
   --device <id>      Target device ID
-  --base-url <url>   API base URL
+
+List options:
+  --limit <n>        Number of pushes (1-20, default 5)
+  --type <type>      Filter by push type
+
+Dismiss options:
+  --all              Dismiss all notifications
+
+Global options:
+  --key <api-key>    API key (or set ZEPH_API_KEY env)
+  --base-url <url>   API base URL (or set ZEPH_BASE_URL env)
   --json             Output JSON format
+  --version          Show version
 
 Environment:
   ZEPH_API_KEY       API key (fallback when --key not provided)
@@ -63,68 +86,257 @@ const printError = (message, isJson) => {
         console.error(`Error: ${message}`);
     }
 };
-const printSuccess = (pushId, isJson) => {
-    if (isJson) {
-        console.log(JSON.stringify({ pushId, status: 'ok' }));
+const printJson = (data) => {
+    console.log(JSON.stringify(data, null, 2));
+};
+const loadConfig = () => {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(CONFIG_FILE, 'utf-8'));
     }
-    else {
-        console.log(`Push sent: ${pushId}`);
+    catch {
+        return {};
     }
 };
-// ── Main ────────────────────────────────────────────────────────
-const main = async () => {
-    const args = parseArgs(process.argv);
-    const command = args._command;
+const saveConfig = (config) => {
+    (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    (0, fs_1.writeFileSync)(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n');
+};
+const prompt = (question) => {
+    const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+};
+// ── Commands ────────────────────────────────────────────────────
+const createHook = (args) => {
+    const config = loadConfig();
+    const apiKey = args.key || process.env.ZEPH_API_KEY || config.apiKey;
     const isJson = args.json === true;
-    if (args.version === true) {
-        console.log(getVersion());
-        return 0;
-    }
-    if (!command || command === 'help') {
-        printUsage();
-        return 0;
-    }
-    if (command !== 'notify') {
-        printError(`Unknown command: ${command}`, isJson);
-        printUsage();
-        return 1;
-    }
-    const apiKey = args.key || process.env.ZEPH_API_KEY;
     if (!apiKey) {
-        printError('API key required. Use --key or set ZEPH_API_KEY', isJson);
-        return 3;
+        printError('API key required. Run "zeph setup" or set ZEPH_API_KEY', isJson);
+        return null;
     }
-    const baseUrl = args['base-url'] || process.env.ZEPH_BASE_URL;
-    const hook = new zeph_hook_js_1.ZephHook({
+    const baseUrl = args['base-url'] || process.env.ZEPH_BASE_URL || config.baseUrl;
+    return new zeph_hook_js_1.ZephHook({
         apiKey,
         ...(baseUrl && { baseUrl }),
     });
+};
+const handleNotify = async (args) => {
+    const isJson = args.json === true;
+    const hook = createHook(args);
+    if (!hook)
+        return 3;
     try {
         const result = await hook.notify({
             title: args.title,
             body: args.body,
             url: args.url,
             type: args.type || undefined,
+            priority: args.priority || undefined,
             targetDeviceId: args.device,
         });
-        printSuccess(result.pushId, isJson);
+        if (isJson) {
+            printJson({ pushId: result.pushId, status: 'ok' });
+        }
+        else {
+            console.log(`Push sent: ${result.pushId}`);
+        }
         return 0;
     }
     catch (err) {
-        if (err instanceof errors_js_1.QuotaExceededError) {
-            printError(err.message, isJson);
-            return 2;
+        return handleError(err, isJson);
+    }
+};
+const handleList = async (args) => {
+    const isJson = args.json === true;
+    const hook = createHook(args);
+    if (!hook)
+        return 3;
+    try {
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const result = await hook.list({
+            limit,
+            type: args.type,
+        });
+        if (isJson) {
+            printJson(result);
         }
-        if (err instanceof errors_js_1.AuthenticationError) {
-            printError(err.message, isJson);
-            return 3;
+        else {
+            if (result.pushes.length === 0) {
+                console.log('No pushes found.');
+            }
+            else {
+                for (const p of result.pushes) {
+                    const title = p.title ?? '(no title)';
+                    const time = new Date(p.createdAt).toLocaleString();
+                    console.log(`  ${p.pushId}  [${p.type}]  ${title}  (${time})`);
+                }
+                if (result.hasMore)
+                    console.log(`  ... more available (use --limit to increase)`);
+            }
         }
-        if (err instanceof errors_js_1.ZephError) {
-            printError(err.message, isJson);
-            return 1;
+        return 0;
+    }
+    catch (err) {
+        return handleError(err, isJson);
+    }
+};
+const handleDismiss = async (args) => {
+    const isJson = args.json === true;
+    const hook = createHook(args);
+    if (!hook)
+        return 3;
+    try {
+        if (args.all === true) {
+            const result = await hook.dismissAll();
+            if (isJson) {
+                printJson({ dismissed: result.dismissed, status: 'ok' });
+            }
+            else {
+                console.log(`Dismissed ${result.dismissed} pushes.`);
+            }
+        }
+        else {
+            const pushId = args._arg1;
+            if (!pushId) {
+                printError('Push ID required. Usage: zeph dismiss <push-id> or zeph dismiss --all', isJson);
+                return 1;
+            }
+            await hook.dismiss(pushId);
+            if (isJson) {
+                printJson({ dismissed: true, pushId, status: 'ok' });
+            }
+            else {
+                console.log(`Dismissed: ${pushId}`);
+            }
+        }
+        return 0;
+    }
+    catch (err) {
+        return handleError(err, isJson);
+    }
+};
+const handleTest = async (args) => {
+    const isJson = args.json === true;
+    const hook = createHook(args);
+    if (!hook)
+        return 3;
+    try {
+        const result = await hook.notify({
+            title: 'Zeph Test',
+            body: `CLI connected successfully (v${VERSION})`,
+        });
+        if (isJson) {
+            printJson({ pushId: result.pushId, status: 'ok', message: 'Test notification sent' });
+        }
+        else {
+            console.log(`Test notification sent: ${result.pushId}`);
         }
-        printError(err instanceof Error ? err.message : 'Unknown error', isJson);
+        return 0;
+    }
+    catch (err) {
+        return handleError(err, isJson);
+    }
+};
+const handleSetup = async () => {
+    console.log('\n  Zeph Setup\n');
+    const existing = loadConfig();
+    // API Key
+    const currentKey = process.env.ZEPH_API_KEY || existing.apiKey;
+    if (currentKey) {
+        console.log(`  API Key: ${currentKey.slice(0, 12)}... (already set)`);
+    }
+    const keyInput = await prompt(currentKey
+        ? '  New API Key (Enter to keep current): '
+        : '  API Key (from Settings > API Keys): ');
+    const apiKey = keyInput || currentKey;
+    if (!apiKey) {
+        console.error('\n  Error: API key is required.');
         return 1;
     }
+    // Hook ID
+    const currentHook = process.env.ZEPH_HOOK_ID || existing.hookId;
+    if (currentHook) {
+        console.log(`  Hook ID: ${currentHook} (already set)`);
+    }
+    const hookInput = await prompt(currentHook
+        ? '  New Hook ID (Enter to keep, "none" to remove): '
+        : '  Hook ID (optional, for prompt/input): ');
+    const hookId = hookInput === 'none' ? undefined : (hookInput || currentHook);
+    // Base URL
+    const currentUrl = process.env.ZEPH_BASE_URL || existing.baseUrl;
+    const urlInput = await prompt(`  Base URL (Enter for ${currentUrl || 'https://api.zeph.to/v1'}): `);
+    const baseUrl = urlInput || currentUrl;
+    // Save config
+    const config = { apiKey, ...(hookId && { hookId }), ...(baseUrl && { baseUrl }) };
+    saveConfig(config);
+    console.log(`\n  Config saved to ${CONFIG_FILE}`);
+    // Test connection
+    console.log('  Testing connection...');
+    try {
+        const hook = new zeph_hook_js_1.ZephHook({ apiKey, ...(baseUrl && { baseUrl }) });
+        const result = await hook.notify({
+            title: 'Zeph Setup',
+            body: `CLI configured successfully (v${VERSION})`,
+        });
+        console.log(`  Test push sent: ${result.pushId}`);
+    }
+    catch (err) {
+        console.error(`  Test failed: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        console.error('  Config saved but connection failed. Check your API key.');
+        return 1;
+    }
+    console.log('\n  Done! Restart Claude Code to apply.\n');
+    return 0;
+};
+// ── Error Handler ───────────────────────────────────────────────
+const handleError = (err, isJson) => {
+    if (err instanceof errors_js_1.QuotaExceededError) {
+        printError(err.message, isJson);
+        return 2;
+    }
+    if (err instanceof errors_js_1.AuthenticationError) {
+        printError(err.message, isJson);
+        return 3;
+    }
+    if (err instanceof errors_js_1.ZephError) {
+        printError(err.message, isJson);
+        return 1;
+    }
+    printError(err instanceof Error ? err.message : 'Unknown error', isJson);
+    return 1;
+};
+// ── Main ────────────────────────────────────────────────────────
+const main = async () => {
+    const args = parseArgs(process.argv);
+    const command = args._command;
+    if (args.version === true) {
+        console.log(VERSION);
+        return 0;
+    }
+    if (!command || command === 'help') {
+        printUsage();
+        return 0;
+    }
+    switch (command) {
+        case 'setup':
+            return handleSetup();
+        case 'notify':
+            return handleNotify(args);
+        case 'list':
+            return handleList(args);
+        case 'dismiss':
+            return handleDismiss(args);
+        case 'test':
+            return handleTest(args);
+        default:
+            printError(`Unknown command: ${command}`, args.json === true);
+            printUsage();
+            return 1;
+    }
 };
 main().then((code) => process.exit(code));

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { ZephHook } from './zeph-hook.js';
 export { ZephError, AuthenticationError, QuotaExceededError } from './errors.js';
-export type { ZephOptions, NotifyPayload, NotifyResult } from './types.js';
+export type { ZephOptions, NotifyPayload, NotifyResult, ListParams, ListResult, DismissOneResult, DismissAllResult, PushItem } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -8,11 +8,34 @@ export interface NotifyPayload {
     body?: string;
     url?: string;
     type?: 'note' | 'link' | 'file';
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
     targetDeviceId?: string;
 }
 export interface NotifyResult {
     pushId: string;
 }
+export interface ListParams {
+    limit?: number;
+    type?: 'note' | 'link' | 'file' | 'clipboard' | 'hook';
+}
+export interface PushItem {
+    pushId: string;
+    type: string;
+    title?: string;
+    body?: string;
+    createdAt: string;
+}
+export interface ListResult {
+    pushes: PushItem[];
+    count: number;
+    hasMore: boolean;
+}
+export interface DismissOneResult {
+    dismissed: true;
+}
+export interface DismissAllResult {
+    dismissed: number;
+}
 export interface ApiErrorResponse {
     error: {
         code: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;CACxD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

package/dist/zeph-hook.d.ts

@@ -1,10 +1,14 @@
-import type { ZephOptions, NotifyPayload, NotifyResult } from './types.js';
+import type { ZephOptions, NotifyPayload, NotifyResult, ListParams, ListResult, DismissOneResult, DismissAllResult } from './types.js';
 export declare class ZephHook {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly timeoutMs;
     constructor(options: ZephOptions);
     notify(payload: NotifyPayload): Promise<NotifyResult>;
+    list(params?: ListParams): Promise<ListResult>;
+    dismiss(pushId: string): Promise<DismissOneResult>;
+    dismissAll(): Promise<DismissAllResult>;
+    private request;
     private parseError;
 }
 //# sourceMappingURL=zeph-hook.d.ts.map

package/dist/zeph-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zeph-hook.d.ts","sourceRoot":"","sources":["../src/zeph-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAM7F,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,WAAW;IAS1B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAqC3D,OAAO,CAAC,UAAU;CASnB"}
+{"version":3,"file":"zeph-hook.d.ts","sourceRoot":"","sources":["../src/zeph-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAY,gBAAgB,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAMnK,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,WAAW;IAS1B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IASrD,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKlD,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;YAK/B,OAAO;IAiCrB,OAAO,CAAC,UAAU;CASnB"}

package/dist/zeph-hook.js

@@ -17,17 +17,50 @@ class ZephHook {
         this.timeoutMs = options.timeout ?? DEFAULT_TIMEOUT_MS;
     }
     async notify(payload) {
+        const json = await this.request('POST', '/pushes/send', payload);
+        const pushId = json.data?.pushId;
+        if (!pushId) {
+            throw new errors_js_1.ZephError('Server returned no pushId', 'INVALID_RESPONSE', 500);
+        }
+        return { pushId };
+    }
+    async list(params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set('limit', String(params.limit));
+        if (params?.type)
+            query.set('type', params.type);
+        const qs = query.toString();
+        const json = await this.request('GET', `/pushes${qs ? `?${qs}` : ''}`);
+        const pushes = json.data.map((p) => ({
+            pushId: p.pushId,
+            type: p.type,
+            title: p.title,
+            body: p.body?.slice(0, 100),
+            createdAt: p.createdAt,
+        }));
+        return { pushes, count: pushes.length, hasMore: json.pagination?.hasMore ?? false };
+    }
+    async dismiss(pushId) {
+        await this.request('POST', `/pushes/${encodeURIComponent(pushId)}/dismiss`);
+        return { dismissed: true };
+    }
+    async dismissAll() {
+        const json = await this.request('POST', '/pushes/dismiss-all');
+        return { dismissed: json.data?.dismissed ?? 0 };
+    }
+    async request(method, path, body) {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        const headers = { 'X-API-Key': this.apiKey };
+        if (body)
+            headers['Content-Type'] = 'application/json';
         let response;
         try {
-            response = await fetch(`${this.baseUrl}/pushes/send`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    'X-API-Key': this.apiKey,
-                },
-                body: JSON.stringify(payload),
+            response = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
                 signal: controller.signal,
             });
         }
@@ -44,11 +77,7 @@ class ZephHook {
         if (!response.ok) {
             throw this.parseError(response.status, json);
         }
-        const pushId = json.data?.pushId;
-        if (!pushId) {
-            throw new errors_js_1.ZephError('Server returned no pushId', 'INVALID_RESPONSE', response.status);
-        }
-        return { pushId };
+        return json;
     }
     parseError(status, body) {
         const message = body.error?.message ?? `Request failed with status ${status}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/hook-sdk",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Zeph push notification SDK + CLI — zero dependencies",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -35,7 +35,11 @@
     "push",
     "notification",
     "cli",
-    "webhook"
+    "webhook",
+    "ai-agent",
+    "mcp",
+    "claude",
+    "devtools"
   ],
   "license": "MIT"
 }