chargebee-init 1.0.0-beta.1

package/bin/chargebee-init

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import { run } from "../dist/cli.js";
+
+function onError(err) {
+	console.error(err);
+	process.exit(1);
+}
+
+process.on("uncaughtException", onError);
+
+run().catch(onError);

package/dist/checks.d.ts

@@ -0,0 +1,17 @@
+import type { PackageManifest } from "@pnpm/types";
+import { type DetectedFramework } from "./frameworks.js";
+export type Checks = "git" | "package.json" | "framework";
+export type CheckError = {
+    check: Checks;
+    msg: string;
+    bail?: boolean;
+};
+export type CheckResponse<P extends string, T> = {
+    [k in P]?: T;
+} & {
+    errors: CheckError[];
+};
+export type PreflightResponse = CheckResponse<"pkg", PackageManifest>;
+export type FrameworkResponse = CheckResponse<"framework", DetectedFramework>;
+export declare const preflightChecks: (path: string) => Promise<PreflightResponse>;
+export declare const frameworkChecks: (pkg: PackageManifest) => Promise<FrameworkResponse>;

package/dist/checks.js

@@ -0,0 +1,46 @@
+import colors from "ansi-colors";
+import { detectFramework, satisfiesMinVersion, supportedFrameworks, } from "./frameworks.js";
+import { isCleanTree } from "./git.js";
+import { getPackageJson } from "./package.js";
+export const preflightChecks = async (path) => {
+    const errors = [];
+    // We raise a warning if we can't validate that the target directory isn't
+    // a git tree, but give them the option to continue
+    const cleanTree = await isCleanTree(path);
+    if (!cleanTree) {
+        errors.push({
+            check: "git",
+            msg: `Could not validate if the target directory is a clean git tree`,
+        });
+    }
+    // This is a hard stop as we can't continue without a valid package.json
+    const pkg = getPackageJson(path);
+    if (pkg) {
+        return { pkg, errors };
+    }
+    errors.push({
+        check: "package.json",
+        msg: `Could not read the contents of ${path}/package.json to perform the required checks. Please ensure your app has a valid package.json.`,
+        bail: true,
+    });
+    return { errors };
+};
+export const frameworkChecks = async (pkg) => {
+    const errors = [];
+    const framework = detectFramework(pkg);
+    if (!framework) {
+        errors.push({
+            check: "framework",
+            msg: `No supported framework detected in package.json. We currently support: ${colors.red(Object.keys(supportedFrameworks).join(", "))}`,
+            bail: true,
+        });
+    }
+    else if (!satisfiesMinVersion(framework)) {
+        errors.push({
+            check: "framework",
+            msg: `${framework.name}@${framework.version} does not satisfy the minimum version we support (${framework.info.minVersion}). Can't proceed!`,
+            bail: true,
+        });
+    }
+    return { framework, errors };
+};

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function run(): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,44 @@
+import colors from "ansi-colors";
+import meow from "meow";
+import * as help from "./help.js";
+import { init } from "./init.js";
+const cli = meow(`
+Usage
+	$ chargebee-init <command> [subcommand]
+
+Options
+	--help display this help text
+
+Examples
+	$ chargebee-init
+	$ chargebee-init help
+	$ chargebee-init help nextjs|express
+  `, {
+    importMeta: import.meta,
+    autoHelp: true,
+    autoVersion: true,
+});
+export async function run() {
+    const [command = "", subcommand = ""] = cli.input;
+    switch (command) {
+        case "":
+        case "init":
+            await init();
+            break;
+        case "help":
+            {
+                if (!subcommand || !(subcommand in help.messages)) {
+                    console.log(colors.cyanBright(help.cliHelpMsg(cli.pkg.version, cli.pkg.description)));
+                    console.log(cli.help.replace(cli.pkg.description, "").trim());
+                }
+                else {
+                    const framework = subcommand;
+                    console.log(help.messages[framework].preinit);
+                    console.log(colors.yellowBright(help.messages[framework].postinit));
+                }
+            }
+            break;
+        default:
+            cli.showHelp();
+    }
+}

