@atscript/moost-wf 0.1.59 → 0.1.61

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { WfOutlet, WfOutletTriggerConfig, WfOutletTriggerDeps } from "@moostjs/event-wf";
 import { TInterceptorDef } from "moost";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
@@ -149,4 +150,28 @@ declare function useWfAction(): {
   setAction: (action: string | undefined) => void;
 };
 //#endregion
-export { AltAction, FormInput, FormInputRequired, type TFormInput, extractPassContext, formInputInterceptor, getFormActions, serializeFormSchema, useFormInput, useWfAction };
+//#region src/outlet.d.ts
+/**
+ * `createHttpOutlet` pre-configured for `<AsWfForm>` consumers.
+ *
+ * Wraps generic form payloads in `{ inputRequired: { payload, transport: 'http', context } }`
+ * so step handlers can `return outletHttp(serializeFormSchema(Form), extractPassContext(Form, ctx))`
+ * without shaping the response by hand.
+ *
+ * Signal pass-through: payloads already carrying a root-level routing key
+ * (`finished`/`sent`/`outlet`/`error`) — e.g. `outletHttp({ outlet: 'awaiting-payment' })`
+ * for a webhook pause — flow through at the response root (merged with `context`
+ * if provided), so the client routes on the signal as expected.
+ */
+declare function createAsHttpOutlet(): WfOutlet;
+//#endregion
+//#region src/handle.d.ts
+/**
+ * Drop-in wrapper around `handleWfOutletRequest` that compensates for
+ * `@wooksjs/event-wf`'s unwrap of `useWfFinished().set({ value })` (wooks index.mjs:198).
+ * Steps return their domain data via `value` and the wrapper supplies the `finished: true`
+ * marker so `<AsWfForm>` fires `@finished` instead of falling into "Unexpected response format".
+ */
+declare function handleAsOutletRequest(config: WfOutletTriggerConfig, deps: WfOutletTriggerDeps): Promise<unknown>;
+//#endregion
+export { AltAction, FormInput, FormInputRequired, type TFormInput, createAsHttpOutlet, extractPassContext, formInputInterceptor, getFormActions, handleAsOutletRequest, serializeFormSchema, useFormInput, useWfAction };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { useWfState } from "@moostjs/event-wf";
+import { createHttpOutlet, handleWfOutletRequest, useWfState } from "@moostjs/event-wf";
 import { Intercept, Resolve, TInterceptorPriority, useControllerContext } from "moost";
 import { isAnnotatedType, serializeAnnotatedType } from "@atscript/typescript/utils";
 import { current, key } from "@wooksjs/event-core";
@@ -331,4 +331,80 @@ function formInputInterceptor() {
 	};
 }
 //#endregion
-export { AltAction, FormInput, FormInputRequired, extractPassContext, formInputInterceptor, getFormActions, serializeFormSchema, useFormInput, useWfAction };
+//#region src/outlet.ts
+/**
+* Top-level keys `<AsWfForm>` routes on (`packages/vue-wf/src/use-wf-form.ts:128-167`):
+* `finished` → @finished, `sent`/`outlet` → outlet pause, `error` → error branch.
+* Payloads that already carry one of these must reach the response root intact —
+* wrapping in `inputRequired` would mis-route to the form branch.
+*/
+const SIGNAL_KEYS = [
+	"finished",
+	"sent",
+	"outlet",
+	"error"
+];
+/**
+* `createHttpOutlet` pre-configured for `<AsWfForm>` consumers.
+*
+* Wraps generic form payloads in `{ inputRequired: { payload, transport: 'http', context } }`
+* so step handlers can `return outletHttp(serializeFormSchema(Form), extractPassContext(Form, ctx))`
+* without shaping the response by hand.
+*
+* Signal pass-through: payloads already carrying a root-level routing key
+* (`finished`/`sent`/`outlet`/`error`) — e.g. `outletHttp({ outlet: 'awaiting-payment' })`
+* for a webhook pause — flow through at the response root (merged with `context`
+* if provided), so the client routes on the signal as expected.
+*/
+function createAsHttpOutlet() {
+	return createHttpOutlet({ transform: (payload, context) => {
+		if (payload !== null && typeof payload === "object") {
+			for (const key of SIGNAL_KEYS) if (key in payload) return context && typeof context === "object" ? {
+				...payload,
+				...context
+			} : payload;
+		}
+		return { inputRequired: {
+			payload,
+			transport: "http",
+			context: context ?? {}
+		} };
+	} });
+}
+//#endregion
+//#region src/handle.ts
+/**
+* Top-level keys `<AsWfForm>` routes on (`packages/vue-wf/src/use-wf-form.ts:128-167`)
+* plus `inputRequired` (form-pause envelope). Anything carrying one of these reaches
+* the client root intact; only "bare" finished payloads need a `finished: true` marker.
+*/
+const MARKER_KEYS = [
+	"inputRequired",
+	"finished",
+	"error",
+	"sent",
+	"outlet"
+];
+/**
+* Wrap an unmarked plain-object result in `{ finished: true, ...result }` — the marker
+* `<AsWfForm>` reads to fire `@finished`. Pass-through for `null`/`undefined`, arrays,
+* primitives (incl. redirect's empty-string body), and already-marked envelopes.
+*/
+function wrapFinished(result) {
+	if (result !== null && typeof result === "object" && !Array.isArray(result) && !MARKER_KEYS.some((k) => k in result)) return {
+		finished: true,
+		...result
+	};
+	return result;
+}
+/**
+* Drop-in wrapper around `handleWfOutletRequest` that compensates for
+* `@wooksjs/event-wf`'s unwrap of `useWfFinished().set({ value })` (wooks index.mjs:198).
+* Steps return their domain data via `value` and the wrapper supplies the `finished: true`
+* marker so `<AsWfForm>` fires `@finished` instead of falling into "Unexpected response format".
+*/
+async function handleAsOutletRequest(config, deps) {
+	return wrapFinished(await handleWfOutletRequest(config, deps));
+}
+//#endregion
+export { AltAction, FormInput, FormInputRequired, createAsHttpOutlet, extractPassContext, formInputInterceptor, getFormActions, handleAsOutletRequest, serializeFormSchema, useFormInput, useWfAction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/moost-wf",
-  "version": "0.1.59",
+  "version": "0.1.61",
   "description": "Workflow form integration for moost — decorators, interceptors, and serialization driven by atscript type metadata",
   "keywords": [
     "atscript",
@@ -61,7 +61,7 @@
     "moost": "^0.6.9",
     "unplugin-atscript": "^0.1.54",
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
-    "@atscript/ui": "^0.1.59"
+    "@atscript/ui": "^0.1.61"
   },
   "peerDependencies": {
     "@atscript/core": "^0.1.54",