@olenbetong/appframe-vite 6.1.2 → 6.2.0

package/README.md

@@ -80,12 +80,122 @@ This package reads `package.json.appframe` to know what to proxy and how to buil
 - Resolve
 	- Adds the alias `~/` to `/src/` so imports like `~/components/Button` resolve to `src/components/Button`.
 
-## Exported helpers
+## CLI — `appframe-vite`
 
-Although most users only need the default plugin, the package also exports:
+The package ships a CLI (`appframe-vite`) alongside the Vite plugin.
 
-- `addAppframeBuildConfig(config)`: applies the Appframe build defaults (paths, externals, visualizer).
-- `createDevMiddleware(server)`: serves transformed article HTML and injects cached i18n strings.
+### `generate-types`
+
+Generates TypeScript type definitions from the article's data objects and procedures:
+
+```sh
+appframe-vite generate-types
+```
+
+### `resources generate`
+
+Reads `resources.yaml` and regenerates all data object / procedure files:
+
+```sh
+appframe-vite resources generate
+# custom config file path:
+appframe-vite resources generate --config path/to/resources.yaml
+```
+
+### `resources add`
+
+Interactive wizard — prompts for resource, ID, output path, permissions, fields, and more, then appends an entry to `resources.yaml` and generates the output file:
+
+```sh
+appframe-vite resources add
+```
+
+### `resources edit [id]`
+
+Interactive editor — pre-fills the wizard with the current values from `resources.yaml` and regenerates the file on save:
+
+```sh
+appframe-vite resources edit dsAccountGroups
+# or without an id (shows a searchable list):
+appframe-vite resources edit
+```
+
+## `resources.yaml` config file
+
+Place `resources.yaml` at the project root to declare all data objects and procedures for an app. The Vite dev server watches this file and auto-regenerates all output files when it changes.
+
+**Example:**
+
+```yaml
+dataObjects:
+  - id: dsAccountGroups
+    resource: atbv_Accounting_SubsidiaryLedgerGroups
+    global: true
+    types: true
+    maxRecords: -1
+    expose: true
+    fields:
+      - Domain
+      - SubsidiaryLedgerGroup
+      - PrimKey
+      - Description
+    output: src/data/dsAccountGroups.ts
+
+  - id: dsSubsidiaryLedger
+    resource: atbv_Accounting_SubsidiaryLedger
+    global: true
+    types: true
+    permissions: IUD
+    output: src/data/dsSubsidiaryLedger.ts
+
+procedures:
+  - id: procCreateCustomer
+    resource: astp_Accounting_SubsidiaryLedger_Create
+    global: true
+    types: true
+    expose: true
+    output: src/data/procCreateCustomer.ts
+```
+
+**Supported fields per entry:**
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | `string` | Variable name used in generated code (e.g. `dsAccountGroups`) |
+| `resource` | `string` | Database object ID (e.g. `atbv_Accounting_SubsidiaryLedgerGroups`) |
+| `output` | `string` | Output file path relative to project root |
+| `global` | `boolean` | Use `af.data.generateApiDataObject` / `new af.ProcedureAPI` globals |
+| `types` | `boolean` | Emit TypeScript type definitions |
+| `permissions` | `string` | Permissions: I = insert, U = update, D = delete (e.g. `IUD`) |
+| `maxRecords` | `number` | Max records to fetch (default `50`; `-1` for all) |
+| `sortOrder` | `string \| string[]` | Sort order, e.g. `Created:Desc` or `[Created:Desc, Name]` |
+| `master` | `string` | Master data object name (or `name:importPath`) |
+| `linkFields` | `string \| string[]` | Fields linking child to master |
+| `expose` | `boolean \| string` | Expose on `af.article.dataObjects` / `af.article.procedures` |
+| `dynamic` | `boolean` | Enable dynamic loading |
+| `unique` | `string` | Unique table name for update/delete |
+| `overrides` | `string \| string[]` | Type overrides, e.g. `MyField:string[]` |
+| `distinct` | `boolean` | Fetch distinct rows |
+| `aggregates` | `string \| string[]` | Aggregate bindings, e.g. `Qty:SUM` |
+| `groupBy` | `string \| string[]` | Group-by fields |
+| `where` | `string` | Initial where clause |
+| `fields` | `string \| string[]` | Fields to include (all if omitted) |
+
+A top-level `server` key can override the hostname (defaults to `appframe.proxy.hostname` from `package.json`).
+
+## `@olenbetong/appframe-vite/resources` export
+
+Shared code generation utilities for Node.js consumers:
+
+```ts
+import {
+  fetchAndGenerate,
+  buildYamlConfig,
+  parseYamlConfig,
+  formatWithBiome,
+  getCustomImportPath,
+  type CLIOptions,
+} from "@olenbetong/appframe-vite/resources";
+```
 
