sahpa-monorepo 0.1.0

package/README.md

@@ -0,0 +1,20 @@
+# Sahpa Monorepo
+
+این ساختار یک مونوریپوی مبتنی بر `npm workspaces` است که امکان توسعه هم‌زمان چند پکیج و اپلیکیشن را می‌دهد.
+
+## مفهوم Workspace در مونوریپو
+در npm، یک **workspace** به مجموعه‌ای از پکیج‌های داخلی گفته می‌شود که با هم تحت یک `package.json` استاندارد مدیریت می‌شوند. هر workspace یک پکیج مجزا است، ولی نصب وابستگی‌ها، اجرای اسکریپت‌ها و لینک دادن پکیج‌ها از ریشه مونوریپو انجام می‌شود. بنابراین می‌توانید یک کتابخانه مشترک بنویسید (`packages/utils`)، آن را به اپ وب اضافه کنید (`apps/web`) و نسخه‌های محلی را بدون انتشار خارج از ریشه مصرف کنید. این سازوکار هزینه‌ی نصب را کاهش و هماهنگی بین پکیج‌ها را ساده‌تر می‌کند.
+
+## ساختار
+- `package.json` ریشه با فیلد `workspaces` تعریف کننده‌ی زیرپکیج‌های `apps/*` و `packages/*`.
+- `apps/web` اپ نمونه‌ای است که از پکیج‌های داخلی استفاده می‌کند.
+- `packages/utils` و `packages/shared` به عنوان پکیج‌های کمکی قابل reuse.
+
+## راه‌اندازی
+1. `npm run bootstrap` — نصب وابستگی‌ها برای تمام workspaceها.
+2. `npm run start:web` — اجرای اپ نمونه از workspace `apps/web`.
+3. `npm run build` / `npm run test` / `npm run lint` — اجرای اسکریپت‌های تعریف شده در تمام workspaceها به کمک `npm run <script> --workspaces`.
+
+## توسعه
+- اگر پکیج جدیدی لازم دارید، کافی است پوشه‌ای در `apps/` یا `packages/` بسازید، `package.json` خودش را تعریف کنید و روی آن فایل‌های لازم را اضافه نمایید.
+- وابستگی بین workspaceها با `workspace:*` در `dependencies` تعریف شود تا npm به صورت خودکار به نسخه‌های محلی اشاره کند.

package/apps/web/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "apps-web",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Frontend simulation for the Sahpa monorepo",
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node src/index.test.js"
+  },
+  "dependencies": {
+    "@sahpa/shared": "^0.1.0"
+  }
+}

package/apps/web/src/index.js

@@ -0,0 +1,5 @@
+const { formatMonorepoMessage } = require("@sahpa/utils");
+const { config } = require("@sahpa/shared");
+
+console.log("App Name:", config.projectName);
+console.log(formatMonorepoMessage("Sahpa Web App"));

package/apps/web/src/index.test.js

@@ -0,0 +1,2 @@
+require('./index');
+console.log('web app boot successful');

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "sahpa-monorepo",
+  "version": "0.1.0",
+  "description": "npm workspace scaffold for Sahpa projects",
+  "workspaces": [
+    "apps/*",
+    "packages/*"
+  ],
+  "scripts": {
+    "bootstrap": "npm install",
+    "build": "npm run build --workspaces",
+    "test": "npm run test --workspaces",
+    "lint": "npm run lint --workspaces",
+    "start:web": "npm --workspace apps/web start"
+  },
+  "packageManager": "yarn@3.6.1+sha512.de524adec81a6c3d7a26d936d439d2832e351cdfc5728f9d91f3fc85dd20b04391c038e9b4ecab11cae2b0dd9f0d55fd355af766bc5c1a7f8d25d96bb2a0b2ca"
+}

package/packages/shared/.npmrc.publish

@@ -0,0 +1 @@
+//registry.npmjs.org/:_authToken=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

package/packages/shared/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "shared22",
+  "version": "0.1.23",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "node src/index.js"
+  }
+}

package/packages/shared/src/index.js

@@ -0,0 +1,10 @@
+const config = {
+  projectName: 'sahpa-monorepo',
+  createdAt: new Date().toISOString()
+};
+
+function info() {
+  console.log('shared config loaded', config);
+}
+
+module.exports = { config, info };

package/packages/utils/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@sahpa/utils",
+  "version": "0.1.0",
+  "description": "Utility helpers shared across Sahpa workspaces",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "node src/index.test.js"
+  }
+}

package/packages/utils/src/index.js

@@ -0,0 +1,5 @@
+function formatMonorepoMessage(name) {
+  return `Welcome to ${name}!`;
+}
+
+module.exports = { formatMonorepoMessage };

package/packages/utils/src/index.test.js

@@ -0,0 +1,5 @@
+const { formatMonorepoMessage } = require('./index');
+const assert = require('node:assert');
+
+assert.strictEqual(formatMonorepoMessage('Sahpa'), 'Welcome to Sahpa!');
+console.log('utils tests pass');