@jchat/addon-sdk 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/vite.mjs

@@ -1,11 +1,28 @@
 import fs from "node:fs";
 import path from "node:path";
-import { execFileSync } from "node:child_process";
 import crypto from "node:crypto";
 //#region src/vite.ts
 /**
-* Vite plugin to configure Jchat addon manifest generation, bundle backend scripts, copy
-* migrations, declarative seed data, and zip production build artifacts.
+* Vite plugin for building JChat sandboxed addon extensions.
+*
+* Configures automatic manifest generation (`manifest.json`), bundles server-side API scripts
+* (`src/api.ts`), embeds scoped Tailwind CSS into the frontend bundle, packages database migrations
+* and seed files, copies documentation (`README.md`), signs database-bearing addon manifests, and
+* zips production build artifacts.
+*
+* @example
+*   ;```ts
+*   import { jchatAddon } from "@jchat/addon-sdk/vite"
+*   import manifest from "./src/manifest"
+*   import { defineConfig } from "vite"
+*
+*   export default defineConfig({
+*     plugins: [jchatAddon({ manifest })]
+*   })
+*   ```
+*
+* @param options - Configuration options for the JChat addon Vite plugin.
+* @returns A Vite {@link Plugin} instance configured for addon compilation.
 */
 function jchatAddon(options) {
 	const { manifest: manifestData } = options;
@@ -15,10 +32,45 @@ function jchatAddon(options) {
 		name: "jchat-addon",
 		apply: "build",
 		config(_, env) {
-			return { define: { "process.env.NODE_ENV": JSON.stringify(env.mode || "production") } };
+			const rootDir = process.cwd();
+			const uiEntry = path.resolve(rootDir, "src/ui.tsx");
+			const hasUi = fs.existsSync(uiEntry);
+			return {
+				define: {
+					global: "window",
+					"process.env.NODE_ENV": JSON.stringify(env.mode || "production")
+				},
+				build: {
+					outDir: "build",
+					emptyOutDir: true,
+					minify: env.mode === "production",
+					...hasUi ? {
+						lib: {
+							entry: uiEntry,
+							name: manifestData.id,
+							formats: ["es"],
+							fileName: () => "ui.[hash].js"
+						},
+						rolldownOptions: {
+							external: [
+								"react",
+								"react-dom",
+								"react/jsx-runtime",
+								"react/jsx-dev-runtime",
+								"@tanstack/react-query",
+								"@jchat/addon-sdk",
+								"@jchat/addon-sdk/state",
+								"@jchat/addon-sdk/ui",
+								"@jchat/addon-sdk/icon"
+							],
+							output: { format: "esm" }
+						}
+					} : {}
+				}
+			};
 		},
 		configResolved(config) {
-			developmentBuild = config.mode === "development";
+			developmentBuild = options.development ?? (config.mode === "development" || process.env.JCHAT_ADDON_DEV === "true" || process.env.NODE_ENV === "development");
 			if (shouldZip === void 0) shouldZip = config.mode === "production";
 		},
 		async writeBundle() {
@@ -41,9 +93,13 @@ function jchatAddon(options) {
 				}
 			};
 			const serverSrcPath = path.resolve(rootDir, "src/api.ts");
-			const hasServer = fs.existsSync(serverSrcPath);
+			const hasServer = await Bun.file(serverSrcPath).exists();
 			if (hasServer) {
-				execFileSync("bun", createAddonServerBuildArguments(serverSrcPath, path.resolve(buildDir, "api.js"), developmentBuild), { stdio: "inherit" });
+				Bun.spawnSync(["bun", ...createAddonServerBuildArguments(serverSrcPath, path.resolve(buildDir, "api.js"), developmentBuild)], { stdio: [
+					"inherit",
+					"inherit",
+					"inherit"
+				] });
 				manifest = {
 					...manifest,
 					server: {
@@ -59,12 +115,15 @@ function jchatAddon(options) {
 			});
 			for (const relativePath of databaseFiles) {
 				if (path.isAbsolute(relativePath) || relativePath.includes("\\") || relativePath.split("/").includes("..")) throw new Error(`Unsafe addon database file path: ${relativePath}`);
-				const source = path.resolve(rootDir, relativePath);
-				if (!fs.existsSync(source) || !fs.statSync(source).isFile()) throw new Error(`Missing addon database file: ${relativePath}`);
 				const destination = path.resolve(buildDir, relativePath);
 				fs.mkdirSync(path.dirname(destination), { recursive: true });
-				fs.copyFileSync(source, destination);
 			}
+			await Promise.all(databaseFiles.map(async (relativePath) => {
+				const source = path.resolve(rootDir, relativePath);
+				if (!await Bun.file(source).exists() || !fs.statSync(source).isFile()) throw new Error(`Missing addon database file: ${relativePath}`);
+				const destination = path.resolve(buildDir, relativePath);
+				return Bun.write(destination, Bun.file(source));
+			}));
 			if (manifest.server?.migrations?.length || manifest.server?.seeds?.length) {
 				const signingPrivateKey = requireAddonSigningKey(options.signingPrivateKey ?? process.env.JCHAT_ADDON_SIGNING_PRIVATE_KEY, developmentBuild);
 				if (signingPrivateKey) {
@@ -75,36 +134,57 @@ function jchatAddon(options) {
 						...manifest.server?.seeds ?? []
 					];
 					if (hasServer) archivePaths.push("api.js");
-					manifest = signAddonManifest(manifest, archivePaths.map((file) => ({
+					const resolvedFiles = await Promise.all(archivePaths.map(async (file) => ({
 						path: file,
-						contents: file === "manifest.json" ? Buffer.from("") : fs.readFileSync(path.resolve(buildDir, file))
-					})), signingPrivateKey);
+						contents: file === "manifest.json" ? Buffer.from("") : Buffer.from(await Bun.file(path.resolve(buildDir, file)).arrayBuffer())
+					})));
+					manifest = signAddonManifest(manifest, resolvedFiles, signingPrivateKey);
 				}
 			}
+			const readmeSource = path.resolve(rootDir, "README.md");
+			if (await Bun.file(readmeSource).exists()) await Bun.write(path.resolve(buildDir, "README.md"), Bun.file(readmeSource));
+			const vendorLicensesContent = await generateAddonVendorLicenses(rootDir, manifest.name);
+			await Bun.write(path.resolve(buildDir, "vendor-licenses.txt"), vendorLicensesContent);
 			const manifestJson = JSON.stringify(manifest, null, 2);
-			fs.writeFileSync(path.resolve(buildDir, "manifest.json"), manifestJson);
+			await Bun.write(path.resolve(buildDir, "manifest.json"), manifestJson);
 			if (shouldZip) {
 				const zipName = `${manifest.id}-${pkg.version}.zip`;
 				const filesToZip = ["manifest.json", bundleFile];
-				if (fs.existsSync(path.resolve(buildDir, "api.js"))) filesToZip.push("api.js");
+				if (await Bun.file(path.resolve(buildDir, "api.js")).exists()) filesToZip.push("api.js");
+				if (await Bun.file(path.resolve(buildDir, "README.md")).exists()) filesToZip.push("README.md");
+				if (await Bun.file(path.resolve(buildDir, "vendor-licenses.txt")).exists()) filesToZip.push("vendor-licenses.txt");
 				const migrationsDest = path.resolve(buildDir, "migrations");
 				if (fs.existsSync(migrationsDest)) filesToZip.push("migrations");
 				const seedsDest = path.resolve(buildDir, "seeds");
 				if (fs.existsSync(seedsDest)) filesToZip.push("seeds");
-				execFileSync("tar", [
+				Bun.spawnSync([
+					"tar",
 					"-a",
 					"-cf",
 					zipName,
 					...filesToZip
 				], {
 					cwd: buildDir,
-					stdio: "inherit"
+					stdio: [
+						"inherit",
+						"inherit",
+						"inherit"
+					]
 				});
 				console.log(`Build Complete: ${manifest.id} v${pkg.version} → ${zipName}`);
 			}
 		}
 	};
 }
+/**
+* Generates CLI argument parameters for bundling server-side Elysia API scripts (`src/api.ts`) via
+* Bun.
+*
+* @param entryPath - Absolute file path to the server entry script (`src/api.ts`).
+* @param outputPath - Absolute destination file path for the bundled output (`build/api.js`).
+* @param developmentBuild - Indicates whether to enable external sourcemaps or minification.
+* @returns Array of command line arguments for running `bun build`.
+*/
 function createAddonServerBuildArguments(entryPath, outputPath, developmentBuild) {
 	return [
 		"build",
@@ -112,9 +192,17 @@ function createAddonServerBuildArguments(entryPath, outputPath, developmentBuild
 		"--target=bun",
 		"--format=esm",
 		`--outfile=${outputPath}`,
-		developmentBuild ? "--sourcemap=external" : "--minify"
+		developmentBuild ? "--sourcemap=inline" : "--minify"
 	];
 }
+/**
+* Cryptographically signs an addon manifest using RSA-SHA256 over all archive file contents.
+*
+* @param manifest - Unsigned or base addon manifest.
+* @param files - List of archive file paths and raw contents to digest.
+* @param privateKey - RSA private key in PEM format.
+* @returns Updated {@link AddonManifest} containing an RSA signature block.
+*/
 function signAddonManifest(manifest, files, privateKey) {
 	if (!manifest.publisher?.id) throw new Error("Signed addons require manifest.publisher.id");
 	const unsigned = {
@@ -126,7 +214,7 @@ function signAddonManifest(manifest, files, privateKey) {
 		}
 	};
 	const hash = crypto.createHash("sha256");
-	for (const file of [...files].sort((a, b) => a.path.localeCompare(b.path))) {
+	for (const file of [...files].toSorted((a, b) => a.path.localeCompare(b.path))) {
 		hash.update(file.path);
 		hash.update("\0");
 		hash.update(file.path === "manifest.json" ? stableStringify(unsigned) : file.contents);
@@ -142,6 +230,14 @@ function signAddonManifest(manifest, files, privateKey) {
 		}
 	};
 }
+/**
+* Resolves the required RSA signing key for database-bearing addons.
+*
+* @param signingPrivateKey - Provided signing key or undefined.
+* @param developmentBuild - Whether the current build is targeting development mode.
+* @returns Resolved signing key string or undefined (in dev builds).
+* @throws {@link Error} If building a database-bearing addon in production without a signing key.
+*/
 function requireAddonSigningKey(signingPrivateKey, developmentBuild) {
 	if (signingPrivateKey) return signingPrivateKey;
 	if (developmentBuild) return void 0;
@@ -158,34 +254,128 @@ function embedCssIntoBundle(buildDir, addonId) {
 	const js = fs.readFileSync(jsPath, "utf-8");
 	if (css.length < 10) css = "";
 	else {
+		css = stripLayer(css, "properties");
+		css = stripLayer(css, "base");
 		css = css.replace(/:root\s*\{[^}]+\}/g, "");
+		css = css.replace(/:root:not\([^)]+\)\s*\{[^}]+\}/g, "");
 		css = css.replace(/\.dark\s*\{[^}]+\}/g, "");
 		css = css.replace(/\[data-theme=[^\]]+\]\s*\{[^}]+\}/g, "");
 		css = css.replace(/\.dark\s*\[data-theme=[^\]]+\]\s*\{[^}]+\}/g, "");
