pupgram 0.1.3 → 0.2.0

package/README.md

@@ -57,6 +57,42 @@ async function main() {
 main()
 ```
 
+### Creating a Reel
+
+```ts
+import { Instagram, enConfig } from "pupgram"
+
+async function main() {
+    // 1. Initialize the Instagram instance
+    const instagram = await Instagram.create({
+        puppeteer: {
+            userDataDir: ".user-data",
+            headless: "shell",
+        },
+        config: enConfig,
+    })
+
+    // 2. Ensure you are logged in
+    await instagram.ensureLoggedIn({
+        username: "your-username",
+        password: "your-password",
+    })
+
+    // 3. Create a Reel
+    const reelData = await instagram.createReel({
+        filePaths: ["./path/to/video.mp4"],
+        caption: "My awesome Reel! 🎥",
+    })
+
+    console.log(`Reel created! URL: https://www.instagram.com/reel/${reelData.code}`)
+
+    // 4. Close the instance
+    await instagram.close()
+}
+
+main()
+```
+
 ---
 
 ### Features
@@ -76,10 +112,25 @@ Automate content publishing with support for:
 - **Captions**: Add rich text captions to your posts.
 - **Confirmation**: Waiting for server confirmation to ensure the post is live before proceeding.
 
+#### 🎞️ Reel Creation
+
+Automate reel publishing with support for:
+- **Video Upload**: Upload video files.
+- **Aspect Ratio**: Automatically handles ratio selection for Reels (Original/9:16).
+- **Captions**: Add rich text captions.
+
 #### ⚙️ Configurable
 
 Pupgram is designed to be flexible. You can provide custom configurations for different locales or UI variations using the `config` option in `Instagram.create`.
 
+#### 🐞 Debugging
+
+When things go wrong, Pupgram helps you diagnose the issue. If `screenshotOnError` or `htmlContentOnError` are enabled (default: `true`), Pupgram creates an `errors` directory in your project root.
+
+Each error generates a timestamped folder containing:
+- **error.png**: A screenshot of the page at the time of the error.
+- **error.html**: The HTML content of the page.
+
 ---
 
 ## 🧪 Tests (Not included yet, CONTRIBUTE! :D)

package/dist/actions/create-post/index.d.ts

@@ -4,4 +4,4 @@ export * from "./select-files.action";
 export * from "./put-post-caption.action";
 export * from "./click-on-next-button.action";
 export * from "./click-on-share-button.action";
-export * from "./wait-for-configmation.action";
+export * from "./wait-for-post-configure.action";

package/dist/actions/create-post/index.js

@@ -20,4 +20,4 @@ __exportStar(require("./select-files.action"), exports);
 __exportStar(require("./put-post-caption.action"), exports);
 __exportStar(require("./click-on-next-button.action"), exports);
 __exportStar(require("./click-on-share-button.action"), exports);
-__exportStar(require("./wait-for-configmation.action"), exports);
+__exportStar(require("./wait-for-post-configure.action"), exports);

package/dist/actions/create-post/select-files.action.js

@@ -1,25 +1,29 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.selectFilesAction = void 0;
-const delay_util_1 = require("../../utils/delay.util");
+const node_path_1 = __importDefault(require("node:path"));
 const error_1 = require("../../error");
 const selectFilesAction = (filePaths) => {
     return async ({ page, config, logger, defaultTimeout }) => {
         logger.info("Selecting files");
-        const fileInputElement = (await page.waitForSelector(config.fileInputSelector, {
+        const fileInput = (await page.waitForSelector(config.fileInputSelector, {
             timeout: defaultTimeout,
         }));
-        if (!fileInputElement) {
+        if (!fileInput) {
             throw new error_1.InstagramError("File input element not found");
         }
-        await (0, delay_util_1.delay)(500);
-        // logger.debug("File input element found. Making it visible")
-        // await page.evaluate((selector) => {
-        //     const fileInputElement = document.querySelector(selector) as HTMLInputElement
-        //     fileInputElement.style.display = "block"
-        // }, config.fileInputSelector)
-        // logger.debug("File input element visible. Uploading files")
-        await fileInputElement.uploadFile(...filePaths);
+        const absolutePaths = filePaths.map((filePath) => node_path_1.default.resolve(filePath));
+        try {
+            await fileInput.uploadFile(...absolutePaths);
+            logger.debug("Files uploaded via uploadFile");
+        }
+        catch (error) {
+            logger.error(`Failed to upload files: ${error.message}`);
+            throw error;
+        }
         logger.debug("Files selected");
     };
 };

package/dist/actions/create-post/wait-for-configmation.action.js

@@ -3,25 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.waitForConfirmationAction = void 0;
 const error_1 = require("../../error");
 const waitForConfirmationAction = async ({ page, config, logger, defaultTimeout }) => {
-    var _a;
+    var _a, _b;
     logger.info("Waiting for confirmation");
     let result;
-    const configureEndpoint = "/api/v1/media/configure/";
+    const configureEndpoints = ["/api/v1/media/configure/", "/api/v1/media/configure_sidecar/"];
     logger.debug("Waiting for response");
-    const response = await page.waitForResponse((res) => res.url().includes(configureEndpoint) && res.status() === 200 && res.request().method() === "POST", { timeout: 60000 * 2 });
+    const response = await page.waitForResponse((res) => configureEndpoints.some((endpoint) => res.url().includes(endpoint)) &&
+        res.status() === 200 &&
+        res.request().method() === "POST", { timeout: 60000 * 2 });
     const json = await response.json();
-    if (json.status === "ok" && json.media) {
-        const media = json.media;
-        result = {
-            id: media.id,
-            pk: media.pk,
-            code: media.code,
-            caption: ((_a = media.caption) === null || _a === void 0 ? void 0 : _a.text) || "",
-        };
-    }
-    else {
+    if (json.status !== "ok" || !json.media) {
         throw new error_1.InstagramError("Failed to create post");
     }
+    const media = json.media;
+    result = {
+        id: (_a = media.id) !== null && _a !== void 0 ? _a : media.pk,
+        pk: media.pk,
+        code: media.code,
+        caption: ((_b = media.caption) === null || _b === void 0 ? void 0 : _b.text) || "",
+    };
     logger.debug("Response received. Waiting for confirmation text message");
     await page.waitForSelector(`xpath///*[contains(text(), "${config.confirmationText}")]`, {
         timeout: defaultTimeout,

package/dist/actions/create-post/wait-for-post-configure.action.d.ts

@@ -0,0 +1,3 @@
+import { PostData } from "../../interfaces/post-data.interface";
+import { Action } from "../../interfaces";
+export declare const waitForPostConfigureAction: Action<PostData>;

package/dist/actions/create-post/wait-for-post-configure.action.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForPostConfigureAction = void 0;
+const error_1 = require("../../error");
+const waitForPostConfigureAction = async ({ page, config, logger, defaultTimeout }) => {
+    var _a, _b;
+    logger.info("Waiting for confirmation");
+    let result;
+    const configureEndpoints = ["/api/v1/media/configure/", "/api/v1/media/configure_sidecar/"];
+    logger.debug("Waiting for response");
+    const response = await page.waitForResponse((res) => configureEndpoints.some((endpoint) => res.url().includes(endpoint)) &&
+        res.status() === 200 &&
+        res.request().method() === "POST", { timeout: 60000 * 5 });
+    const json = await response.json();
+    if (json.status !== "ok" || !json.media) {
+        throw new error_1.InstagramError("Failed to create post");
+    }
+    const media = json.media;
+    result = {
+        id: (_a = media.id) !== null && _a !== void 0 ? _a : media.pk,
+        pk: media.pk,
+        code: media.code,
+        caption: ((_b = media.caption) === null || _b === void 0 ? void 0 : _b.text) || "",
+    };
+    logger.debug("Response received. Waiting for confirmation text message");
+    await page.waitForSelector(`xpath///*[contains(text(), "${config.confirmationText}")]`, {
+        timeout: defaultTimeout,
+    });
+    logger.debug("Confirmation text message found");
+    return result;
+};
+exports.waitForPostConfigureAction = waitForPostConfigureAction;

package/dist/actions/create-reel/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./select-ratio.action";
+export * from "./try-close-reel-info.action";
+export * from "./wait-for-reel-configurate.action";

package/dist/actions/create-reel/index.js

@@ -0,0 +1,19 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./select-ratio.action"), exports);
+__exportStar(require("./try-close-reel-info.action"), exports);
+__exportStar(require("./wait-for-reel-configurate.action"), exports);

package/dist/actions/create-reel/select-ratio.action.d.ts

@@ -0,0 +1,2 @@
+import { Action } from "../../interfaces";
+export declare const selectRatioAction: Action<void>;

package/dist/actions/create-reel/select-ratio.action.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectRatioAction = void 0;
+const error_1 = require("../../error");
+const selectRatioAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Selecting ratio");
+    const selectRatioSelector = `xpath///button[.//*[name()='svg']//*[name()='title' and text()='${config.reelSelectRatioText}']]`;
+    const videoElement = await page.waitForSelector("video", { timeout: defaultTimeout });
+    if (!videoElement) {
+        throw new error_1.InstagramError("Video element not found");
+    }
+    logger.debug("Video element found");
+    await page.evaluate((videoElement) => {
+        const container = videoElement.closest("div");
+        if (container instanceof HTMLElement) {
+            container.dataset.__oldDisplay = container.style.display;
+            container.style.display = "none";
+        }
+    }, videoElement);
+    logger.debug("Video container display hidden");
+    try {
+        const selectRatioElement = await page.waitForSelector(selectRatioSelector, {
+            timeout: defaultTimeout,
+        });
+        if (!selectRatioElement) {
+            throw new error_1.InstagramError("Select ratio element not found");
+        }
+        await selectRatioElement.click();
+        logger.debug("Select ratio element clicked");
+        const originalRatioElement = await page.waitForSelector(`xpath///div[./span[contains(text(), '${config.reelSelectOriginalRatioText}')]]`, { timeout: defaultTimeout });
+        if (!originalRatioElement) {
+            throw new error_1.InstagramError("Original ratio element not found");
+        }
+        await originalRatioElement.click();
+        logger.debug("Original ratio element clicked");
+    }
+    finally {
+        logger.info("Restoring video container display");
+        await page.evaluate(() => {
+            document.querySelectorAll("div[data-__old-display]").forEach((el) => {
+                const oldDisplay = el.getAttribute("data-__old-display");
+                el.style.display = oldDisplay || "";
+                el.removeAttribute("data-__old-display");
+            });
+        });
+    }
+    logger.debug("Original ratio element clicked");
+};
+exports.selectRatioAction = selectRatioAction;

