unshared-clientjs-sdk 1.0.1 → 1.0.3

package/README.md

@@ -0,0 +1,109 @@
+# Unshared Labs SDK
+
+A lightweight, drop-in SDK for sending secure session and event data to the **Unshared Labs** platform.
+This package is designed for server environments (e.g., Express, Fastify, Next.js API routes) that need to track account sharing activity, session behavior, or suspicious usage patterns.
+
+---
+
+## Installation
+
+```bash
+npm install unshared-clientjs-sdk
+# or
+yarn add unshared-clientjs-sdk
+```
+
+---
+
+## Quick Example
+
+```ts
+import UnsharedLabsClient from "unshared-clientjs-sdk";
+
+const client = new UnsharedLabsClient({
+  apiKey: process.env.UNSHARED_LABS_API_KEY!,
+});
+```
+
+---
+
+## API
+
+### `submitEvent(...)`
+
+```ts
+submitEvent(
+  eventType: string,
+  userId: string,
+  ipAddress: string,
+  deviceId: string,
+  sessionHash: string,
+  userAgent: string,
+  clientTimestamp: string,
+  eventDetails?: map<String,any> | null
+): Promise<any>
+```
+
+**Parameters**
+
+* `eventType` — string, e.g. `"login"`, `"heartbeat"`, `"logout"`
+* `userId` — string, unique user identifier (encrypted before sending)
+* `ipAddress` — string, client IP (encrypted)
+* `deviceId` — string, device identifier (encrypted)
+* `sessionHash` — string, session identifier or fingerprint (encrypted)
+* `userAgent` — string
+* `clientTimestamp` — ISO timestamp string (e.g. `new Date().toISOString()`).
+* `eventDetails` — optional map of objects (String,any) of additional details
+
+**Returns**: A promise resolving Unshared Lab's DB insert result or rejecting with an error.
+
+---
+
+## Example (Express)
+
+```ts
+import express from "express";
+import UnsharedLabsClient from "unshared-clientjs-sdk";
+
+const app = express();
+app.use(express.json());
+
+const client = new UnsharedLabsClient({
+  apiKey: process.env.UNSHARED_LABS_API_KEY!,
+});
+
+app.post("/login", async (req, res) => {
+  const { userId } = req.body;
+
+  try {
+    await client.submitEvent(
+      "login",
+      userId,
+      req.ip,
+      req.headers["x-device-id"]?.toString() || "unknown-device",
+      req.headers["x-session-hash"]?.toString() || "unknown-session",
+      req.headers["user-agent"] || "",
+      new Date().toISOString(),
+      new Map(Object.entries({"example": true, "source": 'test-server' }))
+    );
+
+    res.status(200).json({ message: "Login tracked" });
+  } catch (err) {
+    res.status(500).json({ error: err instanceof Error ? err.message : err });
+  }
+});
+
+app.listen(3000, () => console.log("Server running on port 3000"));
+```
+
+---
+
+## License
+
+MIT © Unshared Labs
+
+---
+
+## Support
+
+For issues or onboarding help, contact Unshared Labs support.

package/dist/client.d.ts

@@ -1,11 +1,13 @@
 export interface UnsharedLabsClientConfig {
     apiKey: string;
+    clientId: string;
     baseUrl?: string;
 }
 export default class UnsharedLabsClient {
     private _UNSHAREDLABS_DEFAULT_URL;
     private _UNSHAREDLABS_INTERNAL_CLIENT;
     private _apiKey;
+    private _clientId;
     constructor(config: UnsharedLabsClientConfig);
     private _getSupabaseClient;
     submitEvent(eventType: string, userId: string, ipAddress: string, deviceId: string, sessionHash: string, userAgent: string, clientTimestamp: string, eventDetails?: Map<string, any> | null): Promise<any>;

package/dist/client.js

@@ -4,9 +4,10 @@ const supabase_js_1 = require("@supabase/supabase-js");
 const util_1 = require("./util");
 class UnsharedLabsClient {
     constructor(config) {
-        this._UNSHAREDLABS_DEFAULT_URL = 'https://ysufzncettwerbyamygx.supabase.co';
+        this._UNSHAREDLABS_DEFAULT_URL = atob('aHR0cHM6Ly95c3Vmem5jZXR0d2VyYnlhbXlneC5zdXBhYmFzZS5jbwo=');
         let url = config.baseUrl || this._UNSHAREDLABS_DEFAULT_URL;
         this._apiKey = config.apiKey;
+        this._clientId = atob(config.clientId);
         this._UNSHAREDLABS_INTERNAL_CLIENT = this._getSupabaseClient(url, this._apiKey);
     }
     _getSupabaseClient(url, apiKey) {
@@ -36,7 +37,7 @@ class UnsharedLabsClient {
                 event_details: encryptedEventDetails,
             };
             const { data, error } = await this._UNSHAREDLABS_INTERNAL_CLIENT
-                .from('session_heartbeats')
+                .from(this._clientId)
                 .insert(body);
             if (error) {
                 throw error;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unshared-clientjs-sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -12,7 +12,8 @@
     "test-server": "ts-node test-server/server.ts"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": [],
   "author": "",