-		css = `@scope (#addon-${addonId}) {\n*, ::before, ::after { border-color: var(--border); }\n${css}\n}`;
+		css = css.replace(/\.font-(?:lato|playfair|dancing|poppins|jetbrains|quicksand|roboto-serif|audiowide|special-elite|press-start|grenze|righteous|creepster|vast-shadow|syncopate|lobster)\s*\{[^}]+\}/g, "");
+		css = css.replace(/--font-(?:lato|playfair|dancing|poppins|jetbrains|quicksand|roboto-serif|audiowide|special-elite|press-start|grenze|righteous|creepster|vast-shadow|syncopate|lobster):[^;]+;/g, "");
+		css = css.replace(/[^{}]*\[data-color[^{}]*\{[^}]+\}/g, "");
+		css = css.replace(/@property\s+--tw-[^{]+\{[^}]+\}/g, "");
+		css = css.replace(/\.loader-dots\s*\{[^}]+\}/g, "");
+		css = css.replace(/\.loader-dots\s+span[^{]*\{[^}]+\}/g, "");
+		css = css.replace(/@keyframes\s+wave-dots\s*\{[\s\S]*?\n\}/g, "");
+		css = css.replace(/@keyframes\s+gradient-border\s*\{[\s\S]*?\n\}/g, "");
+		css = css.replace(/\.animate-gradient(?:-border|-text)?\s*\{[^}]+\}/g, "");
+		css = css.replace(/\.me\s*\{[^}]+\}/g, "");
+		css = css.replace(/\.user-border\s*\{[^}]+\}/g, "");
+		css = css.replace(/\.scrollbar-hide[^{]*\{[^}]+\}/g, "");
+		css = css.replace(/@layer\s+components(?:\s*\{[^}]*\}|;)/g, "");
+		css = minifyCss(`@scope (#addon-${addonId}) { ${css} }`);
 	}
