piece-flexprice 0.1.0

package/index.js

@@ -0,0 +1,256 @@
+const { createPiece, createAction, Property } = require("@activepieces/pieces-framework");
+
+const ingestEventAction = createAction({
+  name: "ingest_event",
+  displayName: "Ingest Usage Event",
+  description: "Report a billable usage event to Flexprice (e.g. lead_received, whatsapp_message_sent)",
+  props: {
+    eventName: Property.ShortText({
+      displayName: "Event Name",
+      description: "Name of the usage event (e.g. lead_received, whatsapp_message_sent)",
+      required: true,
+      defaultValue: "lead_received"
+    }),
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Internal Flexprice Customer UUID (or leave empty if passing External Customer ID)",
+      required: false
+    }),
+    externalCustomerId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "External Tenant/Client ID (e.g. Supabase client_id)",
+      required: false
+    }),
+    quantity: Property.Number({
+      displayName: "Quantity",
+      description: "Usage quantity / units (default: 1)",
+      required: false,
+      defaultValue: 1
+    }),
+    propertiesJson: Property.LongText({
+      displayName: "Custom Event Properties (JSON)",
+      description: "Optional JSON metadata object for the event",
+      required: false
+    })
+  },
+  async run(context) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    let propertiesObj = {};
+    if (context.propsValue.propertiesJson) {
+      try {
+        propertiesObj = JSON.parse(context.propsValue.propertiesJson);
+      } catch (e) {
+        propertiesObj = { raw: context.propsValue.propertiesJson };
+      }
+    }
+
+    const payload = {
+      event_name: context.propsValue.eventName,
+      customer_id: context.propsValue.customerId || undefined,
+      external_customer_id: context.propsValue.externalCustomerId || undefined,
+      timestamp: new Date().toISOString(),
+      properties: {
+        quantity: context.propsValue.quantity ?? 1,
+        ...propertiesObj
+      }
+    };
+
+    const res = await fetch(`${baseUrl}/events`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Event Ingestion Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});
+
+const createCustomerAction = createAction({
+  name: "create_customer",
+  displayName: "Create Customer",
+  description: "Provision a new billing customer profile in Flexprice",
+  props: {
+    externalId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "Unique identifier for client in your system (e.g. Supabase client_id)",
+      required: true
+    }),
+    name: Property.ShortText({
+      displayName: "Customer Name",
+      description: "Client business or individual name",
+      required: true
+    }),
+    email: Property.ShortText({
+      displayName: "Customer Email",
+      description: "Billing contact email address",
+      required: false
+    })
+  },
+  async run(context) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const payload = {
+      external_id: context.propsValue.externalId,
+      name: context.propsValue.name,
+      email: context.propsValue.email || undefined
+    };
+
+    const res = await fetch(`${baseUrl}/customers`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Customer Creation Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});
+
+const getCustomerAction = createAction({
+  name: "get_customer",
+  displayName: "Get Customer Details",
+  description: "Fetch customer details from Flexprice by external ID or customer ID",
+  props: {
+    externalId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "External tenant ID",
+      required: true
+    })
+  },
+  async run(context) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/customers?external_id=${encodeURIComponent(context.propsValue.externalId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Customer Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});
+
+const getSubscriptionsAction = createAction({
+  name: "get_subscriptions",
+  displayName: "Get Subscriptions",
+  description: "Fetch customer subscription plan and status from Flexprice",
+  props: {
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Customer ID in Flexprice",
+      required: true
+    })
+  },
+  async run(context) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/subscriptions?customer_id=${encodeURIComponent(context.propsValue.customerId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Subscriptions Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});
+
+const getInvoicesAction = createAction({
+  name: "get_invoices",
+  displayName: "Get Invoices",
+  description: "Fetch invoices and billing statements from Flexprice",
+  props: {
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Customer ID in Flexprice",
+      required: true
+    })
+  },
+  async run(context) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/invoices?customer_id=${encodeURIComponent(context.propsValue.customerId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Invoices Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});
+
+const flexpricePiece = createPiece({
+  displayName: "Flexprice Billing & Metering",
+  logoUrl: "https://raw.githubusercontent.com/flexprice/flexprice-front/main/assets/flexprice_logo.png",
+  minimumSupportedRelease: "0.5.0",
+  authors: ["Whatomation Team"],
+  auth: Property.CustomAuth({
+    displayName: "Flexprice Authentication",
+    description: "Provide your Flexprice API key and server URL",
+    required: true,
+    props: {
+      apiKey: Property.SecretText({
+        displayName: "API Key",
+        description: "Your master Flexprice API key (x-api-key)",
+        required: true
+      }),
+      baseUrl: Property.ShortText({
+        displayName: "API Base URL",
+        description: "Flexprice API Base URL (default: http://localhost:8080/v1)",
+        required: true,
+        defaultValue: "http://localhost:8080/v1"
+      })
+    }
+  }),
+  actions: [
+    ingestEventAction,
+    createCustomerAction,
+    getCustomerAction,
+    getSubscriptionsAction,
+    getInvoicesAction
+  ],
+  triggers: []
+});
+
+module.exports = { flexpricePiece };

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "piece-flexprice",
+  "displayName": "Flexprice Billing & Metering",
+  "version": "0.1.0",
+  "minimumSupportedRelease": "0.5.0",
+  "main": "index.js",
+  "dependencies": {
+    "@activepieces/pieces-framework": "^0.9.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,39 @@
+import { createPiece, Property } from "@activepieces/pieces-framework";
+import { ingestEventAction } from "./lib/actions/ingest-event";
+import { createCustomerAction } from "./lib/actions/create-customer";
+import { getCustomerAction } from "./lib/actions/get-customer";
+import { getSubscriptionsAction } from "./lib/actions/get-subscriptions";
+import { getInvoicesAction } from "./lib/actions/get-invoices";
+
+export const flexpricePiece = createPiece({
+  displayName: "Flexprice Billing & Metering",
+  logoUrl: "https://raw.githubusercontent.com/flexprice/flexprice-front/main/assets/flexprice_logo.png",
+  minimumSupportedRelease: "0.5.0",
+  authors: ["Whatomation Team"],
+  auth: Property.CustomAuth({
+    displayName: "Flexprice Authentication",
+    description: "Provide your Flexprice API key and server URL",
+    required: true,
+    props: {
+      apiKey: Property.SecretText({
+        displayName: "API Key",
+        description: "Your master Flexprice API key (x-api-key)",
+        required: true
+      }),
+      baseUrl: Property.ShortText({
+        displayName: "API Base URL",
+        description: "Flexprice API Base URL (default: http://localhost:8080/v1)",
+        required: true,
+        defaultValue: "http://localhost:8080/v1"
+      })
+    }
+  }),
+  actions: [
+    ingestEventAction,
+    createCustomerAction,
+    getCustomerAction,
+    getSubscriptionsAction,
+    getInvoicesAction
+  ],
+  triggers: []
+});

package/src/lib/actions/create-customer.ts

@@ -0,0 +1,57 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { ActionContext, FlexpriceAuth } from "../types";
+
+interface CreateCustomerProps {
+  externalId: string;
+  name: string;
+  email?: string;
+}
+
+export const createCustomerAction = createAction({
+  name: "create_customer",
+  displayName: "Create Customer",
+  description: "Provision a new billing customer profile in Flexprice",
+  props: {
+    externalId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "Unique identifier for client in your system (e.g. Supabase client_id)",
+      required: true
+    }),
+    name: Property.ShortText({
+      displayName: "Customer Name",
+      description: "Client business or individual name",
+      required: true
+    }),
+    email: Property.ShortText({
+      displayName: "Customer Email",
+      description: "Billing contact email address",
+      required: false
+    })
+  },
+  async run(context: ActionContext<CreateCustomerProps, FlexpriceAuth>) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const payload = {
+      external_id: context.propsValue.externalId,
+      name: context.propsValue.name,
+      email: context.propsValue.email || undefined
+    };
+
+    const res = await fetch(`${baseUrl}/customers`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Customer Creation Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});

