@boon4681/giri 0.0.2 → 0.0.3-alpha-1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as Middleware, C as Context, H as HandlerResponse, V as ValidatedInput, S as Services, c as StatusCode, R as ResponseFormat, T as TypedResponse, d as MiddlewareOptions, B as BodyContentType, a as GiriBodySchema, b as GiriInputSchema, i as inputSchemaBrand, e as RouteInput, f as HttpMethod, g as GiriConfig, h as GiriPaths, j as SecurityRequirement } from './types-DkrKD1S4.js';
-export { G as GiriAdapter, k as GiriFetchHandler, l as GiriRequest, m as GiriRouteRegistration, n as GiriServeOptions, o as GiriServer, p as GiriServerInfo, q as Handle, I as Infer, r as InferStackVars, s as InputValidationResult, J as JsonSchema, t as MergeStack, u as MiddlewareOpenApi, v as MiddlewareVarsOf, N as Next, w as RouteInputOf, x as RouteOpenApi, y as RouteOpenApiConfig, z as ValidBody, A as ValidQuery, D as VarsOf } from './types-DkrKD1S4.js';
+import { M as Middleware, C as Context, H as HandlerResponse, V as ValidatedInput, S as Services, c as CookieJarFactory, d as StatusCode, R as ResponseFormat, T as TypedResponse, e as MiddlewareOptions, B as BodyContentType, a as GiriBodySchema, b as GiriInputSchema, i as inputSchemaBrand, f as RouteInput, g as HttpMethod, h as GiriConfig, j as GiriPaths, k as SecurityRequirement } from './types-BvRph0mx.js';
+export { l as CookieJar, m as CookieOptions, n as CookieSink, G as GiriAdapter, o as GiriFetchHandler, p as GiriRequest, q as GiriRouteRegistration, r as GiriServeOptions, s as GiriServer, t as GiriServerInfo, u as Handle, I as Infer, v as InferStackVars, w as InputValidationResult, J as JsonSchema, x as MergeStack, y as MiddlewareOpenApi, z as MiddlewareVarsOf, N as Next, A as RouteInputOf, D as RouteOpenApi, E as RouteOpenApiConfig, F as ValidBody, K as ValidQuery, L as VarsOf } from './types-BvRph0mx.js';
 
 interface CreateContextOptions<Params extends Record<string, string> = Record<string, string>, Input extends ValidatedInput = ValidatedInput> {
     request: Request;
@@ -8,12 +8,21 @@ interface CreateContextOptions<Params extends Record<string, string> = Record<st
     app?: Services;
     /** The adapter's native per-request context, stashed for backend-specific bridges. */
     native?: unknown;
+    /** Secret for `c.signedCookie` / `c.req.signedCookie` (from `config.cookieSecret`). */
+    cookieSecret?: string;
+    /** The adapter's cookie jar, built from its runtime's native helpers. */
+    cookies?: CookieJarFactory;
 }
 declare function createTypedResponse<T, S extends StatusCode, F extends ResponseFormat>(data: T, status: S, format: F, headers?: HeadersInit): TypedResponse<T, S, F>;
 declare function isTypedResponse(value: unknown): value is TypedResponse<unknown>;
 declare function createContext<Params extends Record<string, string> = Record<string, string>, Input extends ValidatedInput = ValidatedInput>(options: CreateContextOptions<Params, Input>): Context<Params, Input>;
 declare function typedResponseToResponse(response: TypedResponse<unknown>): Response;
-declare function toResponse(response: HandlerResponse): Response;
+/**
+ * Convert a handler's return value to a real `Response`, then merge any headers set imperatively via
+ * `c.header()` (the response's own headers win; pending ones fill the gaps). Pass the `context` so
+ * those imperative headers are applied; without it the response is returned unchanged.
+ */
+declare function toResponse(response: HandlerResponse, context?: Context): Response;
 declare function composeMiddleware(middleware: Middleware[], handle: (c: Context) => HandlerResponse | Promise<HandlerResponse>, context: Context): Promise<HandlerResponse>;
 type AnyMiddleware<Vars extends Record<string, unknown>> = Middleware<Record<string, string>, ValidatedInput, Vars>;
 declare function defineMiddleware<Vars extends Record<string, unknown> = {}>(middleware: AnyMiddleware<Vars>): AnyMiddleware<Vars>;
@@ -71,6 +80,14 @@ declare function scanRoutes(routesDir: string): Promise<ScannedRoute[]>;
 interface BuildGiriAppOptions {
     cwd?: string;
     services?: Services;
+    /** Files that changed since last build — only these are purged from require.cache before loading. */
+    dirty?: Set<string>;
+    /** Defer route-module evaluation until the adapter first reads its runtime fields. */
+    lazy?: boolean;
+    /** The caller owns a persistent TypeScript loader for lazy route evaluation. */
+    loaderRegistered?: boolean;
+    /** The caller owns a persistent project-alias resolver for lazy route evaluation. */
+    aliasResolverRegistered?: boolean;
 }
 interface BuiltGiriApp<App> {
     app: App;
@@ -120,6 +137,14 @@ interface RouteSecurity {
     /** Scheme definitions to merge into `components.securitySchemes`. */
     securitySchemes: Record<string, unknown>;
 }
+/** Resolved OpenAPI operation metadata (everything on `openapi` except `hidden`). */
+interface RouteOpenApiMeta {
+    tags?: string[];
+    summary?: string;
+    description?: string;
+    deprecated?: boolean;
+    operationId?: string;
+}
 
 /** The per-route metadata maps feeding `manifest.json` / `openapi.json`. */
 interface SyncData {
@@ -127,6 +152,7 @@ interface SyncData {
     inputsByFile: Map<string, RouteInputSchemas>;
     securityByFile: Map<string, RouteSecurity>;
     hiddenFiles: Set<string>;
+    openapiByFile: Map<string, RouteOpenApiMeta>;
 }
 interface SyncResult {
     paths: GiriPaths;
@@ -163,4 +189,4 @@ declare function runInit(lifecycle: GiriLifecycle): Promise<Services>;
 
 declare function defineConfig<App>(config: GiriConfig<App>): GiriConfig<App>;
 
-export { BodyContentType, Context, GiriBodySchema, GiriConfig, GiriInputSchema, type GiriLifecycle, GiriPaths, HandlerResponse, HttpMethod, Middleware, MiddlewareOptions, RouteInput, SecurityRequirement, Services, StatusCode, TypedResponse, ValidatedInput, buildGiriApp, composeMiddleware, createContext, createTypedResponse, defineBodySchema, defineConfig, defineInputSchema, defineMiddleware, isGiriBodySchema, isGiriInputSchema, isTypedResponse, loadLifecycle, prepareRequestInput, resolveGiriPaths, runInit, scanRoutes, stack, syncProject, toResponse, typedResponseToResponse };
+export { BodyContentType, Context, CookieJarFactory, GiriBodySchema, GiriConfig, GiriInputSchema, type GiriLifecycle, GiriPaths, HandlerResponse, HttpMethod, Middleware, MiddlewareOptions, RouteInput, SecurityRequirement, Services, StatusCode, TypedResponse, ValidatedInput, buildGiriApp, composeMiddleware, createContext, createTypedResponse, defineBodySchema, defineConfig, defineInputSchema, defineMiddleware, isGiriBodySchema, isGiriInputSchema, isTypedResponse, loadLifecycle, prepareRequestInput, resolveGiriPaths, runInit, scanRoutes, stack, syncProject, toResponse, typedResponseToResponse };