@elysiumjs/hephaestus 0.2.1 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # @elysiumjs/hephaestus
 
+## 0.3.3
+
+### Patch Changes
+
+- [`04773f2`](https://github.com/na2axl/elysiumjs/commit/04773f2acd4ab1c762a80ee903715d90f1c08e21) Thanks [@na2axl](https://github.com/na2axl)! - Ship the type declarations. The packages pointed `types` at `dist/index.d.ts` but their build never wrote it, so TypeScript projects got no types for them.
+
+## 0.3.2
+
+### Patch Changes
+
+- Updated dependencies [[`68a0cdd`](https://github.com/na2axl/elysiumjs/commit/68a0cdd8b2e4a003d6e0af2d78985623cae40428), [`2c49acd`](https://github.com/na2axl/elysiumjs/commit/2c49acd3b552aa43765d70339fa216961499e1b5), [`76ba0ff`](https://github.com/na2axl/elysiumjs/commit/76ba0ff18f3c196cebc2189426328f67cb699f46), [`4ebf029`](https://github.com/na2axl/elysiumjs/commit/4ebf029611e6d753a4f1bfdbe247a75d954d9ded), [`bacce71`](https://github.com/na2axl/elysiumjs/commit/bacce7146f667a1a46bf474dc0344fb0111ae12a)]:
+  - @elysiumjs/core@0.10.0
+
+## 0.3.1
+
+### Patch Changes
+
+- Updated dependencies [[`5fef4a7`](https://github.com/na2axl/elysiumjs/commit/5fef4a7199f502fc4fe035299e7670739459a108)]:
+  - @elysiumjs/core@0.9.0
+
+## 0.3.0
+
+### Minor Changes
+
+- [`8ac91ab`](https://github.com/na2axl/elysiumjs/commit/8ac91ab676b1119b4eecf0ddb3fd0a3e84017cac) Thanks [@na2axl](https://github.com/na2axl)! - Upgrade dependencies to their latest major versions: wampy 8, zod 4, commander 15, @casl/ability 7, OpenTelemetry SDK 2 (sdk-node 0.300, resources 3), @sentry/bun 11. Generated projects now use TypeScript 7.
+
+  Breaking in `@elysiumjs/mnemosyne-drizzle`: it now requires drizzle-orm 1.0 (release candidate) and generated projects use drizzle-kit 1.0. `ColumnsWithTable` is no longer re-exported. `migration:generate` writes 1.0 migration folders (`<timestamp>_<name>/migration.sql`), and `migration:run` tracks those by folder name while still running flat `*.sql` files. Existing projects can upgrade their migrations folder with `drizzle-kit up`: `migration:run` recognises the moved migrations as already applied and renames their records. The `make:model` stub now generates a `pgTable` and a `DrizzleModel` built from it.
+
+  Breaking in `@elysiumjs/core`: the deprecated `@elysiajs/swagger` plugin is replaced by `@elysiajs/openapi`, and the app option `swagger` is renamed `openapi` (typed `ElysiaOpenAPIConfig | false`). Without a `path`, the docs now live at `/openapi` instead of `/swagger`. The UI options `scalarConfig` and `swaggerOptions` are now `scalar` and `swagger`. Elysia stays on 1.4 (now `^1.4.30`) until Elysia 2 and its OpenAPI plugin are stable.
+
+  Also in `@elysiumjs/core`: the WAMP `onChallenge` callback must return a string (or a promise of one); `null` is no longer accepted. `onError` now receives the error and `onReconnectSuccess` receives wampy's details object. `WampClient` is now wampy's own `Wampy` type. `onOpen` is called by Elysium once the connection is established, since wampy 8 no longer has that callback.
+
+- [`07236b3`](https://github.com/na2axl/elysiumjs/commit/07236b386c2506590d74e8753ce847c1e184b3ee) Thanks [@na2axl](https://github.com/na2axl)! - Introduce the module system. Modules are now the only way to register anything in an Elysium.js app. This is a breaking change with no compatibility layer.
+
+  Breaking changes:
+
+  - `@Module.register()` takes `imports`, `services`, `exports`, `controllers`, `commands`, `jobs`, `prefix` and `env`. Services are private to their module unless exported (or global). The `beforeRegister` and `afterRegister` hooks are replaced by `onInit`, `onServe` and `onDestroy`.
+  - Configurable modules are bound with `with()`, for example `HermesModule.with({ level: 'debug' })`. `with()` accepts an object or a function.
+  - Decorators only record metadata. Importing a file no longer registers commands, services or event wiring, and the side-effect imports of the packages are removed. List commands, jobs and services in the module that owns them.
+  - `@Application.register()` no longer takes `database`, `redis`, `wamp` or `'elysium:hermes'`/`'elysium:cerberus'` keys. Use `DrizzleModule`, `RedisModule`, `WampModule`, `HermesModule` and `CerberusModule`. Package plugins are replaced by modules: add `SentryModule` instead of the `plugin()` function. `plugins` still accepts plain Elysia plugin factories.
+  - Constructing an `Application` no longer runs it. Use `await App.start()`; `Application.testing()` boots a module graph for tests. The `styx` binary loads `src/app.ts` (or `index.ts`) and starts the exported application, so a project entry no longer needs to import commands.
+  - The job system of core (`Job`, `Worker`, `WorkerPool`, `commandWork`) is removed. `@elysiumjs/heracles` is the only job system: extend its `Job`, list jobs in a module's `jobs`, declare queues with `HeraclesModule.with({ queues })`, and dispatch with `Heracles.dispatch()`.
+  - `@elysiumjs/styx` ships `StyxModule`, active in development only. The `migration:generate` and `migration:run` commands move to `DrizzleModule` and are available in production.
+  - `@elysiumjs/mnemosyne` ships `MnemosyneModule` for its caches (`redis: false` or `memory: false` opts out). `DrizzleModule` imports it.
+  - New modules: `HephaestusModule`, `ArgusModule` (`serviceName` is required), `SentryModule` (needs a `dsn` or `SENTRY_DSN`) and `CerberusModule` (`getSubject` is required).
+  - Module and service code throws typed errors (for example `InvalidModuleConfigError`) instead of exiting the process. `Application.run()` prints them and exits; command `run()` methods may still exit, and package plugin factories are unchanged.
+  - `Application.register` merges subclass props over the parent's (own props, then own metadata, then parent, then defaults), and concatenates `modules` parent first. Previously defaults and parent values won, so `openapi` could not be enabled.
+  - `Heracles.dispatch` starts a stopped queue on first use, so producers no longer start queues. `Queue.start()` is idempotent.
+  - `create-elysium` generates apps that use modules, and adds Sentry and Hephaestus to the `modules` list.
+  - `@Event.on`/`@Event.once` method listeners on classes in a loaded module's `services` or `controllers` are wired by the kernel and run in their module's context. Jobs, commands and middlewares are not wired, and an instance listener on a class that is not a service throws `EventListenerNotSupportedError`. Listeners on classes not listed in a loaded module no longer fire.
+  - New typed errors: `CircularDependencyError` (services that depend on each other, in sync and async resolution), `DuplicateModuleNameError` (two different module classes sharing a name; module scopes and config tokens are name based) and `EventListenerNotSupportedError`.
+  - Lazy boot contract: a CLI command initialises only its own module and that module's imports. Sync helpers such as `Database.getConnection()` work when the owning module's `onInit` is synchronous; otherwise they throw `ServiceNotReadyError` naming the module. Use `await Service.resolve()` or set `static boot = true` on the command.
+
+### Patch Changes
+
+- Updated dependencies [[`8ac91ab`](https://github.com/na2axl/elysiumjs/commit/8ac91ab676b1119b4eecf0ddb3fd0a3e84017cac), [`3625883`](https://github.com/na2axl/elysiumjs/commit/3625883dba92f1596e7444ee52f9399d8e9b049f), [`07236b3`](https://github.com/na2axl/elysiumjs/commit/07236b386c2506590d74e8753ce847c1e184b3ee)]:
+  - @elysiumjs/core@0.8.0
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -1,15 +1,31 @@
 # @elysiumjs/hephaestus
 
-To install dependencies:
+Build tooling for Elysium.js applications: standalone binaries, Docker images and embedded assets.
+
+## Installation
 
 ```bash
-bun install
+bun add @elysiumjs/hephaestus
 ```
 
-To run:
+Install it as a regular dependency, not a dev dependency: `HephaestusModule` is imported by your application at runtime.
 
-```bash
-bun run index.ts
+## Usage
+
+Add `HephaestusModule` to the modules of your application. It provides the Hephaestus commands to `styx`.
+
+```ts
+import { Application } from '@elysiumjs/core';
+import { HephaestusModule } from '@elysiumjs/hephaestus';
+
+@Application.register({
+	modules: [HephaestusModule /* , your other modules */]
+})
+export class App extends Application {}
 ```
 
-This project was created using `bun init` in bun v1.2.16. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
+Then run `bun styx list` to see the available commands.
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See the [LICENSE](../../LICENSE) file for more info.

package/dist/assets/embedder.d.ts

@@ -0,0 +1,38 @@
+import type { HephaestusConfig } from '../types';
+/**
+ * Manifest mapping asset paths to their base64 content and MIME type.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export interface AssetManifest {
+    [path: string]: {
+        content: string;
+        mimeType: string;
+    };
+}
+/**
+ * Embeds assets into a generated loader module for use in compiled binaries.
+ *
+ * For static assets known at development time, prefer Bun's native file embedding:
+ * ```typescript
+ * import icon from './icon.png' with { type: 'file' };
+ * const bytes = await Bun.file(icon).arrayBuffer();
+ * ```
+ *
+ * This class is for dynamic glob-based embedding from config.
+ *
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class AssetEmbedder {
+    private config;
+    constructor(config: HephaestusConfig);
+    /**
+     * Scans for assets matching the config patterns and generates a loader module.
+     * @author Axel Nana <axel.nana@workbud.com>
+     * @returns A string containing the generated asset loader module.
+     */
+    embed(): Promise<string>;
+    private buildManifest;
+    private isExcluded;
+    private generateLoader;
+    private getMimeType;
+}

package/dist/assets/index.d.ts

@@ -0,0 +1 @@
+export { type AssetManifest, AssetEmbedder } from './embedder';

package/dist/builder/binary.builder.d.ts

@@ -0,0 +1,32 @@
+import type { HephaestusConfig, PlatformTarget } from '../types';
+/**
+ * Result of a single binary compilation.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export interface BuildResult {
+    platform: PlatformTarget;
+    outputPath: string;
+    size: number;
+    duration: number;
+}
+/**
+ * Compiles Elysium projects into single-binary executables using Bun.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class BinaryBuilder {
+    private config;
+    constructor(config: HephaestusConfig);
+    /**
+     * Builds a single binary for a specific platform, or the current one if not specified.
+     * @author Axel Nana <axel.nana@workbud.com>
+     * @param platform The target platform. Defaults to the current platform.
+     * @returns The build result with metrics.
+     */
+    build(platform?: PlatformTarget): Promise<BuildResult>;
+    /**
+     * Builds binaries for all configured platforms, or the current one if none are configured.
+     * @author Axel Nana <axel.nana@workbud.com>
+     * @returns An array of build results.
+     */
+    buildAll(): Promise<BuildResult[]>;
+}

package/dist/builder/index.d.ts

@@ -0,0 +1 @@
+export { type BuildResult, BinaryBuilder } from './binary.builder';

package/dist/commands/build.command.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@elysiumjs/core';
+/**
+ * Command used to build the project into a standalone binary.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HephaestusBuildCommand extends Command {
+    static readonly command: string;
+    static readonly description: string;
+    static readonly dev: boolean;
+    private platform?;
+    private allPlatforms;
+    run(): Promise<void>;
+    private formatSize;
+}

package/dist/commands/docker.command.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@elysiumjs/core';
+/**
+ * Command used to generate a Dockerfile for the compiled binary.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HephaestusDockerCommand extends Command {
+    static readonly command: string;
+    static readonly description: string;
+    static readonly dev: boolean;
+    private output;
+    run(): Promise<void>;
+}

package/dist/commands/docker.generator.d.ts

@@ -0,0 +1,20 @@
+import type { HephaestusConfig } from '../types';
+/**
+ * Generates a multi-stage Dockerfile for compiled Elysium binaries.
+ *
+ * The runtime stage uses Alpine (not Bun) because the compiled binary
+ * is self-contained. Healthcheck uses `wget` (available in Alpine base).
+ *
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class DockerGenerator {
+    private config;
+    constructor(config: HephaestusConfig);
+    /**
+     * Generates the Dockerfile and writes it to the output directory.
+     * @author Axel Nana <axel.nana@workbud.com>
+     * @param outputDir The directory to write the Dockerfile to.
+     */
+    generate(outputDir: string): void;
+    private renderDockerfile;
+}

package/dist/commands/embed.command.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@elysiumjs/core';
+/**
+ * Command used to generate asset loader module from configured patterns.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HephaestusEmbedCommand extends Command {
+    static readonly command: string;
+    static readonly description: string;
+    static readonly dev: boolean;
+    run(): Promise<void>;
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,3 @@
+export * from './build.command';
+export * from './embed.command';
+export * from './docker.command';

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export { loadConfig } from './loader';

package/dist/config/loader.d.ts

@@ -0,0 +1,8 @@
+import type { HephaestusConfig } from '../types';
+/**
+ * Loads and validates the Hephaestus build configuration from the project root.
+ * @author Axel Nana <axel.nana@workbud.com>
+ * @param cwd The working directory to search for config files.
+ * @returns The validated configuration.
+ */
+export declare function loadConfig(cwd?: string): Promise<HephaestusConfig>;

package/dist/hephaestus.module.d.ts

@@ -0,0 +1,7 @@
+import { Module } from '@elysiumjs/core';
+/**
+ * Exposes the Hephaestus build tooling commands.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HephaestusModule extends Module {
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { HephaestusModule } from './hephaestus.module';
+export type { HephaestusConfig, PlatformTarget } from './types';
+export { HephaestusConfigSchema, PlatformTargetSchema } from './types';
+export type { BuildResult } from './builder';
+export { BinaryBuilder } from './builder';
+export type { AssetManifest } from './assets';
+export { AssetEmbedder } from './assets';
+export { DockerGenerator } from './commands/docker.generator';
+export { loadConfig } from './config';
+export { bunTarget, detectCurrentPlatform, getOutputName } from './platform';

package/dist/index.js

@@ -1,6 +1,6 @@
 // @bun
-var h=function(e,i,L,I){var c=arguments.length,n=c<3?i:I===null?I=Object.getOwnPropertyDescriptor(i,L):I,S;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")n=Reflect.decorate(e,i,L,I);else for(var T=e.length-1;T>=0;T--)if(S=e[T])n=(c<3?S(n):c>3?S(i,L,n):S(i,L))||n;return c>3&&n&&Object.defineProperty(i,L,n),n};var O=(e,i)=>{if(typeof Reflect==="object"&&typeof Reflect.metadata==="function")return Reflect.metadata(e,i)};import"@elysiumjs/core";import{Command as y,CommandArgumentType as q}from"@elysiumjs/core";import{join as F}from"path";var D={"linux-x64":"bun-linux-x64","linux-x64-baseline":"bun-linux-x64-baseline","linux-arm64":"bun-linux-arm64","darwin-x64":"bun-darwin-x64","darwin-arm64":"bun-darwin-arm64","windows-x64":"bun-windows-x64"};function R(e){return D[e]}function w(){let{platform:e,arch:i}=process;if(e==="linux"&&i==="x64")return"linux-x64";if(e==="linux"&&i==="arm64")return"linux-arm64";if(e==="darwin"&&i==="x64")return"darwin-x64";if(e==="darwin"&&i==="arm64")return"darwin-arm64";if(e==="win32"&&i==="x64")return"windows-x64";return"linux-x64"}function W(e,i){return i.startsWith("windows")?`${e}.exe`:e}class g{config;constructor(e){this.config=e}async build(e){let i=Date.now(),L=e??w(),I=W(this.config.output.name,L),c=F(this.config.output.dir,I),n=["bun","build",this.config.entry,"--compile","--outfile",c];if(this.config.build.minify)n.push("--minify");if(this.config.build.sourcemap)n.push("--sourcemap");if(e&&e!==w())n.push("--target",R(e));let S=Bun.spawn(n,{stdout:"pipe",stderr:"pipe"});if(await S.exited!==0){let B=await new Response(S.stderr).text();throw Error(`Build failed for ${L}: ${B}`)}let V=Bun.file(c).size;return{platform:L,outputPath:c,size:V,duration:Date.now()-i}}async buildAll(){let e=this.config.platforms;if(e.length===0)return[await this.build()];let i=[];for(let L of e)i.push(await this.build(L));return i}}import{join as J}from"path";import{z as s}from"zod";var r=s.enum(["linux-x64","linux-x64-baseline","linux-arm64","darwin-x64","darwin-arm64","windows-x64"]),N=s.object({entry:s.string().default("./src/index.ts"),output:s.object({name:s.string(),dir:s.string().default("./dist")}),platforms:s.array(r).default([]),build:s.object({minify:s.boolean().default(!0),sourcemap:s.boolean().default(!0),bytecode:s.boolean().default(!0),split:s.boolean().default(!1)}).default({}),assets:s.object({embed:s.array(s.string()).default([]),exclude:s.array(s.string()).default([])}).default({}),env:s.object({generateExample:s.boolean().default(!0)}).default({}),docker:s.object({enabled:s.boolean().default(!1),buildImage:s.string().default("oven/bun:1-alpine"),runtimeImage:s.string().default("alpine:3.19"),expose:s.array(s.number()).default([]),healthcheck:s.object({path:s.string().default("/health"),interval:s.string().default("30s")}).optional()}).optional(),release:s.object({include:s.array(s.string()).default([]),compress:s.enum(["zip","tar.gz"]).default("tar.gz")}).optional()});var v=["hephaestus.config.ts","hephaestus.config.js","hephaestus.config.json"];async function A(e=process.cwd()){for(let i of v){let L=J(e,i),I=Bun.file(L);if(await I.exists()){if(i.endsWith(".json")){let n=await I.json();return N.parse(n)}let c=await import(L);return N.parse(c.default??c)}}throw Error(`No Hephaestus config found. Create one of: ${v.join(", ")}`)}class Y extends y{constructor(){super(...arguments);this.allPlatforms=!1}static command="hephaestus:build";static description="Build the project into a standalone binary.";static dev=!0;async run(){try{let e=await A(),i=new g(e);if(this.allPlatforms){let L=this.spinner("Building for all platforms"),I=await i.buildAll();L.complete("Build completed"),this.newLine(),this.title("Build Results:");for(let c of I)this.info(`${c.platform}: ${c.outputPath} (${this.formatSize(c.size)}, ${c.duration}ms)`)}else{let L=this.platform,I=L?` for ${L}`:"",c=this.spinner(`Building${I}`),n=await i.build(L);c.complete("Build completed"),this.newLine(),this.success(`Built ${n.platform}: ${n.outputPath} (${this.formatSize(n.size)}, ${n.duration}ms)`)}}catch(e){this.trace(e,"Build failed"),process.exit(1)}}formatSize(e){if(e<1024)return`${e}B`;if(e<1048576)return`${(e/1024).toFixed(1)}KB`;return`${(e/1048576).toFixed(1)}MB`}}h([y.arg({name:"platform",required:!1,description:"Target platform for the build",type:q.ENUM,enum:["linux-x64","linux-x64-baseline","linux-arm64","darwin-x64","darwin-arm64","windows-x64"]}),O("design:type",typeof PlatformTarget==="undefined"?Object:PlatformTarget)],Y.prototype,"platform",void 0),h([y.arg({name:"all-platforms",required:!1,description:"Build for all configured platforms",type:q.BOOLEAN,default:!1}),O("design:type",Boolean)],Y.prototype,"allPlatforms",void 0),Y=h([y.register()],Y);import{join as X}from"path";import{Command as K}from"@elysiumjs/core";import{relative as Q}from"path";class p{config;constructor(e){this.config=e}async embed(){let e=await this.buildManifest();return this.generateLoader(e)}async buildManifest(){let e={},i=this.config.assets.embed;for(let L of i){let I=new Bun.Glob(L);for await(let c of I.scan({cwd:process.cwd(),absolute:!0})){if(this.isExcluded(c))continue;let n=await Bun.file(c).arrayBuffer(),S=Q(process.cwd(),c);e[S]={content:Buffer.from(n).toString("base64"),mimeType:this.getMimeType(c)}}}return e}isExcluded(e){return this.config.assets.exclude.some((i)=>{return new Bun.Glob(i).match(e)})}generateLoader(e){return`// Auto-generated by Hephaestus
-const __assets__ = ${JSON.stringify(e,null,2)};
+var __legacyDecorateClassTS=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)if(d=decorators[i])r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r;return c>3&&r&&Object.defineProperty(target,key,r),r};var __legacyMetadataTS=(k,v)=>{if(typeof Reflect==="object"&&typeof Reflect.metadata==="function")return Reflect.metadata(k,v)};import{Module}from"@elysiumjs/core";import{Command,CommandArgumentType}from"@elysiumjs/core";import{join}from"path";var BUN_TARGET_MAP={"linux-x64":"bun-linux-x64","linux-x64-baseline":"bun-linux-x64-baseline","linux-arm64":"bun-linux-arm64","darwin-x64":"bun-darwin-x64","darwin-arm64":"bun-darwin-arm64","windows-x64":"bun-windows-x64"};function bunTarget(platform){return BUN_TARGET_MAP[platform]}function detectCurrentPlatform(){let platform=process.platform,arch=process.arch;if(platform==="linux"&&arch==="x64")return"linux-x64";if(platform==="linux"&&arch==="arm64")return"linux-arm64";if(platform==="darwin"&&arch==="x64")return"darwin-x64";if(platform==="darwin"&&arch==="arm64")return"darwin-arm64";if(platform==="win32"&&arch==="x64")return"windows-x64";return"linux-x64"}function getOutputName(baseName,platform){return platform.startsWith("windows")?`${baseName}.exe`:baseName}class BinaryBuilder{config;constructor(config){this.config=config}async build(platform){let startTime=Date.now(),targetPlatform=platform??detectCurrentPlatform(),outputName=getOutputName(this.config.output.name,targetPlatform),outputPath=join(this.config.output.dir,outputName),args=["bun","build",this.config.entry,"--compile","--outfile",outputPath];if(this.config.build.minify)args.push("--minify");if(this.config.build.sourcemap)args.push("--sourcemap");if(platform&&platform!==detectCurrentPlatform())args.push("--target",bunTarget(platform));let proc=Bun.spawn(args,{stdout:"pipe",stderr:"pipe"});if(await proc.exited!==0){let stderr=await new Response(proc.stderr).text();throw Error(`Build failed for ${targetPlatform}: ${stderr}`)}let size=Bun.file(outputPath).size;return{platform:targetPlatform,outputPath,size,duration:Date.now()-startTime}}async buildAll(){let platforms=this.config.platforms;if(platforms.length===0)return[await this.build()];let results=[];for(let platform of platforms)results.push(await this.build(platform));return results}}import{join as join2}from"path";import{z}from"zod";var PlatformTargetSchema=z.enum(["linux-x64","linux-x64-baseline","linux-arm64","darwin-x64","darwin-arm64","windows-x64"]),HephaestusConfigSchema=z.object({entry:z.string().default("./src/index.ts"),output:z.object({name:z.string(),dir:z.string().default("./dist")}),platforms:z.array(PlatformTargetSchema).default([]),build:z.object({minify:z.boolean().default(!0),sourcemap:z.boolean().default(!0),bytecode:z.boolean().default(!0),split:z.boolean().default(!1)}).prefault({}),assets:z.object({embed:z.array(z.string()).default([]),exclude:z.array(z.string()).default([])}).prefault({}),env:z.object({generateExample:z.boolean().default(!0)}).prefault({}),docker:z.object({enabled:z.boolean().default(!1),buildImage:z.string().default("oven/bun:1-alpine"),runtimeImage:z.string().default("alpine:3.19"),expose:z.array(z.number()).default([]),healthcheck:z.object({path:z.string().default("/health"),interval:z.string().default("30s")}).optional()}).optional(),release:z.object({include:z.array(z.string()).default([]),compress:z.enum(["zip","tar.gz"]).default("tar.gz")}).optional()});var CONFIG_FILENAMES=["hephaestus.config.ts","hephaestus.config.js","hephaestus.config.json"];async function loadConfig(cwd=process.cwd()){for(let filename of CONFIG_FILENAMES){let configPath=join2(cwd,filename),file=Bun.file(configPath);if(await file.exists()){if(filename.endsWith(".json")){let raw=await file.json();return HephaestusConfigSchema.parse(raw)}let mod=await import(configPath);return HephaestusConfigSchema.parse(mod.default??mod)}}throw Error(`No Hephaestus config found. Create one of: ${CONFIG_FILENAMES.join(", ")}`)}class HephaestusBuildCommand extends Command{constructor(){super(...arguments);this.allPlatforms=!1}static command="hephaestus:build";static description="Build the project into a standalone binary.";static dev=!0;async run(){try{let config=await loadConfig(),builder=new BinaryBuilder(config);if(this.allPlatforms){let spinner=this.spinner("Building for all platforms"),results=await builder.buildAll();spinner.complete("Build completed"),this.newLine(),this.title("Build Results:");for(let result of results)this.info(`${result.platform}: ${result.outputPath} (${this.formatSize(result.size)}, ${result.duration}ms)`)}else{let targetPlatform=this.platform,platformText=targetPlatform?` for ${targetPlatform}`:"",spinner=this.spinner(`Building${platformText}`),result=await builder.build(targetPlatform);spinner.complete("Build completed"),this.newLine(),this.success(`Built ${result.platform}: ${result.outputPath} (${this.formatSize(result.size)}, ${result.duration}ms)`)}}catch(error){this.trace(error,"Build failed"),process.exit(1)}}formatSize(bytes){if(bytes<1024)return`${bytes}B`;if(bytes<1048576)return`${(bytes/1024).toFixed(1)}KB`;return`${(bytes/1048576).toFixed(1)}MB`}}__legacyDecorateClassTS([Command.arg({name:"platform",required:!1,description:"Target platform for the build",type:CommandArgumentType.ENUM,enum:["linux-x64","linux-x64-baseline","linux-arm64","darwin-x64","darwin-arm64","windows-x64"]}),__legacyMetadataTS("design:type",typeof PlatformTarget==="undefined"?Object:PlatformTarget)],HephaestusBuildCommand.prototype,"platform",void 0),__legacyDecorateClassTS([Command.arg({name:"all-platforms",required:!1,description:"Build for all configured platforms",type:CommandArgumentType.BOOLEAN,default:!1}),__legacyMetadataTS("design:type",Boolean)],HephaestusBuildCommand.prototype,"allPlatforms",void 0),HephaestusBuildCommand=__legacyDecorateClassTS([Command.register()],HephaestusBuildCommand);import{join as join3}from"path";import{Command as Command2}from"@elysiumjs/core";import{relative}from"path";class AssetEmbedder{config;constructor(config){this.config=config}async embed(){let manifest=await this.buildManifest();return this.generateLoader(manifest)}async buildManifest(){let manifest={},patterns=this.config.assets.embed;for(let pattern of patterns){let glob=new Bun.Glob(pattern);for await(let file of glob.scan({cwd:process.cwd(),absolute:!0})){if(this.isExcluded(file))continue;let content=await Bun.file(file).arrayBuffer(),relativePath=relative(process.cwd(),file);manifest[relativePath]={content:Buffer.from(content).toString("base64"),mimeType:this.getMimeType(file)}}}return manifest}isExcluded(filePath){return this.config.assets.exclude.some((pattern)=>new Bun.Glob(pattern).match(filePath))}generateLoader(manifest){return`// Auto-generated by Hephaestus
+const __assets__ = ${JSON.stringify(manifest,null,2)};
 
 export function getAsset(path: string): Buffer | null {
   const asset = __assets__[path];
@@ -16,18 +16,18 @@ export function getAssetString(path: string): string | null {
 export function listAssets(): string[] {
   return Object.keys(__assets__);
 }
-`}getMimeType(e){let i=e.split(".").pop()?.toLowerCase();return{html:"text/html",css:"text/css",js:"application/javascript",json:"application/json",png:"image/png",jpg:"image/jpeg",svg:"image/svg+xml"}[i??""]??"application/octet-stream"}}class x extends K{static command="hephaestus:embed";static description="Generate asset loader module from configured patterns.";static dev=!0;async run(){try{let e=this.spinner("Scanning and embedding assets"),i=await A(),I=await new p(i).embed(),c=X(i.output.dir,"__assets__.ts");await Bun.write(c,I),e.complete("Assets embedded successfully"),this.newLine(),this.success(`Asset loader generated: ${c}`)}catch(e){this.trace(e,"Asset embedding failed"),process.exit(1)}}}x=h([K.register()],x);import{Command as E,CommandArgumentType as G}from"@elysiumjs/core";import{mkdirSync as Z,writeFileSync as $}from"fs";import{join as M}from"path";class t{config;constructor(e){this.config=e}generate(e){Z(e,{recursive:!0});let i=this.renderDockerfile();$(M(e,"Dockerfile"),i)}renderDockerfile(){let e=this.config.docker?.buildImage??"oven/bun:1-alpine",i=this.config.docker?.runtimeImage??"alpine:3.19",L=this.config.output.name,I=this.config.docker?.expose??[],c=this.config.docker?.healthcheck;return`# Generated by Hephaestus
-FROM ${e} AS builder
+`}getMimeType(path){let ext=path.split(".").pop()?.toLowerCase();return{html:"text/html",css:"text/css",js:"application/javascript",json:"application/json",png:"image/png",jpg:"image/jpeg",svg:"image/svg+xml"}[ext??""]??"application/octet-stream"}}class HephaestusEmbedCommand extends Command2{static command="hephaestus:embed";static description="Generate asset loader module from configured patterns.";static dev=!0;async run(){try{let spinner=this.spinner("Scanning and embedding assets"),config=await loadConfig(),loader=await new AssetEmbedder(config).embed(),outputPath=join3(config.output.dir,"__assets__.ts");await Bun.write(outputPath,loader),spinner.complete("Assets embedded successfully"),this.newLine(),this.success(`Asset loader generated: ${outputPath}`)}catch(error){this.trace(error,"Asset embedding failed"),process.exit(1)}}}HephaestusEmbedCommand=__legacyDecorateClassTS([Command2.register()],HephaestusEmbedCommand);import{Command as Command3,CommandArgumentType as CommandArgumentType2}from"@elysiumjs/core";import{mkdirSync,writeFileSync}from"fs";import{join as join4}from"path";class DockerGenerator{config;constructor(config){this.config=config}generate(outputDir){mkdirSync(outputDir,{recursive:!0});let dockerfile=this.renderDockerfile();writeFileSync(join4(outputDir,"Dockerfile"),dockerfile)}renderDockerfile(){let buildImage=this.config.docker?.buildImage??"oven/bun:1-alpine",runtimeImage=this.config.docker?.runtimeImage??"alpine:3.19",binaryName=this.config.output.name,expose=this.config.docker?.expose??[],healthcheck=this.config.docker?.healthcheck;return`# Generated by Hephaestus
+FROM ${buildImage} AS builder
 WORKDIR /app
 COPY . .
 RUN bun install --frozen-lockfile --production
 RUN bun run build
 
-FROM ${i}
+FROM ${runtimeImage}
 WORKDIR /app
-COPY --from=builder /app/dist/${L} /app/${L}
-${I.map((n)=>`EXPOSE ${n}`).join(`
+COPY --from=builder /app/dist/${binaryName} /app/${binaryName}
+${expose.map((p)=>`EXPOSE ${p}`).join(`
 `)}
-${c?`HEALTHCHECK --interval=${c.interval} CMD wget -qO- http://localhost:${I[0]??3000}${c.path} || exit 1`:""}
-ENTRYPOINT ["./${L}"]
-`}}class U extends E{constructor(){super(...arguments);this.output="."}static command="hephaestus:docker";static description="Generate a Dockerfile for the compiled binary.";static dev=!0;async run(){try{let e=await A();new t(e).generate(this.output),this.success(`Dockerfile generated in ${this.output}`)}catch(e){this.trace(e,"Dockerfile generation failed"),process.exit(1)}}}h([E.arg({name:"output",required:!1,description:"Output directory for the Dockerfile",type:G.STRING,default:"."}),O("design:type",String)],U.prototype,"output",void 0),U=h([E.register()],U);export{A as loadConfig,W as getOutputName,w as detectCurrentPlatform,R as bunTarget,r as PlatformTargetSchema,N as HephaestusConfigSchema,t as DockerGenerator,g as BinaryBuilder,p as AssetEmbedder};
+${healthcheck?`HEALTHCHECK --interval=${healthcheck.interval} CMD wget -qO- http://localhost:${expose[0]??3000}${healthcheck.path} || exit 1`:""}
+ENTRYPOINT ["./${binaryName}"]
+`}}class HephaestusDockerCommand extends Command3{constructor(){super(...arguments);this.output="."}static command="hephaestus:docker";static description="Generate a Dockerfile for the compiled binary.";static dev=!0;async run(){try{let config=await loadConfig();new DockerGenerator(config).generate(this.output),this.success(`Dockerfile generated in ${this.output}`)}catch(error){this.trace(error,"Dockerfile generation failed"),process.exit(1)}}}__legacyDecorateClassTS([Command3.arg({name:"output",required:!1,description:"Output directory for the Dockerfile",type:CommandArgumentType2.STRING,default:"."}),__legacyMetadataTS("design:type",String)],HephaestusDockerCommand.prototype,"output",void 0),HephaestusDockerCommand=__legacyDecorateClassTS([Command3.register()],HephaestusDockerCommand);class HephaestusModule extends Module{}HephaestusModule=__legacyDecorateClassTS([Module.register({commands:[HephaestusBuildCommand,HephaestusDockerCommand,HephaestusEmbedCommand]})],HephaestusModule);export{AssetEmbedder,BinaryBuilder,DockerGenerator,HephaestusConfigSchema,HephaestusModule,PlatformTargetSchema,bunTarget,detectCurrentPlatform,getOutputName,loadConfig};

package/dist/platform/index.d.ts

@@ -0,0 +1 @@
+export { bunTarget, detectCurrentPlatform, getOutputName } from './targets';

package/dist/platform/targets.d.ts

@@ -0,0 +1,22 @@
+import type { PlatformTarget } from '../types';
+/**
+ * Converts a Hephaestus platform target to a Bun target string.
+ * @author Axel Nana <axel.nana@workbud.com>
+ * @param platform The Hephaestus platform target.
+ * @returns The Bun `--target` value.
+ */
+export declare function bunTarget(platform: PlatformTarget): string;
+/**
+ * Detects the current platform and returns the corresponding target.
+ * @author Axel Nana <axel.nana@workbud.com>
+ * @returns The detected platform target.
+ */
+export declare function detectCurrentPlatform(): PlatformTarget;
+/**
+ * Returns the output file name for a given platform.
+ * @author Axel Nana <axel.nana@workbud.com>
+ * @param baseName The base binary name.
+ * @param platform The target platform.
+ * @returns The platform-specific output file name.
+ */
+export declare function getOutputName(baseName: string, platform: PlatformTarget): string;

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+/**
+ * Supported compilation target platforms.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare const PlatformTargetSchema: z.ZodEnum<{
+    "darwin-arm64": "darwin-arm64";
+    "darwin-x64": "darwin-x64";
+    "linux-arm64": "linux-arm64";
+    "linux-x64": "linux-x64";
+    "linux-x64-baseline": "linux-x64-baseline";
+    "windows-x64": "windows-x64";
+}>;
+/**
+ * A supported compilation target platform.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export type PlatformTarget = z.infer<typeof PlatformTargetSchema>;
+/**
+ * Hephaestus build configuration schema.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare const HephaestusConfigSchema: z.ZodObject<{
+    entry: z.ZodDefault<z.ZodString>;
+    output: z.ZodObject<{
+        name: z.ZodString;
+        dir: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        "darwin-arm64": "darwin-arm64";
+        "darwin-x64": "darwin-x64";
+        "linux-arm64": "linux-arm64";
+        "linux-x64": "linux-x64";
+        "linux-x64-baseline": "linux-x64-baseline";
+        "windows-x64": "windows-x64";
+    }>>>;
+    build: z.ZodPrefault<z.ZodObject<{
+        minify: z.ZodDefault<z.ZodBoolean>;
+        sourcemap: z.ZodDefault<z.ZodBoolean>;
+        bytecode: z.ZodDefault<z.ZodBoolean>;
+        split: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    assets: z.ZodPrefault<z.ZodObject<{
+        embed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    env: z.ZodPrefault<z.ZodObject<{
+        generateExample: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    docker: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        buildImage: z.ZodDefault<z.ZodString>;
+        runtimeImage: z.ZodDefault<z.ZodString>;
+        expose: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        healthcheck: z.ZodOptional<z.ZodObject<{
+            path: z.ZodDefault<z.ZodString>;
+            interval: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    release: z.ZodOptional<z.ZodObject<{
+        include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        compress: z.ZodDefault<z.ZodEnum<{
+            "tar.gz": "tar.gz";
+            zip: "zip";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Hephaestus build configuration.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export type HephaestusConfig = z.infer<typeof HephaestusConfigSchema>;

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@elysiumjs/hephaestus",
-  "version": "0.2.1",
+  "version": "0.3.3",
   "license": "Apache-2.0",
   "description": "Compilation and bundling utilities for Elysium.js apps.",
   "private": false,
   "author": "Workbud Technologies Inc.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/workbud/elysium"
+    "url": "git+https://github.com/na2axl/elysiumjs.git",
+    "directory": "@elysiumjs/hephaestus"
   },
   "keywords": [
     "elysium",
@@ -19,15 +20,23 @@
     "compilation",
     "bun"
   ],
-  "homepage": "https://github.com/workbud/elysium",
-  "module": "index.ts",
+  "homepage": "https://github.com/na2axl/elysiumjs/tree/main/@elysiumjs/hephaestus#readme",
+  "bugs": {
+    "url": "https://github.com/na2axl/elysiumjs/issues"
+  },
+  "module": "dist/index.js",
   "type": "module",
+  "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "format": "prettier --write \"./src/**/*.ts\"",
     "clean": "rimraf dist",
-    "build:js": "bun build ./src/index.ts --outdir ./dist --target bun -e zod -e @elysiumjs/core --root ./src --minify",
+    "build:js": "bun build ./src/index.ts --outdir ./dist --target bun -e zod -e @elysiumjs/core --root ./src --minify-syntax --minify-whitespace",
     "build:ts": "tsc",
     "build": "bun run clean && bun run build:js && bun run build:ts",
     "test": "bun test",
@@ -36,12 +45,12 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "zod": "^3.23.0"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@elysiumjs/core": "0.6.1"
+    "@elysiumjs/core": "0.10.0"
   },
   "peerDependencies": {
-    "@elysiumjs/core": "^0.6.1"
+    "@elysiumjs/core": "^0.10.0"
   }
 }