@parsrun/service-adapters 0.1.0

package/dist/payments/index.js

@@ -0,0 +1,636 @@
+// src/payments/definition.ts
+import { defineService } from "@parsrun/service";
+var paymentsServiceDefinition = defineService({
+  name: "payments",
+  version: "1.0.0",
+  description: "Payments, billing, and subscription management microservice",
+  queries: {
+    /**
+     * Get subscription details
+     */
+    getSubscription: {
+      input: void 0,
+      output: void 0,
+      description: "Get subscription details by ID or customer ID"
+    },
+    /**
+     * Get customer details
+     */
+    getCustomer: {
+      input: void 0,
+      output: void 0,
+      description: "Get customer details"
+    },
+    /**
+     * Check quota status
+     */
+    checkQuota: {
+      input: void 0,
+      output: void 0,
+      description: "Check if customer has quota for a feature"
+    },
+    /**
+     * Get usage summary
+     */
+    getUsage: {
+      input: void 0,
+      output: void 0,
+      description: "Get usage summary for a customer"
+    },
+    /**
+     * Get available plans
+     */
+    getPlans: {
+      input: void 0,
+      output: void 0,
+      description: "Get available subscription plans"
+    },
+    /**
+     * Get dunning status
+     */
+    getDunningStatus: {
+      input: void 0,
+      output: void 0,
+      description: "Get dunning status for a customer"
+    }
+  },
+  mutations: {
+    /**
+     * Create a checkout session
+     */
+    createCheckout: {
+      input: void 0,
+      output: void 0,
+      description: "Create a checkout session for subscription"
+    },
+    /**
+     * Cancel a subscription
+     */
+    cancelSubscription: {
+      input: void 0,
+      output: void 0,
+      description: "Cancel a subscription"
+    },
+    /**
+     * Update subscription
+     */
+    updateSubscription: {
+      input: void 0,
+      output: void 0,
+      description: "Update a subscription (e.g., change plan)"
+    },
+    /**
+     * Create customer portal session
+     */
+    createPortalSession: {
+      input: void 0,
+      output: void 0,
+      description: "Create a customer portal session for self-service"
+    },
+    /**
+     * Track usage
+     */
+    trackUsage: {
+      input: void 0,
+      output: void 0,
+      description: "Track usage of a metered feature"
+    },
+    /**
+     * Assign plan to customer
+     */
+    assignPlan: {
+      input: void 0,
+      output: void 0,
+      description: "Manually assign a plan to a customer"
+    },
+    /**
+     * Handle webhook
+     */
+    handleWebhook: {
+      input: void 0,
+      output: void 0,
+      description: "Handle payment provider webhook"
+    }
+  },
+  events: {
+    emits: {
+      /**
+       * Subscription was created
+       */
+      "subscription.created": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "A new subscription was created"
+      },
+      /**
+       * Subscription was renewed
+       */
+      "subscription.renewed": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Subscription was renewed for a new period"
+      },
+      /**
+       * Subscription was canceled
+       */
+      "subscription.canceled": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Subscription was canceled"
+      },
+      /**
+       * Subscription plan changed
+       */
+      "subscription.plan_changed": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Subscription plan was changed"
+      },
+      /**
+       * Payment succeeded
+       */
+      "payment.succeeded": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Payment was successful"
+      },
+      /**
+       * Payment failed
+       */
+      "payment.failed": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Payment failed"
+      },
+      /**
+       * Quota exceeded
+       */
+      "quota.exceeded": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Customer exceeded their quota for a feature"
+      },
+      /**
+       * Quota threshold reached
+       */
+      "quota.threshold_reached": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Customer reached a usage threshold (e.g., 80%)"
+      },
+      /**
+       * Dunning started
+       */
+      "dunning.started": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Dunning process started for a customer"
+      },
+      /**
+       * Dunning resolved
+       */
+      "dunning.resolved": {
+        data: void 0,
+        delivery: "at-least-once",
+        description: "Dunning process was resolved"
+      }
+    },
+    handles: [
+      // Events this service listens to
+      "user.created",
+      // Create customer record
+      "user.deleted",
+      // Cancel subscriptions
+      "tenant.suspended"
+      // Pause billing
+    ]
+  }
+});
+
+// src/payments/server.ts
+import { createLogger } from "@parsrun/core";
+import {
+  createRpcServer,
+  createEventEmitter,
+  createMemoryEventTransport,
+  getEmbeddedRegistry
+} from "@parsrun/service";
+var InMemoryPaymentsStorage = class {
+  usage = /* @__PURE__ */ new Map();
+  customerPlans = /* @__PURE__ */ new Map();
+  plans = [
+    {
+      id: "free",
+      name: "free",
+      displayName: "Free",
+      tier: 0,
+      basePrice: 0,
+      currency: "USD",
+      billingInterval: "month",
+      features: [
+        { featureKey: "api_calls", limitValue: 1e3, limitPeriod: "month" },
+        { featureKey: "storage_mb", limitValue: 100, limitPeriod: null }
+      ]
+    },
+    {
+      id: "pro",
+      name: "pro",
+      displayName: "Pro",
+      tier: 1,
+      basePrice: 2900,
+      currency: "USD",
+      billingInterval: "month",
+      features: [
+        { featureKey: "api_calls", limitValue: 1e5, limitPeriod: "month" },
+        { featureKey: "storage_mb", limitValue: 1e4, limitPeriod: null }
+      ]
+    },
+    {
+      id: "enterprise",
+      name: "enterprise",
+      displayName: "Enterprise",
+      tier: 2,
+      basePrice: 9900,
+      currency: "USD",
+      billingInterval: "month",
+      features: [
+        { featureKey: "api_calls", limitValue: null, limitPeriod: "month" },
+        { featureKey: "storage_mb", limitValue: null, limitPeriod: null }
+      ]
+    }
+  ];
+  async getUsage(customerId, featureKey) {
+    return this.usage.get(`${customerId}:${featureKey}`) ?? 0;
+  }
+  async trackUsage(customerId, featureKey, quantity) {
+    const key = `${customerId}:${featureKey}`;
+    const current = this.usage.get(key) ?? 0;
+    const newTotal = current + quantity;
+    this.usage.set(key, newTotal);
+    return newTotal;
+  }
+  async resetUsage(customerId, featureKey) {
+    if (featureKey) {
+      this.usage.delete(`${customerId}:${featureKey}`);
+    } else {
+      for (const key of this.usage.keys()) {
+        if (key.startsWith(`${customerId}:`)) {
+          this.usage.delete(key);
+        }
+      }
+    }
+  }
+  async getPlan(planId) {
+    return this.plans.find((p) => p.id === planId) ?? null;
+  }
+  async getPlans() {
+    return this.plans;
+  }
+  async getCustomerPlan(customerId) {
+    return this.customerPlans.get(customerId) ?? "free";
+  }
+  async setCustomerPlan(customerId, planId) {
+    this.customerPlans.set(customerId, planId);
+  }
+};
+function createPaymentsServiceServer(options) {
+  const logger = options.logger ?? createLogger({ name: "payments-service" });
+  const eventTransport = options.eventTransport ?? createMemoryEventTransport();
+  const storage = options.storage ?? new InMemoryPaymentsStorage();
+  const eventEmitter = createEventEmitter({
+    service: "payments",
+    definition: paymentsServiceDefinition,
+    transport: eventTransport,
+    logger
+  });
+  const handlers = {
+    queries: {
+      getSubscription: async (input, ctx) => {
+        const { subscriptionId, customerId } = input;
+        ctx.logger.debug("Getting subscription", { subscriptionId, customerId });
+        if (!subscriptionId && !customerId) {
+          return null;
+        }
+        return {
+          id: subscriptionId ?? `sub_${customerId}`,
+          customerId: customerId ?? "cus_123",
+          status: "active",
+          planId: "pro",
+          planName: "Pro",
+          currentPeriodStart: (/* @__PURE__ */ new Date()).toISOString(),
+          currentPeriodEnd: new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString(),
+          cancelAtPeriodEnd: false,
+          provider: options.providers.default.type
+        };
+      },
+      getCustomer: async (input, ctx) => {
+        const { customerId } = input;
+        ctx.logger.debug("Getting customer", { customerId });
+        return {
+          id: customerId,
+          email: `${customerId}@example.com`,
+          name: "Test Customer",
+          provider: options.providers.default.type
+        };
+      },
+      checkQuota: async (input, ctx) => {
+        const { customerId, featureKey } = input;
+        ctx.logger.debug("Checking quota", { customerId, featureKey });
+        const planId = await storage.getCustomerPlan(customerId);
+        const plan = planId ? await storage.getPlan(planId) : null;
+        const feature = plan?.features.find((f) => f.featureKey === featureKey);
+        const used = await storage.getUsage(customerId, featureKey);
+        const limit = feature?.limitValue ?? null;
+        const percentage = limit ? Math.round(used / limit * 100) : 0;
+        const allowed = limit === null || used < limit;
+        return {
+          allowed,
+          remaining: limit !== null ? Math.max(0, limit - used) : null,
+          limit,
+          percentage
+        };
+      },
+      getUsage: async (input, ctx) => {
+        const { customerId, featureKey } = input;
+        ctx.logger.debug("Getting usage", { customerId, featureKey });
+        const planId = await storage.getCustomerPlan(customerId);
+        const plan = planId ? await storage.getPlan(planId) : null;
+        const features = [];
+        const featuresToCheck = featureKey ? plan?.features.filter((f) => f.featureKey === featureKey) ?? [] : plan?.features ?? [];
+        for (const f of featuresToCheck) {
+          const used = await storage.getUsage(customerId, f.featureKey);
+          features.push({
+            featureKey: f.featureKey,
+            used,
+            limit: f.limitValue,
+            percentage: f.limitValue ? Math.round(used / f.limitValue * 100) : 0
+          });
+        }
+        return {
+          features,
+          period: {
+            start: new Date(Date.now() - 30 * 24 * 60 * 60 * 1e3).toISOString(),
+            end: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        };
+      },
+      getPlans: async (_input, ctx) => {
+        ctx.logger.debug("Getting plans");
+        const plans = await storage.getPlans();
+        return { plans };
+      },
+      getDunningStatus: async (input, ctx) => {
+        const { customerId } = input;
+        ctx.logger.debug("Getting dunning status", { customerId });
+        return { inDunning: false };
+      }
+    },
+    mutations: {
+      createCheckout: async (input, ctx) => {
+        const { email, planId, successUrl: _successUrl, cancelUrl: _cancelUrl, countryCode } = input;
+        void _successUrl;
+        void _cancelUrl;
+        ctx.logger.info("Creating checkout", { email, planId, countryCode });
+        const sessionId = `cs_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+        const customerId = `cus_${Date.now()}`;
+        return {
+          checkoutUrl: `https://checkout.example.com/${sessionId}`,
+          sessionId,
+          customerId,
+          provider: options.providers.default.type
+        };
+      },
+      cancelSubscription: async (input, ctx) => {
+        const { subscriptionId, cancelAtPeriodEnd, reason } = input;
+        ctx.logger.info("Canceling subscription", { subscriptionId, reason });
+        await eventEmitter.emit("subscription.canceled", {
+          subscriptionId,
+          customerId: "cus_123",
+          reason,
+          effectiveAt: cancelAtPeriodEnd ? new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString() : (/* @__PURE__ */ new Date()).toISOString(),
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        return {
+          success: true,
+          canceledAt: (/* @__PURE__ */ new Date()).toISOString(),
+          effectiveAt: cancelAtPeriodEnd ? new Date(Date.now() + 30 * 24 * 60 * 60 * 1e3).toISOString() : (/* @__PURE__ */ new Date()).toISOString()
+        };
+      },
+      updateSubscription: async (input, ctx) => {
+        const { subscriptionId, planId } = input;
+        ctx.logger.info("Updating subscription", { subscriptionId, planId });
+        if (planId) {
+          await eventEmitter.emit("subscription.plan_changed", {
+            subscriptionId,
+            customerId: "cus_123",
+            previousPlanId: "pro",
+            newPlanId: planId,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+        }
+        return {
+          success: true,
+          subscription: {
+            id: subscriptionId,
+            planId: planId ?? "pro",
+            status: "active"
+          }
+        };
+      },
+      createPortalSession: async (input, ctx) => {
+        const { customerId, returnUrl: _returnUrl } = input;
+        void _returnUrl;
+        ctx.logger.info("Creating portal session", { customerId });
+        return {
+          portalUrl: `https://billing.example.com/portal/${customerId}`,
+          expiresAt: new Date(Date.now() + 60 * 60 * 1e3).toISOString()
+        };
+      },
+      trackUsage: async (input, ctx) => {
+        const { customerId, featureKey, quantity } = input;
+        ctx.logger.debug("Tracking usage", { customerId, featureKey, quantity });
+        const newTotal = await storage.trackUsage(customerId, featureKey, quantity);
+        const planId = await storage.getCustomerPlan(customerId);
+        const plan = planId ? await storage.getPlan(planId) : null;
+        const feature = plan?.features.find((f) => f.featureKey === featureKey);
+        const limit = feature?.limitValue ?? null;
+        if (limit !== null) {
+          const percentage = Math.round(newTotal / limit * 100);
+          if (percentage >= 100 && newTotal - quantity < limit) {
+            await eventEmitter.emit("quota.exceeded", {
+              customerId,
+              featureKey,
+              used: newTotal,
+              limit,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            });
+          } else if (percentage >= 80 && Math.round((newTotal - quantity) / limit * 100) < 80) {
+            await eventEmitter.emit("quota.threshold_reached", {
+              customerId,
+              featureKey,
+              percentage,
+              used: newTotal,
+              limit,
+              timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            });
+          }
+        }
+        return {
+          success: true,
+          newTotal,
+          remaining: limit !== null ? Math.max(0, limit - newTotal) : null
+        };
+      },
+      assignPlan: async (input, ctx) => {
+        const { customerId, planId } = input;
+        ctx.logger.info("Assigning plan", { customerId, planId });
+        const previousPlanId = await storage.getCustomerPlan(customerId);
+        await storage.setCustomerPlan(customerId, planId);
+        return {
+          success: true,
+          previousPlanId: previousPlanId ?? void 0,
+          newPlanId: planId
+        };
+      },
+      handleWebhook: async (input, ctx) => {
+        const { provider, payload: _payload, signature: _signature } = input;
+        void _payload;
+        void _signature;
+        ctx.logger.info("Handling webhook", { provider });
+        return {
+          success: true,
+          eventType: "payment.succeeded",
+          eventId: `evt_${Date.now()}`
+        };
+      }
+    }
+  };
+  const rpcServer = createRpcServer({
+    definition: paymentsServiceDefinition,
+    handlers,
+    logger
+  });
+  const register = () => {
+    const registry = getEmbeddedRegistry();
+    registry.register("payments", rpcServer);
+    logger.info("Payments service registered");
+  };
+  return {
+    rpcServer,
+    eventEmitter,
+    register
+  };
+}
+
+// src/payments/client.ts
+import {
+  useService
+} from "@parsrun/service";
+function createPaymentsServiceClient(options) {
+  const client = useService("payments", options);
+  return {
+    // Queries
+    async getSubscription(opts) {
+      return client.query("getSubscription", opts);
+    },
+    async getCustomer(customerId) {
+      return client.query("getCustomer", { customerId });
+    },
+    async checkQuota(customerId, featureKey) {
+      return client.query("checkQuota", { customerId, featureKey });
+    },
+    async getUsage(opts) {
+      return client.query("getUsage", opts);
+    },
+    async getPlans() {
+      return client.query("getPlans", void 0);
+    },
+    async getDunningStatus(customerId) {
+      return client.query("getDunningStatus", { customerId });
+    },
+    // Mutations
+    async createCheckout(opts) {
+      return client.mutate("createCheckout", opts);
+    },
+    async cancelSubscription(opts) {
+      return client.mutate("cancelSubscription", opts);
+    },
+    async updateSubscription(opts) {
+      return client.mutate("updateSubscription", opts);
+    },
+    async createPortalSession(customerId, returnUrl) {
+      return client.mutate("createPortalSession", { customerId, returnUrl });
+    },
+    async trackUsage(opts) {
+      return client.mutate("trackUsage", opts);
+    },
+    async assignPlan(customerId, planId, expiresAt) {
+      return client.mutate("assignPlan", { customerId, planId, expiresAt });
+    },
+    async handleWebhook(opts) {
+      return client.mutate("handleWebhook", opts);
+    },
+    // Event subscriptions
+    onSubscriptionCreated(handler) {
+      return client.on("subscription.created", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onSubscriptionRenewed(handler) {
+      return client.on("subscription.renewed", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onSubscriptionCanceled(handler) {
+      return client.on("subscription.canceled", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onSubscriptionPlanChanged(handler) {
+      return client.on("subscription.plan_changed", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onPaymentSucceeded(handler) {
+      return client.on("payment.succeeded", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onPaymentFailed(handler) {
+      return client.on("payment.failed", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onQuotaExceeded(handler) {
+      return client.on("quota.exceeded", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onQuotaThresholdReached(handler) {
+      return client.on("quota.threshold_reached", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onDunningStarted(handler) {
+      return client.on("dunning.started", async (event) => {
+        await handler(event.data);
+      });
+    },
+    onDunningResolved(handler) {
+      return client.on("dunning.resolved", async (event) => {
+        await handler(event.data);
+      });
+    },
+    async close() {
+      if ("close" in client && typeof client.close === "function") {
+        await client.close();
+      }
+    }
+  };
+}
+export {
+  createPaymentsServiceClient,
+  createPaymentsServiceServer,
+  paymentsServiceDefinition
+};
+//# sourceMappingURL=index.js.map