-See `docs/reference/appframe-vite/` for a deeper dive into internals and configuration.
 

package/lib/cli-resources-add.d.ts

@@ -0,0 +1 @@
+export declare function addResource(): Promise<void>;

package/lib/cli-resources-add.js

@@ -0,0 +1,184 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+import { Client, generateApiDataHandler } from "@olenbetong/appframe-data";
+import { config } from "dotenv";
+import fuzzy from "fuzzy";
+import inquirer from "inquirer";
+import autocomplete from "inquirer-autocomplete-standalone";
+import { getLoginInfo } from "./devServer.js";
+import { fetchAndGenerate, fetchResourceDefinition, formatWithBiome } from "./resourceGenerate.js";
+import { entryToCLIOptions, readResourcesConfig, writeResourcesConfig } from "./resourcesConfig.js";
+config({ quiet: true });
+async function getResources(client) {
+    let ds = generateApiDataHandler({
+        client,
+        resource: "API_Resources",
+        fields: [
+            { name: "DBObjectID", type: "string", nullable: false },
+            { name: "Name", type: "string", nullable: true },
+            { name: "ObjectType", type: "string", nullable: true },
+        ],
+    });
+    return ds.retrieve({ maxRecords: -1 });
+}
+export async function addResource() {
+    let { hostname, username, password } = await getLoginInfo();
+    let client = new Client(hostname);
+    await client.login(username, password);
+    // Step 1: pick a resource
+    let resources = await getResources(client);
+    let resourceChoices = resources.map((r) => ({
+        name: r.Name && r.Name !== r.DBObjectID ? `${r.DBObjectID} / ${r.Name}` : r.DBObjectID,
+        value: r.DBObjectID,
+        objectType: r.ObjectType,
+    }));
+    let chosenResource = await autocomplete({
+        message: "Select a resource",
+        source: async (input) => {
+            return fuzzy
+                .filter(input ?? "", resourceChoices, { extract: (el) => el.name })
+                .map((el) => ({ name: el.original.name, value: el.original.value }));
+        },
+    });
+    let chosenMeta = resourceChoices.find((r) => r.value === chosenResource);
+    let isView = chosenMeta?.objectType === "V";
+    // Fetch definition for field picker
+    let definition = await fetchResourceDefinition(client, chosenResource);
+    let allFields = definition.Parameters?.filter((p) => !["CUT", "CDL"].includes(p.Name)).map((p) => isView ? p.Name : p.ParamName) ?? [];
+    // Step 2: choose ID
+    let defaultId = isView
+        ? `ds${chosenResource.replace(/^a[a-z]+_[A-Za-z]+_/, "")}`
+        : `proc${chosenResource.replace(/^astp_[A-Za-z]+_/, "")}`;
+    let { id } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "id",
+            message: "Data object / procedure ID",
+            default: defaultId,
+        },
+    ]);
+    // Step 3: output path
+    let defaultOutput = `src/data/${id}.ts`;
+    let { output } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "output",
+            message: "Output file path (relative to project root)",
+            default: defaultOutput,
+        },
+    ]);
+    // Step 4: global vs module imports
+    let { useGlobal } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "useGlobal",
+            message: "Use global af.data / af.ProcedureAPI (instead of ES imports)?",
+            default: true,
+        },
+    ]);
+    // Step 5: TypeScript types
+    let { withTypes } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "withTypes",
+            message: "Generate TypeScript type definitions?",
+            default: true,
+        },
+    ]);
+    // Step 6: expose
+    let { exposeIt } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "exposeIt",
+            message: `Expose on af.article.${isView ? "dataObjects" : "procedures"}?`,
+            default: false,
+        },
+    ]);
+    // View-specific options
+    let permissions;
+    let maxRecords = "50";
+    let selectedFields = [];
+    let sortOrder;
+    if (isView) {
+        // Permissions
+        let { permInput } = await inquirer.prompt([
+            {
+                type: "checkbox",
+                name: "permInput",
+                message: "Permissions",
+                choices: [
+                    { name: "Insert (I)", value: "I" },
+                    { name: "Update (U)", value: "U" },
+                    { name: "Delete (D)", value: "D" },
+                ],
+            },
+        ]);
+        permissions = permInput.length > 0 ? permInput.join("") : undefined;
+        // Max records
+        let { maxRec } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "maxRec",
+                message: "Max records (-1 for all)",
+                default: "50",
+                validate: (v) => (!Number.isNaN(Number(v)) ? true : "Must be a number"),
+            },
+        ]);
+        maxRecords = maxRec;
+        // Field picker
+        if (allFields.length > 0) {
+            let { fields } = await inquirer.prompt([
+                {
+                    type: "checkbox",
+                    name: "fields",
+                    message: "Select fields to include (leave all unchecked to include all)",
+                    choices: allFields,
+                },
+            ]);
+            selectedFields = fields;
+        }
+        // Sort order
+        let { sortInput } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "sortInput",
+                message: "Sort order (e.g. Created:Desc,Name — leave blank for none)",
+                default: "",
+            },
+        ]);
+        sortOrder = sortInput || undefined;
+    }
+    // Build entry
+    let relativeOutput = relative(process.cwd(), resolve(process.cwd(), output)).replace(/\\/g, "/");
+    let entry = {
+        id,
+        resource: chosenResource,
+        output: relativeOutput,
+        global: useGlobal || undefined,
+        types: withTypes || undefined,
+        expose: exposeIt || undefined,
+        permissions: permissions,
+        maxRecords: maxRecords !== "50" ? Number(maxRecords) : undefined,
+        sortOrder: sortOrder ? sortOrder.split(",") : undefined,
+        fields: selectedFields.length > 0 ? selectedFields : undefined,
+    };
+    // Write to resources.yaml
+    let config2 = await readResourcesConfig();
+    if (isView) {
+        config2.dataObjects = [...(config2.dataObjects ?? []), entry];
+    }
+    else {
+        config2.procedures = [...(config2.procedures ?? []), entry];
+    }
+    await writeResourcesConfig(config2);
+    console.log(`Added '${id}' to resources.yaml`);
+    // Generate the file
+    let options = entryToCLIOptions(entry, hostname);
+    options.output = resolve(process.cwd(), output);
+    let content = await fetchAndGenerate(chosenResource, options, client);
+    let outputPath = resolve(process.cwd(), output);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, content, "utf-8");
+    await formatWithBiome(outputPath);
+    console.log(`Generated ${output}`);
+}

