@managespace/sdk 0.1.174 → 0.1.175

package/dist/extensibility/functions/project/document.d.ts

@@ -1,4 +1,4 @@
-import { CreateDocument, DocumentComplete, DocumentCreated, DocumentStatus, Success, Template } from '../../../generated';
+import { CreateDocument, DocumentComplete, Success, Template } from '../../../generated';
 import { CreateTemplate as CreateTemplatePayload } from '../../../generated/models/create-template';
 import { ExtPlugin } from '../../types';
 type BasePaginationQuery = {
@@ -7,7 +7,7 @@ type BasePaginationQuery = {
 };
 export declare namespace Document {
     class Create implements ExtPlugin {
-        responseType: DocumentCreated;
+        responseType: Success;
         payload: CreateDocument & {
             siteId: string;
         };
@@ -36,12 +36,6 @@ export declare namespace Document {
         responseType: Success;
         payload: DocumentComplete;
     }
-    class GetStatus implements ExtPlugin {
-        responseType: DocumentStatus;
-        payload: {
-            documentId: string;
-        };
-    }
 }
 export {};
 //# sourceMappingURL=document.d.ts.map

package/dist/extensibility/functions/project/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../src/extensibility/functions/project/document.ts"],"names":[],"mappings":"AACA,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,OAAO,EACP,QAAQ,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,KAAK,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,yBAAiB,QAAQ,CAAC;IACtB,MAAa,MAAO,YAAW,SAAS;QACpC,YAAY,EAAG,eAAe,CAAC;QAE/B,OAAO,EAAG,cAAc,GAAG;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD;IACD,MAAa,cAAe,YAAW,SAAS;QAC5C,YAAY,EAAG,QAAQ,CAAC;QAExB,OAAO,EAAG,qBAAqB,GAAG;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD;IACD,MAAa,WAAY,YAAW,SAAS;QACzC,YAAY,EAAG,QAAQ,CAAC;QAExB,OAAO,EAAG;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KACpC;IACD,MAAa,YAAa,YAAW,SAAS;QAC1C,YAAY,EAAG,QAAQ,EAAE,CAAC;QAE1B,OAAO,EAAG,mBAAmB,GAAG;YAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC;KACL;IACD,MAAa,MAAO,YAAW,SAAS;QACpC,YAAY,EAAG,OAAO,CAAC;QAEvB,OAAO,EAAG,gBAAgB,CAAC;KAC9B;IACD,MAAa,SAAU,YAAW,SAAS;QACvC,YAAY,EAAG,cAAc,CAAC;QAE9B,OAAO,EAAG;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KACpC;CACJ"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../src/extensibility/functions/project/document.ts"],"names":[],"mappings":"AACA,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,KAAK,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,yBAAiB,QAAQ,CAAC;IACtB,MAAa,MAAO,YAAW,SAAS;QACpC,YAAY,EAAG,OAAO,CAAC;QAEvB,OAAO,EAAG,cAAc,GAAG;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD;IACD,MAAa,cAAe,YAAW,SAAS;QAC5C,YAAY,EAAG,QAAQ,CAAC;QAExB,OAAO,EAAG,qBAAqB,GAAG;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD;IACD,MAAa,WAAY,YAAW,SAAS;QACzC,YAAY,EAAG,QAAQ,CAAC;QAExB,OAAO,EAAG;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;KACpC;IACD,MAAa,YAAa,YAAW,SAAS;QAC1C,YAAY,EAAG,QAAQ,EAAE,CAAC;QAE1B,OAAO,EAAG,mBAAmB,GAAG;YAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC;KACL;IACD,MAAa,MAAO,YAAW,SAAS;QACpC,YAAY,EAAG,OAAO,CAAC;QAEvB,OAAO,EAAG,gBAAgB,CAAC;KAC9B;CACJ"}

package/dist/extensibility/functions/project/document.js

@@ -28,9 +28,4 @@ var Document;
         payload;
     }
     Document.Signed = Signed;
-    class GetStatus {
-        responseType;
-        payload;
-    }
-    Document.GetStatus = GetStatus;
 })(Document || (exports.Document = Document = {}));

package/dist/extensions/host-bridge.d.ts

