@labyrinthe/connect 0.0.0-stage → 1.2.0

package/dist/next.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+var connect = require('@labyrinthe/connect');
+
+// src/next.ts
+function labyrintheWebhookHandler(options) {
+  return async (request) => {
+    const secret = options.secret ?? readEnv("LABYRINTHE_WEBHOOK_SECRET");
+    if (secret === void 0 || secret === "") {
+      return json(500, { error: { code: "WEBHOOK_SECRET_MISSING", message: "No webhook secret configured." } });
+    }
+    let event;
+    try {
+      const rawBody = new Uint8Array(await request.arrayBuffer());
+      event = await connect.Webhooks.constructEvent(
+        rawBody,
+        request.headers.get("x-signature"),
+        secret,
+        options.toleranceSeconds === void 0 ? {} : { toleranceSeconds: options.toleranceSeconds }
+      );
+    } catch (error) {
+      if (error instanceof connect.SignatureVerificationError || error instanceof connect.InvalidWebhookPayloadError) {
+        return json(400, { error: { code: error.code, message: error.message } });
+      }
+      throw error;
+    }
+    try {
+      const result = await options.onEvent(event, request);
+      return result instanceof Response ? result : json(200, { received: true });
+    } catch (error) {
+      const logger = globalThis.console;
+      logger?.error?.("Labyrinthe webhook handler failed", { event: event.event, id: event.id }, error);
+      return json(500, { error: { code: "WEBHOOK_HANDLER_FAILED", message: "The webhook handler failed." } });
+    }
+  };
+}
+function json(status, body) {
+  return new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json" } });
+}
+function readEnv(name) {
+  try {
+    return globalThis.process?.env?.[name];
+  } catch {
+    return void 0;
+  }
+}
+
+exports.labyrintheWebhookHandler = labyrintheWebhookHandler;

package/dist/next.d.cts

@@ -0,0 +1,31 @@
+import { WebhookEvent } from '@labyrinthe/connect';
+export { WebhookEvent } from '@labyrinthe/connect';
+
+/**
+ * Webhook handler for Next.js App Router Route Handlers — and any runtime
+ * built on the Fetch API `Request` / `Response` (Vercel edge, Deno, Bun, Hono…).
+ *
+ *     // app/api/webhooks/labyrinthe/route.ts
+ *     import { labyrintheWebhookHandler } from '@labyrinthe/connect/next';
+ *
+ *     export const POST = labyrintheWebhookHandler({
+ *       secret: process.env.LABYRINTHE_WEBHOOK_SECRET!,
+ *       onEvent: async (event) => { … },
+ *     });
+ */
+
+interface LabyrintheWebhookHandlerOptions {
+    /** Endpoint secret (client area > Developers > Webhooks). Defaults to `process.env.LABYRINTHE_WEBHOOK_SECRET`. */
+    secret?: string;
+    /** Max age of a delivery, in seconds (default 300; 0 disables the check). */
+    toleranceSeconds?: number;
+    /**
+     * Handles a verified event. Return nothing to answer 200, or your own
+     * `Response`. If it throws, the handler answers 500 and the delivery is
+     * retried later. Answer within 10 seconds: queue slow work.
+     */
+    onEvent: (event: WebhookEvent, request: Request) => unknown;
+}
+declare function labyrintheWebhookHandler(options: LabyrintheWebhookHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type LabyrintheWebhookHandlerOptions, labyrintheWebhookHandler };

package/dist/next.d.ts

@@ -0,0 +1,31 @@
+import { WebhookEvent } from '@labyrinthe/connect';
+export { WebhookEvent } from '@labyrinthe/connect';
+
+/**
+ * Webhook handler for Next.js App Router Route Handlers — and any runtime
+ * built on the Fetch API `Request` / `Response` (Vercel edge, Deno, Bun, Hono…).
+ *
+ *     // app/api/webhooks/labyrinthe/route.ts
+ *     import { labyrintheWebhookHandler } from '@labyrinthe/connect/next';
+ *
+ *     export const POST = labyrintheWebhookHandler({
+ *       secret: process.env.LABYRINTHE_WEBHOOK_SECRET!,
+ *       onEvent: async (event) => { … },
+ *     });
+ */
+
+interface LabyrintheWebhookHandlerOptions {
+    /** Endpoint secret (client area > Developers > Webhooks). Defaults to `process.env.LABYRINTHE_WEBHOOK_SECRET`. */
+    secret?: string;
+    /** Max age of a delivery, in seconds (default 300; 0 disables the check). */
+    toleranceSeconds?: number;
+    /**
+     * Handles a verified event. Return nothing to answer 200, or your own
+     * `Response`. If it throws, the handler answers 500 and the delivery is
+     * retried later. Answer within 10 seconds: queue slow work.
+     */
+    onEvent: (event: WebhookEvent, request: Request) => unknown;
+}
+declare function labyrintheWebhookHandler(options: LabyrintheWebhookHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type LabyrintheWebhookHandlerOptions, labyrintheWebhookHandler };