package/lib/cli-resources-edit.d.ts

@@ -0,0 +1 @@
+export declare function editResource(id?: string): Promise<void>;

package/lib/cli-resources-edit.js

@@ -0,0 +1,177 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve } from "node:path";
+import { Client } from "@olenbetong/appframe-data";
+import { config } from "dotenv";
+import fuzzy from "fuzzy";
+import inquirer from "inquirer";
+import autocomplete from "inquirer-autocomplete-standalone";
+import { getLoginInfo } from "./devServer.js";
+import { fetchAndGenerate, fetchResourceDefinition, formatWithBiome } from "./resourceGenerate.js";
+import { entryToCLIOptions, readResourcesConfig, writeResourcesConfig } from "./resourcesConfig.js";
+config({ quiet: true });
+export async function editResource(id) {
+    let resourcesConfig = await readResourcesConfig();
+    let allEntries = [
+        ...(resourcesConfig.dataObjects ?? []).map((e) => ({ isView: true, entry: e })),
+        ...(resourcesConfig.procedures ?? []).map((e) => ({ isView: false, entry: e })),
+    ];
+    if (allEntries.length === 0) {
+        console.error("No resources found in resources.yaml. Run 'appframe-vite resources add' to add one.");
+        process.exit(1);
+    }
+    // Select entry to edit
+    let selected;
+    if (id) {
+        let found = allEntries.find((e) => e.entry.id === id);
+        if (!found) {
+            console.error(`No resource with id '${id}' found in resources.yaml.`);
+            process.exit(1);
+        }
+        selected = found;
+    }
+    else {
+        let entryChoices = allEntries.map((e) => ({
+            name: `${e.isView ? "[view]" : "[proc]"} ${e.entry.id} (${e.entry.resource})`,
+            value: e.entry.id,
+        }));
+        let chosenId = await autocomplete({
+            message: "Select a resource to edit",
+            source: async (input) => {
+                return fuzzy
+                    .filter(input ?? "", entryChoices, { extract: (el) => el.name })
+                    .map((el) => ({ name: el.original.name, value: el.original.value }));
+            },
+        });
+        selected = allEntries.find((e) => e.entry.id === chosenId);
+    }
+    let { entry, isView } = selected;
+    let { hostname, username, password } = await getLoginInfo();
+    let client = new Client(hostname);
+    await client.login(username, password);
+    // Fetch definition for field picker
+    let definition = await fetchResourceDefinition(client, entry.resource);
+    let allFields = definition.Parameters?.filter((p) => !["CUT", "CDL"].includes(p.Name)).map((p) => isView ? p.Name : p.ParamName) ?? [];
+    let currentFields = Array.isArray(entry.fields) ? entry.fields : (entry.fields?.split(",").filter(Boolean) ?? []);
+    // Re-run wizard pre-filled with current values
+    let { id: newId } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "id",
+            message: "Data object / procedure ID",
+            default: entry.id,
+        },
+    ]);
+    let { output } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "output",
+            message: "Output file path (relative to project root)",
+            default: entry.output,
+        },
+    ]);
+    let { useGlobal } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "useGlobal",
+            message: "Use global af.data / af.ProcedureAPI?",
+            default: entry.global ?? false,
+        },
+    ]);
+    let { withTypes } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "withTypes",
+            message: "Generate TypeScript type definitions?",
+            default: entry.types ?? false,
+        },
+    ]);
+    let { exposeIt } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "exposeIt",
+            message: `Expose on af.article.${isView ? "dataObjects" : "procedures"}?`,
+            default: !!entry.expose,
+        },
+    ]);
+    let permissions = entry.permissions;
+    let maxRecords = String(entry.maxRecords ?? 50);
+    let selectedFields = currentFields;
+    let sortOrder = Array.isArray(entry.sortOrder) ? entry.sortOrder.join(",") : entry.sortOrder;
+    if (isView) {
+        let currentPerms = entry.permissions ?? "";
+        let { permInput } = await inquirer.prompt([
+            {
+                type: "checkbox",
+                name: "permInput",
+                message: "Permissions",
+                choices: [
+                    { name: "Insert (I)", value: "I", checked: currentPerms.includes("I") },
+                    { name: "Update (U)", value: "U", checked: currentPerms.includes("U") },
+                    { name: "Delete (D)", value: "D", checked: currentPerms.includes("D") },
+                ],
+            },
+        ]);
+        permissions = permInput.length > 0 ? permInput.join("") : undefined;
+        let { maxRec } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "maxRec",
+                message: "Max records (-1 for all)",
+                default: String(entry.maxRecords ?? 50),
+                validate: (v) => (!Number.isNaN(Number(v)) ? true : "Must be a number"),
+            },
+        ]);
+        maxRecords = maxRec;
+        if (allFields.length > 0) {
+            let { fields } = await inquirer.prompt([
+                {
+                    type: "checkbox",
+                    name: "fields",
+                    message: "Select fields to include (leave all unchecked to include all)",
+                    choices: allFields.map((f) => ({ name: f, checked: currentFields.includes(f) })),
+                },
+            ]);
+            selectedFields = fields;
+        }
+        let { sortInput } = await inquirer.prompt([
+            {
+                type: "input",
+                name: "sortInput",
+                message: "Sort order (e.g. Created:Desc,Name — leave blank for none)",
+                default: sortOrder ?? "",
+            },
+        ]);
+        sortOrder = sortInput || undefined;
+    }
+    let relativeOutput = relative(process.cwd(), resolve(process.cwd(), output)).replace(/\\/g, "/");
+    let updatedEntry = {
+        id: newId,
+        resource: entry.resource,
+        output: relativeOutput,
+        global: useGlobal || undefined,
+        types: withTypes || undefined,
+        expose: exposeIt || undefined,
+        permissions,
+        maxRecords: maxRecords !== "50" ? Number(maxRecords) : undefined,
+        sortOrder: sortOrder ? sortOrder.split(",") : undefined,
+        fields: selectedFields.length > 0 ? selectedFields : undefined,
+    };
+    // Update resources.yaml
+    if (isView) {
+        resourcesConfig.dataObjects = (resourcesConfig.dataObjects ?? []).map((e) => e.id === entry.id ? updatedEntry : e);
+    }
+    else {
+        resourcesConfig.procedures = (resourcesConfig.procedures ?? []).map((e) => (e.id === entry.id ? updatedEntry : e));
+    }
+    await writeResourcesConfig(resourcesConfig);
+    console.log(`Updated '${newId}' in resources.yaml`);
+    // Regenerate
+    let options = entryToCLIOptions(updatedEntry, hostname);
+    options.output = resolve(process.cwd(), output);
+    let content = await fetchAndGenerate(entry.resource, options, client);
+    let outputPath = resolve(process.cwd(), output);
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, content, "utf-8");
+    await formatWithBiome(outputPath);
+    console.log(`Regenerated ${output}`);
+}

