@mailto.foo/sdk 1.0.0

package/README.md

@@ -0,0 +1,43 @@
+
+# @mailto.foo/sdk
+
+The JavaScript SDK for mailto.foo — a headless email subscription and contact form service. Drop it in via script tag or npm, hand it your publish key, and it handles bot protection and delivers only verified submissions to your dashboard.
+
+No backend code required on your end.
+
+## Installation
+
+``` bash
+npm install @mailto.foo/sdk
+```
+Or via CDN (no npm needed):
+``` html
+<script src="https://cdn.mailto.foo/sdk.js"></script>
+```
+
+## Usage
+### npm / ESM
+
+``` js
+import { MailtoWidget } from '@mailto.foo/sdk'
+
+MailtoWidget.init('pk_your_publish_key')
+```
+
+### Script tag
+
+```
+<script
+  src="https://cdn.mailto.foo/sdk.js"
+  data-key="pk_your_publish_key"
+></script>
+```
+That's it. The widget mounts, renders the bot protection challenge, and submits emails to your dashboard automatically.
+
+### Publish Key
+
+Your publish key (`pk_xxx`) is tied to your mailto.foo account and the domain you registered. It is safe to expose in frontend code — it only allows submissions, not reads.
+Get your publish key from your mailto.foo dashboard.
+
+## License
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export declare const Mailto: {
+    subscribe: (email: string) => Promise<void>;
+};

package/dist/index.js

@@ -0,0 +1,28 @@
+import Cap from "@cap.js/widget";
+const getToken = () => {
+    return new Promise((resolve, reject) => {
+        const cap = new Cap({
+            apiEndpoint: "https://captcha.mailto.foo/api/",
+        });
+        cap.solve()
+            .then((result) => {
+            cap.reset();
+            resolve(result.token);
+        })
+            .catch(reject);
+    });
+};
+export const Mailto = {
+    subscribe: async (email) => {
+        const token = await getToken();
+        const res = await fetch("https://api.mailto.foo/subscribe", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ email, token }),
+        });
+        if (!res.ok) {
+            throw new Error("Subscription failed");
+        }
+    }
+};
+//# 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,GAAG,MAAM,gBAAgB,CAAC;AAEjC,MAAM,QAAQ,GAAG,GAAoB,EAAE;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,IAAK,GAAW,CAAC;YAC3B,WAAW,EAAE,iCAAiC;SAC/C,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,EAAE;aACR,IAAI,CAAC,CAAC,MAAW,EAAE,EAAE;YACpB,GAAG,CAAC,KAAK,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;aACD,KAAK,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS,EAAE,KAAK,EAAE,KAAa,EAAiB,EAAE;QAChD,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAE/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,kCAAkC,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SACvC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mailto.foo/sdk",
+  "type": "module",
+  "description": "Headless email subscription and contact form SDK for mailto.foo",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/mailto.foo/sdk.git"
+  },
+  "homepage": "https://gitlab.com/mailto.foo/sdk.git",
+  "files": [
+    "dist/**/*"
+  ],
+  "author": "saikksub<saikksub@gmail.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "1.8.3",
+    "@changesets/cli": "^2.27.7",
+    "@total-typescript/tsconfig": "^1.0.4",
+    "typescript": "^5.5.3"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/mailto.foo/sdk/-/boards"
+  },
+  "dependencies": {
+    "@cap.js/widget": "^0.1.53"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "biome check --write ./src",
+    "workflow:check": "biome check ./src",
+    "release": "pnpm run build && changeset publish"
+  }
+}