@bbclaw/shared 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @bbclaw/shared
+ *
+ * Tiny zero-dependency types shared between core, cli, desktop, and backend.
+ * Anything that needs a runtime dependency (SDK types, http clients) belongs
+ * in @bbclaw/core, not here.
+ */
+/** Discriminated result, used in lieu of `throw` for predictable failures. */
+export type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export declare function ok<T>(value: T): Result<T, never>;
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Top-level provider taxonomy. Each kind has its own family of implementations:
+ * - `anthropic`: official Anthropic API (and bedrock/vertex if we add them).
+ * - `openai-compat`: anything that speaks OpenAI's chat/completions schema.
+ * - `web-bridge`: browser-controlled chat services (DeepSeek/Kimi/ChatGPT/...).
+ */
+export declare const PROVIDER_KINDS: readonly ["anthropic", "openai-compat", "web-bridge"];
+export type ProviderKind = (typeof PROVIDER_KINDS)[number];
+/**
+ * Minimal logger surface. Real implementations live wherever they make sense
+ * (CLI uses pino-pretty, desktop uses an in-memory ring buffer, backend uses
+ * pino → stdout). Core code calls these methods and stays unopinionated.
+ */
+export interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+export declare const silentLogger: Logger;
+/** Helpful for tests and dev: writes everything to stderr with a prefix. */
+export declare function consoleLogger(prefix?: string): Logger;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AAEnF,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,uDAAwD,CAAA;AACnF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAChC;AAED,eAAO,MAAM,YAAY,EAAE,MAK1B,CAAA;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,SAAa,GAAG,MAAM,CAWzD"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * @bbclaw/shared
+ *
+ * Tiny zero-dependency types shared between core, cli, desktop, and backend.
+ * Anything that needs a runtime dependency (SDK types, http clients) belongs
+ * in @bbclaw/core, not here.
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+/**
+ * Top-level provider taxonomy. Each kind has its own family of implementations:
+ * - `anthropic`: official Anthropic API (and bedrock/vertex if we add them).
+ * - `openai-compat`: anything that speaks OpenAI's chat/completions schema.
+ * - `web-bridge`: browser-controlled chat services (DeepSeek/Kimi/ChatGPT/...).
+ */
+export const PROVIDER_KINDS = ['anthropic', 'openai-compat', 'web-bridge'];
+export const silentLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/** Helpful for tests and dev: writes everything to stderr with a prefix. */
+export function consoleLogger(prefix = '[bbclaw]') {
+    const write = (level, args) => {
+        // biome-ignore lint/suspicious/noConsole: intentional stderr logger
+        console.error(prefix, level, ...args);
+    };
+    return {
+        debug: (...a) => write('DEBUG', a),
+        info: (...a) => write('INFO', a),
+        warn: (...a) => write('WARN', a),
+        error: (...a) => write('ERROR', a),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,eAAe,EAAE,YAAY,CAAU,CAAA;AAenF,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAA;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,MAAM,GAAG,UAAU;IAC/C,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAAe,EAAQ,EAAE;QACrD,oEAAoE;QACpE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;IACvC,CAAC,CAAA;IACD,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;KACnC,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@bbclaw/shared",
+  "version": "0.1.0",
+  "description": "Shared type contracts for BBClaw — zero runtime deps.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests"
+  }
+}