npm - @elchika-inc/todoke-cli - Versions diffs - 0.1.0 - Mend

@elchika-inc/todoke-cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 todoke
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md ADDED Viewed

@@ -0,0 +1,61 @@
+# @elchika-inc/todoke-cli
+Command-line interface for [todoke](https://todoke.dev) — the minimal Web Push notification SaaS with first-class AI (MCP) support.
+Manage your apps, API keys, and send Web Push notifications from the terminal.
+## Install
+> **Note**: `@elchika-inc/todoke-cli` is not yet published to npm. Until it is, build it from this repository:
+>
+> ```bash
+> # after cloning the todoke monorepo
+> bun install
+> cd apps/cli
+> bun run build   # emits dist/
+> ```
+Once published:
+```bash
+npm install -g @elchika-inc/todoke-cli
+# or run without installing
+npx @elchika-inc/todoke-cli --help
+```
+## Getting started
+Authenticate with a **full**-scope API key (create one from the [dashboard](https://todoke.dev) or `todoke keys add`):
+```bash
+todoke login --api-key pk_xxxxxxxx
+```
+Credentials are stored in `~/.todoke.json` (file mode `0600`). Point at a different backend with `--api-url` (defaults to `https://api.todoke.dev`).
+## Commands
+| Command | Description |
+|---------|-------------|
+| `todoke login --api-key <key> [--api-url <url>]` | Save an API key and log in (a `full`-scope key is required) |
+| `todoke logout` | Remove saved credentials |
+| `todoke apps list` | List your apps |
+| `todoke apps stats <app-id>` | Show delivery stats for an app |
+| `todoke apps delete <app-id>` | Delete an app |
+| `todoke keys list <app-id>` | List an app's API keys |
+| `todoke keys add <app-id> -n <name> [-s <scope>]` | Create an API key (`scope`: `subscribe_only` / `notify` / `full`, default `notify`) |
+| `todoke keys rm <app-id> <key-id>` | Delete an API key |
+| `todoke notify -t <title> -b <body> [-u <url>] [-e <endpoint>]` | Send a Web Push notification to the logged-in key's app (omit `-e` to broadcast to all subscribers) |
+Run `todoke <command> --help` for full option details.
+## Example
+```bash
+# Send a broadcast notification to every subscriber of the logged-in key's app
+todoke notify -t "Deploy complete" -b "v1.2.0 is live" -u https://example.com/changelog
+```
+## License
+MIT — see [LICENSE](./LICENSE).

package/dist/index.js ADDED Viewed

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+import chalk from "chalk";
+import { Command } from "commander";
+import ora from "ora";
+import { apiRequest, CONFIG_PATH, DEFAULT_API_URL, deleteConfig, loadConfig, saveConfig, } from "./lib.js";
+function getConfig() {
+    const config = loadConfig();
+    if (!config) {
+        console.error(chalk.red("ログインしていません。`todoke login --api-key <key>` を実行してください。"));
+        process.exit(1);
+    }
+    return config;
+}
+function handleError(spinner, message) {
+    spinner.fail(message);
+    process.exitCode = 1;
+}
+const program = new Command();
+program.name("todoke").description("todoke CLI — Web Push通知SaaS").version("0.1.0");
+// login
+program
+    .command("login")
+    .description("API キーを保存してログイン（full スコープのキーが必要）")
+    .requiredOption("--api-key <key>", "API キー (pk_ で始まる文字列、full スコープ)")
+    .option("--api-url <url>", "API URL", DEFAULT_API_URL)
+    .action(async (opts) => {
+    const spinner = ora("接続を確認中...").start();
+    const config = { apiKey: opts.apiKey, apiUrl: opts.apiUrl };
+    const res = await apiRequest(config, "/api/v1/apps");
+    if (!res.ok) {
+        if (res.status === 403) {
+            handleError(spinner, "このAPIキーのスコープではログインできません。full スコープのAPIキーをダッシュボードで発行して使用してください。");
+        }
+        else {
+            handleError(spinner, `認証に失敗しました: ${res.message}`);
+        }
+        return;
+    }
+    saveConfig(config);
+    spinner.succeed(chalk.green(`ログインしました。設定を ${CONFIG_PATH} に保存しました。`));
+});
+// logout
+program
+    .command("logout")
+    .description("保存した認証情報を削除")
+    .action(() => {
+    if (deleteConfig()) {
+        console.log(chalk.green("ログアウトしました。"));
+    }
+    else {
+        console.log(chalk.gray("ログインしていません。"));
+    }
+});
+// apps
+const appsCmd = program.command("apps").description("アプリ管理");
+appsCmd
+    .command("list")
+    .description("アプリ一覧を表示")
+    .action(async () => {
+    const spinner = ora("取得中...").start();
+    const res = await apiRequest(getConfig(), "/api/v1/apps");
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.stop();
+    if (res.data.length === 0) {
+        console.log(chalk.gray("アプリがありません。"));
+        return;
+    }
+    console.log(chalk.bold(`\nアプリ一覧 (${res.data.length}件)\n`));
+    for (const app of res.data) {
+        console.log(`  ${chalk.bold(app.name)}  ${chalk.gray(app.id)}`);
+    }
+});
+appsCmd
+    .command("stats <app-id>")
+    .description("アプリの統計を表示")
+    .action(async (appId) => {
+    const spinner = ora("取得中...").start();
+    const res = await apiRequest(getConfig(), `/api/v1/apps/${appId}/stats`);
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.stop();
+    const { activeSubscribers, totalSent, totalFailed, monthlySent } = res.data;
+    console.log(`\n  アクティブ購読者: ${chalk.bold(activeSubscribers)}`);
+    console.log(`  総送信数:         ${chalk.bold(totalSent)}`);
+    console.log(`  失敗数:           ${chalk.bold(totalFailed)}`);
+    console.log(`  今月の配信成功数: ${chalk.bold(monthlySent)}\n`);
+});
+appsCmd
+    .command("delete <app-id>")
+    .description("アプリを削除")
+    .action(async (appId) => {
+    const spinner = ora("削除中...").start();
+    const res = await apiRequest(getConfig(), `/api/v1/apps/${appId}`, { method: "DELETE" });
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.succeed("削除しました。");
+});
+// keys
+const keysCmd = program.command("keys").description("APIキー管理");
+keysCmd
+    .command("list <app-id>")
+    .description("APIキー一覧を表示")
+    .action(async (appId) => {
+    const spinner = ora("取得中...").start();
+    const res = await apiRequest(getConfig(), `/api/v1/apps/${appId}/keys`);
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.stop();
+    if (res.data.length === 0) {
+        console.log(chalk.gray("APIキーがありません。"));
+        return;
+    }
+    console.log(chalk.bold(`\nAPIキー一覧 (${res.data.length}件)\n`));
+    for (const key of res.data) {
+        const lastUsed = key.last_used_at
+            ? new Date(key.last_used_at).toLocaleString("ja-JP")
+            : chalk.gray("未使用");
+        console.log(`  ${chalk.bold(key.name)}  ${chalk.cyan(key.scope)}  最終使用: ${lastUsed}`);
+        console.log(`    ${chalk.gray(key.id)}`);
+    }
+});
+keysCmd
+    .command("add <app-id>")
+    .description("APIキーを作成")
+    .requiredOption("-n, --name <name>", "キー名")
+    .option("-s, --scope <scope>", "スコープ (subscribe_only/notify/full)", "notify")
+    .action(async (appId, opts) => {
+    const spinner = ora("作成中...").start();
+    const res = await apiRequest(getConfig(), `/api/v1/apps/${appId}/keys`, {
+        method: "POST",
+        body: JSON.stringify({ name: opts.name, scope: opts.scope }),
+    });
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.succeed(`作成しました: ${chalk.bold(res.data.name)} (${chalk.cyan(res.data.scope)})`);
+    if (res.data.key) {
+        console.log(chalk.yellow(`\n  APIキー: ${chalk.bold(res.data.key)}`));
+        console.log(chalk.dim("  ※ このキーは一度しか表示されません。必ずコピーしてください。\n"));
+    }
+});
+keysCmd
+    .command("rm <app-id> <key-id>")
+    .description("APIキーを削除")
+    .action(async (appId, keyId) => {
+    const spinner = ora("削除中...").start();
+    const res = await apiRequest(getConfig(), `/api/v1/apps/${appId}/keys/${keyId}`, {
+        method: "DELETE",
+    });
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.succeed("削除しました。");
+});
+// notify
+// 送信先アプリは API キーから導出される（/api/v1/notify は URL に appId を取らない）。
+// app-id を位置引数に取ると「別アプリ ID を渡してもキー所属アプリへ黙って送る」
+// silent misrouting を招くため、引数は取らない。
+program
+    .command("notify")
+    .description("Push通知を送信（送信先はログイン中の API キーのアプリ）")
+    .requiredOption("-t, --title <title>", "通知タイトル")
+    .requiredOption("-b, --body <body>", "通知本文")
+    .option("-u, --url <url>", "クリック時のURL")
+    .option("-e, --endpoint <endpoint>", "特定の購読者のエンドポイント")
+    .action(async (opts) => {
+    const spinner = ora("送信中...").start();
+    const payload = { title: opts.title, body: opts.body };
+    if (opts.url)
+        payload.url = opts.url;
+    if (opts.endpoint)
+        payload.endpoint = opts.endpoint;
+    const res = await apiRequest(getConfig(), "/api/v1/notify", {
+        method: "POST",
+        body: JSON.stringify(payload),
+    });
+    if (!res.ok) {
+        handleError(spinner, res.message);
+        return;
+    }
+    spinner.succeed(`通知を送信しました: "${chalk.bold(opts.title)}"`);
+});
+program.parse();

package/dist/lib.js ADDED Viewed

@@ -0,0 +1,51 @@
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const CONFIG_PATH = join(homedir(), ".todoke.json");
+export const DEFAULT_API_URL = "https://api.todoke.dev";
+export function loadConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            typeof parsed.apiKey !== "string" ||
+            typeof parsed.apiUrl !== "string")
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveConfig(config) {
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
+}
+export function deleteConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return false;
+    try {
+        unlinkSync(CONFIG_PATH);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function apiRequest(config, path, init = {}) {
+    const res = await fetch(`${config.apiUrl}${path}`, {
+        ...init,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${config.apiKey}`,
+            ...init.headers,
+        },
+    });
+    if (!res.ok) {
+        const body = (await res.json().catch(() => ({})));
+        return { ok: false, status: res.status, message: body.error ?? res.statusText };
+    }
+    const data = (await res.json());
+    return { ok: true, data };
+}

package/package.json ADDED Viewed

@@ -0,0 +1,42 @@
+{
+  "name": "@elchika-inc/todoke-cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for todoke — the minimal Web Push notification SaaS",
+  "bin": {
+    "todoke": "./dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.2"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://todoke.dev",
+  "keywords": [
+    "web-push",
+    "push-notifications",
+    "cloudflare",
+    "cli",
+    "todoke"
+  ]
+}