orionplace-nuxt 0.1.2 → 0.2.0

package/bin/orionplace-nuxt.mjs

@@ -1,13 +1,28 @@
 #!/usr/bin/env node
 import { setupProject } from '../src/setup.mjs';
+import { updateProject } from '../src/update.mjs';
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { createInterface } from 'node:readline/promises';
 
 const help = `Orionplace Nuxt setup
 
+From zero (Node.js 22.12+ with npm; run from the parent folder):
+  npx --yes orionplace-nuxt init my-marketplace
+  cd my-marketplace
+  npm install
+  npx orionplace-nuxt set backend your-project.orionplace.app
+  npx orionplace-nuxt add frontend shop.example.com
+  npm run dev
+
+Replace the backend with the domain from your orionmarket.place profile,
+and the frontend with your storefront domain. Open Nuxt's local URL;
+the storefront opens after Application Load succeeds.
+
+Commands for an existing project (run from its root):
   npx orionplace-nuxt help
   npx orionplace-nuxt init [directory]
+  npx orionplace-nuxt update
   npx orionplace-nuxt set backend <personal-backend.orionplace.app>
   npx orionplace-nuxt add frontend <shop.example.com>
   npx orionplace-nuxt remove frontend <shop.example.com>
@@ -15,7 +30,10 @@ const help = `Orionplace Nuxt setup
   npx orionplace-nuxt set frontend <shop.example.com>
 
 Options: --cwd <directory>  --dry-run  --help  --version
+Update option: --local (apply this CLI version instead of fetching the latest release)
 
+Update downloads the latest release, refreshes unedited source, and installs dependencies.
+It preserves edited source, domain mappings and MIMIC. --dry-run leaves project files unchanged.
 Set backend or add frontend also initializes the integration; either can come first.
 MIMIC starts empty. The first added frontend sets it; later additions preserve it.
 Set mimic selects an existing frontend without changing any domain mappings.
