@limetech/n8n-nodes-lime 0.2.9 → 0.3.0

package/nodes/lime-crm/transport/commons.ts

@@ -0,0 +1,44 @@
+import { LIME_CRM_API_CREDENTIAL_KEY } from '../commons';
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { NodeResponse } from '../../nodeResponse';
+
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+
+async function getLimeUrl(context: IAllExecuteFunctions): Promise<string> {
+    const credentials = await context.getCredentials(
+        LIME_CRM_API_CREDENTIAL_KEY
+    );
+    return credentials.url as string;
+}
+
+export async function callLimeApi<T>(
+    nodeContext: IAllExecuteFunctions,
+    method: HTTPMethod,
+    url: string,
+    options?: object
+): Promise<NodeResponse<T>> {
+    try {
+        const response: T =
+            await nodeContext.helpers.requestWithAuthentication.call(
+                nodeContext,
+                LIME_CRM_API_CREDENTIAL_KEY,
+                {
+                    method: method,
+                    url: url,
+                    json: true,
+                    baseURL: await getLimeUrl(nodeContext),
+                    ...options,
+                }
+            );
+        return {
+            success: true,
+            data: response,
+        };
+    } catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            status: error?.cause?.status,
+        };
+    }
+}

package/nodes/lime-crm/transport/erpConnector.ts

@@ -0,0 +1,21 @@
+import { callLimeApi } from './commons';
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { LimeCrmData } from '../resources/erpConnector/transform';
+import { NodeResponse } from '../../nodeResponse';
+
+const ERP_CONNECTOR_URL = '/limepkg-erp-connector/';
+
+export interface CreateOrUpdateObjectsTaskResponse {
+    id: string;
+    status: string;
+    result: Record<string, unknown> | null;
+}
+
+export async function startCreateOrUpdateObjectsTask(
+    nodeContext: IAllExecuteFunctions,
+    data: LimeCrmData
+): Promise<NodeResponse<CreateOrUpdateObjectsTaskResponse>> {
+    return await callLimeApi(nodeContext, 'PUT', ERP_CONNECTOR_URL, {
+        body: data,
+    });
+}

package/nodes/lime-crm/transport/index.ts

@@ -0,0 +1,17 @@
+export {
+    getSubscription,
+    deleteSubscription,
+    createSubscription,
+    listSubscriptionsWithExistingData,
+} from './webhooks';
+export { getLimeTypesFromApi, getProperties } from './limetypes';
+
+export {
+    createLimeObject,
+    deleteLimeObject,
+    updateLimeObject,
+    getLimeObject,
+    searchLimeObject,
+} from './limeobjects';
+export { startCreateOrUpdateObjectsTask } from './erpConnector';
+export { callLimeApi } from './commons';

package/nodes/lime-crm/transport/limeobjects.ts