package/dist/frameworks.d.ts

@@ -0,0 +1,17 @@
+import type { PackageManifest } from "@pnpm/types";
+export type Framework = "nextjs" | "express";
+export type Features = "checkout" | "webhook";
+export interface FrameworkInfo {
+    packageName: string;
+    minVersion: string;
+    dependencies: string[];
+    appDirectories: string[];
+}
+export declare const supportedFrameworks: Record<Framework, FrameworkInfo>;
+export type DetectedFramework = {
+    name: Framework;
+    version: string;
+    info: FrameworkInfo;
+};
+export declare function detectFramework(pkgJson: PackageManifest): DetectedFramework | undefined;
+export declare function satisfiesMinVersion({ version, info, }: DetectedFramework): boolean;

package/dist/frameworks.js

@@ -0,0 +1,42 @@
+import path from "node:path";
+import semver from "semver";
+export const supportedFrameworks = {
+    nextjs: {
+        packageName: "next",
+        minVersion: "15",
+        dependencies: ["@chargebee/nextjs:~0.1.0"],
+        appDirectories: ["app", path.join("src", "app")],
+    },
+    express: {
+        packageName: "express",
+        minVersion: ">=5",
+        dependencies: ["@chargebee/express:~0.1.0"],
+        appDirectories: ["app", "src"],
+    },
+};
+// We read the version from package.json, which will not
+// give us the exact installed version thanks to semver. But as
+// long as it satisfies our minVersion, that should be ok.
+//
+// TODO: What if there are multiple detected frameworks?
+export function detectFramework(pkgJson) {
+    if (!pkgJson.dependencies) {
+        return undefined;
+    }
+    for (const [framework, info] of Object.entries(supportedFrameworks)) {
+        const version = pkgJson.dependencies[info.packageName];
+        if (version) {
+            return {
+                name: framework,
+                version,
+                info,
+            };
+        }
+    }
+    return undefined;
+}
+export function satisfiesMinVersion({ version, info, }) {
+    var _a, _b;
+    const ver = (_b = (_a = semver.coerce(version)) === null || _a === void 0 ? void 0 : _a.version) !== null && _b !== void 0 ? _b : "";
+    return semver.satisfies(ver, info.minVersion);
+}

package/dist/git.d.ts

@@ -0,0 +1 @@
+export declare function isCleanTree(dir: string): Promise<boolean>;

package/dist/git.js

@@ -0,0 +1,10 @@
+import { simpleGit } from "simple-git";
+export async function isCleanTree(dir) {
+    try {
+        const git = simpleGit(dir);
+        return (await git.status()).isClean();
+    }
+    catch (_err) {
+        return false;
+    }
+}

package/dist/help.d.ts

@@ -0,0 +1,11 @@
+export declare const cliHelpMsg: (version: string, description: string) => string;
+export declare const messages: {
+    readonly nextjs: {
+        readonly preinit: "\n* --------------------------\n* Chargebee Next.js Adapter\n* --------------------------\n* Integrates with Next.js version 15 \n* Only App Router is supported at the moment\n* Routes will be created under the chargebee directory by default\n";
+        readonly postinit: "\nPlease complete the following steps before you test out the Chargebee integration:\n\n* Define the required process.env.* variables either by adding them to your .env file or replacing them at build time:\n\n\tCHARGEBEE_SITE=\"site-name\"\n\tCHARGEBEE_API_KEY=\"\"\n\tCHARGEBEE_WEBHOOK_AUTH=\"username:password\"\n\n* Run npm|pnpm|bun install to grab the required packages\n\n* Configure the webhook URL in the Chargebee dashboard with basic auth set to the username and password defined in CHARGEBEE_WEBHOOK_AUTH\n\n* Review the routes created under the chargebee/ directory and make necessary changes\n";
+    };
+    readonly express: {
+        readonly preinit: "\n* --------------------------\n* Chargebee Express Adapter\n* --------------------------\n* Integrates with Express version 5\n";
+        readonly postinit: "\nPlease complete the following steps before you test out the Chargebee integration:\n\n* Define the required process.env.* variables either by adding them to your .env file or replacing them at build time:\n\n\tCHARGEBEE_SITE=\"site-name\"\n\tCHARGEBEE_API_KEY=\"\"\n\tCHARGEBEE_WEBHOOK_AUTH=\"username:password\"\n\n* Run npm|pnpm|bun install to grab the required packages\n\n* Configure the webhook URL in the Chargebee dashboard with basic auth set to the username and password defined in CHARGEBEE_WEBHOOK_AUTH\n\n* Review chargebee/controllers.ts and make necessary changes\n\n* Wire up the routes in your express app:\n\n\timport chargebeeInit from \"./chargebee/controllers.ts\"\n\tchargebeeInit(app);\n";
+    };
+};

