@objectstack/cli 4.0.3 → 4.0.5

package/dist/utils/build-runtime.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Build a single ESM bundle that re-exports every inline handler function
+ * collected by `lowerCallables`. The bundle is the second half of the
+ * "two-product" build (alongside `objectstack.json`):
+ *
+ *   dist/
+ *   ├── objectstack.json
+ *   └── objectstack-runtime.{contenthash}.mjs   ← THIS
+ *
+ * At runtime, `StandaloneStack` (and `MultiProjectPlugin`) dynamic-import
+ * the mjs and merge `module.functions` into the bundle before
+ * `bindHooks(...)` runs — so string-named handlers resolve to real code
+ * even though the JSON artifact is pure metadata.
+ */
+export interface BuildRuntimeOptions {
+    /** Absolute path to the user's `objectstack.config.{ts,js,mjs}`. */
+    sourceConfigPath: string;
+    /** Lowered handler refs (`name → handlerName`) — mirrors `LoweringResult.functions`. */
+    refs: string[];
+    /** Output directory (e.g. `<cwd>/dist`). Created if missing. */
+    outputDir: string;
+    /** Base file name without hash, e.g. `objectstack-runtime`. */
+    baseName?: string;
+    /** External package names to mark as external (`@objectstack/*` etc.). */
+    externalPackages?: string[];
+}
+export interface BuildRuntimeResult {
+    /** Absolute path to the emitted mjs. */
+    outputPath: string;
+    /** File name (relative to outputDir) — embedded in objectstack.json. */
+    outputFileName: string;
+    /** Content hash (sha256, first 16 hex chars). */
+    hash: string;
+    /** Bundle size in bytes. */
+    size: number;
+}
+export declare function buildRuntimeBundle(opts: BuildRuntimeOptions): Promise<BuildRuntimeResult>;
+/** Best-effort cleanup of stale `objectstack-runtime.*.mjs` files. */
+export declare function cleanupOldRuntimeBundles(outputDir: string, keepFileName: string, baseName?: string): number;
+/** Reuse: read an existing bundle and recompute its size for stats. */
+export declare function statBundle(outputPath: string): {
+    size: number;
+} | null;
+export declare const runtimeBundlePathRelative: (outputDir: string, file: string) => string;
+//# sourceMappingURL=build-runtime.d.ts.map

package/dist/utils/build-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runtime.d.ts","sourceRoot":"","sources":["../../src/utils/build-runtime.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AA6DD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4D/F;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,SAAe,GAAG,MAAM,CAejH;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOtE;AAED,eAAO,MAAM,yBAAyB,GAAI,WAAW,MAAM,EAAE,MAAM,MAAM,KAAG,MACf,CAAC"}

package/dist/utils/build-runtime.js

