first commit

Author: cbecerrae

.github/workflows/schedule-attendance.yml

@@ -0,0 +1,59 @@
+name: Schedule Attendance Marking
+
+on:
+  schedule:
+    - cron: '0 13 * * 2-6' # Monday to Friday at 08:00 Lima (13:00 UTC) → In
+    - cron: '0 0 * * 2-5'  # Monday to Thursday at 19:00 Lima (00:00 UTC) → Out
+    - cron: '0 22 * * 6'   # Friday at 17:00 Lima (22:00 UTC) → Out
+  workflow_dispatch: # Allows manual execution
+
+jobs:
+  set-attendance-type:
+    runs-on: ubuntu-latest
+    outputs:
+      attendance_type: ${{ steps.set-type.outputs.ATTENDANCE_TYPE }}
+    
+    steps:
+      # Determine the attendance type based on the current UTC hour
+      - name: Determine attendance type
+        id: set-type
+        run: |
+          HOUR_UTC=$(date -u +%H)
+          if [[ "$HOUR_UTC" -lt 18 ]]; then
+            echo "ATTENDANCE_TYPE=In" >> $GITHUB_OUTPUT
+          else
+            echo "ATTENDANCE_TYPE=Out" >> $GITHUB_OUTPUT
+          fi
+
+  mark-attendance:
+    runs-on: ubuntu-latest
+    needs: set-attendance-type
+
+    steps:
+      # Checkout the repository to use this private action
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # Set up Chrome browser, ChromeDriver, and dependencies 
+      - name: Set up Chrome
+        uses: browser-actions/setup-chrome@v1
+        id: setup-chrome
+        with:
+          chrome-version: stable
+          install-chromedriver: true
+          install-dependencies: true
+
+      # Use the custom javascript action to mark attendance based on the determined type
+      - name: Mark Attendance
+        uses: cbecerrae/talana-attendance-javascript-action@v1
+        id: mark-attendance
+        with:
+          attendance_email: ${{ secrets.ATTENDANCE_EMAIL }}
+          attendance_password: ${{ secrets.ATTENDANCE_PASSWORD }}
+          attendance_type: ${{ needs.set-attendance-type.outputs.attendance_type }}
+          chrome_path: ${{ steps.setup-chrome.outputs.chrome-path }}
+          chromedriver_path: ${{ steps.setup-chrome.outputs.chromedriver-path }}
+      
+      # Confirm the attendance marking and output the attendance type and time 
+      - name: Confirm Attendance
+        run: echo "Attendance of type '${{ needs.set-attendance-type.outputs.attendance_type }}' marked at time ${{ steps.mark-attendance.outputs.attendance_time }}"

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cristhian Alonzo Becerra Espinoza
+
+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.

README.md