package/lib/cli-resources-generate.d.ts

@@ -0,0 +1 @@
+export declare function generateFromConfig(configPath?: string): Promise<void>;

package/lib/cli-resources-generate.js

@@ -0,0 +1,44 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { Client } from "@olenbetong/appframe-data";
+import { config } from "dotenv";
+import { getLoginInfo } from "./devServer.js";
+import { fetchAndGenerate, formatWithBiome } from "./resourceGenerate.js";
+import { entryToCLIOptions, readResourcesConfig } from "./resourcesConfig.js";
+config({ quiet: true });
+export async function generateFromConfig(configPath) {
+    let { hostname, username, password } = await getLoginInfo();
+    let resourcesConfig = await readResourcesConfig(configPath);
+    let allEntries = [
+        ...(resourcesConfig.dataObjects ?? []).map((e) => ({ type: "dataObject", entry: e })),
+        ...(resourcesConfig.procedures ?? []).map((e) => ({ type: "procedure", entry: e })),
+    ];
+    if (allEntries.length === 0) {
+        console.log("No resources found in resources.yaml");
+        return;
+    }
+    let client = new Client(hostname);
+    await client.login(username, password);
+    let errors = [];
+    for (let { entry } of allEntries) {
+        let options = entryToCLIOptions(entry, resourcesConfig.server ?? hostname);
+        options.output = resolve(process.cwd(), entry.output);
+        try {
+            let content = await fetchAndGenerate(entry.resource, options, client);
+            let outputPath = resolve(process.cwd(), entry.output);
+            await mkdir(dirname(outputPath), { recursive: true });
+            await writeFile(outputPath, content, "utf-8");
+            await formatWithBiome(outputPath);
+            console.log(`  ✓ ${entry.id} → ${entry.output}`);
+        }
+        catch (error) {
+            let message = error?.message ?? String(error);
+            console.error(`  ✗ ${entry.id}: ${message}`);
+            errors.push({ id: entry.id, error: message });
+        }
+    }
+    if (errors.length > 0) {
+        console.error(`\n${errors.length} resource(s) failed to generate.`);
+        process.exit(1);
+    }
+}