@@ -0,0 +1,154 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, unlinkSync, readdirSync } from 'node:fs';
+import { dirname, basename, resolve as resolvePath, relative, sep as PATH_SEP } from 'node:path';
+const DEFAULT_BASE = 'objectstack-runtime';
+/**
+ * Generate the entry source that re-extracts callable handlers from the
+ * compiled config. We bundle the user's config transitively (so every
+ * `*.hook.ts` import is captured), then walk the same shape the lowering
+ * pass walked and re-export the matching handlers under the same string
+ * keys. The runtime side merges this map into `bundle.functions`.
+ */
+function generateEntrySource(sourceConfigPath, refs, entryDir) {
+    // Use a POSIX-style relative path so esbuild's resolver bundles the
+    // user's config + every transitively-imported `*.hook.ts` into the
+    // emitted ESM. A `file://` URL would be treated as external.
+    let importPath = relative(entryDir, sourceConfigPath).split(PATH_SEP).join('/');
+    if (!importPath.startsWith('.'))
+        importPath = './' + importPath;
+    const refLiteral = JSON.stringify(refs);
+    return `// AUTO-GENERATED by @objectstack/cli — do not edit.
+import config from ${JSON.stringify(importPath)};
+
+const REFS = new Set(${refLiteral});
+
+function collect(cfg) {
+  const out = Object.create(null);
+  if (!cfg || typeof cfg !== 'object') return out;
+  // Hooks: { name, handler }
+  if (Array.isArray(cfg.hooks)) {
+    for (const h of cfg.hooks) {
+      if (h && typeof h === 'object' && typeof h.handler === 'function' && typeof h.name === 'string') {
+        if (REFS.has(h.name)) out[h.name] = h.handler;
+      }
+    }
+  }
+  // Top-level functions map
+  if (cfg.functions && !Array.isArray(cfg.functions) && typeof cfg.functions === 'object') {
+    for (const [k, v] of Object.entries(cfg.functions)) {
+      if (typeof v === 'function' && REFS.has(k)) out[k] = v;
+    }
+  }
+  // Top-level functions array
+  if (Array.isArray(cfg.functions)) {
+    for (const entry of cfg.functions) {
+      if (entry && typeof entry === 'object' && typeof entry.handler === 'function' && typeof entry.name === 'string') {
+        if (REFS.has(entry.name)) out[entry.name] = entry.handler;
+      }
+    }
+  }
+  return out;
+}
+
+const cfg = config && typeof config === 'object' && 'default' in config ? config.default : config;
+export const functions = collect(cfg);
+export const meta = {
+  builtAt: new Date().toISOString(),
+  refCount: ${refs.length},
+};
+`;
+}
+export async function buildRuntimeBundle(opts) {
+    const { sourceConfigPath, refs, outputDir } = opts;
+    const baseName = opts.baseName ?? DEFAULT_BASE;
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const entryDir = dirname(sourceConfigPath);
+    const entryPath = resolvePath(entryDir, `.${baseName}.entry.${process.pid}.${Date.now()}.mjs`);
+    writeFileSync(entryPath, generateEntrySource(sourceConfigPath, refs, entryDir));
+    let esbuild;
+    try {
+        esbuild = await import('esbuild');
+    }
+    catch (err) {
+        try {
+            unlinkSync(entryPath);
+        }
+        catch { /* noop */ }
+        throw new Error(`[build-runtime] esbuild is required to bundle declarative handlers but is not installed: ${err.message}`);
+    }
+    // Bundle to an in-memory buffer first so we can hash, then rename.
+    let result;
+    try {
+        result = await esbuild.build({
+            entryPoints: [entryPath],
+            bundle: true,
+            format: 'esm',
+            platform: 'node',
+            target: 'node18',
+            write: false,
+            sourcemap: 'inline',
+            packages: 'external',
+            logLevel: 'silent',
+            legalComments: 'none',
+            resolveExtensions: ['.ts', '.tsx', '.mjs', '.js', '.cjs', '.json'],
+            loader: { '.ts': 'ts', '.tsx': 'tsx' },
+            banner: { js: '// @generated by @objectstack/cli — do not edit.' },
+        });
+    }
+    finally {
+        try {
+            unlinkSync(entryPath);
+        }
+        catch { /* noop */ }
+    }
+    const out = result.outputFiles?.[0];
+    if (!out)
+        throw new Error('[build-runtime] esbuild produced no output');
+    const code = out.text;
+    const hash = createHash('sha256').update(code).digest('hex').slice(0, 16);
+    const fileName = `${baseName}.${hash}.mjs`;
+    const outputPath = resolvePath(outputDir, fileName);
+    writeFileSync(outputPath, code);
+    return {
+        outputPath,
+        outputFileName: fileName,
+        hash,
+        size: Buffer.byteLength(code, 'utf8'),
+    };
+}
+/** Best-effort cleanup of stale `objectstack-runtime.*.mjs` files. */
+export function cleanupOldRuntimeBundles(outputDir, keepFileName, baseName = DEFAULT_BASE) {
+    if (!existsSync(outputDir))
+        return 0;
+    let removed = 0;
+    try {
+        const re = new RegExp(`^${baseName}\\.[a-f0-9]+\\.mjs(\\.map)?$`);
+        for (const f of readdirSync(outputDir)) {
+            if (!re.test(f))
+                continue;
+            if (f === keepFileName)
+                continue;
+            try {
+                unlinkSync(resolvePath(outputDir, f));
+                removed += 1;
+            }
+            catch { /* noop */ }
+        }
+    }
+    catch { /* noop */ }
+    return removed;
+}
+/** Reuse: read an existing bundle and recompute its size for stats. */
+export function statBundle(outputPath) {
+    try {
+        const buf = readFileSync(outputPath);
+        return { size: buf.byteLength };
+    }
+    catch {
+        return null;
+    }
+}
+export const runtimeBundlePathRelative = (outputDir, file) => relative(outputDir, resolvePath(outputDir, basename(file)));
+//# sourceMappingURL=build-runtime.js.map