@@ -0,0 +1,53 @@
+# Talana Attendance JavaScript Action
+
+This GitHub Action automates attendance marking on the [Talana](https://peru.talana.com/es-pe/remuneraciones/login-vue#/) platform using JavaScript, Node.js, and Selenium. It runs on a schedule, logging in and marking attendance as "In" or "Out" based on the time, leveraging Selenium to interact with the platform. The action ensures seamless, automated attendance marking.
+
+## Requirements
+
+To use this action, you need *Google Chrome* and *ChromeDriver* installed on the runner. You can install them using the [setup-chrome](https://github.com/browser-actions/setup-chrome) GitHub Action. This action automatically provides the necessary paths to the Chrome and ChromeDriver binaries. These paths should be passed as inputs (`chrome_path` and `chromedriver_path`) to the **talana-attendance-javascript-action** GitHub Action.
+
+## Inputs
+
+### `attendance_email`
+
+**Required** User email for authentication.
+
+### `attendance_password`
+
+**Required** User password for authentication.
+
+### `attendance_type`
+
+**Required** Attendance type: In or Out.
+
+### `chrome_path`
+
+**Required** Path to the installed Chrome binary.
+
+### `chromedriver_path`
+
+**Required** Path to the installed ChromeDriver binary.
+
+## Outputs
+
+### `attendance_time`
+
+The time when the attendance was marked.
+
+## Usage
+
+```yaml
+uses: cbecerrae/talana-attendance-javascript-action@v1
+with:
+    attendance_email: 'user@example.com'
+    attendance_password: 'password123'
+    attendance_type: 'In'
+    chrome_path: '/path/to/chrome'
+    chromedriver_path: '/path/to/chromedriver'
+```
+
+## GitHub Action Workflow Example 
+
+[![Schedule Attendance Marking](https://github.com/cbecerrae/talana-attendance-javascript-action/actions/workflows/schedule-attendance.yml/badge.svg)](https://github.com/cbecerrae/talana-attendance-javascript-action/actions/workflows/schedule-attendance.yml)
+
+For a full example of how to implement this action alongside **setup-chrome**, check the [`.github/workflows/schedule-attendance.yml`](.github/workflows/schedule-attendance.yml) file. This example demonstrates how to schedule attendance marking and provides a working setup for using this action in combination with the **setup-chrome** action.

action.yml

@@ -0,0 +1,29 @@
+name: 'Talana Attendance JavaScript Action'
+description: 'This GitHub Action automates attendance marking in Talana by interacting with the platform using Node.js and Selenium.'
+inputs:
+  attendance_email:
+    description: 'User email for authentication'
+    required: true
+  attendance_password:
+    description: 'User password for authentication'
+    required: true
+  attendance_type:
+    description: 'Attendance type: In or Out'
+    required: true
+  chrome_path:
+    description: 'Path to the installed Chrome binary'
+    required: true
+  chromedriver_path:
+    description: 'Path to the installed ChromeDriver binary'
+    required: true
+outputs:
+  attendance_time:
+    description: 'The time when the attendance was marked'
+
+runs:
+  using: 'node20'
+  main: 'index.js'
+
+branding:
+  icon: 'clock'
+  color: 'green'

index.js

@@ -0,0 +1,58 @@
+const core = require('@actions/core');
+const { getDriver } = require('./utils/chrome.js');
+const { login } = require('./utils/login.js');
+const { markAttendance } = require('./utils/mark_attendance.js');
+const { logger } = require('./utils/shared.js');
+
+async function main() {
+    /**
+     * Main function that executes the attendance marking process.
+     *
+     * This function is invoked by GitHub Actions and expects its input as environment variables.
+     * It initializes a headless Chrome browser using Puppeteer, performs user authentication,
+     * and marks attendance based on the specified type ('In' or 'Out').
+     *
+     * If an exception occurs during execution, it logs the error and exits with a non-zero status.
+     */
+
+    // Extract input parameters provided by GitHub Actions
+    const email = core.getInput('attendance_email'); // User email for authentication
+    const password = core.getInput('attendance_password'); // User password for authentication
+    const type = core.getInput('attendance_type'); // Attendance type: 'In' or 'Out'
+    const chromePath = core.getInput('chrome_path'); // Path to the Chrome binary
+    const chromedriverPath = core.getInput('chromedriver_path');  // Path to the ChromeDriver binary
+
+    // Validate required parameters
+    if (!email || !password || !type) {
+        console.error('Missing required environment variables.');
+        process.exit(1);
+    }
+
+    // Launch a new ChromeDriver instance with the specified chromePath
+    let driver = await getDriver(chromePath, chromedriverPath);
+
+    try {
+        // Perform login operation
+        await login(driver, email, password);
+
+        // Mark attendance based on the provided type
+        await markAttendance(driver, type);
+    } catch (error) {
+        // Log any encountered errors
+        logger.error(`Exception caught: ${error.message}`);
+        logger.error(`Stack Trace: ${error.stack}`);
+        process.exit(1);
+    } finally {
+        // Ensure the browser is closed to free up resources
+        await driver.quit();
+    }
+
+    // Set the output for the GitHub Actions workflow
+    const time = (new Date()).toTimeString();
+    core.setOutput("attendance_time", time);
+}
+
+// Execute the main function when the script is run directly
+if (require.main === module) {
+    main();
+}