@hashsome/runtime 0.1.0

package/dist/app/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../app/root.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIvE,MAAM,KAAK,GAAG;IACZ,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;IACtC,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE;CACxC,CAAC;AAEF;;;;;6FAK6F;AAC7F,MAAM,UAAU,YAAY,CAAC,KAAK,GAAc,MAAM,EAAE,IAAI,GAAW,YAAY;IACjF,MAAM,WAAW,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAC7D,MAAM,cAAc,GAClB,KAAK,KAAK,QAAQ;QAChB,CAAC,CAAC,mEAAmE,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO;QACpH,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,QAAQ,GAAG;wDACqC,OAAO,CAAC,EAAE,YAAY,OAAO,CAAC,EAAE,kBAAkB,SAAS,CAAC,IAAI,CAAC;;;MAGnH,cAAc;GACjB,CAAC;IAEF,OAAO,SAAS,MAAM,CAAC,EAAE,QAAQ,EAAiC;QAChE,OAAO,CACL,gBAAM,IAAI,EAAC,IAAI,aACb,2BACE,eAAM,OAAO,EAAC,OAAO,GAAG,EACxB,eACE,IAAI,EAAC,UAAU,EACf,OAAO,EAAC,4FAA4F,GACpG,EACF,eAAM,IAAI,EAAC,cAAc,EAAC,OAAO,EAAE,WAAW,GAAI,EAClD,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAC,8BAA8B,GAAG,EAC7D,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAC,2BAA2B,EAAC,WAAW,EAAC,EAAE,GAAG,EACzE,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,wBAAqB,EAAE,GAAG,EAC3E,gBAAO,uBAAuB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAI,EACxD,KAAC,IAAI,KAAG,EACR,KAAC,KAAK,KAAG,IACJ,EACP,2BACG,QAAQ,EACT,KAAC,iBAAiB,KAAG,EACrB,KAAC,OAAO,KAAG,IACN,IACF,CACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;8BAE8B;AAC9B,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/bin/hashsome.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/hashsome.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+// Makes this file a module, which top-level `await` below requires.
+// oxlint-disable-next-line unicorn/require-module-specifiers
+export {};
+const commands = {
+    dev: async () => (await import('../src/cli/dev.js')).dev(),
+    build: async () => (await import('../src/cli/build.js')).build(),
+    start: async () => (await import('../src/cli/start.js')).start(),
+    package: async () => (await import('../src/cli/package.js')).packageCommand(process.argv.slice(3)),
+};
+const command = process.argv[2];
+const run = command && commands[command];
+if (!run) {
+    console.error(`Usage: hashsome <${Object.keys(commands).join('|')}>`);
+    process.exit(1);
+}
+await run();

package/dist/bin/hashsome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashsome.js","sourceRoot":"","sources":["../../bin/hashsome.ts"],"names":[],"mappings":";AAEA,oEAAoE;AACpE,6DAA6D;AAC7D,OAAO,EAAE,CAAC;AAEV,MAAM,QAAQ,GAAG;IACf,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,EAAE;IAC1D,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,EAAE;IAChE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,EAAE;IAChE,OAAO,EAAE,KAAK,IAAI,EAAE,CAClB,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CACvE,CAAC;AAEX,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAsC,CAAC;AACrE,MAAM,GAAG,GAAG,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzC,IAAI,CAAC,GAAG,EAAE,CAAC;IACT,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,EAAE,CAAC"}

package/dist/src/cli/build.d.ts

@@ -0,0 +1,4 @@
+/** Builds the client into `build/client`. Exits when done, unless `exit` is false (a caller that has more to do). */
+export declare function build({ exit }?: {
+    exit?: boolean;
+}): Promise<void>;

package/dist/src/cli/build.js

