groundmail-clerk 0.0.0-stage → 0.14.1

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# groundmail-clerk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Deliver [Clerk](https://clerk.com) auth emails through [Groundmail](https://groundmail.dev) when you disable **Delivered by Clerk**.
+
+Clerk has no custom SMTP form — turn off delivery per template, listen for `email.created`, and send with Groundmail.
+
+## Install
+
+```bash
+npm install groundmail-clerk groundmail
+```
+
+```bash
+GROUNDMAIL_API_KEY=gm_your_key_here
+GROUNDMAIL_FROM_EMAIL=noreply@yourdomain.com
+```
+
+## Usage
+
+```ts
+import { verifyWebhook } from '@clerk/nextjs/webhooks'
+import { createClerkEmailDeliverer } from 'groundmail-clerk'
+
+const deliver = createClerkEmailDeliverer({
+  from: process.env.GROUNDMAIL_FROM_EMAIL!,
+  // apiKey: process.env.GROUNDMAIL_API_KEY,
+})
+
+export async function POST(req: Request) {
+  const evt = await verifyWebhook(req)
+  if (evt.type === 'email.created') {
+    await deliver(evt.data)
+  }
+  return new Response('ok')
+}
+```
+
+Also available as `import { createClerkEmailDeliverer } from 'groundmail/clerk'`.
+
+## Docs
+
+https://docs.groundmail.dev/guides/clerk
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { ClerkEmailCreatedData, GroundmailClerkOptions, createClerkEmailDeliverer, deliverClerkEmail } from 'groundmail/clerk';

package/dist/index.js

@@ -0,0 +1,9 @@
+// src/index.ts
+import {
+  createClerkEmailDeliverer,
+  deliverClerkEmail
+} from "groundmail/clerk";
+export {
+  createClerkEmailDeliverer,
+  deliverClerkEmail
+};

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "groundmail-clerk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.14.1",
+  "description": "Deliver Clerk email.created webhooks through Groundmail transactional email",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Groundmail/groundmail-clerk.git"
+  },
+  "homepage": "https://docs.groundmail.dev/guides/clerk",
+  "bugs": {
+    "url": "https://github.com/Groundmail/groundmail-clerk/issues"
+  },
+  "keywords": [
+    "clerk",
+    "clerk-auth",
+    "email",
+    "webhook",
+    "transactional",
+    "groundmail",
+    "authentication"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "groundmail": ">=0.13.0"
+  },
+  "devDependencies": {
+    "groundmail": "0.14.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  }
+}