@@ -0,0 +1,83 @@
+import { callLimeApi } from './commons';
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { NodeResponse } from '../../nodeResponse';
+
+const LIMEOBJECT_URL = '/api/v1/limeobject/';
+
+interface SearchLimeobjectApiResponse {
+    _embedded: {
+        limeobjects: Array<object>;
+    };
+}
+
+export async function createLimeObject(
+    nodeContext: IAllExecuteFunctions,
+    limetype: string,
+    data: object
+): Promise<NodeResponse<unknown>> {
+    const url = `${LIMEOBJECT_URL}${limetype}/`;
+    return await callLimeApi(nodeContext, 'POST', url, {
+        body: data,
+    });
+}
+
+export async function deleteLimeObject(
+    nodeContext: IAllExecuteFunctions,
+    limetype: string,
+    id: string
+): Promise<NodeResponse<void>> {
+    const url = `${LIMEOBJECT_URL}${limetype}/${id}/`;
+    return await callLimeApi(nodeContext, 'DELETE', url);
+}
+
+export async function getLimeObject(
+    nodeContext: IAllExecuteFunctions,
+    limetype: string,
+    id: string
+): Promise<NodeResponse<unknown>> {
+    const url = `${LIMEOBJECT_URL}${limetype}/${id}/`;
+    return await callLimeApi(nodeContext, 'GET', url);
+}
+
+export async function updateLimeObject(
+    nodeContext: IAllExecuteFunctions,
+    limetype: string,
+    id: string,
+    data: object
+): Promise<NodeResponse<unknown>> {
+    const url = `${LIMEOBJECT_URL}${limetype}/${id}/`;
+    return await callLimeApi(nodeContext, 'PUT', url, {
+        body: data,
+    });
+}
+
+export async function searchLimeObject(
+    nodeContext: IAllExecuteFunctions,
+    limetype: string,
+    searchField: string,
+    searchTerm: string,
+    limit: number | null,
+    sortField: string | null
+): Promise<NodeResponse<Array<object>>> {
+    const url = `${LIMEOBJECT_URL}${limetype}/`;
+    const response = await callLimeApi<SearchLimeobjectApiResponse>(
+        nodeContext,
+        'GET',
+        url,
+        {
+            qs: {
+                ...(searchField && searchTerm && { [searchField]: searchTerm }),
+                ...(limit != null && limit > 0 && { _limit: limit }),
+                ...(sortField != null && { _sort: sortField }),
+            },
+        }
+    );
+
+    if (response.success) {
+        return {
+            success: true,
+            data: response.data?._embedded.limeobjects ?? [],
+        };
+    }
+    return response;
+}

package/nodes/lime-crm/transport/limetypes.ts

@@ -0,0 +1,68 @@
+import { callLimeApi } from '.';
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { LimeType, LimeTypeProperty } from '../commons';
+import { NodeResponse } from '../../nodeResponse';
+
+const LIMETYPE_URL = '/api/v1/limetype/';
+
+interface LimeTypesApiResponse {
+    _links: {
+        limetypes: LimeType[];
+    };
+}
+
+interface LimeTypePropertiesApiResponse {
+    _embedded: {
+        properties: LimeTypeProperty[];
+    };
+}
+
+export async function getLimeTypesFromApi(
+    nodeContext: IAllExecuteFunctions
+): Promise<NodeResponse<LimeType[]>> {
+    const response = await callLimeApi<LimeTypesApiResponse>(
+        nodeContext,
+        'GET',
+        LIMETYPE_URL
+    );
+    if (response.success) {
+        return {
+            success: true,
+            data: response.data?._links.limetypes ?? [],
+        };
+    }
+    return response;
+}
+
+export async function getLimeType(
+    nodeContext: IAllExecuteFunctions,
+    limeType: string
+): Promise<NodeResponse<LimeType>> {
+    const url = `${LIMETYPE_URL}${limeType}/`;
+    return await callLimeApi<LimeType>(nodeContext, 'GET', url);
+}
+
+export async function getProperties(
+    nodeContext: IAllExecuteFunctions,
+    limeType: string
+): Promise<NodeResponse<LimeTypeProperty[]>> {
+    const url = `${LIMETYPE_URL}${limeType}/`;
+    const response = await callLimeApi<LimeTypePropertiesApiResponse>(
+        nodeContext,
+        'GET',
+        url,
+        {
+            qs: {
+                _embed: 'properties',
+            },
+        }
+    );
+
+    if (response.success) {
+        return {
+            success: true,
+            data: response.data?._embedded.properties ?? [],
+        };
+    }
+    return response;
+}

package/nodes/lime-crm/transport/task.ts

@@ -0,0 +1,32 @@
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { callLimeApi } from './commons';
+
+const TASK_URL = '/api/v1/task/';
+
+interface Task {
+    id: string;
+    status: 'PENDING' | 'STARTED' | 'SUCCESS' | 'FAILURE' | 'REVOKED' | 'RETRY';
+    result: unknown;
+}
+
+interface GetTasksApiResponse {
+    _embedded: {
+        tasks: Task[];
+    };
+}
+
+export async function getTasks(
+    nodeContext: IAllExecuteFunctions,
+    taskId: string
+) {
+    return await callLimeApi<GetTasksApiResponse>(
+        nodeContext,
+        'GET',
+        TASK_URL,
+        {
+            qs: {
+                id: taskId,
+            },
+        }
+    );
+}