package/dist/help.js

@@ -0,0 +1,58 @@
+export const cliHelpMsg = (version, description) => `
+chargebee-init v${version}
+
+${description}. Supports these popular frameworks:
+
+Next.js v15
+Express v5
+
+And these features using the Chargebee Node SDK:
+
+Checkout (Hosted Pages): One time, subscription and manage payment method
+Webhook: Incoming webhooks
+`;
+const commonPostInit = `Please complete the following steps before you test out the Chargebee integration:
+
+* Define the required process.env.* variables either by adding them to your .env file or replacing them at build time:
+
+	CHARGEBEE_SITE="site-name"
+	CHARGEBEE_API_KEY=""
+	CHARGEBEE_WEBHOOK_AUTH="username:password"
+
+* Run npm|pnpm|bun install to grab the required packages
+
+* Configure the webhook URL in the Chargebee dashboard with basic auth set to the username and password defined in CHARGEBEE_WEBHOOK_AUTH
+`;
+export const messages = {
+    nextjs: {
+        preinit: `
+* --------------------------
+* Chargebee Next.js Adapter
+* --------------------------
+* Integrates with Next.js version 15 
+* Only App Router is supported at the moment
+* Routes will be created under the chargebee directory by default
+`,
+        postinit: `
+${commonPostInit}
+* Review the routes created under the chargebee/ directory and make necessary changes
+`,
+    },
+    express: {
+        preinit: `
+* --------------------------
+* Chargebee Express Adapter
+* --------------------------
+* Integrates with Express version 5
+`,
+        postinit: `
+${commonPostInit}
+* Review chargebee/controllers.ts and make necessary changes
+
+* Wire up the routes in your express app:
+
+	import chargebeeInit from "./chargebee/controllers.ts"
+	chargebeeInit(app);
+`,
+    },
+};

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare const init: () => Promise<void>;

package/dist/init.js

