lovewebconnection 0.0.0-stage → 0.2.0

package/dist/webhook.d.ts

@@ -0,0 +1,17 @@
+export interface WebhookOptions {
+    /** Value for the Authorization header; null or blank sends none. */
+    authHeader?: string | null;
+    timeoutMs?: number;
+    /** Injected for tests; defaults to the global fetch. */
+    fetchImpl?: typeof fetch;
+}
+export interface WebhookResult {
+    ok: boolean;
+    /** Failure reason when ok is false, else null. */
+    message: string | null;
+}
+/**
+ * POST an alert payload. Delivery never throws, so a receiver that rejects the
+ * call cannot end a watch run; the caller decides how to report the failure.
+ */
+export declare function postWebhook(url: string, payload: Record<string, unknown>, options?: WebhookOptions): Promise<WebhookResult>;

package/dist/webhook.js

@@ -0,0 +1,35 @@
+const DEFAULT_TIMEOUT_MS = 3000;
+function describe(error) {
+    if (error instanceof Error) {
+        const short = error.shortMessage;
+        if (typeof short === "string" && short.length > 0)
+            return short;
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * POST an alert payload. Delivery never throws, so a receiver that rejects the
+ * call cannot end a watch run; the caller decides how to report the failure.
+ */
+export async function postWebhook(url, payload, options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const headers = { "content-type": "application/json" };
+    const auth = options.authHeader?.trim();
+    if (auth)
+        headers.authorization = auth;
+    try {
+        const response = await fetchImpl(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(options.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+        });
+        return response.ok
+            ? { ok: true, message: null }
+            : { ok: false, message: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return { ok: false, message: describe(error) };
+    }
+}

package/examples/erc20.abi.json

@@ -0,0 +1,57 @@
+[
+  {
+    "type": "function",
+    "name": "name",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "string" }]
+  },
+  {
+    "type": "function",
+    "name": "symbol",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "string" }]
+  },
+  {
+    "type": "function",
+    "name": "decimals",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint8" }]
+  },
+  {
+    "type": "function",
+    "name": "totalSupply",
+    "stateMutability": "view",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint256" }]
+  },
+  {
+    "type": "function",
+    "name": "balanceOf",
+    "stateMutability": "view",
+    "inputs": [{ "name": "account", "type": "address" }],
+    "outputs": [{ "name": "", "type": "uint256" }]
+  },
+  {
+    "type": "function",
+    "name": "allowance",
+    "stateMutability": "view",
+    "inputs": [
+      { "name": "owner", "type": "address" },
+      { "name": "spender", "type": "address" }
+    ],
+    "outputs": [{ "name": "remaining", "type": "uint256" }]
+  },
+  {
+    "type": "function",
+    "name": "transfer",
+    "stateMutability": "nonpayable",
+    "inputs": [
+      { "name": "to", "type": "address" },
+      { "name": "amount", "type": "uint256" }
+    ],
+    "outputs": [{ "name": "", "type": "bool" }]
+  }
+]

package/examples/xlayer.tokens.json

@@ -0,0 +1,4 @@
+[
+  "0x1E4a5963aBFD975d8c9021ce480b42188849D41d",
+  "0xe538905cf8410324e03A5A23C1c177a474D59b2b"
+]

package/package.json

@@ -1,6 +1,79 @@
 {
   "name": "lovewebconnection",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "lwc — read-only EVM chain connection kit: chain health, balances, scans, view calls, and watch-mode reliability checks",
+  "license": "MIT",
+  "homepage": "https://github.com/emeraldjewels4-rgb/lovewebconnection-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emeraldjewels4-rgb/lovewebconnection-cli.git"
+  },
+  "author": "emeraldjewels4-rgb (https://github.com/emeraldjewels4-rgb)",
+  "type": "module",
+  "bin": {
+    "lwc": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "keywords": [
+    "evm",
+    "ethereum",
+    "rpc",
+    "blockchain",
+    "viem",
+    "read-only",
+    "xlayer",
+    "base",
+    "cli"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "prepare": "git config core.hooksPath .githooks || true",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test src/chain.test.ts src/balances.test.ts src/contract.test.ts src/watch.test.ts src/call.test.ts src/metrics.test.ts src/scan.test.ts src/compare.test.ts src/compare-history.test.ts src/metadata-cache.test.ts src/cache.test.ts src/tokenfile.test.ts src/views.test.ts src/signatures.test.ts src/sessions.test.ts src/history.test.ts src/plot.test.ts src/prices.test.ts src/rotate.test.ts src/webhook.test.ts src/alert-queue.test.ts src/alert-store.test.ts src/market.test.ts src/market-server.test.ts src/presets-summary.test.ts src/presets-history.test.ts src/presets.test.ts src/explorer-state.test.ts src/explorer-browser.test.ts",
+    "chain": "node src/cli.ts",
+    "chain:json": "node src/cli.ts --json",
+    "balances": "node src/cli.ts balances",
+    "example": "node src/cli.ts example",
+    "watch": "node src/cli.ts watch",
+    "call": "node src/cli.ts call",
+    "tokens": "node src/cli.ts tokens",
+    "views": "node src/cli.ts views",
+    "signatures": "node src/cli.ts signatures",
+    "sessions": "node src/cli.ts sessions",
+    "history": "node src/cli.ts history",
+    "plot": "node src/cli.ts plot",
+    "scan": "node src/cli.ts scan",
+    "cache": "node src/cli.ts cache",
+    "compare": "node src/cli.ts compare",
+    "compare-history": "node src/cli.ts compare-history",
+    "market": "node src/cli.ts market",
+    "presets": "node src/cli.ts presets",
+    "presets-history": "node src/cli.ts presets-history",
+    "explorer:data": "node scripts/explorer-data.mjs",
+    "migrate": "node scripts/migrate.mjs"
+  },
+  "dependencies": {
+    "viem": "^2.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "typescript": "^5.6.0"
+  }
+}