@thatopen/services 0.8.0 → 0.9.0

package/src/cli/templates/cloud-component/src/main.ts

@@ -1,70 +1,70 @@
-// Cloud Component Entry Point
-//
-// Your component runs on the server as a Node.js process.
-// The execution engine provides these globals — do NOT import them:
-//
-//   thatOpenServices  — pre-authenticated EngineServicesClient
-//   executionParams   — parameters passed by the caller (shape defined in ../declarations.json)
-//   executionContext  — platform-supplied run context: { projectId?, executionId, toolId, toolVersion }
-//                       Use executionContext.projectId to scope uploads/lookups to the launching project.
-//                       Undefined when the component is run outside a project context.
-//   executionReporter — { message(msg), error(msg), progress(pct) } for live feedback
-//
-// Parameters are declared in `declarations.json` at the project root. That
-// file is bundled alongside this code at publish time so the platform (and
-// the CLI's `thatopen run`) knows which parameters the component accepts
-// and their types. Whenever you add, remove, or rename a parameter in this
-// file you MUST update `declarations.json` to match — `thatopen publish`
-// fails if they drift.
-//
-// Return value — must be { type, message }:
-//   type: "SUCCESS" | "FAIL" | "WARNING"
-
-// Globals injected by the execution engine at runtime — keep these for type checking
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-declare const thatOpenServices: import("@thatopen/services").EngineServicesClient;
-declare const executionParams: Record<string, unknown>;
-declare const executionContext: {
-  projectId?: string;
-  executionId: string;
-  toolId: string;
-  toolVersion: string;
-};
-declare const executionReporter: {
-  message(msg: string): void;
-  error(msg: string): void;
-  progress(pct: number): void;
-};
-
-export async function main() {
-  const projectName = executionParams.projectName as string | undefined;
-  const iterations = Number(executionParams.iterations);
-
-  executionReporter.message(
-    `Starting for "${projectName ?? "(unnamed)"}"`,
-  );
-  executionReporter.message(`Will run ${iterations} iteration(s)`);
-  if (executionContext?.projectId) {
-    executionReporter.message(`Scoped to project ${executionContext.projectId}`);
-  }
-
-  if (!projectName) {
-    return { type: "FAIL", message: "projectName parameter is required" };
-  }
-  if (!Number.isFinite(iterations) || iterations <= 0) {
-    return { type: "FAIL", message: "iterations must be a positive number" };
-  }
-
-  for (let i = 1; i <= iterations; i++) {
-    executionReporter.message(`Iteration ${i} of ${iterations}`);
-    executionReporter.progress(Math.round((i / iterations) * 100));
-    await new Promise((resolve) => setTimeout(resolve, 500));
-  }
-
-  executionReporter.message("All iterations completed");
-
-  return {
-    type: "SUCCESS",
-    message: `Processed "${projectName}" across ${iterations} iteration(s)`,
-  };
-}
+// Cloud Component Entry Point
+//
+// Your component runs on the server as a Node.js process.
+// The execution engine provides these globals — do NOT import them:
+//
+//   thatOpenServices  — pre-authenticated EngineServicesClient
+//   executionParams   — parameters passed by the caller (shape defined in ../declarations.json)
+//   executionContext  — platform-supplied run context: { projectId?, executionId, toolId, toolVersion }
+//                       Use executionContext.projectId to scope uploads/lookups to the launching project.
+//                       Undefined when the component is run outside a project context.
+//   executionReporter — { message(msg), error(msg), progress(pct) } for live feedback
+//
+// Parameters are declared in `declarations.json` at the project root. That
+// file is bundled alongside this code at publish time so the platform (and
+// the CLI's `thatopen run`) knows which parameters the component accepts
+// and their types. Whenever you add, remove, or rename a parameter in this
+// file you MUST update `declarations.json` to match — `thatopen publish`
+// fails if they drift.
+//
+// Return value — must be { type, message }:
+//   type: "SUCCESS" | "FAIL" | "WARNING"
+
+// Globals injected by the execution engine at runtime — keep these for type checking
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+declare const thatOpenServices: import("@thatopen/services").EngineServicesClient;
+declare const executionParams: Record<string, unknown>;
+declare const executionContext: {
+  projectId?: string;
+  executionId: string;
+  toolId: string;
+  toolVersion: string;
+};
+declare const executionReporter: {
+  message(msg: string): void;
+  error(msg: string): void;
+  progress(pct: number): void;
+};
+
+export async function main() {
+  const projectName = executionParams.projectName as string | undefined;
+  const iterations = Number(executionParams.iterations);
+
+  executionReporter.message(
+    `Starting for "${projectName ?? "(unnamed)"}"`,
+  );
+  executionReporter.message(`Will run ${iterations} iteration(s)`);
+  if (executionContext?.projectId) {
+    executionReporter.message(`Scoped to project ${executionContext.projectId}`);
+  }
+
+  if (!projectName) {
+    return { type: "FAIL", message: "projectName parameter is required" };
+  }
+  if (!Number.isFinite(iterations) || iterations <= 0) {
+    return { type: "FAIL", message: "iterations must be a positive number" };
+  }
+
+  for (let i = 1; i <= iterations; i++) {
+    executionReporter.message(`Iteration ${i} of ${iterations}`);
+    executionReporter.progress(Math.round((i / iterations) * 100));
+    await new Promise((resolve) => setTimeout(resolve, 500));
+  }
+
+  executionReporter.message("All iterations completed");
+
+  return {
+    type: "SUCCESS",
+    message: `Processed "${projectName}" across ${iterations} iteration(s)`,
+  };
+}

