seqpulse 0.5.2 → 0.5.3

package/CI_CD_SNIPPETS_MULTI-PLATFORM.md

@@ -6,7 +6,11 @@ Snippets de reference pour integrer `SeqPulse` avec la meme logique sur plusieur
 2. deploy applicatif
 3. `finish` toujours execute, meme en cas d'echec
 
-Tous les snippets ci-dessous utilisent le package publie `seqpulse@0.5.1` et la sortie ciblee `--output deploymentId`.
+Tous les snippets ci-dessous utilisent le package publie `seqpulse@0.5.2` et une logique defensive:
+
+- `trigger` avec `--timeout-ms 15000`
+- capture du `deploymentId` dans une variable CI
+- `finish` execute seulement si un vrai `deploymentId` existe
 
 ## Variables requises
 
@@ -53,10 +57,11 @@ jobs:
       - name: SeqPulse Trigger
         id: seqpulse_trigger
         run: |
-          DEPLOYMENT_ID="$(npx -y seqpulse@0.5.1 ci trigger \
+          DEPLOYMENT_ID="$(npx -y seqpulse@0.5.2 ci trigger \
             --env prod \
             --branch "${GITHUB_REF_NAME}" \
             --non-blocking true \
+            --timeout-ms 15000 \
             --output deploymentId)"
           echo "deployment_id=${DEPLOYMENT_ID}" >> "$GITHUB_OUTPUT"
 
@@ -66,10 +71,15 @@ jobs:
       - name: SeqPulse Finish
         if: ${{ always() }}
         run: |
-          npx -y seqpulse@0.5.1 ci finish \
-            --deployment-id "${{ steps.seqpulse_trigger.outputs.deployment_id }}" \
-            --job-status "${{ job.status }}" \
-            --non-blocking true
+          if [ -n "${{ steps.seqpulse_trigger.outputs.deployment_id }}" ]; then
+            npx -y seqpulse@0.5.2 ci finish \
+              --deployment-id "${{ steps.seqpulse_trigger.outputs.deployment_id }}" \
+              --job-status "${{ job.status }}" \
+              --timeout-ms 15000 \
+              --non-blocking true
+          else
+            echo "Skipping SeqPulse finish: no deployment id available."
+          fi
 ```
 
 ## GitLab CI
@@ -81,20 +91,26 @@ deploy_prod:
   script:
     - npm ci
     - |
-      DEPLOYMENT_ID="$(npx -y seqpulse@0.5.1 ci trigger \
+      DEPLOYMENT_ID="$(npx -y seqpulse@0.5.2 ci trigger \
         --env prod \
         --branch "${CI_COMMIT_REF_NAME}" \
         --non-blocking true \
+        --timeout-ms 15000 \
         --output deploymentId)"
       printf 'SEQPULSE_DEPLOYMENT_ID=%s\n' "$DEPLOYMENT_ID" > .seqpulse.env
     - ./deploy.sh
   after_script:
     - . ./.seqpulse.env 2>/dev/null || true
     - |
-      npx -y seqpulse@0.5.1 ci finish \
-        --deployment-id "${SEQPULSE_DEPLOYMENT_ID}" \
-        --job-status "${CI_JOB_STATUS}" \
-        --non-blocking true
+      if [ -n "${SEQPULSE_DEPLOYMENT_ID}" ]; then
+        npx -y seqpulse@0.5.2 ci finish \
+          --deployment-id "${SEQPULSE_DEPLOYMENT_ID}" \
+          --job-status "${CI_JOB_STATUS}" \
+          --timeout-ms 15000 \
+          --non-blocking true
+      else
+        echo "Skipping SeqPulse finish: no deployment id available."
+      fi
 ```
 
 ## CircleCI
@@ -116,10 +132,11 @@ jobs:
       - run:
           name: SeqPulse Trigger
           command: |
-            DEPLOYMENT_ID="$(npx -y seqpulse@0.5.1 ci trigger \
+            DEPLOYMENT_ID="$(npx -y seqpulse@0.5.2 ci trigger \
               --env prod \
               --branch "${CIRCLE_BRANCH}" \
               --non-blocking true \
+              --timeout-ms 15000 \
               --output deploymentId)"
             echo "export SEQPULSE_DEPLOYMENT_ID=${DEPLOYMENT_ID}" >> "$BASH_ENV"
 
@@ -141,10 +158,15 @@ jobs:
           when: always
           command: |
             . "$BASH_ENV"
