n8n-nodes-pronote 0.2.1 → 0.2.5

package/README.md

@@ -29,3 +29,5 @@ See `agent-tools/pronoteTools.ts` for a thin wrapper you can drop into LLM agent
 1) Run **PRONOTE Auth Helper** with operation “Prepare Mobile Validation” and your instance URL. It returns a `deviceUUID` and the `InfoMobileApp.json` URL.
 2) Open that URL in a browser, approve the device in your CAS portal (e.g., Lycée Connecté). Capture the returned `login` and `mdp` (token).
 3) Run **PRONOTE Auth Helper** with operation “Validate Mobile Token”, providing the `instanceUrl`, `login`, `mdp`, and the same `deviceUUID`. The node outputs a verified token plus user details—use these in the PRONOTE credentials.
+
+> Use `mobileToken` (mdp) + `deviceUUID` in the PRONOTE credentials. The `sessionToken` returned is short‑lived; nodes will re-login with the mobile token on each run.

package/dist/nodes/Pronote/PronoteAuthHelper.node.js

@@ -178,7 +178,8 @@ class PronoteAuthHelper {
                         instanceUrl: auth.url,
                         deviceUUID: auth.deviceUUID,
                         username: auth.username,
-                        token: auth.token,
+                        mobileToken: token,
+                        sessionToken: auth.token,
                         kind: auth.kind,
                         userDisplayName: auth.session.user.name,
                         establishment: auth.session.user.resources[0]?.establishmentName,
@@ -209,7 +210,7 @@ class PronoteAuthHelper {
                         instanceUrl: auth.url,
                         deviceUUID: auth.deviceUUID,
                         username: auth.username,
-                        token: auth.token,
+                        sessionToken: auth.token,
                         kind: auth.kind,
                         userDisplayName: auth.session.user.name,
                         establishment: auth.session.user.resources[0]?.establishmentName,

package/dist/nodes/Pronote/PronoteTool.node.d.ts

@@ -1,5 +1,5 @@
-import { type INodeType, type INodeTypeDescription, type ISupplyDataFunctions, type SupplyData } from "n8n-workflow";
+import { type INodeType, type INodeTypeDescription, type IExecuteFunctions, type INodeExecutionData } from "n8n-workflow";
 export declare class PronoteTool implements INodeType {
     description: INodeTypeDescription;
-    supplyData(this: ISupplyDataFunctions): Promise<SupplyData>;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

package/dist/nodes/Pronote/PronoteTool.node.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PronoteTool = void 0;
-const tools_1 = require("@langchain/core/tools");
-const zod_1 = require("zod");
 const n8n_workflow_1 = require("n8n-workflow");
 const pawnoteClient_1 = require("../../shared/pawnoteClient");
 const GenericFunctions_1 = require("./GenericFunctions");
@@ -15,13 +13,14 @@ class PronoteTool {
             group: ["transform"],
             version: 1,
             description: "Expose PRONOTE timetable, tasks, and grades to AI Agents",
-            subtitle: "={{ $parameter[\"toolDescription\"] || \"PRONOTE tool\" }}",
+            subtitle: "={{ $parameter[\"action\"] || \"PRONOTE\" }}",
             defaults: {
                 name: "PRONOTE Tool",
             },
-            inputs: [],
-            outputs: [n8n_workflow_1.NodeConnectionTypes.AiTool],
-            outputNames: ["Tool"],
+            usableAsTool: true,
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputNames: ["Result"],
             credentials: [
                 {
                     name: "pronoteApi",
@@ -30,104 +29,138 @@ class PronoteTool {
             ],
             properties: [
                 {
-                    displayName: "Tool Description",
-                    name: "toolDescription",
+                    displayName: "Action",
+                    name: "action",
+                    type: "options",
+                    default: "timetable",
+                    options: [
+                        { name: "Timetable", value: "timetable" },
+                        { name: "Tasks", value: "tasks" },
+                        { name: "Grades", value: "grades" },
+                        { name: "Grade Periods", value: "gradePeriods" },
+                    ],
+                    description: "What to retrieve from PRONOTE",
+                },
+                {
+                    displayName: "Reference Date",
+                    name: "referenceDate",
+                    type: "string",
+                    default: "",
+                    placeholder: "2024-09-01",
+                    description: "ISO date used to pick the PRONOTE week for timetable/tasks. Defaults to today.",
+                    displayOptions: {
+                        show: {
+                            action: ["timetable", "tasks"],
+                        },
+                    },
+                },
+                {
+                    displayName: "Only Pending Tasks",
+                    name: "onlyPendingTasks",
+                    type: "boolean",
+                    default: false,
+                    description: "Filter out tasks already marked done",
+                    displayOptions: {
+                        show: {
+                            action: ["tasks"],
+                        },
+                    },
+                },
+                {
+                    displayName: "Period Name or ID",
+                    name: "periodName",
                     type: "string",
-                    default: "Use this tool to read timetable, homework/tasks, or grade information from PRONOTE. " +
-                        "Provide action: timetable, tasks, grades, or gradePeriods. " +
-                        "Use referenceDate (ISO) for timetable/tasks; periodName for grades.",
-                    description: "Optional guidance shown to the model about how to use this tool.",
-                    typeOptions: {
-                        rows: 3,
+                    default: "",
+                    description: "Grade period to fetch (name or ID). Leave empty to use the first available period.",
+                    displayOptions: {
+                        show: {
+                            action: ["grades"],
+                        },
+                    },
+                },
+                {
+                    displayName: "Include Individual Grades",
+                    name: "includeGrades",
+                    type: "boolean",
+                    default: true,
+                    description: "If false, only averages and subjects are returned",
+                    displayOptions: {
+                        show: {
+                            action: ["grades"],
+                        },
                     },
                 },
             ],
         };
     }
-    async supplyData() {
-        try {
-            const { session } = await (0, GenericFunctions_1.getPronoteAuth)(this);
-            const tool = new tools_1.DynamicStructuredTool({
-                name: "pronote",
-                description: this.getNodeParameter("toolDescription", 0) ||
-                    "Fetch timetable, homework/tasks, or grade information from PRONOTE. " +
-                        "Actions: timetable, tasks, grades, gradePeriods. " +
-                        "Use referenceDate (ISO date) to target a week for timetable/tasks. " +
-                        "When action=grades, provide periodName (ID or label).",
-                schema: zod_1.z.object({
-                    action: zod_1.z
-                        .enum(["timetable", "tasks", "grades", "gradePeriods"])
-                        .describe("What to retrieve from PRONOTE."),
-                    referenceDate: zod_1.z
-                        .string()
-                        .optional()
-                        .describe("ISO date (e.g. 2024-09-01). Used for timetable and tasks to select the week; defaults to today."),
-                    periodName: zod_1.z
-                        .string()
-                        .optional()
-                        .describe("Grade period name or ID. Used when action=grades."),
-                    onlyPendingTasks: zod_1.z
-                        .boolean()
-                        .optional()
-                        .describe("When action=tasks, if true only return undone tasks."),
-                    includeGrades: zod_1.z
-                        .boolean()
-                        .optional()
-                        .describe("When action=grades, if false only averages are returned."),
-                }),
-                func: async (input) => {
-                    const safeStringify = (data) => JSON.stringify(data, null, 2);
-                    switch (input.action) {
-                        case "timetable": {
-                            const referenceDate = (0, GenericFunctions_1.resolveReferenceDate)(input.referenceDate);
-                            const timetable = await (0, pawnoteClient_1.fetchTimetable)(session, referenceDate);
-                            return safeStringify(timetable);
-                        }
-                        case "tasks": {
-                            const referenceDate = (0, GenericFunctions_1.resolveReferenceDate)(input.referenceDate);
-                            const assignments = await (0, pawnoteClient_1.fetchAssignments)(session, referenceDate);
-                            const filtered = input.onlyPendingTasks
-                                ? assignments.filter((a) => !a.isDone)
-                                : assignments;
-                            return safeStringify(filtered);
-                        }
-                        case "gradePeriods": {
-                            const periods = await (0, pawnoteClient_1.fetchGradePeriods)(session);
-                            return safeStringify(periods);
-                        }
-                        case "grades": {
-                            const includeGrades = input.includeGrades !== false;
-                            const overview = await (0, pawnoteClient_1.fetchGrades)(session, input.periodName);
-                            if (!includeGrades) {
-                                return safeStringify({
-                                    period: overview.period,
-                                    studentOverall: overview.studentOverall,
-                                    classAverage: overview.classAverage,
-                                    subjects: overview.subjects.map((subject) => ({
-                                        id: subject.id,
-                                        name: subject.name,
-                                        studentAverage: subject.studentAverage,
-                                        classAverage: subject.classAverage,
-                                        maximum: subject.maximum,
-                                        minimum: subject.minimum,
-                                        outOf: subject.outOf,
-                                    })),
-                                });
-                            }
-                            return safeStringify(overview);
-                        }
-                        default:
-                            throw new Error(`Unsupported action: ${input["action"]}`);
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const auth = await (0, GenericFunctions_1.getPronoteAuth)(this);
+        const action = this.getNodeParameter("action", 0);
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (action === "timetable") {
+                    const referenceDate = (0, GenericFunctions_1.resolveReferenceDate)(this.getNodeParameter("referenceDate", i));
+                    const timetable = await (0, pawnoteClient_1.fetchTimetable)(auth.session, referenceDate);
+                    for (const day of timetable) {
+                        returnData.push({ json: day, pairedItem: { item: i } });
                     }
-                },
-            });
-            return {
-                response: tool,
-            };
-        }
-        catch (error) {
-            throw new n8n_workflow_1.NodeOperationError(this.getNode(), error.message);
+                    continue;
+                }
+                if (action === "tasks") {
+                    const referenceDate = (0, GenericFunctions_1.resolveReferenceDate)(this.getNodeParameter("referenceDate", i));
+                    const onlyPending = this.getNodeParameter("onlyPendingTasks", i);
+                    const assignments = await (0, pawnoteClient_1.fetchAssignments)(auth.session, referenceDate);
+                    for (const assignment of assignments) {
+                        if (onlyPending && assignment.isDone)
+                            continue;
+                        returnData.push({ json: assignment, pairedItem: { item: i } });
+                    }
+                    continue;
+                }
+                if (action === "gradePeriods") {
+                    const periods = await (0, pawnoteClient_1.fetchGradePeriods)(auth.session);
+                    for (const period of periods) {
+                        returnData.push({ json: period, pairedItem: { item: i } });
+                    }
+                    continue;
+                }
+                if (action === "grades") {
+                    const periodName = this.getNodeParameter("periodName", i).trim() || undefined;
+                    const includeGrades = this.getNodeParameter("includeGrades", i);
+                    const overview = await (0, pawnoteClient_1.fetchGrades)(auth.session, periodName);
+                    if (!includeGrades) {
+                        returnData.push({
+                            json: {
+                                period: overview.period,
+                                studentOverall: overview.studentOverall,
+                                classAverage: overview.classAverage,
+                                subjects: overview.subjects.map((subject) => ({
+                                    id: subject.id,
+                                    name: subject.name,
+                                    studentAverage: subject.studentAverage,
+                                    classAverage: subject.classAverage,
+                                    maximum: subject.maximum,
+                                    minimum: subject.minimum,
+                                    outOf: subject.outOf,
+                                })),
+                            },
+                            pairedItem: { item: i },
+                        });
+                    }
+                    else {
+                        returnData.push({ json: overview, pairedItem: { item: i } });
+                    }
+                    continue;
+                }
+                throw new Error(`Unsupported action ${action}`);
+            }
+            catch (error) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error.message, { itemIndex: i });
+            }
         }
+        return [returnData];
     }
 }
 exports.PronoteTool = PronoteTool;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-pronote",
-  "version": "0.2.1",
+  "version": "0.2.5",
   "description": "n8n custom nodes and agent utilities to talk to PRONOTE via the Pawnote library.",
   "license": "MIT",
   "main": "dist/nodes/Pronote/Pronote.node.js",
@@ -14,9 +14,7 @@
     "dist"
   ],
   "dependencies": {
-    "@langchain/core": "^0.2.29",
-    "pawnote": "^1.6.2",
-    "zod": "^3.23.8"
+    "pawnote": "^1.6.2"
   },
   "peerDependencies": {
     "n8n-core": "^1.0.0",