synthos 0.10.1 → 0.11.0

package/static-files/helpers.v3.js

@@ -2,6 +2,8 @@
     if (window.__synthOSHelpers) return;
     window.__synthOSHelpers = true;
 
+    var NOT_FOUND_ERRORS = ['table_not_found', 'schema_not_found'];
+
     function _json(method, url, body) {
         var opts = {
             method: method,
@@ -11,15 +13,19 @@
             opts.body = JSON.stringify(body);
         }
         return fetch(url, opts).then(function(res) {
+            if (res.status === 204) {
+                return null;
+            }
             var ct = res.headers.get('content-type') || '';
             var isJson = ct.indexOf('application/json') !== -1;
             return (isJson ? res.json() : res.text()).then(function(data) {
                 if (!res.ok) {
-                    if (res.status === 404 && isJson && data && data.error === 'table_not_found') {
-                        return null; // for data.get, return null if the table or row is not found instead of throwing an error
+                    if (res.status === 404 && isJson && data && NOT_FOUND_ERRORS.indexOf(data.error) !== -1) {
+                        return null; // map "not found" responses to null instead of throwing
                     }
                     var err = new Error(isJson && data && data.error ? data.error : data);
                     err.status = res.status;
+                    if (isJson && data && data.conflicts) err.conflicts = data.conflicts;
                     throw err;
                 }
                 return data;
@@ -31,10 +37,14 @@
         return (window.pageInfo && window.pageInfo.name) || 'default';
     }
 
+    function _pageData() {
+        return '/api/data/' + encodeURIComponent(_pageName());
+    }
+
     window.synthos = {
         data: {
             list: function(table, opts) {
-                var url = '/api/data/' + encodeURIComponent(_pageName()) + '/' + encodeURIComponent(table);
+                var url = _pageData() + '/' + encodeURIComponent(table);
                 if (opts && typeof opts.limit === 'number') {
                     url += '?limit=' + opts.limit;
                     if (typeof opts.offset === 'number') {
@@ -44,13 +54,30 @@
                 return _json('GET', url) || [];
             },
             get: function(table, id) {
-                return _json('GET', '/api/data/' + encodeURIComponent(_pageName()) + '/' + encodeURIComponent(table) + '/' + encodeURIComponent(id)) || null;
+                return _json('GET', _pageData() + '/' + encodeURIComponent(table) + '/' + encodeURIComponent(id)) || null;
             },
             save: function(table, row) {
-                return _json('POST', '/api/data/' + encodeURIComponent(_pageName()) + '/' + encodeURIComponent(table), row);
+                return _json('POST', _pageData() + '/' + encodeURIComponent(table), row);
             },
             remove: function(table, id) {
-                return _json('DELETE', '/api/data/' + encodeURIComponent(_pageName()) + '/' + encodeURIComponent(table) + '/' + encodeURIComponent(id));
+                return _json('DELETE', _pageData() + '/' + encodeURIComponent(table) + '/' + encodeURIComponent(id));
+            },
+            schema: function(table) {
+                return _json('GET', _pageData() + '/' + encodeURIComponent(table) + '/_schema').then(function(w) {
+                    return w && w.schema ? w.schema : null;
+                });
+            },
+            defineSchema: function(table, schema, options) {
+                var merge = (options && options.merge === 'replace') ? 'replace' : 'additive';
+                var url = _pageData() + '/' + encodeURIComponent(table) + '/_schema?merge=' + merge;
+                var body = { schema: schema };
+                if (options && typeof options.definedBy === 'string') body.definedBy = options.definedBy;
+                return _json('PUT', url, body);
+            },
+            tables: function() {
+                return _json('GET', _pageData() + '/_tables').then(function(res) {
+                    return (res && res.tables) || [];
+                });
             }
         },
 
@@ -102,6 +129,23 @@
                 },
                 remove: function(table, id) {
                     return _json('DELETE', '/api/shared/data/' + encodeURIComponent(table) + '/' + encodeURIComponent(id));
+                },
+                schema: function(table) {
+                    return _json('GET', '/api/shared/data/' + encodeURIComponent(table) + '/_schema').then(function(w) {
+                        return w && w.schema ? w.schema : null;
+                    });
+                },
+                defineSchema: function(table, schema, options) {
+                    var merge = (options && options.merge === 'replace') ? 'replace' : 'additive';
+                    var url = '/api/shared/data/' + encodeURIComponent(table) + '/_schema?merge=' + merge;
+                    var body = { schema: schema };
+                    if (options && typeof options.definedBy === 'string') body.definedBy = options.definedBy;
+                    return _json('PUT', url, body);
+                },
+                tables: function() {
+                    return _json('GET', '/api/shared/data/_tables').then(function(res) {
+                        return (res && res.tables) || [];
+                    });
                 }
             },
             files: {

package/static-files/page-bridge.js

@@ -0,0 +1,114 @@
+/**
+ * page-bridge.js — iframe-side postMessage bridge
+ *
+ * Runs inside the iframe (page content document). Responsibilities:
+ * 1. Error capture — forwards JS errors to the parent shell via shell:error
+ * 2. Listen for page:load messages — replace page content via document.write()
+ * 3. Listen for page:theme messages — swap theme stylesheet
+ * 4. Notify parent that bridge is ready via shell:ready
+ * 5. Forward navigation requests to parent via shell:navigate
+ */
+(function() {
+    var ORIGIN = window.location.origin;
+
+    // --- Error Capture -------------------------------------------------------
+    var capturedErrors = [];
+
+    window.onerror = function(msg, src, line, col, err) {
+        var entry = msg + ' at ' + (src || '?') + ':' + (line || '?') + ':' + (col || '?');
+        if (err && err.stack) entry += '\n' + err.stack;
+        capturedErrors.push(entry);
+        sendToShell('shell:error', { errors: capturedErrors.slice() });
+        capturedErrors = [];
+        return false;
+    };
+
+    window.addEventListener('unhandledrejection', function(ev) {
+        var r = ev.reason;
+        capturedErrors.push('Unhandled rejection: ' + (r && r.stack ? r.stack : String(r)));
+        sendToShell('shell:error', { errors: capturedErrors.slice() });
+        capturedErrors = [];
+    });
+
+    // --- Bridge Messaging ----------------------------------------------------
+
+    function sendToShell(type, payload) {
+        window.parent.postMessage(
+            { source: 'synthos-page', type: type, payload: payload || {} },
+            ORIGIN
+        );
+    }
+
+    window.addEventListener('message', function(event) {
+        if (event.origin !== ORIGIN) return;
+        var msg = event.data;
+        if (!msg || msg.source !== 'synthos-shell') return;
+
+        switch (msg.type) {
+            case 'page:load':
+                // Replace entire page content — the new HTML includes page-bridge.js
+                // so the bridge re-initializes after write.
+                document.open();
+                document.write(msg.payload.html);
+                document.close();
+                break;
+
+            case 'page:theme':
+                applyTheme(msg.payload);
+                break;
+        }
+    });
+
+    function applyTheme(payload) {
+        var themeLink = document.getElementById('theme-css');
+        if (themeLink && payload.theme) {
+            themeLink.href = '/api/theme.css?theme=' + encodeURIComponent(payload.theme);
+        }
+        if (payload.mode) {
+            document.documentElement.classList.remove('light-mode', 'dark-mode');
+            document.documentElement.classList.add(payload.mode + '-mode');
+        }
+    }
+
+    // --- Navigation Intercept ------------------------------------------------
+    // Page scripts that call window.__synthOSNavigateTo or click internal links
+    // should route through the parent shell for dirty-check handling.
+
+    window.__synthOSNavigateTo = function(url) {
+        sendToShell('shell:navigate', { url: url });
+    };
+
+    // Intercept <a> clicks on same-origin links so they navigate the parent
+    // shell instead of the iframe (prevents page-within-a-page nesting).
+    document.addEventListener('click', function(e) {
+        var anchor = e.target.closest ? e.target.closest('a[href]') : null;
+        if (!anchor) return;
+        var href = anchor.getAttribute('href');
+        if (!href) return;
+        // Only intercept internal navigation (absolute same-origin or root-relative)
+        var isRootRelative = href.charAt(0) === '/' && href.charAt(1) !== '/';
+        var isSameOrigin = href.indexOf(ORIGIN) === 0;
+        if (!isRootRelative && !isSameOrigin) return;
+        // Skip anchors that explicitly opt out
+        if (anchor.hasAttribute('data-no-intercept')) return;
+        // Skip download links
+        if (anchor.hasAttribute('download')) return;
+        e.preventDefault();
+        var url = isRootRelative ? href : href.replace(ORIGIN, '');
+        sendToShell('shell:navigate', { url: url });
+    }, true);
+
+    // --- Dirty State ---------------------------------------------------------
+
+    window.__synthOSPageDirty = false;
+    Object.defineProperty(window, '__synthOSPageDirty', {
+        get: function() { return false; },
+        set: function(val) {
+            sendToShell('shell:dirty', { dirty: !!val });
+        },
+        configurable: true
+    });
+
+    // --- Notify Parent: Bridge Ready -----------------------------------------
+    sendToShell('shell:ready', {});
+})();