@@ -0,0 +1,18 @@
+import { resolve } from 'node:path';
+import { createBuilder } from 'vite';
+import { loadConfig } from '../config.js';
+import { createViteConfig } from '../vite.js';
+/** Builds the client into `build/client`. Exits when done, unless `exit` is false (a caller that has more to do). */
+export async function build({ exit = true } = {}) {
+    const config = await loadConfig(resolve(process.cwd()));
+    const inline = createViteConfig(config);
+    // React Router's SPA prerender step starts a Vite preview server that resolves the
+    // project from the working directory.
+    process.chdir(inline.root ?? config.root);
+    const builder = await createBuilder(inline);
+    await builder.buildApp();
+    // Vite/React Router leave handles open after the SPA prerender; nothing else to wait for.
+    if (exit) {
+        process.exit(0);
+    }
+}

package/dist/src/cli/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/cli/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,GAAuB,EAAE;IAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,mFAAmF;IACnF,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IACzB,0FAA0F;IAC1F,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/cli/dev.d.ts

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

package/dist/src/cli/dev.js

@@ -0,0 +1,19 @@
+import { resolve } from 'node:path';
+import { createServer } from 'vite';
+import { loadConfig } from '../config.js';
+import { Proxy } from '../server/proxy.js';
+import { startIntegrations } from '../server/integrations.js';
+import { createViteConfig } from '../vite.js';
+export async function dev() {
+    const config = await loadConfig(resolve(process.cwd()));
+    const stop = startIntegrations(config.integrations, { log: console.log });
+    const server = await createServer(createViteConfig(config, new Proxy(config.integrations, { log: console.log })));
+    await server.listen();
+    server.printUrls();
+    const shutdown = () => {
+        stop();
+        void server.close().then(() => process.exit(0));
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}

package/dist/src/cli/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../src/cli/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,gBAAgB,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAC/E,CAAC;IAEF,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,SAAS,EAAE,CAAC;IACnB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,EAAE,CAAC;QACP,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/cli/package.d.ts

@@ -0,0 +1,13 @@
+import { type Target } from '../release/render.ts';
+/** Reads the targets and the \`--flag value\` / \`--flag=value\` / \`--no-image\` options. */
+export declare function parseArgs(args: string[]): {
+    help: boolean;
+    image: boolean;
+    platform: string | undefined;
+    name: string | undefined;
+    tag: string | undefined;
+    out: string;
+    targets: Target[];
+    port: number | undefined;
+};
+export declare function packageCommand(args: string[]): Promise<void>;

package/dist/src/cli/package.js

@@ -0,0 +1,115 @@
+import { resolve } from 'node:path';
+import { loadConfig } from '../config.js';
+import { packageRelease } from '../release/package.js';
+import { TARGETS } from '../release/render.js';
+import { build } from './build.js';
+const USAGE = `Usage: hashsome package [target...] [options]
+
+Builds the project and writes what you need to deploy it, into ./release.
+
+Targets (one or more; with none, \`package.targets\` in hashsome.config.ts):
+  plain     The server (one file) and the client. Runs with just Node 24+. No Docker needed.
+  compose   A Docker Compose file and the container image (image.tar).
+  helm      A Helm chart for k3s/Kubernetes and the container image (image.tar).
+  image     Only the container image (image.tar), for manifests you write yourself.
+
+Options:
+  --platform <p>   What the image runs on, e.g. linux/amd64 (default: package.platform, else this machine's)
+  --name <name>    Image, service and chart name (default: package.name, else the package name)
+  --tag <tag>      Image tag (default: the time, so each release has its own)
+  --out <dir>      Where to write it (default: release)
+  --port <n>       The port the server listens on in the image (default: package.port, else 3000)
+  --no-image       Skip building the image (no Docker needed; compose and helm need one later)
+
+Examples:
+  hashsome package helm --platform linux/amd64
+  hashsome package plain
+`;
+const VALUE_FLAGS = ['platform', 'name', 'tag', 'out', 'port'];
+/** Reads the targets and the \`--flag value\` / \`--flag=value\` / \`--no-image\` options. */
+export function parseArgs(args) {
+    const values = new Map();
+    const targets = [];
+    const flags = new Set();
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg.startsWith('--')) {
+            if (!TARGETS.includes(arg)) {
+                throw new Error(`Unknown target "${arg}" (use ${TARGETS.join(', ')})`);
+            }
+            targets.push(arg);
+            continue;
+        }
+        const [key, inline] = arg.slice(2).split('=', 2);
+        if (key === 'no-image' || key === 'help') {
+            flags.add(key);
+        }
+        else if (VALUE_FLAGS.includes(key)) {
+            const value = inline ?? args[++i];
+            if (value === undefined) {
+                throw new Error(`--${key} needs a value`);
+            }
+            values.set(key, value);
+        }
+        else {
+            throw new Error(`Unknown option --${key}`);
+        }
+    }
+    const port = values.has('port') ? Number(values.get('port')) : undefined;
+    if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65535)) {
+        throw new Error('--port must be a port number');
+    }
+    return {
+        help: flags.has('help'),
+        image: !flags.has('no-image'),
+        platform: values.get('platform'),
+        name: values.get('name'),
+        tag: values.get('tag'),
+        out: values.get('out') ?? 'release',
+        targets,
+        port,
+    };
+}
+export async function packageCommand(args) {
+    let options;
+    try {
+        options = parseArgs(args);
+    }
+    catch (error) {
+        console.error(`${error instanceof Error ? error.message : String(error)}\n\n${USAGE}`);
+        process.exit(1);
+    }
+    if (options.help) {
+        console.log(USAGE);
+        return;
+    }
+    const root = resolve(process.cwd());
+    const defaults = (await loadConfig(root)).package;
+    const targets = options.targets.length > 0 ? options.targets : (defaults.targets ?? []);
+    if (targets.length === 0) {
+        console.error(`Say what to package for: ${TARGETS.join(', ')}.\n\n${USAGE}`);
+        process.exit(1);
+    }
+    await build({ exit: false });
+    try {
+        const { out, image: ref } = await packageRelease({
+            root,
+            out: options.out,
+            name: options.name ?? defaults.name,
+            tag: options.tag,
+            platform: options.platform ?? defaults.platform,
+            port: options.port ?? defaults.port ?? 3000,
+            image: options.image,
+            targets: [...new Set(targets)],
+        });
+        console.log(`\nRelease (${[...new Set(targets)].join(', ')}) written to ${out}`);
+        if (ref) {
+            console.log(`\nImage: ${ref}\nOn the server: k3s ctr -n k8s.io images import image.tar`);
+        }
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    process.exit(0);
+}

package/dist/src/cli/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/cli/package.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/start.d.ts

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

package/dist/src/cli/start.js

@@ -0,0 +1,12 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../config.js';
+import { startServer } from '../server/production.js';
+export async function start() {
+    const config = await loadConfig(resolve(process.cwd()));
+    if (!existsSync(join(config.root, 'build', 'client', 'index.html'))) {
+        console.error('No build found. Run `hashsome build` first.');
+        process.exit(1);
+    }
+    startServer(config);
+}

package/dist/src/cli/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/cli/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QACpE,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,WAAW,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,36 @@
+import type { Integration } from '@hashsome/core';
+/** How a project is packaged for deployment: what `hashsome package` does without being told. */
+export interface PackageConfig {
+    /** What to write: `plain` (the server bundle and client, runs with Node), `compose` (Docker Compose), `helm` (a Helm chart for k3s), `image` (just the container image, for your own manifests). Command-line targets win over this. */
+    targets?: ('plain' | 'compose' | 'helm' | 'image')[];
+    /** What the image runs on, e.g. `linux/amd64`. Default: the machine that builds it. */
+    platform?: string;
+    /** The image, service and chart name. Default: the package name. */
+    name?: string;
+    /** Where the server listens in the image. Default 3000. */
+    port?: number;
+}
+export interface HashsomeConfig {
+    /** Backends the runtime proxies to the browser. `@hashsome/runtime` ships no integrations of its
+     * own — install whichever you need (e.g. `@hashsome/integration.home-assistant`) and construct them
+     * here, typically reading connection details from your own environment variables. */
+    integrations?: Integration[];
+    port?: number;
+    host?: string;
+    /** Defaults for `hashsome package`, so deploying is `pnpm package` with no flags. */
+    package?: PackageConfig;
+}
+export interface ResolvedConfig {
+    root: string;
+    integrations: Integration[];
+    port: number;
+    host: string;
+    package: PackageConfig;
+}
+export declare function defineConfig(config: HashsomeConfig): HashsomeConfig;
+export declare const CONFIG_FILE = "hashsome.config.ts";
+/** Applies defaults to a config (and checks it). `PORT` and `HOST` in the environment win over the
+ * file, so a container can be told where to listen without rebuilding. */
+export declare function resolveConfig(root: string, user: HashsomeConfig): ResolvedConfig;
+/** Loads `<root>/hashsome.config.ts` (if present) and applies defaults. */
+export declare function loadConfig(root: string): Promise<ResolvedConfig>;

package/dist/src/config.js

@@ -0,0 +1,54 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+export function defineConfig(config) {
+    return config;
+}
+export const CONFIG_FILE = 'hashsome.config.ts';
+/** Throws if two integrations were configured with the same `id` — each id is a claimed entity-ref
+ * prefix, and a silent collision (whichever integration was constructed last would simply win in
+ * every `Map`-keyed lookup) is exactly the kind of bug that's worth catching at startup. */
+function assertUniqueIds(integrations) {
+    const seen = new Map();
+    for (const [index, integration] of integrations.entries()) {
+        const firstIndex = seen.get(integration.id);
+        if (firstIndex !== undefined) {
+            throw new Error(`Duplicate integration id "${integration.id}" (integrations[${firstIndex}] and ` +
+                `integrations[${index}]). Each integration's id becomes its entity-ref prefix ` +
+                `(e.g. "${integration.id}:some.entity") and must be unique — pass a distinct \`id\` ` +
+                'to one of them.');
+        }
+        seen.set(integration.id, index);
+    }
+}
+/** Applies defaults to a config (and checks it). `PORT` and `HOST` in the environment win over the
+ * file, so a container can be told where to listen without rebuilding. */
+export function resolveConfig(root, user) {
+    const integrations = user.integrations ?? [];
+    assertUniqueIds(integrations);
+    return {
+        root,
+        integrations,
+        port: Number(process.env.PORT ?? user.port ?? 3000),
+        host: process.env.HOST ?? user.host ?? '0.0.0.0',
+        package: user.package ?? {},
+    };
+}
+/** Loads `<root>/hashsome.config.ts` (if present) and applies defaults. */
+export async function loadConfig(root) {
+    const file = join(root, CONFIG_FILE);
+    let user = {};
+    if (existsSync(file)) {
+        const mod = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ pathToFileURL(file).href)));
+        user = mod.default ?? {};
+    }
+    return resolveConfig(root, user);
+}

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqCzC,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD;;4FAE4F;AAC5F,SAAS,eAAe,CAAC,YAA2B;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,CAAC,EAAE,mBAAmB,UAAU,QAAQ;gBAC9E,gBAAgB,KAAK,0DAA0D;gBAC/E,UAAU,WAAW,CAAC,EAAE,6DAA6D;gBACrF,iBAAiB,CACpB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;0EAC0E;AAC1E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAoB;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7C,eAAe,CAAC,YAAY,CAAC,CAAC;IAC9B,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QACnD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS;QAChD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,IAAI,GAAmB,EAAE,CAAC;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,kCAAC,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAC,CAErE,CAAC;QAEF,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1 @@
+export { defineConfig, type HashsomeConfig, type PackageConfig } from './config.ts';

