@justscale/core 0.1.0

package/dist/justscale.d.ts

@@ -0,0 +1,63 @@
+/**
+ * JustScale() - The main entry point for JustScale applications
+ *
+ * @module @justscale/core
+ */
+import { WeakRefSet } from 'weakrefset';
+import type { AnyToken, Builder, Token, ExtractControllers, CompileResult } from './builder/types.js';
+import type { ControllerInstance } from './core/controller.js';
+import { type App } from './app.js';
+import type { ServiceToken } from './core/service.js';
+import type { ModelRepositoryToken } from './models/index.js';
+import { Logger } from './core/logger.js';
+import { Lifecycle } from './core/lifecycle.js';
+import { type Container } from './index.js';
+import { ClusterServer, type ServeOptions } from './cluster/cluster.js';
+export type BuiltInTokens = [typeof Logger, typeof Lifecycle];
+/**
+ * A built JustScale application.
+ *
+ * - `TProvided` - tokens the underlying builder registered via `.add()`.
+ * - `TRequires` - tokens the underlying builder declared via `.requires()`.
+ *   Empty by default; non-empty marks this as a sub-app that must be
+ *   composed into a parent `JustScale()` before it can compile.
+ */
+export interface IBuiltApp<TProvided extends AnyToken[] = AnyToken[], TRequires extends AnyToken[] = []> {
+    /** Access the underlying compiled App (same as compile()) */
+    readonly app: CompileResult<TRequires, App<ExtractControllers<TProvided>>>;
+    /** All resolved controller instances */
+    readonly controllers: ControllerInstance[];
+    /** The DI container */
+    readonly container: Container;
+    /** The cluster server (available after serve()) */
+    readonly server: ClusterServer | null;
+    /** Socket path (available after serve()) */
+    readonly socketPath: string | null;
+    /** Whether the app is currently serving */
+    readonly isServing: boolean;
+    readonly __requires: TRequires;
+    compile(): CompileResult<TRequires, App<ExtractControllers<TProvided>>>;
+    /** Resolve a token from the container */
+    resolve<T, C extends Record<string, (...args: any[]) => Promise<any>>>(token: ModelRepositoryToken<T, C>): Promise<import('./models/index.js').ModelRepository<T> & C>;
+    resolve<T, TDeps extends Record<string, ServiceToken<unknown>>>(token: import('./core/service.js').Service<T, TDeps>): Promise<T>;
+    resolve<T, TDeps extends Record<string, ServiceToken<unknown>>>(token: import('./core/service.js').ServiceDef<T, TDeps>): Promise<T>;
+    resolve<T>(token: ServiceToken<T>): Promise<T>;
+    resolve<T>(token: Token<T>): Promise<T>;
+    resolve(token: any): Promise<any>;
+    /** Start serving on the specified protocols */
+    serve(options?: ServeOptions): Promise<void>;
+    /** Stop the app gracefully */
+    stop(): Promise<void>;
+}
+export interface JustScaleFunction {
+    /** Create a new app builder */
+    (): Builder<BuiltInTokens>;
+    /** All apps created in this Node process */
+    readonly apps: WeakRefSet<IBuiltApp<any, any>>;
+    /** Graceful shutdown of all apps */
+    shutdown(): Promise<void>;
+}
+declare const JustScale: JustScaleFunction;
+export default JustScale;
+export type { IBuiltApp as BuiltApp };
+//# sourceMappingURL=justscale.d.ts.map

package/dist/justscale.d.ts.map

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

package/dist/justscale.js

