reset-framework-cli 1.2.0 → 1.2.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Jan Kordoš
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to do so, subject to the
-following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026 Jan Kordoš
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,21 +1,21 @@
-# reset-framework-cli
-
-`reset-framework-cli` is the developer-facing command-line interface for Reset Framework.
-
-## Install
-
-```bash
-npm install -g reset-framework-cli
-```
-
-## Commands
-
-- `reset-framework-cli create-app my-app`
-- `reset-framework-cli dev`
-- `reset-framework-cli build`
-- `reset-framework-cli package`
-- `reset-framework-cli doctor`
-
+# reset-framework-cli
+
+`reset-framework-cli` is the developer-facing command-line interface for Reset Framework.
+
+## Install
+
+```bash
+npm install -g reset-framework-cli
+```
+
+## Commands
+
+- `reset-framework-cli create-app my-app`
+- `reset-framework-cli dev`
+- `reset-framework-cli build`
+- `reset-framework-cli package`
+- `reset-framework-cli doctor`
+
 ## Package boundary
 
 - `reset-framework-cli` orchestrates the framework.
@@ -23,7 +23,7 @@ npm install -g reset-framework-cli
 - `@reset-framework/native` provides the CMake-based runtime source package.
 - `@reset-framework/sdk` provides the frontend bridge package.
 - `@reset-framework/schema` provides the config schema package.
-
+
 ## How it works
 
 - `reset-framework-cli dev` and `reset-framework-cli build` use the bundled runtime package for the current platform by default.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reset-framework-cli",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "type": "module",
   "description": "Command-line tooling for Reset Framework.",
   "license": "MIT",