package/dist/next.js

@@ -0,0 +1,46 @@
+import { Webhooks, SignatureVerificationError, InvalidWebhookPayloadError } from '@labyrinthe/connect';
+
+// src/next.ts
+function labyrintheWebhookHandler(options) {
+  return async (request) => {
+    const secret = options.secret ?? readEnv("LABYRINTHE_WEBHOOK_SECRET");
+    if (secret === void 0 || secret === "") {
+      return json(500, { error: { code: "WEBHOOK_SECRET_MISSING", message: "No webhook secret configured." } });
+    }
+    let event;
+    try {
+      const rawBody = new Uint8Array(await request.arrayBuffer());
+      event = await Webhooks.constructEvent(
+        rawBody,
+        request.headers.get("x-signature"),
+        secret,
+        options.toleranceSeconds === void 0 ? {} : { toleranceSeconds: options.toleranceSeconds }
+      );
+    } catch (error) {
+      if (error instanceof SignatureVerificationError || error instanceof InvalidWebhookPayloadError) {
+        return json(400, { error: { code: error.code, message: error.message } });
+      }
+      throw error;
+    }
+    try {
+      const result = await options.onEvent(event, request);
+      return result instanceof Response ? result : json(200, { received: true });
+    } catch (error) {
+      const logger = globalThis.console;
+      logger?.error?.("Labyrinthe webhook handler failed", { event: event.event, id: event.id }, error);
+      return json(500, { error: { code: "WEBHOOK_HANDLER_FAILED", message: "The webhook handler failed." } });
+    }
+  };
+}
+function json(status, body) {
+  return new Response(JSON.stringify(body), { status, headers: { "Content-Type": "application/json" } });
+}
+function readEnv(name) {
+  try {
+    return globalThis.process?.env?.[name];
+  } catch {
+    return void 0;
+  }
+}
+
+export { labyrintheWebhookHandler };

package/package.json

@@ -1,6 +1,121 @@
 {
   "name": "@labyrinthe/connect",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Official Node.js / TypeScript SDK for Labyrinthe Connect: send SMS and verify phone numbers with OTP (DR Congo, Central Africa).",
+  "keywords": [
+    "labyrinthe",
+    "sms",
+    "otp",
+    "2fa",
+    "verification",
+    "drc",
+    "congo",
+    "sdk"
+  ],
+  "homepage": "https://github.com/Labyrinthe-Team/labyrinthe-connect-sdks/tree/main/node#readme",
+  "bugs": {
+    "url": "https://github.com/Labyrinthe-Team/labyrinthe-connect-sdks/issues",
+    "email": "connect@labyrinthe-rdc.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Labyrinthe-Team/labyrinthe-connect-sdks.git",
+    "directory": "node"
+  },
+  "license": "MIT",
+  "author": "Labyrinthe Connect <connect@labyrinthe-rdc.com>",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./express": {
+      "import": {
+        "types": "./dist/express.d.ts",
+        "default": "./dist/express.js"
+      },
+      "require": {
+        "types": "./dist/express.d.cts",
+        "default": "./dist/express.cjs"
+      }
+    },
+    "./next": {
+      "import": {
+        "types": "./dist/next.d.ts",
+        "default": "./dist/next.js"
+      },
+      "require": {
+        "types": "./dist/next.d.cts",
+        "default": "./dist/next.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist",
+    "README.md",
+    "README.fr.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.src.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run tests/integration.test.ts",
+    "check:dist": "node scripts/check-dist.mjs && node scripts/check-dist.cjs",
+    "publint": "publint --strict",
+    "attw": "attw --pack . --profile node16",
+    "check": "npm run lint && npm run typecheck && npm test && npm run build && npm run check:dist && npm run publint && npm run attw",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "express": ">=4.17",
+    "next": ">=13.4"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
+    "@eslint/js": "9.39.5",
+    "@types/express": "5.0.6",
+    "@types/node": "20.19.43",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "eslint": "9.39.5",
+    "express": "5.2.1",
+    "publint": "0.3.25",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.72.0",
+    "vite": "6.4.4",
+    "vitest": "3.2.7",
+    "yaml": "2.9.1"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}