@@ -0,0 +1,166 @@
+import type { EntityEventHandler, ExtensionContext } from './types';
+/**
+ * Get the extension context from the ManageSpace host.
+ *
+ * This returns a promise that resolves when the context is received from the host.
+ * Call this early in your extension's lifecycle to get authentication and org context.
+ *
+ * @example
+ * ```typescript
+ * import { getContext } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * console.log('Org ID:', context.orgId);
+ * console.log('API URL:', context.apiBaseUrl);
+ * ```
+ */
+export declare function getContext(): Promise<ExtensionContext>;
+/**
+ * Get the current context synchronously.
+ *
+ * Returns null if the context has not yet been received from the host.
+ * Prefer using `getContext()` which waits for the context to be available.
+ *
+ * @example
+ * ```typescript
+ * import { getCurrentContext } from '@managespace/sdk/extensions';
+ *
+ * const context = getCurrentContext();
+ * if (context) {
+ *     console.log('Already have context:', context.orgId);
+ * }
+ * ```
+ */
+export declare function getCurrentContext(): ExtensionContext | null;
+/**
+ * Navigate the ManageSpace host application to a specific path.
+ *
+ * Use this to navigate users to pages within ManageSpace, such as
+ * customer profiles, asset details, or other views.
+ *
+ * @param path - The path to navigate to (e.g., "/customer/123")
+ *
+ * @example
+ * ```typescript
+ * import { navigate } from '@managespace/sdk/extensions';
+ *
+ * // Navigate to a customer profile
+ * navigate('/customer/abc-123');
+ *
+ * // Navigate to the assets page
+ * navigate('/assets');
+ * ```
+ */
+export declare function navigate(path: string): void;
+/**
+ * Show a toast notification in the ManageSpace host application.
+ *
+ * Use this for user feedback after actions complete.
+ *
+ * @param message - The message to display
+ * @param variant - The toast type: 'success' or 'error' (default: 'success')
+ *
+ * @example
+ * ```typescript
+ * import { showToast } from '@managespace/sdk/extensions';
+ *
+ * // Success notification
+ * showToast('Customer updated successfully');
+ *
+ * // Error notification
+ * showToast('Failed to save changes', 'error');
+ * ```
+ */
+export declare function showToast(message: string, variant?: 'success' | 'error'): void;
+/**
+ * Signal to the ManageSpace host that the extension is ready to receive context.
+ *
+ * Call this after your extension has loaded and set up its message listeners.
+ * The host will respond with a CONTEXT_INIT message containing the ExtensionContext.
+ *
+ * @example
+ * ```typescript
+ * import { signalReady, getContext } from '@managespace/sdk/extensions';
+ *
+ * // Signal ready and wait for context
+ * signalReady();
+ * const context = await getContext();
+ * ```
+ */
+export declare function signalReady(): void;
+/**
+ * Subscribe to entity events from the ManageSpace host.
+ *
+ * The host sends events when entities (customers, assets, etc.) are
+ * created, updated, or deleted. Use this to keep your extension in sync.
+ *
+ * @param handler - Callback function to handle entity events
+ * @returns Unsubscribe function to remove the handler
+ *
+ * @example
+ * ```typescript
+ * import { onEntityEvent } from '@managespace/sdk/extensions';
+ *
+ * const unsubscribe = onEntityEvent((event) => {
+ *     if (event.entityType === 'customer' && event.action === 'updated') {
+ *         console.log('Customer updated:', event.entityId);
+ *         refreshCustomerData();
+ *     }
+ * });
+ *
+ * // Later, to stop listening:
+ * unsubscribe();
+ * ```
+ */
+export declare function onEntityEvent(handler: EntityEventHandler): () => void;
+/**
+ * Create a configured fetch function for calling the ManageSpace API.
+ *
+ * This returns a fetch wrapper that automatically includes credentials
+ * and sets the correct headers for API calls.
+ *
+ * @param context - The extension context from getContext()
+ * @returns A fetch function configured for ManageSpace API calls
+ *
+ * @example
+ * ```typescript
+ * import { getContext, createApiFetch } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * const apiFetch = createApiFetch(context);
+ *
+ * // Fetch customers
+ * const response = await apiFetch('/api/crm/customers/queries', {
+ *     method: 'POST',
+ *     body: JSON.stringify({
+ *         pageOptions: { offset: 0, limit: 20 }
+ *     })
+ * });
+ * const data = await response.json();
+ * ```
+ */
+export declare function createApiFetch(context: ExtensionContext): (path: string, options?: RequestInit) => Promise<Response>;
+/**
+ * Create a configured fetch function for calling your extension's BFF.
+ *
+ * This returns a fetch wrapper that forwards credentials to your BFF,
+ * allowing it to make authenticated calls to the ManageSpace API.
+ *
+ * @param context - The extension context from getContext()
+ * @returns A fetch function configured for BFF calls, or null if no BFF is configured
+ *
+ * @example
+ * ```typescript
+ * import { getContext, createBffFetch } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * const bffFetch = createBffFetch(context);
+ *
+ * if (bffFetch) {
+ *     const response = await bffFetch('/api/enriched-customers');
+ *     const data = await response.json();
+ * }
+ * ```
+ */
+export declare function createBffFetch(context: ExtensionContext): ((path: string, options?: RequestInit) => Promise<Response>) | null;
+//# sourceMappingURL=host-bridge.d.ts.map

