@vistagenic/vista 0.2.16 → 0.3.2

package/dist/server/vista-import-map.js

@@ -1,123 +1,134 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveVistaSourceRequest = resolveVistaSourceRequest;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-let nativeModule = null;
-let nativeLoadAttempted = false;
-function loadNativeModule() {
-    if (nativeLoadAttempted) {
-        return nativeModule;
-    }
-    nativeLoadAttempted = true;
-    const possiblePaths = [
-        path_1.default.resolve(__dirname, '../../../../crates/vista-napi'),
-        path_1.default.resolve(__dirname, '../../../crates/vista-napi'),
-        path_1.default.resolve(process.cwd(), '../crates/vista-napi'),
-        '@aspect-build/vista-napi',
-    ];
-    for (const modulePath of possiblePaths) {
-        try {
-            nativeModule = require(modulePath);
-            return nativeModule;
-        }
-        catch {
-            // continue
-        }
-    }
-    return null;
-}
-function resolveExistingModuleBase(candidateBase) {
-    for (const extension of ['.js', '.ts', '.tsx', '.jsx']) {
-        const absolutePath = `${candidateBase}${extension}`;
-        if (fs_1.default.existsSync(absolutePath)) {
-            return absolutePath;
-        }
-    }
-    for (const extension of ['.js', '.ts', '.tsx', '.jsx']) {
-        const indexPath = path_1.default.join(candidateBase, `index${extension}`);
-        if (fs_1.default.existsSync(indexPath)) {
-            return indexPath;
-        }
-    }
-    return null;
-}
-function normalizeVistaRequest(request) {
-    const normalizedRequest = request === '@vistagenic/vista'
-        ? 'vista'
-        : request.startsWith('@vistagenic/vista/')
-            ? `vista/${request.slice('@vistagenic/vista/'.length)}`
-            : request;
-    if (normalizedRequest !== 'vista' && !normalizedRequest.startsWith('vista/')) {
-        return null;
-    }
-    return normalizedRequest;
-}
-function resolveSourceCandidates(packageRoot, subpath) {
-    if (subpath === '') {
-        return [path_1.default.join(packageRoot, 'react-server'), path_1.default.join(packageRoot, 'index')];
-    }
-    const sourceMap = {
-        link: [path_1.default.join(packageRoot, 'client', 'link')],
-        image: [path_1.default.join(packageRoot, 'image', 'react-server'), path_1.default.join(packageRoot, 'image', 'index')],
-        router: [path_1.default.join(packageRoot, 'client', 'router')],
-        navigation: [path_1.default.join(packageRoot, 'client', 'navigation')],
-        dynamic: [path_1.default.join(packageRoot, 'client', 'dynamic')],
-        script: [path_1.default.join(packageRoot, 'client', 'script')],
-        font: [path_1.default.join(packageRoot, 'font', 'index')],
-        'font/google': [path_1.default.join(packageRoot, 'font', 'google')],
-        'font/local': [path_1.default.join(packageRoot, 'font', 'local')],
-        head: [path_1.default.join(packageRoot, 'client', 'head.react-server'), path_1.default.join(packageRoot, 'client', 'head')],
-        config: [path_1.default.join(packageRoot, 'config')],
-        stack: [path_1.default.join(packageRoot, 'stack', 'index')],
-        'stack/client': [path_1.default.join(packageRoot, 'stack', 'client', 'index')],
-        'client/rsc-router': [path_1.default.join(packageRoot, 'client', 'rsc-router')],
-        'client/server-actions': [path_1.default.join(packageRoot, 'client', 'server-actions')],
-        server: [path_1.default.join(packageRoot, 'server', 'index')],
-        'server/runtime-actions': [path_1.default.join(packageRoot, 'server', 'runtime-actions')],
-        cache: [path_1.default.join(packageRoot, 'server', 'cache')],
-    };
-    if (sourceMap[subpath]) {
-        return sourceMap[subpath];
-    }
-    if (subpath.startsWith('server/')) {
-        return [path_1.default.join(packageRoot, 'server', subpath.slice('server/'.length))];
-    }
-    if (subpath.startsWith('client/')) {
-        return [path_1.default.join(packageRoot, 'client', subpath.slice('client/'.length))];
-    }
-    return [path_1.default.join(packageRoot, subpath)];
-}
-function resolveVistaSourceRequest(request, packageRoot) {
-    const native = loadNativeModule();
-    if (native?.resolveVistaSourceImport) {
-        try {
-            const nativeResolution = native.resolveVistaSourceImport(request, packageRoot);
-            if (nativeResolution?.resolvedPath) {
-                return nativeResolution.resolvedPath;
-            }
-            if (nativeResolution) {
-                return null;
-            }
-        }
-        catch {
-            // fall through to JS fallback
-        }
-    }
-    const normalizedRequest = normalizeVistaRequest(request);
-    if (!normalizedRequest) {
-        return null;
-    }
-    const subpath = normalizedRequest === 'vista' ? '' : normalizedRequest.slice('vista/'.length);
-    const candidateBases = resolveSourceCandidates(packageRoot, subpath);
-    for (const candidateBase of candidateBases) {
-        const resolved = resolveExistingModuleBase(candidateBase);
-        if (resolved) {
-            return resolved;
-        }
-    }
-    return null;
-}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVistaSourceRequest = resolveVistaSourceRequest;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+let nativeModule = null;
+let nativeLoadAttempted = false;
+function loadNativeModule() {
+    if (nativeLoadAttempted) {
+        return nativeModule;
+    }
+    nativeLoadAttempted = true;
+    const possiblePaths = [
+        path_1.default.resolve(__dirname, '../../../../crates/vista-napi'),
+        path_1.default.resolve(__dirname, '../../../crates/vista-napi'),
+        path_1.default.resolve(process.cwd(), '../crates/vista-napi'),
+        '@aspect-build/vista-napi',
+    ];
+    for (const modulePath of possiblePaths) {
+        try {
+            nativeModule = require(modulePath);
+            return nativeModule;
+        }
+        catch {
+            // continue
+        }
+    }
+    return null;
+}
+function resolveExistingModuleBase(candidateBase) {
+    for (const extension of ['.js', '.ts', '.tsx', '.jsx']) {
+        const absolutePath = `${candidateBase}${extension}`;
+        if (fs_1.default.existsSync(absolutePath)) {
+            return absolutePath;
+        }
+    }
+    for (const extension of ['.js', '.ts', '.tsx', '.jsx']) {
+        const indexPath = path_1.default.join(candidateBase, `index${extension}`);
+        if (fs_1.default.existsSync(indexPath)) {
+            return indexPath;
+        }
+    }
+    return null;
+}
+function normalizeVistaRequest(request) {
+    const normalizedRequest = request === '@vistagenic/vista'
+        ? 'vista'
+        : request.startsWith('@vistagenic/vista/')
+            ? `vista/${request.slice('@vistagenic/vista/'.length)}`
+            : request;
+    if (normalizedRequest !== 'vista' && !normalizedRequest.startsWith('vista/')) {
+        return null;
+    }
+    return normalizedRequest;
+}
+function resolveSourceCandidates(packageRoot, subpath) {
+    if (subpath === '') {
+        return [path_1.default.join(packageRoot, 'react-server'), path_1.default.join(packageRoot, 'index')];
+    }
+    const sourceMap = {
+        link: [path_1.default.join(packageRoot, 'client', 'link.react-server'), path_1.default.join(packageRoot, 'client', 'link')],
+        image: [path_1.default.join(packageRoot, 'image', 'react-server'), path_1.default.join(packageRoot, 'image', 'index')],
+        router: [path_1.default.join(packageRoot, 'client', 'router.react-server'), path_1.default.join(packageRoot, 'client', 'router')],
+        navigation: [
+            path_1.default.join(packageRoot, 'client', 'navigation.react-server'),
+            path_1.default.join(packageRoot, 'client', 'navigation'),
+        ],
+        dynamic: [path_1.default.join(packageRoot, 'client', 'dynamic.react-server'), path_1.default.join(packageRoot, 'client', 'dynamic')],
+        script: [path_1.default.join(packageRoot, 'client', 'script.react-server'), path_1.default.join(packageRoot, 'client', 'script')],
+        font: [path_1.default.join(packageRoot, 'font', 'index')],
+        'font/google': [path_1.default.join(packageRoot, 'font', 'google')],
+        'font/local': [path_1.default.join(packageRoot, 'font', 'local')],
+        theme: [path_1.default.join(packageRoot, 'theme', 'react-server'), path_1.default.join(packageRoot, 'theme', 'index')],
+        head: [path_1.default.join(packageRoot, 'client', 'head.react-server'), path_1.default.join(packageRoot, 'client', 'head')],
+        config: [path_1.default.join(packageRoot, 'config')],
+        auth: [path_1.default.join(packageRoot, 'auth', 'index')],
+        'auth/react': [path_1.default.join(packageRoot, 'auth', 'react-server'), path_1.default.join(packageRoot, 'auth', 'react')],
+        ai: [path_1.default.join(packageRoot, 'ai', 'index')],
+        'ai/react': [path_1.default.join(packageRoot, 'ai', 'react', 'react-server'), path_1.default.join(packageRoot, 'ai', 'react', 'index')],
+        stack: [path_1.default.join(packageRoot, 'stack', 'index')],
+        'stack/client': [path_1.default.join(packageRoot, 'stack', 'client', 'index')],
+        'client/rsc-router': [
+            path_1.default.join(packageRoot, 'client', 'rsc-router.react-server'),
+            path_1.default.join(packageRoot, 'client', 'rsc-router'),
+        ],
+        'client/server-actions': [path_1.default.join(packageRoot, 'client', 'server-actions')],
+        server: [path_1.default.join(packageRoot, 'server', 'index')],
+        'server/runtime-actions': [path_1.default.join(packageRoot, 'server', 'runtime-actions')],
+        cache: [path_1.default.join(packageRoot, 'server', 'cache')],
+    };
+    if (sourceMap[subpath]) {
+        return sourceMap[subpath];
+    }
+    if (subpath.startsWith('server/')) {
+        return [path_1.default.join(packageRoot, 'server', subpath.slice('server/'.length))];
+    }
+    if (subpath.startsWith('client/')) {
+        return [path_1.default.join(packageRoot, 'client', subpath.slice('client/'.length))];
+    }
+    return [path_1.default.join(packageRoot, subpath)];
+}
+function resolveVistaSourceRequest(request, packageRoot) {
+    const native = loadNativeModule();
+    if (native?.resolveVistaSourceImport) {
+        try {
+            const nativeResolution = native.resolveVistaSourceImport(request, packageRoot);
+            if (nativeResolution?.resolvedPath) {
+                return nativeResolution.resolvedPath;
+            }
+            if (nativeResolution) {
+                return null;
+            }
+        }
+        catch {
+            // fall through to JS fallback
+        }
+    }
+    const normalizedRequest = normalizeVistaRequest(request);
+    if (!normalizedRequest) {
+        return null;
+    }
+    const subpath = normalizedRequest === 'vista' ? '' : normalizedRequest.slice('vista/'.length);
+    const candidateBases = resolveSourceCandidates(packageRoot, subpath);
+    for (const candidateBase of candidateBases) {
+        const resolved = resolveExistingModuleBase(candidateBase);
+        if (resolved) {
+            return resolved;
+        }
+    }
+    return null;
+}

