@arnaudjnn/billing-tools 0.14.0

package/dist/billing.js

@@ -0,0 +1,258 @@
+import Stripe from "stripe";
+// Token model: 1 token = 1 cent. Held in the Stripe customer credit balance,
+// where a negative balance = available credit. All functions keyed on a
+// stripeCustomerId are pure Stripe math (identical across host apps); the
+// customer-id pointer itself is stored by the host via the adapter.
+// One memoized Stripe client for the whole lib (lazy — never construct at
+// import; STRIPE_SECRET_KEY may be unset at module load in dev).
+let _stripe = null;
+export function getStripe() {
+    return (_stripe ??= new Stripe(process.env.STRIPE_SECRET_KEY));
+}
+export function stripeConfigured() {
+    return !!process.env.STRIPE_SECRET_KEY;
+}
+function toStripePrice(p) {
+    const product = typeof p.product === "object" && p.product && !("deleted" in p.product)
+        ? p.product
+        : null;
+    return {
+        id: p.id,
+        productId: product?.id ?? (typeof p.product === "string" ? p.product : null),
+        productName: product?.name ?? null,
+        lookupKey: p.lookup_key ?? null,
+        nickname: p.nickname ?? null,
+        unitAmount: p.unit_amount,
+        currency: p.currency,
+        interval: p.recurring?.interval ?? null,
+        intervalCount: p.recurring?.interval_count ?? null,
+    };
+}
+/** All active recurring (subscription) prices on the Stripe account. Uses the
+ *  SDK's async auto-pagination so accounts with >1 page of prices aren't
+ *  silently truncated. */
+export async function listSubscriptionPrices() {
+    const out = [];
+    for await (const p of getStripe().prices.list({
+        active: true,
+        type: "recurring",
+        limit: 100,
+        expand: ["data.product"],
+    })) {
+        out.push(toStripePrice(p));
+    }
+    return out;
+}
+/** Resolve a single subscription price without any env config. Resolution
+ *  order: explicit `priceId` → matching `lookupKey` → the sole recurring price.
+ *  Returns null if nothing matches or the choice is ambiguous (multiple prices,
+ *  no lookupKey) — the caller can then list options via listSubscriptionPrices.
+ *  The priceId/lookupKey paths query Stripe directly (no full-list scan). */
+export async function resolveSubscriptionPrice(opts = {}) {
+    const stripe = getStripe();
+    if (opts.priceId) {
+        try {
+            const p = await stripe.prices.retrieve(opts.priceId, { expand: ["product"] });
+            return p.active ? toStripePrice(p) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (opts.lookupKey) {
+        const r = await stripe.prices.list({
+            lookup_keys: [opts.lookupKey],
+            active: true,
+            limit: 1,
+            expand: ["data.product"],
+        });
+        if (r.data[0])
+            return toStripePrice(r.data[0]);
+        return null;
+    }
+    const all = await listSubscriptionPrices();
+    return all.length === 1 ? all[0] : null;
+}
+export async function getBillingCustomerId(adapter, orgId) {
+    return adapter.getBillingCustomerId(orgId);
+}
+// Idempotent: return the org's Stripe customer id, creating the customer +
+// welcome credit and persisting the pointer via the adapter on first use.
+export async function ensureStripeCustomer(adapter, orgId, email, config) {
+    const existing = await adapter.getBillingCustomerId(orgId);
+    if (existing)
+        return existing;
+    const stripe = getStripe();
+    const customer = await stripe.customers.create({
+        email,
+        metadata: { org_id: orgId },
+    });
+    if (config.freeTokens > 0) {
+        // Idempotency key so a race on first-use (two concurrent callers) can't
+        // grant the welcome bonus twice for the same org.
+        await stripe.customers.createBalanceTransaction(customer.id, {
+            amount: -config.freeTokens,
+            currency: config.currency,
+            description: `Welcome bonus: ${config.freeTokens} free tokens`,
+        }, { idempotencyKey: `welcome:${orgId}` });
+    }
+    await adapter.setBillingCustomerId(orgId, customer.id);
+    return customer.id;
+}
+export async function getTokenBalance(stripeCustomerId) {
+    const customer = await getStripe().customers.retrieve(stripeCustomerId);
+    if (customer.deleted)
+        return 0;
+    return -customer.balance; // negative balance = credit
+}
+export async function deductTokens(stripeCustomerId, toolName, cost, currency) {
+    await getStripe().customers.createBalanceTransaction(stripeCustomerId, {
+        amount: cost, // positive = debit
+        currency,
+        description: `Tool call: ${toolName} (${cost} tokens)`,
+    });
+}
+export async function creditTokens(stripeCustomerId, amount, description, currency, 
+/** Pass a stable key (e.g. the source invoice/session id) so replayed events
+ *  — a re-delivered webhook, an overlapping poll — credit exactly once. */
+idempotencyKey) {
+    await getStripe().customers.createBalanceTransaction(stripeCustomerId, {
+        amount: -amount, // negative = credit
+        currency,
+        description,
+    }, idempotencyKey ? { idempotencyKey } : undefined);
+}
+export async function createTokenCheckoutSession(stripeCustomerId, orgId, amountMajor, config) {
+    const amountMinor = Math.round(amountMajor * 100);
+    const tokens = amountMinor; // 1 token = 1 minor unit
+    const session = await getStripe().checkout.sessions.create({
+        customer: stripeCustomerId,
+        mode: "payment",
+        // No payment_method_types → Checkout auto-offers every method enabled in the
+        // Dashboard (cards + Apple Pay / Google Pay / Link), maximizing conversion.
+        line_items: [
+            {
+                price_data: {
+                    currency: config.currency,
+                    product_data: {
+                        name: `${tokens} tokens`,
+                        description: `${amountMajor} = ${tokens} tokens`,
+                    },
+                    unit_amount: amountMinor,
+                },
+                quantity: 1,
+            },
+        ],
+        invoice_creation: { enabled: true },
+        payment_intent_data: {
+            setup_future_usage: "off_session",
+            metadata: { org_id: orgId, tokens: String(tokens) },
+        },
+        metadata: { org_id: orgId, tokens: String(tokens) },
+        success_url: `${config.baseUrl}/billing/success?tokens=${tokens}`,
+        cancel_url: `${config.baseUrl}/billing/cancel`,
+    });
+    return session.url;
+}
+/** A Stripe Billing Portal session URL — the no-code self-serve surface where a
+ *  customer manages their subscription (upgrade/downgrade/cancel), updates the
+ *  payment method (fixes a failing card), and views invoices. */
+export async function createBillingPortalSession(stripeCustomerId, returnUrl) {
+    const session = await getStripe().billingPortal.sessions.create({
+        customer: stripeCustomerId,
+        return_url: returnUrl,
+    });
+    return session.url;
+}
+export async function getAutoReloadSettings(stripeCustomerId) {
+    const customer = await getStripe().customers.retrieve(stripeCustomerId);
+    if (customer.deleted)
+        return null;
+    const meta = customer.metadata;
+    if (meta.auto_reload_enabled !== "true")
+        return null;
+    return {
+        enabled: true,
+        threshold: parseInt(meta.auto_reload_threshold || "0", 10),
+        reload_to: parseInt(meta.auto_reload_to || "0", 10),
+    };
+}
+export async function setAutoReloadSettings(stripeCustomerId, threshold, reloadTo, enabled) {
+    await getStripe().customers.update(stripeCustomerId, {
+        metadata: {
+            auto_reload_enabled: String(enabled),
+            auto_reload_threshold: String(threshold),
+            auto_reload_to: String(reloadTo),
+        },
+    });
+}
+export async function tryAutoReload(stripeCustomerId, currency) {
+    const settings = await getAutoReloadSettings(stripeCustomerId);
+    if (!settings || !settings.enabled)
+        return;
+    const balance = await getTokenBalance(stripeCustomerId);
+    if (balance > settings.threshold)
+        return;
+    const tokensNeeded = settings.reload_to - balance;
+    if (tokensNeeded <= 0)
+        return;
+    const stripe = getStripe();
+    const pms = await stripe.paymentMethods.list({
+        customer: stripeCustomerId,
+        type: "card",
+        limit: 1,
+    });
+    if (pms.data.length === 0)
+        return;
+    try {
+        const pi = await stripe.paymentIntents.create({
+            amount: tokensNeeded,
+            currency,
+            customer: stripeCustomerId,
+            payment_method: pms.data[0].id,
+            off_session: true,
+            confirm: true,
+            description: `Auto-reload: ${tokensNeeded} tokens`,
+            metadata: { auto_reload: "true", tokens: String(tokensNeeded) },
+        });
+        if (pi.status === "succeeded") {
+            await creditTokens(stripeCustomerId, tokensNeeded, `Auto-reload: ${tokensNeeded} tokens`, currency);
+        }
+    }
+    catch {
+        // card declined / off-session failure — never block the triggering call
+    }
+}
+export async function listInvoices(stripeCustomerId, limit = 10) {
+    const stripe = getStripe();
+    const [invoices, charges] = await Promise.all([
+        stripe.invoices.list({ customer: stripeCustomerId, limit }),
+        stripe.charges.list({ customer: stripeCustomerId, limit }),
+    ]);
+    const invoiceEntries = invoices.data.map((inv) => ({
+        id: inv.id,
+        type: "purchase",
+        number: inv.number,
+        amount: inv.amount_paid,
+        status: inv.status,
+        created: new Date(inv.created * 1000).toISOString(),
+        invoice_url: inv.hosted_invoice_url ?? null,
+        invoice_pdf: inv.invoice_pdf ?? null,
+    }));
+    const autoReloadCharges = charges.data
+        .filter((ch) => ch.metadata?.auto_reload === "true" && ch.status === "succeeded")
+        .map((ch) => ({
+        id: ch.id,
+        type: "auto_reload",
+        number: null,
+        amount: ch.amount,
+        status: ch.status,
+        created: new Date(ch.created * 1000).toISOString(),
+        invoice_url: ch.receipt_url ?? null,
+        invoice_pdf: null,
+    }));
+    return [...invoiceEntries, ...autoReloadCharges]
+        .sort((a, b) => new Date(b.created).getTime() - new Date(a.created).getTime())
+        .slice(0, limit);
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":"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"}

package/dist/cli/client.d.ts

@@ -0,0 +1,10 @@
+export interface ApiClientConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+export declare function callTool(config: ApiClientConfig, tool: string, args?: Record<string, unknown>): Promise<unknown>;
+export declare function listTools(config: ApiClientConfig): Promise<Array<{
+    name: string;
+    cost: number;
+}>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/cli/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cli/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAOvG"}

package/dist/cli/client.js

@@ -0,0 +1,22 @@
+export async function callTool(config, tool, args = {}) {
+    const res = await fetch(`${config.baseUrl}/api/v0/${tool}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", Authorization: `Bearer ${config.apiKey}` },
+        body: JSON.stringify(args),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`${tool} failed (${res.status}): ${text}`);
+    }
+    return res.json();
+}
+export async function listTools(config) {
+    const res = await fetch(`${config.baseUrl}/api/v0`, {
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`Failed to list tools: ${res.status}`);
+    const data = (await res.json());
+    return data.tools;
+}
+//# sourceMappingURL=client.js.map

package/dist/cli/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/cli/client.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAuB,EACvB,IAAY,EACZ,OAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,WAAW,IAAI,EAAE,EAAE;QAC1D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE;QACzF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAuB;IACrD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,SAAS,EAAE;QAClD,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE;KACtD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqD,CAAC;IACpF,OAAO,IAAI,CAAC,KAAK,CAAC;AACpB,CAAC"}

package/dist/cli/commands.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import { type CliOptions } from "./config.js";
+export declare function registerBillingCommands(program: Command, opts: CliOptions): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EACL,KAAK,UAAU,EAMhB,MAAM,aAAa,CAAC;AAyBrB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,QAwEzE"}

package/dist/cli/commands.js

@@ -0,0 +1,94 @@
+import { rmSync } from "node:fs";
+import { callTool } from "./client.js";
+import { configPath, readConfig, writeConfig, resolveBaseUrl, resolveApiKey, } from "./config.js";
+function extractApiKey(result) {
+    const visit = (v) => {
+        if (typeof v === "string") {
+            const m = v.match(/sk_[A-Za-z0-9_-]+/);
+            return m ? m[0] : undefined;
+        }
+        if (v && typeof v === "object") {
+            for (const x of Object.values(v)) {
+                const found = visit(x);
+                if (found)
+                    return found;
+            }
+        }
+        return undefined;
+    };
+    return visit(result);
+}
+function print(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+// Register the shared billing commands on a commander program (or subcommand).
+// Reads global options --api-key / --url off `program`.
+export function registerBillingCommands(program, opts) {
+    const requireConfig = () => {
+        const apiKey = resolveApiKey(opts, program.opts().apiKey);
+        if (!apiKey) {
+            console.error(`Error: API key required. Run 'auth <email> --code <code>' to log in,`);
+            console.error(`or pass --api-key / set ${opts.envPrefix}_API_KEY.`);
+            process.exit(1);
+        }
+        return { baseUrl: resolveBaseUrl(opts, program.opts().url), apiKey };
+    };
+    program
+        .command("auth <email>")
+        .description("Get an API key via email + 6-digit code")
+        .option("--code <code>", "6-digit verification code from email")
+        .action(async (email, o) => {
+        const baseUrl = resolveBaseUrl(opts, program.opts().url);
+        const apiKey = resolveApiKey(opts, program.opts().apiKey) || "bootstrap";
+        const args = { email };
+        if (o.code)
+            args.code = o.code;
+        const result = await callTool({ baseUrl, apiKey }, "get_api_key", args);
+        print(result);
+        const key = extractApiKey(result);
+        if (key) {
+            writeConfig(opts, { ...readConfig(opts), apiKey: key, email, baseUrl });
+            console.error(`\n✓ Logged in as ${email}. Credentials saved to ${configPath(opts)}.`);
+        }
+    });
+    program
+        .command("logout")
+        .description("Sign out by clearing local credentials")
+        .action(() => {
+        try {
+            rmSync(configPath(opts), { force: true });
+        }
+        catch {
+            /* best effort */
+        }
+        console.log(`✓ Signed out. Removed ${configPath(opts)}.`);
+    });
+    program
+        .command("balance")
+        .description("Get current token balance and tool costs")
+        .action(async () => print(await callTool(requireConfig(), "get_token_balance")));
+    program
+        .command("buy <amount>")
+        .description("Buy tokens (returns a Stripe Checkout URL)")
+        .action(async (amount) => print(await callTool(requireConfig(), "buy_tokens", { amount: parseInt(amount, 10) })));
+    program
+        .command("invoices")
+        .description("List recent invoices")
+        .option("--limit <n>", "Number to return (default 10)", (v) => parseInt(v, 10))
+        .action(async (o) => {
+        const args = {};
+        if (o.limit)
+            args.limit = o.limit;
+        print(await callTool(requireConfig(), "list_invoices", args));
+    });
+    const keys = program.command("keys").description("List and revoke API keys");
+    keys
+        .command("list")
+        .description("List API keys")
+        .action(async () => print(await callTool(requireConfig(), "list_api_keys")));
+    keys
+        .command("revoke <id>")
+        .description("Revoke an API key by id")
+        .action(async (id) => print(await callTool(requireConfig(), "revoke_api_key", { api_key_id: id })));
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/config.d.ts

@@ -0,0 +1,16 @@
+export interface CliOptions {
+    configDir: string;
+    envPrefix: string;
+    defaultUrl: string;
+}
+export interface CliConfig {
+    apiKey?: string;
+    email?: string;
+    baseUrl?: string;
+}
+export declare function configPath(opts: CliOptions): string;
+export declare function readConfig(opts: CliOptions): CliConfig;
+export declare function writeConfig(opts: CliOptions, c: CliConfig): void;
+export declare function resolveBaseUrl(opts: CliOptions, cliUrl?: string): string;
+export declare function resolveApiKey(opts: CliOptions, cliKey?: string): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAQtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAShE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF"}

package/dist/cli/config.js

@@ -0,0 +1,40 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, isAbsolute } from "node:path";
+function expandHome(p) {
+    if (p === "~" || p.startsWith("~/"))
+        return join(homedir(), p.slice(1));
+    return isAbsolute(p) ? p : join(homedir(), p);
+}
+export function configPath(opts) {
+    return join(expandHome(opts.configDir), "config.json");
+}
+export function readConfig(opts) {
+    const p = configPath(opts);
+    if (!existsSync(p))
+        return {};
+    try {
+        return JSON.parse(readFileSync(p, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(opts, c) {
+    const p = configPath(opts);
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(c, null, 2));
+    try {
+        chmodSync(p, 0o600);
+    }
+    catch {
+        /* best effort */
+    }
+}
+export function resolveBaseUrl(opts, cliUrl) {
+    return cliUrl || process.env[`${opts.envPrefix}_API_URL`] || readConfig(opts).baseUrl || opts.defaultUrl;
+}
+export function resolveApiKey(opts, cliKey) {
+    return cliKey || process.env[`${opts.envPrefix}_API_KEY`] || readConfig(opts).apiKey;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAkBtD,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAc,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,CAAY;IACxD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,MAAe;IAC9D,OAAO,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,MAAe;IAC7D,OAAO,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACvF,CAAC"}

package/dist/create-billing.d.ts

@@ -0,0 +1,78 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BillingAdapter, BillingConfig } from "./types.js";
+import { type AgentAuthBranding, type AgentAuthPaths, type AgentAuthPolicy, type AgentIdentityType } from "./agent-auth/index.js";
+import type { ClaimStore } from "./agent-auth/claim-store.js";
+import type { PlansConfig } from "./plans.js";
+export interface CreateBillingOptions {
+    /** Storage adapter (WorkOSOrgAdapter or your own). */
+    adapter: BillingAdapter;
+    /** Billing config; resolved once internally. */
+    config: BillingConfig;
+    /** Per-tool token costs (echoed by get_token_balance + the REST tool list). */
+    toolCosts?: Record<string, number>;
+    /** WWW-Authenticate realm on 401s. */
+    realm?: string;
+    /** Declarative plans → auto-provisioned Stripe products/prices + list_plans. */
+    plans?: PlansConfig;
+    defaultPlan?: string;
+    /** Register your app's own product tools alongside the billing tools. */
+    registerTools?: (server: McpServer) => void;
+    /** Enable auth.md agent self-registration. Omit to leave it off. */
+    agentAuth?: {
+        branding: AgentAuthBranding;
+        identityTypes?: AgentIdentityType[];
+        baseUrl?: string | ((request: Request) => string);
+        policy?: AgentAuthPolicy;
+        asMetadataExtra?: Record<string, unknown>;
+        paths?: AgentAuthPaths;
+        claimStore?: ClaimStore;
+    };
+    /** Stripe webhook handler. Defaults on (currency from config); `false` to skip. */
+    webhook?: {
+        currency?: string;
+    } | false;
+    /** MCP transport overrides. */
+    mcp?: {
+        apiKeyPrefix?: string;
+        maxDuration?: number;
+    };
+}
+export declare function createBilling(opts: CreateBillingOptions): {
+    adapter: BillingAdapter;
+    config: Required<BillingConfig>;
+    register: (server: McpServer) => void;
+    dispatcher: {
+        dispatchTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+        getToolNames: () => string[];
+    };
+    /** MCP transport: mount `export const { GET, POST } = mcp` in app/[transport]/route.ts. */
+    mcp: {
+        GET: (request: Request) => Promise<Response>;
+        POST: (request: Request) => Promise<Response>;
+        maxDuration: number;
+    };
+    /** GET /api/v0 tool list handler. */
+    restList: (request: Request) => Promise<Response>;
+    /** POST /api/v0/[tool] dispatch handler. */
+    restDispatch: (request: Request, ctx: {
+        params: Promise<{
+            tool: string;
+        }>;
+    }) => Promise<Response>;
+    /** Stripe webhook POST handler (undefined if `webhook: false`). */
+    webhook: ((request: Request) => Promise<Response>) | undefined;
+    /** auth.md handlers (undefined unless `agentAuth` was configured). */
+    agentAuth: {
+        protectedResource: (request: Request) => Response;
+        authorizationServer: (request: Request) => Response;
+        authMd: (request: Request) => Response;
+        identity: (request: Request) => Promise<Response>;
+        claim: (request: Request) => Promise<Response>;
+        token: (request: Request) => Promise<Response>;
+        handleClaimGrant: (params: Record<string, string>) => Promise<Response>;
+        revoke: (request: Request) => Promise<Response>;
+        resourceMetadataUrl: (request: Request) => string;
+        wwwAuthenticate: (request: Request) => string;
+    } | undefined;
+};
+//# sourceMappingURL=create-billing.d.ts.map

package/dist/create-billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-billing.d.ts","sourceRoot":"","sources":["../src/create-billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhE,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,OAAO,EAAE,cAAc,CAAC;IACxB,gDAAgD;IAChD,MAAM,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,oEAAoE;IACpE,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACpC,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,CAAC;IACF,mFAAmF;IACnF,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACxC,+BAA+B;IAC/B,GAAG,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB;;;uBAY5B,SAAS;;;;;IAiCjC,2FAA2F;;;;;;IAE3F,qCAAqC;;IAErC,4CAA4C;;;;;;IAE5C,mEAAmE;;IAEnE,sEAAsE;;;;;;;;;;;;;EAGzE"}

package/dist/create-billing.js

@@ -0,0 +1,59 @@
+import { resolveConfig } from "./types.js";
+import { registerBillingTools } from "./tools/register.js";
+import { createDispatcher } from "./dispatch.js";
+import { createToolListHandler, createToolDispatchHandler } from "./routes/rest.js";
+import { createMcpTransport } from "./routes/mcp.js";
+import { createStripeWebhookHandler } from "./routes/webhook.js";
+import { createAgentAuth, } from "./agent-auth/index.js";
+export function createBilling(opts) {
+    const resolved = resolveConfig(opts.config);
+    const agentAuth = opts.agentAuth
+        ? createAgentAuth({ adapter: opts.adapter, config: resolved, ...opts.agentAuth })
+        : undefined;
+    const resourceMetadata = agentAuth
+        ? (request) => agentAuth.resourceMetadataUrl(request)
+        : undefined;
+    // ONE registrar used by both the dispatcher (REST shadow server) and the live
+    // MCP server, so the two surfaces expose an identical tool set.
+    const register = (server) => {
+        registerBillingTools(server, {
+            adapter: opts.adapter,
+            config: resolved,
+            toolCosts: opts.toolCosts,
+            plans: opts.plans,
+            defaultPlan: opts.defaultPlan,
+        });
+        opts.registerTools?.(server);
+    };
+    const dispatcher = createDispatcher(register);
+    const restList = createToolListHandler({ dispatcher, toolCosts: opts.toolCosts });
+    const restDispatch = createToolDispatchHandler({ dispatcher, realm: opts.realm, resourceMetadata });
+    const mcp = createMcpTransport({
+        register,
+        adapter: opts.adapter,
+        realm: opts.realm,
+        apiKeyPrefix: opts.mcp?.apiKeyPrefix,
+        maxDuration: opts.mcp?.maxDuration,
+        resourceMetadata,
+    });
+    const webhook = opts.webhook === false
+        ? undefined
+        : createStripeWebhookHandler({ currency: opts.webhook?.currency ?? resolved.currency });
+    return {
+        adapter: opts.adapter,
+        config: resolved,
+        register,
+        dispatcher,
+        /** MCP transport: mount `export const { GET, POST } = mcp` in app/[transport]/route.ts. */
+        mcp,
+        /** GET /api/v0 tool list handler. */
+        restList,
+        /** POST /api/v0/[tool] dispatch handler. */
+        restDispatch,
+        /** Stripe webhook POST handler (undefined if `webhook: false`). */
+        webhook,
+        /** auth.md handlers (undefined unless `agentAuth` was configured). */
+        agentAuth,
+    };
+}
+//# sourceMappingURL=create-billing.js.map

package/dist/create-billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-billing.js","sourceRoot":"","sources":["../src/create-billing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EACL,eAAe,GAKhB,MAAM,uBAAuB,CAAC;AAwC/B,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;QAC9B,CAAC,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACjF,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,gBAAgB,GAAG,SAAS;QAChC,CAAC,CAAC,CAAC,OAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC;QAC9D,CAAC,CAAC,SAAS,CAAC;IAEd,8EAA8E;IAC9E,gEAAgE;IAChE,MAAM,QAAQ,GAAG,CAAC,MAAiB,EAAE,EAAE;QACrC,oBAAoB,CAAC,MAAM,EAAE;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,yBAAyB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACpG,MAAM,GAAG,GAAG,kBAAkB,CAAC;QAC7B,QAAQ;QACR,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY;QACpC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW;QAClC,gBAAgB;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,KAAK,KAAK;QACpB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,0BAA0B,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE5F,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,QAAQ;QAChB,QAAQ;QACR,UAAU;QACV,2FAA2F;QAC3F,GAAG;QACH,qCAAqC;QACrC,QAAQ;QACR,4CAA4C;QAC5C,YAAY;QACZ,mEAAmE;QACnE,OAAO;QACP,sEAAsE;QACtE,SAAS;KACV,CAAC;AACJ,CAAC"}