package/dist/extensions/host-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-bridge.d.ts","sourceRoot":"","sources":["../../src/extensions/host-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,gBAAgB,EAGnB,MAAM,SAAS,CAAC;AAiCjB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAQtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,SAAS,GAAG,OAAmB,GACzC,IAAI,CAMN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAKrE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,gBAAgB,GAC1B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAY5D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,gBAAgB,GAC1B,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAgBrE"}

package/dist/extensions/host-bridge.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContext = getContext;
+exports.getCurrentContext = getCurrentContext;
+exports.navigate = navigate;
+exports.showToast = showToast;
+exports.signalReady = signalReady;
+exports.onEntityEvent = onEntityEvent;
+exports.createApiFetch = createApiFetch;
+exports.createBffFetch = createBffFetch;
+let contextResolve = null;
+let currentContext = null;
+const entityEventHandlers = new Set();
+// Set up message listener when this module loads
+if (typeof window !== 'undefined') {
+    window.addEventListener('message', (event) => {
+        if (!event.data?.type)
+            return;
+        switch (event.data.type) {
+            case 'CONTEXT_INIT':
+                currentContext = event.data.payload;
+                if (contextResolve) {
+                    contextResolve(event.data.payload);
+                    contextResolve = null;
+                }
+                break;
+            case 'ENTITY_EVENT':
+                for (const handler of entityEventHandlers) {
+                    try {
+                        handler(event.data.payload);
+                    }
+                    catch (error) {
+                        console.error('Entity event handler error:', error);
+                    }
+                }
+                break;
+        }
+    });
+}
+/**
+ * Get the extension context from the ManageSpace host.
+ *
+ * This returns a promise that resolves when the context is received from the host.
+ * Call this early in your extension's lifecycle to get authentication and org context.
+ *
+ * @example
+ * ```typescript
+ * import { getContext } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * console.log('Org ID:', context.orgId);
+ * console.log('API URL:', context.apiBaseUrl);
+ * ```
+ */
+function getContext() {
+    if (currentContext) {
+        return Promise.resolve(currentContext);
+    }
+    return new Promise((resolve) => {
+        contextResolve = resolve;
+    });
+}
+/**
+ * Get the current context synchronously.
+ *
+ * Returns null if the context has not yet been received from the host.
+ * Prefer using `getContext()` which waits for the context to be available.
+ *
+ * @example
+ * ```typescript
+ * import { getCurrentContext } from '@managespace/sdk/extensions';
+ *
+ * const context = getCurrentContext();
+ * if (context) {
+ *     console.log('Already have context:', context.orgId);
+ * }
+ * ```
+ */
+function getCurrentContext() {
+    return currentContext;
+}
+/**
+ * Navigate the ManageSpace host application to a specific path.
+ *
+ * Use this to navigate users to pages within ManageSpace, such as
+ * customer profiles, asset details, or other views.
+ *
+ * @param path - The path to navigate to (e.g., "/customer/123")
+ *
+ * @example
+ * ```typescript
+ * import { navigate } from '@managespace/sdk/extensions';
+ *
+ * // Navigate to a customer profile
+ * navigate('/customer/abc-123');
+ *
+ * // Navigate to the assets page
+ * navigate('/assets');
+ * ```
+ */
+function navigate(path) {
+    const message = {
+        type: 'NAVIGATE',
+        payload: { path },
+    };
+    window.parent.postMessage(message, '*');
+}
+/**
+ * Show a toast notification in the ManageSpace host application.
+ *
+ * Use this for user feedback after actions complete.
+ *
+ * @param message - The message to display
+ * @param variant - The toast type: 'success' or 'error' (default: 'success')
+ *
+ * @example
+ * ```typescript
+ * import { showToast } from '@managespace/sdk/extensions';
+ *
+ * // Success notification
+ * showToast('Customer updated successfully');
+ *
+ * // Error notification
+ * showToast('Failed to save changes', 'error');
+ * ```
+ */
+function showToast(message, variant = 'success') {
+    const msg = {
+        type: 'SHOW_TOAST',
+        payload: { message, variant },
+    };
+    window.parent.postMessage(msg, '*');
+}
+/**
+ * Signal to the ManageSpace host that the extension is ready to receive context.
+ *
+ * Call this after your extension has loaded and set up its message listeners.
+ * The host will respond with a CONTEXT_INIT message containing the ExtensionContext.
+ *
+ * @example
+ * ```typescript
+ * import { signalReady, getContext } from '@managespace/sdk/extensions';
+ *
+ * // Signal ready and wait for context
+ * signalReady();
+ * const context = await getContext();
+ * ```
+ */
+function signalReady() {
+    const message = { type: 'READY' };
+    window.parent.postMessage(message, '*');
+}
+/**
+ * Subscribe to entity events from the ManageSpace host.
+ *
+ * The host sends events when entities (customers, assets, etc.) are
+ * created, updated, or deleted. Use this to keep your extension in sync.
+ *
+ * @param handler - Callback function to handle entity events
+ * @returns Unsubscribe function to remove the handler
+ *
+ * @example
+ * ```typescript
+ * import { onEntityEvent } from '@managespace/sdk/extensions';
+ *
+ * const unsubscribe = onEntityEvent((event) => {
+ *     if (event.entityType === 'customer' && event.action === 'updated') {
+ *         console.log('Customer updated:', event.entityId);
+ *         refreshCustomerData();
+ *     }
+ * });
+ *
+ * // Later, to stop listening:
+ * unsubscribe();
+ * ```
+ */
+function onEntityEvent(handler) {
+    entityEventHandlers.add(handler);
+    return () => {
+        entityEventHandlers.delete(handler);
+    };
+}
+/**
+ * Create a configured fetch function for calling the ManageSpace API.
+ *
+ * This returns a fetch wrapper that automatically includes credentials
+ * and sets the correct headers for API calls.
+ *
+ * @param context - The extension context from getContext()
+ * @returns A fetch function configured for ManageSpace API calls
+ *
+ * @example
+ * ```typescript
+ * import { getContext, createApiFetch } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * const apiFetch = createApiFetch(context);
+ *
+ * // Fetch customers
+ * const response = await apiFetch('/api/crm/customers/queries', {
+ *     method: 'POST',
+ *     body: JSON.stringify({
+ *         pageOptions: { offset: 0, limit: 20 }
+ *     })
+ * });
+ * const data = await response.json();
+ * ```
+ */
+function createApiFetch(context) {
+    return (path, options = {}) => {
+        const url = `${context.apiBaseUrl}${path}`;
+        return fetch(url, {
+            ...options,
+            credentials: 'include',
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers,
+            },
+        });
+    };
+}
+/**
+ * Create a configured fetch function for calling your extension's BFF.
+ *
+ * This returns a fetch wrapper that forwards credentials to your BFF,
+ * allowing it to make authenticated calls to the ManageSpace API.
+ *
+ * @param context - The extension context from getContext()
+ * @returns A fetch function configured for BFF calls, or null if no BFF is configured
+ *
+ * @example
+ * ```typescript
+ * import { getContext, createBffFetch } from '@managespace/sdk/extensions';
+ *
+ * const context = await getContext();
+ * const bffFetch = createBffFetch(context);
+ *
+ * if (bffFetch) {
+ *     const response = await bffFetch('/api/enriched-customers');
+ *     const data = await response.json();
+ * }
+ * ```
+ */
+function createBffFetch(context) {
+    if (!context.bffUrl) {
+        return null;
+    }
+    return (path, options = {}) => {
+        const url = `${context.bffUrl}${path}`;
+        return fetch(url, {
+            ...options,
+            credentials: 'include',
+            headers: {
+                'Content-Type': 'application/json',
+                ...options.headers,
+            },
+        });
+    };
+}