package/lib/cli.js

@@ -1,29 +1,53 @@
 #!/usr/bin/env node
+import { Command } from "commander";
 import { config } from "dotenv";
 import { runGenerateTypes } from "./generateTypes.js";
 import { importJson } from "./importJson.js";
 import { createLogMessage } from "./utils.js";
+config({ path: `${process.cwd()}/.env`, quiet: true });
+const pkg = await importJson("../package.json");
+// ---------------------------------------------------------------------------
+// generate-types
+// ---------------------------------------------------------------------------
 async function generateTypes() {
-    config({ path: `${process.cwd()}/.env`, quiet: true });
-    const pkg = await importJson("./package.json", true);
-    const hostname = pkg.appframe.proxy?.hostname ?? "dev.obet.no";
+    const appPkg = await importJson("./package.json", true);
+    const hostname = appPkg.appframe.proxy?.hostname ?? "dev.obet.no";
     const { APPFRAME_LOGIN: username = "", APPFRAME_PWD: password = "" } = process.env;
     const logger = {
         info: (msg) => console.log(msg),
         error: (msg) => console.error(msg),
     };
     logger.info(createLogMessage("Generating types…", { source: hostname }));
-    await runGenerateTypes(hostname, username, password, pkg.appframe, logger);
-}
-const [, , command] = process.argv;
-switch (command) {
-    case "generate-types":
-        await generateTypes();
-        break;
-    default:
-        console.error(createLogMessage(`Unknown command: ${command ?? "(none)"}`, { type: "error" }));
-        console.error("Usage: appframe-vite <command>");
-        console.error("Commands:");
-        console.error("  generate-types  Generate TypeScript type definitions");
-        process.exit(1);
+    await runGenerateTypes(hostname, username, password, appPkg.appframe, logger);
 }