package/src/lib/actions/get-customer.ts

@@ -0,0 +1,38 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { ActionContext, FlexpriceAuth } from "../types";
+
+interface GetCustomerProps {
+  externalId: string;
+}
+
+export const getCustomerAction = createAction({
+  name: "get_customer",
+  displayName: "Get Customer Details",
+  description: "Fetch customer details from Flexprice by external ID or customer ID",
+  props: {
+    externalId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "External tenant ID",
+      required: true
+    })
+  },
+  async run(context: ActionContext<GetCustomerProps, FlexpriceAuth>) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/customers?external_id=${encodeURIComponent(context.propsValue.externalId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Customer Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});

package/src/lib/actions/get-invoices.ts

@@ -0,0 +1,38 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { ActionContext, FlexpriceAuth } from "../types";
+
+interface GetInvoicesProps {
+  customerId: string;
+}
+
+export const getInvoicesAction = createAction({
+  name: "get_invoices",
+  displayName: "Get Invoices",
+  description: "Fetch invoices and billing statements from Flexprice",
+  props: {
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Customer ID in Flexprice",
+      required: true
+    })
+  },
+  async run(context: ActionContext<GetInvoicesProps, FlexpriceAuth>) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/invoices?customer_id=${encodeURIComponent(context.propsValue.customerId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Invoices Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});

