@dodopayments/opencode-plugin 0.6.1 → 0.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dodopayments/opencode-plugin",
-    "version": "0.6.1",
+    "version": "0.6.3",
     "description": "Dodo Payments agent skills and MCP servers for OpenCode.",
     "type": "module",
     "main": "opencode-plugin/index.js",

package/skills/billing-sdk/SKILL.md

@@ -77,7 +77,8 @@ From the current official registry, grouped by purpose:
 
 Most blocks have a published usage example and props table on their page at
 [billingsdk.com/docs/components](https://billingsdk.com/docs/components) (for example `subscription-management`
-and `billing-settings`); `pricing-table-one` is reproduced below. The generated file's props type is still
+and `billing-settings`); `pricing-table-one` is reproduced in
+[references/pricing-page.md](references/pricing-page.md). The generated file's props type is still
 authoritative for the version you installed, so read it after running `add`.
 
 ## Server client
@@ -103,200 +104,14 @@ are `https://test.dodopayments.com` and `https://live.dodopayments.com`.
 
 ## Pricing page
 
-### 1. Plan catalogue
+Full guide: [references/pricing-page.md](references/pricing-page.md).
 
-`pricing-table-one` takes BillingSDK's `Plan[]`, not an arbitrary shape. Adding the component generates
-`lib/billingsdk-config.ts`, which exports the `Plan` interface and a sample `plans` array — edit that array
-rather than defining your own type. Prices are display **strings** (`monthlyPrice`, `yearlyPrice`) and
-`features` are objects. The amount actually charged comes from the Dodo product catalogue (always in the
-smallest currency unit), so treat this file as a mirror of the dashboard and reconcile it when you change a
-price.
+Covers:
 
