@jchat/create-addon 1.0.0-alpha.10

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# @jchat/create-addon
+
+## 1.0.0-alpha.10
+
+## 1.0.0-alpha.9
+
+## 1.0.0-alpha.8
+
+## 1.0.0-alpha.7
+
+### Minor Changes
+
+- 7cef24c: - Enhance addon package diagnostics with semantic version compatibility validation for JChat host and Addon SDK
+  - Add support for local workspace development, sandbox test harnesses, and distribution packaging
+  - Improve runtime license verification and multi-environment path resolution
+  - Update addon generator templates with 20-language i18n support, standard scripts, and type definitions
+
+## 1.0.0-alpha.6
+
+## 1.0.0-alpha.5
+
+### Patch Changes
+
+- 9755c28: Export curated UI components, types, and Tailwind styles from `@jchat/addon-sdk/ui` (`@jchat/addon-sdk/ui/tailwind.css`) for sandbox and third-party addon developers.
+- 8b8297f: Rename package from `create-jchat-addon` to `@jchat/create-addon` and update binary script to `create-addon`.
+- 5bbb2b6: Inherit jchatVersion and addonSdkVersion directly from @jchat/create-addon package version when generating standalone devkit.
+
+## 1.0.0-alpha.4
+
+### Patch Changes
+
+- 8b8297f: Rename package from `create-jchat-addon` to `@jchat/create-addon` and update binary script to `create-addon`.
+- 5bbb2b6: Inherit jchatVersion and addonSdkVersion directly from @jchat/create-addon package version when generating standalone devkit.
+
+## 1.0.0-alpha.3
+
+## 1.0.0-alpha.2
+
+## 1.0.0-alpha.1
+
+### Patch Changes
+
+- 70537c0: Cleanup folder structure.
+
+## 1.0.0-alpha.0
+
+- Initial public alpha release.

package/LICENSE

@@ -0,0 +1,23 @@
+CUSTOM COMMERCIAL END USER LICENSE AGREEMENT (EULA)
+
+Copyright (c) 2026 JChat Project. All rights reserved.
+
+1. DEFINITIONS
+"Software" refers to this npm package and its source code.
+"Authorized Application" refers strictly to the application known as "JChat".
+
+2. LICENSE GRANT
+Subject to the terms of this Agreement and payment of any applicable fees, the 
+Licensor grants you a non-exclusive, non-transferable, revocable license to 
+download, install, and use the Software.
+
+3. RESTRICTIONS ON USE
+You are expressly prohibited from using this Software, in whole or in part, 
+in any application, product, or service other than the Authorized Application (JChat). 
+Any deployment, linking, execution, or inclusion of this Software into an 
+application that is not JChat constitutes a breach of this contract and 
+an infringement of copyright law.
+
+4. NO REDISTRIBUTION
+You may not sub-license, rent, lease, or publicly redistribute this Software 
+to any third party without explicit written consent from the Licensor.

package/README.md

@@ -0,0 +1,39 @@
+# @jchat/create-addon
+
+A CLI tool for generating a self-contained JChat addon development workspace.
+
+## Usage
+
+Generate a new addon workspace:
+
+```bash
+bunx @jchat/create-addon <addon-id>
+```
+
+### Options
+
+- `<addon-id>`: (Required) The unique ID for your addon, typically hyphenated (e.g., `weather-addon`).
+- `--target=<directory>`: (Optional) The directory to generate the workspace in. Defaults to `../<addon-id>` relative to the current working directory.
+- `--image=<image>`: (Optional) A specific Docker / Podman container image to use for the sandbox environment. Defaults to `ghcr.io/mjjabarullah/jchat-sandbox`.
+
+### Example
+
+```bash
+bunx @jchat/create-addon my-addon
+cd my-addon
+```
+
+## Requirements
+
+- Bun 1.3+
+- Docker or Podman
+
+## Licensing
+
+The creator package and JChat-authored template material are licensed under Apache License 2.0.
+You retain ownership of the original code and content you add to a generated project and may choose
+the license for that original work. Any JChat-authored template portions and third-party components
+remain subject to their respective licenses and notices.
+
+The generated developer sandbox does not grant a production JChat license. Production use remains
+subject to the applicable JChat and addon marketplace terms.

