@ibgib/web-gib 0.0.63 → 0.0.65

package/src/index.mts

@@ -25,7 +25,15 @@ export * from "./identity/passkey-helper.mjs";
 // Identity UI components
 export * from "./ui/component/identity/index.mjs";
 
+// Privacy Policy component
+export * from "./ui/component/privacy-policy/index.mjs";
+
 // UI constants & types
 export * from "./ui/ui-constants.mjs";
 export * from "./ui/ui-types.mjs";
 
+// Workspace Projection Spaces
+export * from "./witness/space/web-in-memory-workspace-projection-space/web-in-memory-workspace-projection-space-v1.mjs";
+export * from "./witness/space/web-in-memory-workspace-projection-space/web-in-memory-workspace-projection-space-types.mjs";
+export * from "./witness/space/web-in-memory-workspace-projection-space/web-in-memory-workspace-projection-space-constants.mjs";
+

package/src/storage/storage-helpers.web.mts

@@ -744,7 +744,7 @@ export async function storageDelete({
     const lc = `[${storageDelete.name}]`;
     let db: IDBDatabase | undefined = undefined;
     try {
-        if (logalot) { console.log(`${lc} starting... (I: 8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d)`); }
+        if (logalot) { console.log(`${lc} starting... (I: genuuid)`); }
         await new Promise<void>((resolve, reject) => {
             const openDBRequest = indexedDB.open(dbName);
             openDBRequest.onerror = () => {

package/src/ui/component/identity/add-device/add-device.mts

@@ -7,11 +7,12 @@ import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
 import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
 import { getIbGibAddr } from "@ibgib/ts-gib/dist/helper.mjs";
 import { KeystoneService_V1 } from "@ibgib/core-gib/dist/keystone/keystone-service-v1.mjs";
-import { KeystoneProfileBuilder } from "@ibgib/core-gib/dist/keystone/policy/keystone-profile-builder.mjs";
 import { KeystoneIbGib_V1 } from "@ibgib/core-gib/dist/keystone/keystone-types.mjs";
-import { KEYSTONE_USERNAME_REGEXP, KEYSTONE_VERB_SYNC, KEYSTONE_VERB_CONNECT } from "@ibgib/core-gib/dist/keystone/keystone-constants.mjs";
+import {
+    KEYSTONE_USERNAME_REGEXP, KEYSTONE_VERB_SYNC, KEYSTONE_VERB_CONNECT
+} from "@ibgib/core-gib/dist/keystone/keystone-constants.mjs";
 import { deriveDelegateSecret, createSyncDelegateKeystone } from "@ibgib/core-gib/dist/keystone/delegate/delegate-helpers.mjs";
-import { getTimelinesGroupedByTjp, getTjpAddr, toDto } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
+import { getTimelinesGroupedByTjp, toDto } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
 import { updateSpecialIndex } from "@ibgib/core-gib/dist/timeline/timeline-api.mjs";
 import { validateEmail } from "@ibgib/core-gib/dist/keystone/keystone-helpers.mjs";
 import { FlatIbGibGraph } from "@ibgib/core-gib/dist/common/other/graph-types.mjs";
@@ -589,7 +590,7 @@ export class AddDeviceComponentInstance
 
             const sovereignSyncProfileName = process.env.KEYSTONE_PROFILE_SOVEREIGN_SYNC;
             if (!sovereignSyncProfileName || !sovereignSyncProfileName.trim()) {
-                throw new Error('KEYSTONE_PROFILE_SOVEREIGN_SYNC environment variable is missing. Expected valid profile name like "sync-profile.dev" or "sync-profile.prod". (E: 8f9e0a1b2c3d4e5f67890123456789ab)');
+                throw new Error('KEYSTONE_PROFILE_SOVEREIGN_SYNC environment variable is missing. Expected valid profile name like "sync-profile.dev" or "sync-profile.prod". (E: genuuid)');
             }
 
             const delegateKeystone = await createSyncDelegateKeystone({

package/src/ui/component/identity/identity-header/identity-header.mts

@@ -22,6 +22,7 @@ import { getDeterministicColorInfo, getGlobalMetaspace_waitIfNeeded } from "../.
 import {
     EVENT_IBGIB_IDENTITY_REQUEST_CHANGE, EVENT_IBGIB_IDENTITY_CHANGED, EVENT_IBGIB_UI_MESSAGE,
     EVENT_IBGIB_IDENTITY_UPDATE_AVAILABLE,
+    UI_ACTION_SHOW_IDENTITY_MANAGER, UI_ACTION_SHOW_KEYSTONE_CREATOR, UI_ACTION_SHOW_ADD_DEVICE
 } from "../../../ui-constants.mjs";
 import { EventIbGibIdentityUpdateAvailableDetail } from "../../../ui-types.mjs";
 import { getKeystoneSyncService } from "../../../../identity/keystone-sync-service.mjs";
@@ -376,7 +377,7 @@ export class IdentityHeaderComponentInstance
             e.stopPropagation();
             this.closeDropdown();
             window.dispatchEvent(new CustomEvent(EVENT_IBGIB_UI_MESSAGE, {
-                detail: { action: 'show-keystone-creator' },
+                detail: { action: UI_ACTION_SHOW_KEYSTONE_CREATOR },
                 bubbles: true,
                 composed: true
             }));
@@ -386,7 +387,7 @@ export class IdentityHeaderComponentInstance
             e.stopPropagation();
             this.closeDropdown();
             window.dispatchEvent(new CustomEvent(EVENT_IBGIB_UI_MESSAGE, {
-                detail: { action: 'show-add-device' },
+                detail: { action: UI_ACTION_SHOW_ADD_DEVICE },
                 bubbles: true,
                 composed: true
             }));
@@ -412,7 +413,7 @@ export class IdentityHeaderComponentInstance
 
     private navigateToManager() {
         window.dispatchEvent(new CustomEvent(EVENT_IBGIB_UI_MESSAGE, {
-            detail: { action: 'show-identity-manager' },
+            detail: { action: UI_ACTION_SHOW_IDENTITY_MANAGER },
             bubbles: true,
             composed: true
         }));

package/src/ui/component/identity/keystone-details/keystone-details.mts

@@ -943,11 +943,11 @@ export class KeystoneDetailsComponentInstance
 
         const metaspace = await getGlobalMetaspace_waitIfNeeded();
         if (!metaspace) {
-            throw new Error(`(UNEXPECTED) metaspace falsy? (E: 8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3e)`);
+            throw new Error(`(UNEXPECTED) metaspace falsy? (E: genuuid)`);
         }
         const space = await metaspace.getLocalUserSpace({ lock: false });
         if (!space) {
-            throw new Error(`(UNEXPECTED) space falsy? (E: 9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4f)`);
+            throw new Error(`(UNEXPECTED) space falsy? (E: genuuid)`);
         }
         const localSpaceId = space.ib ? parseSpaceIb({ spaceIb: space.ib }).spaceId : undefined;
 

package/src/ui/component/privacy-policy/index.mts

@@ -0,0 +1,18 @@
+/**
+ * @module ui/component/privacy-policy
+ *
+ * Privacy Policy UI component and registration helper.
+ */
+
+export * from './privacy-policy.mjs';
+
+import { getComponentSvc } from '../ibgib-component-service.mjs';
+import { PrivacyPolicyComponentMeta } from './privacy-policy.mjs';
+
+/**
+ * Registers the Privacy Policy UI component with the central component service.
+ */
+export async function registerPrivacyPolicyComponent(): Promise<void> {
+    const componentSvc = await getComponentSvc();
+    componentSvc.registerComponentMeta(new PrivacyPolicyComponentMeta());
+}

package/src/ui/component/privacy-policy/privacy-policy.css

@@ -0,0 +1,263 @@
+/* =========================================================================
+   ibgib — privacy-policy.css
+   Scoped styles for <ibgib-privacy-policy> Web Component.
+   Inherits CSS custom properties from the host application.
+   ========================================================================= */
+
+:host {
+    display: block;
+    width: 100%;
+    height: 100%;
+    overflow-y: auto;
+    overflow-x: hidden;
+    color: var(--clr-text-primary, #e8f0e8);
+    font-family: var(--font-sans, system-ui, sans-serif);
+    line-height: 1.6;
+    box-sizing: border-box;
+}
+
+.privacy-container {
+    max-width: 860px;
+    margin: 0 auto;
+    padding: 2rem 1.5rem 4rem;
+    box-sizing: border-box;
+}
+
+/* ── Header ── */
+.privacy-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding-bottom: 1.25rem;
+    margin-bottom: 2rem;
+    border-bottom: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+}
+
+.btn-back {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.45rem 0.9rem;
+    font-size: 0.88rem;
+    font-family: inherit;
+    color: var(--clr-text-secondary, #8fa08f);
+    background: var(--clr-bg-glass, rgba(11, 17, 32, 0.7));
+    border: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+    border-radius: var(--radius-sm, 6px);
+    cursor: pointer;
+    transition: all var(--t-fast, 120ms ease);
+}
+
+.btn-back:hover {
+    color: var(--clr-text-primary, #ffffff);
+    border-color: var(--clr-border-hover, rgba(120, 248, 126, 0.32));
+    background: var(--clr-accent-glow, rgba(120, 248, 126, 0.15));
+}
+
+.privacy-badge {
+    font-size: 0.85rem;
+    color: var(--clr-accent, #78f87e);
+    padding: 0.3rem 0.75rem;
+    border-radius: var(--radius-sm, 6px);
+    background: var(--clr-accent-glow, rgba(120, 248, 126, 0.1));
+    border: 1px solid var(--clr-border, rgba(120, 248, 126, 0.15));
+}
+
+/* ── Loading State ── */
+.privacy-loading {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 4rem 1rem;
+    gap: 1rem;
+    color: var(--clr-text-secondary, #8fa08f);
+}
+
+.spinner {
+    width: 32px;
+    height: 32px;
+    border: 3px solid var(--clr-border, rgba(120, 248, 126, 0.15));
+    border-top-color: var(--clr-accent, #78f87e);
+    border-radius: 50%;
+    animation: spin 0.8s linear infinite;
+}
+
+@keyframes spin {
+    to { transform: rotate(360deg); }
+}
+
+/* ── Error State ── */
+.privacy-error {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding: 3rem 1rem;
+    gap: 1rem;
+    color: var(--clr-danger, #ff5b5b);
+    background: rgba(255, 91, 91, 0.08);
+    border: 1px solid rgba(255, 91, 91, 0.25);
+    border-radius: var(--radius-md, 12px);
+    margin: 2rem 0;
+}
+
+.btn-retry {
+    padding: 0.4rem 1rem;
+    font-size: 0.88rem;
+    color: var(--clr-text-primary, #ffffff);
+    background: var(--clr-danger, #ff5b5b);
+    border: none;
+    border-radius: var(--radius-sm, 6px);
+    cursor: pointer;
+}
+
+/* ── Markdown Rendered Typography ── */
+.privacy-content {
+    display: block;
+}
+
+.privacy-content .policy-title {
+    font-size: 2.2rem;
+    color: var(--clr-text-primary, #ffffff);
+    margin-top: 0;
+    margin-bottom: 0.75rem;
+    line-height: 1.25;
+}
+
+.privacy-content .policy-h2 {
+    font-size: 1.35rem;
+    color: var(--clr-accent, #78f87e);
+    margin-top: 2.25rem;
+    margin-bottom: 0.75rem;
+    padding-bottom: 0.35rem;
+    border-bottom: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+}
+
+.privacy-content .policy-h3 {
+    font-size: 1.1rem;
+    color: var(--clr-text-primary, #e8f0e8);
+    margin-top: 1.5rem;
+    margin-bottom: 0.5rem;
+}
+
+.privacy-content .policy-h4 {
+    font-size: 0.95rem;
+    color: var(--clr-text-secondary, #8fa08f);
+    margin-top: 1.25rem;
+    margin-bottom: 0.4rem;
+}
+
+.privacy-content p {
+    color: var(--clr-text-primary, #e8f0e8);
+    font-size: 0.95rem;
+    margin: 0.75rem 0;
+}
+
+.privacy-content ul,
+.privacy-content ol {
+    padding-left: 1.5rem;
+    margin: 0.5rem 0 1rem;
+}
+
+.privacy-content li {
+    color: var(--clr-text-primary, #e8f0e8);
+    font-size: 0.95rem;
+    margin-bottom: 0.35rem;
+}
+
+.privacy-content code {
+    font-family: var(--font-mono, monospace);
+    font-size: 0.85em;
+    background: rgba(255, 255, 255, 0.08);
+    padding: 0.15rem 0.35rem;
+    border-radius: 4px;
+    color: var(--clr-accent, #78f87e);
+}
+
+.privacy-content code.math {
+    color: var(--clr-info, #44aaff);
+}
+
+.privacy-content a {
+    color: var(--clr-accent, #78f87e);
+    text-decoration: underline;
+    transition: color var(--t-fast, 120ms ease);
+}
+
+.privacy-content a:hover {
+    color: var(--clr-border-hover, #a6fca9);
+}
+
+.privacy-content .divider {
+    border: 0;
+    border-top: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+    margin: 2.25rem 0;
+}
+
+/* ── Alert Boxes ── */
+.privacy-content .alert-box {
+    display: flex;
+    gap: 0.75rem;
+    padding: 1rem 1.25rem;
+    border-radius: var(--radius-sm, 6px);
+    margin: 1.25rem 0;
+    align-items: flex-start;
+    border: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+    background: var(--clr-bg-glass, rgba(11, 17, 32, 0.7));
+}
+
+.privacy-content .alert-warning {
+    background: rgba(255, 204, 68, 0.08);
+    border-color: rgba(255, 204, 68, 0.3);
+    color: var(--clr-warn, #ffcc44);
+}
+
+.privacy-content .alert-important {
+    background: rgba(68, 170, 255, 0.08);
+    border-color: rgba(68, 170, 255, 0.3);
+    color: var(--clr-info, #44aaff);
+}
+
+.privacy-content .alert-note {
+    background: rgba(120, 248, 126, 0.08);
+    border-color: rgba(120, 248, 126, 0.3);
+    color: var(--clr-accent, #78f87e);
+}
+
+.privacy-content .alert-icon {
+    font-size: 1.2rem;
+    line-height: 1.2;
+}
+
+.privacy-content .alert-body {
+    font-size: 0.88rem;
+    line-height: 1.45;
+    color: var(--clr-text-primary, #e8f0e8);
+}
+
+/* ── Footer ── */
+.privacy-footer {
+    margin-top: 3.5rem;
+    padding-top: 1.5rem;
+    border-top: 1px solid var(--clr-border, rgba(120, 248, 126, 0.12));
+    font-size: 0.85rem;
+    color: var(--clr-text-secondary, #8fa08f);
+    display: flex;
+    justify-content: space-between;
+    flex-wrap: wrap;
+    gap: 1rem;
+}
+
+.privacy-footer a {
+    color: var(--clr-accent, #78f87e);
+    text-decoration: none;
+}
+
+.privacy-footer a:hover {
+    text-decoration: underline;
+}
+
+.hidden {
+    display: none !important;
+}

package/src/ui/component/privacy-policy/privacy-policy.html

@@ -0,0 +1,27 @@
+<div class="privacy-container">
+    <header class="privacy-header">
+        <button id="btn-back" class="btn-back" type="button">
+            <span class="icon">←</span>
+            <span>Return</span>
+        </button>
+        <span class="privacy-badge">🔒 Privacy Policy</span>
+    </header>
+
+    <div id="loading-spinner" class="privacy-loading">
+        <div class="spinner"></div>
+        <p>Loading Privacy Policy...</p>
+    </div>
+
+    <div id="error-container" class="privacy-error hidden">
+        <p id="error-message">Unable to load Privacy Policy.</p>
+        <button id="btn-retry" class="btn-retry" type="button">Retry</button>
+    </div>
+
+    <main id="privacy-content" class="privacy-content hidden">
+    </main>
+
+    <footer class="privacy-footer">
+        <span>© ibgib contributors</span>
+        <span class="footer-link"><a href="https://ibgib.space" target="_blank" rel="noopener">ibgib.space</a></span>
+    </footer>
+</div>

package/src/ui/component/privacy-policy/privacy-policy.mts

@@ -0,0 +1,168 @@
+import thisCss from "./privacy-policy.css";
+import thisHtml from "./privacy-policy.html";
+import commonComponentStylesCss from "../common-component-styles.css";
+
+import { extractErrorMsg } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { convertMarkdownToHtml } from "@ibgib/helper-gib/dist/helpers/markdown-helper.mjs";
+import { ROOT_ADDR } from "@ibgib/ts-gib/dist/V1/constants.mjs";
+import { IbGibAddr } from "@ibgib/ts-gib/dist/types.mjs";
+import { IbGib_V1 } from "@ibgib/ts-gib/dist/V1/types.mjs";
+
+import { IbGibDynamicComponentMetaBase, IbGibDynamicComponentInstanceBase } from "../ibgib-dynamic-component-bases.mjs";
+import { ElementsBase, IbGibDynamicComponentInstance } from "../component-types.mjs";
+import { getComponentCtorArg } from "../../../app-bootstrap/init-orchestration.mjs";
+
+export const PRIVACY_POLICY_COMPONENT_NAME = 'ibgib-privacy-policy';
+
+/**
+ * Metadata for the Privacy Policy component.
+ */
+export class PrivacyPolicyComponentMeta extends IbGibDynamicComponentMetaBase {
+    protected lc: string = `[PrivacyPolicyComponentMeta]`;
+
+    routeRegExp?: RegExp = new RegExp(`^${PRIVACY_POLICY_COMPONENT_NAME}$|^privacy(-policy)?$`, 'i');
+    componentName = PRIVACY_POLICY_COMPONENT_NAME;
+
+    constructor() {
+        super(getComponentCtorArg());
+        if (typeof customElements !== 'undefined' && !customElements.get(this.componentName)) {
+            customElements.define(this.componentName, PrivacyPolicyComponentInstance);
+        }
+    }
+
+    async createInstance({
+        path,
+        ibGibAddr
+    }: {
+        path: string;
+        ibGibAddr: IbGibAddr;
+    }): Promise<IbGibDynamicComponentInstance> {
+        const lc = `${this.lc}[${this.createInstance.name}]`;
+        const component = document.createElement(this.componentName) as PrivacyPolicyComponentInstance;
+        await component.initialize({
+            ibGibAddr: ibGibAddr || ROOT_ADDR,
+            meta: this,
+            html: thisHtml,
+            css: [commonComponentStylesCss, thisCss],
+        });
+        return component;
+    }
+}
+
+/**
+ * References to DOM elements within the Privacy Policy shadow root.
+ */
+interface PrivacyPolicyElements extends ElementsBase {
+    btnBack?: HTMLButtonElement;
+    loadingSpinner?: HTMLDivElement;
+    errorContainer?: HTMLDivElement;
+    errorMessage?: HTMLParagraphElement;
+    btnRetry?: HTMLButtonElement;
+    privacyContent?: HTMLElement;
+}
+
+/**
+ * Concrete Web Component implementation for rendering Privacy Policy markdown.
+ */
+export class PrivacyPolicyComponentInstance
+    extends IbGibDynamicComponentInstanceBase<IbGib_V1, PrivacyPolicyElements> {
+
+    protected lc: string = `[PrivacyPolicyComponentInstance]`;
+
+    /** Path or URL to the markdown privacy policy file */
+    public markdownUrl: string = '/PRIVACY_POLICY.md';
+
+    constructor() {
+        super();
+    }
+
+    public override async created(): Promise<void> {
+        const lc = `${this.lc}[${this.created.name}]`;
+        try {
+            const shadow = this.shadowRoot!;
+            const contentEl = (shadow.querySelector('.privacy-container') || shadow.querySelector('#privacy-content') || this) as HTMLElement;
+
+            this.elements = {
+                contentEl,
+                btnBack: shadow.querySelector('#btn-back') as HTMLButtonElement,
+                loadingSpinner: shadow.querySelector('#loading-spinner') as HTMLDivElement,
+                errorContainer: shadow.querySelector('#error-container') as HTMLDivElement,
+                errorMessage: shadow.querySelector('#error-message') as HTMLParagraphElement,
+                btnRetry: shadow.querySelector('#btn-retry') as HTMLButtonElement,
+                privacyContent: shadow.querySelector('#privacy-content') as HTMLElement,
+            };
+
+            this.elements.btnBack?.addEventListener('click', () => {
+                if (window.history.length > 1) {
+                    window.history.back();
+                } else {
+                    window.location.href = '/';
+                }
+            });
+
+            this.elements.btnRetry?.addEventListener('click', () => {
+                this.loadPrivacyPolicy();
+            });
+
+            await this.loadPrivacyPolicy();
+
+        } catch (error) {
+            console.error(`${lc} ${extractErrorMsg(error)}`);
+        }
+    }
+
+    public override async disconnected(): Promise<void> {
+        const lc = `${this.lc}[${this.disconnected.name}]`;
+        // Cleanup if needed
+    }
+
+    /**
+     * Fetches the markdown policy and converts it to formatted HTML in the DOM.
+     */
+    public async loadPrivacyPolicy(): Promise<void> {
+        const lc = `${this.lc}[${this.loadPrivacyPolicy.name}]`;
+        try {
+            const el = this.elements;
+            if (el?.loadingSpinner) {
+                el.loadingSpinner.classList.remove('hidden');
+            }
+            if (el?.errorContainer) {
+                el.errorContainer.classList.add('hidden');
+            }
+            if (el?.privacyContent) {
+                el.privacyContent.classList.add('hidden');
+            }
+
+            const res = await fetch(this.markdownUrl);
+            if (!res.ok) {
+                throw new Error(`Failed to load ${this.markdownUrl} (status ${res.status}: ${res.statusText})`);
+            }
+
+            const mdText = await res.text();
+            const renderedHtml = convertMarkdownToHtml(mdText, {
+                linkTarget: '_blank',
+                linkRel: 'noopener',
+                enableAlerts: true
+            });
+
+            if (this.elements?.privacyContent) {
+                this.elements.privacyContent.innerHTML = renderedHtml;
+                this.elements.privacyContent.classList.remove('hidden');
+            }
+
+        } catch (error) {
+            const msg = extractErrorMsg(error);
+            console.error(`${lc} ${msg}`);
+            if (this.elements?.errorMessage) {
+                this.elements.errorMessage.textContent = `Unable to load Privacy Policy: ${msg}`;
+            }
+            if (this.elements?.errorContainer) {
+                this.elements.errorContainer.classList.remove('hidden');
+            }
+        } finally {
+            if (this.elements?.loadingSpinner) {
+                this.elements.loadingSpinner.classList.add('hidden');
+            }
+        }
+    }
+}

package/src/ui/ui-constants.mts

@@ -110,4 +110,11 @@ export const EVENT_IBGIB_IDENTITY_UPDATE_AVAILABLE = 'ibgib-identity-update-avai
 export const EVENT_IBGIB_IDENTITY_RENEWAL_REQUIRED = 'ibgib-identity-renewal-required';
 // #endregion Custom Events
 
+// #region UI Message Actions
+export const UI_ACTION_SHOW_IDENTITY_MANAGER = 'show-identity-manager';
+export const UI_ACTION_SHOW_KEYSTONE_CREATOR = 'show-keystone-creator';
+export const UI_ACTION_SHOW_ADD_DEVICE = 'show-add-device';
+export const UI_ACTION_SHOW_PRIVACY_POLICY = 'show-privacy-policy';
+// #endregion UI Message Actions
+
 

package/src/witness/agent/gemini/gemini-helpers.mts

@@ -181,19 +181,19 @@ export function getFunctionCallAndResponseParts({
 }): { call: FunctionCallPart, response: FunctionResponsePart } {
     const lc = `[${getFunctionCallAndResponseParts.name}]`;
     try {
-        if (logalot) { console.log(`${lc} starting... (I: 1a2b3c4d5e6f7a8b)`); }
+        if (logalot) { console.log(`${lc} starting... (I: genuuid)`); }
 
         if (!functionInfoIbGib) {
-            throw new Error(`${lc} functionInfoIbGib parameter is required. (E: 9c8f7a3b2d1e4a5b6c7d8e9f)`);
+            throw new Error(`${lc} functionInfoIbGib parameter is required. (E: genuuid)`);
         }
         if (!functionInfoIbGib.data) {
-            throw new Error(`${lc} functionInfoIbGib.data is required. (E: 2b3c4d5e6f7a8b1c2d3e4f5a)`);
+            throw new Error(`${lc} functionInfoIbGib.data is required. (E: genuuid)`);
         }
 
         const { fnName, fnArgs, fnResult } = functionInfoIbGib.data;
 
         if (!fnName) {
-            throw new Error(`${lc} functionInfoIbGib.data.fnName is required. (E: 6f7a8b1c2d3e4f5a6b7c8d9e)`);
+            throw new Error(`${lc} functionInfoIbGib.data.fnName is required. (E: genuuid)`);
         }
 
         // 1. Create FunctionCallPart

package/src/witness/space/web-in-memory-workspace-projection-space/web-in-memory-workspace-projection-space-constants.mts

@@ -0,0 +1,8 @@
+/**
+ * @module web-in-memory-workspace-projection-space-constants
+ *
+ * Constants for in-memory web workspace projection spaces.
+ */
+
+export const DEFAULT_WEB_IN_MEMORY_WORKSPACE_PROJECTION_SPACE_DESCRIPTION =
+    'Web in-memory space witness for projecting and observing virtual workspace hierarchies in browser environments.';

package/src/witness/space/web-in-memory-workspace-projection-space/web-in-memory-workspace-projection-space-types.mts

@@ -0,0 +1,53 @@
+/**
+ * @module web-in-memory-workspace-projection-space-types
+ *
+ * Types for in-memory web workspace projection spaces.
+ */
+
+import {
+    WorkspaceProjectionSpaceData_V1,
+    WorkspaceProjectionSpaceRel8ns_V1
+} from '@ibgib/core-gib/dist/witness/space/workspace-projection-space/workspace-projection-space-types.mjs';
+import {
+    DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
+    IBGIB_SPACE_NAME_DEFAULT,
+    ZERO_SPACE_ID
+} from '@ibgib/core-gib/dist/witness/space/space-constants.mjs';
+import {
+    DEFAULT_WEB_IN_MEMORY_WORKSPACE_PROJECTION_SPACE_DESCRIPTION
+} from './web-in-memory-workspace-projection-space-constants.mjs';
+
+/**
+ * In-memory virtual file entry.
+ */
+export interface VirtualFileEntry {
+    relPath: string;
+    content: Uint8Array;
+    isDirectory: boolean;
+    modifiedAt?: number;
+}
+
+/**
+ * Data payload for WebInMemoryWorkspaceProjectionSpace_V1.
+ */
+export interface WebInMemoryWorkspaceProjectionSpaceData_V1 extends WorkspaceProjectionSpaceData_V1 {
+}
+
+export const DEFAULT_WEB_IN_MEMORY_WORKSPACE_PROJECTION_SPACE_DATA_V1: WebInMemoryWorkspaceProjectionSpaceData_V1 = {
+    version: '1',
+    uuid: ZERO_SPACE_ID,
+    name: IBGIB_SPACE_NAME_DEFAULT,
+    classname: 'WebInMemoryWorkspaceProjectionSpace_V1',
+    workspaceRoot: '/',
+    vcsFolderName: '.vcsgib',
+    persistOptsAndResultIbGibs: false,
+    validateIbGibAddrsMatchIbGibs: false,
+    longPollingIntervalMs: DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
+    allowPrimitiveArgs: false,
+    catchAllErrors: true,
+    description: DEFAULT_WEB_IN_MEMORY_WORKSPACE_PROJECTION_SPACE_DESCRIPTION,
+    trace: false,
+};
+
+export interface WebInMemoryWorkspaceProjectionSpaceRel8ns_V1 extends WorkspaceProjectionSpaceRel8ns_V1 {
+}