@happ-cli/nextjs 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @happ/nextjs — Next.js App Router adapter for the Happ feature entitlement platform.
+ *
+ * Extends @happ/sdk with gate() and withFeature() that return NextResponse,
+ * so route handlers stay clean and framework-idiomatic.
+ *
+ * Quickstart:
+ *
+ *   // src/lib/happ.ts
+ *   import { createHappClient } from "@happ/nextjs"
+ *   export const happ = createHappClient()  // reads HAPP_API_URL + HAPP_API_KEY from env
+ *
+ *   // app/api/invoices/route.ts
+ *   import { happ } from "@/lib/happ"
+ *
+ *   export async function POST(req: Request) {
+ *     const session = await auth()
+ *     if (!session?.user?.id) return NextResponse.json({ error: "Unauthorized" }, { status: 401 })
+ *
+ *     const { customerId, items } = await req.json()
+ *
+ *     return happ.withFeature("invoices", session.user.id, async () => {
+ *       const invoice = await prisma.invoice.create({ ... })
+ *       return NextResponse.json(invoice)
+ *     }, { metered: true })
+ *   }
+ */
+import { NextResponse } from "next/server";
+import { HappClient, HappClientOptions } from "@happ-cli/sdk";
+/**
+ * Discriminated union returned by gate().
+ * TypeScript narrows the shape automatically after the allowed check.
+ */
+export type GateResult = {
+    allowed: true;
+    effectiveSubscriberId: string;
+} | {
+    allowed: false;
+    response: NextResponse;
+};
+export declare class HappNextjsClient extends HappClient {
+    /**
+     * Evaluate a feature gate and return either the entitlement or a ready-made 403 response.
+     *
+     *   const gate = await happ.gate("invoices", userId)
+     *   if (!gate.allowed) return gate.response
+     *   // gate.effectiveSubscriberId is available here
+     */
+    gate(featureKey: string, subscriberId: string): Promise<GateResult>;
+    /**
+     * Gate a feature, run an action, and (for metered features) auto-increment usage.
+     * The action only runs if the gate passes. Increment only fires on a successful response.
+     *
+     *   // Boolean feature — no increment
+     *   return happ.withFeature("duplicate-invoice", userId, async () => {
+     *     return NextResponse.json(duplicate)
+     *   })
+     *
+     *   // Metered feature — auto-increments after success
+     *   return happ.withFeature("invoices", userId, async () => {
+     *     return NextResponse.json(invoice)
+     *   }, { metered: true })
+     */
+    withFeature(featureKey: string, subscriberId: string, fn: () => Promise<Response>, options?: {
+        metered?: boolean;
+    }): Promise<Response>;
+}
+/** Create a Happ Next.js client. Options default to HAPP_API_URL and HAPP_API_KEY env vars. */
+export declare function createHappClient(options?: HappClientOptions): HappNextjsClient;
+export type { HappClientOptions, EvalResult } from "@happ-cli/sdk";
+export { DENIAL_MESSAGES } from "@happ-cli/sdk";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAmB,MAAM,eAAe,CAAA;AAI9E;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAE,qBAAqB,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAAA;AAI9C,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBzE;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAClC,OAAO,CAAC,QAAQ,CAAC;CAYrB;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAE9E;AAGD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,84 @@
+/**
+ * @happ/nextjs — Next.js App Router adapter for the Happ feature entitlement platform.
+ *
+ * Extends @happ/sdk with gate() and withFeature() that return NextResponse,
+ * so route handlers stay clean and framework-idiomatic.
+ *
+ * Quickstart:
+ *
+ *   // src/lib/happ.ts
+ *   import { createHappClient } from "@happ/nextjs"
+ *   export const happ = createHappClient()  // reads HAPP_API_URL + HAPP_API_KEY from env
+ *
+ *   // app/api/invoices/route.ts
+ *   import { happ } from "@/lib/happ"
+ *
+ *   export async function POST(req: Request) {
+ *     const session = await auth()
+ *     if (!session?.user?.id) return NextResponse.json({ error: "Unauthorized" }, { status: 401 })
+ *
+ *     const { customerId, items } = await req.json()
+ *
+ *     return happ.withFeature("invoices", session.user.id, async () => {
+ *       const invoice = await prisma.invoice.create({ ... })
+ *       return NextResponse.json(invoice)
+ *     }, { metered: true })
+ *   }
+ */
+import { NextResponse } from "next/server";
+import { HappClient, DENIAL_MESSAGES } from "@happ-cli/sdk";
+// ─── Client ───────────────────────────────────────────────────────────────────
+export class HappNextjsClient extends HappClient {
+    /**
+     * Evaluate a feature gate and return either the entitlement or a ready-made 403 response.
+     *
+     *   const gate = await happ.gate("invoices", userId)
+     *   if (!gate.allowed) return gate.response
+     *   // gate.effectiveSubscriberId is available here
+     */
+    async gate(featureKey, subscriberId) {
+        const result = await this.eval(featureKey, subscriberId);
+        if (!result.allowed) {
+            const message = DENIAL_MESSAGES[result.reason ?? ""] ??
+                `Access denied (${result.reason ?? "unknown"})`;
+            return {
+                allowed: false,
+                response: NextResponse.json({ error: message }, { status: 403 }),
+            };
+        }
+        return {
+            allowed: true,
+            effectiveSubscriberId: result.effectiveSubscriberId ?? subscriberId,
+        };
+    }
+    /**
+     * Gate a feature, run an action, and (for metered features) auto-increment usage.
+     * The action only runs if the gate passes. Increment only fires on a successful response.
+     *
+     *   // Boolean feature — no increment
+     *   return happ.withFeature("duplicate-invoice", userId, async () => {
+     *     return NextResponse.json(duplicate)
+     *   })
+     *
+     *   // Metered feature — auto-increments after success
+     *   return happ.withFeature("invoices", userId, async () => {
+     *     return NextResponse.json(invoice)
+     *   }, { metered: true })
+     */
+    async withFeature(featureKey, subscriberId, fn, options = {}) {
+        const gate = await this.gate(featureKey, subscriberId);
+        if (!gate.allowed)
+            return gate.response;
+        const response = await fn();
+        if (options.metered && response.status < 400) {
+            await this.increment(featureKey, gate.effectiveSubscriberId);
+        }
+        return response;
+    }
+}
+/** Create a Happ Next.js client. Options default to HAPP_API_URL and HAPP_API_KEY env vars. */
+export function createHappClient(options) {
+    return new HappNextjsClient(options);
+}
+export { DENIAL_MESSAGES } from "@happ-cli/sdk";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAqB,eAAe,EAAE,MAAM,eAAe,CAAA;AAY9E,iFAAiF;AAEjF,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC9C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,YAAoB;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GACX,eAAe,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;gBACpC,kBAAkB,MAAM,CAAC,MAAM,IAAI,SAAS,GAAG,CAAA;YACjD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;aACjE,CAAA;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,YAAY;SACpE,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,WAAW,CACf,UAAkB,EAClB,YAAoB,EACpB,EAA2B,EAC3B,UAAiC,EAAE;QAEnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAA;QAEvC,MAAM,QAAQ,GAAG,MAAM,EAAE,EAAE,CAAA;QAE3B,IAAI,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAA;QAC9D,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAED,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAA;AACtC,CAAC;AAID,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@happ-cli/nextjs",
+  "version": "0.1.0",
+  "description": "Happ feature entitlement SDK — Next.js App Router adapter",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@happ-cli/sdk": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=14"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "next": "^15.0.0",
+    "typescript": "^5.4.5"
+  }
+}