@lazyapps/bootstrap 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026, Oliver Sturm
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @lazyapps/bootstrap
+
+Composition orchestrator for LazyApps applications. Wires together framework components and enables flexible deployment topologies from monolith to fully distributed.
+
+## Installation
+
+```bash
+pnpm add @lazyapps/bootstrap
+```
+
+## Part of LazyApps
+
+This package is part of the [LazyApps](https://github.com/oliversturm/lazyapps-libs) event-sourcing and CQRS framework.

package/index.js

@@ -0,0 +1,55 @@
+import { startCommandProcessor } from '@lazyapps/command-processor';
+import { startReadModels } from '@lazyapps/readmodels';
+import { getLogger } from '@lazyapps/logger';
+import { startSvelteKit } from './svelte.js';
+
+const log = getLogger('BS', 'INIT');
+
+let signalHandlersInstalled = false;
+const handleSignals = (server) => {
+  const handler = (signal) => {
+    log.info(`Signal ${signal} received`);
+    server.close(() => {
+      log.info('Server closed, exiting process');
+      process.exit(0);
+    });
+  };
+
+  if (!signalHandlersInstalled) {
+    // Let's just do this once per process, since it's possible we're in a monolith
+    process.on('SIGTERM', handler);
+    process.on('SIGINT', handler);
+    signalHandlersInstalled = true;
+  }
+};
+
+export function start({
+  correlation: correlationConfig,
+  commands,
+  readModels,
+  changeNotifier,
+  svelte,
+}) {
+  if (commands) {
+    log.debug('Starting command processor');
+    startCommandProcessor(correlationConfig, commands).then((server) => {
+      handleSignals(server);
+    });
+  }
+  if (readModels) {
+    log.debug('Starting read models');
+    startReadModels(correlationConfig, readModels).then((server) => {
+      handleSignals(server);
+    });
+  }
+  if (changeNotifier) {
+    log.debug('Starting change notifier');
+    changeNotifier.listener(correlationConfig).then((server) => {
+      handleSignals(server);
+    });
+  }
+  if (svelte) {
+    log.debug('Starting SvelteKit frontend');
+    startSvelteKit(correlationConfig, svelte);
+  }
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@lazyapps/bootstrap",
+  "version": "0.1.0",
+  "description": "Composition orchestrator for LazyApps applications",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./svelte": "./svelte.js"
+  },
+  "files": [
+    "*.js"
+  ],
+  "keywords": [
+    "event-sourcing",
+    "cqrs",
+    "lazyapps",
+    "bootstrap",
+    "orchestrator"
+  ],
+  "author": "Oliver Sturm",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oliversturm/lazyapps-libs.git",
+    "directory": "packages/bootstrap"
+  },
+  "bugs": {
+    "url": "https://github.com/oliversturm/lazyapps-libs/issues"
+  },
+  "homepage": "https://github.com/oliversturm/lazyapps-libs/tree/main/packages/bootstrap#readme",
+  "engines": {
+    "node": ">=18.20.3 || >=20.18.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.46.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@lazyapps/command-processor": "^0.1.0",
+    "@lazyapps/logger": "^0.1.0",
+    "@lazyapps/readmodels": "^0.1.0"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0",
+    "@sveltejs/kit": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "@sveltejs/kit": {
+      "optional": true
+    }
+  },
+  "type": "module",
+  "scripts": {
+    "test": "vitest"
+  }
+}

package/svelte.js

@@ -0,0 +1,68 @@
+import { createServer, createLogger as createViteLogger } from 'vite';
+import { sveltekit } from '@sveltejs/kit/vite';
+import { getLogger } from '@lazyapps/logger';
+
+// Note, the custom logger stuff is currently
+// missing from vite docs. Best example I found
+// is here: https://github.com/vitejs/vite/issues/10940
+// There's a PR for the upcoming docs as well,
+// but it's hard to read and not very verbose.
+
+const log = getLogger('BS/Svelte');
+const viteLog = getLogger('BS/Svelte/Vite');
+const viteOrigLogger = createViteLogger();
+// Sometimes vite sends empty output with a
+// warn level, so prevent this from being logged.
+const wrap = (f) => (msg) => (msg ? f(msg) : undefined);
+const customLogger = {
+  ...viteOrigLogger,
+  info: wrap(viteLog.info), // ignoring second parameter options
+  warn: wrap(viteLog.warn),
+  error: wrap(viteLog.error),
+};
+
+export const startSvelteKit = ({
+  port = 5173,
+  host = 'localhost',
+  logLevel = 'info',
+  mqCommandsPort = 51883,
+  mqQueriesPort = 51884,
+} = {}) => {
+  const config = {
+    plugins: [sveltekit()],
+
+    server: {
+      host,
+      port,
+    },
+
+    define: {
+      // Decided to use the 'process.env' prefix here, because
+      // otherwise the defined value will be marked as an error
+      // by eslint. In the context of this monolith setup, the
+      // use as an actual environment variable is not relevant.
+      'process.env.MQ_COMMANDS_PORT': JSON.stringify(mqCommandsPort),
+      'process.env.MQ_QUERIES_PORT': JSON.stringify(mqQueriesPort),
+    },
+
+    clearScreen: false,
+    logLevel,
+    customLogger,
+  };
+
+  return createServer(config)
+    .then((server) =>
+      server.listen().then(() => {
+        server.printUrls();
+      }),
+    )
+    .then(() => {
+      log.debug(`SvelteKit frontend started on ${host}:${port}`);
+    })
+    .catch((err) => {
+      log.error(
+        `An error occurred starting the SvelteKit frontend on ${host}:${port}`,
+        err,
+      );
+    });
+};