package/dist/src/index.js

@@ -0,0 +1,8 @@
+// Node-only and JSX-free on purpose: `hashsome.config.ts` imports `defineConfig` from here and is
+// loaded via a plain Node `import()` in the CLI (see `config.ts`'s `loadConfig()`), which both
+// can't transform JSX and runs `config.ts`'s own `node:fs` import for real. Anything browser code
+// imports — the React-facing pieces (`createLayout`, ...) —
+// lives under the `@hashsome/runtime/app` subpath instead: importing *anything* from this file pulls
+// in the whole module, and `config.ts`'s `node:fs` import throws immediately if that ever reaches
+// a browser bundle (Vite externalizes Node builtins client-side as throwing stubs).
+export { defineConfig } from './config.js';

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,+FAA+F;AAC/F,kGAAkG;AAClG,4DAA4D;AAC5D,qGAAqG;AACrG,kGAAkG;AAClG,oFAAoF;AACpF,OAAO,EAAE,YAAY,EAA2C,MAAM,aAAa,CAAC"}

package/dist/src/release/bundle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bundles a project's server into one file: the runtime, the project's `hashsome.config.ts` and every
+ * integration it imports, with their dependencies, so the file runs with just `node` and no
+ * `node_modules`. Secrets are not in it: the config reads them from the environment when it runs.
+ * Uses Vite's own server build, so there is no bundler of its own to install.
+ */
+export declare function bundleServer({ root, outFile }: {
+    root: string;
+    outFile: string;
+}): Promise<void>;