package/dist/stack/index.d.ts

@@ -1,32 +1,34 @@
-import { mergeRouters as mergeStackRouters } from './server/merge-routers';
-import { type ProcedureBuilder } from './server/procedure';
-import { type CreateRouterOptions } from './server/router';
-import { type StackSerializer } from './server/serialization';
-import type { MiddlewareFunction, ProcedureRecord, StackRouter, StackSerializationMode } from './server/types';
-/**
- * Package entry for `@vistagenic/vista/stack`.
- *
- * Example:
- *   import { vstack } from '@vistagenic/vista/stack'
- *   const v = vstack.init()
- */
-export interface VStackInitOptions {
-    serialization?: StackSerializationMode;
-}
-export interface VStackInstance<TCtx, TEnv> {
-    procedure: ProcedureBuilder<TCtx, TEnv>;
-    middleware<TCurrentCtx extends TCtx, TOutput extends Record<string, unknown> = {}>(handler: MiddlewareFunction<TCurrentCtx, TOutput, TEnv>): MiddlewareFunction<TCurrentCtx, TOutput, TEnv>;
-    router<TProcedures extends ProcedureRecord>(procedures: TProcedures, options?: CreateRouterOptions<TEnv>): StackRouter<TProcedures, TCtx, TEnv>;
-    mergeRouters: typeof mergeStackRouters;
-    serializer: StackSerializer;
-    options: Required<VStackInitOptions>;
-}
-export declare function initStack<TCtx extends Record<string, unknown> = {}, TEnv = unknown>(options?: VStackInitOptions): VStackInstance<TCtx, TEnv>;
-export declare const vstack: {
-    init: typeof initStack;
-};
-/**
- * Re-export server stack primitives from `@vistagenic/vista/stack`.
- */
-export type { CreateRouterOptions } from './server/router';
-export * from './server';
+import { mergeRouters as mergeStackRouters } from './server/merge-routers';
+import { type CreateCallerOptions, type InferCaller } from './server/caller';
+import { type ProcedureBuilder } from './server/procedure';
+import { type CreateRouterOptions } from './server/router';
+import { type StackSerializer } from './server/serialization';
+import type { MiddlewareFunction, ProcedureRecord, StackRouter, StackSerializationMode } from './server/types';
+/**
+ * Package entry for `@vistagenic/vista/stack`.
+ *
+ * Example:
+ *   import { vstack } from '@vistagenic/vista/stack'
+ *   const v = vstack.init()
+ */
+export interface VStackInitOptions {
+    serialization?: StackSerializationMode;
+}
+export interface VStackInstance<TCtx, TEnv> {
+    procedure: ProcedureBuilder<TCtx, TEnv>;
+    middleware<TCurrentCtx extends TCtx, TOutput extends Record<string, unknown> = {}>(handler: MiddlewareFunction<TCurrentCtx, TOutput, TEnv>): MiddlewareFunction<TCurrentCtx, TOutput, TEnv>;
+    router<TProcedures extends ProcedureRecord>(procedures: TProcedures, options?: CreateRouterOptions<TEnv>): StackRouter<TProcedures, TCtx, TEnv>;
+    mergeRouters: typeof mergeStackRouters;
+    createCaller<TProcedures extends ProcedureRecord>(router: StackRouter<TProcedures, TCtx, TEnv>, options: CreateCallerOptions<TCtx, TEnv>): InferCaller<TProcedures>;
+    serializer: StackSerializer;
+    options: Required<VStackInitOptions>;
+}
+export declare function initStack<TCtx extends Record<string, unknown> = {}, TEnv = unknown>(options?: VStackInitOptions): VStackInstance<TCtx, TEnv>;
+export declare const vstack: {
+    init: typeof initStack;
+};
+/**
+ * Re-export server stack primitives from `@vistagenic/vista/stack`.
+ */
+export type { CreateRouterOptions } from './server/router';
+export * from './server';

