@bondedhq/shared 0.0.0-stage → 0.1.0

package/dist/troubleshooting-doc.js

@@ -0,0 +1,46 @@
+import { UNKNOWN_PROBLEM, troubleshootingList } from "./problems.js";
+/**
+ * The troubleshooting page (docs/TROUBLESHOOTING.md), built from `PROBLEMS`: one section per
+ * code, whose heading is the code itself, so the docs site's anchor for it is `#<code>` (the
+ * links the web app and the runner print). `pnpm docs:troubleshooting` writes it; a test fails
+ * when the committed page is out of date.
+ */
+/** Each area's heading, in the order the page lists them. */
+export const PROBLEM_AREAS = {
+    "sign-in": "Signing in and signed requests",
+    requests: "Limits and requests",
+    registration: "Registering an agent",
+    connection: "Connecting your agent",
+    check: "Connection checks",
+    rating: "Ratings",
+    cover: "Cover and claims",
+    vault: "The vault",
+    notifications: "Notifications",
+    service: "Bonded's own services",
+};
+/** Text that Markdown would read as markup (HTML tags), made plain. */
+const plain = (text) => text.replace(/</g, "&lt;").replace(/>/g, "&gt;");
+export function troubleshootingMarkdown() {
+    const list = troubleshootingList();
+    const lines = [
+        "# Troubleshooting",
+        "",
+        "Every problem, warning and refusal Bonded shows, with what to do about it. Each one has a stable code: the web app's **How to fix this** links, the runner's `how to fix:` lines and the API's `code` fields all point at its section here, whose heading is the code.",
+        "",
+        "Where a message carries numbers, ids or times, the sentence below is its gist. The API returns the code next to each sentence: `code` beside `error` on a refusal (and in `details.code`), `issues[].code` on a connection check's problems and warnings, `problems[].code` in an agent's health panel, and `code` on an in-app notification.",
+        "",
+        "This page is generated from `PROBLEMS` in [packages/shared/src/problems.ts](../packages/shared/src/problems.ts) by `pnpm docs:troubleshooting`. Don't edit it by hand: change the list and run the command.",
+        "",
+    ];
+    for (const [area, title] of Object.entries(PROBLEM_AREAS)) {
+        const entries = list.filter((p) => p.area === area);
+        if (!entries.length)
+            continue;
+        lines.push(`## ${title}`, "");
+        for (const p of entries)
+            lines.push(`### ${p.code}`, "", `**Message:** ${plain(p.sentence)}`, "", `**What to do:** ${plain(p.fix)}`, "");
+    }
+    lines.push("## Anything else", "", `### ${UNKNOWN_PROBLEM}`, "", "**Message:** a sentence this page doesn't list yet. The API gives it the code `other`.", "", "**What to do:** the sentence says what went wrong in its own words. If it isn't clear, check the status page (Status, at the foot of the web app) and try again; if it keeps happening, open an issue with the message.", "");
+    return lines.join("\n");
+}
+//# sourceMappingURL=troubleshooting-doc.js.map

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@bondedhq/shared",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Bonded's shared schemas, ABIs, chain configs, signing types and the agent and runner protocols.",
+  "license": "MIT",
+  "keywords": [
+    "bonded",
+    "ai-agents",
+    "mandate-vault",
+    "zod",
+    "abi"
+  ],
+  "homepage": "https://github.com/ddboy19912/bonded/tree/main/packages/shared#readme",
+  "bugs": {
+    "url": "https://github.com/ddboy19912/bonded/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ddboy19912/bonded.git",
+    "directory": "packages/shared"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./agent-url": {
+      "types": "./dist/agent-url.d.ts",
+      "import": "./dist/agent-url.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "viem": "^2.56.9",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint src test",
+    "test": "vitest run",
+    "abis": "node scripts/gen-abis.mjs",
+    "abis:check": "node scripts/gen-abis.mjs --check",
+    "docs:troubleshooting": "tsc -p tsconfig.build.json && node scripts/gen-troubleshooting.mjs",
+    "docs:troubleshooting:check": "tsc -p tsconfig.build.json && node scripts/gen-troubleshooting.mjs --check"
+  }
 }