@@ -0,0 +1,66 @@
+import colors from "ansi-colors";
+import Enquirer from "enquirer";
+import { frameworkChecks, preflightChecks } from "./checks.js";
+import { supportedFrameworks } from "./frameworks.js";
+import * as help from "./help.js";
+import { updateDependencies, writePackageJson } from "./package.js";
+import { confirmWritePrompt, gitPrompt, pathPrefixPrompt, targetDirPrompt, } from "./prompts.js";
+import { copyTemplates } from "./templates.js";
+const error = (...lines) => {
+    console.error(`\n${lines.map((line) => colors.red(`✖ ${line}`)).join("\n")}\n`);
+    process.exit(1);
+};
+const checkErrors = ({ errors }) => {
+    const bailErrors = errors.filter((err) => err.bail);
+    if (bailErrors.length > 0) {
+        error(...bailErrors.map((err) => err.msg));
+    }
+};
+export const init = async () => {
+    const cwd = process.cwd();
+    const enquirer = new Enquirer();
+    const { targetDir } = (await enquirer.prompt(targetDirPrompt(cwd)));
+    // General checks
+    const preflightResponse = await preflightChecks(targetDir);
+    checkErrors(preflightResponse);
+    if (preflightResponse.errors.length > 0) {
+        const { gitConfirm } = (await enquirer.prompt(gitPrompt(preflightResponse)));
+        if (!gitConfirm) {
+            error("Did not make any changes");
+        }
+    }
+    // Check target framework and version
+    // biome-ignore lint/style/noNonNullAssertion: pkg will always be available here
+    const pkg = preflightResponse.pkg;
+    const frameworkResponse = await frameworkChecks(pkg);
+    checkErrors(frameworkResponse);
+    if (!frameworkResponse) {
+        throw new Error(`Could not determine framework in package`);
+    }
+    const { pathPrefix } = (await enquirer.prompt(pathPrefixPrompt()));
+    // biome-ignore lint/style/noNonNullAssertion: framework will always be available here
+    const detectedFramework = frameworkResponse.framework;
+    const { confirmWrite } = (await enquirer.prompt(confirmWritePrompt(detectedFramework)));
+    if (!confirmWrite) {
+        console.log(colors.yellow("Not proceeding, did not make any changes"));
+        process.exit(0);
+    }
+    // Copy templates
+    try {
+        const frameworkName = detectedFramework.name;
+        const updatedFiles = copyTemplates({
+            targetDir,
+            framework: frameworkName,
+            frameworkInfo: supportedFrameworks[frameworkName],
+            pathPrefix,
+        });
+        const updatedPkg = updateDependencies(pkg, detectedFramework);
+        writePackageJson(targetDir, updatedPkg);
+        updatedFiles.push(`package.json`);
+        console.log(colors.green(`\nThe following files were created or updated: \n${updatedFiles.join("\n")}\n`));
+        console.log(colors.yellow(help.messages[frameworkName].postinit));
+    }
+    catch (err) {
+        error("Could not copy files to the app directory", err);
+    }
+};

package/dist/package.d.ts

@@ -0,0 +1,5 @@
+import type { PackageManifest } from "@pnpm/types";
+import type { DetectedFramework } from "./frameworks.js";
+export declare function getPackageJson(dir: string): PackageManifest | undefined;
+export declare function updateDependencies(pkg: PackageManifest, framework: DetectedFramework): PackageManifest;
+export declare function writePackageJson(dir: string, pkg: PackageManifest): void;

package/dist/package.js

@@ -0,0 +1,31 @@
+import fs from "node:fs";
+import path from "node:path";
+export function getPackageJson(dir) {
+    try {
+        const pkgJson = fs.readFileSync(path.join(dir, "package.json"), {
+            encoding: "utf8",
+        });
+        return typeof pkgJson === "string"
+            ? JSON.parse(pkgJson)
+            : undefined;
+    }
+    catch (_err) {
+        return undefined;
+    }
+}
+export function updateDependencies(pkg, framework) {
+    var _a;
+    (_a = pkg.dependencies) !== null && _a !== void 0 ? _a : (pkg.dependencies = {});
+    framework.info.dependencies.forEach((dep) => {
+        const [name, version] = dep.split(":");
+        if (name && version && pkg.dependencies) {
+            pkg.dependencies[name] = version;
+        }
+    });
+    return pkg;
+}
+export function writePackageJson(dir, pkg) {
+    fs.writeFileSync(path.join(dir, "package.json"), JSON.stringify(pkg, null, 2), {
+        encoding: "utf8",
+    });
+}

package/dist/prompts.d.ts

@@ -0,0 +1,10 @@
+import type Enquirer from "enquirer";
+import type { PreflightResponse } from "./checks.js";
+import type { DetectedFramework } from "./frameworks.js";
+type Prompt = Parameters<typeof Enquirer.prompt>[0];
+export declare const targetDirPrompt: (cwd: string) => Prompt;
+export declare const gitPrompt: (preflight: PreflightResponse) => Prompt;
+export declare const confirmWritePrompt: (framework: DetectedFramework) => Prompt;
+export declare const apiAuthPrompt: () => Prompt;
+export declare const pathPrefixPrompt: () => Prompt;
+export {};

