@pradip1995/create-storefront-app 0.4.2 → 0.4.4

package/lib/medusa-plugin-versions.json

@@ -52,5 +52,8 @@
     "medusa-export",
     "medusa-payment-provider",
     "@tsc_tech/medusa-plugin-smtp"
+  ],
+  "moduleOnlyPlugins": [
+    "@tsc_tech/medusa-plugin-smtp"
   ]
 }

package/lib/scaffold-backend.js

@@ -104,7 +104,7 @@ export function scaffoldBackend(backendRoot, args) {
       "backend:build": "backend-build",
       "db:migrate":
         "npm run backend:build && cd .generated-backend && npm install && npx medusa db:migrate",
-      dev: "npm run backend:build && cd .generated-backend && npm install && npm run dev",
+      dev: "npm run backend:build && cd .generated-backend && npm install && npx medusa db:migrate && npm run dev",
       build:
         "npm run backend:build && cd .generated-backend && npm install && npm run build",
       start:

package/lib/versions.js

@@ -1,7 +1,7 @@
 /** Published package semver ranges — bump when releasing framework/components. */
 export const COMMERCE_CORE_VERSION = "^4.0.2"
 export const FRAMEWORK_VERSION = "^0.2.1"
-export const FRAMEWORK_COMPILER_VERSION = "^0.3.2"
+export const FRAMEWORK_COMPILER_VERSION = "^0.4.0"
 export const COMPONENTS_VERSION = ">=0.2.0 <0.4.0"
 
 export const FRAMEWORK_PACKAGES = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pradip1995/create-storefront-app",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Scaffold a segment-based Medusa storefront using @pradip1995/framework packages",
   "license": "MIT",
   "type": "module",

package/templates/backend/README.md

@@ -6,14 +6,14 @@ Medusa source is **generated** into `.generated-backend/` — same pattern as `s
 
 | File | Edit when |
 |------|-----------|
-| `plugins.config.json` | Add/remove plugins or change npm versions |
+| `plugins.config.json` | Add/remove plugins, change versions, or override plugin options |
 | `backend.config.json` | Change preset (`full`/`minimal`) or default region |
 | `.env` | Database URL, secrets, optional integrations |
 
 ## Commands
 
 ```bash
-npm run dev            # backend-build → medusa develop
+npm run dev            # backend-build → migrate → medusa develop
 npm run db:migrate     # first time (run twice on fresh DB if needed)
 npm run build          # backend-build → medusa build
 npm run seed           # seed demo data
@@ -22,6 +22,69 @@ npm run backend:build  # regenerate .generated-backend/ only
 
 **Do not edit** `.generated-backend/` — changes are overwritten on the next build.
 
+## Plugin configuration
+
+There are three layers:
+
+### 1. Secrets and integrations → `backend/.env`
+
+Credentials and environment-specific values are read at runtime via `process.env`:
+
+| Variable | Used by |
+|----------|---------|
+| `JWT_SECRET`, `COOKIE_SECRET` | Auth, invoice, order-management |
+| `SMTP_*` | SMTP notification module (when `@tsc_tech/medusa-plugin-smtp` is enabled) |
+| `CASHFREE_*` | Cashfree payment (when credentials are set) |
+| `SHIPROCKET_*` | Shiprocket fulfillment (when email/password are set) |
+| `AWS_*` | S3 file storage (falls back to local files when unset) |
+| `GOOGLE_CLIENT_*` | Google OAuth on customer auth |
+
+After changing `.env`, restart the backend — no rebuild needed.
+
+### 2. Business / plugin options → `plugins.config.json` → `pluginOptions`
+
+Override framework defaults per plugin. Values are merged into generated `medusa-config.ts` on `npm run backend:build`.
+
+```json
+{
+  "plugins": {
+    "stock-monitoring": "^0.0.5",
+    "medusa-review-rating": "^0.0.38"
+  },
+  "pluginOptions": {
+    "stock-monitoring": {
+      "low_stock_threshold": 5,
+      "slow_moving_days_threshold": 60
+    },
+    "medusa-review-rating": {
+      "autoApprove": false,
+      "requireVerifiedPurchase": true
+    },
+    "customer-registration": {
+      "registration": { "require_verification": false }
+    }
+  }
+}
+```
+
+To reference an env var from generated config, use a string (same as framework defaults):
+
+```json
+"medusa-shiprocket-fulfillment-sbl": {
+  "shiprocket": {
+    "pickupLocation": "process.env.SHIPROCKET_PICKUP_LOCATION || \"Warehouse A\""
+  }
+}
+```
+
+Run `npm run backend:build` (or `npm run dev`) after editing `pluginOptions`.
+
+### 3. Framework defaults
+
+Sensible defaults for every supported plugin live in `@pradip1995/framework-compiler` (`plugin-definitions.cjs`). You only need `pluginOptions` when you want to change something from the default.
+
+Unknown plugins must be added to the framework before they can be listed in `plugins.config.json`.
+
 ## Homepage admin schema
 
 Synced from storefront segments — see `storefront/pages.config.json` and run `npm run storefront:build` in the storefront folder.

package/templates/docker/docker/postgres/docker-entrypoint-wrapper.sh

@@ -4,6 +4,39 @@ set -euo pipefail
 DUMP_PATH="${DUMP_PATH:-/dump/dump.sql}"
 MIN_TABLES="${MIN_TABLES_FOR_DUMP:-1}"
 
+table_count() {
+  psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -tAc \
+    "SELECT count(*) FROM information_schema.tables WHERE table_schema = 'public';" \
+    2>/dev/null || echo "0"
+}
+
+restore_dump_if_empty() {
+  if [ -z "${POSTGRES_USER:-}" ] || [ -z "${POSTGRES_DB:-}" ]; then
+    return 0
+  fi
+
+  if ! pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  local count
+  count="$(table_count)"
+
+  if [ "${count:-0}" -ge "$MIN_TABLES" ]; then
+    return 0
+  fi
+
+  if [ ! -f "$DUMP_PATH" ] || [ ! -s "$DUMP_PATH" ]; then
+    echo "Database empty (${count:-0} tables) and no dump at ${DUMP_PATH} — run npm run migrate:backend"
+    return 0
+  fi
+
+  echo "Database empty (${count:-0} tables). Restoring from ${DUMP_PATH} ..."
+  psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1 -f "$DUMP_PATH"
+  count="$(table_count)"
+  echo "Database restore complete (${count} tables)."
+}
+
 dump_database() {
   if [ -z "${POSTGRES_USER:-}" ] || [ -z "${POSTGRES_DB:-}" ]; then
     return 0
@@ -13,19 +46,15 @@ dump_database() {
     return 0
   fi
 
-  local table_count
-  table_count=$(
-    psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -tAc \
-      "SELECT count(*) FROM information_schema.tables WHERE table_schema = 'public';" \
-      2>/dev/null || echo "0"
-  )
+  local count
+  count="$(table_count)"
 
-  if [ "${table_count:-0}" -lt "$MIN_TABLES" ]; then
-    echo "Skipping dump: public schema has ${table_count:-0} table(s)."
+  if [ "${count:-0}" -lt "$MIN_TABLES" ]; then
+    echo "Skipping dump: public schema has ${count:-0} table(s)."
     return 0
   fi
 
-  echo "Saving database dump (${table_count} tables) to ${DUMP_PATH} ..."
+  echo "Saving database dump (${count} tables) to ${DUMP_PATH} ..."
   pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fp > "${DUMP_PATH}.tmp"
   mv "${DUMP_PATH}.tmp" "${DUMP_PATH}"
   echo "Database dump saved."
@@ -46,4 +75,11 @@ trap shutdown_postgres SIGTERM SIGINT
 
 /usr/local/bin/docker-entrypoint.sh "$@" &
 child_pid=$!
+
+until pg_isready -U "${POSTGRES_USER:-postgres}" -d "${POSTGRES_DB:-postgres}" >/dev/null 2>&1; do
+  sleep 1
+done
+
+restore_dump_if_empty
+
 wait "$child_pid"