-```typescript
-// lib/billingsdk-config.ts (generated by `add pricing-table-one`; edit the plans)
-export interface Plan {
-  id: string;
-  title: string;
-  description: string;
-  highlight?: boolean;
-  type?: 'monthly' | 'yearly';
-  currency?: string;
-  monthlyPrice: string;
-  yearlyPrice: string;
-  buttonText: string;
-  badge?: string;
-  features: {
-    name: string;
-    icon: string;
-    iconColor?: string;
-  }[];
-}
-
-export const plans: Plan[] = [
-  {
-    id: 'starter',
-    title: 'Starter',
-    description: 'For individuals getting started.',
-    currency: '$',
-    monthlyPrice: '9',
-    yearlyPrice: '90',
-    buttonText: 'Choose Starter',
-    features: [
-      { name: '100 requests', icon: 'check' },
-      { name: 'Basic support', icon: 'check' },
-      { name: '1 project', icon: 'check' },
-    ],
-  },
-  {
-    id: 'pro',
-    title: 'Pro',
-    description: 'For teams running in production.',
-    currency: '$',
-    monthlyPrice: '29',
-    yearlyPrice: '290',
-    buttonText: 'Choose Pro',
-    badge: 'Most popular',
-    highlight: true,
-    features: [
-      { name: 'Unlimited requests', icon: 'check' },
-      { name: 'Priority support', icon: 'check' },
-      { name: '10 projects', icon: 'check' },
-    ],
-  },
-];
-```
-
-The generated file is the contract for your installed version; if its `Plan` differs from the above, follow
-the file. `onPlanSelect` receives only the plan `id`, so the ids here are the slugs the server maps below.
-
-This example sells **monthly plans only**: `yearlyPrice` is required by the `Plan` type and is displayed,
-but the server map below has only monthly products. To sell yearly too, create the yearly products in Dodo,
-track the table's billing-period toggle in your own state (it is not passed to `onPlanSelect`), send it with
-the plan id, and key the server map by plan and period (for example `pro:yearly`).
-
-### 2. Product id map — server only
-
-Never let the browser choose an arbitrary `product_id`. Map the public plan slug to a `pdt_` id on the
-server and reject anything else.
-
-```typescript
-// lib/plan-products.server.ts
-import 'server-only';
-
-// Keys must match the `id`s in lib/billingsdk-config.ts.
-const PRODUCT_IDS: Readonly<Record<string, string>> = {
-  starter: 'pdt_starter_monthly',
-  pro: 'pdt_pro_monthly',
-};
-
-export function productIdForPlan(value: unknown): string | null {
-  if (typeof value !== 'string' || !Object.hasOwn(PRODUCT_IDS, value)) return null;
-  return PRODUCT_IDS[value];
-}
-```
-
-### 3. Checkout route
-
-```typescript
-// app/api/checkout/route.ts
-import { NextResponse } from 'next/server';
-import { dodo } from '@/lib/dodopayments';
-import { productIdForPlan } from '@/lib/plan-products.server';
-import { getCurrentUser } from '@/lib/auth';
-
-export async function POST(request: Request) {
-  const user = await getCurrentUser();
-  if (!user) {
-    return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
-  }
-
-  const body: unknown = await request.json();
-  const planId = (body as { planId?: unknown }).planId;
-  const productId = productIdForPlan(planId);
-
-  if (!productId) {
-    return NextResponse.json({ error: 'Unknown plan' }, { status: 400 });
-  }
-
-  try {
-    const session = await dodo.checkoutSessions.create({
-      product_cart: [{ product_id: productId, quantity: 1 }],
-      customer: { email: user.email, name: user.name },
-      return_url: `${process.env.NEXT_PUBLIC_APP_URL}/billing/return`,
-      cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing`,
-      metadata: { app_user_id: user.id },
-    });
-
-    if (!session.checkout_url) {
-      return NextResponse.json({ error: 'No checkout URL returned' }, { status: 502 });
-    }
-
-    return NextResponse.json({ checkoutUrl: session.checkout_url });
-  } catch (error) {
-    console.error('Checkout session creation failed', error);
-    return NextResponse.json({ error: 'Could not start checkout' }, { status: 500 });
-  }
-}
-```
-
-`checkout_url` is nullable — it is absent when the session is created with `payment_method_id` — so guard
-it rather than redirecting to `undefined`. Checkout URLs are single-use and normally expire after 24 hours.
-
-Use `checkoutSessions.create`. `payments.create` and `subscriptions.create` are deprecated for new
-integrations. Checkout parameters are covered in depth in the `checkout-integration` skill.
-
-### 4. Client component
-
-```tsx
-// components/pricing-plans.tsx
-'use client';
-
-import { useState } from 'react';
-import { PricingTableOne } from '@/components/billingsdk/pricing-table-one';
-import { plans } from '@/lib/billingsdk-config';
-
-export function PricingPlans() {
-  const [error, setError] = useState<string | null>(null);
-
-  async function handlePlanSelect(planId: string) {
-    setError(null);
-    try {
-      const response = await fetch('/api/checkout', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ planId }),
-      });
-
-      if (!response.ok) {
-        setError('Could not start checkout. Please try again.');
-        return;
-      }
-
-      const { checkoutUrl } = (await response.json()) as { checkoutUrl: string };
-      window.location.href = checkoutUrl;
-    } catch {
-      setError('Network error. Please try again.');
-    }
-  }
-
-  return (
-    <>
-      <PricingTableOne
-        plans={plans}
-        title="Choose your plan"
-        description="Select the plan that works best for you"
-        onPlanSelect={handlePlanSelect}
-        theme="classic"
-        size="medium"
-      />
-      {error ? <p role="alert">{error}</p> : null}
-    </>
-  );
-}
-```
-
-Render `<PricingPlans />` from `app/pricing/page.tsx`. Nothing secret crosses into the client component:
-it sends a plan slug and receives a URL.
+- Plan catalogue
+- Product id map — server only
+- Checkout route
+- Client component
 
 ## Subscription management and customer portal
 

package/skills/billing-sdk/references/pricing-page.md

@@ -0,0 +1,197 @@
+# BillingSDK: Pricing page
+
+
+### 1. Plan catalogue
+
+`pricing-table-one` takes BillingSDK's `Plan[]`, not an arbitrary shape. Adding the component generates
+`lib/billingsdk-config.ts`, which exports the `Plan` interface and a sample `plans` array — edit that array
+rather than defining your own type. Prices are display **strings** (`monthlyPrice`, `yearlyPrice`) and
+`features` are objects. The amount actually charged comes from the Dodo product catalogue (always in the
+smallest currency unit), so treat this file as a mirror of the dashboard and reconcile it when you change a
+price.
+
+```typescript
+// lib/billingsdk-config.ts (generated by `add pricing-table-one`; edit the plans)
+export interface Plan {
+  id: string;
+  title: string;
+  description: string;
+  highlight?: boolean;
+  type?: 'monthly' | 'yearly';
+  currency?: string;
+  monthlyPrice: string;
+  yearlyPrice: string;
+  buttonText: string;
+  badge?: string;
+  features: {
+    name: string;
+    icon: string;
+    iconColor?: string;
+  }[];
+}
+
+export const plans: Plan[] = [
+  {
+    id: 'starter',
+    title: 'Starter',
+    description: 'For individuals getting started.',
+    currency: '$',
+    monthlyPrice: '9',
+    yearlyPrice: '90',
+    buttonText: 'Choose Starter',
+    features: [
+      { name: '100 requests', icon: 'check' },
+      { name: 'Basic support', icon: 'check' },
+      { name: '1 project', icon: 'check' },
+    ],
+  },
+  {
+    id: 'pro',
+    title: 'Pro',
+    description: 'For teams running in production.',
+    currency: '$',
+    monthlyPrice: '29',
+    yearlyPrice: '290',
+    buttonText: 'Choose Pro',
+    badge: 'Most popular',
+    highlight: true,
+    features: [
+      { name: 'Unlimited requests', icon: 'check' },
+      { name: 'Priority support', icon: 'check' },
+      { name: '10 projects', icon: 'check' },
+    ],
+  },
+];
+```
+
+The generated file is the contract for your installed version; if its `Plan` differs from the above, follow
+the file. `onPlanSelect` receives only the plan `id`, so the ids here are the slugs the server maps below.
+
+This example sells **monthly plans only**: `yearlyPrice` is required by the `Plan` type and is displayed,
+but the server map below has only monthly products. To sell yearly too, create the yearly products in Dodo,
+track the table's billing-period toggle in your own state (it is not passed to `onPlanSelect`), send it with
+the plan id, and key the server map by plan and period (for example `pro:yearly`).
+
+### 2. Product id map — server only
+
+Never let the browser choose an arbitrary `product_id`. Map the public plan slug to a `pdt_` id on the
+server and reject anything else.
+
+```typescript
+// lib/plan-products.server.ts
+import 'server-only';
+
+// Keys must match the `id`s in lib/billingsdk-config.ts.
+const PRODUCT_IDS: Readonly<Record<string, string>> = {
+  starter: 'pdt_starter_monthly',
+  pro: 'pdt_pro_monthly',
+};
+
+export function productIdForPlan(value: unknown): string | null {
+  if (typeof value !== 'string' || !Object.hasOwn(PRODUCT_IDS, value)) return null;
+  return PRODUCT_IDS[value];
+}
+```
+
+### 3. Checkout route
+
+```typescript
+// app/api/checkout/route.ts
+import { NextResponse } from 'next/server';
+import { dodo } from '@/lib/dodopayments';
+import { productIdForPlan } from '@/lib/plan-products.server';
+import { getCurrentUser } from '@/lib/auth';
+
+export async function POST(request: Request) {
+  const user = await getCurrentUser();
+  if (!user) {
+    return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
+  }
+
+  const body: unknown = await request.json();
+  const planId = (body as { planId?: unknown }).planId;
+  const productId = productIdForPlan(planId);
+
+  if (!productId) {
+    return NextResponse.json({ error: 'Unknown plan' }, { status: 400 });
+  }
+
+  try {
+    const session = await dodo.checkoutSessions.create({
+      product_cart: [{ product_id: productId, quantity: 1 }],
+      customer: { email: user.email, name: user.name },
+      return_url: `${process.env.NEXT_PUBLIC_APP_URL}/billing/return`,
+      cancel_url: `${process.env.NEXT_PUBLIC_APP_URL}/pricing`,
+      metadata: { app_user_id: user.id },
+    });
+
+    if (!session.checkout_url) {
+      return NextResponse.json({ error: 'No checkout URL returned' }, { status: 502 });
+    }
+
+    return NextResponse.json({ checkoutUrl: session.checkout_url });
+  } catch (error) {
+    console.error('Checkout session creation failed', error);
+    return NextResponse.json({ error: 'Could not start checkout' }, { status: 500 });
+  }
+}
+```
+
+`checkout_url` is nullable — it is absent when the session is created with `payment_method_id` — so guard
+it rather than redirecting to `undefined`. Checkout URLs are single-use and normally expire after 24 hours.
+
+Use `checkoutSessions.create`. `payments.create` and `subscriptions.create` are deprecated for new
+integrations. Checkout parameters are covered in depth in the `checkout-integration` skill.
+
+### 4. Client component
+
+```tsx
+// components/pricing-plans.tsx
+'use client';
+
+import { useState } from 'react';
+import { PricingTableOne } from '@/components/billingsdk/pricing-table-one';
+import { plans } from '@/lib/billingsdk-config';
+
+export function PricingPlans() {
+  const [error, setError] = useState<string | null>(null);
+
+  async function handlePlanSelect(planId: string) {
+    setError(null);
+    try {
+      const response = await fetch('/api/checkout', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ planId }),
+      });
+
+      if (!response.ok) {
+        setError('Could not start checkout. Please try again.');
+        return;
+      }
+
+      const { checkoutUrl } = (await response.json()) as { checkoutUrl: string };
+      window.location.href = checkoutUrl;
+    } catch {
+      setError('Network error. Please try again.');
+    }
+  }
+
+  return (
+    <>
+      <PricingTableOne
+        plans={plans}
+        title="Choose your plan"
+        description="Select the plan that works best for you"
+        onPlanSelect={handlePlanSelect}
+        theme="classic"
+        size="medium"
+      />
+      {error ? <p role="alert">{error}</p> : null}
+    </>
+  );
+}
+```
+
+Render `<PricingPlans />` from `app/pricing/page.tsx`. Nothing secret crosses into the client component:
+it sends a plan slug and receives a URL.