@khester/create-dynamics-app 2.0.0 → 2.2.0

package/dist/scaffold.js

@@ -21,6 +21,25 @@ export function resolveLibraryFromFlags(options) {
     }
     return undefined;
 }
+const COMPONENT_HOSTS = 'power-pages, web-resource, dialog-form';
+export function resolveWithComponents(descriptor, library, withComponents) {
+    if (!withComponents)
+        return { kind: 'skip' };
+    if (!descriptor.supportsComponents) {
+        return {
+            kind: 'warn',
+            message: `--with-components is ignored for "${descriptor.id}". Supported: ${COMPONENT_HOSTS}.`,
+        };
+    }
+    if (library === 'fluent-v9') {
+        return {
+            kind: 'error',
+            message: `--with-components ships Fluent v8 components and can't combine with Fluent v9 on "${descriptor.id}". ` +
+                'Re-run with --v8 (or drop --with-components).',
+        };
+    }
+    return { kind: 'apply' };
+}
 /** Map known CLI flags to prompt answers so we don't re-ask for them. */
 export function prefilledAnswers(options) {
     const pre = {};
@@ -32,6 +51,8 @@ export function prefilledAnswers(options) {
         pre.propertyType = options.propertyType;
     if (options.graph)
         pre.graph = 'true';
+    if (options.surface)
+        pre.surface = options.surface;
     return pre;
 }
 /** Run an artifact's prompts, skipping any already provided via flags. */
@@ -86,7 +107,7 @@ export async function runArtifactPrompts(descriptor, projectName, options) {
     return answers;
 }
 /** Build the `{{var}}` substitution bag from answers + the artifact's derive() hook. */
-export function buildTemplateVariables(descriptor, projectName, answers, library) {
+export function buildTemplateVariables(descriptor, projectName, answers, library, withComponents) {
     let vars = { projectName, ...answers };
     // Derived vars are data-driven per artifact (replaces hard-coded per-id logic).
     if (descriptor.derive) {
@@ -95,6 +116,11 @@ export function buildTemplateVariables(descriptor, projectName, answers, library
     if (descriptor.supportsLibraryChoice && library) {
         vars.componentLibrary = library;
     }
+    // Opt-in @khester/reusable-components (Fluent v8). Only honored on a host that
+    // can consume them; the driver guards `--with-components --v9` before this point.
+    if (descriptor.supportsComponents && withComponents) {
+        vars.withComponents = 'true';
+    }
     // Always return the bag. Substitution is keyed on `{{name}}`, so it is a safe
     // no-op on templates without placeholders — and this guarantees `{{projectName}}`
     // is honored if a template adds it later (the old length-based guard silently skipped it).

package/dist/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khester/create-dynamics-app",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Unified CLI to scaffold Dynamics 365 / Power Platform artifacts",
   "main": "dist/index.js",
   "type": "module",
@@ -19,12 +19,13 @@
     "prepublishOnly": "npm run build",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:e2e": "tsc --noEmit -p tsconfig.e2e.json && vitest run --config vitest.e2e.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts,.tsx",
     "clean": "rimraf dist tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@dataverse-kit/export-engine": "^1.0.0",
+    "@dataverse-kit/export-engine": "^1.19.0",
     "@khester/dynamics-ui-components": "^1.0.0",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",

package/templates/grid-starter/ARCHITECTURE.md

@@ -0,0 +1,66 @@
+# Architecture
+
+A small, layered custom page centered on a reusable **grid**. The grid is
+declarative (columns are data), and data access is isolated behind one seam.
+
+## Layers
+
+```
+@dataverse-kit/grid-kit          <DataGrid> + cell-renderer registry (npm dependency)
+@khester/dynamics-cell-renderers the cell components grid-kit wraps
+@khester/reusable-components     logging + dev-panel UI primitives
+        │  (imported)
+        ▼
+src/grid/GridPage.tsx            view — builds ColumnDef[] + createCellRegistry,
+                                 maps API rows, renders <DataGrid>
+        │
+        ▼
+src/core/services/  IApiService     the data-access contract
+                    ServiceFactory  picks one impl per environment (the seam)
+                    Mock / Fetch / Xrm   three implementations
+```
+
+**Dependency rule (one direction):** view → `IApiService`. `core/` imports nothing
+app-specific. UI/grid/logging are consumed from packages, never reached into.
+
+## The grid pattern
+
+| Concern | Lives in | Why |
+|---------|----------|-----|
+| Columns | the `columns: ColumnDef[]` array in `GridPage.tsx` | declarative; each column is a `rendererType` + `rendererConfig` (+ `editorType`) |
+| Cell rendering | `@dataverse-kit/grid-kit` registry | shared renderers; override or add types via `registry.register(...)` |
+| Row mapping | `mapAccount` in `GridPage.tsx` | Dataverse attribute → display row, one place |
+| Filtering | local `search` state | client-side; the toolbar `onSearch` updates it |
+| Load | `api.retrieveMultipleRecords('accounts', …)` | data fetch isolated behind `IApiService` |
+
+The same registry that drives this `<DataGrid>` also drives a Grid Customizer via
+`toGridCustomizerOverrides` — so a cell type you add here works in both hosts.
+
+## The ServiceFactory seam
+
+`ServiceFactory.createApiService(Xrm)` is the single decision point:
+
+- **Mock** (`localhost`, no `DYNAMICS_URL`) → `MockApiService`, in-memory (seeds a
+  few accounts).
+- **Token** (`localhost` + `DYNAMICS_URL`) → `FetchApiService`. `vite.config.ts`
+  proxies `/api/data/*` to the org and injects the bearer **server-side**, so the
+  token never reaches the client bundle.
+- **Production** (deployed) → `XrmApiService`, hitting the Web API on the same
+  origin (session auth). `Xrm` is resolved from `window.parent` in `App.tsx`.
+
+All three implement the same `IApiService` and address entities by their Web API
+**set name** (e.g. `accounts`).
+
+## Logging
+
+`logger` / `withCrudLog` come from `@khester/reusable-components`.
+`core/services/crudLogging.ts` binds `withCrudLog` to the Dataverse error shapes so
+every service method emits one structured `[CRUD] …` line. Console output is
+**localhost-gated** (errors always surface); on localhost the buffer is exposed as
+`window.__APP_LOGS__` + `window.dumpAppLogs(filter?)`.
+
+## Testing
+
+The view and `IApiService` implementations are best covered by running the app
+against the mock seam (`npm run dev`). Add unit tests for any pure mappers you
+introduce (Vitest is configured via `npm run test`).

package/templates/grid-starter/README.md

@@ -0,0 +1,122 @@
+# Grid Starter (Dataverse custom page)
+
+A production-shaped starter for a React app mounted as a **Dynamics 365 custom
+page**, centered on a reusable **grid**. `src/grid/GridPage.tsx` renders an
+[`@dataverse-kit/grid-kit`](../../../grid-kit) `<DataGrid>` over the
+`ServiceFactory` data seam: mock data on localhost, live Dataverse in production.
+
+The grid is **registry-driven** — every column is a `ColumnDef` with a
+`rendererType` (text, currency, `coloredCell` status badge, rating, …). The same
+registry works in a PCF grid and a Grid Customizer. To add or change a cell:
+edit the `columns` array in `GridPage.tsx`; to add a bespoke cell type, call
+`registry.register('myType', { read: MyCell })`.
+
+The data-access seam (`src/core/services`) is owned by this app.
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `npm install` | Install dependencies |
+| `npm run dev` | Run in **mock** mode — seeded data, no org needed |
+| `npm run dev:token` | Run against a **live org** — refreshes the token + starts Vite |
+| `npm run auth:token -- --url https://<org>.crm.dynamics.com` | Acquire/refresh a Dataverse token into `.env` (needs `az login`) |
+| `npm run build` | Production build → `dist/` (multi-file) |
+| `npm run build:d365` | Single self-contained `dist/index.html` (the web resource) |
+| `npm run deploy` | Build + upload + **publish** the web resource to your org |
+| `npm test` | Run Vitest (no tests ship by default — add your own; passes with none) |
+| `npm run typecheck` | Type-check (`tsc --noEmit`) |
+| `npm install @khester/reusable-components@latest` | Update the shared component library |
+
+> Requires **Node 18+**. For `dev:token` / `deploy` you also need `az login` and
+> `DYNAMICS_URL` in `.env` (set once via `npm run auth:token -- --url …`).
+
+## Quick start
+
+```bash
+npm install
+npm run dev          # mock mode — a seeded account, no org needed
+```
+
+Open http://localhost:3000. The grid lists the seeded accounts; type in the
+toolbar search to filter, click **Refresh** to reload. Each load logs a
+`[CRUD] READ accounts ok` line; on localhost `window.dumpAppLogs()` in the
+browser console prints the structured log buffer.
+
+A floating **🔧 Dev Tools** panel (bottom-right, localhost only) shows the active
+mode (Mock / Token-proxy / Production) and the `[CRUD]` log buffer. It renders
+nothing once deployed.
+
+## Three runtime modes
+
+`src/core/services/ServiceFactory.ts` picks the data service per environment:
+
+| Mode | When | Service |
+|------|------|---------|
+| **Mock** | `localhost`, no `DYNAMICS_URL` | `MockApiService` (in-memory, seeds a few accounts) |
+| **Token** | `localhost` + `DYNAMICS_URL` set | `FetchApiService` → Vite proxy → real Dataverse |
+| **Production** | deployed in a model-driven app | `XrmApiService` (Web API, session auth) |
+
+### Token mode — test against a real org locally
+
+```bash
+npm run auth:token -- --url https://<org>.crm.dynamics.com   # writes .env via Azure CLI
+npm run dev
+```
+
+The Vite dev server proxies `/api/data/*` to the org and injects the bearer token
+**server-side** — the token never enters the browser bundle. Tokens last ~60 min;
+re-run `npm run auth:token` to refresh (no dev-server restart needed). Requires
+`az login` first. See `env.example` for the variables.
+
+Once `DYNAMICS_URL` is in `.env`, **`npm run dev:token`** refreshes the token and
+starts the dev server in one step:
+
+```bash
+npm run dev:token
+```
+
+## Build & deploy
+
+```bash
+npm run build        # standard multi-file build → dist/
+npm run build:d365   # single self-contained dist/index.html (vite-plugin-singlefile)
+npm run deploy       # build:d365 + upload as an HTML web resource + publish
+```
+
+**`npm run deploy`** refreshes the token, builds the single-file bundle, and
+upserts + publishes it as an HTML web resource via the Dataverse Web API (no PAC
+CLI needed). Set the web-resource name in `.env` first — the prefix must match a
+publisher that exists in your org:
+
+```bash
+# .env
+WEBRESOURCE_NAME=cr1a2_/myapp/index.html   # use YOUR publisher prefix
+# WEBRESOURCE_SOLUTION=MySolution          # optional: add it to an unmanaged solution
+```
+
+Then host it on a model-driven **custom page**, or open it via
+`Xrm.Navigation.navigateTo({ pageType: "webresource", webresourceName: "<name>" })`.
+The page reads an optional record id from the URL (`?id=<guid>`); in production it
+resolves `Xrm` from `window.parent`.
+
+> Some orgs enforce a Content-Security-Policy that blocks inline `<script>`. The
+> single-file bundle is one inline script — if your environment blocks it, use the
+> multi-file `npm run build` output instead.
+
+## Make it your own
+
+The grid lives in `src/grid/GridPage.tsx`:
+
+1. **Change columns** — edit the `columns: ColumnDef[]` array. Each column has a
+   `rendererType` (text, currency, coloredCell, rating, optionset, progress, date,
+   link, toggle, …) plus optional `rendererConfig` and `editorType`.
+2. **Custom cell** — `registry.register('myType', { read: MyCell })`, then set a
+   column's `rendererType` to `'myType'`.
+3. **Map your entity** — adjust `mapAccount` and the column `fieldName`s to your
+   Dataverse attributes, and seed rows in `src/core/services/MockApiService.ts`
+   so `npm run dev` works offline.
+
+```bash
+npm run typecheck    # tsc --noEmit
+```

package/templates/grid-starter/env.example

@@ -0,0 +1,16 @@
+# Token-proxy dev mode — run `npm run dev` against a real Dataverse org.
+#
+# Preferred: run `npm run auth:token -- --url https://<org>.crm.dynamics.com`,
+# which acquires a token via the Azure CLI and writes both values to .env.
+# Or copy this file to .env and fill them in manually.
+#
+# When DYNAMICS_URL is set, the Vite dev server proxies /api/data/* to the org
+# and injects DYNAMICS_TOKEN as the bearer (server-side — never in the bundle).
+DYNAMICS_URL=https://your-org.crm.dynamics.com
+DYNAMICS_TOKEN=
+
+# `npm run deploy` — the HTML web-resource unique name. The prefix (before `_`)
+# MUST be a publisher prefix that exists in your org (e.g. cr1a2_ / new_).
+WEBRESOURCE_NAME=new_/your-app/index.html
+# Optional: add the web resource to this unmanaged solution (unique name).
+WEBRESOURCE_SOLUTION=

package/templates/grid-starter/gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+*.log
+.env
+.env.local
+.env.*.local

package/templates/grid-starter/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Dynamics Custom Page</title>
+    <style>
+      /* App canvas behind the form — matches the Dynamics model-driven background. */
+      body { margin: 0; min-height: 100vh; background: #fafafa; }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/index.tsx"></script>
+  </body>
+</html>

package/templates/grid-starter/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "grid-starter-app",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Dataverse React custom page with a grid-kit <DataGrid> (Vite + @dataverse-kit/grid-kit)",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "vite",
+    "dev:token": "npm run auth:token && npm run dev",
+    "build": "tsc && vite build",
+    "build:d365": "tsc && vite build --mode d365",
+    "deploy": "npm run auth:token && npm run build:d365 && node tools/deploy/deploy-webresource.cjs",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@dataverse-kit/grid-kit": "^0.1.0",
+    "@khester/dynamics-cell-renderers": "^1.1.0",
+    "@khester/reusable-components": "^0.1.4",
+    "@fluentui/react": "^8.110.10",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.1",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3",
+    "vite": "^5.4.21",
+    "vite-plugin-singlefile": "^2.0.3",
+    "vitest": "^1.6.0"
+  }
+}

package/templates/grid-starter/src/App.tsx

@@ -0,0 +1,23 @@
+import React from "react";
+import { ServiceFactory } from "./core/services/ServiceFactory";
+import { GridPage } from "./grid/GridPage";
+import { DevPanel } from "./dev-tools/DevPanel";
+
+// Domain-free shell. The Xrm context exists only when this bundle is hosted
+// inside a model-driven app (the custom page runs in an iframe, so Xrm lives on
+// window.parent). ServiceFactory uses it for production mode; on localhost it is
+// undefined and the factory returns the mock or token-proxy service instead.
+const Xrm: any = (window as any).parent?.Xrm ?? (window as any).Xrm;
+
+export const App: React.FC = () => {
+  const api = React.useMemo(() => ServiceFactory.createApiService(Xrm), []);
+  return (
+    <>
+      <GridPage api={api} />
+      {/* Localhost-only floating dev tools (renders nothing once deployed). */}
+      <DevPanel />
+    </>
+  );
+};
+
+export default App;

package/templates/grid-starter/src/core/services/FetchApiService.ts

@@ -0,0 +1,117 @@
+import { IApiService } from "./IApiService";
+import { logCrud } from "./crudLogging";
+import { logger } from "@khester/reusable-components";
+
+/**
+ * Dev API service for token-proxy mode (`npm run dev` with DYNAMICS_URL set).
+ * Requests go to the SAME-ORIGIN path /api/data/v9.2/... and the Vite dev proxy
+ * (vite.config.ts) injects the `Authorization: Bearer` header server-side — the
+ * token is never read by, or bundled into, the client.
+ */
+export class FetchApiService implements IApiService {
+  constructor(private baseUrl = "") {}
+
+  private headers(): HeadersInit {
+    return {
+      "Content-Type": "application/json; charset=utf-8",
+      Accept: "application/json",
+      "OData-Version": "4.0",
+      "OData-MaxVersion": "4.0",
+      Prefer: 'odata.include-annotations="*"',
+    };
+  }
+
+  retrieveMultipleRecords(
+    entity: string,
+    fetchXml: string,
+  ): Promise<{ entities: any[] }> {
+    return logCrud(
+      { op: "READ", entity, resultCount: (r) => r?.entities?.length },
+      async () => {
+        const url = `${this.baseUrl}/api/data/v9.2/${entity}?fetchXml=${encodeURIComponent(fetchXml)}`;
+        const response = await fetch(url, { method: "GET", headers: this.headers() });
+        if (!response.ok) {
+          const body = await response.text().catch(() => "");
+          throw new Error(`API error ${response.status}: ${response.statusText}${body ? ` — ${body}` : ""}`);
+        }
+        const data = await response.json();
+        return { entities: data.value ?? [] };
+      },
+    );
+  }
+
+  createRecord(entity: string, record: any): Promise<any> {
+    return logCrud({ op: "CREATE", entity, resultId: (r) => r?.id }, async () => {
+      const url = `${this.baseUrl}/api/data/v9.2/${entity}`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify(record),
+      });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`Create failed ${response.status}: ${body}`);
+      }
+      const entityId = response.headers.get("OData-EntityId");
+      const match = entityId ? /\(([^)]+)\)/.exec(entityId) : null;
+      return match ? { id: match[1] } : response.json().catch(() => ({}));
+    });
+  }
+
+  updateRecord(entity: string, id: string, record: any): Promise<any> {
+    return logCrud({ op: "UPDATE", entity, id }, async () => {
+      const cleanId = id.replace(/[{}]/g, "");
+      const url = `${this.baseUrl}/api/data/v9.2/${entity}(${cleanId})`;
+      const response = await fetch(url, {
+        method: "PATCH",
+        headers: this.headers(),
+        body: JSON.stringify(record),
+      });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`Update failed ${response.status}: ${body}`);
+      }
+      return { success: true };
+    });
+  }
+
+  deleteRecord(entity: string, id: string): Promise<void> {
+    return logCrud({ op: "DELETE", entity, id }, async () => {
+      const cleanId = id.replace(/[{}]/g, "");
+      const url = `${this.baseUrl}/api/data/v9.2/${entity}(${cleanId})`;
+      const response = await fetch(url, { method: "DELETE", headers: this.headers() });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`Delete failed ${response.status}: ${body}`);
+      }
+    });
+  }
+
+  executeRequest(requestName: string, requestData: any): Promise<any> {
+    return logCrud({ op: "EXECUTE", entity: requestName }, async () => {
+      const url = `${this.baseUrl}/api/data/v9.2/${requestName}`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: this.headers(),
+        body: JSON.stringify(requestData),
+      });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`Execute failed ${response.status}: ${body}`);
+      }
+      return response.json().catch(() => ({}));
+    });
+  }
+
+  async uploadFile(file: File): Promise<string> {
+    logger.warn("uploadFile not implemented", {
+      source: "FetchApiService",
+      data: { file: file.name },
+    });
+    return "";
+  }
+
+  async associateRecord(): Promise<void> {
+    logger.warn("associateRecord not implemented", { source: "FetchApiService" });
+  }
+}

