pupgram 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcuth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# Pupgram
+
+**Pupgram** is a powerful automation library for Instagram built on top of `puppeteer`. It simplifies the process of interacting with Instagram programmatically, allowing you to log in, create posts, and manage your account with ease.
+
+## 📦 Installation
+
+Installation is straightforward; just use your preferred package manager. Here is an example using NPM:
+
+```bash
+npm i pupgram
+```
+
+## 🚀 Usage
+
+<a href="https://www.buymeacoffee.com/marcuth">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="200">
+</a>
+
+### Basic Example
+
+Here is how to use `Pupgram` to log in and create a post.
+
+```ts
+import { Instagram, enConfig } from "pupgram"
+
+async function main() {
+    // 1. Initialize the Instagram instance
+    const instagram = await Instagram.create({
+        puppeteer: {
+            userDataDir: ".user-data", // Persist session
+            headless: "shell",
+        },
+        logLevel: "debug",
+        screenshotOnError: true,
+        config: enConfig, // Use English selectors/config
+    })
+
+    // 2. Ensure you are logged in
+    await instagram.ensureLoggedIn({
+        username: "your-username",
+        password: "your-password",
+    })
+
+    // 3. Create a post
+    const postData = await instagram.createPost({
+        filePaths: ["./path/to/image.png"],
+        caption: "Hello from Pupgram! 🚀",
+    })
+
+    console.log(`Post created! URL: https://www.instagram.com/p/${postData.code}`)
+    console.log(postData)
+
+    // 4. Close the instance
+    await instagram.close()
+}
+
+main()
+```
+
+---
+
+### Features
+
+#### 🤖 Automated Interactions
+
+Pupgram handles the complex DOM interactions required to navigate Instagram, including handling dialogues, buttons, and inputs.
+
+#### 🔐 Login Management
+
+Easily manage user sessions. `ensureLoggedIn` checks if a valid session exists and only performs a full login flow if necessary, saving time and reducing friction.
+
+#### 📸 Post Creation
+
+Automate content publishing with support for:
+- **Multiple Files**: Upload one or more images/videos.
+- **Captions**: Add rich text captions to your posts.
+- **Confirmation**: Waiting for server confirmation to ensure the post is live before proceeding.
+
+#### ⚙️ 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`.
+
+---
+
+## 🧪 Tests (Not included yet, CONTRIBUTE! :D)
+
+Automated tests are located in `__tests__`. To run them:
+
+```bash
+npm run test
+```
+
+## 🤝 Contributing
+
+Want to contribute? Follow these steps:
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature-new`).
+3. Commit your changes (`git commit -m 'Add new feature'`).
+4. Push to the branch (`git push origin feature-new`).
+5. Open a Pull Request.
+
+## 📝 License
+
+This project is licensed under the MIT License.

package/dist/actions/create-post/click-on-create-button.action.d.ts

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

package/dist/actions/create-post/click-on-create-button.action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickOnCreateButtonAction = void 0;
+const utils_1 = require("../../utils");
+const error_1 = require("../../error");
+const clickOnCreateButtonAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Clicking on create button");
+    const createButton = await page.waitForSelector(`xpath///*[contains(text(), '${config.createButtonText}')]`, {
+        timeout: defaultTimeout,
+    });
+    if (!createButton) {
+        throw new error_1.InstagramError("Create button not found");
+    }
+    logger.debug("Create button found. Clicking on it");
+    await (0, utils_1.evaluatedClick)(page, createButton);
+    logger.debug("Create button clicked");
+};
+exports.clickOnCreateButtonAction = clickOnCreateButtonAction;

package/dist/actions/create-post/click-on-next-button.action.d.ts

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

