@founderroute/analytics-node 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FounderRoute
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/index.d.ts

@@ -0,0 +1,6 @@
+export function signIdentity(input:{secret:string;propertyId:string;userId:string;expiresInSeconds?:number}):string;
+export class FounderRouteServer {
+  constructor(options:{secret:string;endpoint:string;fetch?:typeof fetch});
+  event(name:string,input:{consent:boolean;verificationId?:string;userId:string;anonymousId:string;eventId?:string;outcomeId?:string;accountId?:string;occurredAt?:string;traits?:Record<string,unknown>;properties?:Record<string,unknown>}):Record<string,unknown>|null;
+  send(events:Array<Record<string,unknown>|null>):Promise<{results:Array<{event_id:string;status:string;reason?:string}>}>;
+}

package/index.js

@@ -0,0 +1,22 @@
+import { createHash, createHmac, randomUUID } from "node:crypto";
+export function signIdentity({secret,propertyId,userId,expiresInSeconds=3600}) {
+  if(!secret?.startsWith("fr_sk_")||!propertyId||!userId)throw new Error("A server key, property, and opaque user ID are required.");
+  const payload=Buffer.from(JSON.stringify({property_id:propertyId,user_id:userId,exp:Math.floor(Date.now()/1000)+Math.min(604800,Math.max(60,expiresInSeconds))})).toString("base64url");
+  const signingKey=createHash("sha256").update(secret).digest("hex");
+  return `${payload}.${createHmac("sha256",signingKey).update(payload).digest("base64url")}`;
+}
+export class FounderRouteServer {
+  constructor({secret,endpoint,fetch:transport=globalThis.fetch}) { if(!secret?.startsWith("fr_sk_"))throw new Error("A server ingest secret is required.");this.secret=secret;this.endpoint=endpoint.replace(/\/$/,"");this.fetch=transport; }
+  event(name,{consent,userId,anonymousId,eventId=randomUUID(),outcomeId,accountId,occurredAt=new Date().toISOString(),traits={},properties={},verificationId}) {
+    if(consent!==true)return null;
+    if(!userId||!anonymousId)throw new Error("Pass a stable user ID and the originating anonymous ID.");
+    return {event_id:eventId,protocol:1,name,kind:"custom",consent:true,occurred_at:occurredAt,anonymous_id:anonymousId,user_id:userId,...(outcomeId?{outcome_id:outcomeId}:{}),...(accountId?{account_id:accountId}:{}),traits,properties,context:{sdk:"node",sdk_version:"0.1.0-beta.1",...(verificationId?{verification_id:verificationId}:{})}};
+  }
+  async send(events) {
+    const batch=events.filter(Boolean);if(!batch.length)return {results:[]};
+    if(batch.length>50)throw new Error("Send at most 50 events per batch.");
+    const body=JSON.stringify({events:batch});if(Buffer.byteLength(body)>65536)throw new Error("Batch exceeds 64 KiB.");
+    const response=await this.fetch(`${this.endpoint}/api/analytics/v1/server-events`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.secret}`},body});
+    const result=await response.json();if(!response.ok){const error=new Error(result.error??"Analytics delivery failed");error.status=response.status;error.retryAfter=response.headers.get("Retry-After");throw error;}return result;
+  }
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@founderroute/analytics-node",
+  "version": "0.1.0-beta.1",
+  "description": "FounderRoute server analytics SDK for verified outcomes and identity assertions",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": ["index.js", "index.d.ts", "LICENSE"],
+  "engines": { "node": ">=20" },
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/itsreed/founderroute-analytics.git", "directory": "packages/node" },
+  "homepage": "https://github.com/itsreed/founderroute-analytics#readme",
+  "bugs": { "url": "https://github.com/itsreed/founderroute-analytics/issues" },
+  "publishConfig": { "access": "public", "provenance": true }
+}