@ibgib/space-gib 0.0.9 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/space-gib",
-  "version": "0.0.9",
+  "version": "0.0.13",
   "type": "module",
   "description": "ibgib storage and provider service — SaaS at ibgib.space",
   "scripts": {
@@ -12,11 +12,11 @@
     "build:test": "tsc -p tsconfig.test.json"
   },
   "dependencies": {
-    "@ibgib/core-gib": "^0.1.66",
+    "@ibgib/core-gib": "^0.1.70",
     "@ibgib/helper-gib": "^0.0.36",
     "@ibgib/ts-gib": "^0.5.33",
-    "@ibgib/web-gib": "^0.0.52",
-    "@ibgib/node-gib": "^0.0.10"
+    "@ibgib/web-gib": "^0.0.56",
+    "@ibgib/node-gib": "^0.0.14"
   },
   "engines": {
     "node": ">=20.0.0"

package/space-gib.localhost-1785337158142.log

@@ -0,0 +1,75 @@
+chunk-ZINPBU3N.mjs:26110 yes this is being updated! I am just wondering if I am seeing old code in the browser, i.e., if refresh is happening or just getting cache (I: 6599db11c1086062b8f5e86db89cba26)
+chunk-ZINPBU3N.mjs:22339 [KeystoneScrubberComponentInstance][loadIbGib] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+loadIbGib @ chunk-ZINPBU3N.mjs:22339
+await in loadIbGib
+loadIbGib @ chunk-ZINPBU3N.mjs:26180
+initialize @ chunk-ZINPBU3N.mjs:26124
+await in initialize
+createInstance @ chunk-ZINPBU3N.mjs:26092
+getComponentInstance @ chunk-ZINPBU3N.mjs:155
+fnCreateAndLoadChildComponent @ chunk-ZINPBU3N.mjs:23947
+await in fnCreateAndLoadChildComponent
+getLoadedChildInfo @ chunk-ZINPBU3N.mjs:23972
+activateIbGib @ chunk-ZINPBU3N.mjs:22821
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:26183 [KeystoneScrubberComponentInstance][loadIbGib] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+loadIbGib @ chunk-ZINPBU3N.mjs:26183
+await in loadIbGib
+initialize @ chunk-ZINPBU3N.mjs:26124
+await in initialize
+createInstance @ chunk-ZINPBU3N.mjs:26092
+getComponentInstance @ chunk-ZINPBU3N.mjs:155
+fnCreateAndLoadChildComponent @ chunk-ZINPBU3N.mjs:23947
+await in fnCreateAndLoadChildComponent
+getLoadedChildInfo @ chunk-ZINPBU3N.mjs:23972
+activateIbGib @ chunk-ZINPBU3N.mjs:22821
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:26126 [KeystoneScrubberComponentInstance][initialize] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+initialize @ chunk-ZINPBU3N.mjs:26126
+await in initialize
+createInstance @ chunk-ZINPBU3N.mjs:26092
+getComponentInstance @ chunk-ZINPBU3N.mjs:155
+fnCreateAndLoadChildComponent @ chunk-ZINPBU3N.mjs:23947
+await in fnCreateAndLoadChildComponent
+getLoadedChildInfo @ chunk-ZINPBU3N.mjs:23972
+activateIbGib @ chunk-ZINPBU3N.mjs:22821
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:164 [IbGibComponentService][getComponentInstance] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+getComponentInstance @ chunk-ZINPBU3N.mjs:164
+await in getComponentInstance
+fnCreateAndLoadChildComponent @ chunk-ZINPBU3N.mjs:23947
+await in fnCreateAndLoadChildComponent
+getLoadedChildInfo @ chunk-ZINPBU3N.mjs:23972
+activateIbGib @ chunk-ZINPBU3N.mjs:22821
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:23995 [IdentityManagerComponentInstance][getLoadedChildInfo] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+getLoadedChildInfo @ chunk-ZINPBU3N.mjs:23995
+await in getLoadedChildInfo
+activateIbGib @ chunk-ZINPBU3N.mjs:22821
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:22849 [IdentityManagerComponentInstance][activateIbGib] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+activateIbGib @ chunk-ZINPBU3N.mjs:22849
+await in activateIbGib
+activateIbGib @ chunk-ZINPBU3N.mjs:23878
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656
+chunk-ZINPBU3N.mjs:23932 [IdentityManagerComponentInstance][activateIbGib] couldn't get ibGib (keystone^28F26FB0EEA43E56968AA6BE6D0EC673AF13B3E3BCE26A32D7719402E0ADC71E) in space (witness space WebFilesystemSpace_V1 space_gib__yidcqwooervd 0e103ade06650512f06870e05f42b432a5045939c605dd46a5e75dcb51c10f3b undefined undefined) (E: 59c3461bebf3e0065df72bd1bd8dc125)
+activateIbGib @ chunk-ZINPBU3N.mjs:23932
+await in activateIbGib
+(anonymous) @ chunk-ZINPBU3N.mjs:23650
+(anonymous) @ chunk-ZINPBU3N.mjs:25656

package/src/client/AUTO-GENERATED-version.mts

@@ -8,4 +8,4 @@
 /**
  * Version of space-gib, auto-updated by the build process.
  */
-export const AUTO_GENERATED_VERSION = '0.0.9';
+export const AUTO_GENERATED_VERSION = '0.0.13';

package/src/client/README.md

@@ -13,7 +13,7 @@ This directory contains the browser single-page application (SPA) frontend for `
 * `index.html` & `style.css`: The static entry points.
 * `index.mts`: The JS entry point that initializes the global context and bootstraps the SPA.
 * `components/`: Contains dynamic UI components (`keystone-creator`, etc.).
-* `api/`: REST and WebSocket API communication layers.
+* `api/`: REST and WebSocket API communication layers (including email send/inbound handlers).
 * `dev-tools.mts`: Utilities for rendering the local development test panel.
 
 For local development commands, please refer to the [Root space-gib README](../../README.md).

package/src/client/api/space-gib-api-bridge.mts

@@ -1,230 +1,14 @@
-import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
-import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
-
-import { GLOBAL_LOG_A_LOT } from '../constants.mjs';
-
-const logalot = GLOBAL_LOG_A_LOT;
+import { IbGibApiBridge, setApiBridge } from "@ibgib/web-gib/dist/api/ibgib-api-bridge.mjs";
 
 /**
- * Handles communication with the SpaceGib REST API.
+ * SpaceGib REST API bridge extending the upstream IbGibApiBridge.
  */
-export class SpaceGibApiBridge {
-    private lc: string = `[SpaceGibApiBridge]`;
-
-    /**
-     * Posts a single genesis keystone ibgib to the server to create a new domain.
-     *
-     * @param keystoneIbGib The genesis keystone ibgib.
-     * @returns Promise resolving to the server response containing the addr.
-     */
-    public async postGenesisKeystone(keystoneIbGib: IbGib_V1): Promise<{ success: boolean; message?: string; addr?: string }> {
-        const lc = `${this.lc}[${this.postGenesisKeystone.name}]`;
-        try {
-            if (logalot) { console.log(`${lc} starting... (I: eecd082fc4a4381c8857928e8b090826)`); }
-
-            const response = await fetch('/api/keystone/genesis', {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({ keystoneIbGib }),
-            });
-
-            const data = await response.json();
-
-            if (!response.ok) {
-                const errorMsg = data.message || data.error || 'Unknown error';
-                console.error(`${lc} [NAG][ibgib-paradigm] server rejected genesis keystone: ${errorMsg}`);
-                return { success: false, message: errorMsg, addr: data.addr };
-            }
-
-            if (logalot) { console.log(`${lc} genesis keystone posted successfully.`); }
-            return { success: true, addr: data.addr };
-
-        } catch (error) {
-            const errorMsg = extractErrorMsg(error);
-            console.error(`${lc} error: ${errorMsg}`);
-            return { success: false, message: errorMsg };
-        } finally {
-            if (logalot) { console.log(`${lc} complete.`); }
-        }
-    }
-
-    /**
-     * PUTs an evolved domain keystone and any related keystones (e.g., session
-     * keystones or delegate keystones) to the server.
-     */
-    public async putEvolveKeystone({
-        domainAddr,
-        keystoneIbGib,
-        relatedKeystoneIbGibs = [],
-        revokeTokens
-    }: {
-        /**
-         * Address of the root parent domain identity keystone.
-         */
-        domainAddr: string;
-        /**
-         * The main evolved keystone frame being synchronized.
-         */
-        keystoneIbGib: IbGib_V1;
-        /**
-         * Array of other keystone frames related to this evolution.
-         * Distinction in intent:
-         * 1. Ephemeral Session Keystones: Temporary keystones generated to
-         *    authorize a single sync session (under 'sync' claims, targeted via
-         *    claim.target = sAddr).
-         * 2. Persistent Delegate Keystones: Long-lived sub-keystones registered
-         *    in the parent's `delegates` dictionary that are evolved
-         *    concurrently (e.g., during 'manage' password changes).
-         */
-        relatedKeystoneIbGibs?: IbGib_V1[];
-        /**
-         * Optional map of providerId to token to revoke during unlinking.
-         */
-        revokeTokens?: Record<string, string>;
-    }): Promise<{ success: boolean; message?: string }> {
-        const lc = `${this.lc}[${this.putEvolveKeystone.name}]`;
-        try {
-            console.log(`${lc} posting evolved keystone...`);
-
-            // Note: encodeURIComponent safely encodes the `^` if needed, though our regex handles both
-            const url = `/api/keystone/evolve/${encodeURIComponent(domainAddr)}`;
-            const response = await fetch(url, {
-                method: 'PUT',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify({
-                    keystoneIbGib,
-                    relatedKeystoneIbGibs,
-                    revokeTokens
-                }),
-            });
-
-            const data = await response.json();
-
-            if (!response.ok) {
-                const errorMsg = data.message || data.error || 'Unknown error';
-                console.error(`${lc} server rejected keystone evolution: ${errorMsg}`);
-                return { success: false, message: errorMsg };
-            }
-
-            console.log(`${lc} keystone evolution accepted by server.`);
-            return { success: true };
-
-        } catch (error) {
-            const errorMsg = extractErrorMsg(error);
-            console.error(`${lc} fetch error: ${errorMsg}`);
-            return { success: false, message: errorMsg };
-        }
-    }
-
-    /**
-     * GETs the keystone graph for a domain from the server.
-     */
-    public async getKeystoneGraph(domainAddr: string): Promise<{ success: boolean; message?: string; graph?: Record<string, any> }> {
-        const lc = `${this.lc}[${this.getKeystoneGraph.name}]`;
-        try {
-            console.log(`${lc} fetching keystone graph...`);
-
-            const url = `/api/keystone/${encodeURIComponent(domainAddr)}?getLatest=true&getGraph=true`;
-            const response = await fetch(url, {
-                method: 'GET',
-                headers: {
-                    'Accept': 'application/json',
-                }
-            });
-
-            const data = await response.json();
-
-            console.log(`${lc} fetch keystone graph complete.`);
-
-            if (!response.ok) {
-                const errorMsg = data.message || data.error || 'Unknown error';
-                console.error(`${lc} server rejected keystone graph get: ${errorMsg}`);
-                return { success: false, message: errorMsg };
-            }
-
-            return { success: true, graph: data.domainGraph };
-
-        } catch (error) {
-            const errorMsg = extractErrorMsg(error);
-            console.error(`${lc} fetch error: ${errorMsg}`);
-            return { success: false, message: errorMsg };
-        }
-    }
-
-    /**
-     * GETs a single ibGib frame from the server's domain-specific space.
-     */
-    public async getIbGib(domainAddr: string, ibGibAddr: string, getLatest = false): Promise<{ success: boolean; message?: string; ibGib?: IbGib_V1 }> {
-        const lc = `${this.lc}[${this.getIbGib.name}]`;
-        try {
-            console.log(`${lc} fetching single ibGib frame...`);
-
-            const url = `/api/ibgib/${encodeURIComponent(domainAddr)}/${encodeURIComponent(ibGibAddr)}?getLatest=${getLatest}&getGraph=false`;
-            const response = await fetch(url, {
-                method: 'GET',
-                headers: {
-                    'Accept': 'application/json',
-                }
-            });
-
-            const data = await response.json();
-
-            console.log(`${lc} fetching single ibGib frame complete.`);
-
-            if (!response.ok) {
-                const errorMsg = data.message || data.error || 'Unknown error';
-                console.error(`${lc} server rejected ibGib get: ${errorMsg}`);
-                return { success: false, message: errorMsg };
-            }
-
-            return { success: true, ibGib: data };
-
-        } catch (error) {
-            const errorMsg = extractErrorMsg(error);
-            console.error(`${lc} fetch error: ${errorMsg}`);
-            return { success: false, message: errorMsg };
-        }
-    }
-
-    /**
-     * GETs the full dependency graph of an ibGib from the server's domain-specific space.
-     */
-    public async getIbGibGraph(domainAddr: string, ibGibAddr: string, getLatest = false): Promise<{ success: boolean; message?: string; graph?: Record<string, IbGib_V1>; addr?: string }> {
-        const lc = `${this.lc}[${this.getIbGibGraph.name}]`;
-        try {
-            console.log(`${lc} fetching ibGib graph...`);
-
-            const url = `/api/ibgib/${encodeURIComponent(domainAddr)}/${encodeURIComponent(ibGibAddr)}?getLatest=${getLatest}&getGraph=true`;
-            const response = await fetch(url, {
-                method: 'GET',
-                headers: {
-                    'Accept': 'application/json',
-                }
-            });
-
-            const data = await response.json();
-
-            console.log(`${lc} fetching ibGib graph complete.`);
-
-            if (!response.ok) {
-                const errorMsg = data.message || data.error || 'Unknown error';
-                console.error(`${lc} server rejected ibGib graph get: ${errorMsg}`);
-                return { success: false, message: errorMsg };
-            }
-
-            return { success: true, graph: data.graph, addr: data.addr };
-
-        } catch (error) {
-            const errorMsg = extractErrorMsg(error);
-            console.error(`${lc} fetch error: ${errorMsg}`);
-            return { success: false, message: errorMsg };
-        }
-    }
+export class SpaceGibApiBridge extends IbGibApiBridge {
+    protected override lc: string = `[SpaceGibApiBridge]`;
 }
 
-/** Singleton instance for the bridge. */
+/** Singleton instance for space-gib API bridge. */
 export const spaceGibApiBridge = new SpaceGibApiBridge();
+
+// Register as active API bridge in web-gib
+setApiBridge(spaceGibApiBridge);

package/src/client/ui/shell/space-gib-shell-service.mts

@@ -11,14 +11,12 @@ import {
     ID_FOOTER_RESIZER, ID_BTN_LEFT_PANEL_TOGGLE, ID_BTN_RIGHT_PANEL_TOGGLE,
     ID_BTN_CREATE_KEYSTONE, ID_CENTER_PANEL_CONTENT
 } from "./space-gib-shell-constants.mjs";
-import { EVENT_IBGIB_SHELL_READY, EVENT_IBGIB_UI_BUSY } from "@ibgib/web-gib/dist/ui/ui-constants.mjs";
+import { EVENT_IBGIB_SHELL_READY, EVENT_IBGIB_UI_BUSY, EVENT_IBGIB_UI_MESSAGE } from "@ibgib/web-gib/dist/ui/ui-constants.mjs";
 import { showFullscreenDialog, FullscreenDialogController } from "@ibgib/web-gib/dist/ui/ui-helpers.mjs";
+import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
+import { getKeystoneSyncService } from "@ibgib/web-gib/dist/identity/keystone-sync-service.mjs";
 import { PanelState } from "./space-gib-shell-types.mjs";
-import { KeystoneCreatorComponentMeta } from "../../components/keystone-creator/keystone-creator.mjs";
-import { IdentityManagerComponentMeta } from "../../components/identity-manager/identity-manager.mjs";
-import { IdentityHeaderComponentMeta } from "../../components/identity-header/identity-header.mjs";
-import { KeystoneDetailsComponentMeta } from "../../components/keystone-details/keystone-details.mjs";
-import { KeystoneScrubberComponentMeta } from "../../components/keystone-scrubber/keystone-scrubber.mjs";
+import { registerStandardIdentityComponents } from "@ibgib/web-gib/dist/ui/component/identity/index.mjs";
 
 export class SpaceGibShellService {
     private lc: string = `[SpaceGibShellService]`;
@@ -101,6 +99,17 @@ export class SpaceGibShellService {
                 btnCreate.addEventListener('click', () => this.showIdentityManager());
             }
 
+            window.addEventListener(EVENT_IBGIB_UI_MESSAGE, (ev: any) => {
+                const action = ev.detail?.action;
+                if (action === 'show-identity-manager') {
+                    this.showIdentityManager();
+                } else if (action === 'show-keystone-creator') {
+                    this.showKeystoneCreator();
+                } else if (action === 'show-add-device') {
+                    this.showAddDevice();
+                }
+            });
+
             // Listen for global busy events from components
             let currentBusyOverlay: FullscreenDialogController | undefined;
             let isShellBusy = false;
@@ -184,6 +193,26 @@ export class SpaceGibShellService {
         }
     }
 
+    public async showAddDevice() {
+        const lc = `${this.lc}[${this.showAddDevice.name}]`;
+        try {
+            const componentSvc = await getComponentSvc();
+            const component = await componentSvc.getComponentInstance({
+                path: 'ibgib-add-device',
+                ibGibAddr: ROOT_ADDR,
+                useRegExpPrefilter: true,
+            });
+
+            const centerPanel = document.getElementById(ID_CENTER_PANEL_CONTENT);
+            if (centerPanel && component) {
+                centerPanel.innerHTML = ''; // Clear hero section
+                centerPanel.appendChild(component as any);
+            }
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+        }
+    }
+
     private toggleLeftPanel() {
         this.leftPanelState = this.leftPanelState === 'expanded' ? 'collapsed' : 'expanded';
         const panel = document.getElementById(ID_LEFT_PANEL);
@@ -246,20 +275,9 @@ export class SpaceGibShellService {
     private async registerComponents(): Promise<void> {
         const lc = `${this.lc}[${this.registerComponents.name}]`;
         try {
-            const componentsMeta: IbGibDynamicComponentMeta[] = [
-                new KeystoneCreatorComponentMeta(),
-                new IdentityManagerComponentMeta(),
-                new IdentityHeaderComponentMeta(),
-                new KeystoneDetailsComponentMeta(),
-                new KeystoneScrubberComponentMeta(),
-            ];
-            const componentSvc = await getComponentSvc();
-            for (let componentMeta of componentsMeta) {
-                componentSvc.registerComponentMeta(componentMeta);
-            }
+            registerStandardIdentityComponents();
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
-            throw error;
         }
     }
 
@@ -290,6 +308,38 @@ export class SpaceGibShellService {
             }
 
             window.dispatchEvent(new CustomEvent(EVENT_IBGIB_SHELL_READY, { detail: { timestamp: Date.now() } }));
+
+            // Trigger 1 (App Boot): On onEngineReady, if active identity exists, check for updates.
+            const domainIdentity = (globalThis as any).ibgib?.identity?.domainIdentity;
+            if (domainIdentity) {
+                const activePrimaryAddr = getIbGibAddr({ ibGib: domainIdentity });
+                const syncSvc = getKeystoneSyncService();
+                const updateCheck = await syncSvc.checkForKeystoneUpdate({ activePrimaryAddr });
+                if (updateCheck.hasUpdate) {
+                    console.log(`${lc} 🔔 Keystone update available on app boot! Server n=${updateCheck.serverN}, Local n=${updateCheck.localN}`);
+                    await syncSvc.updateActiveKeystone({ activePrimaryAddr });
+                } else {
+                    console.log(`${lc} Keystone identity up to date on app boot (n=${updateCheck.localN}).`);
+                }
+            }
+
+            // Trigger 5 (30s Test Heartbeat): Start background 30-second setInterval heartbeat log nag
+            setInterval(async () => {
+                console.log(`[KeystoneSyncService] ⚠️ HEARTBEAT TEST MODE: Interval set to 30s for testing (MUST be changed to 5m for production)`);
+                try {
+                    const currentDomainIdentity = (globalThis as any).ibgib?.identity?.domainIdentity;
+                    if (currentDomainIdentity) {
+                        const activeAddr = getIbGibAddr({ ibGib: currentDomainIdentity });
+                        const syncSvc = getKeystoneSyncService();
+                        const res = await syncSvc.checkForKeystoneUpdate({ activePrimaryAddr: activeAddr });
+                        if (res.hasUpdate) {
+                            console.log(`[KeystoneSyncService] 🔔 Heartbeat detected keystone update on server! Server n=${res.serverN}, Local n=${res.localN}`);
+                        }
+                    }
+                } catch (err) {
+                    console.warn(`[KeystoneSyncService] Heartbeat update check error: ${extractErrorMsg(err)}`);
+                }
+            }, 30000);
         } catch (error) {
             console.error(`${lc} ${extractErrorMsg(error)}`);
         }

package/src/common/keystone-policies.mts

@@ -19,7 +19,7 @@ import {
 import { createPoolConfigFromJson, KeystonePoolTemplate } from '@ibgib/core-gib/dist/keystone/keystone-config-builder.mjs';
 import { KeystonePoolConfig } from '@ibgib/core-gib/dist/keystone/keystone-types.mjs';
 
-import rawPolicies from './keystone-policies.json' assert { type: 'json' };
+import rawPolicies from './keystone-policies.json' with { type: 'json' };
 
 // ---------------------------------------------------------------------------
 // 1. JSON Configuration Mapping & Hybrid Fallbacks

package/src/server/README.md

@@ -10,9 +10,10 @@ The server is built on a custom microframework called `serve-gib`. For details o
 * **Hosting**: The server runs inside a Docker container orchestrated via `docker-compose`.
 * **Build**: Compiled and bundled by `esbuild` using the monorepo's shared `build-space-gib.mts` script.
 
-## Core Files
+## Core Files & Endpoints
 * `server.mts`: The main entry point that initializes the server, handles WebSocket upgrades, and defines the HTTP routing pipeline.
-* `path-constants.mts`: Canonical definitions for all API regex routes.
+* `path-constants.mts`: Canonical definitions for all API regex routes (`/api/health`, `/api/keystone/*`, `/api/email/inbound`, `/api/email/send`, etc.).
 * `bootstrap-helper.mts`: Logic for initializing domain-isolated multitenant metaspaces.
+* `handlers/api/email/`: Endpoint handlers for inbound SES webhook processing (`POST /api/email/inbound`) and outbound email dispatch (`POST /api/email/send`).
 
 For local development commands, please refer to the [Root space-gib README](../../README.md).

package/src/server/server.mts

@@ -1,7 +1,7 @@
 /**
  * @module server
  *
- * Native Node.js HTTP server for space-gib — using the serve-gib microframework.
+ * Native Node.js HTTP server for space-gib — using serve-gib from @ibgib/node-gib.
  */
 
 import { createServer } from 'node:http';
@@ -9,21 +9,14 @@ import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { extractErrorMsg } from '@ibgib/helper-gib/dist/helpers/utils-helper.mjs';
-
-import { ServeGib_V1 } from './serve-gib/serve-gib-v1.mjs';
-import { HealthHandler } from './serve-gib/handlers/api/health.handler.mjs';
-import { IbGibHandler } from './serve-gib/handlers/api/ibgib/ibgib.handler.mjs';
-import { KeystonePostHandler } from './serve-gib/handlers/api/keystone/keystone-post.handler.mjs';
-import { KeystoneGetHandler } from './serve-gib/handlers/api/keystone/keystone-get.handler.mjs';
-import { KeystoneGenesisHandler } from './serve-gib/handlers/api/keystone/keystone-genesis.handler.mjs';
-import { KeystoneEvolveHandler } from './serve-gib/handlers/api/keystone/keystone-evolve.handler.mjs';
-import { StaticFileHandler } from './serve-gib/handlers/static-handler.mjs';
-import { ErrorHandler } from './serve-gib/handlers/error-handler.mjs';
-import { canHandleWsUpgrade, handleWsEchoUpgrade } from './serve-gib/handlers/api/debug/ws-echo.handler.mjs';
-import { SyncUpgradeHandler } from './serve-gib/handlers/ws/sync-upgrade.handler.mjs';
-import { SsoLinkHandler } from './serve-gib/handlers/api/keystone/sso-link.handler.mjs';
-import { SsoLoginHandler } from './serve-gib/handlers/api/keystone/sso-login.handler.mjs';
-import { SsoConfigHandler } from './serve-gib/handlers/api/keystone/sso-config.handler.mjs';
+import {
+    ServeGib_V1,
+    ErrorHandler,
+    SyncUpgradeHandler,
+    canHandleWsUpgrade,
+    handleWsEchoUpgrade,
+    getStandardServeGibHandlers,
+} from '@ibgib/node-gib/dist/serve-gib/index.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -43,27 +36,15 @@ async function main(): Promise<void> {
     const lc = '[space-gib server]';
     try {
         console.log(`${lc} starting...`);
-
         console.log(`${lc} dataDir: ${DATA_DIR}`);
 
         const syncUpgradeHandler = new SyncUpgradeHandler();
 
-        // Initialize serve-gib
+        // Initialize serve-gib using standard handler preset from @ibgib/node-gib
         const serveGib = new ServeGib_V1({
             port: PORT,
             dataDir: DATA_DIR,
-            handlers: [
-                new HealthHandler(),
-                new IbGibHandler(),
-                new KeystoneGenesisHandler(),
-                new KeystoneEvolveHandler(),
-                new KeystonePostHandler(),
-                new KeystoneGetHandler(),
-                new SsoLinkHandler(),
-                new SsoLoginHandler(),
-                new SsoConfigHandler(),
-                new StaticFileHandler(CLIENT_DIR),
-            ],
+            handlers: getStandardServeGibHandlers({ clientDir: CLIENT_DIR }),
             errorHandler: new ErrorHandler()
         });
 
@@ -75,10 +56,10 @@ async function main(): Promise<void> {
         // since Node.js fires `upgrade` events independently of `request` events.
         server.on('upgrade', async (req, socket, head) => {
             const reqCtx = await serveGib.prepareContext(req);
-            
+
             // Check sync upgrade handler first
             const isSync = await syncUpgradeHandler.handleUpgrade(reqCtx, socket as any, head);
-            
+
             // Fallback to debug echo if not handled by sync
             if (!isSync && canHandleWsUpgrade(req)) {
                 handleWsEchoUpgrade(req, socket as any, head);