orionplace-react 0.5.0 → 0.6.1

package/README.md

@@ -8,7 +8,7 @@ account, journal and support, in English and Russian. The package includes a
 setup CLI and the full storefront source, so every page and component in your
 project is yours to change.
 
-- **Setup CLI:** `init`, `set backend`, `add frontend`, `set mimic` and `update`.
+- **Setup CLI:** `init`, `set backend`, `add frontend`, `set mimic`, `sitemap rebuild` and `update`.
 - **Server install:** `install` builds the storefront on your Linux server and
   runs it as a system service behind nginx with HTTPS.
 - **API gateway:** the browser calls `/api/...` on your own domain; the server
@@ -318,6 +318,8 @@ npx orionplace-react add frontend shop.example.com
 npx orionplace-react add frontend www.shop.example.com
 npx orionplace-react remove frontend www.shop.example.com
 npx orionplace-react set mimic shop.example.com
+npx orionplace-react sitemap rebuild [shop.example.com]
+npx orionplace-react sitemap status
 sudo npx orionplace-react install
 npx orionplace-react status
 sudo npx orionplace-react restart
@@ -334,8 +336,15 @@ npm run orionplace:remove-frontend -- www.shop.example.com
 npm run orionplace:mimic -- shop.example.com
 npm run orionplace:help
 npm run orionplace:update
+npm run orionplace:sitemap
 ```
 
+The storefront serves `/robots.txt` and `/sitemap.xml` (public pages, categories,
+products and journal publications in every language). The sitemap is rebuilt
+from the backend once an hour; `npm run orionplace:sitemap` rebuilds it at once,
+for example after new publications, and the running storefront serves it without
+a restart.
+
 `npm set` belongs to npm's own configuration system; use the commands above.
 The setup commands configure local integration files. They do not provision a
 backend, change your account or create DNS records. `install` deploys the

package/bin/orionplace-react.mjs

@@ -3,6 +3,7 @@ import { setupProject } from '../src/setup.mjs';
 import { updateProject } from '../src/update.mjs';
 import { installService } from '../src/install.mjs';
 import { SERVICE_ACTIONS, SERVICE_ALIASES, controlService, findApp, printService } from '../src/service.mjs';
+import { sitemapCommand } from '../src/sitemap.mjs';
 import { readFile } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { createInterface } from 'node:readline/promises';
@@ -30,6 +31,9 @@ Commands for an existing project (run from its root):
   npx orionplace-react remove frontend <shop.example.com>
   npx orionplace-react set mimic <existing-frontend.example.com>
   npx orionplace-react set frontend <shop.example.com>
+  npx orionplace-react sitemap rebuild [domain]   rebuild /sitemap.xml now (every frontend, or one);
+                                       the running storefront serves it at once
+  npx orionplace-react sitemap status [domain]    when each sitemap was built
 
 On your Linux server (run from the project root):
   sudo npx orionplace-react install
@@ -131,6 +135,9 @@ try {
       }
       const done       = await controlService({ action: command, cwd, name: install.name, lines: positional[1] ?? 100, follow, dryRun });
       process.exitCode = printService(done);
+    } else if (command === 'sitemap' && positional.length <= 3) {
+      if (dryRun) throw new Error('--dry-run is not a sitemap option; sitemap status shows the state without changes.');
+      process.exitCode = await sitemapCommand({ cwd, action: target, domain: positional[2] });
     } else if (command === 'init' && positional.length <= 2) {
       result = await setupProject({ cwd: target ? resolve(cwd, target) : cwd, dryRun });
     } else if (command === 'update' && positional.length === 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orionplace-react",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Next.js 16 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",

package/runtime/marketplace.d.mts

@@ -25,3 +25,100 @@ export declare function forwardMarketplace(
   request: Request,
   configuration?: MarketplaceConfiguration,
 ): Promise<Response>;
+
+export interface MarketplaceSitemapPage {
+  path: string;
+  lastmod?: string | null;
+  locales?: string[];
+}
+
+export declare function marketplacePublicOrigin(
+  request: Request,
+  tenantDomain?: string,
+): string;
+
+export declare function noindexPathPrefixes(value?: string): string[];
+
+export declare function marketplaceNoindexPath(
+  pathname: string,
+  value?: string,
+): boolean;
+
+export declare function sitemapIndexedPages(
+  pages: MarketplaceSitemapPage[],
+  value?: string,
+): MarketplaceSitemapPage[];
+
+export declare function marketplaceRobots(origin: string): string;
+
+export declare function marketplaceRobotsResponse(
+  request: Request,
+  configuration?: MarketplaceConfiguration,
+): Promise<Response>;
+
+export declare function sitemapLocales(locales: unknown): string[];
+
+export declare function sitemapLastmod(
+  value: unknown,
+  now?: number,
+): string | null;
+
+export declare function sitemapApiPath(
+  paths: unknown,
+  name: string,
+): string | null;
+
+export declare function sitemapCategoryIds(categories: unknown): number[];
+
+export declare function marketplaceSitemapXml(
+  origin: string,
+  pages: MarketplaceSitemapPage[],
+  locales: string[],
+): string;
+
+export declare function marketplaceSitemapResponse(
+  request: Request,
+  configuration?: MarketplaceConfiguration,
+): Promise<Response>;
+
+export interface MarketplaceSitemap {
+  version: number;
+  domain: string;
+  built: string;
+  locales: string[];
+  pages: MarketplaceSitemapPage[];
+}
+
+export interface MarketplaceSitemapRebuild {
+  domain: string;
+  path: string;
+  built: string;
+  urls: number;
+  pages: number;
+  publications: number;
+}
+
+export declare const SITEMAP_LIFETIME: number;
+
+export declare function readMarketplaceDomain(
+  domain: string,
+  options?: { root?: string },
+): Promise<MarketplaceTenant>;
+
+export declare function marketplaceConfigDirectory(root?: string): string;
+
+export declare function marketplaceDomains(root?: string): Promise<string[]>;
+
+export declare function sitemapCacheDirectory(root?: string): string;
+
+export declare function readSitemapCache(
+  domain: string,
+  root?: string,
+): Promise<MarketplaceSitemap | null>;
+
+export declare function sitemapUrlCount(sitemap: MarketplaceSitemap): number;
+
+export declare function rebuildMarketplaceSitemap(
+  domain: string,
+  options?: { root?: string },
+): Promise<MarketplaceSitemapRebuild>;