@tinyweb_dev/oe-meeting-react 0.1.0

package/docs/RELEASE.md

@@ -0,0 +1,116 @@
+# Release npm — `@tinyweb_dev/oe-meeting-react`
+
+Workflow [`release_npm.yml`](../../../../.github/workflows/release_npm.yml) build,
+typecheck, test, kiểm tra tarball và publish React SDK lên npm.
+
+## Chuẩn bị một lần
+
+### 1. Kiểm tra npm organization
+
+Tài khoản phát hành phải có quyền publish package public trong scope
+`@tinyweb_dev`.
+
+### 2. Tạo npm access token
+
+Tạo automation/granular access token trên npm với quyền read/write package
+`@tinyweb_dev/oe-meeting-react`.
+
+### 3. Thêm GitHub Actions secret
+
+Trong repository `tinyweb-01/oe-meeting`, mở:
+
+```text
+Settings → Secrets and variables → Actions → New repository secret
+```
+
+Tạo secret:
+
+```text
+Name:  NPM_TOKEN
+Value: <npm-access-token>
+```
+
+Không ghi token vào source, workflow, log hoặc file `.npmrc` trong repository.
+
+## Kiểm thử pipeline không publish
+
+Mở GitHub Actions → `release_npm` → Run workflow và giữ:
+
+```text
+dry_run = true
+```
+
+Workflow sẽ chạy đầy đủ build, typecheck, test, `npm pack` và
+`npm publish --dry-run`; không upload package.
+
+Có thể kiểm tra tương đương ở local:
+
+```bash
+cd src/sdk
+npm ci
+npm run build --workspace @tinyweb_dev/oe-meeting-react
+npm run typecheck --workspace @tinyweb_dev/oe-meeting-react
+npm run test --workspace @tinyweb_dev/oe-meeting-react
+cd react
+npm pack --dry-run
+npm publish --access public --dry-run
+```
+
+## Phát hành bằng tag
+
+### 1. Cập nhật version
+
+Từ repository root:
+
+```bash
+npm version 0.1.1 --workspace @tinyweb_dev/oe-meeting-react --no-git-tag-version
+```
+
+Lệnh cập nhật version package và workspace lockfile. Review, commit và merge vào
+branch phát hành trước khi tạo tag.
+
+### 2. Tạo tag đúng convention
+
+Tag bắt buộc có dạng:
+
+```text
+oe-meeting-react-v<package-version>
+```
+
+Ví dụ package version `0.1.1`:
+
+```bash
+git tag oe-meeting-react-v0.1.1
+git push origin oe-meeting-react-v0.1.1
+```
+
+Workflow từ chối release nếu tag không khớp chính xác version trong
+`src/sdk/react/package.json`.
+
+### 3. Xác nhận kết quả
+
+Kiểm tra workflow summary và package:
+
+```text
+https://www.npmjs.com/package/@tinyweb_dev/oe-meeting-react
+```
+
+Nếu cùng version đã tồn tại trên npm, workflow bỏ qua publish để rerun an toàn.
+Npm không cho phép ghi đè một version đã publish; cần tăng version để phát hành
+bản mới.
+
+## Phát hành thủ công
+
+`workflow_dispatch` hỗ trợ chọn `dry_run = false`. Chỉ dùng khi cần phát hành từ
+một commit/ref đã review và package version chưa tồn tại trên npm. Luồng tag vẫn
+là cách phát hành chuẩn vì tạo dấu mốc release rõ ràng trong Git.
+
+## Troubleshooting
+
+| Lỗi | Nguyên nhân thường gặp | Cách xử lý |
+|---|---|---|
+| `ENEEDAUTH` / `E401` | Thiếu, hết hạn hoặc sai `NPM_TOKEN` | Tạo token mới và cập nhật GitHub secret. |
+| `E403` | Token không có quyền scope/package hoặc npm yêu cầu 2FA policy khác | Kiểm tra quyền granular token và organization. |
+| Tag không khớp version | Tag và `package.json` khác nhau | Tăng version, commit rồi tạo tag đúng convention. |
+| Version đã tồn tại | Npm không cho overwrite | Tăng patch/minor/major version. |
+| Build/typecheck/test fail | Source chưa đạt release gate | Fix lỗi; không bỏ qua gate publish. |

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@tinyweb_dev/oe-meeting-react",
+  "version": "0.1.0",
+  "description": "React SDK to embed OE Meeting rooms via iframe and postMessage",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "INTEGRATION.md",
+    "docs"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "react-dom": ">=17"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.2.4",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tinyweb-01/oe-meeting.git",
+    "directory": "src/sdk/react"
+  },
+  "homepage": "https://github.com/tinyweb-01/oe-meeting/tree/prod/src/sdk/react#readme",
+  "bugs": {
+    "url": "https://github.com/tinyweb-01/oe-meeting/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "oe-meeting",
+    "video-conference",
+    "embed",
+    "react",
+    "iframe",
+    "lms"
+  ]
+}