@@ -0,0 +1,501 @@
+/**
+ * JustScale() - The main entry point for JustScale applications
+ *
+ * @module @justscale/core
+ */
+import { WeakRefSet } from 'weakrefset';
+import { isServiceDef, isControllerDef, isRepositoryBinding, isServiceBinding, isInstanceBinding, isFeatureToken, isBuilderCallback, isComponentArray, SERVICE_BINDING, INSTANCE_BINDING, } from './builder/types.js';
+import { isConfigComponent } from './features/config/types.js';
+import { Config } from './features/config/config-of.js';
+import { isSecretComponent } from './features/secrets/types.js';
+import { Secret } from './features/secrets/secret-of.js';
+import { isFeatureFlagComponent } from './features/feature-flags/types.js';
+import { FeatureFlag } from './features/feature-flags/feature-flag-of.js';
+import { isEnvironment } from './features/environment/types.js';
+import { VAULT_KIND } from './features/vault/types.js';
+import { getContributionDefault, getContributionParent, isContribution, } from './core/contribution.js';
+import { getImplicitServices, validateDependencies } from './builder/validation.js';
+import { createAppInternal } from './app.js';
+import { createScopedBridge } from './core/scope-bridge.js';
+import { LifecycleImpl } from './core/lifecycle-impl.js';
+import { ClusterServer, getRegisteredTransports, } from './cluster/cluster.js';
+import { createKernel } from './kernel/kernel.js';
+function createState() {
+    return {
+        components: [],
+        services: [],
+        controllers: [],
+        repoBindings: [],
+        serviceBindings: [],
+        instanceBindings: [],
+        features: [],
+        callbacks: [],
+        overrides: [],
+        configComponents: [],
+        secretComponents: [],
+        featureFlagComponents: [],
+        environment: null,
+        requires: [],
+        subApps: [],
+    };
+}
+function cloneState(state) {
+    return {
+        components: [...state.components],
+        services: [...state.services],
+        controllers: [...state.controllers],
+        repoBindings: [...state.repoBindings],
+        serviceBindings: [...state.serviceBindings],
+        instanceBindings: [...state.instanceBindings],
+        features: [...state.features],
+        callbacks: [...state.callbacks],
+        overrides: [...state.overrides],
+        configComponents: [...state.configComponents],
+        secretComponents: [...state.secretComponents],
+        featureFlagComponents: [...state.featureFlagComponents],
+        environment: state.environment,
+        requires: [...state.requires],
+        subApps: [...state.subApps],
+    };
+}
+/** Collects feature components during feature expansion. */
+class FeatureBuilderCollector {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    add(component) {
+        if (component == null) {
+            throw new TypeError(`Builder.add() received ${component === null ? 'null' : 'undefined'}. ` +
+                'Check that the imported module exists and exports the expected component.');
+        }
+        processComponent(this.state, component);
+        return this;
+    }
+}
+/**
+ * If the service is a `createContribution()` result, ensure its parent
+ * token's default aggregating service is registered in the state (once).
+ */
+function ensureContributionDefault(state, service) {
+    if (!isContribution(service))
+        return;
+    const parent = getContributionParent(service);
+    if (!parent)
+        return;
+    // Already bound? Skip - could be a custom monolithic provider via bindService.
+    if (state.serviceBindings.some((b) => b.token === parent))
+        return;
+    const defaultDef = getContributionDefault(parent);
+    if (state.services.includes(defaultDef))
+        return;
+    // Register the default service AND bind it to the user's subclass
+    // (parent = the subclass the user wrote via `abstract class X extends defineContribution(...)`).
+    state.services.push(defaultDef);
+    state.components.push(defaultDef);
+    state.serviceBindings.push({
+        [SERVICE_BINDING]: true,
+        token: parent,
+        implementation: defaultDef,
+    });
+}
+/**
+ * Resolves inject deps, runs the factory, validates each returned value
+ * against its partial's schema, and registers the result under the partial's symbol key.
+ */
+async function runPartialComponents(components, container) {
+    for (const component of components) {
+        const entries = await Promise.all(Object.entries(component.inject).map(async ([key, token]) => [key, await container.resolve(token)]));
+        const deps = Object.fromEntries(entries);
+        const values = await component.factory(deps);
+        const schemaByKey = new Map();
+        for (const partial of component.provides) {
+            schemaByKey.set(partial.key, partial.schema);
+        }
+        for (const key of Object.getOwnPropertySymbols(values)) {
+            const raw = values[key];
+            const schema = schemaByKey.get(key);
+            const validated = schema ? schema.parse(raw) : raw;
+            container.registerInstance(key, validated);
+        }
+    }
+}
+function processComponent(state, component) {
+    state.components.push(component);
+    if (component instanceof BuiltApp) {
+        state.subApps.push(component);
+        return;
+    }
+    if (isControllerDef(component)) {
+        state.controllers.push(component);
+    }
+    else if (isServiceDef(component)) {
+        state.services.push(component);
+        // If this service contributes to a multi-impl token, ensure the default
+        // aggregator for that token is registered too (once). Without this, the
+        // contribution would have nowhere to call `.register()` on.
+        ensureContributionDefault(state, component);
+    }
+    else if (isRepositoryBinding(component)) {
+        state.repoBindings.push(component);
+    }
+    else if (isServiceBinding(component)) {
+        state.serviceBindings.push(component);
+    }
+    else if (isInstanceBinding(component)) {
+        state.instanceBindings.push(component);
+    }
+    else if (isFeatureToken(component)) {
+        state.features.push(component);
+        const featureBuilder = new FeatureBuilderCollector(state);
+        component(featureBuilder);
+    }
+    else if (isBuilderCallback(component)) {
+        state.callbacks.push(component);
+    }
+    else if (isComponentArray(component)) {
+        for (const item of component) {
+            processComponent(state, item);
+        }
+    }
+    else if (isConfigComponent(component)) {
+        state.configComponents.push(component);
+    }
+    else if (isSecretComponent(component)) {
+        state.secretComponents.push(component);
+    }
+    else if (isFeatureFlagComponent(component)) {
+        state.featureFlagComponents.push(component);
+    }
+    else if (isEnvironment(component)) {
+        applyEnvironment(state, component);
+    }
+}
+/**
+ * Enforce vault policy, then push env services and providers through processComponent.
+ */
+function applyEnvironment(state, env) {
+    const disallow = new Set(env.vaultPolicy.disallow ?? []);
+    const warn = new Set(env.vaultPolicy.warn ?? []);
+    for (const svc of env.services) {
+        const kind = svc[VAULT_KIND];
+        if (kind && disallow.has(kind)) {
+            throw new Error(`Environment '${env.name}' (type '${env.type}') disallows vault kind '${kind}'. ` +
+                'Swap for a production-safe vault (EnvVarVault, KubernetesVault, HashiCorpVault) ' +
+                'or explicitly opt in via vaultPolicy.');
+        }
+        if (kind && warn.has(kind)) {
+            console.warn(`[justscale] Environment '${env.name}' wires vault kind '${kind}' under a warn policy. ` +
+                'This should not be used in production.');
+        }
+    }
+    if (state.environment && state.environment.name !== env.name) {
+        throw new Error('Only one environment may be registered per app. Already registered: ' +
+            `'${state.environment.name}' (type '${state.environment.type}'). ` +
+            `Attempted to register: '${env.name}' (type '${env.type}').`);
+    }
+    state.environment = env;
+    for (const svc of env.services)
+        processComponent(state, svc);
+    for (const provider of env.providers)
+        processComponent(state, provider);
+}
+// ============================================================================
+// Builder Implementation
+// ============================================================================
+class BuilderImpl {
+    state;
+    constructor(state = createState()) {
+        this.state = state;
+    }
+    add(component) {
+        if (component == null) {
+            throw new TypeError(`Builder.add() received ${component === null ? 'null' : 'undefined'}. ` +
+                'Check that the imported module exists and exports the expected component.');
+        }
+        const newState = cloneState(this.state);
+        processComponent(newState, component);
+        return new BuilderImpl(newState);
+    }
+    addControllers(controllers) {
+        const newState = cloneState(this.state);
+        for (const controller of controllers) {
+            if (controller == null) {
+                throw new TypeError('Builder.addControllers() received a null/undefined entry. ' +
+                    'Check that all CLI controllers discovered from packages are defined.');
+            }
+            processComponent(newState, controller);
+        }
+        return new BuilderImpl(newState);
+    }
+    override(token, implementation) {
+        const newState = cloneState(this.state);
+        newState.overrides.push({ token, implementation });
+        return new BuilderImpl(newState);
+    }
+    requires(token) {
+        const newState = cloneState(this.state);
+        newState.requires.push(token);
+        return new BuilderImpl(newState);
+    }
+    build() {
+        const additionalProvides = [];
+        for (const component of this.state.configComponents) {
+            for (const partial of component.provides) {
+                additionalProvides.push(Config.of(partial));
+            }
+        }
+        for (const component of this.state.secretComponents) {
+            for (const partial of component.provides) {
+                additionalProvides.push(Secret.of(partial));
+            }
+        }
+        for (const component of this.state.featureFlagComponents) {
+            for (const partial of component.provides) {
+                additionalProvides.push(FeatureFlag.of(partial));
+            }
+        }
+        for (const token of this.state.requires) {
+            additionalProvides.push(token);
+        }
+        const subAppRequires = [];
+        for (const sub of this.state.subApps) {
+            const subRequires = sub.__requires;
+            if (subRequires)
+                subAppRequires.push(...subRequires);
+        }
+        const alreadyBound = new Set(this.state.services);
+        for (const binding of this.state.serviceBindings) {
+            alreadyBound.add(binding.token);
+        }
+        for (const binding of this.state.instanceBindings) {
+            alreadyBound.add(binding.token);
+        }
+        for (const [abstractToken, implicitService] of getImplicitServices()) {
+            if (alreadyBound.has(implicitService))
+                continue;
+            if (alreadyBound.has(abstractToken))
+                continue;
+            this.state.services.push(implicitService);
+            this.state.components.push(implicitService);
+        }
+        validateDependencies(this.state.services, this.state.repoBindings, this.state.serviceBindings, this.state.instanceBindings, this.state.features, {
+            additionalProvides,
+            additionalRequires: subAppRequires,
+        });
+        const builtApp = new BuiltApp(this.state);
+        apps.add(builtApp);
+        return builtApp;
+    }
+}
+// ============================================================================
+// BuiltApp Implementation
+// ============================================================================
+class BuiltApp {
+    state;
+    _app = null;
+    _server = null;
+    _socketPath = null;
+    _isServing = false;
+    _kernel = null;
+    lifecycle = null;
+    _parentBuildContext = null;
+    constructor(state) {
+        this.state = state;
+    }
+    /** @internal */
+    _inheritBuildContext(ctx) {
+        if (this._app) {
+            throw new Error('Sub-app already compiled - cannot inherit build context. ' +
+                '_inheritBuildContext must be called before compile.');
+        }
+        this._parentBuildContext = ctx;
+    }
+    get __requires() {
+        return this.state.requires;
+    }
+    /** @internal */
+    async __attachBridgesFrom(parentContainer) {
+        if (this._app) {
+            throw new Error('Sub-app already compiled - cannot attach bridges. ' +
+                '__attachBridgesFrom must be called before compile.');
+        }
+        for (const token of this.state.requires) {
+            const bridge = await createScopedBridge(parentContainer, token);
+            this.state.instanceBindings.push({
+                [INSTANCE_BINDING]: true,
+                token: token,
+                instance: bridge,
+            });
+        }
+    }
+    /** @internal */
+    _maybeCompiledApp() {
+        return this._app;
+    }
+    compileInternal() {
+        if (this._app) {
+            return this._app;
+        }
+        this.lifecycle = new LifecycleImpl();
+        const configComponents = this.state.configComponents;
+        const secretComponents = this.state.secretComponents;
+        const featureFlagComponents = this.state.featureFlagComponents;
+        const subApps = this.state.subApps;
+        this._app = createAppInternal({
+            services: this.state.services,
+            controllers: this.state.controllers,
+            _beforeControllerResolution: (container) => {
+                container.setLifecycle(this.lifecycle);
+                for (const binding of this.state.repoBindings) {
+                    if (isServiceDef(binding.implementation)) {
+                        container.registerFor(binding.token, binding.implementation);
+                    }
+                    else {
+                        container.registerInstance(binding.token, binding.implementation);
+                    }
+                }
+                for (const binding of this.state.serviceBindings) {
+                    container.registerFor(binding.token, binding.implementation);
+                }
+                for (const binding of this.state.instanceBindings) {
+                    container.registerInstance(binding.token, binding.instance);
+                }
+                for (const override of this.state.overrides) {
+                    container.registerFor(override.token, override.implementation);
+                }
+            },
+            _asyncBeforeControllerResolution: async (container) => {
+                await runPartialComponents(configComponents, container);
+                await runPartialComponents(secretComponents, container);
+                await runPartialComponents(featureFlagComponents, container);
+            },
+            _getMatchDelegates: () => subApps
+                .map((sub) => sub._maybeCompiledApp())
+                .filter((a) => a !== null),
+            _parentBuildContext: this._parentBuildContext ?? undefined,
+        });
+        if (this.state.subApps.length > 0) {
+            const parentReady = this._app.ready;
+            const parentApp = this._app;
+            const subAppsLocal = this.state.subApps;
+            const chained = parentReady.then(async () => {
+                for (const sub of subAppsLocal) {
+                    const subImpl = sub;
+                    if (subImpl._maybeCompiledApp())
+                        continue;
+                    if (parentApp.__buildContext) {
+                        subImpl._inheritBuildContext(parentApp.__buildContext);
+                    }
+                    await subImpl.__attachBridgesFrom(parentApp.container);
+                    await subImpl.compileInternal().ready;
+                }
+            });
+            this._app.ready = chained;
+        }
+        return this._app;
+    }
+    compile() {
+        return this.compileInternal();
+    }
+    get app() {
+        return this.compileInternal();
+    }
+    get controllers() {
+        return this.compileInternal().controllers;
+    }
+    get container() {
+        return this.compileInternal().container;
+    }
+    get match() {
+        return this.compileInternal().match;
+    }
+    get execute() {
+        return this.compileInternal().execute;
+    }
+    resolve(token) {
+        return this.compileInternal().container.resolve(token);
+    }
+    get server() {
+        return this._server;
+    }
+    get socketPath() {
+        return this._socketPath;
+    }
+    get isServing() {
+        return this._isServing;
+    }
+    async serve(options = {}) {
+        if (this._isServing) {
+            throw new Error('App is already serving');
+        }
+        const app = this.compileInternal();
+        await app.ready;
+        if (!options.noSocket) {
+            this._server = new ClusterServer({
+                socketPath: options.socketPath,
+            });
+            this._server.attachApp(app);
+            for (const transport of getRegisteredTransports()) {
+                if (transport.registerHandlers) {
+                    transport.registerHandlers(this._server, app);
+                }
+            }
+            this._socketPath = await this._server.listen();
+        }
+        // Start remaining legacy transports (scheduled-task, cli cluster).
+        for (const transport of getRegisteredTransports()) {
+            if (transport.onServe) {
+                await transport.onServe(this, options);
+            }
+        }
+        // Start adapters (HTTP, and future protocols) via the kernel.
+        // Kernel owns adapter dedup, requires resolution, and stop ordering.
+        // Signal handling is left to `defineApp` so library consumers
+        // that call serve() directly don't get unexpected process-level handlers.
+        this._kernel = createKernel({ app, signals: false });
+        await this._kernel.start();
+        this._isServing = true;
+    }
+    async stop() {
+        if (this._kernel) {
+            await this._kernel.stop();
+            this._kernel = null;
+        }
+        else if (this.lifecycle) {
+            await this.lifecycle.runHook('stop');
+        }
+        for (const transport of getRegisteredTransports()) {
+            if (transport.onStop) {
+                await transport.onStop(this);
+            }
+        }
+        if (this._server) {
+            await this._server.close();
+            this._server = null;
+            this._socketPath = null;
+        }
+        this._isServing = false;
+    }
+}
+// ============================================================================
+// JustScale Namespace
+// ============================================================================
+const apps = new WeakRefSet();
+async function shutdown() {
+    const stopPromises = [];
+    for (const app of apps) {
+        if (app.isServing) {
+            stopPromises.push(app.stop());
+        }
+    }
+    await Promise.all(stopPromises);
+}
+const JustScale = Object.assign(function JustScale() {
+    return new BuilderImpl();
+}, {
+    apps,
+    shutdown,
+});
+export default JustScale;
+//# sourceMappingURL=justscale.js.map

package/dist/justscale.js.map

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

package/dist/kernel/adapter.d.ts

@@ -0,0 +1,9 @@
+import type { AnyToken } from '../builder/types.js';
+import type { App } from '../app.js';
+export interface Adapter {
+    readonly name: string;
+    readonly requires: readonly AnyToken[];
+    start(app: App, ...resolved: unknown[]): Promise<void> | void;
+    stop?(): Promise<void> | void;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/kernel/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/kernel/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;IACvC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B"}

package/dist/kernel/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/kernel/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/kernel/adapter.ts"],"names":[],"mappings":""}

package/dist/kernel/kernel.d.ts

@@ -0,0 +1,15 @@
+import type { App } from '../app.js';
+import type { Adapter } from './adapter.js';
+export interface KernelOptions {
+    app: App;
+    signals?: boolean;
+    logger?: Pick<Console, 'warn' | 'error' | 'log' | 'info'>;
+}
+export interface Kernel {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    readonly running: boolean;
+    readonly startedAdapters: readonly Adapter[];
+}
+export declare function createKernel(opts: KernelOptions): Kernel;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ5C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,GAAG,CAAC;IACT,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAuIxD"}