@simplif/node 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simplif
+
+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/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @simplif/node
+
+Official Node.js SDK for the Simplif fraud prevention API.
+
+## Requirements
+Node.js 18 or later.
+
+## Installation
+npm install @simplif/node
+
+## Quick Start
+
+Import the SDK into your Node.js backend:
+
+    import { Simplif } from "@simplif/node";
+
+    const simplif = new Simplif({
+      apiKey: process.env.SIMPLIF_SECRET_KEY
+    });
+
+    const result = await simplif.evaluateSignup({
+      email: "customer@example.com",
+      device_id: "device_123",
+      user_agent: "Mozilla/5.0"
+    });
+
+    console.log(result);
+
+## Authentication
+Generate your secret API key in the Simplif Developers dashboard.
+Store it securely in SIMPLIF_SECRET_KEY.
+Never expose secret API keys in browser code.
+
+## Error handling
+The SDK throws errors with status and code properties for API failures.
+
+## Security
+This SDK is intended for server-side use only.
+
+API endpoint: https://api.simplif.com

package/index.js

@@ -0,0 +1,44 @@
+export class Simplif {
+  constructor({ apiKey, baseUrl = "https://api.simplif.com" } = {}) {
+    if (!apiKey || typeof apiKey !== "string") {
+      throw new Error("Simplif secret API key is required");
+    }
+
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+
+  async evaluateSignup(data) {
+    if (!data || typeof data.email !== "string" || !data.email.trim()) {
+      throw new Error("Signup email is required");
+    }
+
+    const response = await fetch(
+      `${this.baseUrl}/v1/signups/evaluate`,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.apiKey
+        },
+        body: JSON.stringify(data),
+        signal: AbortSignal.timeout(15000)
+      }
+    );
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      const error = new Error(
+        result.error || `Simplif API error (${response.status})`
+      );
+      error.status = response.status;
+      error.code = result.code;
+      throw error;
+    }
+
+    return result;
+  }
+}
+
+export default Simplif;

package/package.json

@@ -1,6 +1,18 @@
-{
-  "name": "@simplif/node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+    "name": "@simplif/node",
+    "version": "0.1.0",
+    "description": "Simplif fraud prevention Node.js SDK",
+    "type": "module",
+    "main": "./index.js",
+    "exports": "./index.js",
+    "engines": {
+        "node": ">=18"
+    },
+    "license": "MIT",
+    "files": [
+        "index.js"
+    ],
+    "publishConfig": {
+        "access": "public"
+    }
+}