package/dist/prompts.js

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import colors from "ansi-colors";
+import * as help from "./help.js";
+export const targetDirPrompt = (cwd) => ({
+    type: "text",
+    name: "targetDir",
+    message: `Path to your existing app`,
+    initial: cwd,
+    validate(path) {
+        if (!(fs.existsSync(path) && fs.lstatSync(path).isDirectory())) {
+            return `${path} doesn't exist or is not a directory`;
+        }
+        return true;
+    },
+});
+export const gitPrompt = (preflight) => ({
+    type: "confirm",
+    name: "gitConfirm",
+    message: () => {
+        var _a;
+        return colors.yellow(`${(_a = preflight.errors.filter((err) => !err.bail)[0]) === null || _a === void 0 ? void 0 : _a.msg}. Do you want to continue?`);
+    },
+});
+export const confirmWritePrompt = (framework) => ({
+    type: "confirm",
+    name: "confirmWrite",
+    message: () => `Supported version of ${framework.name} found! Please read these details to continue: \n
+${colors.cyanBright(help.messages[framework.name].preinit)}
+
+The next step is to create the required files and update package.json with the dependencies.
+${colors.green("Do you want to continue?")}`,
+});
+export const apiAuthPrompt = () => [
+    {
+        type: "input",
+        name: "siteName",
+        message: "Site name",
+        initial: "site-test",
+    },
+    {
+        type: "password",
+        name: "apiKey",
+        message() {
+            const siteName = this.state.answers.siteName;
+            const url = `https://${siteName}.chargebee.com/apikeys_and_webhooks/api`;
+            return `API key [${colors.underline(colors.gray(url))}]`;
+        },
+    },
+];
+export const pathPrefixPrompt = () => ({
+    type: "input",
+    name: "pathPrefix",
+    message: "The base path prefix for all the routes created. You can edit the generated files to change this later",
+    initial: "",
+    result(value) {
+        return value.trim() ? `/${value.trim().replace(/^\/*|\/*$/g, "")}` : "";
+    },
+});

package/dist/templates/express/controllers.ts

