@aromix/core 0.0.0

package/dist/index.d.cts

@@ -0,0 +1,234 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
+type Platform = "node" | "bun" | "cloudflare:worker";
+type Format = "esm" | "cjs";
+interface AromixBuildConfig {
+    entry: string;
+    outDir: string;
+    platform: Platform;
+    format: Format;
+    tsconfig: string;
+    sourcemap: boolean;
+    minify: boolean;
+}
+/** Identity fn :: exists purely for autocomplete and type safety */
+declare function build(options: AromixBuildConfig): AromixBuildConfig;
+
+interface Config {
+}
+declare function config<T extends Config>(config: T | (() => T)): T;
+
+interface BaseCtx {
+    id: string;
+    payload: unknown;
+    args<T>(schema: StandardSchemaV1<T>): T;
+}
+interface CommandCtx extends BaseCtx {
+}
+interface StreamCtx extends BaseCtx {
+}
+interface SocketCtx<Receive extends EventMap, Send extends EventMap> extends BaseCtx {
+    on<E extends keyof Receive>(event: E, handler: (data: Receive[E]) => void | Promise<void>): void;
+    send<E extends keyof Send>(event: E, data: Send[E]): void;
+    onClose(handler: () => void): void;
+    close(): void;
+}
+type EventMap = Record<string, unknown>;
+
+interface Entity {
+}
+declare function entity(options: Entity): void;
+
+declare const Codec: {
+    encode(data: unknown): Uint8Array;
+    decode(buf: Uint8Array): unknown;
+    fromRequest(req: Request): Promise<unknown>;
+    response(data: unknown): Response;
+};
+
+declare function toFetchHandler(): void;
+
+type RequestHook = (ctx: BaseCtx) => Response | void | Promise<Response | void>;
+type ResponseHook = (ctx: BaseCtx, res: Response) => Response | void | Promise<Response | void>;
+type ErrorHook = (err: unknown, ctx: BaseCtx) => Response | void | Promise<Response | void>;
+type Hook = {
+    on: "Ready";
+    run: (config: Config) => void | Promise<void>;
+} | {
+    on: "Close";
+    run: (config: Config) => void | Promise<void>;
+} | {
+    on: "Request";
+    run: RequestHook;
+} | {
+    on: "Response";
+    run: ResponseHook;
+} | {
+    on: "Error";
+    run: ErrorHook;
+};
+
+declare function hook<T extends Hook["on"]>(on: T, run: Extract<Hook, {
+    on: T;
+}>["run"]): Extract<Hook, {
+    on: T;
+}>;
+
+/**
+ * load() — cross-runtime glob file resolver with tsconfig path alias support.
+ *
+ * Returns resolved absolute file paths. Does NOT import — caller drives imports.
+ *
+ * Supported glob features:
+ *   *       — matches any segment (not path separators)
+ *   **      — matches any depth (where supported by runtime FS walk)
+ *   {a,b}   — brace expansion
+ *   @alias  — tsconfig `paths` aliases
+ *
+ * Runtimes: Node.js, Bun, Deno, Cloudflare Workers (Workers: alias-only, no FS)
+ *
+ * Usage:
+ *   const paths = load('@config/*')
+ *   const paths = load(['@entity/*.entity.{ts,js}', './app/users/*.ts'])
+ *
+ *   make({ entity: load('@entity/*') })
+ *   async function make(pathMap: Record<string, string[]>) {
+ *     for (const [key, paths] of Object.entries(pathMap)) {
+ *       for (const p of paths) {
+ *         const mod = await import(p)
+ *         // ...
+ *       }
+ *     }
+ *   }
+ */
+type GlobPattern = string | string[];
+interface LoadOptions {
+    /** Working directory for relative patterns. Defaults to process.cwd() / Deno.cwd(). */
+    cwd?: string;
+    /** Path to tsconfig.json. Auto-discovered from cwd upward if not provided. */
+    tsconfig?: string;
+    /** Include dotfiles. Default: false. */
+    dot?: boolean;
+    /** Only return files (not directories). Default: true. */
+    filesOnly?: boolean;
+}
+/**
+ * Resolves a glob pattern (or array of patterns) to absolute file paths.
+ * Supports tsconfig path aliases, `*` globs, and `{a,b}` brace expansion.
+ *
+ * @example
+ * const paths = load('@entity\/*.entity.{ts,js}')
+ * const paths = load(['@config\/*', './extra\/*.ts'])
+ */
+declare function load(pattern: GlobPattern, options?: LoadOptions): string[];
+declare function clearCache(): void;
+
+declare function make(): void;
+
+declare function filter<T extends Hook["on"]>(hooks: Hook[], on: T): Extract<Hook, {
+    on: T;
+}>["run"][];
+
+declare function plugin(): void;
+
+declare const programMeta: unique symbol;
+type ProgramMeta = typeof programMeta;
+interface CommandOptions<Input, Output, Deps> {
+    name: string;
+    input?: StandardSchemaV1<Input>;
+    output?: StandardSchemaV1<Output>;
+    hooks?: Hook[];
+    run(input: Input, deps: Deps): Output | Promise<Output>;
+}
+interface Stream<Events> {
+    emit<E extends keyof Events>(event: E, data: Events[E]): void;
+    /**
+     * Closes the stream.
+     */
+    close(): void;
+}
+interface StreamOptions<Input, Events, Deps> {
+    name: string;
+    input?: StandardSchemaV1<Input>;
+    events?: StandardSchemaV1<Events>;
+    hooks?: Hook[];
+    run(input: Input, stream: Stream<Events>, deps: Deps): void | Promise<void>;
+}
+interface Socket<Receive, Send> {
+    on<E extends keyof Receive>(event: E, handler: (data: Receive[E]) => void | Promise<void>): void;
+    emit<E extends keyof Send>(event: E, data: Send[E]): void;
+    /**
+     * Closes the socket.
+     */
+    close(): void;
+}
+interface SocketOptions<Receive, Send, Deps> {
+    name: string;
+    receive?: StandardSchemaV1<Receive>;
+    send?: StandardSchemaV1<Send>;
+    hooks?: Hook[];
+    run(socket: Socket<Receive, Send>, deps: Deps): void | Promise<void>;
+}
+type Route = {
+    type: "command";
+    options: CommandOptions<any, any, any>;
+} | {
+    type: "stream";
+    options: StreamOptions<any, any, any>;
+} | {
+    type: "socket";
+    options: SocketOptions<any, any, any>;
+};
+interface ProgramConfig<Deps> {
+    name: string;
+    deps?: Deps;
+    hooks?: Hook[];
+}
+interface Program<Deps = any> {
+    [programMeta]: {
+        name: string;
+        deps: Deps;
+        hooks: Hook[];
+        routes: Route[];
+    };
+    command<Input = any, Output = any>(options: CommandOptions<Input, Output, Deps>): void;
+    stream<Input = any, Events = any>(options: StreamOptions<Input, Events, Deps>): void;
+    socket<Receive = any, Send = any>(options: SocketOptions<Receive, Send, Deps>): void;
+}
+
+/**
+ * Creates a new Aromix Program.
+ * Programs group commands, streams, and sockets under a common namespace
+ * and share dependencies and hooks.
+ */
+declare function program<Deps>(config: ProgramConfig<Deps>): Program<Deps>;
+
+/**
+ * Creates a destructurable facade object for a service instance.
+ * Methods are bound to the instance, and properties are proxied via getters/setters.
+ */
+declare function createFacadeObj<T extends object>(serviceInstance: any): T;
+
+type ServiceConstructor<T> = new (...args: any[]) => T;
+interface Setup {
+    setup(): void | Promise<void>;
+}
+interface Teardown {
+    teardown(): void | Promise<void>;
+}
+interface Lifecycle extends Setup, Teardown {
+}
+/**
+ * Marks a class as an injectable service.
+ */
+declare function provide(): ClassDecorator;
+/**
+ * Resolves a service singleton instance.
+ * Throws if the class is not decorated with @provide().
+ */
+declare function inject<T>(Service: ServiceConstructor<T>): T;
+declare namespace inject {
+    var facade: <T extends object>(Service: ServiceConstructor<T>) => T;
+}
+
+export { type AromixBuildConfig, type BaseCtx, Codec, type CommandCtx, type CommandOptions, type Config, type ErrorHook, type EventMap, type Format, type GlobPattern, type Hook, type Lifecycle, type LoadOptions, type Platform, type Program, type ProgramConfig, type ProgramMeta, type RequestHook, type ResponseHook, type Route, type ServiceConstructor, type Setup, type Socket, type SocketCtx, type SocketOptions, type Stream, type StreamCtx, type StreamOptions, type Teardown, build, clearCache, config, createFacadeObj, entity, filter, hook, inject, load, make, plugin, program, programMeta, provide, toFetchHandler };

