create-aiaui-module 0.0.0-stage → 0.1.0

package/src/protocol.js

@@ -0,0 +1,98 @@
+import { lstat, open, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+
+import { GeneratorError } from "./errors.js";
+
+const MODULE_ID = /^[A-Za-z][A-Za-z0-9_]*$/;
+
+function validProtocol(value) {
+  return (
+    value &&
+    typeof value === "object" &&
+    !Array.isArray(value) &&
+    value.schemaVersion === 1 &&
+    (value.port === null ||
+      (Number.isInteger(value.port) &&
+        value.port >= 1 &&
+        value.port <= 65535)) &&
+    Array.isArray(value.modules) &&
+    value.modules.every(
+      (module) =>
+        module &&
+        typeof module === "object" &&
+        MODULE_ID.test(module.name) &&
+        typeof module.enabled === "boolean",
+    ) &&
+    new Set(value.modules.map((module) => module.name)).size ===
+      value.modules.length
+  );
+}
+
+export async function registerModule(instanceRoot, moduleId) {
+  const configPath = path.join(instanceRoot, "Config", "AIAUIProtocol.json");
+  const draft = {
+    schemaVersion: 1,
+    port: null,
+    modules: [{ name: moduleId, enabled: false }],
+  };
+  let entry;
+  try {
+    entry = await lstat(configPath);
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  if (!entry) {
+    try {
+      const handle = await open(configPath, "wx");
+      try {
+        await handle.writeFile(JSON.stringify(draft, null, 2) + "\n");
+      } catch (error) {
+        await handle.close();
+        await rm(configPath, { force: true });
+        throw error;
+      }
+      await handle.close();
+      return { configPath, enabled: false, port: null };
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+      entry = await lstat(configPath);
+    }
+  }
+  if (!entry.isFile() || entry.isSymbolicLink()) {
+    throw new GeneratorError(
+      "invalid_protocol",
+      "AIAUIProtocol.json must be a real file",
+    );
+  }
+  let protocol;
+  try {
+    protocol = JSON.parse(await readFile(configPath, "utf8"));
+  } catch (error) {
+    throw new GeneratorError(
+      "invalid_protocol",
+      `AIAUIProtocol.json is not valid JSON: ${error.message}`,
+    );
+  }
+  if (!validProtocol(protocol)) {
+    throw new GeneratorError(
+      "invalid_protocol",
+      "AIAUIProtocol.json must have schemaVersion 1, a port or null, and a modules array",
+    );
+  }
+  const existing = protocol.modules.find((module) => module.name === moduleId);
+  if (existing)
+    return { configPath, enabled: existing.enabled, port: protocol.port };
+  protocol.modules.push({ name: moduleId, enabled: false });
+  const temporary = `${configPath}.${randomUUID()}.tmp`;
+  try {
+    await writeFile(temporary, JSON.stringify(protocol, null, 2) + "\n", {
+      flag: "wx",
+      mode: entry.mode,
+    });
+    await rename(temporary, configPath);
+  } finally {
+    await rm(temporary, { force: true });
+  }
+  return { configPath, enabled: false, port: protocol.port };
+}

package/templates/HelloWorld/README.md

@@ -0,0 +1,5 @@
+# HelloWorld module
+
+This frontend-only template shows a minimal AIAUI module. Edit `resources/src/Hello.ce.vue`, then run `npm install` and `npm run build` inside `resources/` to refresh the prebuilt file. `resources/src/index.ts` remains the module entry. There is intentionally no `api.py`.
+
+Generation creates `PyAIAUI/HelloWorld/` and registers it as disabled in `Config/AIAUIProtocol.json`. Set a port and enable it after integrating the module host.

package/templates/HelloWorld/contractVersion

@@ -0,0 +1 @@
+1

package/templates/HelloWorld/resources/build.mjs

@@ -0,0 +1,9 @@
+import { writeFile } from "node:fs/promises";
+import { build } from "vite";
+
+await build();
+await writeFile(
+  "dist/manifest.json",
+  JSON.stringify({ entry: "modules.js", files: ["modules.js"] }, null, 2) +
+    "\n",
+);

package/templates/HelloWorld/resources/dist/manifest.json

@@ -0,0 +1,6 @@
+{
+  "entry": "modules.js",
+  "files": [
+    "modules.js"
+  ]
+}