@saviours/check 0.1.2 → 0.1.3

package/README.md

@@ -1,20 +1,43 @@
 # `@saviours/check`
 
+<p align="left">
+  <img src="https://www.saviours.xyz/brand/saviours-mark-ink.png" alt="saviours" width="40" height="40" />
+</p>
+
 [![npm](https://img.shields.io/npm/v/@saviours/check.svg)](https://www.npmjs.com/package/@saviours/check)
 
 Two-line counterparty check for wallets and agents.  
 Default path reads Sepolia ENS only — **$0**, no Saviours server.
 
+## Install (fresh project)
+
+**Do not run `npm i` / `pnpm add` inside the Saviours git monorepo.**  
+That tree is pnpm-managed; mixing `npm` there crashes arborist (`Cannot read properties of null (reading 'matches')`).
+
 ```bash
-pnpm add @saviours/check
-# npm i @saviours/check
+mkdir saviours-demo && cd saviours-demo
+npm init -y
+npm i @saviours/check
+# or: pnpm init && pnpm add @saviours/check
+```
+
+Package is **ESM-only** (`"type": "module"`). Use `import`, not `require`.
+
+```bash
+node --input-type=module -e "
+import { check } from '@saviours/check';
+const r = await check('0x935bfb495e33f74d2e9735df1da66ace442ede48');
+console.log(r.decision, r.status); // named → BLOCK|WARN · TAINTED|WATCH
+"
 ```
 
 ```ts
 import { check, guard } from "@saviours/check";
 
 const r = await check("0x935bfb495e33f74d2e9735df1da66ace442ede48");
-if (r.decision === "BLOCK") throw new Error("named TAINTED");
+if (r.decision === "BLOCK" || r.decision === "WARN") {
+  throw new Error(\`named \${r.status}\`);
+}
 
 await guard(addr); // throws SavioursBlockedError on BLOCK
 ```
@@ -36,6 +59,15 @@ Also exported: `BAZANTIC_GATEWAY`, `BAZANTIC_MCP`, `SAVIOURS_APP_URL`.
 
 Also: `castCommand(address)`, React helper `@saviours/check/react`.
 
+### Inside this monorepo
+
+Workspace already wires the package — no npm install needed:
+
+```bash
+pnpm --filter @saviours/check build
+pnpm --filter @saviours/check smoke
+```
+
 ## Product law
 
 - Memory hit is always **$0**.
@@ -69,13 +101,3 @@ Never bind in agent recipes: `dispute` · `revoke` · `eacProbe`.
 - Email: [b4harshit01@gmail.com](mailto:b4harshit01@gmail.com)  
 - Twitter: [@harshitb01](https://twitter.com/harshitb01)  
 - GitHub: [devhb1](https://github.com/devhb1) · [issues](https://github.com/devhb1/Saviour/issues)
-
-## Smoke
-
-```bash
-node --input-type=module -e "
-import { check } from '@saviours/check';
-console.log(await check('0x935bfb495e33f74d2e9735df1da66ace442ede48'));
-"
-# → decision BLOCK · status TAINTED
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saviours/check",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Two-line counterparty check — ENS first, Bazantic Shield/investigate gateway",
   "type": "module",
   "license": "MIT",
@@ -30,26 +30,32 @@
   "publishConfig": {
     "access": "public"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./react": {
       "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
     }
   },
   "files": [
     "dist",
     "examples",
-    "README.md"
+    "README.md",
+    "scripts"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "prepare": "tsc -p tsconfig.json",
-    "prepublishOnly": "tsc -p tsconfig.json"
+    "prepublishOnly": "tsc -p tsconfig.json",
+    "smoke": "node ./scripts/smoke.mjs"
   },
   "peerDependencies": {
     "react": ">=18"

package/scripts/smoke.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * Integrator smoke — after `npm i @saviours/check` in a fresh project:
+ *   node node_modules/@saviours/check/scripts/smoke.mjs
+ * From this monorepo:
+ *   pnpm --filter @saviours/check smoke
+ */
+let check;
+try {
+  ({ check } = await import("@saviours/check"));
+} catch {
+  ({ check } = await import("../dist/index.js"));
+}
+
+const ATTACK_1 = "0x935bfb495e33f74d2e9735df1da66ace442ede48";
+
+const r = await check(ATTACK_1);
+const named =
+  r.decision === "BLOCK" ||
+  r.decision === "WARN" ||
+  r.status === "TAINTED" ||
+  r.status === "WATCH";
+
+console.log(
+  JSON.stringify(
+    {
+      address: ATTACK_1,
+      decision: r.decision,
+      status: r.status,
+      source: r.source,
+      ensName: r.ensName ?? null,
+    },
+    null,
+    2,
+  ),
+);
+
+if (!named) {
+  console.error(
+    "Expected ATTACK-1 to be named (BLOCK/WARN · TAINTED/WATCH). Got",
+    r.decision,
+    r.status,
+  );
+  process.exit(1);
+}
+
+console.log("smoke ok · named threat · ENS resolve path");