@arnaudjnn/billing-tools 0.14.0

package/dist/dispatch.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare class ToolValidationError extends Error {
+}
+export type RegisterFn = (server: McpServer) => void;
+export declare function createDispatcher(register: RegisterFn): {
+    dispatchTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    getToolNames: () => string[];
+};
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAOjD,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAErD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU;yBA6BjB,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,OAAO,CAAC;wBAiCjE,MAAM,EAAE;EAMlC"}

package/dist/dispatch.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export class ToolValidationError extends Error {
+}
+export function createDispatcher(register) {
+    let handlers = null;
+    function init() {
+        if (handlers)
+            return;
+        const map = new Map();
+        const server = new McpServer({ name: "rest-dispatch", version: "0.0.0" });
+        const origTool = server.tool.bind(server);
+        server.tool = function (...args) {
+            const name = args[0];
+            const cb = args[args.length - 1];
+            let validator = null;
+            const shape = args.length >= 4 ? args[2] : null;
+            if (shape && typeof shape === "object" && !Array.isArray(shape)) {
+                try {
+                    validator = z.object(shape);
+                }
+                catch {
+                    validator = null;
+                }
+            }
+            if (typeof cb === "function" && typeof name === "string") {
+                map.set(name, { cb: cb, validator });
+            }
+            return origTool(...args);
+        };
+        register(server);
+        handlers = map;
+    }
+    async function dispatchTool(name, args) {
+        init();
+        const entry = handlers.get(name);
+        if (!entry)
+            throw new Error(`Unknown tool: ${name}`);
+        if (args && typeof args === "object") {
+            args = Object.fromEntries(Object.entries(args).filter(([, v]) => v !== null && v !== undefined));
+        }
+        let callArgs = args;
+        if (entry.validator) {
+            const parsed = entry.validator.safeParse(args ?? {});
+            if (!parsed.success) {
+                const detail = parsed.error.issues
+                    .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+                    .join("; ");
+                throw new ToolValidationError(`Invalid arguments for ${name}: ${detail}`);
+            }
+            callArgs = parsed.data;
+        }
+        const extra = { _meta: {}, sendNotification: async () => { } };
+        const result = await entry.cb(callArgs, extra);
+        if (result?.isError)
+            throw new Error(result.content?.[0]?.text || "Tool error");
+        const text = result?.content?.[0]?.text;
+        if (!text)
+            return result;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    function getToolNames() {
+        init();
+        return Array.from(handlers.keys());
+    }
+    return { dispatchTool, getToolNames };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,26 @@
+import type Stripe from "stripe";
+export interface PollResult {
+    cursor: string | null;
+    count: number;
+}
+/** Poll Stripe events newer than `after` (last processed event id), oldest
+ *  first. No `after` → baseline to the newest event, process nothing. */
+export declare function pollStripeEvents(opts: {
+    after?: string | null;
+    types?: string[];
+    onEvent: (event: Stripe.Event) => Promise<void>;
+    maxPerPoll?: number;
+}): Promise<PollResult>;
+/** Poll WorkOS events of the given types newer than `after`, oldest first.
+ *  No `after` → baseline to the newest event, process nothing. */
+export declare function pollWorkOSEvents(opts: {
+    after?: string | null;
+    events: string[];
+    onEvent: (event: {
+        id: string;
+        event: string;
+        data: unknown;
+    }) => Promise<void>;
+    maxPerPoll?: number;
+}): Promise<PollResult>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAejC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;yEACyE;AACzE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBtB;AAED;kEACkE;AAClE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsCtB"}

package/dist/events.js

@@ -0,0 +1,72 @@
+import { getStripe } from "./billing.js";
+import { getWorkOS } from "./workos.js";
+/** Poll Stripe events newer than `after` (last processed event id), oldest
+ *  first. No `after` → baseline to the newest event, process nothing. */
+export async function pollStripeEvents(opts) {
+    const stripe = getStripe();
+    const listParams = { limit: 100, ...(opts.types ? { types: opts.types } : {}) };
+    if (!opts.after) {
+        const latest = await stripe.events.list({ ...listParams, limit: 1 });
+        return { cursor: latest.data[0]?.id ?? null, count: 0 };
+    }
+    const max = opts.maxPerPoll ?? 500;
+    const fresh = [];
+    for await (const event of stripe.events.list(listParams)) {
+        if (event.id === opts.after)
+            break; // caught up
+        fresh.push(event);
+        if (fresh.length >= max)
+            break;
+    }
+    fresh.reverse(); // oldest → newest
+    for (const event of fresh)
+        await opts.onEvent(event);
+    return {
+        cursor: fresh.length ? fresh[fresh.length - 1].id : opts.after,
+        count: fresh.length,
+    };
+}
+/** Poll WorkOS events of the given types newer than `after`, oldest first.
+ *  No `after` → baseline to the newest event, process nothing. */
+export async function pollWorkOSEvents(opts) {
+    const wos = getWorkOS();
+    // WorkOS requires the event-name filter (narrow to the SDK's EventName union).
+    const events = opts.events;
+    const page = (after) => wos.events.listEvents({ events, order: "asc", limit: 100, ...(after ? { after } : {}) });
+    // Baseline (no cursor): page ascending to the very end and take the last id
+    // WITHOUT processing. (WorkOS's `order:desc` isn't reliable for "newest", so
+    // we walk forward to the end rather than trust a single desc query.)
+    // NOTE: listEvents returns a plain List (not an AutoPaginatable), so this
+    // manual walk is required — see the AGENTS.md "deliberate exceptions".
+    if (!opts.after) {
+        let cursor = null;
+        for (;;) {
+            const { data } = await page(cursor ?? undefined);
+            if (data.length === 0)
+                break;
+            cursor = data[data.length - 1].id;
+            if (data.length < 100)
+                break;
+        }
+        return { cursor, count: 0 };
+    }
+    const max = opts.maxPerPoll ?? 500;
+    let cursor = opts.after;
+    let count = 0;
+    for (;;) {
+        const { data } = await page(cursor);
+        if (data.length === 0)
+            break;
+        for (const event of data) {
+            await opts.onEvent({ id: event.id, event: event.event, data: event.data });
+            cursor = event.id;
+            count++;
+            if (count >= max)
+                break;
+        }
+        if (count >= max || data.length < 100)
+            break;
+    }
+    return { cursor, count };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export type { BillingAdapter, BillingUser, ApiKeyInfo, BillingConfig, ResolvedConfig, ToolResult, ToolErrorResult, } from "./types.js";
+export { resolveConfig, internalDomainsFromEnv } from "./types.js";
+export { authContext, runWithAuth, runWithResolvedOrg, enforceAccess, enforceTokens, } from "./auth.js";
+export { getStripe, stripeConfigured, ensureStripeCustomer, getBillingCustomerId, getTokenBalance, deductTokens, creditTokens, createTokenCheckoutSession, createBillingPortalSession, getAutoReloadSettings, setAutoReloadSettings, tryAutoReload, listInvoices, listSubscriptionPrices, resolveSubscriptionPrice, type StripePrice, } from "./billing.js";
+export { ensurePlans, planPriceId, planForPriceId, seatLimit, includedTokens, lookupKeyFor, type PlanDef, type PlansConfig, type BillingInterval, type EnsuredPrice, } from "./plans.js";
+export { sendMagicAuth, verifyMagicAuth } from "./magic-auth.js";
+export { createWorkOSInvitations, type InvitationService, type Invitation, type InvitationHooks, type InvitationEmailContext, type WorkOSInvitationsOptions, } from "./invitations.js";
+export { pollStripeEvents, pollWorkOSEvents, type PollResult } from "./events.js";
+export { createBillingSync, createSyncRoute, type BillingSync, type BillingSyncOptions, type CursorStore, } from "./sync.js";
+export { createMirror, type Mirror, type MirrorOptions, type MirrorQuery, type MirrorQueryResult, } from "./mirror.js";
+export { registerBillingTools, installInputLogging, BILLING_TOOL_NAMES, type RegisterBillingToolsOptions, } from "./tools/register.js";
+export { createDispatcher, ToolValidationError, type RegisterFn } from "./dispatch.js";
+export { createBilling, type CreateBillingOptions } from "./create-billing.js";
+export { createAgentAuth, CLAIM_GRANT_TYPE, type AgentAuthOptions, type AgentAuthBranding, type AgentAuthPaths, type AgentAuthPolicy, type AgentIdentityType, } from "./agent-auth/index.js";
+export { inMemoryClaimStore, type ClaimStore, type ClaimStatus, type ClaimReadResult, } from "./agent-auth/claim-store.js";
+export { createMachinePaymentHandler, createPaymentMd, type MachinePaymentOptions, type MachinePaymentMethod, type PaymentChallenge, type SettleFn, type PaymentMdOptions, } from "./machine-payment/index.js";
+export { createToolListHandler, createToolDispatchHandler, type Dispatcher } from "./routes/rest.js";
+export { createMcpTransport, type McpTransportOptions } from "./routes/mcp.js";
+export { createStripeWebhookHandler, type WebhookOptions } from "./routes/webhook.js";
+export { registerBillingCommands } from "./cli/commands.js";
+export { callTool, listTools, type ApiClientConfig } from "./cli/client.js";
+export { type CliOptions, type CliConfig, configPath, readConfig, writeConfig, resolveBaseUrl, resolveApiKey, } from "./cli/config.js";
+export { lookupCompany } from "./util/clearout.js";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,40 @@
+// billing-tools — make your Stripe + WorkOS app ready to get paid.
+export { resolveConfig, internalDomainsFromEnv } from "./types.js";
+// Auth engine
+export { authContext, runWithAuth, runWithResolvedOrg, enforceAccess, enforceTokens, } from "./auth.js";
+// Billing engine (Stripe math)
+export { getStripe, stripeConfigured, ensureStripeCustomer, getBillingCustomerId, getTokenBalance, deductTokens, creditTokens, createTokenCheckoutSession, createBillingPortalSession, getAutoReloadSettings, setAutoReloadSettings, tryAutoReload, listInvoices, listSubscriptionPrices, resolveSubscriptionPrice, } from "./billing.js";
+// Declarative plans (auto-provision Stripe products/prices from config)
+export { ensurePlans, planPriceId, planForPriceId, seatLimit, includedTokens, lookupKeyFor, } from "./plans.js";
+// WorkOS magic-auth
+export { sendMagicAuth, verifyMagicAuth } from "./magic-auth.js";
+// WorkOS organization invitations (shared, hook-configurable)
+export { createWorkOSInvitations, } from "./invitations.js";
+// Event-polling sync (zero-webhook: poll Stripe + WorkOS Events APIs)
+export { pollStripeEvents, pollWorkOSEvents } from "./events.js";
+// Turn-key billing sync engine (owns the poll→dispatch→plan/token/mirror loop)
+export { createBillingSync, createSyncRoute, } from "./sync.js";
+// Generic DB mirror for WorkOS entities (table-agnostic; org + user shapes)
+export { createMirror, } from "./mirror.js";
+// Tool registration
+export { registerBillingTools, installInputLogging, BILLING_TOOL_NAMES, } from "./tools/register.js";
+// REST dispatch bridge
+export { createDispatcher, ToolValidationError } from "./dispatch.js";
+// One-call composition helper (mount every surface from one config)
+export { createBilling } from "./create-billing.js";
+// auth.md — agent self-registration protocol (framework-agnostic handlers)
+export { createAgentAuth, CLAIM_GRANT_TYPE, } from "./agent-auth/index.js";
+export { inMemoryClaimStore, } from "./agent-auth/claim-store.js";
+// Machine payments — MPP (the 402 payment sibling of auth.md)
+export { createMachinePaymentHandler, createPaymentMd, } from "./machine-payment/index.js";
+// Next route factories
+export { createToolListHandler, createToolDispatchHandler } from "./routes/rest.js";
+export { createMcpTransport } from "./routes/mcp.js";
+export { createStripeWebhookHandler } from "./routes/webhook.js";
+// CLI factory
+export { registerBillingCommands } from "./cli/commands.js";
+export { callTool, listTools } from "./cli/client.js";
+export { configPath, readConfig, writeConfig, resolveBaseUrl, resolveApiKey, } from "./cli/config.js";
+// Utils
+export { lookupCompany } from "./util/clearout.js";
+//# 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,mEAAmE;AAYnE,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEnE,cAAc;AACd,OAAO,EACL,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,+BAA+B;AAC/B,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,GAEzB,MAAM,cAAc,CAAC;AAEtB,wEAAwE;AACxE,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,SAAS,EACT,cAAc,EACd,YAAY,GAKb,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjE,8DAA8D;AAC9D,OAAO,EACL,uBAAuB,GAMxB,MAAM,kBAAkB,CAAC;AAE1B,sEAAsE;AACtE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAElF,+EAA+E;AAC/E,OAAO,EACL,iBAAiB,EACjB,eAAe,GAIhB,MAAM,WAAW,CAAC;AAEnB,4EAA4E;AAC5E,OAAO,EACL,YAAY,GAKb,MAAM,aAAa,CAAC;AAErB,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,uBAAuB;AACvB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAEvF,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAE/E,2EAA2E;AAC3E,OAAO,EACL,eAAe,EACf,gBAAgB,GAMjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,GAInB,MAAM,6BAA6B,CAAC;AAErC,8DAA8D;AAC9D,OAAO,EACL,2BAA2B,EAC3B,eAAe,GAMhB,MAAM,4BAA4B,CAAC;AAEpC,uBAAuB;AACvB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAmB,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,kBAAkB,EAA4B,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAuB,MAAM,qBAAqB,CAAC;AAEtF,cAAc;AACd,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAwB,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAGL,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/invitations.d.ts

@@ -0,0 +1,56 @@
+import type { BillingUser } from "./types.js";
+import type { WorkOSOrgMap } from "./adapters/workos-org.js";
+export interface InvitationEmailContext {
+    /** WorkOS invitation id (use it in your accept link). */
+    id: string;
+    email: string;
+    roleSlug: string;
+    /** App orgId (post-map). */
+    orgId: string;
+    /** WorkOS organization id. */
+    organizationId: string;
+    /** `${baseUrl}${acceptPath}/${id}` — ready-made link for a custom email. */
+    acceptUrl: string;
+    inviterUserId?: string;
+}
+export interface InvitationHooks {
+    /** Send a branded email. Omit → rely on WorkOS's default invitation email. */
+    sendEmail?(ctx: InvitationEmailContext): Promise<void>;
+    /** Decide whether `user` may accept an invite addressed to `invitedEmail`.
+     *  Omit → case-insensitive match against the user's WorkOS primary email.
+     *  Return false for a generic rejection, or throw for a custom message. */
+    canAccept?(invitedEmail: string, user: BillingUser): Promise<boolean>;
+}
+export interface Invitation {
+    id: string;
+    email: string;
+    roleSlug: string;
+    /** App orgId (post-map), or "" if it can't be resolved. */
+    orgId: string;
+    organizationId: string;
+    state: "pending" | "accepted" | "expired" | "revoked";
+    createdAt: string;
+    expiresAt: string;
+}
+export interface WorkOSInvitationsOptions {
+    apiKey?: string;
+    clientId?: string;
+    /** ws↔org id map (share the adapter's). Omit → orgId IS the WorkOS org id. */
+    map?: WorkOSOrgMap;
+    /** Base URL for the custom-email accept link. */
+    baseUrl?: string;
+    /** Accept-link path prefix. Default "/invita". */
+    acceptPath?: string;
+    hooks?: InvitationHooks;
+}
+export interface InvitationService {
+    send(orgId: string, email: string, roleSlug: string, inviterUserId?: string): Promise<Invitation>;
+    list(orgId: string): Promise<Invitation[]>;
+    get(invitationId: string): Promise<Invitation | null>;
+    accept(invitationId: string, user: BillingUser): Promise<{
+        orgId: string;
+    }>;
+    revoke(orgId: string, invitationId: string): Promise<void>;
+}
+export declare function createWorkOSInvitations(opts?: WorkOSInvitationsOptions): InvitationService;
+//# sourceMappingURL=invitations.d.ts.map

package/dist/invitations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitations.d.ts","sourceRoot":"","sources":["../src/invitations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAgB7D,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,SAAS,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;+EAE2E;IAC3E,SAAS,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAID,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,wBAA6B,GAClC,iBAAiB,CAwHnB"}

package/dist/invitations.js

@@ -0,0 +1,117 @@
+import { NotFoundException, ConflictException } from "@workos-inc/node";
+import { getWorkOS } from "./workos.js";
+const PAGE = 100;
+export function createWorkOSInvitations(opts = {}) {
+    // Shared, lazily-memoized WorkOS client (see workos.ts).
+    const workos = () => getWorkOS({ apiKey: opts.apiKey, clientId: opts.clientId });
+    const hooks = opts.hooks ?? {};
+    const baseUrl = opts.baseUrl ?? "";
+    const acceptPath = opts.acceptPath ?? "/invita";
+    const toWid = (orgId) => opts.map ? opts.map.toWorkosOrgId(orgId) : Promise.resolve(orgId);
+    const toOrgId = (workosOrgId) => opts.map ? opts.map.toOrgId(workosOrgId) : Promise.resolve(workosOrgId);
+    async function normalize(inv, orgId) {
+        const resolved = orgId ?? (inv.organizationId ? await toOrgId(inv.organizationId) : null);
+        return {
+            id: inv.id,
+            email: inv.email,
+            roleSlug: inv.roleSlug ?? "member",
+            orgId: resolved ?? "",
+            organizationId: inv.organizationId ?? "",
+            state: inv.state,
+            createdAt: inv.createdAt,
+            expiresAt: inv.expiresAt,
+        };
+    }
+    async function get(invitationId) {
+        let inv;
+        try {
+            inv = await workos().userManagement.getInvitation(invitationId);
+        }
+        catch (e) {
+            if (e instanceof NotFoundException)
+                return null;
+            throw e;
+        }
+        if (inv.state !== "pending")
+            return null;
+        return normalize(inv);
+    }
+    async function send(orgId, email, roleSlug, inviterUserId) {
+        const organizationId = await toWid(orgId);
+        const inv = await workos().userManagement.sendInvitation({
+            email: email.trim().toLowerCase(),
+            organizationId,
+            roleSlug,
+            inviterUserId,
+        });
+        if (hooks.sendEmail) {
+            await hooks.sendEmail({
+                id: inv.id,
+                email: inv.email,
+                roleSlug: inv.roleSlug ?? roleSlug,
+                orgId,
+                organizationId,
+                acceptUrl: `${baseUrl}${acceptPath}/${inv.id}`,
+                inviterUserId,
+            });
+        }
+        return normalize(inv, orgId);
+    }
+    async function list(orgId) {
+        const organizationId = await toWid(orgId);
+        const paginatable = await workos().userManagement.listInvitations({ organizationId, limit: PAGE });
+        const pending = (await paginatable.autoPagination()).filter((i) => i.state === "pending");
+        return Promise.all(pending.map((i) => normalize(i, orgId)));
+    }
+    async function accept(invitationId, user) {
+        const inv = await get(invitationId);
+        if (!inv)
+            throw new Error("Invitation is invalid or already used");
+        const allowed = hooks.canAccept
+            ? await hooks.canAccept(inv.email, user)
+            : inv.email.toLowerCase() === user.email.toLowerCase();
+        if (!allowed) {
+            throw new Error(`This invitation is for ${inv.email}.`);
+        }
+        const organizationId = await toWid(inv.orgId);
+        // Tolerate an already-present membership (never downgrade).
+        try {
+            await workos().userManagement.createOrganizationMembership({
+                organizationId,
+                userId: user.id,
+                roleSlug: inv.roleSlug,
+            });
+        }
+        catch (e) {
+            if (!(e instanceof ConflictException))
+                throw e;
+        }
+        // Consume the pending invitation.
+        try {
+            await workos().userManagement.revokeInvitation(invitationId);
+        }
+        catch (e) {
+            if (!(e instanceof NotFoundException))
+                throw e;
+        }
+        return { orgId: inv.orgId };
+    }
+    async function revoke(orgId, invitationId) {
+        const organizationId = await toWid(orgId);
+        let inv;
+        try {
+            inv = await workos().userManagement.getInvitation(invitationId);
+        }
+        catch (e) {
+            if (e instanceof NotFoundException)
+                return;
+            throw e;
+        }
+        // Belongs-to check: the invitation must target this org.
+        if (inv.organizationId !== organizationId)
+            return;
+        await workos().userManagement.revokeInvitation(invitationId);
+    }
+    return { send, list, get, accept, revoke };
+}
+//# sourceMappingURL=invitations.js.map

package/dist/invitations.js.map

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

package/dist/machine-payment/index.d.ts

@@ -0,0 +1,57 @@
+export type MachinePaymentMethod = "stripe" | "tempo" | "solana" | "base";
+export interface PaymentChallenge {
+    id: string;
+    method: MachinePaymentMethod;
+    intent: "charge";
+    amount: number;
+    currency: string;
+    /** SPT profile id (`profile_…`) for method "stripe", or a deposit address for crypto. */
+    payTo?: string;
+}
+/** Settle a presented payment credential against a challenge. Provided by the
+ *  app once its Stripe account is machine-payments-eligible (e.g. `stripe.charge`
+ *  with the SPT, or a crypto verification). Resolve with a receipt on success;
+ *  throw / return null to reject. */
+export type SettleFn = (credential: string, challenge: PaymentChallenge) => Promise<{
+    receipt: string;
+} | null>;
+export interface MachinePaymentOptions {
+    /** Accepted methods, in preference order. Default ["stripe"]. */
+    methods?: MachinePaymentMethod[];
+    /** Price in minor units — fixed, or resolved per request (e.g. by path/tool). */
+    amount: number | ((request: Request) => number | Promise<number>);
+    currency?: string;
+    /** SPT profile id (`profile_…`) advertised for method "stripe". */
+    networkId?: string;
+    /** Crypto deposit address advertised for crypto methods. */
+    payToAddress?: string;
+    /** Inject the actual charge once the account is eligible. Omit → 402 with a
+     *  "settlement not enabled" note (protocol ready, money path pending). */
+    settle?: SettleFn;
+    /** Called after a successful settle; use to record the payment / grant access. */
+    onPaid?: (challenge: PaymentChallenge, receipt: string, request: Request) => Promise<void> | void;
+}
+/** Build the MPP payment gate. Returns `requirePayment(request)` → either a 402
+ *  `Response` (payment needed / rejected / not-settled) or `{ paid: true,
+ *  challenge, receipt }` when settlement succeeds — the caller then serves the
+ *  paid resource. */
+export declare function createMachinePaymentHandler(opts: MachinePaymentOptions): {
+    requirePayment: (request: Request) => Promise<Response | {
+        paid: true;
+        challenge: PaymentChallenge;
+        receipt: string;
+    }>;
+    buildChallenges: (request: Request) => Promise<PaymentChallenge[]>;
+};
+export interface PaymentMdOptions {
+    productName: string;
+    methods?: MachinePaymentMethod[];
+    currency?: string;
+    /** Path the paid resource lives at, for the doc examples. Default "/mcp". */
+    resourcePath?: string;
+    baseUrl?: string | ((request: Request) => string);
+}
+/** `/payment.md` — the agent-facing "how to pay per request" narrative; the
+ *  payment equivalent of auth.md. */
+export declare function createPaymentMd(opts: PaymentMdOptions): (request: Request) => Response;
+//# sourceMappingURL=index.d.ts.map

package/dist/machine-payment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/machine-payment/index.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;qCAGqC;AACrC,MAAM,MAAM,QAAQ,GAAG,CACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,gBAAgB,KACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAEzC,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,iFAAiF;IACjF,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;8EAC0E;IAC1E,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnG;AAyBD;;;qBAGqB;AACrB,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,qBAAqB;8BAiC1D,OAAO,KACf,OAAO,CAAC,QAAQ,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;+BA9B3C,OAAO,KAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;EAmD9E;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC;CACnD;AAED;qCACqC;AACrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,IAC1B,SAAS,OAAO,KAAG,QAAQ,CAqCtD"}