@plasius/chatbot 1.1.4 → 1.1.6

package/CHANGELOG.md

@@ -17,6 +17,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
   - Replaced `audit:deps` from `depcheck` to `npm ls --all --omit=optional --omit=peer > /dev/null 2>&1 || true` to avoid deprecated dependency-chain risk.
 
 - **Fixed**
+  - Enforced CommonJS runtime compatibility for dual-build output by generating and validating `dist-cjs/package.json` (`type: commonjs`) during build and package verification.
   - (placeholder)
 
 - **Security**

package/README.md

@@ -17,6 +17,12 @@ Public package for chatbot UI/state integrations used in Plasius applications.
 npm install @plasius/chatbot
 ```
 
+## Module formats
+
+This package publishes dual ESM and CJS artifacts.
+When CJS output is emitted under `dist-cjs/*.js` with `type: module`, `dist-cjs/package.json` is generated with `{ "type": "commonjs" }` to ensure Node `require(...)` compatibility.
+
+
 ## Usage
 
 ```ts

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/docs/adrs/adr-0003-dual-esm-cjs-runtime-compatibility.md

@@ -0,0 +1,22 @@
+# ADR-0003: Dual ESM and CJS Runtime Compatibility
+
+- Date: 2026-03-01
+- Status: Accepted
+
+## Context
+
+`@plasius/chatbot` publishes dual ESM and CJS entry points. This package currently emits CJS output under `dist-cjs/*.js` while the repository root uses `type: module`. Without an explicit CommonJS boundary for `dist-cjs`, Node can interpret those files as ESM and fail at runtime for `require(...)` consumers.
+
+## Decision
+
+Keep dual output and enforce a runtime-compatible CJS boundary by:
+
+- generating `dist-cjs/package.json` with `{ "type": "commonjs" }` as part of `build:cjs`;
+- validating this metadata in `pack:check`;
+- ensuring the packed artifact includes `dist-cjs/package.json`.
+
+## Consequences
+
+- Node CommonJS consumers can reliably load `@plasius/chatbot` via `require(...)`.
+- ESM consumers remain unchanged.
+- CD publish checks fail fast if CJS runtime compatibility metadata is missing.

package/docs/adrs/index.md

@@ -2,3 +2,4 @@
 
 - [ADR-0001: Standalone @plasius/chatbot Package Scope](./adr-0001-chatbot-package-scope.md)
 - [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)
+- [ADR-0003: Dual ESM and CJS Runtime Compatibility](./adr-0003-dual-esm-cjs-runtime-compatibility.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/chatbot",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "OpenAI Chatbot",
   "main": "./dist-cjs/index.js",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,7 @@
     "audit:npm": "npm audit --audit-level=high --omit=dev",
     "audit:test": "vitest run --coverage",
     "audit:all": "npm-run-all -l audit:ts audit:eslint audit:deps audit:npm audit:test",
-    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo --listEmittedFiles && rsync -av --include '*/' --include '*.module.css' --exclude '*' src/ dist-cjs/ || true",
+    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo --listEmittedFiles && rsync -av --include '*/' --include '*.module.css' --exclude '*' src/ dist-cjs/ || true && node scripts/write-cjs-package-json.cjs",
     "lint": "eslint . --max-warnings=0",
     "prepare": "npm run build",
     "demo:run": "npm run build && node demo/example.mjs",
@@ -32,8 +32,8 @@
   "license": "MIT",
   "dependencies": {
     "@plasius/entity-manager": "^1.0.6",
-    "@plasius/error": "^1.0.5",
-    "@plasius/profile": "^1.0.7",
+    "@plasius/error": "^1.0.6",
+    "@plasius/profile": "^1.0.9",
     "@plasius/schema": "^1.2.2",
     "emoji-picker-react": "^4.12.2",
     "react": "19.2.4",