package/dist/actions/create-reel/try-close-reel-info.action.d.ts

@@ -0,0 +1,2 @@
+import { Action } from "../../interfaces";
+export declare const tryCloseReelInfoAction: Action<void>;

package/dist/actions/create-reel/try-close-reel-info.action.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryCloseReelInfoAction = void 0;
+const tryCloseReelInfoAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Closing reel info");
+    try {
+        const closeButton = await page.waitForSelector(`xpath///button[text()='${config.reelCloseInfoText}']`, {
+            timeout: defaultTimeout * 2,
+        });
+        if (!closeButton) {
+            logger.debug("Close button not found");
+            return;
+        }
+        await closeButton.click();
+        logger.debug("Close button clicked");
+    }
+    catch (error) {
+        logger.debug("Close button not found");
+    }
+};
+exports.tryCloseReelInfoAction = tryCloseReelInfoAction;

package/dist/actions/create-reel/wait-for-reel-configurate.action.d.ts

@@ -0,0 +1,3 @@
+import { PostData } from "../../interfaces/post-data.interface";
+import { Action } from "../../interfaces";
+export declare const waitForReelConfigureAction: Action<PostData>;

package/dist/actions/create-reel/wait-for-reel-configurate.action.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForReelConfigureAction = void 0;
+const waitForReelConfigureAction = async ({ page }) => {
+    var _a;
+    const start = Date.now();
+    const timeout = 5 * 60000;
+    while (Date.now() - start < timeout) {
+        const response = await page.waitForResponse((res) => res.url().includes("/api/v1/media/configure_to_clips/") && res.request().method() === "POST", { timeout: timeout });
+        const json = await response.json();
+        if (json.media) {
+            return {
+                caption: (_a = json.caption.text) !== null && _a !== void 0 ? _a : "",
+                id: json.media.id,
+                pk: json.media.pk,
+                code: json.media.code,
+            };
+        }
+        if (json.status === "fail" && json.message === "Transcode not finished yet.") {
+            continue;
+        }
+        throw new Error(`Unexpected response: ${JSON.stringify(json)}`);
+    }
+    throw new Error("Timeout waiting for Reel configure");
+};
+exports.waitForReelConfigureAction = waitForReelConfigureAction;

