@elchika-inc/todoke 0.1.0

package/LICENSE

@@ -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

@@ -0,0 +1,64 @@
+# @elchika-inc/todoke
+
+TypeScript SDK for [todoke](https://todoke.dev) — the minimal Web Push notification SaaS with first-class AI (MCP) support.
+
+## Install
+
+> **Note**: `@elchika-inc/todoke` is not yet published to npm. Until it is, build it from this repository:
+>
+> ```bash
+> # after cloning the todoke monorepo
+> bun install
+> cd packages/sdk
+> bun run build   # emits dist/ (ESM + type declarations)
+> ```
+
+Once published, installation will be:
+
+```bash
+npm install @elchika-inc/todoke
+# or: bun add @elchika-inc/todoke / pnpm add @elchika-inc/todoke
+```
+
+## Quick start
+
+```typescript
+import { PushCF } from "@elchika-inc/todoke";
+
+const client = new PushCF({
+  apiKey: "pk_your_key",
+  // baseUrl: "https://api.todoke.dev" // default
+});
+
+// Subscribe (browser — requires a service worker at /sw.js)
+const registration = await navigator.serviceWorker.ready;
+await client.subscribe({ registration });
+
+// Send a notification to all active subscribers
+await client.notify({
+  title: "お知らせ",
+  body: "新しいメッセージがあります",
+  url: "https://yourapp.com/messages",
+});
+
+// Stats
+const stats = await client.getStats();
+```
+
+## API key scopes
+
+todoke issues API keys with three scopes — use the narrowest one for each surface:
+
+| Scope | Use for |
+|---|---|
+| `subscribe_only` | Safe to embed in frontend code (subscribe only) |
+| `notify` | Server-side sending |
+| `full` | Management operations |
+
+## Documentation
+
+Full guides and API reference: **https://docs.todoke.dev**
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PushCF, PushCFError } from "./push-cf.js";
+export type { NotifyPayload, PushCFOptions, Stats, SubscribeOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { PushCF, PushCFError } from "./push-cf.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/push-cf.d.ts

@@ -0,0 +1,14 @@
+import type { NotifyPayload, PushCFOptions, Stats, SubscribeOptions } from "./types.js";
+export declare class PushCF {
+    #private;
+    constructor({ apiKey, baseUrl }: PushCFOptions);
+    notify(payload: NotifyPayload): Promise<void>;
+    subscribe({ registration }: SubscribeOptions): Promise<void>;
+    getStats(): Promise<Stats>;
+}
+export declare class PushCFError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+//# sourceMappingURL=push-cf.d.ts.map

package/dist/push-cf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-cf.d.ts","sourceRoot":"","sources":["../src/push-cf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAcxF,qBAAa,MAAM;;gBAIL,EAAE,MAAM,EAAE,OAAkC,EAAE,EAAE,aAAa;IAKnE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7C,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC5D,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;CAsBjC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D"}

package/dist/push-cf.js

@@ -0,0 +1,93 @@
+function urlBase64ToUint8Array(base64Url) {
+    const pad = "=".repeat((4 - (base64Url.length % 4)) % 4);
+    const base64 = (base64Url + pad).replace(/-/g, "+").replace(/_/g, "/");
+    const raw = atob(base64);
+    const buffer = new ArrayBuffer(raw.length);
+    const out = new Uint8Array(buffer);
+    for (let i = 0; i < raw.length; i++) {
+        out[i] = raw.charCodeAt(i);
+    }
+    return out;
+}
+export class PushCF {
+    #apiKey;
+    #baseUrl;
+    constructor({ apiKey, baseUrl = "https://api.todoke.dev" }) {
+        this.#apiKey = apiKey;
+        this.#baseUrl = baseUrl.replace(/\/$/, "");
+    }
+    async notify(payload) {
+        const res = await fetch(`${this.#baseUrl}/api/v1/notify`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.#apiKey}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const body = (await res.json().catch(() => ({})));
+            throw new PushCFError(res.status, body.code ?? "UNKNOWN", body.error ?? res.statusText);
+        }
+    }
+    async subscribe({ registration }) {
+        const vapidPublicKey = await this.#fetchVapidPublicKey();
+        const subscription = await registration.pushManager.subscribe({
+            userVisibleOnly: true,
+            applicationServerKey: urlBase64ToUint8Array(vapidPublicKey),
+        });
+        const json = subscription.toJSON();
+        const keys = json.keys;
+        if (!json.endpoint || !keys?.p256dh || !keys?.auth) {
+            throw new PushCFError(0, "INVALID_SUBSCRIPTION", "PushSubscription is missing required fields");
+        }
+        const res = await fetch(`${this.#baseUrl}/api/v1/subscriptions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.#apiKey}`,
+            },
+            body: JSON.stringify({
+                endpoint: json.endpoint,
+                p256dh: keys.p256dh,
+                auth: keys.auth,
+            }),
+        });
+        if (!res.ok) {
+            const body = (await res.json().catch(() => ({})));
+            throw new PushCFError(res.status, body.code ?? "UNKNOWN", body.error ?? res.statusText);
+        }
+    }
+    async getStats() {
+        const res = await fetch(`${this.#baseUrl}/api/v1/stats`, {
+            headers: { Authorization: `Bearer ${this.#apiKey}` },
+        });
+        if (!res.ok) {
+            const body = (await res.json().catch(() => ({})));
+            throw new PushCFError(res.status, body.code ?? "UNKNOWN", body.error ?? res.statusText);
+        }
+        return res.json();
+    }
+    async #fetchVapidPublicKey() {
+        const res = await fetch(`${this.#baseUrl}/api/v1/vapid-public-key`, {
+            headers: { Authorization: `Bearer ${this.#apiKey}` },
+        });
+        if (!res.ok) {
+            const body = (await res.json().catch(() => ({})));
+            throw new PushCFError(res.status, body.code ?? "UNKNOWN", body.error ?? res.statusText);
+        }
+        const { vapidPublicKey } = (await res.json());
+        return vapidPublicKey;
+    }
+}
+export class PushCFError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = "PushCFError";
+        this.status = status;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=push-cf.js.map

package/dist/push-cf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-cf.js","sourceRoot":"","sources":["../src/push-cf.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type NotifyPayload = {
+    title: string;
+    body: string;
+    url?: string;
+    icon?: string;
+    badge?: string;
+    /** Send to a specific endpoint only; omit to broadcast */
+    endpoint?: string;
+};
+export type SubscribeOptions = {
+    /** Existing ServiceWorkerRegistration to use */
+    registration: ServiceWorkerRegistration;
+};
+export type Stats = {
+    activeSubscribers: number;
+    totalSent: number;
+    totalFailed: number;
+    totalFailedExpired: number;
+    totalFailedOther: number;
+    monthlySent: number;
+    monthlyFailed: number;
+};
+export type PushCFOptions = {
+    apiKey: string;
+    /** Defaults to "https://api.todoke.dev" */
+    baseUrl?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,YAAY,EAAE,yBAAyB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@elchika-inc/todoke",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "TypeScript SDK for todoke Web Push SaaS",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "tsc -p tsconfig.build.json"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^3.1.1"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://todoke.dev",
+  "keywords": [
+    "web-push",
+    "push-notifications",
+    "cloudflare",
+    "mcp",
+    "todoke"
+  ]
+}