recurrente-js 1.0.3 → 1.0.5

package/dist/scripts/generate-context.cjs

@@ -0,0 +1,152 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+// --- Configuration ---
+const OUTPUT_DIR = "ai-context";
+const ALLOWED_EXTENSIONS = [
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".json",
+    ".md",
+    ".css",
+    ".prisma",
+    ".env.example",
+    ".sql",
+    ".gitignore",
+];
+// CORRECTED: This list is now for both files and directories.
+const IGNORED_ITEMS = [
+    "node_modules",
+    ".next",
+    ".vercel",
+    "dist",
+    "build",
+    ".git",
+    ".cache",
+    "scripts",
+    "react-email-starter",
+    "package-lock.json", // This will now be correctly ignored
+];
+// --------------------
+/**
+ * Recursively finds all files in a directory that match the allowed extensions.
+ */
+function getAllFiles(dirPath, arrayOfFiles = []) {
+    const items = node_fs_1.default.readdirSync(dirPath, { withFileTypes: true });
+    for (const item of items) {
+        // *** FIX: Check EVERY item (file or directory) against the ignore list first ***
+        if (IGNORED_ITEMS.includes(item.name)) {
+            continue; // Skip this item entirely
+        }
+        const fullPath = node_path_1.default.join(dirPath, item.name);
+        if (item.isDirectory()) {
+            // The ignore check is already done, so we just recurse.
+            getAllFiles(fullPath, arrayOfFiles);
+        }
+        else {
+            // It's a file. The ignore check was already done.
+            // Now, we just check its extension.
+            if (ALLOWED_EXTENSIONS.includes(node_path_1.default.extname(item.name))) {
+                arrayOfFiles.push(fullPath);
+            }
+        }
+    }
+    return arrayOfFiles;
+}
+/**
+ * Generates a timestamp string in the format YYYYMMDD_HHMMSS.
+ */
+function getFormattedTimestamp() {
+    const now = new Date();
+    const YYYY = now.getFullYear();
+    const MM = String(now.getMonth() + 1).padStart(2, "0");
+    const DD = String(now.getDate()).padStart(2, "0");
+    const HH = String(now.getHours()).padStart(2, "0");
+    const mm = String(now.getMinutes()).padStart(2, "0");
+    const ss = String(now.getSeconds()).padStart(2, "0");
+    return `${YYYY}${MM}${DD}_${HH}${mm}${ss}`;
+}
+/**
+ * Main script logic.
+ */
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const targetPath = process.argv[2];
+        if (!targetPath) {
+            console.error("❌ Error: Please provide a file or directory path as an argument.");
+            console.log("   Example: npm run context -- .");
+            process.exit(1);
+        }
+        const fullPath = node_path_1.default.resolve(targetPath);
+        if (!node_fs_1.default.existsSync(fullPath)) {
+            console.error(`❌ Error: Path not found: ${fullPath}`);
+            process.exit(1);
+        }
+        let filesToProcess = [];
+        const stats = node_fs_1.default.statSync(fullPath);
+        if (stats.isDirectory()) {
+            console.log(`🔎 Scanning directory: ${targetPath}`);
+            filesToProcess = getAllFiles(fullPath);
+        }
+        else if (stats.isFile()) {
+            // *** FIX: Also check if a single targeted file is on the ignore list ***
+            if (IGNORED_ITEMS.includes(node_path_1.default.basename(fullPath))) {
+                console.log(`🟡 File '${targetPath}' is in the ignore list. Exiting.`);
+                return;
+            }
+            console.log(`🎯 Targeting single file: ${targetPath}`);
+            if (ALLOWED_EXTENSIONS.includes(node_path_1.default.extname(fullPath))) {
+                filesToProcess = [fullPath];
+            }
+        }
+        if (filesToProcess.length === 0) {
+            console.log("🟡 No relevant files found to process. Exiting.");
+            return;
+        }
+        console.log(`📚 Found ${filesToProcess.length} file(s) to process.`);
+        const outputData = {
+            metadata: {
+                sourcePath: targetPath,
+                timestamp: new Date().toISOString(),
+                fileCount: filesToProcess.length,
+            },
+            files: {},
+        };
+        for (const file of filesToProcess) {
+            const relativePath = node_path_1.default.relative(process.cwd(), file);
+            try {
+                const content = node_fs_1.default.readFileSync(file, "utf-8");
+                outputData.files[relativePath] = content;
+            }
+            catch (error) {
+                console.warn(`⚠️  Could not read file: ${relativePath}`, error);
+            }
+        }
+        // Ensure the output directory exists
+        if (!node_fs_1.default.existsSync(OUTPUT_DIR)) {
+            node_fs_1.default.mkdirSync(OUTPUT_DIR);
+        }
+        const baseName = node_path_1.default.basename(targetPath).replace(/[.\\/]/g, "_");
+        const timestamp = getFormattedTimestamp();
+        const outputFilename = `context-${baseName}-${timestamp}.json`;
+        const outputFilePath = node_path_1.default.join(OUTPUT_DIR, outputFilename);
+        node_fs_1.default.writeFileSync(outputFilePath, JSON.stringify(outputData, null, 2));
+        console.log(`\n✅ Success! Context saved to: ${outputFilePath}`);
+    });
+}
+main().catch(console.error);