+// ---------------------------------------------------------------------------
+// Program
+// ---------------------------------------------------------------------------
+const program = new Command();
+program.name("appframe-vite").version(pkg.version).description("Appframe Vite tooling CLI");
+program.command("generate-types").description("Generate TypeScript type definitions").action(generateTypes);
+// resources sub-command
+const resources = program.command("resources").description("Manage data objects and procedures via resources.yaml");
+resources
+    .command("generate")
+    .description("Generate all output files from resources.yaml")
+    .option("-c, --config <path>", "Path to resources config file (default: resources.yaml)")
+    .action(async (opts) => {
+    let { generateFromConfig } = await import("./cli-resources-generate.js");
+    await generateFromConfig(opts.config);
+});
+resources
+    .command("add")
+    .description("Interactively add a data object or procedure to resources.yaml")
+    .action(async () => {
+    let { addResource } = await import("./cli-resources-add.js");
+    await addResource();
+});
+resources
+    .command("edit [id]")
+    .description("Interactively edit an existing resource in resources.yaml")
+    .action(async (id) => {
+    let { editResource } = await import("./cli-resources-edit.js");
+    await editResource(id);
+});
+await program.parseAsync(process.argv);

package/lib/index.js

@@ -1,16 +1,21 @@
+import { resolve } from "node:path";
 import bodyParser from "body-parser";
 import { watch } from "chokidar";
 import { addAppframeBuildConfig } from "./build.js";
+import { generateFromConfig } from "./cli-resources-generate.js";
 import { createDevMiddleware, getLoginInfo, getProxyRoutes } from "./devServer.js";
 import { runGenerateTypes } from "./generateTypes.js";
 import { localizeMiddleware } from "./localization.js";
 import { checkSession, getLastSession, login } from "./proxy.js";
+import { RESOURCES_CONFIG_FILE } from "./resourcesConfig.js";
 import { createLogMessage, getServerName } from "./utils.js";
 let command = "build";
 let interval;
 let server;
 let lastHostname;
 let watcher;
+let resourcesWatcher = null;
+let resourcesDebounce = null;
 try {
     let appPkgUrl = `file://${process.cwd()}/package.json`;
     watcher = watch(appPkgUrl).on("all", async () => {
@@ -139,6 +144,28 @@ export default function appframe() {
             server = _server;
             // Run type generation in the background — doesn't block the dev server from starting.
             runGenerateTypes(hostname, username, password, appframe, _server.config.logger);
+            // Watch resources.yaml and regenerate on change
+            let resourcesConfigPath = resolve(process.cwd(), RESOURCES_CONFIG_FILE);
+            if (resourcesWatcher) {
+                await resourcesWatcher.close();
+            }
+            resourcesWatcher = watch(resourcesConfigPath, { ignoreInitial: true }).on("all", () => {
+                if (resourcesDebounce)
+                    clearTimeout(resourcesDebounce);
+                resourcesDebounce = setTimeout(async () => {
+                    _server.config.logger.info(createLogMessage("resources.yaml changed — regenerating…", { source: hostname }));
+                    try {
+                        await generateFromConfig();
+                        _server.config.logger.info(createLogMessage("resources regenerated", { source: hostname }));
+                    }
+                    catch (error) {
+                        _server.config.logger.error(createLogMessage(`resources regeneration failed: ${error?.message ?? error}`, {
+                            source: hostname,
+                            type: "error",
+                        }));
+                    }
+                }, 300);
+            });
             _server.middlewares.use(`/api/user/localize/new/${appframe.article.id}`, jsonParser);
             _server.middlewares.use(`/api/user/localize/new/${appframe.article.id}`, localizeMiddleware);
             _server.middlewares.use("/data/Logger/LogError", jsonParser);