package/dist/cli.d.mts

@@ -0,0 +1,11 @@
+//#region src/cli.d.ts
+interface CreatorArguments {
+  addonId: string;
+  targetDir: string;
+  sandboxImage?: string;
+  workspace?: boolean;
+}
+declare function parseCreatorArguments(arguments_: readonly string[]): CreatorArguments;
+declare function runCreator(arguments_: readonly string[]): Promise<string>;
+//#endregion
+export { CreatorArguments, parseCreatorArguments, runCreator };

package/dist/cli.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import{i as e,r as t}from"./generator.mjs";import*as n from"node:path";function r(e){let t=e.find(e=>!e.startsWith(`--`));if(t===void 0||t.startsWith(`-`))throw Error(`Usage: bunx @jchat/create-addon <addon-id> [--target=<directory>] [--image=<image>] [--workspace]`);let r=e.find(e=>e.startsWith(`--target=`)),i=e.find(e=>e.startsWith(`--image=`)),a=e.includes(`--workspace`),o=a?n.join(`addons`,t):t;return{addonId:t,targetDir:r?.slice(9)||o,sandboxImage:i?.slice(8)||void 0,workspace:a}}async function i(i){let a=await Bun.file(new URL(`../package.json`,import.meta.url)).json(),o=r(i);return o.workspace?(await t({addonId:o.addonId,targetDir:o.targetDir,isMonorepoWorkspace:!0,jchatVersion:a.version,addonSdkVersion:a.version}),n.resolve(o.targetDir)):(await e({...o,jchatVersion:a.version,addonSdkVersion:a.version,sandboxImage:o.sandboxImage??`${a.jchat?.sandboxImage??`ghcr.io/mjjabarullah/jchat-sandbox`}:${a.version.replaceAll(`+`,`-`)}`}),n.resolve(o.targetDir))}if(import.meta.main)try{let e=await i(process.argv.slice(2));console.log(`Created addon at ${e}`)}catch(e){console.error(e),process.exit(1)}export{r as parseCreatorArguments,i as runCreator};

package/dist/generator.mjs