package/dist/configs/en.config.js

@@ -16,4 +16,7 @@ exports.enConfig = {
     nextButtonText: "Next",
     confirmationText: "Your post has been shared.",
     shareButtonText: "Share",
+    reelSelectRatioText: "Select crop",
+    reelSelectOriginalRatioText: "Original",
+    reelCloseInfoText: "Ok",
 };

package/dist/configs/pt-br.config.js

@@ -16,4 +16,7 @@ exports.ptBrConfig = {
     nextButtonText: "Avançar",
     confirmationText: "Seu post foi compartilhado.",
     shareButtonText: "Compartilhar",
+    reelSelectRatioText: "Selecionar corte",
+    reelSelectOriginalRatioText: "Original",
+    reelCloseInfoText: "Ok",
 };

package/dist/instagram.d.ts

@@ -49,4 +49,5 @@ export declare class Instagram {
     logIn({ username, password }: LogInOptions): Promise<void>;
     ensureLoggedIn({ username, password }: LogInOptions): Promise<void>;
     createPost({ caption, filePaths }: CreatePostOptions): Promise<PostData>;
+    createReel({ caption, filePaths }: CreatePostOptions): Promise<PostData>;
 }

package/dist/instagram.js

@@ -6,13 +6,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Instagram = exports.defaultTimeout = void 0;
 const puppeteer_extra_plugin_stealth_1 = __importDefault(require("puppeteer-extra-plugin-stealth"));
 const puppeteer_extra_1 = __importDefault(require("puppeteer-extra"));