package/nodes/lime-crm/transport/webhooks.ts

@@ -0,0 +1,61 @@
+import { Webhook } from '../commons';
+import { callLimeApi } from '.';
+import { IAllExecuteFunctions } from 'n8n-workflow';
+import { NodeResponse } from '../../nodeResponse';
+
+const SUBSCRIPTION_URL = 'api/v1/subscription/';
+
+interface ApiResponseWebhook {
+    id: string;
+    name: string;
+    enabled: boolean;
+    events: string[];
+    target_url: string;
+}
+
+export async function getSubscription(
+    nodeContext: IAllExecuteFunctions,
+    webhook: Webhook
+): Promise<NodeResponse<ApiResponseWebhook>> {
+    return await callLimeApi(
+        nodeContext,
+        'GET',
+        `${SUBSCRIPTION_URL}${webhook.data.webhookId}`
+    );
+}
+
+export async function listSubscriptionsWithExistingData(
+    nodeContext: IAllExecuteFunctions,
+    webhook: Webhook
+): Promise<NodeResponse<ApiResponseWebhook[]>> {
+    return await callLimeApi(nodeContext, 'GET', SUBSCRIPTION_URL, {
+        qs: {
+            events: webhook.events.join(','),
+            target_url: webhook.url,
+            enabled: true,
+        },
+    });
+}
+
+export async function createSubscription(
+    nodeContext: IAllExecuteFunctions,
+    webhook: Webhook
+): Promise<NodeResponse<ApiResponseWebhook>> {
+    return await callLimeApi(nodeContext, 'POST', SUBSCRIPTION_URL, {
+        body: {
+            events: webhook.events,
+            target_url: webhook.url,
+        },
+    });
+}
+
+export async function deleteSubscription(
+    nodeContext: IAllExecuteFunctions,
+    webhook: Webhook
+): Promise<NodeResponse<void>> {
+    return await callLimeApi(
+        nodeContext,
+        'DELETE',
+        `${SUBSCRIPTION_URL}${webhook.data.webhookId}/`
+    );
+}

package/nodes/nodeResponse.ts

@@ -0,0 +1,13 @@
+type SuccessResponse<T> = {
+    success: true;
+    data: T;
+};
+
+type FailureResponse = {
+    success: false;
+    error: string;
+    status?: number;
+    metadata?: Record<string, unknown>;
+};
+
+export type NodeResponse<T> = SuccessResponse<T> | FailureResponse;

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "@limetech/n8n-nodes-lime",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "n8n node to connect to Lime CRM",
   "license": "MIT",
   "main": "index.js",
   "scripts": {
-    "build": "tsc && find nodes -name '*.svg' -exec cp {} dist/{} \\;",
+    "build": "tsc && mkdir -p dist/nodes/lime-crm/assets && find nodes -name '*.svg' -exec cp {} dist/{} \\;",
     "dev": "tsc --watch",
     "dev:reload": "nodemon --watch dist --exec 'cp -R dist/* ~/.n8n/custom/dist/'",
     "watch": "concurrently \"npm run dev\" \"npm run dev:reload\"",
-    "format": "prettier --write ."
+    "lint": "eslint --max-warnings=0 .",
+    "lint:fix": "eslint --max-warnings=0 . --fix",
+    "format": "prettier -c .",
+    "format:fix": "prettier --write .",
+    "test": "jest"
   },
   "keywords": [
     "n8n",
@@ -18,35 +22,51 @@
     "crm",
     "n8n-community-node-package"
   ],