-	const injection = `
+	if (css.trim().length > 0) {
+		const injection = `
 (function() {
-  if (typeof document !== 'undefined' && ${JSON.stringify(css)}.length > 0) {
-    const style = document.createElement('style');
-    style.type = 'text/css';
-    style.textContent = ${JSON.stringify(css)};
-    document.head.appendChild(style);
+  if (typeof document !== 'undefined') {
+    var s = document.createElement('style');
+    s.type = 'text/css';
+    s.textContent = ${JSON.stringify(css)};
+    document.head.appendChild(s);
   }
 })();
 `;
-	fs.writeFileSync(jsPath, injection + js);
+		fs.writeFileSync(jsPath, injection + js);
+	}
 	try {
 		fs.unlinkSync(cssPath);
 	} catch {}
 }
+function stripLayer(css, layerName) {
+	const marker = `@layer ${layerName} {`;
+	let idx = css.indexOf(marker);
+	while (idx !== -1) {
+		let braceCount = 0;
+		let endIdx = idx + marker.length - 1;
+		for (let i = idx + marker.length - 1; i < css.length; i++) if (css[i] === "{") braceCount++;
+		else if (css[i] === "}") {
+			braceCount--;
+			if (braceCount === 0) {
+				endIdx = i;
+				break;
+			}
+		}
+		css = css.slice(0, idx) + css.slice(endIdx + 1);
+		idx = css.indexOf(marker);
+	}
+	return css;
+}
+function minifyCss(css) {
+	return css.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\s+/g, " ").replace(/\s*([{};:,>])\s*/g, "$1").replace(/;}/g, "}").trim();
+}
+function sortValue(child) {
+	if (Array.isArray(child)) return child.map(sortValue);
+	if (child && typeof child === "object") return Object.fromEntries(Object.entries(child).toSorted(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortValue(nested)]));
+	return child;
+}
 function stableStringify(value) {
-	const sortValue = (child) => {
-		if (Array.isArray(child)) return child.map(sortValue);
-		if (child && typeof child === "object") return Object.fromEntries(Object.entries(child).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortValue(nested)]));
-		return child;
-	};
 	return JSON.stringify(sortValue(value));
 }
+async function generateAddonVendorLicenses(addonDir, addonName) {
+	const title = addonName ? `${addonName} Addon` : "JChat Addon";
+	try {
+		const proc = Bun.spawn([
+			"bun",
+			"pm",
+			"licenses",
+			"--json",
+			"--prod"
+		], {
+			cwd: addonDir,
+			stdout: "pipe",
+			stderr: "pipe"
+		});
+		const output = await new Response(proc.stdout).text();
+		await proc.exited;
+		const data = JSON.parse(output);
+		const lines = [
+			"================================================================================",
+			`${title} - Third-Party Vendor Licenses & Open Source Attribution`,
+			"================================================================================",
+			"This distribution incorporates open-source libraries and software components.",
+			"Their licenses and attributions are listed below.",
+			"================================================================================",
+			""
+		];
+		let totalPackages = 0;
+		const sortedCategories = Object.keys(data).toSorted((a, b) => a.localeCompare(b));
+		for (const licenseCategory of sortedCategories) {
+			const packages = data[licenseCategory];
+			if (!packages || packages.length === 0) continue;
+			lines.push(`\n## License: ${licenseCategory} (${packages.length} packages)\n`);
+			for (const pkg of packages) {
+				totalPackages++;
+				lines.push(`- Package:     ${pkg.name}@${pkg.versions.join(", ")}`);
+				if (pkg.description) lines.push(`  Description: ${pkg.description}`);
+				if (pkg.author) lines.push(`  Author:      ${pkg.author}`);
+				if (pkg.homepage) lines.push(`  Homepage:    ${pkg.homepage}`);
+			}
+		}
+		lines.splice(5, 0, `Total Open-Source Dependencies: ${totalPackages}\n`);
+		return lines.join("\n") + "\n";
+	} catch {
+		return [
+			"================================================================================",
+			`${title} - Third-Party Vendor Licenses & Open Source Attribution`,
+			"================================================================================",
+			"This distribution incorporates open-source libraries and software components.",
+			"See individual package.json files and dependencies for specific license details.",
+			"================================================================================",
+			""
+		].join("\n");
+	}
+}
 //#endregion
 export { createAddonServerBuildArguments, jchatAddon, requireAddonSigningKey, signAddonManifest };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@jchat/addon-sdk",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.20",
   "private": false,