@@ -0,0 +1,246 @@
+import*as e from"node:fs";import*as t from"node:path";function n(e){try{Bun.semver.order(e,e)}catch{throw Error(`Invalid semantic version: ${e}`)}let t=/^(?:v|=)?(\d+)\./.exec(e)?.[1],n=t?Number(t):NaN;if(!Number.isSafeInteger(n))throw Error(`Invalid semantic version: ${e}`);return`>=${e} <${n+1}.0.0`}const r=/^[a-z0-9]+(?:-[a-z0-9]+)*$/;function i(e){if(!r.test(e.addonId))throw Error(`Addon id must contain lowercase letters, numbers, and hyphens`);let t={id:e.addonId,name:P(e.addonId),version:`1.0.0`,description:`${P(e.addonId)} addon for JChat`,author:`Developer`,compatibility:{jchat:n(e.jchatVersion??`1.0.0`),addonSdk:n(e.addonSdkVersion??`1.0.0`)},locales:[`ar`,`de`,`en`,`es`,`fr`,`hi`,`kn`,`ml`,`ta`,`te`,`ur`],defaultLocale:`en`,frontend:{bundle:`./ui.js`,mountPoints:[`chat-toolbar`]},permissions:[]},i=e.isMonorepoWorkspace?d(e.addonId):m(e.addonId,e.addonSdkVersion??`1.0.0`),a=e.isMonorepoWorkspace?f():h();return Object.freeze({"package.json":`${JSON.stringify(i,null,2)}\n`,"tsconfig.json":`${JSON.stringify(a,null,2)}\n`,"src/manifest.ts":g(t),"src/tailwind.css":j(),"src/locales/ar.json":_(t.name),"src/locales/de.json":v(t.name),"src/locales/en.json":y(t.name),"src/locales/es.json":b(t.name),"src/locales/fr.json":x(t.name),"src/locales/hi.json":S(t.name),"src/locales/kn.json":C(t.name),"src/locales/ml.json":w(t.name),"src/locales/ta.json":T(t.name),"src/locales/te.json":E(t.name),"src/locales/ur.json":D(t.name),"src/locales/index.ts":O(),"src/locales.test.ts":k(),"src/ui.tsx":A(t.name)})}async function a(n){let r=t.resolve(n.targetDir);if(e.existsSync(r))throw Error(`Addon target already exists: ${r}`);let a=Object.entries(i(n));for(let[n]of a){let i=t.join(r,...n.split(`/`));e.mkdirSync(t.dirname(i),{recursive:!0})}await Promise.all(a.map(([e,n])=>{let i=t.join(r,...e.split(`/`));return Bun.write(i,n)}))}function o(e){if(!r.test(e.addonId))throw Error(`Addon id must contain lowercase letters, numbers, and hyphens`);let t=e.sandboxImage??`ghcr.io/mjjabarullah/jchat-sandbox:${e.jchatVersion.replace(/\+/g,`-`)}`,n=i({addonId:e.addonId,isMonorepoWorkspace:!1,jchatVersion:e.jchatVersion,addonSdkVersion:e.addonSdkVersion}),a={".env.example":c(e.addonId,t),".gitignore":[`node_modules/`,`addon/node_modules/`,`addon/build/`,`.env`,``].join(`
+`),"README.md":N(e.addonId),"docker-compose.yml":l(),"package.json":`${JSON.stringify(u(e.addonId),null,2)}\n`,"scripts/devkit.ts":M()};for(let[e,t]of Object.entries(n))a[`addon/${e}`]=t;return Object.freeze(a)}async function s(n){let r=t.resolve(n.targetDir);if(e.existsSync(r))throw Error(`Development kit target already exists: ${r}`);let i=Object.entries(o(n));for(let[n]of i){let i=t.join(r,...n.split(`/`));e.mkdirSync(t.dirname(i),{recursive:!0})}await Promise.all(i.map(([e,n])=>{let i=t.join(r,...e.split(`/`));return Bun.write(i,n)}))}function c(e,t){return[`JCHAT_SANDBOX_IMAGE=${t}`,`JCHAT_SANDBOX_ADDON_ID=${e}`,`JCHAT_SANDBOX_PORT=4317`,`JCHAT_SANDBOX_HTTP_MOCK_PORT=4318`,`JCHAT_SANDBOX_HTTP_MOCK_OFFLINE=false`,`JCHAT_SANDBOX_ADDON_HTTP_MOCK_URL=http://http-mock:4318`,``].join(`
+`)}function l(){return`services:
+  sandbox:
+    image: \${JCHAT_SANDBOX_IMAGE:?Copy .env.example to .env}
+    restart: unless-stopped
+    environment:
+      NODE_ENV: development
+      JCHAT_PORT: "4317"
+      JCHAT_COOKIE_SECRET: addon-sandbox-cookie-secret
+      JCHAT_DATABASE_URL: postgresql://jchat:jchat@db:5432/jchat
+      JCHAT_REDIS_DATABASE_URL: redis://redis:6379
+      JCHAT_STORAGE_TYPE: LOCAL
+      JCHAT_BOT_NAME: Sandbox Bot
+      JCHAT_BOT_EMAIL: bot@sandbox.local
+      JCHAT_DOMAIN: localhost
+      JCHAT_SITE_URL: http://localhost:\${JCHAT_SANDBOX_PORT:-4317}
+      JCHAT_ROUTING_MODE: path
+      JCHAT_ADDON_ENCRYPTION_KEY: addon-sandbox-encryption-key
+      JCHAT_ADDON_HTTP_MOCK_URL: \${JCHAT_SANDBOX_ADDON_HTTP_MOCK_URL-http://http-mock:4318}
+    ports:
+      - "127.0.0.1:\${JCHAT_SANDBOX_PORT:-4317}:4317"
+    volumes:
+      - ./addon:/app/addons/\${JCHAT_SANDBOX_ADDON_ID:?Set addon id}:ro
+      - sandbox_uploads:/app/uploads
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+      http-mock:
+        condition: service_healthy
+
+  http-mock:
+    image: \${JCHAT_SANDBOX_IMAGE:?Copy .env.example to .env}
+    entrypoint: ["/app/addon-http-mock"]
+    environment:
+      JCHAT_SANDBOX_HTTP_MOCK_PORT: "4318"
+      JCHAT_SANDBOX_HTTP_MOCK_OFFLINE: \${JCHAT_SANDBOX_HTTP_MOCK_OFFLINE:-false}
+    ports:
+      - "127.0.0.1:\${JCHAT_SANDBOX_HTTP_MOCK_PORT:-4318}:4318"
+    healthcheck:
+      test: ["CMD", "/app/addon-http-mock", "--healthcheck"]
+      interval: 2s
+      timeout: 3s
+      retries: 30
+
+  db:
+    image: postgres:18-alpine
+    environment:
+      POSTGRES_USER: jchat
+      POSTGRES_PASSWORD: jchat
+      POSTGRES_DB: jchat
+    volumes:
+      - sandbox_postgres:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U jchat"]
+      interval: 2s
+      timeout: 3s
+      retries: 30
+
+  redis:
+    image: redis:8.0.6-alpine3.21
+    volumes:
+      - sandbox_redis:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 2s
+      timeout: 3s
+      retries: 30
+
+volumes:
+  sandbox_postgres:
+  sandbox_redis:
+  sandbox_uploads:
+`}function u(e){return{name:`${e}-development-kit`,private:!0,type:`module`,workspaces:[`addon`],scripts:{sandbox:`bun run ./scripts/devkit.ts run`,"sandbox:test":`bun run ./scripts/devkit.ts test`,"sandbox:reset":`bun run ./scripts/devkit.ts reset`,"sandbox:package":`bun run ./scripts/devkit.ts package`,"sandbox:cleanup":`bun run ./scripts/devkit.ts cleanup`},devDependencies:{"@types/bun":`^1.4.0`},engines:{bun:`>=1.4.0`}}}function d(e){return{name:`@jchat/${e}`,version:`1.0.0-alpha.0`,private:!0,description:`${P(e)} addon for JChat`,repository:{type:`git`,url:`git+https://github.com/mjjabarullah/jchat.git`,directory:`addons/${e}`},type:`module`,scripts:{dev:`jchat-addon dev`,build:`tsc --noEmit && jchat-addon build`,test:`bun test`,lint:`oxlint .`,format:`oxfmt . --write`,typecheck:`tsc --noEmit`},dependencies:{"lucide-react":`catalog:`,"usehooks-ts":`catalog:`},devDependencies:{"@tailwindcss/vite":`catalog:`,"@types/bun":`catalog:`,"@types/react":`catalog:`,"@types/react-dom":`catalog:`,elysia:`catalog:`,vite:`catalog:`},peerDependencies:{"@jchat/addon-sdk":`workspace:*`,"@tanstack/react-query":`catalog:`,react:`catalog:`,"react-dom":`catalog:`}}}function f(){return{extends:`@jchat/addon-sdk/tsconfig.json`,include:[`src/**/*`]}}function p(){try{let n=import.meta.dirname;for(let r=0;r<6;r++){let r=t.join(n,`package.json`);if(e.existsSync(r)){let t=e.readFileSync(r,`utf8`),n=JSON.parse(t);if(n.catalog&&typeof n.catalog==`object`)return n.catalog}let i=t.dirname(n);if(i===n)break;n=i}}catch{}return{}}function m(e,t){let n=p();return{name:`@jchat/${e}`,version:`1.0.0`,private:!0,type:`module`,scripts:{dev:`jchat-addon dev`,build:`tsc --noEmit && jchat-addon build`,test:`bun test`,typecheck:`tsc --noEmit`},dependencies:{"@jchat/addon-sdk":`^${t}`,"@tanstack/react-query":n[`@tanstack/react-query`]??`^5.101.4`,"lucide-react":n[`lucide-react`]??`1.31.0`,react:n.react??`^19.2.8`,"react-dom":n[`react-dom`]??`^19.2.8`,"usehooks-ts":n[`usehooks-ts`]??`^3.1.1`},devDependencies:{"@tailwindcss/vite":n[`@tailwindcss/vite`]??`^4.3.3`,"@types/bun":n[`@types/bun`]??`^1.4.0`,"@types/react":n[`@types/react`]??`^19.2.18`,"@types/react-dom":n[`@types/react-dom`]??`^19.2.4`,elysia:n.elysia??`^1.4.29`,tailwindcss:n.tailwindcss??`^4.3.3`,typescript:n.typescript??`^7.0.2`,vite:n.vite??`^8.2.1`}}}function h(){return{extends:`@jchat/addon-sdk/tsconfig.json`,include:[`src/**/*.ts`,`src/**/*.tsx`]}}function g(e){return`import type { AddonManifest } from "@jchat/addon-sdk"
+
+const manifest: AddonManifest = ${JSON.stringify(e,null,2)}
+
+export default manifest
+`}function _(e){return`${JSON.stringify({welcome:`مرحبًا بك في ${e}`,mounted_at:`تم التثبيت في {{mountPoint}}`,test_button:`اختبار الإضافة`,toast_message:`مرحبًا من ${e}`},null,2)}\n`}function v(e){return`${JSON.stringify({welcome:`Willkommen bei ${e}`,mounted_at:`Eingebunden an {{mountPoint}}`,test_button:`Addon testen`,toast_message:`Hallo von ${e}`},null,2)}\n`}function y(e){return`${JSON.stringify({welcome:`Welcome to ${e}`,mounted_at:`Mounted at {{mountPoint}}`,test_button:`Test addon`,toast_message:`Hello from ${e}`},null,2)}\n`}function b(e){return`${JSON.stringify({welcome:`Bienvenido a ${e}`,mounted_at:`Montado en {{mountPoint}}`,test_button:`Probar complemento`,toast_message:`Hola desde ${e}`},null,2)}\n`}function x(e){return`${JSON.stringify({welcome:`Bienvenue sur ${e}`,mounted_at:`Monté sur {{mountPoint}}`,test_button:`Tester le plugin`,toast_message:`Bonjour de ${e}`},null,2)}\n`}function S(e){return`${JSON.stringify({welcome:`${e} में आपका स्वागत है`,mounted_at:`{{mountPoint}} पर माउंट किया गया`,test_button:`ऐडऑन का परीक्षण करें`,toast_message:`${e} की ओर से नमस्कार`},null,2)}\n`}function C(e){return`${JSON.stringify({welcome:`${e} ಗೆ ಸುಸ್ವಾಗತ`,mounted_at:`{{mountPoint}} ನಲ್ಲಿ ಸ್ಥಾಪಿಸಲಾಗಿದೆ`,test_button:`ಆಡ್ಆನ್ ಪರೀಕ್ಷಿಸಿ`,toast_message:`${e} ನಿಂದ ನಮಸ್ಕಾರ`},null,2)}\n`}function w(e){return`${JSON.stringify({welcome:`${e}-ലേക്ക് സ്വാഗതം`,mounted_at:`{{mountPoint}}-ൽ ഘടിപ്പിച്ചിരിക്കുന്നു`,test_button:`ആഡ്ഓൺ പരിശോധിക്കുക`,toast_message:`${e}-ൽ നിന്നുള്ള ആശംസകൾ`},null,2)}\n`}function T(e){return`${JSON.stringify({welcome:`${e}-க்கு வரவேற்கிறோம்`,mounted_at:`{{mountPoint}}-ல் பொருத்தப்பட்டுள்ளது`,test_button:`செருகுநிரலை சோதிக்கவும்`,toast_message:`${e}-லிருந்து வணக்கம்`},null,2)}\n`}function E(e){return`${JSON.stringify({welcome:`${e}కి స్వాగతం`,mounted_at:`{{mountPoint}} వద్ద మౌంట్ చేయబడింది`,test_button:`యాడ్ఆన్‌ని పరీక్షించండి`,toast_message:`${e} నుండి నమస్కారం`},null,2)}\n`}function D(e){return`${JSON.stringify({welcome:`${e} میں خوش آمدید`,mounted_at:`{{mountPoint}} پر نصب ہے`,test_button:`ایڈ آن کا تجربہ کریں`,toast_message:`${e} کی طرف سے ہیلو`},null,2)}\n`}function O(){return`import ar from "./ar.json"
+import de from "./de.json"
+import en from "./en.json"
+import es from "./es.json"
+import fr from "./fr.json"
+import hi from "./hi.json"
+import kn from "./kn.json"
+import ml from "./ml.json"
+import ta from "./ta.json"
+import te from "./te.json"
+import ur from "./ur.json"
+
+export type TranslationKey = keyof typeof en
+
+export const locales = {
+  ar,
+  de,
+  en,
+  es,
+  fr,
+  hi,
+  kn,
+  ml,
+  ta,
+  te,
+  ur
+} as const
+
+export default locales
+`}function k(){return`import { describe, expect, test } from "bun:test"
+import { validateAddonLocales } from "@jchat/addon-sdk"
+import * as path from "node:path"
+
+describe("addon locales", () => {
+  test("maintains key parity across all 11 host languages", () => {
+    const localesDir = path.join(import.meta.dir, "locales")
+    const result = validateAddonLocales(localesDir)
+    if (!result.valid) {
+      console.error(result.errors.join("\\n"))
+    }
+    expect(result.valid).toBe(true)
+  })
+})
+`}function A(e){return`import type { AddonProps } from "@jchat/addon-sdk"
+import { useAddonSDK, useIcons, useTranslation } from "@jchat/addon-sdk"
+import locales from "./locales"
+import "./tailwind.css"
+
+export default function Addon({ mountPoint }: AddonProps) {
+  const sdk = useAddonSDK()
+  const { Icons } = useIcons()
+  const { t, dir } = useTranslation(locales)
+
+  return (
+    <div dir={dir} className="rounded border border-border bg-card p-2 text-card-foreground">
+      <div className="mb-2 flex items-center gap-2">
+        <Icons.Plus aria-hidden="true" className="size-4 text-primary" />
+        <strong>${e}</strong>
+      </div>
+      <p className="mb-2 text-sm text-muted-foreground">{t("mounted_at", { mountPoint })}</p>
+      <button
+        type="button"
+        className="rounded bg-primary px-3 py-2 text-primary-foreground"
+        onClick={() => sdk.toast(t("toast_message", { name: "${e}" }))}
+      >
+        {t("test_button")}
+      </button>
+    </div>
+  )
+}
+`}function j(){return`@import "@jchat/addon-sdk/ui/tailwind.css";`}function M(){return`import * as fs from "node:fs"
+import * as path from "node:path"
+
+type Command = "run" | "test" | "reset" | "package" | "cleanup"
+
+const command = (process.argv[2] ?? "run") as Command
+if (!["run", "test", "reset", "package", "cleanup"].includes(command)) {
+  throw new Error(\`Unknown development-kit command: \${command}\`)
+}
+
+const root = path.resolve(import.meta.dir, "..")
+const environment = {
+  ...process.env,
+  ...readEnvironment(path.join(root, ".env"))
+}
+const addonId = environment.JCHAT_SANDBOX_ADDON_ID
+if (!addonId) throw new Error("JCHAT_SANDBOX_ADDON_ID is missing from .env")
+const compose = [
+  "docker",
+  "compose",
+  "--project-name",
+  \`jchat-addon-devkit-\${addonId}\`,
+  "--file",
+  path.join(root, "docker-compose.yml")
+]
+
+if (command === "test") {
+  await run(["bun", "test"], path.join(root, "addon"), environment)
+} else if (command === "package") {
+  await run(["bun", "run", "build"], path.join(root, "addon"), environment)
+} else if (command === "cleanup") {
+  await run([...compose, "down", "--remove-orphans", "--volumes"], root, environment)
+} else {
+  if (command === "reset") {
+    await run([...compose, "down", "--remove-orphans", "--volumes"], root, environment)
+  }
+  await run(["bun", "run", "build"], path.join(root, "addon"), environment)
+  const watcher = Bun.spawn(["bun", "run", "dev"], {
+    cwd: path.join(root, "addon"),
+    env: environment,
+    stdout: "inherit",
+    stderr: "inherit"
+  })
+  try {
+    await run([...compose, "up"], root, environment)
+  } finally {
+    watcher.kill()
+    await watcher.exited
+  }
+}
+
+async function run(command: string[], cwd: string, env: Record<string, string | undefined>) {
+  const child = Bun.spawn(command, { cwd, env, stdin: "inherit", stdout: "inherit", stderr: "inherit" })
+  const exitCode = await child.exited
+  if (exitCode !== 0) throw new Error(\`\${command.join(" ")} exited with code \${exitCode}\`)
+}
+
+function readEnvironment(file: string): Record<string, string> {
+  if (!fs.existsSync(file)) throw new Error("Copy .env.example to .env before running the kit")
+  return Object.fromEntries(
+    fs.readFileSync(file, "utf8")
+      .split(/\\r?\\n/)
+      .filter((line) => line && !line.startsWith("#"))
+      .map((line) => {
+        const separator = line.indexOf("=")
+        return [line.slice(0, separator), line.slice(separator + 1)]
+      })
+  )
+}
+`}function N(e){return`# ${P(e)} Development Kit
+
+This workspace develops \`${e}\` against the license-free JChat developer sandbox without
+including JChat Core source.
+
+## Start
+
+\`\`\`powershell
+Copy-Item .env.example .env
+bun install
+bun sandbox
+\`\`\`
+
+Open \`http://127.0.0.1:4317\`. The HTTP fixture recorder is available at
+\`http://127.0.0.1:4318/requests\`.
+
+## Commands
+
+- \`bun sandbox\`
+- \`bun sandbox:test\`
+- \`bun sandbox:reset\`
+- \`bun sandbox:package\`
+- \`bun sandbox:cleanup\`
+
+The referenced JChat packages and sandbox image must be published before this standalone kit can
+install or start outside the JChat repository.
+`}function P(e){return e.split(`-`).map(e=>`${e[0]?.toUpperCase()??``}${e.slice(1)}`).join(` `)}export{s as i,o as n,a as r,i as t};