-  "files": [
-    "dist"
-  ],
   "n8n": {
     "n8nNodesApiVersion": 1,
     "credentials": [
       "dist/credentials/LimeCrmApi.credentials.js",
-      "dist/credentials/LimeGoApi.credentials.js"
+      "dist/credentials/FortnoxApi.credentials.js"
     ],
     "nodes": [
-      "dist/nodes/LimeCrm/LimeCrmNode.node.js",
-      "dist/nodes/LimeCrm/LimeCrmTrigger/LimeCrmTrigger.node.js",
-      "dist/nodes/LimeGo/LimeGo.node.js"
+      "dist/nodes/lime-crm/LimeCrm.node.js",
+      "dist/nodes/fortnox/Fortnox.node.js",
+      "dist/nodes/fortnox/FortnoxTrigger.node.js"
     ]
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.4",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/jest": "^30.0.0",
     "@types/node": "^16.11.10",
     "@types/request-promise-native": "^1.0.18",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
     "concurrently": "^7.0.0",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-n8n-nodes-base": "^1.16.1",
+    "eslint-plugin-prettier": "^5.5.3",
+    "install": "^0.13.0",
+    "jest": "^30.0.5",
     "nodemon": "^2.0.15",
-    "prettier": "^2.5.0",
-    "typescript": "~4.8.0",
-    "@typescript-eslint/parser": "^7.15.0",
-    "eslint": "^8.56.0",
-    "eslint-plugin-n8n-nodes-base": "^1.16.1"
+    "npm": "^11.5.2",
+    "prettier": "^3.6.2",
+    "semantic-release": "^24.2.7",
+    "ts-jest": "^29.4.1",
+    "typescript": "^5.9.2"
   },
   "dependencies": {
+    "@limetech/eslint-config": "^3.0.2",
+    "@semantic-release/exec": "^7.1.0",
+    "currency-codes": "^2.2.0",
     "request": "^2.88.2",
-    "request-promise-native": "^1.0.9"
+    "request-promise-native": "^1.0.9",
+    "ws": "^8.18.3"
   },
   "peerDependencies": {
     "n8n-workflow": "*"

package/tests/fixtures/fortnox.ts

@@ -0,0 +1,182 @@
+import { FortnoxInvoiceData } from '../../nodes/lime-crm/resources/erpConnector/transformers/fortnox';
+
+export const invoice = {
+    '@url': 'https://api.fortnox.se/3/invoices/1',
+    '@urlTaxReductionList':
+        'https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=1',
+    AccountingMethod: 'ACCRUAL',
+    Address1: '',
+    Address2: '',
+    AdministrationFee: 0,
+    AdministrationFeeVAT: 0,
+    Balance: 1589,
+    BasisTaxReduction: 0,
+    Booked: true,
+    Cancelled: false,
+    City: 'Wadowice',
+    Comments: '',
+    ContractReference: '0',
+    ContributionPercent: 100,
+    ContributionValue: 1271,
+    CostCenter: '',
+    Country: '',
+    Credit: 'false',
+    CreditInvoiceReference: '0',
+    Currency: 'SEK',
+    CurrencyRate: 1,
+    CurrencyUnit: 1,
+    CustomerName: 'Vatican Forces',
+    CustomerNumber: '3',
+    DeliveryAddress1: '',
+    DeliveryAddress2: '',
+    DeliveryCity: '',
+    DeliveryCountry: '',
+    DeliveryDate: null,
+    DeliveryName: '',
+    DeliveryZipCode: '',
+    DocumentNumber: '1',
+    DueDate: '2025-09-12',
+    EDIInformation: {
+        EDIGlobalLocationNumber: '',
+        EDIGlobalLocationNumberDelivery: '',
+        EDIInvoiceExtra1: '',
+        EDIInvoiceExtra2: '',
+        EDIOurElectronicReference: '',
+        EDIYourElectronicReference: '',
+        EDIStatus: '',
+    },
+    EUQuarterlyReport: false,
+    EmailInformation: {
+        EmailAddressFrom: null,
+        EmailAddressTo: null,
+        EmailAddressCC: '',
+        EmailAddressBCC: '',
+        EmailSubject: 'Faktura {no} bifogas',
+        EmailBody: ' ',
+    },
+    ExternalInvoiceReference1: '',
+    ExternalInvoiceReference2: '',
+    FinalPayDate: null,
+    Freight: 0,
+    FreightVAT: 0,
+    Gross: 1271,
+    HouseWork: false,
+    InvoiceDate: '2025-08-13',
+    InvoicePeriodEnd: '',
+    InvoicePeriodStart: '',
+    InvoiceReference: '0',
+    InvoiceRows: [
+        {
+            AccountNumber: 3001,
+            ArticleNumber: '107',
+            ContributionPercent: '100',
+            ContributionValue: '500',
+            Cost: 0,
+            CostCenter: null,
+            DeliveredQuantity: '5',
+            Description: 'First article',
+            Discount: 0,
+            DiscountType: 'PERCENT',
+            HouseWork: false,
+            HouseWorkHoursToReport: null,
+            HouseWorkType: null,
+            Price: 100,
+            PriceExcludingVAT: 100,
+            Project: '',
+            RowId: 395,
+            StockPointCode: null,
+            Total: 500,
+            TotalExcludingVAT: 500,
+            Unit: 'st',
+            VAT: 25,
+        },
+        {
+            AccountNumber: 3001,
+            ArticleNumber: '108',
+            ContributionPercent: '100',
+            ContributionValue: '738',
+            Cost: 0,
+            CostCenter: null,
+            DeliveredQuantity: '6',
+            Description: 'Second article',
+            Discount: 0,
+            DiscountType: 'PERCENT',
+            HouseWork: false,
+            HouseWorkHoursToReport: null,
+            HouseWorkType: null,
+            Price: 123,
+            PriceExcludingVAT: 123,
+            Project: '',
+            RowId: 396,
+            StockPointCode: null,
+            Total: 738,
+            TotalExcludingVAT: 738,
+            Unit: 'st',
+            VAT: 25,
+        },
+        {
+            AccountNumber: 3001,
+            ArticleNumber: '109',
+            ContributionPercent: '100',
+            ContributionValue: '33',
+            Cost: 0,
+            CostCenter: null,
+            DeliveredQuantity: '3',
+            Description: 'Third article',
+            Discount: 0,
+            DiscountType: 'PERCENT',
+            HouseWork: false,
+            HouseWorkHoursToReport: null,
+            HouseWorkType: null,
+            Price: 11,
+            PriceExcludingVAT: 11,
+            Project: '',
+            RowId: 397,
+            StockPointCode: null,
+            Total: 33,
+            TotalExcludingVAT: 33,
+            Unit: 'st',
+            VAT: 25,
+        },
+    ],
+    InvoiceType: 'INVOICE',
+    Labels: [],
+    Language: 'SV',
+    LastRemindDate: null,
+    Net: 1271,
+    NotCompleted: false,
+    NoxFinans: false,
+    OCR: '13359',
+    OfferReference: '0',
+    OrderReference: '0',
+    OrganisationNumber: '1298737894',
+    OurReference: 'Aspen The Dog',
+    OutboundDate: '2025-08-13',
+    PaymentWay: '',
+    Phone1: '0418459862',
+    Phone2: '',
+    PriceList: 'A',
+    PrintTemplate: 'st',
+    Project: '',
+    Remarks: '',
+    Reminders: 0,
+    RoundOff: 0.25,
+    Sent: false,
+    TaxReduction: null,
+    TaxReductionType: 'none',
+    TermsOfDelivery: '',
+    TermsOfPayment: '30',
+    TimeBasisReference: null,
+    Total: 1589,
+    TotalToPay: 1589,
+    TotalVAT: 317.75,
+    VATIncluded: false,
+    VoucherNumber: 18,
+    VoucherSeries: 'B',
+    VoucherYear: 8,
+    WarehouseReady: true,
+    WayOfDelivery: '',
+    YourOrderNumber: '',
+    YourReference: 'Miki',
+    ZipCode: '21114',
+} satisfies FortnoxInvoiceData;