package/dist/src/release/bundle.js

@@ -0,0 +1,50 @@
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { build } from 'vite';
+/** The runtime's own entry for a packaged server, by path: it does not depend on how the project resolves `@hashsome/runtime`. Next to this file, as source in the repo and as built JavaScript when installed. */
+const SERVE = fileURLToPath(new URL(`../serve${import.meta.url.endsWith('.ts') ? '.ts' : '.js'}`, import.meta.url));
+/**
+ * Bundles a project's server into one file: the runtime, the project's `hashsome.config.ts` and every
+ * integration it imports, with their dependencies, so the file runs with just `node` and no
+ * `node_modules`. Secrets are not in it: the config reads them from the environment when it runs.
+ * Uses Vite's own server build, so there is no bundler of its own to install.
+ */
+export async function bundleServer({ root, outFile }) {
+    const outDir = dirname(outFile);
+    // In the project, next to its config.
+    const entry = join(root, '.hashsome-server-entry.ts');
+    mkdirSync(outDir, { recursive: true });
+    writeFileSync(entry, [
+        `import config from ${JSON.stringify(join(root, 'hashsome.config.ts'))};`,
+        `import { serve } from ${JSON.stringify(SERVE)};`,
+        `serve(config, import.meta.url);`,
+    ].join('\n'));
+    try {
+        await build({
+            root,
+            configFile: false,
+            logLevel: 'warn',
+            // The runtime and the integrations are bundled in, not left to be installed.
+            ssr: { noExternal: true, target: 'node' },
+            build: {
+                ssr: entry,
+                outDir,
+                emptyOutDir: false,
+                minify: false,
+                target: 'node24',
+                rollupOptions: {
+                    output: {
+                        format: 'es',
+                        entryFileNames: basename(outFile),
+                        // Dependencies that are still CommonJS (express, ws) call `require`, which an ES module lacks.
+                        banner: "import { createRequire as __hashsomeCreateRequire } from 'node:module';\nconst require = __hashsomeCreateRequire(import.meta.url);",
+                    },
+                },
+            },
+        });
+    }
+    finally {
+        rmSync(entry, { force: true });
+    }
+}

