| # Workspace |
|
|
| ## Overview |
|
|
| pnpm workspace monorepo using TypeScript. Each package manages its own dependencies. |
|
|
| ## Stack |
|
|
| - **Monorepo tool**: pnpm workspaces |
| - **Node.js version**: 24 |
| - **Package manager**: pnpm |
| - **TypeScript version**: 5.9 |
| - **API framework**: Express 5 |
| - **Database**: PostgreSQL + Drizzle ORM |
| - **Validation**: Zod (`zod/v4`), `drizzle-zod` |
| - **API codegen**: Orval (from OpenAPI spec) |
| - **Build**: esbuild (CJS bundle) |
|
|
| ## Key Commands |
|
|
| - `pnpm run typecheck` — full typecheck across all packages |
| - `pnpm run build` — typecheck + build all packages |
| - `pnpm --filter @workspace/api-spec run codegen` — regenerate API hooks and Zod schemas from OpenAPI spec |
| - `pnpm --filter @workspace/db run push` — push DB schema changes (dev only) |
| - `pnpm --filter @workspace/api-server run dev` — run API server locally |
|
|
| See the `pnpm-workspace` skill for workspace structure, TypeScript setup, and package details. |
|
|
| ## FB Group Publisher PRO (artifacts/fb-publisher) |
|
|
| Arabic RTL web port of the Chrome extension. Architecture: |
| - **Web app** (this artifact): hosts UI, auth, subscriptions, saved lists, all main logic. |
| - **Bridge extension** (`public/extension/`): tiny Chrome extension installed by users; injects a content script on the web app that exposes Facebook cookies and tab scripting via `window.postMessage` (sources: `fbpub-web` ↔ `fbpub-bridge`). |
| - **Auth**: Clerk (mandatory). Express uses `clerkMiddleware` + a proxy from web `/api` to api-server. |
| - **Payments**: PayPal Sandbox subscription, $2.50 every 2 months with 1‑month free trial. Plan auto-created on first subscribe and IDs cached in `app_config` table. |
| - **DB tables**: `users`, `subscriptions`, `saved_lists`, `app_config` (drizzle). |
| - **Pages**: Landing, Sign-in/up, InstallExtension, Subscription, SubscriptionReturn, Publisher. |
|
|
| ## Chrome Extension — حماية الكود |
|
|
| - **الكود المصدري الأصلي** محفوظ في: `artifacts/fb-publisher/public/extension/src/background.source.js` (مُستبعد من Git) |
| - **الكود الموزّع** في `background.js` مُشفّر دائماً باستخدام javascript-obfuscator |
| - **لتعديل الكود**: عدّل `src/background.source.js` ثم شغّل `pnpm run obfuscate-extension` |
| - **السكريبت**: `scripts/obfuscate-extension.cjs` — يشفّر الكود ويبني ZIP تلقائياً |
| - **التبعية**: `javascript-obfuscator` مثبتة في الجذر (workspace root) |
|
|
