@reactll/connect 1.0.1 → 1.1.1

package/README.md

@@ -1,6 +1,6 @@
-# Reactll Connect for Next.js
+# Reactll Connect for Next.js and Node.js
 
-Connects a Next.js site to its [Reactll](https://reactll.com) dashboard: visits, calls, WhatsApp and
+Connects a Next.js or any Node.js site (Express, Fastify, Nuxt, Remix, Astro, Hono…) to its [Reactll](https://reactll.com) dashboard: visits, calls, WhatsApp and
 directions clicks, form leads and site health. Built and maintained by **Reactor Technology**.
 
 ## Install
@@ -54,6 +54,32 @@ export async function contact(formData: FormData) {
 The script stamps every form with the page view id (`_rc_pv`), so Reactll ties the lead to the visit it
 came from. `submitLead(form, fields, options)` takes a plain object instead. Neither ever throws.
 
+## Any other Node.js app
+
+The same package, without Next.js or React (they are optional):
+
+```js
+import { scriptTag, expressHealth, submitLead } from '@reactll/connect/server';
+
+app.use(expressHealth());                       // Express / Connect / node:http — GET /api/reactll/health
+res.render('page', { reactll: scriptTag() });   // put {{{ reactll }}} / <%- reactll %> in the <head>
+
+// after your form was validated and saved:
+await submitLead('Contact', { name, email, message }, { pv: req.body._rc_pv, page: req.get('referer') });
+```
+
+Frameworks on web `Request`/`Response` (Hono, Remix, Nuxt/h3, Astro, Bun, Deno): route
+`GET /api/reactll/health` to `health(request)` from `@reactll/connect/server`.
+
+## Content-Security-Policy
+
+If the site sends a CSP header, allow Reactll Connect in it, or the browser blocks the script and its beacons:
+
+```
+script-src  … https://connect.reactll.com
+connect-src … https://connect.reactll.com
+```
+
 ## License
 
 MIT © Reactor Technology

package/dist/server.d.ts

@@ -21,6 +21,11 @@ export declare function submitLead(form: string, fields: Fields, options?: LeadO
 export declare function submitLeadFromFormData(form: string, data: FormData, options?: LeadOptions & {
     headers?: Headers;
 }): Promise<boolean>;
+/**
+ * The script tag for any server-rendered page (Express/EJS, Handlebars, Fastify, Nuxt, Astro…), or ''
+ * when not connected. Put it in the <head>. Only the public site key is in it.
+ */
+export declare function scriptTag(token?: string): string;
 /**
  * Hourly health check, asked by Reactll (Next.js has no scheduler of its own). Export it from
  * app/api/reactll/health/route.ts:
@@ -31,3 +36,23 @@ export declare function submitLeadFromFormData(form: string, data: FormData, opt
  */
 export declare function GET(request: Request): Promise<Response>;
 export declare const dynamic = "force-dynamic";
+/** The health answer as plain data (platform and versions), for any framework. */
+export declare function health(request: Request): Promise<Response>;
+type NodeReq = {
+    method?: string;
+    url?: string;
+    originalUrl?: string;
+    headers: Record<string, string | string[] | undefined>;
+};
+type NodeRes = {
+    statusCode: number;
+    setHeader(name: string, value: string): unknown;
+    end(body?: string): unknown;
+};
+/**
+ * Express / Connect (and plain node:http) middleware answering Reactll's hourly health question at
+ * GET /api/reactll/health. Other requests pass through.
+ *
+ *   app.use(expressHealth());
+ */
+export declare function expressHealth(path?: string): (req: NodeReq, res: NodeRes, next?: () => void) => Promise<void>;

package/dist/server.js

@@ -65,6 +65,14 @@ export async function submitLeadFromFormData(form, data, options = {}) {
     const pv = typeof data.get('_rc_pv') === 'string' ? data.get('_rc_pv') : null;
     return submitLead(form, fields, { ...options, pv: options.pv ?? pv, page: options.page ?? options.headers?.get('referer') ?? null });
 }
+/**
+ * The script tag for any server-rendered page (Express/EJS, Handlebars, Fastify, Nuxt, Astro…), or ''
+ * when not connected. Put it in the <head>. Only the public site key is in it.
+ */
+export function scriptTag(token) {
+    const c = credentials(token);
+    return c ? `<script src="${c.u}/c.js" data-site="${c.k}" defer></script>` : '';
+}
 function versionOf(pkg) {
     try {
         return createRequire(import.meta.url)(`${pkg}/package.json`).version;
@@ -93,7 +101,7 @@ export async function GET(request) {
         return Response.json({ error: 'unauthorized' }, { status: 401 });
     }
     return Response.json({
-        platform: 'next',
+        platform: versionOf('next') ? 'next' : 'node',
         version: VERSION,
         runtime: Object.fromEntries(Object.entries({
             next: versionOf('next'),
@@ -101,7 +109,39 @@ export async function GET(request) {
             node: process.version.replace(/^v/, ''),
             environment: process.env.VERCEL_ENV ?? process.env.NODE_ENV,
             host: process.env.VERCEL ? 'Vercel' : undefined,
+            // Reactll counts the site's days on this clock (UTC is read as "not set"; set TZ to override).
+            timezone: process.env.TZ || Intl.DateTimeFormat().resolvedOptions().timeZone,
         }).filter(([, v]) => v)),
     }, { headers: { 'Cache-Control': 'no-store' } });
 }
 export const dynamic = 'force-dynamic';
+/** The health answer as plain data (platform and versions), for any framework. */
+export async function health(request) {
+    return GET(request);
+}
+/**
+ * Express / Connect (and plain node:http) middleware answering Reactll's hourly health question at
+ * GET /api/reactll/health. Other requests pass through.
+ *
+ *   app.use(expressHealth());
+ */
+export function expressHealth(path = '/api/reactll/health') {
+    return async (req, res, next) => {
+        const url = (req.originalUrl ?? req.url ?? '').split('?')[0];
+        if ((req.method ?? 'GET') !== 'GET' || url !== path) {
+            next?.();
+            return;
+        }
+        const header = (name) => {
+            const v = req.headers[name];
+            return Array.isArray(v) ? v[0] : (v ?? '');
+        };
+        const answer = await GET(new Request('http://localhost' + path, {
+            headers: { 'x-reactll-timestamp': header('x-reactll-timestamp'), 'x-reactll-signature': header('x-reactll-signature') },
+        }));
+        res.statusCode = answer.status;
+        res.setHeader('Content-Type', 'application/json');
+        res.setHeader('Cache-Control', 'no-store');
+        res.end(await answer.text());
+    };
+}

package/dist/token.d.ts

@@ -5,7 +5,7 @@
  * endpoint, the site's public key and its secret. Only the endpoint and the public key ever reach
  * the browser.
  */
-export declare const VERSION = "1.0.0";
+export declare const VERSION = "1.1.1";
 export interface Credentials {
     /** Endpoint, e.g. https://connect.reactll.com/v1 */
     u: string;

package/dist/token.js

@@ -5,7 +5,7 @@
  * endpoint, the site's public key and its secret. Only the endpoint and the public key ever reach
  * the browser.
  */
-export const VERSION = '1.0.0';
+export const VERSION = '1.1.1';
 export function credentials(token = process.env.REACTLL_CONNECT_TOKEN) {
     const raw = (token ?? '').trim();
     if (!raw.startsWith('rcc_'))

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@reactll/connect",
-  "version": "1.0.1",
-  "description": "Reactll Connect for Next.js: visits, clicks, form leads and site health for your Reactll dashboard.",
+  "version": "1.1.1",
+  "description": "Reactll Connect for Next.js and any Node.js app: visits, clicks, form leads and site health for your Reactll dashboard.",
   "keywords": [
     "nextjs",
+    "nodejs",
+    "express",
     "analytics",
     "leads",
     "reactll"
@@ -47,5 +49,16 @@
     "next": "^15.5.0",
     "react": "^19.0.0",
     "typescript": "^5.6.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
   }
 }