@supacloud/elysia 0.9.0 → 0.14.1

package/dist/index.d.ts

@@ -1,4 +1,14 @@
 import { Elysia } from "elysia";
+import { type CommandPreview } from "@supacloud/contracts";
+import { type EnvironmentInjector } from "@supacloud/app";
+import { type ExecutionObserver } from "./execution";
+import { type ApplicationDocumentationOptions } from "./documentation";
+export type { ExecutionEvent, ExecutionObserver } from "./execution";
+export { createSchemaDecoder, assertResponseStatusDeclared, defineElysiaRoute, defineJsonContract, defineRouteContract, registerElysiaRoute, responseSchemaForStatus, responseStatusDeclared, responseStatusOf, SchemaContractError, toElysiaRouteSchema, } from "./schema_contract";
+export type { ElysiaRouteContext, ElysiaRouteDefinition, ElysiaRouteHandler, ElysiaRouteSchema, ResponseMapSelector, RouteContractSchemas, SchemaDecoderOptions, SchemaNormalizeMode, } from "./schema_contract";
+export { createPersistentCommandAdapter, type PersistentCommandHandler } from "./persistent-command";
+export { createDocumentationPlugin } from "./documentation";
+export type { ApplicationDocumentationOptions, DocumentationSource, GraphqlDocumentationOptions, OpenApiDocumentationOptions, } from "./documentation";
 export interface CompiledRoute {
     method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
     path: string;
@@ -8,13 +18,28 @@ export interface CompiledRoute {
     body?: unknown;
     params?: unknown;
     query?: unknown;
+    headers?: unknown;
+    cookie?: unknown;
+    /** @deprecated Use `responses` with an explicit HTTP status map. */
     response?: unknown;
+    responses?: Record<string | number, unknown>;
+    /** Compile-time ownership and transport classification for the route boundary. */
+    contract?: {
+        body?: "framework" | "domain";
+        response?: "framework" | "native-json" | "binary" | "stream";
+        evidence?: string;
+    };
+    /** Whether each declared schema is concrete or intentionally opaque. */
+    schemaKinds?: Partial<Record<"body" | "params" | "query" | "headers" | "cookie" | "response", "opaque" | "declared">>;
+    /** True when the handler returns a native Response rather than a framework value. */
+    nativeResponse?: boolean;
     /** Compiler-emitted positional invoker; used when available. */
     invoker?: (controller: unknown, request: {
         params?: Record<string, unknown>;
         query?: Record<string, unknown>;
         body?: unknown;
         headers?: Record<string, unknown>;
+        cookie?: Record<string, unknown>;
         context?: unknown;
     }) => Promise<unknown> | unknown;
     /** Class name of the @Command explicitly bound to this route. */
@@ -23,6 +48,7 @@ export interface CompiledRoute {
     aspects?: ApplicationAspect[];
 }
 export interface CompiledCommand {
+    rpc?: string;
     className: string;
     name: string;
     permission?: string;
@@ -37,6 +63,14 @@ export interface CompiledJob {
     name: string;
     serviceKey: string;
     scope: "application" | "request" | "job";
+    /** TypeBox input schema emitted by the compiler. */
+    input?: unknown;
+    /** TypeBox output schema emitted by the compiler. */
+    output?: unknown;
+    mode?: "task" | "workflow";
+    timeoutSec?: number;
+    maxAttempts?: number;
+    idempotency?: "required" | "none";
     aspects?: ApplicationAspect[];
 }
 export interface CompiledController {
@@ -61,6 +95,8 @@ export interface CompiledModule {
     aspects?: ApplicationAspect[];
 }
 export type RequestContextFactory = (request: Request) => unknown | Promise<unknown>;
+export { createSupAuthRequestContext } from "./identity";
+export type { SupAuthIdentity, SupAuthAccess, SupAuthRequestContext, SupAuthContextOptions } from "./identity";
 export declare const VERIFIED_JWT_SUBJECT_HEADER = "x-supacloud-jwt-sub";
 export declare const EXECUTION_ID_HEADER = "x-sb-execution-id";
 export declare const IDEMPOTENCY_KEY_HEADER = "idempotency-key";
@@ -116,6 +152,16 @@ export interface CommandAudit {
     failed(invocation: CommandInvocation, error: unknown): void | Promise<void>;
 }
 export interface CommandGovernance {
+    /** Application-owned adapters: a single RPC owns all declared persistence. */
+    rpc?: Record<string, {
+        capabilities: {
+            audit?: boolean;
+            transaction?: boolean;
+            idempotency?: boolean;
+            boundary?: "database" | "external";
+        };
+        execute: CommandMiddleware;
+    }>;
     authorize: CommandAuthorizer;
     idempotency?: CommandMiddleware;
     transaction?: CommandMiddleware;
@@ -159,10 +205,14 @@ export interface ErrorContext {
 export type ErrorMapper = (error: unknown, context: ErrorContext) => Response | undefined | Promise<Response | undefined>;
 export interface ApplicationOptions {
     name?: string;
+    /** false rejects extra schema properties instead of silently removing them. */
+    normalize?: boolean;
     /** Modules in topological import order. */
     modules?: CompiledModule[];
     /** Platform-level dependencies (db client etc.), passed to createServices. */
     deps?: Record<string, unknown>;
+    /** Optional Angular-backed root injector used for async request contexts. */
+    injector?: EnvironmentInjector;
     /** Builds the per-request context object. Defaults to { requestId, request }. */
     requestContext?: RequestContextFactory;
     /** Enforces permission/audit/idempotency policy for command-bound routes. */
@@ -171,6 +221,10 @@ export interface ApplicationOptions {
     commandExecutor?: CommandExecutor;
     /** Maps framework or application failures to the public HTTP contract. */
     errorMapper?: ErrorMapper;
+    /** Best-effort execution metadata only; durable audit belongs to governance. */
+    onExecution?: ExecutionObserver;
+    /** Optional read-only OpenAPI and GraphQL documentation endpoints. */
+    documentation?: ApplicationDocumentationOptions;
 }
 export interface JobInvocation {
     job: CompiledJob;
@@ -185,13 +239,39 @@ export type JobExecutor = (invocation: JobInvocation, next: () => unknown | Prom
  * Runtime. The runtime strips incoming x-supacloud-jwt-sub values and writes
  * the header only after JWT verification.
  */
-export declare const createSupaCloudRequestContext: RequestContextFactory;
+export declare const createSupaCloudRequestContext: (request: Request) => SupaCloudRequestContext;
 /**
  * Compose the standard command governance order:
  * authorization -> idempotency -> transaction -> audit -> handler.
  * Declared governance metadata fails closed when its adapter is absent.
  */
-export declare function createCommandExecutor(governance: CommandGovernance): CommandExecutor;
+export declare function createCommandExecutor(governance: CommandGovernance, observer?: ExecutionObserver): CommandExecutor;
+/** Execute at the business-selected boundary without binding or re-entering an HTTP route. */
+export declare function executeCompiledCommand<Input, Result>(options: {
+    module: Pick<CompiledModule, "name" | "commands" | "aspects">;
+    command: string;
+    input: Input;
+    request: Request;
+    requestContext: unknown;
+    services?: Record<string, unknown>;
+    scope?: Record<string, unknown>;
+    governance: CommandGovernance;
+    observer?: ExecutionObserver;
+    handler: (input: Input) => Result | Promise<Result>;
+    decode: (value: unknown) => Result;
+}): Promise<Result>;
+/** Read-only actionability. Accepts the same governance object as execute, but only runs authorize. */
+export declare function previewCompiledCommand<Input>(options: {
+    module: Pick<CompiledModule, "name" | "commands">;
+    command: string;
+    input: Input;
+    request: Request;
+    requestContext: unknown;
+    services?: Record<string, unknown>;
+    scope?: Record<string, unknown>;
+    governance: CommandGovernance;
+    preview: (input: Input) => unknown;
+}): Promise<CommandPreview>;
 export declare function requireTrustedIdentity(requestContext: unknown): Required<Pick<TrustedRequestIdentity, "subject" | "accessToken">> & TrustedRequestIdentity;
 export declare function requireIdempotencyKey(invocation: CommandInvocation): string;
 /**
@@ -202,7 +282,7 @@ export declare function requireIdempotencyKey(invocation: CommandInvocation): st
  * exposed on the `scope` context key. Request-scoped controller instances are
  * looked up on `scope`, everything else on `services`.
  */
-export declare function createModulePlugin(compiled: CompiledModule, services: Record<string, unknown>, ctxFactory?: RequestContextFactory, options?: Pick<ApplicationOptions, "commandGovernance" | "commandExecutor" | "errorMapper">, imported?: Record<string, Record<string, unknown>>): Elysia;
+export declare function createModulePlugin(compiled: CompiledModule, services: Record<string, unknown>, ctxFactory?: RequestContextFactory, options?: Pick<ApplicationOptions, "commandGovernance" | "commandExecutor" | "errorMapper" | "onExecution" | "normalize" | "injector">, imported?: Record<string, Record<string, unknown>>): Elysia;
 /**
  * Execute one compiler-emitted Job descriptor.
  *
@@ -210,7 +290,7 @@ export declare function createModulePlugin(compiled: CompiledModule, services: R
  * accepted for command-like job implementations. The scope factory and
  * destruction hooks are generated statically by the compiler.
  */
-export declare function executeJob(compiled: CompiledModule, services: Record<string, unknown>, job: CompiledJob, input: unknown, requestContext: unknown, imported?: Record<string, Record<string, unknown>>, executor?: JobExecutor): Promise<unknown>;
+export declare function executeJob(compiled: CompiledModule, services: Record<string, unknown>, job: CompiledJob, input: unknown, requestContext: unknown, imported?: Record<string, Record<string, unknown>>, executor?: JobExecutor, observer?: ExecutionObserver): Promise<unknown>;
 export declare function defaultErrorResponse(error: unknown, frameworkCode?: string | number): Response;
 /**
  * Create the root Elysia application from compiled modules.
@@ -226,3 +306,5 @@ export { createMemorySandbox, } from "./memory";
 export type { HandleLike as MemoryHandleLike, MemoryDatabase, MemorySandbox, MemorySandboxOptions, MemoryStorage, MemoryStorageObject, } from "./memory";
 export { createMemoryPolicy } from "./memory_policy";
 export type { MemoryPolicy } from "./memory_policy";
+export { createQueueWorkerTransport, createWorker, SupaCloudWorker, WorkerRegistrationError, WorkerReceiptUnconfirmedError, } from "./worker";
+export type { WorkerAcknowledge, WorkerClaim, WorkerFail, WorkerOptions, QueueWorkerTransportOptions, WorkerQueueFailureOptions, WorkerQueueMessage, WorkerQueuePort, WorkerQueueReceiveOptions, WorkerReceiptContext, WorkerReceiptOperation, WorkerRunResult, WorkerState, WorkerTransport, } from "./worker";