Create Subscription action

Author: GTFalcao

components/chargebee/actions/create-subscription/create-subscription.mjs

@@ -0,0 +1,54 @@
+import chargebee from "../../chargebee.app.mjs";
+import { clearObject } from "../../common/utils.mjs";
+
+export default {
+  key: "chargebee-create-subscription",
+  name: "Create Subscription",
+  description: "Create a new subscription for an existing customer. [See the documentation](https://apidocs.chargebee.com/docs/api/subscriptions?lang=curl#create_subscription_for_items)",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    chargebee,
+    customerId: {
+      propDefinition: [
+        chargebee,
+        "customerId",
+      ]
+    },
+    id: {
+      type: "string",
+      label: "ID",
+      description: "A unique and immutable identifier for the subscription. If not provided, it is autogenerated.",
+      optional: true,
+    },
+    netTermDays: {
+      type: "integer",
+      label: "Net Term Days",
+      description: "Defines [Net D](https://www.chargebee.com/docs/net_d.html?_gl=1*1w075xz*_gcl_au*MTU4NzU2NDYzOC4xNzMzODA0OTYw) for the subscription. Net D is the number of days within which any invoice raised for the subscription must be paid.",
+      optional: true,
+    },
+    startDate: {
+      type: "string",
+      label: "Start Date",
+      description: "The date/time at which the subscription is to start, e.g. `2024-08-15T09:30:00Z`. If not provided, the subscription starts immediately.",
+      optional: true,
+    },
+    additionalFields: {
+      type: "object",
+      label: "Additional Fields",
+      description: "Additional fields and values to set for the subscription. [See the documentation](https://apidocs.chargebee.com/docs/api/subscriptions?lang=curl#create_subscription_for_items) for all available fields.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.chargebee.createCustomer(this.customerId, clearObject({
+      id: this.id,
+      net_term_days: this.netTermDays,
+      start_date: this.startDate && (Date.parse(this.startDate) / 1000),
+      ...this.additionalFields,
+    }));
+
+    $.export("$summary", `Successfully created subscription (ID: ${response?.subscription?.id})`);
+    return response;
+  },
+};

components/chargebee/chargebee.app.mjs

@@ -3,6 +3,20 @@ import chargebee from "chargebee";
 export default {
   type: "app",
   app: "chargebee",
+  propDefinitions: {
+    customerId: {
+      type: "string",
+      label: "Customer ID",
+      description: "The ID of the customer to create the subscription for.",
+      async options() {
+        const customers = await this.getCustomers();
+        return customers.list.map((customer) => ({
+          label: `${customer.first_name ?? ''} ${customer.last_name ?? ''} (${customer.email ?? customer.id})`,
+          value: customer.id,
+        }));
+      }
+    }
+  },
   methods: {
     instance() {
       chargebee.configure({
@@ -31,6 +45,9 @@ export default {
     },
     createCustomer(args = {}) {
       return this.instance().customer.create(args).request();
-    }
+    },
+    createSubscription(customerId, args = {}) {
+      return this.instance().subscription.create_for_customer(customerId, args).request();
+    },
   },
 };

components/chargebee/common/utils.mjs

@@ -0,0 +1,3 @@
+export function clearObject(obj) {
+  return Object.fromEntries(Object.entries(obj).filter(([_, v]) => v !== undefined));
+}