package/dist/actions/create-post/click-on-next-button.action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickOnNextButtonAction = void 0;
+const utils_1 = require("../../utils");
+const error_1 = require("../../error");
+const clickOnNextButtonAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Clicking on next button");
+    const nextButton = await page.waitForSelector(`xpath///*[contains(text(), '${config.nextButtonText}')]`, {
+        timeout: defaultTimeout,
+    });
+    if (!nextButton) {
+        throw new error_1.InstagramError("Next button not found");
+    }
+    logger.debug("Next button found. Clicking on it");
+    await (0, utils_1.evaluatedClick)(page, nextButton);
+    logger.debug("Next button clicked");
+};
+exports.clickOnNextButtonAction = clickOnNextButtonAction;

package/dist/actions/create-post/click-on-post-button.action.d.ts

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

package/dist/actions/create-post/click-on-post-button.action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickOnPostButtonAction = void 0;
+const utils_1 = require("../../utils");
+const error_1 = require("../../error");
+const clickOnPostButtonAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Clicking on post button");
+    const postButton = await page.waitForSelector(`xpath///*[contains(text(), '${config.postButtonText}')]`, {
+        timeout: defaultTimeout,
+    });
+    if (!postButton) {
+        throw new error_1.InstagramError("Post button not found");
+    }
+    logger.debug("Post button found. Clicking on it");
+    await (0, utils_1.evaluatedClick)(page, postButton);
+    logger.debug("Post button clicked");
+};
+exports.clickOnPostButtonAction = clickOnPostButtonAction;

package/dist/actions/create-post/click-on-share-button.action.d.ts

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

package/dist/actions/create-post/click-on-share-button.action.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickOnShareButtonAction = void 0;
+const utils_1 = require("../../utils");
+const error_1 = require("../../error");
+const clickOnShareButtonAction = async ({ page, config, logger, defaultTimeout }) => {
+    logger.info("Clicking on share button");
+    const shareButton = await page.waitForSelector(`xpath///div[@role='button' and (text()='${config.shareButtonText}')]`, {
+        timeout: defaultTimeout,
+    });
+    if (!shareButton) {
+        throw new error_1.InstagramError("Share button not found");
+    }
+    logger.debug("Share button found. Clicking on it");
+    await (0, utils_1.evaluatedClick)(page, shareButton);
+    logger.debug("Share button clicked");
+};
+exports.clickOnShareButtonAction = clickOnShareButtonAction;

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

@@ -0,0 +1,7 @@
+export * from "./click-on-create-button.action";
+export * from "./click-on-post-button.action";
+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";

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

@@ -0,0 +1,23 @@
+"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("./click-on-create-button.action"), exports);
+__exportStar(require("./click-on-post-button.action"), exports);
+__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);

package/dist/actions/create-post/put-post-caption.action.d.ts

@@ -0,0 +1,2 @@
+import { ActionFactory } from "../../interfaces";
+export declare const putPostCaptionAction: ActionFactory;

package/dist/actions/create-post/put-post-caption.action.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.putPostCaptionAction = void 0;
+const error_1 = require("../../error");
+const delay_util_1 = require("../../utils/delay.util");
+const putPostCaptionAction = (caption) => {
+    return async ({ page, config, logger, defaultTimeout }) => {
+        logger.info("Starting to put post caption");
+        const captionElement = await page.waitForSelector(config.captionInputSelector, {
+            timeout: defaultTimeout,
+        });
+        if (!captionElement) {
+            logger.error("Failed to find caption input element");
+            throw new error_1.InstagramError("Caption element not found");
+        }
+        logger.debug("Caption element located. Focusing and typing caption...");
+        await captionElement.focus();
+        await page.keyboard.type(caption);
+        await page.keyboard.press("Tab");
+        await (0, delay_util_1.delay)(300);
+        logger.info("Post caption successfully entered");
+    };
+};
+exports.putPostCaptionAction = putPostCaptionAction;

package/dist/actions/create-post/select-files.action.d.ts