package/dist/index.d.ts

@@ -0,0 +1,234 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
+type Platform = "node" | "bun" | "cloudflare:worker";
+type Format = "esm" | "cjs";
+interface AromixBuildConfig {
+    entry: string;
+    outDir: string;
+    platform: Platform;
+    format: Format;
+    tsconfig: string;
+    sourcemap: boolean;
+    minify: boolean;
+}
+/** Identity fn :: exists purely for autocomplete and type safety */
+declare function build(options: AromixBuildConfig): AromixBuildConfig;
+
+interface Config {
+}
+declare function config<T extends Config>(config: T | (() => T)): T;
+
+interface BaseCtx {
+    id: string;
+    payload: unknown;
+    args<T>(schema: StandardSchemaV1<T>): T;
+}
+interface CommandCtx extends BaseCtx {
+}
+interface StreamCtx extends BaseCtx {
+}
+interface SocketCtx<Receive extends EventMap, Send extends EventMap> extends BaseCtx {
+    on<E extends keyof Receive>(event: E, handler: (data: Receive[E]) => void | Promise<void>): void;
+    send<E extends keyof Send>(event: E, data: Send[E]): void;
+    onClose(handler: () => void): void;
+    close(): void;
+}
+type EventMap = Record<string, unknown>;
+
+interface Entity {
+}
+declare function entity(options: Entity): void;
+
+declare const Codec: {
+    encode(data: unknown): Uint8Array;
+    decode(buf: Uint8Array): unknown;
+    fromRequest(req: Request): Promise<unknown>;
+    response(data: unknown): Response;
+};
+
+declare function toFetchHandler(): void;
+
+type RequestHook = (ctx: BaseCtx) => Response | void | Promise<Response | void>;
+type ResponseHook = (ctx: BaseCtx, res: Response) => Response | void | Promise<Response | void>;
+type ErrorHook = (err: unknown, ctx: BaseCtx) => Response | void | Promise<Response | void>;
+type Hook = {
+    on: "Ready";
+    run: (config: Config) => void | Promise<void>;
+} | {
+    on: "Close";
+    run: (config: Config) => void | Promise<void>;
+} | {
+    on: "Request";
+    run: RequestHook;
+} | {
+    on: "Response";
+    run: ResponseHook;
+} | {
+    on: "Error";
+    run: ErrorHook;
+};
+
+declare function hook<T extends Hook["on"]>(on: T, run: Extract<Hook, {
+    on: T;
+}>["run"]): Extract<Hook, {
+    on: T;
+}>;
+
+/**
+ * load() — cross-runtime glob file resolver with tsconfig path alias support.
+ *
+ * Returns resolved absolute file paths. Does NOT import — caller drives imports.
+ *
+ * Supported glob features:
+ *   *       — matches any segment (not path separators)
+ *   **      — matches any depth (where supported by runtime FS walk)
+ *   {a,b}   — brace expansion
+ *   @alias  — tsconfig `paths` aliases
+ *
+ * Runtimes: Node.js, Bun, Deno, Cloudflare Workers (Workers: alias-only, no FS)
+ *
+ * Usage:
+ *   const paths = load('@config/*')
+ *   const paths = load(['@entity/*.entity.{ts,js}', './app/users/*.ts'])
+ *
+ *   make({ entity: load('@entity/*') })
+ *   async function make(pathMap: Record<string, string[]>) {
+ *     for (const [key, paths] of Object.entries(pathMap)) {
+ *       for (const p of paths) {
+ *         const mod = await import(p)
+ *         // ...
+ *       }
+ *     }
+ *   }
+ */
+type GlobPattern = string | string[];
+interface LoadOptions {
+    /** Working directory for relative patterns. Defaults to process.cwd() / Deno.cwd(). */
+    cwd?: string;
+    /** Path to tsconfig.json. Auto-discovered from cwd upward if not provided. */
+    tsconfig?: string;
+    /** Include dotfiles. Default: false. */
+    dot?: boolean;
+    /** Only return files (not directories). Default: true. */
+    filesOnly?: boolean;
+}
+/**
+ * Resolves a glob pattern (or array of patterns) to absolute file paths.
+ * Supports tsconfig path aliases, `*` globs, and `{a,b}` brace expansion.
+ *
+ * @example
+ * const paths = load('@entity\/*.entity.{ts,js}')
+ * const paths = load(['@config\/*', './extra\/*.ts'])
+ */
+declare function load(pattern: GlobPattern, options?: LoadOptions): string[];
+declare function clearCache(): void;
+
+declare function make(): void;
+
+declare function filter<T extends Hook["on"]>(hooks: Hook[], on: T): Extract<Hook, {
+    on: T;
+}>["run"][];
+
+declare function plugin(): void;
+
+declare const programMeta: unique symbol;
+type ProgramMeta = typeof programMeta;
+interface CommandOptions<Input, Output, Deps> {
+    name: string;
+    input?: StandardSchemaV1<Input>;
+    output?: StandardSchemaV1<Output>;
+    hooks?: Hook[];
+    run(input: Input, deps: Deps): Output | Promise<Output>;
+}
+interface Stream<Events> {
+    emit<E extends keyof Events>(event: E, data: Events[E]): void;
+    /**
+     * Closes the stream.
+     */
+    close(): void;
+}
+interface StreamOptions<Input, Events, Deps> {
+    name: string;
+    input?: StandardSchemaV1<Input>;
+    events?: StandardSchemaV1<Events>;
+    hooks?: Hook[];
+    run(input: Input, stream: Stream<Events>, deps: Deps): void | Promise<void>;
+}
+interface Socket<Receive, Send> {
+    on<E extends keyof Receive>(event: E, handler: (data: Receive[E]) => void | Promise<void>): void;
+    emit<E extends keyof Send>(event: E, data: Send[E]): void;
+    /**
+     * Closes the socket.
+     */
+    close(): void;
+}
+interface SocketOptions<Receive, Send, Deps> {
+    name: string;
+    receive?: StandardSchemaV1<Receive>;
+    send?: StandardSchemaV1<Send>;
+    hooks?: Hook[];
+    run(socket: Socket<Receive, Send>, deps: Deps): void | Promise<void>;
+}
+type Route = {
+    type: "command";
+    options: CommandOptions<any, any, any>;
+} | {
+    type: "stream";
+    options: StreamOptions<any, any, any>;
+} | {
+    type: "socket";
+    options: SocketOptions<any, any, any>;
+};
+interface ProgramConfig<Deps> {
+    name: string;
+    deps?: Deps;
+    hooks?: Hook[];
+}
+interface Program<Deps = any> {
+    [programMeta]: {
+        name: string;
+        deps: Deps;
+        hooks: Hook[];
+        routes: Route[];
+    };
+    command<Input = any, Output = any>(options: CommandOptions<Input, Output, Deps>): void;
+    stream<Input = any, Events = any>(options: StreamOptions<Input, Events, Deps>): void;
+    socket<Receive = any, Send = any>(options: SocketOptions<Receive, Send, Deps>): void;
+}
+
+/**
+ * Creates a new Aromix Program.
+ * Programs group commands, streams, and sockets under a common namespace
+ * and share dependencies and hooks.
+ */
+declare function program<Deps>(config: ProgramConfig<Deps>): Program<Deps>;
+
+/**
+ * Creates a destructurable facade object for a service instance.
+ * Methods are bound to the instance, and properties are proxied via getters/setters.
+ */
+declare function createFacadeObj<T extends object>(serviceInstance: any): T;
+
+type ServiceConstructor<T> = new (...args: any[]) => T;
+interface Setup {
+    setup(): void | Promise<void>;
+}
+interface Teardown {
+    teardown(): void | Promise<void>;
+}
+interface Lifecycle extends Setup, Teardown {
+}
+/**
+ * Marks a class as an injectable service.
+ */
+declare function provide(): ClassDecorator;
+/**
+ * Resolves a service singleton instance.
+ * Throws if the class is not decorated with @provide().
+ */
+declare function inject<T>(Service: ServiceConstructor<T>): T;
+declare namespace inject {
+    var facade: <T extends object>(Service: ServiceConstructor<T>) => T;
+}
+
+export { type AromixBuildConfig, type BaseCtx, Codec, type CommandCtx, type CommandOptions, type Config, type ErrorHook, type EventMap, type Format, type GlobPattern, type Hook, type Lifecycle, type LoadOptions, type Platform, type Program, type ProgramConfig, type ProgramMeta, type RequestHook, type ResponseHook, type Route, type ServiceConstructor, type Setup, type Socket, type SocketCtx, type SocketOptions, type Stream, type StreamCtx, type StreamOptions, type Teardown, build, clearCache, config, createFacadeObj, entity, filter, hook, inject, load, make, plugin, program, programMeta, provide, toFetchHandler };