package/templates/grid-starter/src/core/services/IApiService.ts

@@ -0,0 +1,37 @@
+// The single data-access contract for the page. Three implementations satisfy
+// it — MockApiService (offline), FetchApiService (token-proxy dev), and
+// XrmApiService (production) — and ServiceFactory picks one per environment.
+//
+// Entities are addressed by their Web API ENTITY SET name (plural, e.g.
+// "accounts"), used consistently for reads and writes across all three services.
+export interface IApiService {
+  /** Update a record. `record` contains only the changed attributes. */
+  updateRecord(entity: string, id: string, record: any): Promise<any>;
+
+  /** Create a record; resolves to `{ id }`. */
+  createRecord(entity: string, record: any): Promise<any>;
+
+  /** Delete a record. */
+  deleteRecord(entity: string, id: string): Promise<void>;
+
+  /** Retrieve records via a FetchXML query. */
+  retrieveMultipleRecords(
+    entity: string,
+    fetchXml: string,
+  ): Promise<{ entities: any[] }>;
+
+  /** Execute a custom API / unbound function or action. */
+  executeRequest(requestName: string, requestData: any): Promise<any>;
+
+  /** Upload a file and return its URL. */
+  uploadFile(file: File): Promise<string>;
+
+  /** Associate two records via a relationship. */
+  associateRecord(
+    entityName: string,
+    entityId: string,
+    relationshipName: string,
+    relatedEntityName: string,
+    relatedEntityId: string,
+  ): Promise<void>;
+}