@@ -0,0 +1,184 @@
+import {
+	type Chargebee,
+	ChargebeeClient,
+	type ChargeInput,
+	createOneTimeCheckout,
+	createPortalSession,
+	createSubscriptionCheckout,
+	type ManageInput,
+	managePaymentSources,
+	type PortalCreateInput,
+	type SubscriptionInput,
+	validateBasicAuth,
+} from "@chargebee/express";
+import type { Application, Request, Response } from "express";
+
+const apiKey = process.env.CHARGEBEE_API_KEY!;
+const site = process.env.CHARGEBEE_SITE!;
+const webhookBasicAuth = process.env.CHARGEBEE_WEBHOOK_AUTH;
+
+const chargebee = new ChargebeeClient({ apiKey, site });
+
+/**
+ * Checkout an item without creating a subscription
+ */
+const chargeController = createOneTimeCheckout({
+	apiKey,
+	site,
+	apiPayload: async (req: Request) => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// https://api-explorer.chargebee.com/item_prices/list_item_prices
+		const { list } = await chargebee.itemPrice.list({
+			item_type: {
+				is: "charge",
+			},
+			status: {
+				is: "active",
+			},
+		});
+
+		return {
+			item_prices: list.map((entry) => ({
+				item_price_id: entry.item_price.id,
+			})),
+			redirect_url: `${req.baseUrl}{{pathPrefix}}/checkout/callback`,
+		} as ChargeInput;
+	},
+});
+
+/**
+ * Create a subscription
+ */
+const subscriptionController = createSubscriptionCheckout({
+	apiKey,
+	site,
+	apiPayload: async (req: Request) => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// https://api-explorer.chargebee.com/item_prices/list_item_prices
+		const { list } = await chargebee.itemPrice.list({
+			limit: 1,
+			item_type: {
+				is: "plan",
+			},
+			status: {
+				is: "active",
+			},
+		});
+
+		return {
+			subscription_items: [{ item_price_id: list[0]?.item_price.id }],
+			redirect_url: `${req.baseUrl}{{pathPrefix}}/checkout/callback`,
+		} as SubscriptionInput;
+	},
+});
+
+/**
+ * Let the customer add/remove payment sources
+ */
+const manageController = managePaymentSources({
+	apiKey,
+	site,
+	apiPayload: async (req: Request) => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// https://apidocs.chargebee.com/docs/api/hosted_pages?lang=node#manage_payment_sources
+		return {
+			customer: {
+				id: "chargebee-customer-id",
+				redirect_url: `${req.baseUrl}{{pathPrefix}}/checkout/callback`,
+				pass_thru_content: crypto.randomUUID(),
+			},
+		} as ManageInput;
+	},
+});
+
+/**
+ * Open the Chargebee portal for the given cutomer ID
+ */
+const portalController = createPortalSession({
+	apiKey,
+	site,
+	apiPayload: async (req: Request) => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// TODO: Return the authenticated customer here
+		return {
+			customer: {
+				id: "chargebee-customer-id",
+			},
+			redirect_url: `${req.baseUrl}/users/`,
+		} as PortalCreateInput;
+	},
+});
+
+/**
+ * Checkout callback function
+ */
+async function callbackController(req: Request, _res: Response) {
+	console.warn(
+		`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+	);
+	const { searchParams } = new URL(req.originalUrl);
+	const id = searchParams.get("id");
+	const state = searchParams.get("state");
+	// TODO: validate state and do something with the hosted page id
+	if (state === "succeeded") {
+		const { hosted_page } = await chargebee.hostedPage.retrieve(id!);
+	}
+}
+
+/**
+ * Handle incoming webhook events
+ */
+async function webhookController(req: Request, _res: Response) {
+	console.warn(
+		`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+	);
+	// HTTP Basic Auth is currently optional when adding a new webhook
+	// url in the Chargebee dashboard. However, we expect it's set by default.
+	// Please set the env variable CHARGEBEE_WEBHOOK_BASIC_AUTH to "user:pass"
+	// which is validated here
+	try {
+		validateBasicAuth(webhookBasicAuth, req.get("authorization"));
+	} catch (error) {
+		console.error(error);
+	}
+
+	const data = req.body as Chargebee.Event;
+	// TODO: handle the incoming webhook data
+	console.log(data);
+}
+
+/**
+ * Initialize the Express app with the Chargebee controllers
+ * @param app Express application
+ * @returns Express application
+ */
+export default function init(
+	app: Application,
+	{ routePrefix = "{{pathPrefix}}" } = {} as { routePrefix: string },
+) {
+	// Checkout
+	app.get(`${routePrefix}/checkout/one-time-charge`, chargeController);
+	app.get(`${routePrefix}/checkout/subscription`, subscriptionController);
+	app.get(`${routePrefix}/checkout/manage-payment-sources`, manageController);
+	app.get(`${routePrefix}/checkout/callback`, callbackController);
+
+	// Portal
+	app.get(`${routePrefix}/portal`, portalController);
+
+	// Webhook
+	app.post(`${routePrefix}/webhook`, webhookController);
+
+	return app;
+}
+
+// Usage:
+// import chargebeeInit from "./chargebee/controllers.ts"
+// chargebeeInit(app);

package/dist/templates/nextjs/checkout/callback/route.ts