@@ -11,13 +11,15 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@reset-framework/schema": "1.2.0",
-    "@reset-framework/sdk": "1.2.0"
+    "@reset-framework/backend": "1.2.2",
+    "@reset-framework/schema": "1.2.2",
+    "@reset-framework/sdk": "1.2.2",
+    "esbuild": "^0.25.10"
   },
   "optionalDependencies": {
-    "@reset-framework/runtime-darwin-arm64": "1.2.0",
-    "@reset-framework/runtime-darwin-x64": "1.2.0",
-    "@reset-framework/runtime-win32-x64": "1.2.0"
+    "@reset-framework/runtime-darwin-arm64": "1.2.2",
+    "@reset-framework/runtime-darwin-x64": "1.2.2",
+    "@reset-framework/runtime-win32-x64": "1.2.2"
   },
   "bin": {
     "reset-framework-cli": "src/index.js"

package/src/commands/build.js

@@ -1,65 +1,70 @@
 import { prepareFrameworkRuntime } from "../lib/framework.js"
-import { stageMacOSAppBundle, stageWindowsAppBundle } from "../lib/output.js"
-import { resolvePackageManagerCommand, runCommand } from "../lib/process.js"
-import {
-  assertAppProject,
-  assertFrameworkInstall,
-  loadResetConfig,
-  resolveAppOutputPaths,
-  resolveAppPaths,
-  resolveAppPackageManager,
+import { prepareAppBackend } from "../lib/backend.js"
+import { stageMacOSAppBundle, stageWindowsAppBundle } from "../lib/output.js"
+import { resolvePackageManagerCommand, runCommand } from "../lib/process.js"
+import {
+  assertAppProject,
+  assertFrameworkInstall,
+  loadResetConfig,
+  resolveAppOutputPaths,
+  resolveAppPaths,
+  resolveAppPackageManager,
   resolveConfigPath,
   resolveFrontendDir,
   resolveFrameworkBuildPaths,
   resolveFrameworkRuntimeStrategy,
-  resolveFrameworkPaths
+  resolveFrameworkPaths,
+  resolveOptionalBackendEntry
 } from "../lib/project.js"
-import {
-  createProgress,
-  printBanner,
-  printKeyValueTable,
-  printSection,
-  printStatusTable
-} from "../lib/ui.js"
-
-export const description = "Build the frontend, runtime, and final desktop app bundle"
-
-export async function run(context) {
+import {
+  createProgress,
+  printBanner,
+  printKeyValueTable,
+  printSection,
+  printStatusTable
+} from "../lib/ui.js"
+
+export const description = "Build the frontend, runtime, and final desktop app bundle"
+
+export async function run(context) {
   const dryRun = Boolean(context.flags["dry-run"])
   const skipFrontend = Boolean(context.flags["skip-frontend"])
   const skipRuntime = Boolean(context.flags["skip-runtime"])
   const skipStage = Boolean(context.flags["skip-stage"])
   const preferSource = Boolean(context.flags["runtime-source"])
-
-  const appPaths = resolveAppPaths(context.projectRoot)
-  const frameworkPaths = resolveFrameworkPaths()
-  assertAppProject(appPaths)
-  assertFrameworkInstall(frameworkPaths)
-  const config = loadResetConfig(appPaths)
-  assertAppProject(appPaths, config)
-  const packageManager = resolveAppPackageManager(appPaths, config)
+
+  const appPaths = resolveAppPaths(context.projectRoot)
+  const frameworkPaths = resolveFrameworkPaths()
+  assertAppProject(appPaths)
+  assertFrameworkInstall(frameworkPaths)
+  const config = loadResetConfig(appPaths)
+  assertAppProject(appPaths, config)
+  const packageManager = resolveAppPackageManager(appPaths, config)
   const outputPaths = resolveAppOutputPaths(appPaths, config)
   const configPath = resolveConfigPath(appPaths)
   const frontendDir = resolveFrontendDir(appPaths, config)
+  const backendEntry = resolveOptionalBackendEntry(appPaths)
   const frameworkBuildPaths = resolveFrameworkBuildPaths(appPaths)
   const runtimeStrategy = resolveFrameworkRuntimeStrategy(frameworkPaths, { preferSource })
   const steps = [
     !skipFrontend ? "Build frontend" : null,
     !skipRuntime ? "Prepare runtime" : null,
+    !skipStage && backendEntry ? "Bundle backend sidecar" : null,
     !skipStage ? "Stage desktop bundle" : null
   ].filter(Boolean)
-
-  printBanner("reset-framework-cli build", description)
-  printSection("Project")
+
+  printBanner("reset-framework-cli build", description)
+  printSection("Project")
   printKeyValueTable([
     ["Config", configPath],
     ["Frontend", frontendDir],
+    ["Backend", backendEntry ?? "not configured"],
     ["Package manager", packageManager],
     ["Output", outputPaths.appBundlePath],
     ["Runtime", `${runtimeStrategy.kind === "prebuilt" ? "bundled" : "source"} (${runtimeStrategy.label})`]
   ])
-  console.log("")
-
+  console.log("")
+
   printSection("Plan")
   printStatusTable([
     [skipFrontend ? "skip" : "ready", "Frontend", skipFrontend ? "Skipping frontend build" : "Build static frontend assets"],
@@ -70,38 +75,45 @@ export async function run(context) {
         ? (runtimeStrategy.kind === "prebuilt" ? "Reuse the bundled runtime package" : "Skip the source runtime build")
         : (runtimeStrategy.kind === "prebuilt" ? "Use the bundled runtime package" : "Configure and build the runtime from source")
     ],
+    [
+      backendEntry && !skipStage ? "ready" : "skip",
+      "Backend",
+      backendEntry && !skipStage ? "Bundle the optional TypeScript sidecar backend" : "No backend staging is required"
+    ],
     [skipStage ? "skip" : "ready", "Bundle", skipStage ? "Skipping app bundle staging" : "Assemble the final desktop app bundle"]
   ])
-
-  if (dryRun) {
-    console.log("")
-    printSection("Dry run")
-    printStatusTable(
-      steps.length > 0
-        ? steps.map((step) => ["plan", step, "No changes will be written"])
-        : [["warn", "Nothing to do", "All build phases were skipped"]]
-    )
-    return
-  }
-
-  if (steps.length === 0) {
-    console.log("")
-    printSection("Result")
-    printStatusTable([["warn", "Nothing to do", "All build phases were skipped"]])
-    return
-  }
-
-  console.log("")
-  const progress = createProgress(steps.length, "Build")
-
-  if (!skipFrontend) {
-    await runCommand(resolvePackageManagerCommand(packageManager), ["run", "build"], {
-      cwd: frontendDir,
-      dryRun
-    })
-    progress.tick("Frontend assets built")
-  }
-
+
+  if (dryRun) {
+    console.log("")
+    printSection("Dry run")
+    printStatusTable(
+      steps.length > 0
+        ? steps.map((step) => ["plan", step, "No changes will be written"])
+        : [["warn", "Nothing to do", "All build phases were skipped"]]
+    )
+    return
+  }
+
+  if (steps.length === 0) {
+    console.log("")
+    printSection("Result")
+    printStatusTable([["warn", "Nothing to do", "All build phases were skipped"]])
+    return
+  }
+
+  console.log("")
+  const progress = createProgress(steps.length, "Build")
+
+  let backendArtifact = null
+
+  if (!skipFrontend) {
+    await runCommand(resolvePackageManagerCommand(packageManager), ["run", "build"], {
+      cwd: frontendDir,
+      dryRun
+    })
+    progress.tick("Frontend assets built")
+  }
+
   if (!skipRuntime) {
     const preparedRuntime = await prepareFrameworkRuntime(frameworkPaths, frameworkBuildPaths, "release", {
       cwd: appPaths.appRoot,
@@ -111,21 +123,27 @@ export async function run(context) {
     progress.tick(preparedRuntime.kind === "prebuilt" ? "Bundled runtime ready" : "Native runtime built")
   }
 
+  if (!skipStage && backendEntry) {
+    backendArtifact = await prepareAppBackend(frameworkPaths, appPaths, "release")
+    progress.tick("Backend sidecar bundled")
+  }
+
   if (!skipStage) {
     const stageBundle = process.platform === "win32" ? stageWindowsAppBundle : stageMacOSAppBundle
     await stageBundle(frameworkPaths, frameworkBuildPaths, config, {
       dryRun,
       outputPaths,
       configPath,
-      preferSource
+      preferSource,
+      backendArtifact
     })
     progress.tick("Desktop app bundle staged")
   }
-
-  console.log("")
-  printSection("Result")
-  printStatusTable([
-    ["done", "Build output", outputPaths.outputRoot],
-    ["done", "Desktop app", outputPaths.appBundlePath]
-  ])
-}
+
+  console.log("")
+  printSection("Result")
+  printStatusTable([
+    ["done", "Build output", outputPaths.outputRoot],
+    ["done", "Desktop app", outputPaths.appBundlePath]
+  ])
+}

package/src/commands/dev.js

@@ -1,71 +1,76 @@
 import { prepareFrameworkRuntime } from "../lib/framework.js"
-import {
-  registerChildCleanup,
-  resolvePackageManagerCommand,
-  spawnCommand,
-  waitForProcessExit,
-  waitForUrl
-} from "../lib/process.js"
-import {
-  assertAppProject,
-  assertFrameworkInstall,
-  loadResetConfig,
-  resolveAppPaths,
-  resolveAppPackageManager,
+import { prepareAppBackend } from "../lib/backend.js"
+import {
+  registerChildCleanup,
+  resolvePackageManagerCommand,
+  spawnCommand,
+  waitForProcessExit,
+  waitForUrl
+} from "../lib/process.js"
+import {
+  assertAppProject,
+  assertFrameworkInstall,
+  loadResetConfig,
+  resolveAppPaths,
+  resolveAppPackageManager,
   resolveConfigPath,
   resolveDevServerOptions,
   resolveFrontendDir,
   resolveFrameworkBuildPaths,
   resolveFrameworkRuntimeBinary,
   resolveFrameworkRuntimeStrategy,
-  resolveFrameworkPaths
+  resolveFrameworkPaths,
+  resolveOptionalBackendEntry
 } from "../lib/project.js"
-import {
-  createProgress,
-  printBanner,
-  printKeyValueTable,
-  printSection,
-  printStatusTable
-} from "../lib/ui.js"
-
-export const description = "Run the frontend dev server and native host"
-
-export async function run(context) {
+import {
+  createProgress,
+  printBanner,
+  printKeyValueTable,
+  printSection,
+  printStatusTable
+} from "../lib/ui.js"
+
+export const description = "Run the frontend dev server and native host"
+
+export async function run(context) {
   const dryRun = Boolean(context.flags["dry-run"])
   const skipFrontend = Boolean(context.flags["skip-frontend"])
   const skipRuntime = Boolean(context.flags["skip-runtime"])
   const noOpen = Boolean(context.flags["no-open"])
   const preferSource = Boolean(context.flags["runtime-source"])
-
-  const appPaths = resolveAppPaths(context.projectRoot)
-  const frameworkPaths = resolveFrameworkPaths()
-  assertAppProject(appPaths)
-  assertFrameworkInstall(frameworkPaths)
-  const config = loadResetConfig(appPaths)
-  assertAppProject(appPaths, config)
-  const packageManager = resolveAppPackageManager(appPaths, config)
-  const devServer = resolveDevServerOptions(config)
+
+  const appPaths = resolveAppPaths(context.projectRoot)
+  const frameworkPaths = resolveFrameworkPaths()
+  assertAppProject(appPaths)
+  assertFrameworkInstall(frameworkPaths)
+  const config = loadResetConfig(appPaths)
+  assertAppProject(appPaths, config)
+  const packageManager = resolveAppPackageManager(appPaths, config)
+  const devServer = resolveDevServerOptions(config)
   const configPath = resolveConfigPath(appPaths)
   const frontendDir = resolveFrontendDir(appPaths, config)
+  const backendEntry = resolveOptionalBackendEntry(appPaths)
   const frameworkBuildPaths = resolveFrameworkBuildPaths(appPaths)
   const runtimeStrategy = resolveFrameworkRuntimeStrategy(frameworkPaths, { preferSource })
   const steps = [
     !skipRuntime ? "Prepare runtime" : null,
+    backendEntry ? "Bundle backend sidecar" : null,
     !skipFrontend ? "Start frontend dev server" : null,
     !noOpen ? "Launch desktop window" : null
   ].filter(Boolean)
-
-  printBanner("reset-framework-cli dev", description)
-  printSection("Project")
+
+  printBanner("reset-framework-cli dev", description)
+  printSection("Project")
   printKeyValueTable([
     ["Config", configPath],
     ["Frontend", frontendDir],
+    ["Backend", backendEntry ?? "not configured"],
     ["Package manager", packageManager],
     ["Dev URL", config.frontend.devUrl],
     ["Runtime", `${runtimeStrategy.kind === "prebuilt" ? "bundled" : "source"} (${runtimeStrategy.label})`]
   ])
-  console.log("")
-
+  console.log("")
+
   printSection("Plan")
   printStatusTable([
     [
@@ -75,29 +80,30 @@ export async function run(context) {
         ? (runtimeStrategy.kind === "prebuilt" ? "Reuse the bundled runtime package" : "Reuse the existing source runtime build")
         : (runtimeStrategy.kind === "prebuilt" ? "Use the bundled runtime package" : "Configure and build the runtime from source")
     ],
+    [backendEntry ? "ready" : "skip", "Backend", backendEntry ? "Bundle the optional TypeScript sidecar backend" : "No backend entry was found under backend/"],
     [skipFrontend ? "skip" : "ready", "Frontend", skipFrontend ? "Expecting an already running dev server" : "Start the frontend dev server and wait for readiness"],
     [noOpen ? "skip" : "ready", "Window", noOpen ? "Do not launch the desktop window" : "Start the native host with the active project config"]
   ])
-
-  if (dryRun) {
-    console.log("")
-    printSection("Dry run")
-    printStatusTable(
-      steps.length > 0
-        ? steps.map((step) => ["plan", step, "No processes will be started"])
-        : [["warn", "Nothing to do", "All dev phases were skipped"]]
-    )
-    return
-  }
-
-  if (steps.length === 0) {
-    console.log("")
-    printSection("Result")
-    printStatusTable([["warn", "Nothing to do", "All dev phases were skipped"]])
-    return
-  }
-
-  console.log("")
+
+  if (dryRun) {
+    console.log("")
+    printSection("Dry run")
+    printStatusTable(
+      steps.length > 0
+        ? steps.map((step) => ["plan", step, "No processes will be started"])
+        : [["warn", "Nothing to do", "All dev phases were skipped"]]
+    )
+    return
+  }
+
+  if (steps.length === 0) {
+    console.log("")
+    printSection("Result")
+    printStatusTable([["warn", "Nothing to do", "All dev phases were skipped"]])
+    return
+  }
+
+  console.log("")
   const progress = createProgress(steps.length, "Dev")
 
   if (!skipRuntime) {
@@ -108,72 +114,87 @@ export async function run(context) {
     })
     progress.tick(preparedRuntime.kind === "prebuilt" ? "Bundled runtime ready" : "Native runtime built")
   }
-
-  const children = []
-
-  if (!skipFrontend) {
-    const frontendProcess = spawnCommand(resolvePackageManagerCommand(packageManager), [
-      "run",
-      "dev",
-      "--",
-      "--host",
-      devServer.host,
-      "--port",
-      devServer.port,
-      "--strictPort"
-    ], {
-      cwd: frontendDir,
-      dryRun
-    })
-
-    if (frontendProcess) {
-      children.push(frontendProcess)
-      await waitForUrl(config.frontend.devUrl)
-      progress.tick("Frontend dev server is reachable")
-    }
-  }
-
+
+  const children = []
+  let backendArtifact = null
+
+  if (backendEntry) {
+    backendArtifact = await prepareAppBackend(frameworkPaths, appPaths, "dev")
+    progress.tick("Backend sidecar bundled")
+  }
+
+  if (!skipFrontend) {
+    const frontendProcess = spawnCommand(resolvePackageManagerCommand(packageManager), [
+      "run",
+      "dev",
+      "--",
+      "--host",
+      devServer.host,
+      "--port",
+      devServer.port,
+      "--strictPort"
+    ], {
+      cwd: frontendDir,
+      dryRun
+    })
+
+    if (frontendProcess) {
+      children.push(frontendProcess)
+      await waitForUrl(config.frontend.devUrl)
+      progress.tick("Frontend dev server is reachable")
+    }
+  }
+
   if (!noOpen) {
     const appBinary = resolveFrameworkRuntimeBinary(frameworkPaths, frameworkBuildPaths, "dev", {
       mustExist: !dryRun,
       strategy: runtimeStrategy
     })
     const appProcess = spawnCommand(appBinary, [], {
-      cwd: appPaths.appRoot,
-      env: {
-        RESET_CONFIG_PATH: configPath,
-        RESET_FRONTEND_DEV_URL: config.frontend.devUrl
-      },
-      dryRun
-    })
-
-    if (appProcess) {
-      children.push(appProcess)
-      progress.tick("Desktop window launched")
-    }
-  }
-
-  if (children.length === 0) {
-    return
-  }
-
-  console.log("")
-  printSection("Runtime")
-  printStatusTable([
-    ["done", "Frontend", config.frontend.devUrl],
-    ["done", "Config", configPath]
-  ])
-  console.log("  Press Ctrl+C to stop")
-
-  const cleanup = registerChildCleanup(children)
-
-  try {
-    await Promise.race([
-      ...children.map((child, index) =>
-        waitForProcessExit(child, index === 0 ? "dev process" : "native host")
-      )
-    ])
-  } finally {
-    await cleanup()
-  }
-}
+      cwd: appPaths.appRoot,
+      env: {
+        RESET_CONFIG_PATH: configPath,
+        RESET_FRONTEND_DEV_URL: config.frontend.devUrl,
+        ...(backendArtifact
+          ? {
+              RESET_BACKEND_EXECUTABLE: backendArtifact.runtimeExecutablePath,
+              RESET_BACKEND_RUNNER: backendArtifact.runnerPath,
+              RESET_BACKEND_ENTRY: backendArtifact.bundleEntryPath,
+              RESET_BACKEND_WORKING_DIRECTORY: backendArtifact.workingDirectory
+            }
+          : {})
+      },
+      dryRun
+    })
+
+    if (appProcess) {
+      children.push(appProcess)
+      progress.tick("Desktop window launched")
+    }
+  }
+
+  if (children.length === 0) {
+    return
+  }
+
+  console.log("")
+  printSection("Runtime")
+  printStatusTable([
+    ["done", "Frontend", config.frontend.devUrl],
+    ["done", "Config", configPath],
+    ["done", "Backend", backendArtifact ? backendArtifact.bundleEntryPath : "disabled"]
+  ])
+  console.log("  Press Ctrl+C to stop")
+
+  const cleanup = registerChildCleanup(children)
+
+  try {
+    await Promise.race([
+      ...children.map((child, index) =>
+        waitForProcessExit(child, index === 0 ? "dev process" : "native host")
+      )
+    ])
+  } finally {
+    await cleanup()
+  }
+}