package/dist/src/release/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/release/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE7B,mNAAmN;AACnN,MAAM,KAAK,GAAG,aAAa,CACzB,IAAI,GAAG,CAAC,WAAW,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CACvF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAqC;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,sCAAsC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IACtD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,aAAa,CACX,KAAK,EACL;QACE,sBAAsB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,GAAG;QACzE,yBAAyB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;QACjD,iCAAiC;KAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,CAAC;YACV,IAAI;YACJ,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,MAAM;YAChB,6EAA6E;YAC7E,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;YACzC,KAAK,EAAE;gBACL,GAAG,EAAE,KAAK;gBACV,MAAM;gBACN,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,QAAQ;gBAChB,aAAa,EAAE;oBACb,MAAM,EAAE;wBACN,MAAM,EAAE,IAAI;wBACZ,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC;wBACjC,+FAA+F;wBAC/F,MAAM,EACJ,oIAAoI;qBACvI;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/release/package.d.ts

@@ -0,0 +1,26 @@
+import { type Target } from './render.ts';
+export interface ReleaseOptions {
+    /** The project's folder. */
+    root: string;
+    /** Where the release goes, relative to `root`. Emptied first. Default `release`. */
+    out: string;
+    /** Default: the project's package name. */
+    name?: string | undefined;
+    /** Default: the time, so every release has a tag of its own and a node picks up the update. */
+    tag?: string | undefined;
+    /** What the image is built for, e.g. `linux/amd64`. Default: this machine's. */
+    platform?: string | undefined;
+    targets: readonly Target[];
+    /** Build the image and write `image.tar` for the targets that run one (`compose`, `helm`, `image`). Needs Docker. */
+    image: boolean;
+    port: number;
+}
+/**
+ * Writes the release for the chosen `targets` only: `plain` is the server bundled into one file next
+ * to the built client; `compose` and `helm` are run from an image, so they also get `image.tar`.
+ * `build` must have run (the client is read from `build/client`).
+ */
+export declare function packageRelease(options: ReleaseOptions): Promise<{
+    out: string;
+    image?: string;
+}>;