package/src/lib/actions/get-subscriptions.ts

@@ -0,0 +1,38 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { ActionContext, FlexpriceAuth } from "../types";
+
+interface GetSubscriptionsProps {
+  customerId: string;
+}
+
+export const getSubscriptionsAction = createAction({
+  name: "get_subscriptions",
+  displayName: "Get Subscriptions",
+  description: "Fetch customer subscription plan and status from Flexprice",
+  props: {
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Customer ID in Flexprice",
+      required: true
+    })
+  },
+  async run(context: ActionContext<GetSubscriptionsProps, FlexpriceAuth>) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    const url = `${baseUrl}/subscriptions?customer_id=${encodeURIComponent(context.propsValue.customerId)}`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: {
+        "x-api-key": apiKey
+      }
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Fetch Subscriptions Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});

package/src/lib/actions/ingest-event.ts

@@ -0,0 +1,85 @@
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { ActionContext, FlexpriceAuth } from "../types";
+
+interface IngestEventProps {
+  eventName: string;
+  customerId?: string;
+  externalCustomerId?: string;
+  quantity?: number;
+  propertiesJson?: string;
+}
+
+export const ingestEventAction = createAction({
+  name: "ingest_event",
+  displayName: "Ingest Usage Event",
+  description: "Report a billable usage event to Flexprice (e.g. lead_received, whatsapp_message_sent)",
+  props: {
+    eventName: Property.ShortText({
+      displayName: "Event Name",
+      description: "Name of the usage event (e.g. lead_received, whatsapp_message_sent)",
+      required: true,
+      defaultValue: "lead_received"
+    }),
+    customerId: Property.ShortText({
+      displayName: "Flexprice Customer ID",
+      description: "Internal Flexprice Customer UUID (or leave empty if passing External Customer ID)",
+      required: false
+    }),
+    externalCustomerId: Property.ShortText({
+      displayName: "External Customer ID",
+      description: "External Tenant/Client ID (e.g. Supabase client_id)",
+      required: false
+    }),
+    quantity: Property.Number({
+      displayName: "Quantity",
+      description: "Usage quantity / units (default: 1)",
+      required: false,
+      defaultValue: 1
+    }),
+    propertiesJson: Property.LongText({
+      displayName: "Custom Event Properties (JSON)",
+      description: "Optional JSON metadata object for the event",
+      required: false
+    })
+  },
+  async run(context: ActionContext<IngestEventProps, FlexpriceAuth>) {
+    const apiKey = context.auth?.apiKey || "";
+    const baseUrl = (context.auth?.baseUrl || "http://localhost:8080/v1").replace(/\/+$/, "");
+
+    let propertiesObj = {};
+    if (context.propsValue.propertiesJson) {
+      try {
+        propertiesObj = JSON.parse(context.propsValue.propertiesJson);
+      } catch (e) {
+        propertiesObj = { raw: context.propsValue.propertiesJson };
+      }
+    }
+
+    const payload = {
+      event_name: context.propsValue.eventName,
+      customer_id: context.propsValue.customerId || undefined,
+      external_customer_id: context.propsValue.externalCustomerId || undefined,
+      timestamp: new Date().toISOString(),
+      properties: {
+        quantity: context.propsValue.quantity ?? 1,
+        ...propertiesObj
+      }
+    };
+
+    const res = await fetch(`${baseUrl}/events`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+
+    const data = await res.json();
+    if (!res.ok) {
+      throw new Error(`Flexprice Event Ingestion Failed (${res.status}): ${JSON.stringify(data)}`);
+    }
+
+    return data;
+  }
+});

package/src/lib/types.ts

@@ -0,0 +1,9 @@
+export interface FlexpriceAuth {
+  apiKey: string;
+  baseUrl: string;
+}
+
+export interface ActionContext<PropsValue, AuthType = FlexpriceAuth> {
+  auth: AuthType;
+  propsValue: PropsValue;
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "baseUrl": ".",
+    "paths": {
+      "@activepieces/pieces-framework": ["./node_modules/@activepieces/pieces-framework"]
+    }
+  },
+  "include": ["src/**/*"]
+}