package/dist/scripts/generate-context.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/{api → src/api}/recurrente-webhooks.js

@@ -1,16 +1,10 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleWebhookEvent = handleWebhookEvent;
 exports.verifySvixSignature = verifySvixSignature;
 exports.registerWebhookHandler = registerWebhookHandler;
 const svix_1 = require("svix");
 const conversion_1 = require("../utils/conversion");
-const dotenv_1 = __importDefault(require("dotenv"));
-// Load environment variables from .env file if they are not already set
-dotenv_1.default.config();
 /**
  * A record to store the user-registered webhook handlers.
  * Each event type is mapped to its corresponding handler function.

package/dist/{api → src/api}/recurrente.d.ts

@@ -1,4 +1,4 @@
-import { ProductSubscription, CreateSubscriptionResponse, SubscriptionStatusResponse, CreateProductRequest, CreateProductResponse, GetProductResponse, GetAllProductsResponse, UpdateProductRequest, CreateCheckoutRequest, CreateCheckoutResponse } from '../types/globals';
+import { ProductSubscription, CreateSubscriptionResponse, SubscriptionStatusResponse, CreateProductRequest, CreateProductResponse, GetProductResponse, GetAllProductsResponse, UpdateProductRequest } from '../types/globals';
 /**
  * Recurrente API utility for managing product subscriptions, cancellations, and product deletions.
  *
@@ -127,16 +127,5 @@ declare const recurrente: {
      * @see getSubscription
      */
     getSubscription: (subscriptionId: string) => Promise<SubscriptionStatusResponse>;
-    /**
-     * Creates a new checkout session.
-     *
-     * @function
-     * @memberof recurrente.checkouts
-     * @see createCheckout
-     * @param {CreateCheckoutRequest} checkoutData - The details for the checkout session.
-     * @returns {Promise<CreateCheckoutResponse>} A promise that resolves with the checkout ID and URL.
-     * @throws {ErrorResponse} Throws an error if the checkout creation fails.
-     */
-    createCheckout: (checkoutData: CreateCheckoutRequest) => Promise<CreateCheckoutResponse>;
 };
 export default recurrente;

package/dist/{api → src/api}/recurrente.js

@@ -13,30 +13,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const axios_1 = __importDefault(require("axios"));
-const axiosInstance_1 = __importDefault(require("../config/axiosInstance"));
+// CHANGED: We now import the factory function instead of the direct instance.
+const axiosInstance_1 = require("../config/axiosInstance");
 const conversion_1 = require("../utils/conversion");