+const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const create_post_1 = require("./actions/create-post");
 const login_1 = require("./actions/login");
+const create_reel_1 = require("./actions/create-reel");
 const needs_login_action_1 = require("./actions/needs-login.action");
 const logger_helper_1 = require("./helpers/logger.helper");
 const delay_action_1 = require("./actions/delay.action");
-const node_path_1 = __importDefault(require("node:path"));
 puppeteer_extra_1.default.use((0, puppeteer_extra_plugin_stealth_1.default)());
 exports.defaultTimeout = 10000;
 class Instagram {
@@ -60,7 +61,10 @@ class Instagram {
     async initalizePage() {
         this.logger.info("Initalizing page");
         const page = await this.browser.newPage();
-        await page.setViewport({ width: 1920, height: 1080 });
+        await page.setViewport({
+            width: 1920,
+            height: 919,
+        });
         await page.goto(this.baseUrl, { waitUntil: "domcontentloaded" });
         this.logger.debug("Page initalized");
         return page;
@@ -147,10 +151,28 @@ class Instagram {
             create_post_1.clickOnNextButtonAction,
             (0, create_post_1.putPostCaptionAction)(caption),
             create_post_1.clickOnShareButtonAction,
-            create_post_1.waitForConfirmationAction,
+            create_post_1.waitForPostConfigureAction,
         ]);
         this.logger.debug("Post created");
         return result;
     }
+    async createReel({ caption, filePaths }) {
+        this.logger.info("Creating reel");
+        const result = await this.executeWithDiagnostics([
+            (0, delay_action_1.delayAction)(1500),
+            create_post_1.clickOnCreateButtonAction,
+            create_post_1.clickOnPostButtonAction,
+            (0, create_post_1.selectFilesAction)(filePaths),
+            create_reel_1.tryCloseReelInfoAction,
+            create_reel_1.selectRatioAction,
+            create_post_1.clickOnNextButtonAction,
+            create_post_1.clickOnNextButtonAction,
+            (0, create_post_1.putPostCaptionAction)(caption),
+            create_post_1.clickOnShareButtonAction,
+            create_reel_1.waitForReelConfigureAction,
+        ]);
+        this.logger.debug("Reel created");
+        return result;
+    }
 }
 exports.Instagram = Instagram;

package/dist/interfaces/action.interface.d.ts

@@ -5,6 +5,6 @@ export type ActionOptions = {
     config: Config;
     logger: Logger;
     page: Page;
-    defaultTimeout?: number;
+    defaultTimeout: number;
 };
 export type Action<T = void> = (options: ActionOptions) => Promise<T>;

package/dist/interfaces/config.interface.d.ts

@@ -13,4 +13,7 @@ export interface Config {
     nextButtonText: string;
     shareButtonText: string;
     confirmationText: string;
+    reelSelectRatioText: string;
+    reelSelectOriginalRatioText: string;
+    reelCloseInfoText: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pupgram",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "commonjs",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -39,7 +39,6 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "clipboardy": "^5.1.0",
     "puppeteer": "^24.36.1",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",