@@ -0,0 +1,2 @@
+import { ActionFactory } from "../../interfaces";
+export declare const selectFilesAction: ActionFactory;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectFilesAction = void 0;
+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, {
+            timeout: defaultTimeout,
+        }));
+        if (!fileInputElement) {
+            throw new error_1.InstagramError("File input element not found");
+        }
+        logger.debug("File input element found. Making it visible");
+        await page.evaluate((selector) => {
+            const fileInputElement = document.querySelector(selector);
+            fileInputElement.style.display = "block";
+        }, config.fileInputSelector);
+        logger.debug("File input element visible. Uploading files");
+        await fileInputElement.uploadFile(...filePaths);
+        logger.debug("Files selected");
+    };
+};
+exports.selectFilesAction = selectFilesAction;

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

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

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForConfirmationAction = void 0;
+const error_1 = require("../../error");
+const waitForConfirmationAction = async ({ page, config, logger, defaultTimeout }) => {
+    var _a;
+    logger.info("Waiting for confirmation");
+    let result;
+    const configureEndpoint = "/api/v1/media/configure/";
+    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 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 {
+        throw new error_1.InstagramError("Failed to create post");
+    }
+    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.waitForConfirmationAction = waitForConfirmationAction;

package/dist/actions/delay.action.d.ts

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

package/dist/actions/delay.action.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delayAction = void 0;
+const delay_util_1 = require("../utils/delay.util");
+const delayAction = (delayTime) => {
+    return async ({ logger }) => {
+        logger.info("Delaying");
+        await (0, delay_util_1.delay)(delayTime);
+        logger.debug("Delaying");
+    };
+};
+exports.delayAction = delayAction;

package/dist/actions/login/click-on-login-button.action.d.ts

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

package/dist/actions/login/click-on-login-button.action.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clickOnLoginButtonAction = void 0;
+const utils_1 = require("../../utils");
+const error_1 = require("../../error");
+const clickOnLoginButtonAction = async ({ config, logger, page, defaultTimeout }) => {
+    logger.debug("Clicking on login button");
+    const loginButton = await Promise.race([
+        page.waitForSelector(`xpath///div[@role='button'][.//text()[normalize-space()='${config.loginButtonText}']]`, {
+            timeout: defaultTimeout,
+        }),
+        page.waitForSelector(config.alternativeLoginButtonSelector, { timeout: defaultTimeout }),
+    ]);
+    if (!loginButton) {
+        logger.error("Login button not found");
+        throw new error_1.InstagramError("Login button not found");
+    }
+    logger.debug("Login button found. Clicking on it...");
+    await (0, utils_1.evaluatedClick)(page, loginButton);
+    await page.waitForNavigation();
+    logger.debug("Login button clicked");
+};
+exports.clickOnLoginButtonAction = clickOnLoginButtonAction;

package/dist/actions/login/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./type-username.action";
+export * from "./type-password.action";
+export * from "./click-on-login-button.action";
+export * from "./try-close-notifications-dialog.action";

package/dist/actions/login/index.js

@@ -0,0 +1,20 @@
+"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("./type-username.action"), exports);
+__exportStar(require("./type-password.action"), exports);
+__exportStar(require("./click-on-login-button.action"), exports);
+__exportStar(require("./try-close-notifications-dialog.action"), exports);

package/dist/actions/login/try-close-notifications-dialog.action.d.ts

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

package/dist/actions/login/try-close-notifications-dialog.action.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryCloseNotificationsDialogAction = void 0;
+const utils_1 = require("../../utils");
+const tryCloseNotificationsDialogAction = async ({ config, logger, page, defaultTimeout }) => {
+    logger.debug("Trying to close notifications dialog");
+    const closeButton = await page.waitForSelector(`xpath///*[contains(text(), '${config.closeNotificationsDialogText}')]`, { timeout: defaultTimeout });
+    if (!closeButton) {
+        logger.debug("Close button not found");
+        return;
+    }
+    logger.debug("Close button found. Clicking on it...");
+    await (0, utils_1.evaluatedClick)(page, closeButton);
+    logger.debug("Close button clicked");
+};
+exports.tryCloseNotificationsDialogAction = tryCloseNotificationsDialogAction;

package/dist/actions/login/type-password.action.d.ts

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

package/dist/actions/login/type-password.action.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typePasswordAction = void 0;
+const typePasswordAction = (password) => {
+    return async ({ config, logger, page, defaultTimeout }) => {
+        logger.debug("Typing password");
+        const passwordInput = await page.waitForSelector(config.passwordInputSelector, { timeout: defaultTimeout });
+        if (!passwordInput) {
+            logger.error("Password input not found");
+            throw new Error("Password input not found");
+        }
+        await passwordInput.type(password);
+        logger.debug("Password typed");
+    };
+};
+exports.typePasswordAction = typePasswordAction;

package/dist/actions/login/type-username.action.d.ts

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

package/dist/actions/login/type-username.action.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeUsernameAction = void 0;
+const typeUsernameAction = (username) => {
+    return async ({ config, logger, page, defaultTimeout }) => {
+        logger.debug("Typing username");
+        const usernameInput = await page.waitForSelector(config.usernameInputSelector, { timeout: defaultTimeout });
+        if (!usernameInput) {
+            logger.error("Username input not found");
+            throw new Error("Username input not found");
+        }
+        await usernameInput.type(username);
+        logger.debug("Username typed");
+    };
+};
+exports.typeUsernameAction = typeUsernameAction;

package/dist/actions/needs-login.action.d.ts

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

package/dist/actions/needs-login.action.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsLoginAction = void 0;
+const needsLoginAction = async ({ config, logger, page }) => {
+    let needsLogin = true;
+    logger.debug("Checking if needs login");
+    const loginTextElement = await page.$(`xpath///*[contains(text(), "${config.loginText}") or contains(text(), "${config.loginTextAlternative}")]`);
+    logger.debug("Login text element found: ", loginTextElement);
+    if (loginTextElement) {
+        logger.debug("Needs login");
+        needsLogin = true;
+    }
+    else {
+        logger.debug("Does not need login");
+        needsLogin = false;
+    }
+    return needsLogin;
+};
+exports.needsLoginAction = needsLoginAction;

package/dist/configs/en.config.d.ts

@@ -0,0 +1,2 @@
+import { Config } from "../interfaces";
+export declare const enConfig: Config;

package/dist/configs/en.config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enConfig = void 0;
+exports.enConfig = {
+    loginText: "Log in",
+    loginTextAlternative: "Don't have an account?",
+    usernameInputSelector: "input[name='email'], input[name='username']",
+    passwordInputSelector: "input[name='pass'], input[name='password']",
+    loginButtonText: "Log in",
+    alternativeLoginButtonSelector: "button[type='submit']",
+    closeNotificationsDialogText: "Not now",
+    createButtonText: "Create",
+    postButtonText: "Post",
+    fileInputSelector: "input[type='file'][multiple]",
+    captionInputSelector: "div[role='textbox']",
+    nextButtonText: "Next",
+    confirmationText: "Your post has been shared.",
+    shareButtonText: "Share",
+};

package/dist/configs/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./en.config";
+export * from "./pt-br.config";

package/dist/configs/index.js

@@ -0,0 +1,18 @@
+"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("./en.config"), exports);
+__exportStar(require("./pt-br.config"), exports);

package/dist/configs/pt-br.config.d.ts

@@ -0,0 +1,2 @@
+import { Config } from "../interfaces";
+export declare const ptBrConfig: Config;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ptBrConfig = void 0;
+exports.ptBrConfig = {
+    loginText: "Entrar no Instagram",
+    loginTextAlternative: "Não tem uma conta?",
+    usernameInputSelector: "input[name='email'], input[name='username']",
+    passwordInputSelector: "input[name='pass'], input[name='password']",
+    loginButtonText: "Entrar",
+    alternativeLoginButtonSelector: "button[type='submit']",
+    closeNotificationsDialogText: "Agora não",
+    createButtonText: "Criar",
+    postButtonText: "Postar",
+    fileInputSelector: "input[type='file'][multiple]",
+    captionInputSelector: "div[role='textbox']",
+    nextButtonText: "Avançar",
+    confirmationText: "Seu post foi compartilhado.",
+    shareButtonText: "Compartilhar",
+};

package/dist/error.d.ts

@@ -0,0 +1,3 @@
+export declare class InstagramError extends Error {
+    constructor(message: string);
+}

package/dist/error.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstagramError = void 0;
+class InstagramError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InstagramError";
+    }
+}
+exports.InstagramError = InstagramError;