package/dist/index.d.mts

@@ -0,0 +1,26 @@
+//#region src/generator.d.ts
+interface StandaloneDevkitOptions {
+  addonId: string;
+  targetDir: string;
+  jchatVersion: string;
+  addonSdkVersion: string;
+  sandboxImage?: string;
+}
+interface AddonWorkspaceOptions {
+  addonId: string;
+  targetDir: string;
+  isMonorepoWorkspace?: boolean;
+  jchatVersion?: string;
+  addonSdkVersion?: string;
+}
+declare function createAddonFiles(options: {
+  addonId: string;
+  isMonorepoWorkspace?: boolean;
+  jchatVersion?: string;
+  addonSdkVersion?: string;
+}): Readonly<Record<string, string>>;
+declare function writeAddonWorkspace(options: AddonWorkspaceOptions): Promise<void>;
+declare function createStandaloneDevkitFiles(options: StandaloneDevkitOptions): Readonly<Record<string, string>>;
+declare function writeStandaloneDevkit(options: StandaloneDevkitOptions): Promise<void>;
+//#endregion
+export { type AddonWorkspaceOptions, type StandaloneDevkitOptions, createAddonFiles, createStandaloneDevkitFiles, writeAddonWorkspace, writeStandaloneDevkit };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{i as e,n as t,r as n,t as r}from"./generator.mjs";export{r as createAddonFiles,t as createStandaloneDevkitFiles,n as writeAddonWorkspace,e as writeStandaloneDevkit};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@jchat/create-addon",
+  "version": "1.0.0-alpha.10",
+  "private": false,
+  "description": "Command line tool for jchat addon creation.",
+  "keywords": [
+    "addon",
+    "chat",
+    "cli",
+    "create",
+    "jchat",
+    "plugin",
+    "scaffold"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mjjabarullah/jchat.git",
+    "directory": "packages/create-addon"
+  },
+  "bin": {
+    "create-addon": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "bun test",
+    "lint": "oxlint .",
+    "format": "oxfmt . --write",
+    "typecheck": "tsc --noEmit",
+    "prepack": "bun run build"
+  },
+  "devDependencies": {
+    "@jchat/addon-sdk": "workspace:*",
+    "@types/bun": "catalog:",
+    "tsdown": "^0.22.14"
+  },
+  "engines": {
+    "bun": ">=1.4.0"
+  },
+  "jchat": {
+    "sandboxImage": "ghcr.io/mjjabarullah/jchat-sandbox"
+  }
+}