package/src/cli/templates/cloud-component/tsconfig.json

@@ -1,16 +1,16 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020"],
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "strict": true
-  },
-  "include": ["src"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "strict": true
+  },
+  "include": ["src"]
+}

package/src/cli/templates/cloud-component/vite.config.js

@@ -1,46 +1,46 @@
-// Production build config — builds dist/bundle.js as IIFE.
-// For local development, use: npm run dev (runs thatopen serve with esbuild).
-// Do NOT run "vite" or "vite build --watch" directly for dev.
-import { defineConfig } from 'vite';
-import { resolve } from 'path';
-import { existsSync, readFileSync } from 'fs';
-
-function getBetaAliases() {
-  if (!existsSync('.thatopen')) return {};
-  try {
-    const config = JSON.parse(readFileSync('.thatopen', 'utf-8'));
-    if (!config.beta) return {};
-    return {
-      '@thatopen/components': '@thatopen-platform/components-beta',
-      '@thatopen/components-front': '@thatopen-platform/components-front-beta',
-      '@thatopen/fragments': '@thatopen-platform/fragments-beta',
-    };
-  } catch {
-    return {};
-  }
-}
-
-export default defineConfig({
-  resolve: {
-    alias: getBetaAliases(),
-  },
-  build: {
-    lib: {
-      entry: resolve(__dirname, 'src/main.ts'),
-      name: 'ThatOpenComponent',
-      formats: ['iife'],
-      fileName: () => 'bundle.js',
-    },
-    outDir: 'dist',
-    rollupOptions: {
-      // Only @thatopen/services is externalized — the execution wrapper
-      // provides it at runtime via require('@thatopen/services'). Every
-      // other dependency (including @thatopen/components, three, web-ifc,
-      // or any npm package you install) must be bundled into bundle.js.
-      external: ['@thatopen/services'],
-      output: {
-        footer: 'var main = ThatOpenComponent.main;',
-      },
-    },
-  },
-});
+// Production build config — builds dist/bundle.js as IIFE.
+// For local development, use: npm run dev (runs thatopen serve with esbuild).
+// Do NOT run "vite" or "vite build --watch" directly for dev.
+import { defineConfig } from 'vite';
+import { resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+
+function getBetaAliases() {
+  if (!existsSync('.thatopen')) return {};
+  try {
+    const config = JSON.parse(readFileSync('.thatopen', 'utf-8'));
+    if (!config.beta) return {};
+    return {
+      '@thatopen/components': '@thatopen-platform/components-beta',
+      '@thatopen/components-front': '@thatopen-platform/components-front-beta',
+      '@thatopen/fragments': '@thatopen-platform/fragments-beta',
+    };
+  } catch {
+    return {};
+  }
+}
+
+export default defineConfig({
+  resolve: {
+    alias: getBetaAliases(),
+  },
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/main.ts'),
+      name: 'ThatOpenComponent',
+      formats: ['iife'],
+      fileName: () => 'bundle.js',
+    },
+    outDir: 'dist',
+    rollupOptions: {
+      // Only @thatopen/services is externalized — the execution wrapper
+      // provides it at runtime via require('@thatopen/services'). Every
+      // other dependency (including @thatopen/components, three, web-ifc,
+      // or any npm package you install) must be bundled into bundle.js.
+      external: ['@thatopen/services'],
+      output: {
+        footer: 'var main = ThatOpenComponent.main;',
+      },
+    },
+  },
+});

package/src/cli/templates/shared/AGENTS.md

@@ -1,8 +1,8 @@
-# That Open Platform — Agent Guide
-
-Read these two files before doing anything else:
-
-1. `node_modules/@thatopen/services/resources/AGENTS.md` — rules, hard constraints, and the full navigation table for the That Open Platform. Always current for the installed library version.
-2. `README.md` (this folder) — what this specific project is, its commands, architecture, and patterns.
-
-If `node_modules/` doesn't exist yet, run `npm install` first or ask the user to do it.
+# That Open Platform — Agent Guide
+
+Read these two files before doing anything else:
+
+1. `node_modules/@thatopen/services/resources/AGENTS.md` — rules, hard constraints, and the full navigation table for the That Open Platform. Always current for the installed library version.
+2. `README.md` (this folder) — what this specific project is, its commands, architecture, and patterns.
+
+If `node_modules/` doesn't exist yet, run `npm install` first or ask the user to do it.

package/src/cli/templates/shared/CLAUDE.md

@@ -1 +1 @@
-See [AGENTS.md](./AGENTS.md).
+See [AGENTS.md](./AGENTS.md).

package/src/cli/templates/shared/_gitignore

@@ -1,5 +1,5 @@
-node_modules
-dist
-*.zip
-.thatopen
-.npmrc
+node_modules
+dist
+*.zip
+.thatopen
+.npmrc