package/dist/helpers/logger.helper.d.ts

@@ -0,0 +1,2 @@
+import winston from "winston";
+export declare function createLogger(name: string, level?: string): winston.Logger;

package/dist/helpers/logger.helper.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const winston_1 = __importDefault(require("winston"));
+function createLogger(name, level = "info") {
+    return winston_1.default.createLogger({
+        level: level,
+        format: winston_1.default.format.json(),
+        defaultMeta: { service: name },
+        transports: [new winston_1.default.transports.Console()],
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./configs";
+export * from "./instagram";

package/dist/index.js

@@ -0,0 +1,18 @@
+"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("./configs"), exports);
+__exportStar(require("./instagram"), exports);

package/dist/instagram.d.ts

@@ -0,0 +1,52 @@
+import { Browser } from "puppeteer";
+import { PostData } from "./interfaces/post-data.interface";
+import { Config } from "./interfaces";
+export declare const defaultTimeout = 10000;
+export type CreateInstagramOptions = {
+    puppeteer: {
+        headless?: boolean | "new" | "shell";
+        executablePath?: string;
+        userDataDir: string;
+        extraArgs?: string[];
+    };
+    logLevel?: "debug" | "info" | "warn" | "error";
+    screenshotOnError?: boolean;
+    htmlContentOnError?: boolean;
+    config: Config;
+    defaultTimeout?: number;
+};
+export type InstagramOptions = {
+    browser: Browser;
+    logLevel: "debug" | "info" | "warn" | "error";
+    screenshotOnError: boolean;
+    htmlContentOnError: boolean;
+    config: Config;
+    defaultTimeout?: number;
+};
+export type LogInOptions = {
+    username: string;
+    password: string;
+};
+export type CreatePostOptions = {
+    filePaths: string[];
+    caption: string;
+};
+export declare class Instagram {
+    readonly baseUrl = "https://www.instagram.com";
+    private readonly browser;
+    readonly logLevel: "debug" | "info" | "warn" | "error";
+    private readonly logger;
+    private readonly screenshotOnError;
+    private readonly htmlContentOnError;
+    readonly config: Config;
+    readonly defaultTimeout: number;
+    constructor({ browser, logLevel, screenshotOnError, htmlContentOnError, config, defaultTimeout: optionsDefaultTimeout, }: InstagramOptions);
+    static create(options: CreateInstagramOptions): Promise<Instagram>;
+    close(): Promise<void>;
+    private initalizePage;
+    private executeWithDiagnostics;
+    needsLogin(): Promise<boolean>;
+    logIn({ username, password }: LogInOptions): Promise<void>;
+    ensureLoggedIn({ username, password }: LogInOptions): Promise<void>;
+    createPost({ caption, filePaths }: CreatePostOptions): Promise<PostData>;
+}

package/dist/instagram.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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_fs_1 = __importDefault(require("node:fs"));
+const create_post_1 = require("./actions/create-post");
+const login_1 = require("./actions/login");
+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");
+puppeteer_extra_1.default.use((0, puppeteer_extra_plugin_stealth_1.default)());
+exports.defaultTimeout = 10000;
+class Instagram {
+    constructor({ browser, logLevel, screenshotOnError, htmlContentOnError, config, defaultTimeout: optionsDefaultTimeout, }) {
+        this.baseUrl = "https://www.instagram.com";
+        this.browser = browser;
+        this.logLevel = logLevel;
+        this.logger = (0, logger_helper_1.createLogger)("Instagram", logLevel);
+        this.screenshotOnError = screenshotOnError;
+        this.htmlContentOnError = htmlContentOnError;
+        this.config = config;
+        this.defaultTimeout = optionsDefaultTimeout !== null && optionsDefaultTimeout !== void 0 ? optionsDefaultTimeout : exports.defaultTimeout;
+    }
+    static async create(options) {
+        var _a, _b, _c, _d;
+        const browser = await puppeteer_extra_1.default.launch({
+            headless: options.puppeteer.headless,
+            executablePath: options.puppeteer.executablePath,
+            userDataDir: options.puppeteer.userDataDir,
+            args: [
+                "--start-maximized",
+                "--lang=pt-BR",
+                "--accept-lang=pt-BR,pt;q=0.9",
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-dev-shm-usage",
+                "--disable-blink-features=AutomationControlled",
+                ...((_a = options.puppeteer.extraArgs) !== null && _a !== void 0 ? _a : []),
+            ],
+        });
+        return new Instagram({
+            browser: browser,
+            logLevel: (_b = options.logLevel) !== null && _b !== void 0 ? _b : "info",
+            screenshotOnError: (_c = options.screenshotOnError) !== null && _c !== void 0 ? _c : true,
+            htmlContentOnError: (_d = options.htmlContentOnError) !== null && _d !== void 0 ? _d : true,
+            config: options.config,
+            defaultTimeout: options.defaultTimeout,
+        });
+    }
+    async close() {
+        this.logger.info("Closing browser");
+        await this.browser.close();
+        this.logger.debug("Browser closed");
+    }
+    async initalizePage() {
+        this.logger.info("Initalizing page");
+        const page = await this.browser.newPage();
+        await page.setViewport({ width: 1920, height: 1080 });
+        await page.goto(this.baseUrl, { waitUntil: "networkidle2" });
+        this.logger.debug("Page initalized");
+        return page;
+    }
+    async executeWithDiagnostics(actions) {
+        const page = await this.initalizePage();
+        try {
+            let result;
+            for (const action of actions) {
+                result = await action({
+                    config: this.config,
+                    logger: this.logger,
+                    page: page,
+                    defaultTimeout: this.defaultTimeout,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            this.logger.error(error);
+            const errorsDir = "errors";
+            const currentErrorDir = `${errorsDir}/error-${Date.now()}`;
+            if (this.screenshotOnError || this.htmlContentOnError) {
+                this.logger.info("Creating error directory");
+                await node_fs_1.default.promises.mkdir(currentErrorDir, { recursive: true });
+                this.logger.debug("Error directory created");
+            }
+            if (this.screenshotOnError) {
+                this.logger.info("Taking screenshot");
+                await page.screenshot({ path: `${currentErrorDir}/error.png` });
+                this.logger.debug("Screenshot taken");
+            }
+            if (this.htmlContentOnError) {
+                const htmlContent = await page.content();
+                await node_fs_1.default.promises.writeFile(`${currentErrorDir}/error.html`, htmlContent);
+            }
+            throw error;
+        }
+        finally {
+            await page.close();
+        }
+    }
+    async needsLogin() {
+        this.logger.info("Checking if needs login");
+        const page = await this.initalizePage();
+        const needsLogin = await (0, needs_login_action_1.needsLoginAction)({
+            config: this.config,
+            logger: this.logger,
+            page: page,
+            defaultTimeout: this.defaultTimeout,
+        });
+        await page.close();
+        this.logger.debug(`Needs login: ${needsLogin}`);
+        return needsLogin;
+    }
+    async logIn({ username, password }) {
+        this.logger.info("Logging in");
+        await this.executeWithDiagnostics([
+            (0, login_1.typeUsernameAction)(username),
+            (0, login_1.typePasswordAction)(password),
+            login_1.clickOnLoginButtonAction,
+            login_1.tryCloseNotificationsDialogAction,
+        ]);
+        this.logger.debug("Logged in");
+    }
+    async ensureLoggedIn({ username, password }) {
+        const needsLogin = await this.needsLogin();
+        if (needsLogin) {
+            this.logger.info("Needs login");
+            await this.logIn({ username, password });
+        }
+        else {
+            this.logger.info("Already logged in");
+        }
+    }
+    async createPost({ caption, filePaths }) {
+        this.logger.info("Creating post");
+        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_post_1.clickOnNextButtonAction,
+            create_post_1.clickOnNextButtonAction,
+            (0, create_post_1.putPostCaptionAction)(caption),
+            create_post_1.clickOnShareButtonAction,
+            create_post_1.waitForConfirmationAction,
+        ]);
+        this.logger.debug("Post created");
+        return result;
+    }
+}
+exports.Instagram = Instagram;

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

@@ -0,0 +1,2 @@
+import { Action } from "./action.interface";
+export type ActionFactory<T = void> = (...args: any[]) => Action<T>;

package/dist/interfaces/action-factory.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,10 @@
+import { Page } from "puppeteer";
+import { Logger } from "winston";
+import { Config } from "./config.interface";
+export type ActionOptions = {
+    config: Config;
+    logger: Logger;
+    page: Page;
+    defaultTimeout?: number;
+};
+export type Action<T = void> = (options: ActionOptions) => Promise<T>;

package/dist/interfaces/action.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,16 @@
+export interface Config {
+    loginText: string;
+    loginTextAlternative: string;
+    usernameInputSelector: string;
+    passwordInputSelector: string;
+    loginButtonText: string;
+    alternativeLoginButtonSelector: string;
+    closeNotificationsDialogText: string;
+    createButtonText: string;
+    postButtonText: string;
+    fileInputSelector: string;
+    captionInputSelector: string;
+    nextButtonText: string;
+    shareButtonText: string;
+    confirmationText: string;
+}

package/dist/interfaces/config.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./action.interface";
+export * from "./config.interface";
+export * from "./action-factory.interface";

package/dist/interfaces/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("./action.interface"), exports);
+__exportStar(require("./config.interface"), exports);
+__exportStar(require("./action-factory.interface"), exports);

package/dist/interfaces/post-data.interface.d.ts

@@ -0,0 +1,6 @@
+export interface PostData {
+    id: string;
+    pk: string;
+    code: string;
+    caption: string;
+}

package/dist/interfaces/post-data.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/delay.util.d.ts

@@ -0,0 +1 @@
+export declare function delay(ms: number): Promise<unknown>;

package/dist/utils/delay.util.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delay = delay;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/utils/evaluated-click.util.d.ts

@@ -0,0 +1,2 @@
+import { ElementHandle, Page } from "puppeteer";
+export declare const evaluatedClick: (page: Page, elementHandle: ElementHandle<Element>) => Promise<void>;

package/dist/utils/evaluated-click.util.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluatedClick = void 0;
+const evaluatedClick = async (page, elementHandle) => {
+    await page.evaluate((el) => {
+        const element = el;
+        element.scrollIntoView({ behavior: "smooth", block: "center" });
+        element.click();
+    }, elementHandle);
+};
+exports.evaluatedClick = evaluatedClick;

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./evaluated-click.util";

package/dist/utils/index.js

@@ -0,0 +1,17 @@
+"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("./evaluated-click.util"), exports);

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "pupgram",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/*",
+    "!/**/__tests__"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node ./src/index.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "playground": "ts-node ./playground/index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "instagram",
+    "puppeteer",
+    "pupgram",
+    "instagram-bot",
+    "instagram-automation"
+  ],
+  "author": "Marcuth",
+  "license": "MIT",
+  "devDependencies": {
+    "@marcuth/env": "^0.0.1",
+    "@types/node": "^25.1.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "prettier-plugin-sort-imports": "^1.8.9",
+    "ts-node": "^10.9.2",
+    "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",
+    "winston": "^3.19.0"
+  }
+}