@@ -31,10 +49,12 @@ try {
     console.log(JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8')).version);
   } else {
     const positional = [];
-    let cwd = process.cwd();
-    let dryRun = false;
+    let cwd          = process.cwd();
+    let dryRun       = false;
+    let local        = false;
     for (let index = 0; index < argv.length; index++) {
       if (argv[index] === '--dry-run') dryRun = true;
+      else if (argv[index] === '--local') local = true;
       else if (argv[index] === '--cwd') {
         if (!argv[index + 1]) throw new Error('--cwd needs a directory');
         cwd = resolve(argv[++index]);
@@ -42,9 +62,12 @@ try {
       else positional.push(argv[index]);
     }
     const [command, target] = positional;
+    if (local && command !== 'update') throw new Error('--local is only supported by update.');
     let result;
     if (command === 'init' && positional.length <= 2) {
       result = await setupProject({ cwd: target ? resolve(cwd, target) : cwd, dryRun });
+    } else if (command === 'update' && positional.length === 1) {
+      result = await updateProject({ cwd, dryRun, local });
     } else if (((command === 'set' && ['backend', 'frontend', 'mimic'].includes(target)) ||
         (['add', 'remove'].includes(command) && target === 'frontend')) && positional.length <= 3) {
       let value = positional[2];
@@ -56,15 +79,20 @@ try {
       if (!value) throw new Error(`Provide the ${target} domain. See --help.`);
       result = await setupProject({ cwd, action: command, field: target, value, dryRun });
     } else throw new Error('Unknown command. See --help.');
-    console.log(`${dryRun ? 'Planned' : 'Updated'} ${result.root}`);
-    for (const path of result.changed) console.log(`  ${result.removed.includes(path) ? 'Remove: ' : ''}${path}`);
-    for (const path of result.preserved) console.log(`  Preserved your edits: ${path}`);
-    console.log(result.settings.backend && result.settings.frontend
-      ? `Ready: ${result.settings.frontends.join(', ')} -> ${result.settings.backend}\nLocal MIMIC: ${result.settings.frontend}`
-      : `Next: ${result.settings.backend ? 'add frontend' : 'set backend'} to complete the domain mapping.`);
-    if (result.changed.some(path => path.endsWith('.cfg') || path === '.env')) console.log('Restart a running development server to refresh allowed hosts and MIMIC. Reload your production environment when changing MIMIC.');
-    if (result.isNewNuxt) console.log('Run npm install in the project, then npm run dev.');
-    console.log('Project documentation: orionplace/README.md');
+    if (result) {
+      console.log(`${dryRun ? 'Planned' : 'Updated'} ${result.root}`);
+      for (const path of result.changed) console.log(`  ${result.removed.includes(path) ? 'Remove: ' : ''}${path}`);
+      for (const path of result.preserved) console.log(`  Preserved your edits: ${path}`);
+      console.log(result.settings.backend && result.settings.frontend
+        ? `Ready: ${result.settings.frontends.join(', ')} -> ${result.settings.backend}\nLocal MIMIC: ${result.settings.frontend}`
+        : `Next: ${result.settings.backend ? 'add frontend' : 'set backend'} to complete the domain mapping.`);
+      if (result.changed.some(path => path.endsWith('.cfg') || path === '.env')) console.log('Restart a running development server to refresh allowed hosts and MIMIC. Reload your production environment when changing MIMIC.');
+      if (result.isNewNuxt) console.log('Run npm install in the project, then npm run dev.');
+      console.log('Project documentation: orionplace/README.md');
+      if (command === 'update') console.log(dryRun
+        ? 'Dependency installation would run after applying these changes. Project files were not changed.'
+        : 'Update complete. Restart development, or rebuild and redeploy your production frontend.');
+    }
   }
 } catch (error) {
   console.error(`Orionplace: ${error.message}`);

package/package.json

@@ -1,16 +1,29 @@
 {
   "name": "orionplace-nuxt",
-  "version": "0.1.2",
-  "description": "Nuxt integration and setup CLI for your Orionplace personal marketplace backend.",
+  "version": "0.2.0",
+  "description": "Nuxt 4 storefront for your Orionplace marketplace: setup CLI, server API gateway, typed store and ready-made catalog, cart, checkout and account components in English and Russian, plus an Android app build.",
   "type": "module",
   "license": "MIT",
   "author": "Orionplace",
-  "homepage": "https://orionmarket.place/sandbox/backend-domain/nuxt",
+  "homepage": "https://orionmarket.place/en/sandbox/new-project/nuxt",
   "keywords": [
     "nuxt",
+    "nuxt4",
     "nuxt-module",
+    "vue",
     "orionplace",
-    "marketplace"
+    "orionmarketplace",
+    "marketplace",
+    "storefront",
+    "ecommerce",
+    "e-commerce",
+    "shop",
+    "cart",
+    "checkout",
+    "ssr",
+    "cli",
+    "android",
+    "capacitor"
   ],
   "engines": {
     "node": ">=22.12.0"
@@ -31,11 +44,12 @@
     "bin",
     "src",
     "runtime",
+    "templates",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "test": "node --test test/*.test.mjs"
+    "test": "node --experimental-strip-types --import ../../scripts/register-test-aliases.mjs --test test/*.test.mjs"
   },
   "peerDependencies": {
     "nuxt": "^4.0.0"
@@ -43,10 +57,16 @@
   "dependencies": {
     "@nuxt/kit": "^4.5.0",
     "h3": "^1.15.4",
-    "magicast": "^0.5.0"
+    "magicast": "^0.5.0",
+    "@tailwindcss/vite": "^4.3.3",
+    "tailwindcss": "^4.3.3"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "pinia": "^4.0.2",
+    "vue": "^3.5.0"
   }
 }

package/runtime/api.mjs

@@ -1,11 +1,14 @@
 // All browser and SSR /api requests use this gateway.
+// It also serves guarded blog media under /ps3/blog.
 import { defineEventHandler, toWebRequest, sendWebResponse } from 'h3';
 import { useRuntimeConfig } from '#imports';
 import { forwardMarketplace } from './marketplace.mjs';
 
 export default defineEventHandler(async (event) => {
   const response = await forwardMarketplace(toWebRequest(event), {
-    mimicFrontDomain: process.env.MIMIC_FRONT_DOMAIN ?? useRuntimeConfig(event).mimicFrontDomain,
+    mimicFrontDomain:
+      process.env.MIMIC_FRONT_DOMAIN ??
+      useRuntimeConfig(event).mimicFrontDomain,
   });
   return sendWebResponse(event, response);
 });

package/runtime/domain.mjs

@@ -4,6 +4,8 @@ import { useRuntimeConfig } from '#imports';
 import { resolveFrontDomain } from './marketplace.mjs';
 
 export default defineEventHandler((event) => {
-  event.context.marketplaceDomain = resolveFrontDomain(toWebRequest(event),
-    process.env.MIMIC_FRONT_DOMAIN ?? useRuntimeConfig(event).mimicFrontDomain);
+  event.context.marketplaceDomain = resolveFrontDomain(
+    toWebRequest(event),
+    process.env.MIMIC_FRONT_DOMAIN ?? useRuntimeConfig(event).mimicFrontDomain,
+  );
 });