-// TODO: Implement namespaces
-/**
- * Creates a new checkout session.
- *
- * This function takes checkout data, including items (by product_id or details),
- * converts it to snake_case, and sends it to the API to create a new checkout session.
- * It returns the checkout ID and the URL for redirection.
- *
- * @param {CreateCheckoutRequest} checkoutData - The details for the checkout session.
- * @returns {Promise<CreateCheckoutResponse>} The response containing the checkout ID and URL.
- * @throws {ErrorResponse} Throws an error if the checkout creation fails.
- */
-const createCheckout = (checkoutData) => __awaiter(void 0, void 0, void 0, function* () {
-    try {
-        const checkoutDataInSnakeCase = (0, conversion_1.toSnakeCase)(checkoutData);
-        const response = yield axiosInstance_1.default.post('/checkouts/', checkoutDataInSnakeCase);
-        return (0, conversion_1.toCamelCase)(response.data);
-    }
-    catch (error) {
-        throw handleAxiosError(error);
-    }
-});
 /**
  * Creates a new product with a one-time payment.
  *
@@ -50,8 +29,9 @@ const createCheckout = (checkoutData) => __awaiter(void 0, void 0, void 0, funct
  */
 const createProduct = (productData) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
         const productDataInSnakeCase = (0, conversion_1.toSnakeCase)(productData);
