@supacloud/elysia 0.10.0 → 0.16.0

package/dist/index.d.ts

@@ -1,6 +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;
@@ -10,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. */
@@ -40,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 {
@@ -127,6 +158,7 @@ export interface CommandGovernance {
             audit?: boolean;
             transaction?: boolean;
             idempotency?: boolean;
+            boundary?: "database" | "external";
         };
         execute: CommandMiddleware;
     }>;
@@ -173,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. */
@@ -187,6 +223,8 @@ export interface ApplicationOptions {
     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;
@@ -222,6 +260,18 @@ export declare function executeCompiledCommand<Input, Result>(options: {
     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;
 /**
@@ -232,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" | "onExecution">, 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.
  *
@@ -256,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";