package/dist/stack/index.js

@@ -1,45 +1,49 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.vstack = void 0;
-exports.initStack = initStack;
-const merge_routers_1 = require("./server/merge-routers");
-const procedure_1 = require("./server/procedure");
-const router_1 = require("./server/router");
-const serialization_1 = require("./server/serialization");
-function initStack(options = {}) {
-    const normalizedOptions = {
-        serialization: options.serialization ?? 'json',
-    };
-    return {
-        procedure: (0, procedure_1.createProcedureBuilder)(),
-        middleware(handler) {
-            return handler;
-        },
-        router(procedures, routerOptions) {
-            return (0, router_1.createRouter)(procedures, routerOptions);
-        },
-        mergeRouters(...routers) {
-            return (0, merge_routers_1.mergeRouters)(...routers);
-        },
-        serializer: (0, serialization_1.createSerializer)(normalizedOptions.serialization),
-        options: normalizedOptions,
-    };
-}
-exports.vstack = {
-    init: initStack,
-};
-__exportStar(require("./server"), exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vstack = void 0;
+exports.initStack = initStack;
+const merge_routers_1 = require("./server/merge-routers");
+const caller_1 = require("./server/caller");
+const procedure_1 = require("./server/procedure");
+const router_1 = require("./server/router");
+const serialization_1 = require("./server/serialization");
+function initStack(options = {}) {
+    const normalizedOptions = {
+        serialization: options.serialization ?? 'json',
+    };
+    return {
+        procedure: (0, procedure_1.createProcedureBuilder)(),
+        middleware(handler) {
+            return handler;
+        },
+        router(procedures, routerOptions) {
+            return (0, router_1.createRouter)(procedures, routerOptions);
+        },
+        mergeRouters(...routers) {
+            return (0, merge_routers_1.mergeRouters)(...routers);
+        },
+        createCaller(router, callerOptions) {
+            return (0, caller_1.createCaller)(router, callerOptions);
+        },
+        serializer: (0, serialization_1.createSerializer)(normalizedOptions.serialization),
+        options: normalizedOptions,
+    };
+}
+exports.vstack = {
+    init: initStack,
+};
+__exportStar(require("./server"), exports);

package/dist/stack/server/caller.d.ts

@@ -0,0 +1,13 @@
+import type { OperationType, ProcedureRecord, StackRequestLike, StackRouter, StackSerializationMode } from './types';
+export interface CreateCallerOptions<TCtx, TEnv> {
+    ctx: TCtx;
+    env: TEnv;
+    req?: StackRequestLike;
+    serialization?: StackSerializationMode;
+}
+type CallerFn<TInput, TOutput> = [TInput] extends [void] ? () => Promise<TOutput> : (input: TInput) => Promise<TOutput>;
+export type InferCaller<TNode> = TNode extends OperationType<infer TInput, infer TOutput, any, any> ? CallerFn<TInput, TOutput> : TNode extends ProcedureRecord ? {
+    [TKey in keyof TNode]: InferCaller<TNode[TKey]>;
+} : never;
+export declare function createCaller<TProcedures extends ProcedureRecord, TCtx, TEnv>(router: StackRouter<TProcedures, TCtx, TEnv>, options: CreateCallerOptions<TCtx, TEnv>): InferCaller<TProcedures>;
+export {};

package/dist/stack/server/caller.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCaller = createCaller;
+const procedure_1 = require("./procedure");
+const executor_1 = require("./executor");
+function buildRequest(operation, input, base) {
+    if (operation.type === 'get') {
+        return {
+            ...base,
+            method: 'GET',
+            query: input ?? base?.query ?? {},
+        };
+    }
+    return {
+        ...base,
+        method: 'POST',
+        body: input ?? base?.body,
+    };
+}
+function createNodeCaller(node, router, options) {
+    if ((0, procedure_1.isOperation)(node)) {
+        return async (input) => {
+            const toolkit = (0, executor_1.createResponseToolkit)(options.serialization ?? 'json');
+            return (0, executor_1.executeOperation)(node, {
+                ctx: options.ctx,
+                env: options.env,
+                req: buildRequest(node, input, options.req),
+                c: toolkit,
+                middlewares: router.metadata.globalMiddlewares,
+                serialization: options.serialization,
+            });
+        };
+    }
+    const nested = {};
+    for (const [key, child] of Object.entries(node)) {
+        nested[key] = createNodeCaller(child, router, options);
+    }
+    return nested;
+}
+function createCaller(router, options) {
+    return createNodeCaller(router.procedures, router, options);
+}

package/dist/stack/server/executor.d.ts

@@ -1,36 +1,40 @@
-import type { MiddlewareFunction, OperationType, ProcedureRecord, StackExecutionContext, StackRequestLike, StackResponseToolkit, StackRouter, StackSerializationMode } from './types';
-export declare class StackRouteNotFoundError extends Error {
-    status: number;
-    constructor(path: string);
-}
-export declare class StackMethodNotAllowedError extends Error {
-    status: number;
-    constructor(path: string, method: string);
-}
-export declare class StackValidationError extends Error {
-    status: number;
-    cause: unknown;
-    constructor(message: string, cause?: unknown);
-}
-export declare function createResponseToolkit(mode?: StackSerializationMode): StackResponseToolkit;
-export declare function runMiddlewareChain<TCtx, TEnv>(middlewares: MiddlewareFunction<any, any, TEnv>[], context: TCtx, env: TEnv, req: StackRequestLike, c: StackResponseToolkit): Promise<TCtx>;
-export interface ExecuteOperationOptions<TCtx, TEnv> extends StackExecutionContext<TCtx, TEnv> {
-    middlewares?: MiddlewareFunction<any, any, TEnv>[];
-    serialization?: StackSerializationMode;
-}
-export declare function executeOperation<TCtx, TInput, TOutput, TEnv>(operation: OperationType<TInput, TOutput, TCtx, TEnv>, options: ExecuteOperationOptions<TCtx, TEnv>): Promise<TOutput>;
-export interface ExecuteRouteOptions<TCtx, TEnv> {
-    path: string;
-    method: string;
-    req: StackRequestLike;
-    ctx: TCtx;
-    env: TEnv;
-    serialization?: StackSerializationMode;
-}
-export interface ExecuteRouteResult<TData = unknown> {
-    path: string;
-    method: string;
-    data: TData;
-    serializedData: unknown;
-}
-export declare function executeRoute<TProcedures extends ProcedureRecord, TCtx, TEnv>(router: StackRouter<TProcedures, TCtx, TEnv>, options: ExecuteRouteOptions<TCtx, TEnv>): Promise<ExecuteRouteResult>;
+import type { MiddlewareFunction, OperationType, ProcedureRecord, StackExecutionContext, StackRequestLike, StackResponseToolkit, StackRouter, StackSerializationMode } from './types';
+export declare class StackRouteNotFoundError extends Error {
+    status: number;
+    constructor(path: string);
+}
+export declare class StackMethodNotAllowedError extends Error {
+    status: number;
+    constructor(path: string, method: string);
+}
+export declare class StackValidationError extends Error {
+    status: number;
+    cause: unknown;
+    constructor(message: string, cause?: unknown);
+}
+export declare class StackOutputValidationError extends StackValidationError {
+    status: number;
+    constructor(message: string, cause?: unknown);
+}
+export declare function createResponseToolkit(mode?: StackSerializationMode): StackResponseToolkit;
+export declare function runMiddlewareChain<TCtx, TEnv>(middlewares: MiddlewareFunction<any, any, TEnv>[], context: TCtx, env: TEnv, req: StackRequestLike, c: StackResponseToolkit): Promise<TCtx>;
+export interface ExecuteOperationOptions<TCtx, TEnv> extends StackExecutionContext<TCtx, TEnv> {
+    middlewares?: MiddlewareFunction<any, any, TEnv>[];
+    serialization?: StackSerializationMode;
+}
+export declare function executeOperation<TCtx, TInput, TOutput, TEnv>(operation: OperationType<TInput, TOutput, TCtx, TEnv>, options: ExecuteOperationOptions<TCtx, TEnv>): Promise<TOutput>;
+export interface ExecuteRouteOptions<TCtx, TEnv> {
+    path: string;
+    method: string;
+    req: StackRequestLike;
+    ctx: TCtx;
+    env: TEnv;
+    serialization?: StackSerializationMode;
+}
+export interface ExecuteRouteResult<TData = unknown> {
+    path: string;
+    method: string;
+    data: TData;
+    serializedData: unknown;
+}
+export declare function executeRoute<TProcedures extends ProcedureRecord, TCtx, TEnv>(router: StackRouter<TProcedures, TCtx, TEnv>, options: ExecuteRouteOptions<TCtx, TEnv>): Promise<ExecuteRouteResult>;