package/dist/extensions/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ManageSpace Extension SDK
+ *
+ * This module provides utilities for building extensions that run within
+ * the ManageSpace platform. Extensions are loaded in iframes and communicate
+ * with the host application via postMessage.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *     getContext,
+ *     signalReady,
+ *     navigate,
+ *     showToast,
+ *     createApiFetch,
+ * } from '@managespace/sdk/extensions';
+ *
+ * // Signal ready and get context
+ * signalReady();
+ * const context = await getContext();
+ *
+ * // Create API client
+ * const apiFetch = createApiFetch(context);
+ *
+ * // Fetch data
+ * const response = await apiFetch('/api/crm/customers/queries', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ pageOptions: { offset: 0, limit: 20 } })
+ * });
+ *
+ * // Navigate and show feedback
+ * navigate('/customer/123');
+ * showToast('Customer loaded');
+ * ```
+ *
+ * @module extensions
+ */
+export * from './types';
+export * from './host-bridge';
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/extensions/index.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * ManageSpace Extension SDK
+ *
+ * This module provides utilities for building extensions that run within
+ * the ManageSpace platform. Extensions are loaded in iframes and communicate
+ * with the host application via postMessage.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *     getContext,
+ *     signalReady,
+ *     navigate,
+ *     showToast,
+ *     createApiFetch,
+ * } from '@managespace/sdk/extensions';
+ *
+ * // Signal ready and get context
+ * signalReady();
+ * const context = await getContext();
+ *
+ * // Create API client
+ * const apiFetch = createApiFetch(context);
+ *
+ * // Fetch data
+ * const response = await apiFetch('/api/crm/customers/queries', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ pageOptions: { offset: 0, limit: 20 } })
+ * });
+ *
+ * // Navigate and show feedback
+ * navigate('/customer/123');
+ * showToast('Customer loaded');
+ * ```
+ *
+ * @module extensions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./host-bridge"), exports);

