@supacloud/app 0.5.0 → 0.6.0

package/README.md

@@ -8,6 +8,44 @@ SupaCloud compiler (`@supacloud/compiler`) reads that metadata from source,
 validates the dependency graph and generates plain static factories — there is
 no runtime reflection and no `reflect-metadata` dependency.
 
+Runtime DI delegates to Angular's public `@angular/core` APIs through a small
+compatibility adapter. SupaCloud decorators retain module/compiler metadata,
+while production application factories remain compiler-generated and
+reflection-free.
+
+## Runtime Boundary
+
+Angular is the runtime DI engine: `InjectionToken`, hierarchical injectors,
+`inject()`, `DestroyRef`, provider caching and lifecycle execution are delegated
+to Angular public APIs. SupaCloud does not reimplement those mechanisms.
+
+SupaCloud still owns the application model that Angular does not define:
+`Module`, `Scope`, provider descriptors, controllers, commands, jobs, route
+metadata, static aspects, `ApplicationGraph` and compiler diagnostics. Use
+SupaCloud decorators for these semantics; they are compiler input, not Angular
+decorator aliases.
+
+## Static AOP
+
+Use one `around(context, next)` function for cross-cutting behavior at the
+module, route, command, or job boundary:
+
+```ts
+const auditAspect = async (context, next) => {
+  const result = await next();
+  await audit.write(context, result);
+  return result;
+};
+
+@Module({ name: "case", aspects: [auditAspect] })
+export class CaseModule {}
+```
+
+Aspect references must be explicit function identifiers. The compiler rejects
+variables, spread expressions, strings, dynamic pointcuts, Proxy, and runtime
+aspect registration. Angular remains the DI runtime; aspects are SupaCloud
+compiler metadata and generated execution order.
+
 ```ts
 import {
   Command,

package/dist/aspect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Static application aspect contract.
+ *
+ * Aspects are explicit functions referenced by Module/Route/Command metadata.
+ * The compiler resolves those references and emits a direct invocation chain.
+ */
+export type AspectKind = "route" | "command" | "job";
+export interface AspectContext {
+    kind: AspectKind;
+    name: string;
+    input: unknown;
+    request?: Request;
+    requestContext?: unknown;
+    scope?: Record<string, unknown>;
+    services?: Record<string, unknown>;
+    metadata?: unknown;
+}
+export type AspectNext<TResult = unknown> = () => TResult | Promise<TResult>;
+export type Aspect<TResult = unknown> = (context: AspectContext, next: AspectNext<TResult>) => TResult | Promise<TResult>;
+export type RouteAspect = Aspect;
+export type CommandAspect = Aspect;
+export type JobAspect = Aspect;

package/dist/decorators.d.ts

@@ -1,6 +1,7 @@
-import type { Provider, Token, Type } from "./provider";
+import type { Provider, ProviderDep, Token, Type } from "./provider";
 import type { EnvironmentProviders } from "./provider";
 import type { Scope } from "./scope";
+import type { Aspect } from "./aspect";
 /**
  * Decorator metadata keys. Metadata is attached as static properties on the
  * decorated class so the SupaCloud compiler can read it from the AST *and*
@@ -9,6 +10,7 @@ import type { Scope } from "./scope";
 export declare const INJECTABLE_METADATA = "supacloud:injectable";
 export declare const MODULE_METADATA = "supacloud:module";
 export declare const COMMAND_METADATA = "supacloud:command";
+export declare const JOB_METADATA = "supacloud:job";
 export declare const QUERY_METADATA = "supacloud:query";
 export declare const CONTROLLER_METADATA = "supacloud:controller";
 export declare const ROUTES_METADATA = "supacloud:routes";
@@ -40,12 +42,12 @@ export interface InjectableOptions {
     /** Automatically provide this service in root scope without manual module declaration (Angular-style). */
     providedIn?: "root";
     /** Explicit constructor dependency tokens, in parameter order. */
-    deps?: Token[];
+    deps?: ProviderDep[];
 }
 export interface InjectableMeta {
     scope: Scope;
     providedIn?: "root";
-    deps: Token[];
+    deps: ProviderDep[];
 }
 export interface ModuleOptions {
     name: string;
@@ -55,11 +57,15 @@ export interface ModuleOptions {
     providers?: Array<Provider | EnvironmentProviders>;
     controllers?: Array<Type<unknown>>;
     commands?: Array<Type<unknown>>;
+    jobs?: Array<Type<unknown>>;
     queries?: Array<Type<unknown>>;
+    /** Explicit static aspects applied to every route and command in this module. */
+    aspects?: Aspect[];
     exports?: Token[];
 }
-export interface ModuleMeta extends Required<Omit<ModuleOptions, "exports" | "tags">> {
+export interface ModuleMeta extends Required<Omit<ModuleOptions, "exports" | "tags" | "aspects">> {
     tags?: string[];
+    aspects: Aspect[];
     exports: Token[];
 }
 export interface CommandOptions {
@@ -74,7 +80,15 @@ export interface CommandOptions {
     idempotency?: "required" | "none";
     /** Automatically discover and register without manual module declaration. */
     standalone?: boolean;
+    /** Explicit static aspects applied around this command invocation. */
+    aspects?: Aspect[];
 }
+export interface JobOptions {
+    name: string;
+    /** Explicit static aspects applied around this job invocation. */
+    aspects?: Aspect[];
+}
+export type JobMeta = JobOptions;
 export type CommandMeta = Omit<CommandOptions, "transaction" | "idempotency"> & {
     transaction: "required" | "none";
     idempotency: "required" | "none";
@@ -124,6 +138,8 @@ export interface RouteOptions {
     title?: string;
     /** Static route metadata dictionary (modeled after Angular Route.data). */
     data?: Record<string, unknown>;
+    /** Explicit static aspects applied around this route invocation. */
+    aspects?: Aspect[];
 }
 export interface RouteDefinition extends RouteOptions {
     method: HttpMethod;
@@ -174,6 +190,8 @@ export declare function Module(options: ModuleOptions): ClassDecorator;
 export declare function getModuleMeta(target: object): ModuleMeta | undefined;
 export declare function Command(options: CommandOptions): ClassDecorator;
 export declare function getCommandMeta(target: object): CommandMeta | undefined;
+export declare function Job(options: JobOptions): ClassDecorator;
+export declare function getJobMeta(target: object): JobMeta | undefined;
 export declare function Param(nameOrOptions?: string | ParamOptions, options?: ParamOptions): ParameterDecorator;
 export declare function Body(): ParameterDecorator;
 export declare function Headers(name?: string): ParameterDecorator;

package/dist/forms.d.ts

@@ -15,11 +15,12 @@ export interface AbstractControlOptions {
  */
 export declare abstract class AbstractControl<TValue = any> {
     private _value;
-    private _status;
-    private _errors;
+    protected _status: FormControlStatus;
+    protected _errors: ValidationErrors | null;
     private _pristine;
     private _touched;
     private _parent;
+    private _validationRun;
     protected _validator: ValidatorFn | null;
     protected _asyncValidator: AsyncValidatorFn | null;
     constructor(validatorOrOpts?: ValidatorFn | ValidatorFn[] | AbstractControlOptions | null, asyncValidator?: AsyncValidatorFn | AsyncValidatorFn[] | null);
@@ -45,6 +46,7 @@ export declare abstract class AbstractControl<TValue = any> {
     disable(): void;
     enable(): void;
     setErrors(errors: ValidationErrors | null): void;
+    protected cancelPendingValidation(): void;
     hasError(errorCode: string, path?: string | (string | number)[]): boolean;
     getError(errorCode: string, path?: string | (string | number)[]): unknown;
     abstract setValue(value: any): void;

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 export { SCOPES, DEFAULT_SCOPE, SCOPE_LIFETIME_RANK, isScopeViolation } from "./scope";
 export type { Scope } from "./scope";
+export type { Aspect, AspectContext, AspectKind, AspectNext, CommandAspect, JobAspect, RouteAspect, } from "./aspect";
 export { InjectionToken } from "./token";
 export type { InjectionTokenOptions } from "./token";
 export { flattenProviders, isEnvironmentProviders, isClassProvider, isExistingProvider, isFactoryProvider, isValueProvider, makeEnvironmentProviders, provideAppInitializer, provideEnvironmentInitializer, provideToken, } from "./provider";
-export type { ClassProvider, EnvironmentProviders, ExistingProvider, FactoryProvider, Provider, Token, Type, ValueProvider, } from "./provider";
-export { Body, CanDeactivate, Command, Controller, Data, Delete, Get, Head, Headers, Host, Inject, Injectable, Module, Optional, Options, Param, Patch, Post, Put, Query, Resolve, Self, SkipSelf, Title, UseGuards, executeResolvers, getCommandMeta, getControllerMeta, getGuards, getHostParams, getInjectParams, getOptionalParams, getRouteParams, getSelfParams, getSkipSelfParams, getInjectableMeta, getModuleMeta, getQueryMeta, getRoutes, COMMAND_METADATA, CONTROLLER_METADATA, GUARDS_METADATA, CAN_DEACTIVATE_METADATA, HOST_PARAMS_METADATA, INJECTABLE_METADATA, INJECT_PARAMS_METADATA, RESOLVE_METADATA, OPTIONAL_PARAMS_METADATA, ROUTE_PARAMS_METADATA, SELF_PARAMS_METADATA, SKIP_SELF_PARAMS_METADATA, MODULE_METADATA, QUERY_METADATA, ROUTES_METADATA, } from "./decorators";
-export type { CanActivateFn, CanDeactivateFn, CanMatchFn, CommandMeta, CommandOptions, ControllerMeta, ControllerOptions, HttpMethod, InjectableMeta, InjectableOptions, ModuleMeta, ModuleOptions, ParamOptions, QueryMeta, QueryOptions, ResolveFn, RouteDefinition, RouteOptions, RouteParamBinding, } from "./decorators";
+export type { ClassProvider, EnvironmentProviders, ExistingProvider, FactoryProvider, Provider, ProviderDep, ProviderDependency, Token, Type, ValueProvider, } from "./provider";
+export { Body, CanDeactivate, Command, Controller, Data, Delete, Get, Head, Headers, Host, Inject, Injectable, Job, Module, Optional, Options, Param, Patch, Post, Put, Query, Resolve, Self, SkipSelf, Title, UseGuards, executeResolvers, getCommandMeta, getJobMeta, getControllerMeta, getGuards, getHostParams, getInjectParams, getOptionalParams, getRouteParams, getSelfParams, getSkipSelfParams, getInjectableMeta, getModuleMeta, getQueryMeta, getRoutes, COMMAND_METADATA, JOB_METADATA, CONTROLLER_METADATA, GUARDS_METADATA, CAN_DEACTIVATE_METADATA, HOST_PARAMS_METADATA, INJECTABLE_METADATA, INJECT_PARAMS_METADATA, RESOLVE_METADATA, OPTIONAL_PARAMS_METADATA, ROUTE_PARAMS_METADATA, SELF_PARAMS_METADATA, SKIP_SELF_PARAMS_METADATA, MODULE_METADATA, QUERY_METADATA, ROUTES_METADATA, } from "./decorators";
+export type { CanActivateFn, CanDeactivateFn, CanMatchFn, CommandMeta, CommandOptions, JobMeta, JobOptions, ControllerMeta, ControllerOptions, HttpMethod, InjectableMeta, InjectableOptions, ModuleMeta, ModuleOptions, ParamOptions, QueryMeta, QueryOptions, ResolveFn, RouteDefinition, RouteOptions, RouteParamBinding, } from "./decorators";
 export { defineModule } from "./module";
 export { APP_INITIALIZER, DB_CLIENT, DESTROY_REF, ENVIRONMENT_INITIALIZER, JOB_CONTEXT, REQUEST_CONTEXT, createDestroyRef, } from "./context";
 export type { DestroyRef, OnDestroy } from "./context";