package/dist/utils/build-runtime.js.map

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

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,GAAG,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BzD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkBvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAgC,GAAG,OAAO,CAE5E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,GAAG,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BzD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAgC,GAAG,OAAO,CAE5E"}

package/dist/utils/config.js

@@ -47,10 +47,25 @@ export async function loadConfig(source) {
     const { mod } = await bundleRequire({
         filepath: absolutePath,
     });
-    const config = mod.default || mod;
-    if (!config) {
+    const baseConfig = mod.default || mod;
+    if (!baseConfig) {
         throw new Error(`No default export found in ${path.basename(absolutePath)}`);
     }
+    // Preserve named exports (e.g. `onEnable`, `onDisable` lifecycle hooks)
+    // alongside the default-exported stack. Module-namespace named exports are
+    // otherwise dropped when we unwrap `mod.default`, which prevents AppPlugin
+    // from invoking runtime hooks.
+    const config = (baseConfig === mod || mod.default == null)
+        ? baseConfig
+        : (() => {
+            const merged = { ...baseConfig };
+            for (const key of Object.keys(mod)) {
+                if (key === 'default' || key in merged)
+                    continue;
+                merged[key] = mod[key];
+            }
+            return merged;
+        })();
     return {
         config,
         absolutePath,

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,UAAU,CAAC,0BAA0B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC,CAAC;YAC/F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC,CAAC;YACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,cAAc;IACd,MAAM,UAAU,GAAG;QACjB,uBAAuB;QACvB,uBAAuB;QACvB,wBAAwB;KACzB,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;IACrC,CAAC;IAED,UAAU,CAAC,8DAA8D,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAe;IAC9C,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,aAAa,CAAC;QAClC,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,MAAM;QACN,YAAY;QACZ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,uBAAuB;IACjE,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"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"}

package/dist/utils/console.d.ts

@@ -0,0 +1,32 @@
+/** URL mount path for the Console portal inside the ObjectStack server */
+export declare const CONSOLE_PATH = "/_console";
+/**
+ * Resolve the filesystem path to the @objectstack/console package.
+ * Searches workspace locations first, then falls back to node_modules.
+ */
+export declare function resolveConsolePath(): string | null;
+/**
+ * Check whether the Console portal has a pre-built `dist/` directory.
+ */
+export declare function hasConsoleDist(consolePath: string): boolean;
+/**
+ * Create a lightweight kernel plugin that serves the pre-built Console
+ * portal static files at `/_console/*`.
+ *
+ * Identical SPA-fallback semantics to `createStudioStaticPlugin` and
+ * `createAccountStaticPlugin`:
+ *   - `index.html` is read fresh on every fallback hit (so a rebuild
+ *     producing new hashed asset names doesn't leave the browser
+ *     pointing at stale URLs).
+ *   - Hashed asset paths under `/_console/assets/*` never SPA-fallback —
+ *     a real 404 surfaces a rebuild/deploy mismatch instead of the
+ *     dreaded "asset returns text/html" silent failure.
+ */
+export declare function createConsoleStaticPlugin(distPath: string, options?: {
+    isDev?: boolean;
+}): {
+    name: string;
+    init: () => Promise<void>;
+    start: (ctx: any) => Promise<void>;
+};
+//# sourceMappingURL=console.d.ts.map

package/dist/utils/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/utils/console.ts"],"names":[],"mappings":"AAwBA,0EAA0E;AAC1E,eAAO,MAAM,YAAY,cAAc,CAAC;AAIxC;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CA6ClD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE3D;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;;;iBAMlE,GAAG;EA6DzB"}

package/dist/utils/console.js

@@ -0,0 +1,169 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * Console UI Integration Utilities
+ *
+ * Mirrors `studio.ts` / `account.ts` but for the opinionated, fork-ready
+ * runtime console (`@objectstack/console`). The Console SPA is mounted at
+ * `/_console/` by every deployment that opts in (CLI dev server,
+ * self-host, Vercel) — exactly the same convention as `_studio` and
+ * `_account`. The Console is built with `base: '/_console/'`, so its
+ * pre-built `dist/` is served verbatim.
+ *
+ * Note: this module was previously named `dashboard.ts` (and the SPA was
+ * `apps/dashboard`). It was renamed to disambiguate from the spec-level
+ * `Dashboard` metadata type — the Console *renders* dashboards, it is not
+ * itself a dashboard.
+ */
+import path from 'path';
+import fs from 'fs';
+import { createRequire } from 'module';
+import { pathToFileURL } from 'url';
+// ─── Constants ──────────────────────────────────────────────────────
+/** URL mount path for the Console portal inside the ObjectStack server */
+export const CONSOLE_PATH = '/_console';
+// ─── Path Resolution ────────────────────────────────────────────────
+/**
+ * Resolve the filesystem path to the @objectstack/console package.
+ * Searches workspace locations first, then falls back to node_modules.
+ */
+export function resolveConsolePath() {
+    const cwd = process.cwd();
+    // Workspace candidates (monorepo layouts)
+    const candidates = [
+        path.resolve(cwd, 'apps/console'),
+        path.resolve(cwd, '../../apps/console'),
+        path.resolve(cwd, '../apps/console'),
+    ];
+    for (const candidate of candidates) {
+        const pkgPath = path.join(candidate, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                if (pkg.name === '@objectstack/console')
+                    return candidate;
+            }
+            catch {
+                // Skip invalid package.json
+            }
+        }
+    }
+    // Fallback: resolve from node_modules via createRequire.
+    const resolutionBases = [
+        pathToFileURL(path.join(cwd, 'package.json')).href, // consumer workspace
+        import.meta.url, // CLI package itself
+    ];
+    for (const base of resolutionBases) {
+        try {
+            const req = createRequire(base);
+            const resolved = req.resolve('@objectstack/console/package.json');
+            return path.dirname(resolved);
+        }
+        catch {
+            // Not resolvable from this base — try next
+        }
+    }
+    // Last resort: direct filesystem check in cwd/node_modules
+    const directPath = path.join(cwd, 'node_modules', '@objectstack', 'console');
+    if (fs.existsSync(path.join(directPath, 'package.json'))) {
+        return directPath;
+    }
+    return null;
+}
+/**
+ * Check whether the Console portal has a pre-built `dist/` directory.
+ */
+export function hasConsoleDist(consolePath) {
+    return fs.existsSync(path.join(consolePath, 'dist', 'index.html'));
+}
+// ─── Plugin Factory ─────────────────────────────────────────────────
+/**
+ * Create a lightweight kernel plugin that serves the pre-built Console
+ * portal static files at `/_console/*`.
+ *
+ * Identical SPA-fallback semantics to `createStudioStaticPlugin` and
+ * `createAccountStaticPlugin`:
+ *   - `index.html` is read fresh on every fallback hit (so a rebuild
+ *     producing new hashed asset names doesn't leave the browser
+ *     pointing at stale URLs).
+ *   - Hashed asset paths under `/_console/assets/*` never SPA-fallback —
+ *     a real 404 surfaces a rebuild/deploy mismatch instead of the
+ *     dreaded "asset returns text/html" silent failure.
+ */
+export function createConsoleStaticPlugin(distPath, options) {
+    return {
+        name: 'com.objectstack.console-static',
+        init: async () => { },
+        start: async (ctx) => {
+            const httpServer = ctx.getService?.('http.server');
+            if (!httpServer?.getRawApp) {
+                ctx.logger?.warn?.('Console static: http.server service not found — skipping');
+                return;
+            }
+            const app = httpServer.getRawApp();
+            const absoluteDist = path.resolve(distPath);
+            const indexPath = path.join(absoluteDist, 'index.html');
+            if (!fs.existsSync(indexPath)) {
+                ctx.logger?.warn?.(`Console static: dist not found at ${absoluteDist}`);
+                return;
+            }
+            const readIndexHtml = () => fs.readFileSync(indexPath, 'utf-8');
+            // In dev mode, the Console is the default UI surface — root `/`
+            // redirects here. Mirrors the convention Studio used to own; we now
+            // prefer the Console because it is the opinionated end-user surface.
+            if (options?.isDev) {
+                app.get('/', (c) => c.redirect(`${CONSOLE_PATH}/`));
+            }
+            // Redirect bare path to trailing-slash (SPA convention)
+            app.get(CONSOLE_PATH, (c) => c.redirect(`${CONSOLE_PATH}/`));
+            // Serve static files with SPA fallback
+            app.get(`${CONSOLE_PATH}/*`, async (c) => {
+                const reqPath = c.req.path.substring(CONSOLE_PATH.length) || '/';
+                const filePath = path.join(absoluteDist, reqPath);
+                // Security: prevent path traversal
+                if (!filePath.startsWith(absoluteDist)) {
+                    return c.text('Forbidden', 403);
+                }
+                // Try serving the exact file
+                if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
+                    const content = fs.readFileSync(filePath);
+                    return new Response(content, {
+                        headers: { 'content-type': mimeType(filePath) },
+                    });
+                }
+                // Hashed-asset paths must never SPA-fallback.
+                if (reqPath.startsWith('/assets/')) {
+                    return c.text('Not Found', 404);
+                }
+                // SPA fallback
+                return new Response(readIndexHtml(), {
+                    headers: { 'content-type': 'text/html; charset=utf-8' },
+                });
+            });
+            // Suppress unused-parameter lint when isDev isn't needed.
+            void options;
+        },
+    };
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.map': 'application/json',
+};
+function mimeType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return MIME_TYPES[ext] || 'application/octet-stream';
+}
+//# sourceMappingURL=console.js.map

package/dist/utils/console.js.map

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

package/dist/utils/extract-hook-body.d.ts

@@ -0,0 +1,13 @@
+export interface ExtractedBody {
+    /** Pure function-body source (without the surrounding `(ctx) => {...}`). */
+    source: string;
+    /** Inferred capability tokens — may be merged with explicit `// @capabilities` line. */
+    capabilities: Array<'api.read' | 'api.write' | 'crypto.uuid' | 'crypto.hash' | 'log'>;
+    /** True when source is a single expression (arrow with implicit return). */
+    isExpression: boolean;
+}
+/**
+ * Extract the body source from a callable. Throws on forbidden patterns.
+ */
+export declare function extractHookBody(fn: (...a: unknown[]) => unknown, originLabel: string): ExtractedBody;
+//# sourceMappingURL=extract-hook-body.d.ts.map

package/dist/utils/extract-hook-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-hook-body.d.ts","sourceRoot":"","sources":["../../src/utils/extract-hook-body.ts"],"names":[],"mappings":"AAgDA,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,YAAY,EAAE,KAAK,CAAC,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,KAAK,CAAC,CAAC;IACtF,4EAA4E;IAC5E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAmDpG"}