+  "description": "JChat Addon SDK for building JChat addons.",
   "keywords": [
     "addon",
     "chat",
@@ -11,55 +12,156 @@
     "sdk",
     "vite"
   ],
-  "license": "Apache-2.0",
+  "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mjjabarullah/jchat.git",
     "directory": "packages/addon-sdk"
   },
+  "bin": {
+    "jchat-addon": "./dist/cli.mjs"
+  },
   "files": [
     "dist",
-    "src",
+    "tsconfig.addon.json",
+    "skills",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "type": "module",
-  "main": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./contracts": {
+      "types": "./src/contracts.ts",
+      "import": "./src/contracts.ts",
+      "default": "./src/contracts.ts"
+    },
+    "./cli": {
+      "types": "./src/cli.ts",
+      "import": "./src/cli.ts",
+      "default": "./src/cli.ts"
     },
     "./diagnostics": {
-      "types": "./dist/diagnostics.d.mts",
-      "import": "./dist/diagnostics.mjs"
+      "types": "./src/diagnostics.ts",
+      "import": "./src/diagnostics.ts",
+      "default": "./src/diagnostics.ts"
     },
     "./vite": {
-      "types": "./dist/vite.d.mts",
-      "import": "./dist/vite.mjs"
-    }
+      "types": "./src/vite.ts",
+      "import": "./src/vite.ts",
+      "default": "./src/vite.ts"
+    },
+    "./i18n-validator": {
+      "types": "./src/i18n-validator.ts",
+      "import": "./src/i18n-validator.ts",
+      "default": "./src/i18n-validator.ts"
+    },
+    "./ui": {
+      "types": "./src/ui.ts",
+      "import": "./src/ui.ts",
+      "default": "./src/ui.ts"
+    },
+    "./icon": {
+      "types": "./src/icon.ts",
+      "import": "./src/icon.ts",
+      "default": "./src/icon.ts"
+    },
+    "./state": {
+      "types": "./src/state.ts",
+      "import": "./src/state.ts",
+      "default": "./src/state.ts"
+    },
+    "./ui/tailwind.css": {
+      "style": "./src/tailwind.css",
+      "import": "./src/tailwind.css",
+      "default": "./src/tailwind.css"
+    },
+    "./tsconfig.json": "./tsconfig.addon.json"
   },
   "publishConfig": {
+    "main": "./dist/index.mjs",
+    "types": "./dist/index.d.mts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.mts",
+        "import": "./dist/index.mjs"
+      },
+      "./contracts": {
+        "types": "./dist/contracts.d.mts",
+        "import": "./dist/contracts.mjs"
+      },
+      "./cli": {
+        "types": "./dist/cli.d.mts",
+        "import": "./dist/cli.mjs"
+      },
+      "./diagnostics": {
+        "types": "./dist/diagnostics.d.mts",
+        "import": "./dist/diagnostics.mjs"
+      },
+      "./vite": {
+        "types": "./dist/vite.d.mts",
+        "import": "./dist/vite.mjs"
+      },
+      "./i18n-validator": {
+        "types": "./dist/i18n-validator.d.mts",
+        "import": "./dist/i18n-validator.mjs"
+      },
+      "./ui": {
+        "types": "./dist/ui.d.mts",
+        "import": "./dist/ui.mjs"
+      },
+      "./icon": {
+        "types": "./dist/icon.d.mts",
+        "import": "./dist/icon.mjs"
+      },
+      "./state": {
+        "types": "./dist/state.d.mts",
+        "import": "./dist/state.mjs"
+      },
+      "./ui/tailwind.css": {
+        "style": "./src/tailwind.css",
+        "import": "./src/tailwind.css",
+        "default": "./src/tailwind.css"
+      },
+      "./tsconfig.json": "./tsconfig.addon.json"
+    },
     "access": "public"
   },
   "scripts": {
     "build": "tsdown",
-    "lint": "oxlint . --config=../../oxlint.json",
+    "lint": "oxlint .",
     "format": "oxfmt . --write",
-    "typecheck": "tsc --noEmit",
-    "prepack": "bun run build"
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "lucide-react": "catalog:"
   },
   "devDependencies": {
     "@jchat/icon": "workspace:*",
+    "@jchat/ui": "workspace:*",
+    "@tailwindcss/vite": "catalog:",
+    "@tanstack/react-query": "catalog:",
+    "@types/bun": "catalog:",
     "@types/react": "catalog:",
     "elysia": "catalog:",
+    "jotai": "catalog:",
     "kysely": "^catalog:",
-    "tsdown": "^0.22.14",
+    "tsdown": "catalog:",
     "vite": "catalog:"
   },
   "peerDependencies": {
+    "@tailwindcss/vite": "catalog:",
+    "@tanstack/react-query": "catalog:",
     "elysia": "catalog:",
+    "jotai": "catalog:",
     "kysely": "^catalog:",
     "react": "catalog:",
     "vite": "catalog:"