Prérequis minimums pour installer et utiliser Duplo

Installation manuelle

Si vous partez d’un projet vierge, commencez par l’initialiser.

npm init -y

Ensuite pour utiliser Duplo sur NodeJS, vous devez installer le package @duplojs/core et la librairie de portage @duplojs/node.

npm install "@duplojs/[email protected]" "@duplojs/[email protected]"

Installer également les packages typescript et tsx en dépendances de développement.

npm install --save-dev "typescript@>5.5" tsx

Configuration package.json

Définissez le paramètre type sur la valeur module dans le package.json.

{
    "name": "...",
    "version": "...",
    ...,
    "type": "module",
    "scripts": {
        /* permet de lancer le fichier src/main.ts avec la command npm run dev */
        "dev": "tsx --watch src/main.ts", 
        ...
    },
    ...
}

Configuration tsconfig.json

Les paramètres suivants sont fortement conseillés à inclure dans votre fichier tsconfig.json pour une compatibilité optimale avec la plupart des packages.

{
    "compilerOptions": {
        "target": "ESNext",
        "lib": ["ESNext"], 
        "moduleDetection": "force",
        "module": "ESNext",
        "moduleResolution": "Bundler",           
        "types": ["node"],
        "noEmit": true,
        "esModuleInterop": true,
        "strict": true,
        ...
    },
    /* ce paramètre dépend de votre configuration */
    "include": ["src/**/*.ts"], 
    ...
}

Premier fichier

Créez le fichier src/main.ts avec le contenu suivant.

import "@duplojs/node";
import { Duplo } from "@duplojs/core";

const duplo = new Duplo({
    environment: "DEV",
    host: "localhost",
    port: 1506,
});

// methode qui lance le serveur web
const server = await duplo.launch();

Lancer le serveur

npx tsx src/main.ts
# ou
npm run dev

Retour au Références