@openstaticfish/chattybox-config 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# @openstaticfish/chattybox-config
+
+Typed configuration and runtime validation for ChattyBox config-as-code projects.
+
+```ts
+import { defineConfig } from "@openstaticfish/chattybox-config";
+
+export default defineConfig({
+  schemaVersion: "1",
+  assistant: { name: "Support" },
+  knowledge: {
+    sources: [{ type: "website", url: "https://docs.example.com" }],
+  },
+  widget: { enabled: true },
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export type ConfigMode = "collaborative" | "config_locked";
+export type DeploymentEnvironment = "development" | "preview" | "production";
+export type WebsiteSource = {
+    type: "website";
+    url: string;
+    include?: Array<string>;
+    exclude?: Array<string>;
+    maxPages?: number;
+};
+export type ChattyboxConfig = {
+    schemaVersion: "1";
+    assistant: {
+        name: string;
+        systemPrompt?: string;
+        promptProfile?: "default" | "support" | "sales" | "sarcastic" | "custom";
+        fallbackMessage?: string;
+    };
+    knowledge?: {
+        sources: Array<WebsiteSource>;
+    };
+    runtime?: {
+        locale?: string;
+    };
+    widget?: {
+        enabled: boolean;
+        position?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+        headerTitle?: string;
+        welcomeMessage?: string;
+        theme?: {
+            primaryColor?: string;
+            backgroundColor?: string;
+            textColor?: string;
+        };
+    };
+};
+export declare function validateConfig(config: ChattyboxConfig): ChattyboxConfig;
+export declare function defineConfig(config: ChattyboxConfig): ChattyboxConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,49 @@
+// src/index.ts
+var HEX_COLOR = /^#[0-9a-f]{6}$/i;
+function requireNonEmptyString(value, path) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${path} must be a non-empty string`);
+  }
+}
+function validateOptionalColor(value, path) {
+  if (value !== undefined && (typeof value !== "string" || !HEX_COLOR.test(value))) {
+    throw new Error(`${path} must be a six-digit hex color`);
+  }
+}
+function validateConfig(config) {
+  if (!config || typeof config !== "object")
+    throw new Error("Config must be an object");
+  if (config.schemaVersion !== "1")
+    throw new Error('schemaVersion must be "1"');
+  requireNonEmptyString(config.assistant?.name, "assistant.name");
+  if (config.assistant.systemPrompt !== undefined) {
+    requireNonEmptyString(config.assistant.systemPrompt, "assistant.systemPrompt");
+  }
+  for (const [index, source] of (config.knowledge?.sources ?? []).entries()) {
+    if (source.type !== "website") {
+      throw new Error(`knowledge.sources[${index}].type is not supported`);
+    }
+    requireNonEmptyString(source.url, `knowledge.sources[${index}].url`);
+    try {
+      const url = new URL(source.url);
+      if (url.protocol !== "http:" && url.protocol !== "https:")
+        throw new Error;
+    } catch {
+      throw new Error(`knowledge.sources[${index}].url must be an HTTP(S) URL`);
+    }
+    if (source.maxPages !== undefined && (!Number.isInteger(source.maxPages) || source.maxPages < 1)) {
+      throw new Error(`knowledge.sources[${index}].maxPages must be a positive integer`);
+    }
+  }
+  validateOptionalColor(config.widget?.theme?.primaryColor, "widget.theme.primaryColor");
+  validateOptionalColor(config.widget?.theme?.backgroundColor, "widget.theme.backgroundColor");
+  validateOptionalColor(config.widget?.theme?.textColor, "widget.theme.textColor");
+  return config;
+}
+function defineConfig(config) {
+  return validateConfig(config);
+}
+export {
+  validateConfig,
+  defineConfig
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@openstaticfish/chattybox-config",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist/index.js", "dist/index.d.ts", "README.md"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenStaticFish/chattybox.git",
+    "directory": "packages/sdk-config"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node --format esm && tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist",
+    "prepack": "bun run build",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  }
+}