-            npx -y seqpulse@0.5.1 ci finish \
-              --deployment-id "${SEQPULSE_DEPLOYMENT_ID}" \
-              --job-status "${SEQPULSE_JOB_STATUS:-failed}" \
-              --non-blocking true
+            if [ -n "${SEQPULSE_DEPLOYMENT_ID}" ]; then
+              npx -y seqpulse@0.5.2 ci finish \
+                --deployment-id "${SEQPULSE_DEPLOYMENT_ID}" \
+                --job-status "${SEQPULSE_JOB_STATUS:-failed}" \
+                --timeout-ms 15000 \
+                --non-blocking true
+            else
+              echo "Skipping SeqPulse finish: no deployment id available."
+            fi
 ```
 
 ## Jenkins
@@ -176,17 +198,28 @@ pipeline {
         stage('SeqPulse Trigger') {
             steps {
                 script {
-                    def branch = env.CHANGE_BRANCH ?: env.BRANCH_NAME ?: env.GIT_BRANCH ?: 'main'
-                    env.SEQPULSE_DEPLOYMENT_ID = sh(
+                    def branch = (env.CHANGE_BRANCH ?: env.BRANCH_NAME ?: env.GIT_BRANCH ?: 'main')
+                        .replaceFirst(/^origin\//, '')
+                    def triggerRaw = sh(
                         script: """
-                            npx -y seqpulse@0.5.1 ci trigger \
+                            npx -y seqpulse@0.5.2 ci trigger \
                               --env prod \
                               --branch "${branch}" \
                               --non-blocking true \
-                              --output deploymentId
+                              --timeout-ms 15000 \
+                              --output json
                         """,
                         returnStdout: true
                     ).trim()
+
+                    def triggerResult = new groovy.json.JsonSlurperClassic().parseText(triggerRaw ?: "{}")
+                    if (triggerResult?.ok && triggerResult?.deploymentId) {
+                        env.SEQPULSE_DEPLOYMENT_ID = String.valueOf(triggerResult.deploymentId)
+                        echo "SeqPulse trigger accepted for deployment ${env.SEQPULSE_DEPLOYMENT_ID}"
+                    } else {
+                        env.SEQPULSE_DEPLOYMENT_ID = ''
+                        echo "SeqPulse trigger skipped: ${triggerResult?.error ?: 'unknown error'}"
+                    }
                 }
             }
         }
@@ -202,12 +235,17 @@ pipeline {
         always {
             script {
                 def jobStatus = (currentBuild.currentResult ?: 'SUCCESS').toLowerCase()
-                sh """
-                    npx -y seqpulse@0.5.1 ci finish \
-                      --deployment-id "${env.SEQPULSE_DEPLOYMENT_ID ?: ''}" \
-                      --job-status "${jobStatus}" \
-                      --non-blocking true
-                """
+                if (env.SEQPULSE_DEPLOYMENT_ID?.trim()) {
+                    sh """
+                        npx -y seqpulse@0.5.2 ci finish \
+                          --deployment-id "${env.SEQPULSE_DEPLOYMENT_ID}" \
+                          --job-status "${jobStatus}" \
+                          --timeout-ms 15000 \
+                          --non-blocking true
+                    """
+                } else {
+                    echo 'Skipping SeqPulse finish: no deployment id available.'
+                }
             }
         }
     }
@@ -216,6 +254,7 @@ pipeline {
 
 ## Notes pratiques
 
-- Si le package est deja installe dans le projet, vous pouvez remplacer `npx -y seqpulse@0.5.1` par `npx seqpulse`.
+- Si le package est deja installe dans le projet, vous pouvez remplacer `npx -y seqpulse@0.5.2` par `npx seqpulse`.
+- Pour Jenkins, preferer `--output json` si vous voulez logguer clairement un `trigger skipped`.
 - Pour les deploys `prod`, ajoutez un gate explicite sur `main`/tag si votre pipeline est multi-branches.
 - Le pattern recommande est toujours le meme: `trigger -> deploy -> finish`.

package/README.md

@@ -27,6 +27,8 @@ seqpulse.init({
   hmacSecret: process.env.SEQPULSE_HMAC_SECRET,
 });
 
+// Note: hmacEnabled accepts booleans or strings ("true"/"false").
+
 app.use(seqpulse.metrics());
 
 app.get("/", (_req, res) => res.send("ok"));
@@ -85,14 +87,20 @@ async function runDeployment() {
 
 ```bash
 # Trigger
-DEPLOYMENT_ID="$(npx -y seqpulse@0.5.1 ci trigger \
+DEPLOYMENT_ID="$(npx -y seqpulse@0.5.2 ci trigger \
   --env prod \
+  --timeout-ms 15000 \
   --output deploymentId)"
 
 # Finish
-npx -y seqpulse@0.5.1 ci finish \
-  --deployment-id "$DEPLOYMENT_ID" \
-  --job-status "$JOB_STATUS"
+if [ -n "$DEPLOYMENT_ID" ]; then
+  npx -y seqpulse@0.5.2 ci finish \
+    --deployment-id "$DEPLOYMENT_ID" \
+    --job-status "$JOB_STATUS" \
+    --timeout-ms 15000
+else
+  echo "Skipping SeqPulse finish: no deployment id available."
+fi
 ```
 
 Notes:
@@ -101,6 +109,7 @@ Notes:
 - `--github-output` ecrit `deployment_id`, `status`, `http_status`.
 - mode par defaut: non-bloquant (`--non-blocking true`).
 - pour mode strict: `--blocking`.
+- pour CI distante, `--timeout-ms 15000` est recommande.
 
 ## Documentation
 

package/index.js

@@ -71,6 +71,16 @@ function buildSignature(secret, timestamp, method, path, nonce) {
   return `sha256=${digest}`;
 }
 
+function toBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes", "on"].includes(normalized)) return true;
+    if (["false", "0", "no", "off", ""].includes(normalized)) return false;
+  }
+  return Boolean(value);
+}
+
 function rejectHmac(res, message) {
   res.status(401).json({ error: message || "Unauthorized" });
 }
@@ -149,7 +159,7 @@ function init(config) {
   }
 
   const endpoint = canonicalizePath(config.endpoint || DEFAULT_ENDPOINT);
-  const hmacEnabled = Boolean(config.hmacEnabled);
+  const hmacEnabled = toBoolean(config.hmacEnabled);
   const hmacSecret = String(config.hmacSecret || "");
 
   if (hmacEnabled && !hmacSecret) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seqpulse",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "SeqPulse SDK for metrics endpoint instrumentation and HMAC validation",
   "main": "index.js",
   "types": "index.d.ts",