package/templates/grid-starter/src/core/services/MockApiService.ts

@@ -0,0 +1,72 @@
+import { IApiService } from "./IApiService";
+import { logCrud } from "./crudLogging";
+
+// A few seeded in-memory accounts so `npm run dev` renders the grid with no org
+// or token. Each carries the extra demo fields the grid columns show (revenue,
+// statuscode, rating). Replace this seed as your page grows.
+const SEED_ACCOUNTS = [
+  { accountid: "00000000-0000-0000-0000-000000000001", name: "Contoso Ltd", accountnumber: "ACC-1001", telephone1: "+1 (425) 555-0100", emailaddress1: "info@contoso.example", websiteurl: "https://contoso.example", revenue: 1500000, statuscode: "Active", rating: 5 },
+  { accountid: "00000000-0000-0000-0000-000000000002", name: "Fabrikam Inc", accountnumber: "ACC-1002", telephone1: "+1 (206) 555-0140", emailaddress1: "hello@fabrikam.example", websiteurl: "https://fabrikam.example", revenue: 220000, statuscode: "On hold", rating: 3 },
+  { accountid: "00000000-0000-0000-0000-000000000003", name: "Adventure Works", accountnumber: "ACC-1003", telephone1: "+1 (312) 555-0190", emailaddress1: "sales@adventure.example", websiteurl: "https://adventure.example", revenue: 85000, statuscode: "Inactive", rating: 2 },
+  { accountid: "00000000-0000-0000-0000-000000000004", name: "Wingtip Toys", accountnumber: "ACC-1004", telephone1: "+1 (646) 555-0177", emailaddress1: "contact@wingtip.example", websiteurl: "https://wingtip.example", revenue: 640000, statuscode: "Active", rating: 4 },
+];
+
+/**
+ * Default mock used on localhost when no token URL is configured. Operations are
+ * routed through `logCrud`, so a starter page shows the same `[CRUD] …` console
+ * lines (and populates `window.dumpAppLogs()`) as a real service.
+ */
+export class MockApiService implements IApiService {
+  private accounts: Record<string, any> = Object.fromEntries(
+    SEED_ACCOUNTS.map((a) => [a.accountid, { ...a }]),
+  );
+  private nextId = SEED_ACCOUNTS.length + 1;
+
+  retrieveMultipleRecords(entity: string): Promise<{ entities: any[] }> {
+    return logCrud(
+      { op: "READ", entity, resultCount: (r) => r?.entities?.length },
+      async () => ({
+        entities: entity === "accounts" ? Object.values(this.accounts) : [],
+      }),
+    );
+  }
+
+  updateRecord(entity: string, id: string, record: any): Promise<any> {
+    return logCrud({ op: "UPDATE", entity, id }, async () => {
+      const key = id.replace(/[{}]/g, "");
+      if (this.accounts[key]) {
+        this.accounts[key] = { ...this.accounts[key], ...record };
+      }
+      return { success: true };
+    });
+  }
+
+  createRecord(entity: string, record: any): Promise<any> {
+    return logCrud({ op: "CREATE", entity, resultId: (r) => r?.id }, async () => {
+      const id = `00000000-0000-0000-0000-${String(this.nextId++).padStart(12, "0")}`;
+      if (entity === "accounts") this.accounts[id] = { accountid: id, ...record };
+      return { id };
+    });
+  }
+
+  deleteRecord(entity: string, id: string): Promise<void> {
+    return logCrud({ op: "DELETE", entity, id }, async () => {
+      delete this.accounts[id.replace(/[{}]/g, "")];
+    });
+  }
+
+  executeRequest(requestName: string): Promise<any> {
+    return logCrud({ op: "EXECUTE", entity: requestName }, async () => ({}));
+  }
+
+  async uploadFile(): Promise<string> {
+    return "";
+  }
+
+  associateRecord(entityName: string, entityId: string): Promise<void> {
+    return logCrud(
+      { op: "ASSOCIATE", entity: entityName, id: entityId },
+      async () => undefined,
+    );
+  }
+}