-        const response = yield axiosInstance_1.default.post('/products/', productDataInSnakeCase);
+        const response = yield client.post('/products/', productDataInSnakeCase);
         return (0, conversion_1.toCamelCase)(response.data); // Return the created product's details
     }
     catch (error) {
@@ -71,7 +51,8 @@ const createProduct = (productData) => __awaiter(void 0, void 0, void 0, functio
  */
 const getProduct = (productId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const response = yield axiosInstance_1.default.get(`/products/${productId}`);
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        const response = yield client.get(`/products/${productId}`);
         return (0, conversion_1.toCamelCase)(response.data);
     }
     catch (error) {
@@ -91,7 +72,8 @@ const getProduct = (productId) => __awaiter(void 0, void 0, void 0, function* ()
  */
 const getAllProducts = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (page = 1) {
     try {
-        const response = yield axiosInstance_1.default.get(`/products?page=${page}`);
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        const response = yield client.get(`/products?page=${page}`);
         return (0, conversion_1.toCamelCase)(response.data);
     }
     catch (error) {
@@ -112,8 +94,9 @@ const getAllProducts = (...args_1) => __awaiter(void 0, [...args_1], void 0, fun
  */
 const updateProduct = (productId, productData) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
         const productDataInSnakeCase = (0, conversion_1.toSnakeCase)(productData);
-        const response = yield axiosInstance_1.default.patch(`/products/${productId}`, productDataInSnakeCase);
+        const response = yield client.patch(`/products/${productId}`, productDataInSnakeCase);
         return (0, conversion_1.toCamelCase)(response.data); // Return the updated product's details
     }
     catch (error) {
@@ -133,8 +116,9 @@ const updateProduct = (productId, productData) => __awaiter(void 0, void 0, void
  */
 const createSubscription = (productData) => __awaiter(void 0, void 0, void 0, function* () {
     try {
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
         const productDataInSnakeCase = (0, conversion_1.toSnakeCase)(productData);
-        const response = yield axiosInstance_1.default.post('/products/', productDataInSnakeCase);
+        const response = yield client.post('/products/', productDataInSnakeCase);
         return (0, conversion_1.toCamelCase)(response.data); // Return the success response only
     }
     catch (error) {
@@ -154,7 +138,8 @@ const createSubscription = (productData) => __awaiter(void 0, void 0, void 0, fu
  */
 const cancelSubscription = (subscriptionId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const response = yield axiosInstance_1.default.delete(`/subscriptions/${subscriptionId}`);
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        const response = yield client.delete(`/subscriptions/${subscriptionId}`);
         return {
             message: `Subscription canceled successfully. Status: ${response.status}`,
         };
@@ -175,7 +160,8 @@ const cancelSubscription = (subscriptionId) => __awaiter(void 0, void 0, void 0,
  */
 const deleteProduct = (productId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        yield axiosInstance_1.default.delete(`/products/${productId}`);
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        yield client.delete(`/products/${productId}`);
         return { message: 'Product deleted successfully' };
     }
     catch (error) {
@@ -194,7 +180,8 @@ const deleteProduct = (productId) => __awaiter(void 0, void 0, void 0, function*
  */
 const getSubscription = (subscriptionId) => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const response = yield axiosInstance_1.default.get(`/subscriptions/${subscriptionId}`);
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        const response = yield client.get(`/subscriptions/${subscriptionId}`);
         return (0, conversion_1.toCamelCase)(response.data);
     }
     catch (error) {
@@ -242,7 +229,8 @@ function handleAxiosError(error) {
  */
 const test = () => __awaiter(void 0, void 0, void 0, function* () {
     try {
-        const response = yield axiosInstance_1.default.get('/test');
+        const client = (0, axiosInstance_1.getClient)(); // <-- Get client instance at runtime
+        const response = yield client.get('/test');
         return {
             message: `Test request succeeded. Status: ${response.data.message}`,
         };
@@ -373,16 +361,5 @@ const recurrente = {
      * @see getSubscription
      */
     getSubscription,
-    /**
-     * Creates a new checkout session.
-     *
-     * @function
-     * @memberof recurrente.checkouts
-     * @see createCheckout
-     * @param {CreateCheckoutRequest} checkoutData - The details for the checkout session.
-     * @returns {Promise<CreateCheckoutResponse>} A promise that resolves with the checkout ID and URL.
-     * @throws {ErrorResponse} Throws an error if the checkout creation fails.
-     */
-    createCheckout,
 };
 exports.default = recurrente;

package/dist/src/config/axiosInstance.d.ts

@@ -0,0 +1,8 @@
+import { type AxiosInstance } from 'axios';
+/**
+ * Factory function to get a configured Axios instance for Recurrente.
+ * It uses a singleton pattern to ensure the client is only created once per server instance.
+ * @returns {AxiosInstance} The configured Axios client.
+ * @throws {Error} If environment variables are missing AT RUNTIME.
+ */
+export declare function getClient(): AxiosInstance;

package/dist/src/config/axiosInstance.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClient = getClient;
+const axios_1 = __importDefault(require("axios"));
+// 1. This variable will hold our single client instance. It starts as null.
+let _clientInstance = null;
+/**
+ * Factory function to get a configured Axios instance for Recurrente.
+ * It uses a singleton pattern to ensure the client is only created once per server instance.
+ * @returns {AxiosInstance} The configured Axios client.
+ * @throws {Error} If environment variables are missing AT RUNTIME.
+ */
+function getClient() {
+    // 2. If the instance already exists, return it immediately.
+    if (_clientInstance) {
+        return _clientInstance;
+    }
+    // 3. If it doesn't exist, this is the first time the function is called.
+    //    Now, and only now, do we read the environment variables.
+    const baseURL = process.env.RECURRENTE_BASE_URL;
+    const publicKey = process.env.RECURRENTE_PUBLIC_KEY;
+    const secretKey = process.env.RECURRENTE_SECRET_KEY;
+    // 4. Validate the secrets. This will throw a clear error at runtime if they are missing.
+    if (!baseURL) {
+        throw new Error('Missing Recurrente base URL at runtime. Check your environment variables.');
+    }
+    if (!publicKey) {
+        throw new Error('Missing Recurrente Public Key at runtime. Check your environment variables.');
+    }
+    if (!secretKey) {
+        throw new Error('Missing Recurrente Secret Key at runtime. Check your environment variables.');
+    }
+    // 5. Create the new Axios instance.
+    const client = axios_1.default.create({
+        baseURL: `${baseURL}/api`,
+        headers: {
+            'X-PUBLIC-KEY': publicKey,
+            'X-SECRET-KEY': secretKey,
+            'Content-Type': 'application/json',
+        },
+    });
+    // 6. Store the newly created instance in our private variable and return it.
+    _clientInstance = client;
+    return _clientInstance;
+}

package/dist/{types → src/types}/globals.d.ts

@@ -1333,3 +1333,57 @@ export type RecurrenteWebhookEvent = PaymentIntentSucceeded | PaymentIntentFaile
  * @param event - The webhook event object.
  */
 export type WebhookHandler<T> = (event: T) => void;
+/**
+ * Represents the payload for creating a refund.
+ */
+export interface CreateRefundRequest {
+    /**
+     * The ID of the payment intent (`pa_...`) to be refunded.
+     * @required
+     */
+    paymentIntentId: string;
+}
+/**
+ * Represents the response after successfully creating a refund.
+ */
+export interface CreateRefundResponse {
+    /**
+     * The unique identifier for the refund object (e.g., "re_...").
+     * @required
+     */
+    id: string;
+    /**
+     * The status of the refund.
+     * @required
+     */
+    status: 'succeeded' | 'pending' | 'failed';
+    /**
+     * The customer associated with the refunded payment.
+     * @required
+     */
+    customer: {
+        id: string;
+        email: string;
+        fullName: string;
+    };
+    /**
+     * The amount in cents that was refunded to your account balance.
+     * @required
+     */
+    accountRefundedAmountInCents: number;
+    /**
+     * The amount in cents that was refunded to the customer.
+     * @required
+     */
+    customerRefundedAmountInCents: number;
+    /**
+     * The currency of the refund.
+     * @required
+     */
+    currency: string;
+    /**
+     * The timestamp of when the refund was created.
+     * @required
+     */
+    createdAt: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recurrente-js",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "main": "./dist/index.js",
   "types": "./dist/globals.d.ts",
   "exports": {
@@ -20,7 +20,8 @@
     "prepare": "npm.cmd run compile",
     "pretest": "npm.cmd run compile",
     "posttest": "npm.cmd run lint",
-    "dev": "nodemon -w *.ts -e ts -x ts-node --files -H -T ./src/index.ts"
+    "dev": "nodemon -w *.ts -e ts -x ts-node --files -H -T ./src/index.ts",
+    "context": "ts-node scripts/generate-context.cts"
   },
   "author": "Axel Aguilar",
   "license": "MIT",

package/dist/config/axiosInstance.d.ts

@@ -1,3 +0,0 @@
-import { AxiosInstance } from 'axios';
-declare const client: AxiosInstance;
-export default client;

package/dist/config/axiosInstance.js

@@ -1,65 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const axios_1 = __importDefault(require("axios"));
-const dotenv = __importStar(require("dotenv"));
-// Load environment variables from .env file
-dotenv.config();
-const baseURL = process.env.RECURRENTE_BASE_URL;
-const publicKey = process.env.RECURRENTE_PUBLIC_KEY;
-const secretKey = process.env.RECURRENTE_SECRET_KEY;
-if (!baseURL) {
-    throw new Error('Missing Recurrente base URL');
-}
-if (!publicKey) {
-    throw new Error('Missing Recurrente Public Key');
-}
-if (!secretKey) {
-    throw new Error('Missing Recurrente Secret Key');
-}
-// Create an Axios instance with configuration
-const client = axios_1.default.create({
-    baseURL: `${baseURL}/api`,
-    headers: {
-        'X-PUBLIC-KEY': publicKey,
-        'X-SECRET-KEY': secretKey,
-        'Content-Type': 'application/json',
-    },
-});
-// Export the Axios instance for use in other parts of the package
-exports.default = client;