package/dist/src/release/package.js

@@ -0,0 +1,102 @@
+import { spawnSync } from 'node:child_process';
+import { chmodSync, cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { bundleServer } from './bundle.js';
+import { chartDeployment, chartHelpers, chartIngress, chartNotes, chartService, chartValues, chartYaml, composeFile, composeReadme, dockerfile, envExample, helmReadme, imageRef, importScript, plainReadme, releaseReadme, safeName, } from './render.js';
+const timestamp = () => new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+function hostPlatform() {
+    return process.arch === 'arm64' ? 'linux/arm64' : 'linux/amd64';
+}
+/** Runs a command, passing its output through; throws when it fails. */
+function run(command, args, cwd) {
+    const result = spawnSync(command, args, { cwd, stdio: 'inherit' });
+    if (result.error || result.status !== 0) {
+        throw new Error(result.error?.message.includes('ENOENT')
+            ? `${command} is not installed (use --no-image to skip building the image)`
+            : `${command} ${args.join(' ')} failed`);
+    }
+}
+const write = (dir, files) => {
+    for (const [name, content] of Object.entries(files)) {
+        const file = join(dir, name);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, content);
+    }
+};
+/**
+ * Writes the release for the chosen `targets` only: `plain` is the server bundled into one file next
+ * to the built client; `compose` and `helm` are run from an image, so they also get `image.tar`.
+ * `build` must have run (the client is read from `build/client`).
+ */
+export async function packageRelease(options) {
+    const { root, targets } = options;
+    const needsImage = targets.includes('compose') || targets.includes('helm') || targets.includes('image');
+    const client = join(root, 'build', 'client');
+    if (!existsSync(join(client, 'index.html'))) {
+        throw new Error('No build found. Run `hashsome build` first.');
+    }
+    const pkg = existsSync(join(root, 'package.json'))
+        ? JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'))
+        : {};
+    const envFile = join(root, '.env.example');
+    const info = {
+        name: safeName(options.name ?? pkg.name ?? 'hashsome'),
+        tag: options.tag ?? timestamp(),
+        platform: options.platform ?? hostPlatform(),
+        port: options.port,
+        image: options.image && needsImage,
+        envExample: existsSync(envFile) ? readFileSync(envFile, 'utf8') : undefined,
+    };
+    const out = join(root, options.out);
+    rmSync(out, { recursive: true, force: true });
+    // The bundle is what every target is made from. It stays in the release only when asked for;
+    // otherwise it is just the folder the image is built from.
+    const keepPlain = targets.includes('plain');
+    mkdirSync(out, { recursive: true });
+    const plain = keepPlain ? join(out, 'plain') : mkdtempSync(join(tmpdir(), 'hashsome-release-'));
+    mkdirSync(plain, { recursive: true });
+    cpSync(client, join(plain, 'client'), { recursive: true });
+    await bundleServer({ root, outFile: join(plain, 'server.mjs') });
+    write(plain, { Dockerfile: dockerfile(info) });
+    if (keepPlain) {
+        write(plain, { 'README.md': plainReadme(info) });
+    }
+    try {
+        if (info.image) {
+            run('docker', ['buildx', 'build', '--platform', info.platform, '--load', '-t', imageRef(info), plain], root);
+            run('docker', ['save', imageRef(info), '-o', join(out, 'image.tar')], root);
+        }
+    }
+    finally {
+        if (!keepPlain) {
+            rmSync(plain, { recursive: true, force: true });
+        }
+    }
+    if (targets.includes('compose')) {
+        write(join(out, 'compose'), {
+            'compose.yaml': composeFile(info),
+            '.env.example': envExample(info),
+            'README.md': composeReadme(info),
+        });
+    }
+    if (targets.includes('helm')) {
+        const helm = join(out, 'helm');
+        write(helm, {
+            'Chart.yaml': chartYaml(info),
+            'values.yaml': chartValues(info),
+            'templates/_helpers.tpl': chartHelpers(),
+            'templates/deployment.yaml': chartDeployment(),
+            'templates/service.yaml': chartService(),
+            'templates/ingress.yaml': chartIngress(),
+            'templates/NOTES.txt': chartNotes(),
+            'import-image.sh': importScript(info),
+            'README.md': helmReadme(info),
+        });
+        chmodSync(join(helm, 'import-image.sh'), 0o755);
+    }
+    write(out, {
+        'README.md': releaseReadme(info, targets),
+    });
+    return { out, ...(info.image ? { image: imageRef(info) } : {}) };
+}

