bereach-openclaw 0.2.6 → 0.2.9

package/README.md

@@ -10,16 +10,19 @@ openclaw plugins install bereach-openclaw
 
 ## Setup
 
-Set your API key in OpenClaw config (`~/.openclaw/openclaw.json`):
+The API key can be set in 3 ways (in order of precedence):
 
-```json5
+**1. OpenClaw config** (recommended) — `~/.openclaw/openclaw.json` or `/data/.openclaw/openclaw.json`:
+
+```json
 {
-  plugins: {
-    entries: {
-      bereach: {
-        enabled: true,
-        config: {
-          BEREACH_API_KEY: "brc_your_token_here"
+  "plugins": {
+    "allow": ["bereach"],
+    "entries": {
+      "bereach": {
+        "enabled": true,
+        "config": {
+          "BEREACH_API_KEY": "brc_your_token_here"
         }
       }
     }
@@ -27,7 +30,11 @@ Set your API key in OpenClaw config (`~/.openclaw/openclaw.json`):
 }
 ```
 
-Or pass it via Docker environment: `docker run -e BEREACH_API_KEY=brc_xxx ...`
+> **Note:** Add `"bereach"` to `plugins.allow` — OpenClaw requires explicit allowlist for non-bundled plugins.
+
+**2. Environment variable** — `BEREACH_API_KEY=brc_xxx` in your shell or `export BEREACH_API_KEY="brc_xxx"` in `~/.bashrc`.
+
+**3. Docker** — pass via `-e` when launching the container: `docker run -e BEREACH_API_KEY=brc_xxx ...`
 
 Restart the Gateway after configuring.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bereach-openclaw",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "BeReach LinkedIn automation plugin for OpenClaw",
   "license": "AGPL-3.0",
   "scripts": {
@@ -15,6 +15,7 @@
     "bereach": "^0.1.4"
   },
   "devDependencies": {
+    "@types/node": "^22.10.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }

package/scripts/test-register.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env tsx
+/// <reference types="node" />
 /**
  * Simulates OpenClaw plugin registration to catch config/trim errors.
  * Run: pnpm exec tsx scripts/test-register.ts
@@ -10,13 +11,13 @@ import register from "../src/index";
 const apiKey = process.env.BEREACH_API_KEY || "brc_test_placeholder";
 
 const mockApi = {
-  config: { BEREACH_API_KEY: apiKey },
+  pluginConfig: { BEREACH_API_KEY: apiKey },
   registerTool: () => {},
   registerCommand: () => {},
   registerCli: () => {},
 };
 
-console.log("Testing plugin register (simulates OpenClaw load)...");
+console.log("Testing plugin register with config (simulates OpenClaw load)...");
 try {
   register(mockApi);
   console.log("✓ register() completed — no trim/undefined errors");
@@ -24,3 +25,14 @@ try {
   console.error("✗ register() failed:", err?.message || err);
   process.exit(1);
 }
+
+console.log("\nTesting plugin register WITHOUT config (should load, fail on first use)...");
+try {
+  register({ pluginConfig: undefined, registerTool: () => {}, registerCommand: () => {}, registerCli: () => {} });
+  console.log("✓ register() completed — plugin loads without config (lazy init)");
+} catch (err: any) {
+  console.error("✗ register() failed with missing config:", err?.message || err);
+  process.exit(1);
+}
+
+console.log("\n✓ All tests passed");

package/src/client.ts

@@ -1,12 +1,22 @@
 import { Bereach } from "bereach";
 
 let instance: Bereach | null = null;
+let pendingKey: string | undefined;
+
+function normalizeKey(raw: unknown): string | undefined {
+  if (raw == null) return undefined;
+  const s = typeof raw === "string" ? raw : String(raw);
+  const t = s.trim();
+  return t.length > 0 ? t : undefined;
+}
+
+export function setApiKey(key: string | undefined): void {
+  pendingKey = normalizeKey(key);
+}
 
 export function createClient(key?: string): Bereach {
   if (!instance) {
-    const raw = key ?? process.env.BEREACH_API_KEY;
-    const apiKey =
-      typeof raw === "string" && raw.trim().length > 0 ? raw.trim() : undefined;
+    const apiKey = normalizeKey(key ?? pendingKey ?? process.env.BEREACH_API_KEY);
     if (!apiKey) {
       throw new Error(
         "BEREACH_API_KEY is required (set in plugin config or environment)",
@@ -16,3 +26,7 @@ export function createClient(key?: string): Bereach {
   }
   return instance;
 }
+
+export function getClient(): Bereach {
+  return createClient();
+}

package/src/commands/index.ts

@@ -1,14 +1,16 @@
-import type { Bereach } from "bereach";
+import { getClient } from "../client";
 
 /**
  * Registers auto-reply commands and CLI commands.
  * Auto-reply commands execute without invoking the LLM.
+ * Client is created lazily on first command invocation.
  */
-export function registerCommands(api: any, client: Bereach) {
+export function registerCommands(api: any) {
   api.registerCommand({
     name: "bereach-credits",
     description: "Show current BeReach credit balance",
     handler: async () => {
+      const client = getClient();
       const res = await (client as any).profile.getCredits();
       const c = res.credits;
       return {
@@ -24,6 +26,7 @@ export function registerCommands(api: any, client: Bereach) {
     name: "bereach-status",
     description: "Show LinkedIn rate limit summary",
     handler: async () => {
+      const client = getClient();
       const res = await (client as any).profile.getLimits();
       const lines = ["BeReach Rate Limits:"];
       for (const [action, data] of Object.entries(res.limits) as [string, any][]) {
@@ -38,6 +41,7 @@ export function registerCommands(api: any, client: Bereach) {
     name: "bereach-limits",
     description: "Show detailed per-action LinkedIn rate limits",
     handler: async () => {
+      const client = getClient();
       const res = await (client as any).profile.getLimits();
       const lines = [`BeReach Rate Limits (multiplier: ${res.multiplier}x):`];
       for (const [action, data] of Object.entries(res.limits) as [string, any][]) {
@@ -62,6 +66,7 @@ export function registerCommands(api: any, client: Bereach) {
         .command("status")
         .description("Show LinkedIn rate limit summary")
         .action(async () => {
+          const client = getClient();
           const res = await (client as any).profile.getLimits();
           console.log("BeReach Rate Limits:");
           for (const [action, data] of Object.entries(res.limits) as [string, any][]) {

package/src/index.ts

@@ -1,18 +1,18 @@
-import { createClient } from "./client";
+import { setApiKey } from "./client";
 import { registerAllTools } from "./tools";
 import { registerCommands } from "./commands";
 
 function getApiKey(api: any): string | undefined {
-  const cfg = api?.config;
   const key =
-    cfg?.BEREACH_API_KEY ??
-    cfg?.plugins?.entries?.bereach?.config?.BEREACH_API_KEY;
+    api?.pluginConfig?.BEREACH_API_KEY ?? // 1. OpenClaw config (plugins.entries.bereach.config)
+    api?.config?.BEREACH_API_KEY ?? // 2. Fallback config path
+    process.env.BEREACH_API_KEY; // 3. Env var (or ~/.bashrc export)
   return typeof key === "string" && key.trim().length > 0 ? key.trim() : undefined;
 }
 
 export default function register(api: any) {
   const apiKey = getApiKey(api);
-  const client = createClient(apiKey);
-  registerAllTools(api, client);
-  registerCommands(api, client);
+  setApiKey(apiKey);
+  registerAllTools(api);
+  registerCommands(api);
 }

package/src/tools/index.ts

@@ -1,11 +1,12 @@
+import { getClient } from "./../client";
 import { definitions } from "./definitions";
-import type { Bereach } from "bereach";
 
 /**
  * Registers all 33 BeReach tools with the OpenClaw agent.
  * Each tool delegates to the corresponding SDK method via dot-path resolution.
+ * Client is created lazily on first tool invocation to avoid trim/undefined errors during plugin load.
  */
-export function registerAllTools(api: any, client: Bereach) {
+export function registerAllTools(api: any) {
   for (const def of definitions) {
     api.registerTool(
       def.name,
@@ -14,6 +15,7 @@ export function registerAllTools(api: any, client: Bereach) {
         parameters: def.parameters,
       },
       async (params: Record<string, unknown>) => {
+        const client = getClient();
         const [resource, method] = def.handler.split(".");
         const result = await (client as any)[resource][method](params);
         return result;

package/tsconfig.json

@@ -8,7 +8,8 @@
     "skipLibCheck": true,
     "outDir": "dist",
     "rootDir": "src",
-    "declaration": true
+    "declaration": true,
+    "types": ["node"]
   },
   "include": ["src/**/*.ts"],
   "exclude": ["__tests__", "node_modules", "dist"]