@positronic/spec 0.0.77 → 0.0.78

package/dist/src/api/webhooks.js

@@ -429,16 +429,174 @@ export var webhooks = {
             });
         })();
     },
-    uiForm: /**
-   * Test POST /webhooks/system/ui-form - Built-in webhook for UI form submissions.
-   * This is used by pages generated via .ui() steps to submit form data.
+    trigger: /**
+   * Test POST /webhooks/:slug - Webhook triggers a new brain run.
+   * The webhook handler returns { type: 'trigger', response } and the webhook
+   * has a triggers config specifying which brain to start.
+   * Expects 201 with { received: true, action: 'triggered', brainRunId }.
+   */ function trigger(fetch, slug, payload) {
+        return _async_to_generator(function() {
+            var request, response, data, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/webhooks/".concat(encodeURIComponent(slug)), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify(payload)
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 201) {
+                            console.error("POST /webhooks/".concat(slug, " (trigger) returned ").concat(response.status, ", expected 201"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (typeof data.received !== 'boolean' || !data.received) {
+                            console.error("Expected received to be true, got ".concat(data.received));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (data.action !== 'triggered') {
+                            console.error("Expected action to be 'triggered', got '".concat(data.action, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (!data.brainRunId || typeof data.brainRunId !== 'string') {
+                            console.error("Expected brainRunId to be a string, got ".concat(_type_of(data.brainRunId)));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /webhooks/".concat(slug, " (trigger):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    ignore: /**
+   * Test POST /webhooks/:slug - Webhook handler returns ignore.
+   * The webhook handler returns { type: 'ignore' } to acknowledge
+   * receipt but take no action.
+   * Expects 200 with { received: true, action: 'ignored' }.
+   */ function ignore(fetch, slug, payload) {
+        return _async_to_generator(function() {
+            var request, response, data, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        request = new Request("http://example.com/webhooks/".concat(encodeURIComponent(slug)), {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json'
+                            },
+                            body: JSON.stringify(payload)
+                        });
+                        return [
+                            4,
+                            fetch(request)
+                        ];
+                    case 1:
+                        response = _state.sent();
+                        if (response.status !== 200) {
+                            console.error("POST /webhooks/".concat(slug, " (ignore) returned ").concat(response.status, ", expected 200"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            4,
+                            response.json()
+                        ];
+                    case 2:
+                        data = _state.sent();
+                        if (typeof data.received !== 'boolean' || !data.received) {
+                            console.error("Expected received to be true, got ".concat(data.received));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        if (data.action !== 'ignored') {
+                            console.error("Expected action to be 'ignored', got '".concat(data.action, "'"));
+                            return [
+                                2,
+                                false
+                            ];
+                        }
+                        return [
+                            2,
+                            true
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("Failed to test POST /webhooks/".concat(slug, " (ignore):"), error);
+                        return [
+                            2,
+                            false
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    },
+    pageForm: /**
+   * Test POST /webhooks/system/page-form - Built-in webhook for page form submissions.
+   * This is used by pages generated via .page() steps to submit form data.
    *
    * The endpoint:
    * - Accepts form data (application/x-www-form-urlencoded or multipart/form-data)
-   * - Requires an `identifier` query parameter to match the waiting brain
-   * - Requires a `__positronic_token` field for CSRF validation
+   * - Requires `identifier` and `token` query parameters
    * - Returns { received: true, action: 'resumed' | 'not_found', ... }
-   */ function uiForm(fetch, identifier, formData, token) {
+   */ function pageForm(fetch, identifier, formData, token) {
         return _async_to_generator(function() {
             var params, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, key, value, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, v, request, response, data, error;
             return _ts_generator(this, function(_state) {
@@ -452,7 +610,6 @@ export var webhooks = {
                         ]);
                         // Build URLSearchParams from form data
                         params = new URLSearchParams();
-                        params.append('__positronic_token', token);
                         _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
                         try {
                             for(_iterator = Object.entries(formData)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
@@ -496,7 +653,7 @@ export var webhooks = {
                                 }
                             }
                         }
-                        request = new Request("http://example.com/webhooks/system/ui-form?identifier=".concat(encodeURIComponent(identifier)), {
+                        request = new Request("http://example.com/webhooks/system/page-form?identifier=".concat(encodeURIComponent(identifier), "&token=").concat(encodeURIComponent(token)), {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -511,7 +668,7 @@ export var webhooks = {
                         response = _state.sent();
                         // Accept 200 (found and processed) or 404 (no brain waiting)
                         if (response.status !== 200 && response.status !== 404) {
-                            console.error("POST /webhooks/system/ui-form returned ".concat(response.status, ", expected 200 or 404"));
+                            console.error("POST /webhooks/system/page-form returned ".concat(response.status, ", expected 200 or 404"));
                             return [
                                 2,
                                 false
@@ -552,7 +709,7 @@ export var webhooks = {
                         ];
                     case 3:
                         error = _state.sent();
-                        console.error('Failed to test POST /webhooks/system/ui-form:', error);
+                        console.error('Failed to test POST /webhooks/system/page-form:', error);
                         return [
                             2,
                             false
@@ -565,9 +722,9 @@ export var webhooks = {
             });
         })();
     },
-    uiFormMissingIdentifier: /**
-   * Test POST /webhooks/system/ui-form with missing identifier - Should return 400
-   */ function uiFormMissingIdentifier(fetch) {
+    pageFormMissingIdentifier: /**
+   * Test POST /webhooks/system/page-form with missing identifier - Should return 400
+   */ function pageFormMissingIdentifier(fetch) {
         return _async_to_generator(function() {
             var request, response, data, error;
             return _ts_generator(this, function(_state) {
@@ -579,7 +736,7 @@ export var webhooks = {
                             ,
                             4
                         ]);
-                        request = new Request('http://example.com/webhooks/system/ui-form', {
+                        request = new Request('http://example.com/webhooks/system/page-form', {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -593,7 +750,7 @@ export var webhooks = {
                     case 1:
                         response = _state.sent();
                         if (response.status !== 400) {
-                            console.error("POST /webhooks/system/ui-form without identifier returned ".concat(response.status, ", expected 400"));
+                            console.error("POST /webhooks/system/page-form without identifier returned ".concat(response.status, ", expected 400"));
                             return [
                                 2,
                                 false
@@ -625,7 +782,7 @@ export var webhooks = {
                         ];
                     case 3:
                         error = _state.sent();
-                        console.error('Failed to test POST /webhooks/system/ui-form without identifier:', error);
+                        console.error('Failed to test POST /webhooks/system/page-form without identifier:', error);
                         return [
                             2,
                             false
@@ -638,10 +795,10 @@ export var webhooks = {
             });
         })();
     },
-    uiFormMissingToken: /**
-   * Test POST /webhooks/system/ui-form without a CSRF token - Should return 403.
-   * The endpoint checks for missing token before looking up a waiting brain.
-   */ function uiFormMissingToken(fetch, identifier) {
+    pageFormMissingToken: /**
+   * Test POST /webhooks/system/page-form without a CSRF token - Should return 403.
+   * The endpoint checks for missing token query param before looking up a waiting brain.
+   */ function pageFormMissingToken(fetch, identifier) {
         return _async_to_generator(function() {
             var params, request, response, data, error;
             return _ts_generator(this, function(_state) {
@@ -653,10 +810,10 @@ export var webhooks = {
                             ,
                             4
                         ]);
-                        // Send form data without __positronic_token
+                        // Send form data without token query param
                         params = new URLSearchParams();
                         params.append('name', 'Test User');
-                        request = new Request("http://example.com/webhooks/system/ui-form?identifier=".concat(encodeURIComponent(identifier)), {
+                        request = new Request("http://example.com/webhooks/system/page-form?identifier=".concat(encodeURIComponent(identifier)), {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -670,7 +827,7 @@ export var webhooks = {
                     case 1:
                         response = _state.sent();
                         if (response.status !== 403) {
-                            console.error("POST /webhooks/system/ui-form without token returned ".concat(response.status, ", expected 403"));
+                            console.error("POST /webhooks/system/page-form without token returned ".concat(response.status, ", expected 403"));
                             return [
                                 2,
                                 false
@@ -702,7 +859,7 @@ export var webhooks = {
                         ];
                     case 3:
                         error = _state.sent();
-                        console.error('Failed to test POST /webhooks/system/ui-form without token:', error);
+                        console.error('Failed to test POST /webhooks/system/page-form without token:', error);
                         return [
                             2,
                             false
@@ -715,12 +872,12 @@ export var webhooks = {
             });
         })();
     },
-    uiFormWrongToken: /**
-   * Test POST /webhooks/system/ui-form with a wrong CSRF token.
+    pageFormWrongToken: /**
+   * Test POST /webhooks/system/page-form with a wrong CSRF token.
    * Without a brain waiting, the endpoint returns 404 (not_found) since
    * token comparison only runs after a brain is found. The key assertion
    * is that a wrong token never produces a successful 200 "resumed" response.
-   */ function uiFormWrongToken(fetch, identifier, formData, wrongToken) {
+   */ function pageFormWrongToken(fetch, identifier, formData, wrongToken) {
         return _async_to_generator(function() {
             var params, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, key, value, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, v, request, response, data, error;
             return _ts_generator(this, function(_state) {
@@ -733,7 +890,6 @@ export var webhooks = {
                             5
                         ]);
                         params = new URLSearchParams();
-                        params.append('__positronic_token', wrongToken);
                         _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
                         try {
                             for(_iterator = Object.entries(formData)[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
@@ -777,7 +933,7 @@ export var webhooks = {
                                 }
                             }
                         }
-                        request = new Request("http://example.com/webhooks/system/ui-form?identifier=".concat(encodeURIComponent(identifier)), {
+                        request = new Request("http://example.com/webhooks/system/page-form?identifier=".concat(encodeURIComponent(identifier), "&token=").concat(encodeURIComponent(wrongToken)), {
                             method: 'POST',
                             headers: {
                                 'Content-Type': 'application/x-www-form-urlencoded'
@@ -801,7 +957,7 @@ export var webhooks = {
                     case 2:
                         data = _state.sent();
                         if (data.action === 'resumed') {
-                            console.error('POST /webhooks/system/ui-form with wrong token returned 200 with action "resumed" — token validation failed');
+                            console.error('POST /webhooks/system/page-form with wrong token returned 200 with action "resumed" — token validation failed');
                             return [
                                 2,
                                 false
@@ -811,7 +967,7 @@ export var webhooks = {
                     case 3:
                         // Accept 403 (token mismatch) or 404 (no brain waiting — token check happens after brain lookup)
                         if (response.status !== 403 && response.status !== 404) {
-                            console.error("POST /webhooks/system/ui-form with wrong token returned ".concat(response.status, ", expected 403 or 404"));
+                            console.error("POST /webhooks/system/page-form with wrong token returned ".concat(response.status, ", expected 403 or 404"));
                             return [
                                 2,
                                 false
@@ -823,7 +979,7 @@ export var webhooks = {
                         ];
                     case 4:
                         error = _state.sent();
-                        console.error('Failed to test POST /webhooks/system/ui-form with wrong token:', error);
+                        console.error('Failed to test POST /webhooks/system/page-form with wrong token:', error);
                         return [
                             2,
                             false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@positronic/spec",
-  "version": "0.0.77",
+  "version": "0.0.78",
   "publishConfig": {
     "access": "public"
   },