package/dist/extensions/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Extension context injected by the ManageSpace host application.
+ * This is received via postMessage when the extension loads.
+ */
+export interface ExtensionContext {
+    /**
+     * Authentication token for API calls.
+     * Note: When calling the ManageSpace API, use `credentials: 'include'` instead
+     * of passing this token directly. The token is provided for BFF authentication.
+     */
+    token: string;
+    /** The organisation ID the user is currently viewing */
+    orgId: string;
+    /** The authenticated user's ID */
+    userId: string;
+    /** The site ID the user is currently viewing (may be empty if at org level) */
+    siteId: string;
+    /** List of permission strings the user has */
+    permissions: Array<string>;
+    /**
+     * Base URL for ManageSpace API calls.
+     * Example: "http://localhost:5173/gateway"
+     */
+    apiBaseUrl: string;
+    /**
+     * BFF URL from the extension manifest, if configured.
+     * Use this to call your extension's backend.
+     */
+    bffUrl?: string;
+}
+/**
+ * Messages sent from the ManageSpace host to the extension.
+ */
+export type HostMessage = {
+    type: 'CONTEXT_INIT';
+    payload: ExtensionContext;
+} | {
+    type: 'ENTITY_EVENT';
+    payload: {
+        entityType: string;
+        entityId: string;
+        action: 'created' | 'updated' | 'deleted';
+    };
+};
+/**
+ * Messages sent from the extension to the ManageSpace host.
+ */
+export type ExtensionMessage = {
+    type: 'NAVIGATE';
+    payload: {
+        path: string;
+    };
+} | {
+    type: 'SHOW_TOAST';
+    payload: {
+        message: string;
+        variant: 'success' | 'error';
+    };
+} | {
+    type: 'READY';
+};
+/**
+ * Extension manifest format.
+ * This file (manifest.json) must be included in your extension bundle.
+ */
+export interface ExtensionManifest {
+    /** Display name of the extension */
+    name: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Author or company name */
+    author: string;
+    /** Short description of what the extension does */
+    description?: string;
+    /** Label shown in the navigation menu */
+    navLabel: string;
+    /**
+     * Icon name for the navigation menu.
+     * Use Lucide icon names (e.g., "Users", "Settings", "BarChart")
+     */
+    navIcon: string;
+    /**
+     * Route path for the extension (e.g., "/extensions/my-extension").
+     * Must start with "/extensions/"
+     */
+    navRoute: string;
+    /** Entry point HTML file (usually "index.html") */
+    entryPoint: string;
+    /** Optional BFF (Backend for Frontend) configuration */
+    bff?: {
+        /** URL of the BFF server */
+        url: string;
+    };
+}
+/**
+ * Entity event payload received when ManageSpace entities change.
+ * Subscribe to these events to react to changes in the host application.
+ */
+export interface EntityEvent {
+    /** Type of entity (e.g., "customer", "asset", "subscription") */
+    entityType: string;
+    /** ID of the affected entity */
+    entityId: string;
+    /** What happened to the entity */
+    action: 'created' | 'updated' | 'deleted';
+}
+/**
+ * Callback type for entity event handlers.
+ */
+export type EntityEventHandler = (event: EntityEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/extensions/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE3B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACjB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GACnD;IACI,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;KAC7C,CAAC;CACL,CAAC;AAER;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC/C;IACI,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9D,GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,GAAG,CAAC,EAAE;QACF,4BAA4B;QAC5B,GAAG,EAAE,MAAM,CAAC;KACf,CAAC;CACL;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC"}