@hookflo/tern 2.0.2-experimental.0 → 2.0.3-experimental.0

package/README.md

@@ -496,3 +496,53 @@ MIT License - see [LICENSE](./LICENSE) for details.
 - [Framework Summary](./FRAMEWORK_SUMMARY.md)
 - [Architecture Guide](./ARCHITECTURE.md)
 - [Issues](https://github.com/Hookflo/tern/issues)
+
+
+## Troubleshooting
+
+### `Module not found: Can't resolve "@hookflo/tern/nextjs"`
+
+If this happens in a Next.js project, it usually means one of these:
+
+1. You installed an older published package version that does not include subpath exports yet.
+2. Lockfile still points to an old tarball/version.
+3. `node_modules` cache is stale after upgrading.
+
+Fix steps:
+
+```bash
+# in your Next.js app
+npm i @hookflo/tern@latest
+rm -rf node_modules package-lock.json .next
+npm i
+```
+
+Then verify resolution:
+
+```bash
+node -e "console.log(require.resolve('@hookflo/tern/nextjs'))"
+```
+
+If you are testing this repo locally before publish:
+
+```bash
+# inside /workspace/tern
+npm run build
+npm pack
+
+# inside your other project
+npm i /path/to/hookflo-tern-<version>.tgz
+```
+
+Minimal Next.js App Router usage:
+
+```ts
+import { createWebhookHandler } from '@hookflo/tern/nextjs';
+
+export const POST = createWebhookHandler({
+  platform: 'stripe',
+  secret: process.env.STRIPE_WEBHOOK_SECRET!,
+  handler: async (payload) => ({ received: true, event: payload.event ?? payload.type }),
+});
+```
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hookflo/tern",
-  "version": "2.0.2-experimental.0",
+  "version": "2.0.3-experimental.0",
   "description": "A robust, scalable webhook verification framework supporting multiple platforms and signature algorithms",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -73,20 +73,45 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./express": {
+      "types": "./dist/express.d.ts",
       "require": "./dist/express.js",
-      "types": "./dist/express.d.ts"
+      "import": "./dist/express.js",
+      "default": "./dist/express.js"
     },
     "./nextjs": {
+      "types": "./dist/nextjs.d.ts",
       "require": "./dist/nextjs.js",
-      "types": "./dist/nextjs.d.ts"
+      "import": "./dist/nextjs.js",
+      "default": "./dist/nextjs.js"
     },
     "./cloudflare": {
+      "types": "./dist/cloudflare.d.ts",
       "require": "./dist/cloudflare.js",
-      "types": "./dist/cloudflare.d.ts"
+      "import": "./dist/cloudflare.js",
+      "default": "./dist/cloudflare.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "express": [
+        "dist/express.d.ts"
+      ],
+      "nextjs": [
+        "dist/nextjs.d.ts"
+      ],
+      "cloudflare": [
+        "dist/cloudflare.d.ts"
+      ],
+      "*": [
+        "dist/index.d.ts"
+      ]
     }
   }
 }