@sourceregistry/sveltekit-enhance 1.1.1 → 1.1.2

package/README.md

@@ -9,7 +9,7 @@ Use `@sourceregistry/sveltekit-enhance` to build cleaner actions, loads, methods
 
 ## Why teams use this
 
-- Standardize server-side guard logic across routes.
+- Standardize server-side context logic across routes.
 - Reduce repetitive request parsing and validation code.
 - Keep middleware-like behavior explicit and composable.
 - Improve observability with correlation IDs on every response.
@@ -29,7 +29,7 @@ The package provides an `enhance` wrapper for:
 - `enhance.method(...)`
 - `enhance.handle(...)`
 
-Each wrapper accepts one or more guard functions and merges their outputs into a typed `guard` object.
+Each wrapper accepts one or more context functions and merges their outputs into a typed `context` object.
 
 ## Quick start
 
@@ -40,13 +40,13 @@ import {Auth, FeatureFlag, form} from '@sourceregistry/sveltekit-enhance';
 
 export const actions = {
   save: enhance.action(
-    async ({request, guard}) => {
+    async ({request, context}) => {
       const data = await request.formData();
       const email = form.string$(data, 'email');
 
       return {
         ok: true,
-        token: guard.token,
+        token: context.token,
         email
       };
     },

package/dist/index.d.ts

@@ -21,7 +21,7 @@ export type EnhanceInput<CallType extends EnhanceCallType = EnhanceCallType, Par
     get errorHandlers(): EnhanceErrorHandler[];
 } & (CallType extends 'handle' ? {
     get responseHandlers(): EnhanceResponseHandler[];
-    resolve: (event?: RequestEvent) => never;
+    resolve: (event?: RequestEvent, opts?: ResolveOptions) => MaybePromise<Response>;
     readonly event: RequestEvent;
 } : CallType extends 'load' ? {
     parent: ServerLoadEvent<Params, ParentData, RouteId>['parent'];

package/dist/index.js

@@ -118,6 +118,7 @@ handle, ...contexts) => {
 };
 export const handle = (handle, ...contexts) => async (input) => {
     let combined = {};
+    let resolved = false;
     const contextInput = Object.assign(input.event, {
         __errorHandlers__: [],
         __responseHandler__: [],
@@ -129,24 +130,71 @@ export const handle = (handle, ...contexts) => async (input) => {
         get responseHandlers() {
             return this.__responseHandler__;
         },
-        resolve: (event = input.event) => {
-            throw input.resolve(event);
+        resolve: (event = input.event, opts) => {
+            resolved = true;
+            return apply_handle(contexts.length, event, opts);
         },
         get event() {
             return input.event;
         }
     });
-    for (const context of contexts) {
+    const merge_options = (parent_options, options) => {
+        const transformPageChunk = async ({ html, done }) => {
+            if (options?.transformPageChunk) {
+                html = (await options.transformPageChunk({ html, done })) ?? '';
+            }
+            if (parent_options?.transformPageChunk) {
+                html = (await parent_options.transformPageChunk({ html, done })) ?? '';
+            }
+            return html;
+        };
+        return {
+            transformPageChunk,
+            filterSerializedResponseHeaders: parent_options?.filterSerializedResponseHeaders ??
+                options?.filterSerializedResponseHeaders,
+            preload: parent_options?.preload ?? options?.preload
+        };
+    };
+    const apply_handle = async (i, event, parent_options) => {
+        if (i < contexts.length) {
+            const context = contexts[i];
+            const previous_resolve = contextInput.resolve;
+            contextInput.resolve = (next_event = event, options) => {
+                resolved = true;
+                return apply_handle(i + 1, next_event, merge_options(parent_options, options));
+            };
+            try {
+                resolved = false;
+                const result = await context(contextInput);
+                if (result instanceof Response)
+                    return result;
+                if (resolved) {
+                    throw new Error('enhance.handle context called resolve but did not return its response');
+                }
+                combined = Object.assign(combined, result);
+                return apply_handle(i + 1, event, parent_options);
+            }
+            catch (e) {
+                return EnhanceErrorHandle(e, contextInput);
+            }
+            finally {
+                contextInput.resolve = previous_resolve;
+            }
+        }
         try {
-            const result = await context(contextInput);
-            combined = Object.assign(combined, result);
+            return await handle({
+                ...input,
+                context: combined,
+                event,
+                resolve: (next_event, options) => input.resolve(next_event, merge_options(parent_options, options))
+            });
         }
         catch (e) {
             return EnhanceErrorHandle(e, contextInput);
         }
-    }
+    };
     try {
-        const response = await handle(Object.assign(input, { context: combined }));
+        const response = await apply_handle(0, input.event);
         if (contextInput.responseHandlers.length > 0) {
             for (const responseHandler of contextInput.responseHandlers) {
                 await responseHandler({ event: contextInput, response });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sourceregistry/sveltekit-enhance",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Composable enhance and form utilities for SvelteKit actions, loads, methods, and hooks.",
   "author": "A.P.A. Slaa (a.p.a.slaa@projectsource.nl)",
   "scripts": {