@@ -0,0 +1,15 @@
+import { client } from "@chargebee/nextjs";
+import type { NextRequest } from "next/server.js";
+
+export const GET = async (req: NextRequest) => {
+	console.warn(
+		`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+	);
+	const id = req.nextUrl.searchParams.get("id");
+	const state = req.nextUrl.searchParams.get("state");
+	// TODO: validate state and do something with the hosted page id
+	const chargebee = await client.getFromEnv();
+	if (state === "succeeded") {
+		const { hosted_page } = await chargebee.hostedPage.retrieve(id!);
+	}
+};

package/dist/templates/nextjs/checkout/manage-payment-sources/route.ts

@@ -0,0 +1,20 @@
+import { type ManageInput, managePaymentSources } from "@chargebee/nextjs";
+import type { NextRequest } from "next/server.js";
+
+export const GET = managePaymentSources({
+	apiKey: process.env.CHARGEBEE_API_KEY!,
+	site: process.env.CHARGEBEE_SITE!,
+	apiPayload: (req: NextRequest): ManageInput => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// https://apidocs.chargebee.com/docs/api/hosted_pages?lang=node#manage_payment_sources
+		return {
+			customer: {
+				id: "chargebee-customer-id",
+				redirect_url: `${req.nextUrl.origin}{{pathPrefix}}/checkout/callback`,
+				pass_thru_content: crypto.randomUUID(),
+			},
+		} as ManageInput;
+	},
+});

package/dist/templates/nextjs/checkout/one-time-charge/route.ts

@@ -0,0 +1,33 @@
+import {
+	type ChargeInput,
+	client,
+	createOneTimeCheckout,
+} from "@chargebee/nextjs";
+import type { NextRequest } from "next/server.js";
+
+export const GET = createOneTimeCheckout({
+	apiKey: process.env.CHARGEBEE_API_KEY!,
+	site: process.env.CHARGEBEE_SITE!,
+	apiPayload: async (req: NextRequest): Promise<ChargeInput> => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		const chargebee = await client.getFromEnv();
+		// https://api-explorer.chargebee.com/item_prices/list_item_prices
+		const { list } = await chargebee.itemPrice.list({
+			item_type: {
+				is: "charge",
+			},
+			status: {
+				is: "active",
+			},
+		});
+
+		return {
+			item_prices: list.map((entry) => ({
+				item_price_id: entry.item_price.id,
+			})),
+			redirect_url: `${req.nextUrl.origin}{{pathPrefix}}/checkout/callback`,
+		} as ChargeInput;
+	},
+});

package/dist/templates/nextjs/checkout/subscription/route.ts

@@ -0,0 +1,32 @@
+import {
+	client,
+	createSubscriptionCheckout,
+	type SubscriptionInput,
+} from "@chargebee/nextjs";
+import type { NextRequest } from "next/server.js";
+
+export const GET = createSubscriptionCheckout({
+	apiKey: process.env.CHARGEBEE_API_KEY!,
+	site: process.env.CHARGEBEE_SITE!,
+	apiPayload: async (req: NextRequest): Promise<SubscriptionInput> => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		const chargebee = await client.getFromEnv();
+		// https://api-explorer.chargebee.com/item_prices/list_item_prices
+		const { list } = await chargebee.itemPrice.list({
+			limit: 1,
+			item_type: {
+				is: "plan",
+			},
+			status: {
+				is: "active",
+			},
+		});
+
+		return {
+			subscription_items: [{ item_price_id: list[0]?.item_price.id }],
+			redirect_url: `${req.nextUrl.origin}{{pathPrefix}}/checkout/callback`,
+		} as SubscriptionInput;
+	},
+});

package/dist/templates/nextjs/portal/route.ts

@@ -0,0 +1,19 @@
+import { createPortalSession, type PortalCreateInput } from "@chargebee/nextjs";
+import type { NextRequest } from "next/server.js";
+
+export const GET = createPortalSession({
+	apiKey: process.env.CHARGEBEE_API_KEY!,
+	site: process.env.CHARGEBEE_SITE!,
+	apiPayload: async (req: NextRequest): Promise<PortalCreateInput> => {
+		console.warn(
+			`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+		);
+		// TODO: Return the authenticated customer here
+		return {
+			customer: {
+				id: "",
+			},
+			redirect_url: `${req.nextUrl.origin}/users/`,
+		} as PortalCreateInput;
+	},
+});

package/dist/templates/nextjs/webhook/route.ts

@@ -0,0 +1,25 @@
+import { type Chargebee, validateBasicAuth } from "@chargebee/nextjs";
+import { type NextRequest, NextResponse } from "next/server.js";
+
+export async function POST(req: NextRequest) {
+	console.warn(
+		`⚠ This is the default implementation from chargebee-init and must be reviewed!`,
+	);
+	// HTTP Basic Auth is currently optional when adding a new webhook
+	// url in the Chargebee dashboard. However, we expect it's set by default.
+	// Please set the env variable CHARGEBEE_WEBHOOK_BASIC_AUTH to "user:pass"
+	// which is validated here
+	try {
+		validateBasicAuth(
+			process.env.CHARGEBEE_WEBHOOK_AUTH,
+			req.headers.get("authorization"),
+		);
+	} catch (error) {
+		console.error(error);
+		return NextResponse.error();
+	}
+
+	const data = (await req.json()) as Chargebee.Event;
+	// TODO: handle the incoming webhook data
+	console.log(data);
+}