package/dist/src/release/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/release/package.ts"],"names":[],"mappings":"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"}

package/dist/src/release/render.d.ts

@@ -0,0 +1,32 @@
+/** The files of a release, as text. Pure: `package.ts` writes them out. */
+export type Target = 'plain' | 'compose' | 'helm' | 'image';
+export declare const TARGETS: readonly Target[];
+export interface ReleaseInfo {
+    /** The project's name: the image, the compose service and the chart. A valid DNS label. */
+    name: string;
+    tag: string;
+    platform: string;
+    port: number;
+    /** The project's `.env.example`, shown to the person deploying. */
+    envExample?: string | undefined;
+    /** Whether `image.tar` is in the release. */
+    image: boolean;
+}
+export declare const imageRef: ({ name, tag }: Pick<ReleaseInfo, 'name' | 'tag'>) => string;
+/** A project name made safe for an image, a service and a chart. */
+export declare function safeName(raw: string): string;
+export declare function dockerfile({ port }: Pick<ReleaseInfo, 'port'>): string;
+export declare function plainReadme(info: ReleaseInfo): string;
+export declare function composeFile(info: ReleaseInfo): string;
+export declare function composeReadme(info: ReleaseInfo): string;
+export declare function envExample(info: ReleaseInfo): string;
+export declare function chartYaml(info: ReleaseInfo): string;
+export declare function chartValues(info: ReleaseInfo): string;
+export declare function chartHelpers(): string;
+export declare function chartDeployment(): string;
+export declare function chartService(): string;
+export declare function chartIngress(): string;
+export declare function chartNotes(): string;
+export declare function importScript(info: ReleaseInfo): string;
+export declare function helmReadme(info: ReleaseInfo): string;
+export declare function releaseReadme(info: ReleaseInfo, targets: readonly Target[]): string;