package/dist/templates.d.ts

@@ -0,0 +1,7 @@
+import type { Framework, FrameworkInfo } from "./frameworks.js";
+export declare const copyTemplates: ({ targetDir, framework, frameworkInfo, pathPrefix, }: {
+    targetDir: string;
+    framework: Framework;
+    frameworkInfo: FrameworkInfo;
+    pathPrefix: string;
+}) => string[];

package/dist/templates.js

@@ -0,0 +1,52 @@
+var _a;
+import fs from "node:fs";
+import path from "node:path";
+const __dirname = (_a = globalThis.__dirname) !== null && _a !== void 0 ? _a : import.meta.dirname;
+export const copyTemplates = ({ targetDir, framework, frameworkInfo, pathPrefix = "", }) => {
+    const srcDir = path.join(__dirname, "templates", framework);
+    // Determine app directory to write files to
+    let appDir = targetDir;
+    for (let dir of frameworkInfo.appDirectories) {
+        dir = path.join(appDir, dir);
+        if (fs.existsSync(dir)) {
+            appDir = dir;
+            break;
+        }
+    }
+    if (appDir === targetDir || !fs.existsSync(appDir)) {
+        throw new Error(`Could not find expected directories to copy files to: ${frameworkInfo.appDirectories.join(", ")}`);
+    }
+    const copiedFiles = [];
+    const templatesDir = path.join(appDir, pathPrefix);
+    copyDirectory(srcDir, templatesDir, { pathPrefix }, copiedFiles);
+    return copiedFiles;
+};
+function replaceVariables(text, replacements) {
+    return text.replace(/{{\s*(\w+)\s*}}/g, (_, key) => { var _a; return (_a = replacements[key]) !== null && _a !== void 0 ? _a : ""; });
+}
+// Recursively copy the directory and replace templated strings
+function copyDirectory(srcDir, destDir, replacements, copiedFiles) {
+    // Ensure destination directory exists
+    if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+    }
+    // Read all items in the current source directory
+    const items = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const item of items) {
+        const srcPath = path.join(srcDir, item.name);
+        const destPath = path.join(destDir, item.name);
+        if (item.isDirectory()) {
+            // Recursively copy subdirectory
+            copyDirectory(srcPath, destPath, replacements, copiedFiles);
+        }
+        else if (item.isFile()) {
+            let content = fs.readFileSync(srcPath, "utf-8");
+            // Only perform replacements for .ts files
+            if (path.extname(item.name) === ".ts") {
+                content = replaceVariables(content, replacements);
+            }
+            fs.writeFileSync(destPath, content, "utf-8");
+            copiedFiles.push(destPath);
+        }
+    }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "chargebee-init",
+  "version": "1.0.0-beta.1",
+  "author": {
+    "name": "Chargebee",
+    "email": "dx@chargebee.com"
+  },
+  "description": "A CLI to help integrate Chargebee services with your existing app",
+  "type": "module",
+  "exports": "./dist/cli.js",
+  "bin": {
+    "chargebee-init": "bin/chargebee-init"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "ansi-colors": "^4.1.3",
+    "enquirer": "^2.4.1",
+    "meow": "^13.2.0",
+    "simple-git": "^3.27.0",
+    "semver": "^7.7.2"
+  },
+  "devDependencies": {
+    "@pnpm/types": "^1000.6.0",
+    "@types/semver": "^7.7.0"
+  },
+  "scripts": {
+    "prebuild": "rm -rf dist && mkdir -p dist/templates",
+    "build": "tsc",
+    "postbuild": "for n in nextjs express; do cp -R ../$n/templates dist/templates/$n/; done;",
+    "watch": "pnpm build && tsc --watch"
+  }
+}