@netsapiens/horizon-sdk 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -592,7 +592,12 @@ declare class RemoteAppSDK {
     private dynamicColumns;
     private callEventsSubscribed;
     private sidePanelOpen;
-    constructor(eventBus: HorizonEventBus, appId: string);
+    /**
+     * @param webpackModule Your Module Federation container name (the `name` in
+     *   ModuleFederationPlugin, camelCase). The app's `appId` is derived from it
+     *   via {@link deriveAppId} so it matches the host/API registry `id`.
+     */
+    constructor(eventBus: HorizonEventBus, webpackModule: string);
     registerRoute(config: Omit<RouteConfig, "appId">): Promise<void>;
     unregisterRoute(routeId: string): void;
     /**
@@ -639,8 +644,30 @@ declare class RemoteAppSDK {
     getRegisteredDynamicExtensions(): string[];
     getRegisteredDynamicColumns(): string[];
 }
-/** Factory: equivalent to `new RemoteAppSDK(...)`. */
-declare function createRemoteAppSDK(eventBus: HorizonEventBus, appId: string): RemoteAppSDK;
+/**
+ * Factory: equivalent to `new RemoteAppSDK(...)`. Pass your Module Federation
+ * container name (`webpack_module`, camelCase); the appId is derived from it.
+ */
+declare function createRemoteAppSDK(eventBus: HorizonEventBus, webpackModule: string): RemoteAppSDK;
+
+/**
+ * Derive a remote app's stable `appId` (the kebab-case registry `id`) from its
+ * Module Federation container name (`webpack_module`, camelCase).
+ *
+ * This mirrors the derivation the Horizon host and the `/ui-extensions` API use
+ * (`id = kebab(webpack_module)`), so a remote app specifies ONE identifier — the
+ * `name` in its `ModuleFederationPlugin` config — and the SDK, host, and API all
+ * agree on the resulting app id (used for registration attribution, audit, and
+ * the `/ui-extensions/{id}` route).
+ *
+ * Idempotent: an already-kebab value is returned unchanged, so passing either
+ * form works.
+ *
+ * @example
+ * deriveAppId("ucaasExtensionDemo");   // "ucaas-extension-demo"
+ * deriveAppId("ucaas-extension-demo"); // "ucaas-extension-demo" (unchanged)
+ */
+declare function deriveAppId(webpackModule: string): string;
 
 /**
  * Wrap your registered page components with this provider so they receive a
@@ -818,9 +845,15 @@ declare function useSidePanel(eventBus?: HorizonContext["eventBus"], appId?: str
  * Get an SDK instance bound to your app, plus a flat view of the Horizon
  * context. Returned `sdk.cleanup()` is called automatically on unmount.
  *
+ * Pass your **Module Federation container name** — the `name` in your
+ * `ModuleFederationPlugin` config (a.k.a. `webpack_module`, camelCase). That's
+ * the single identifier you maintain; the SDK derives the kebab-case app id
+ * (matching the host/API registry `id`) for you via {@link deriveAppId}.
+ *
  * @example
  * export default function MyApp(horizonContext: HorizonContext) {
- *   const { sdk, user } = useRemoteApp(horizonContext, 'my-app');
+ *   // 'myApp' === the name in your ModuleFederationPlugin config
+ *   const { sdk, user } = useRemoteApp(horizonContext, 'myApp');
  *
  *   useEffect(() => {
  *     sdk.registerDynamicExtension({
@@ -834,7 +867,7 @@ declare function useSidePanel(eventBus?: HorizonContext["eventBus"], appId?: str
  *   return <div>Hello {user.displayName}</div>;
  * }
  */
-declare function useRemoteApp(horizonContext: HorizonContext, appId: string): {
+declare function useRemoteApp(horizonContext: HorizonContext, webpackModule: string): {
     user: HorizonUser;
     auth: HorizonAuth;
     api: HorizonApiClient;
@@ -850,12 +883,12 @@ declare function useRemoteApp(horizonContext: HorizonContext, appId: string): {
 /**
  * Register a route for the lifetime of the calling component.
  */
-declare function useRoute(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<RouteConfig, "appId">): RemoteAppSDK;
+declare function useRoute(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<RouteConfig, "appId">): RemoteAppSDK;
 /**
  * Register a route by pulling its component out of a federated module's
  * webpack container.
  */
-declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], appId: string, routeConfig: Omit<RouteConfig, "appId" | "component">, moduleConfig: RemoteModuleConfig): {
+declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], webpackModule: string, routeConfig: Omit<RouteConfig, "appId" | "component">, moduleConfig: RemoteModuleConfig): {
     loading: boolean;
     error: Error | null;
     sdk: RemoteAppSDK;
@@ -864,7 +897,7 @@ declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], appId:
  * Register a dynamic extension (pattern-based UI injection) for the lifetime
  * of the calling component.
  */
-declare function useDynamicExtension(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<DynamicExtensionConfig, "appId">): RemoteAppSDK;
+declare function useDynamicExtension(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<DynamicExtensionConfig, "appId">): RemoteAppSDK;
 /**
  * Returns the current page context as a typed value.
  *
@@ -892,7 +925,7 @@ declare function usePageContext<T = unknown>(context: ExtensionContext): T | und
 /**
  * Register a dynamic table column for the lifetime of the calling component.
  */
-declare function useDynamicColumn(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<DynamicColumnConfig, "appId">): RemoteAppSDK;
+declare function useDynamicColumn(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<DynamicColumnConfig, "appId">): RemoteAppSDK;
 
 /**
  * Federation Error
@@ -1011,107 +1044,6 @@ declare global {
     }
 }
 
-/**
- * Stable Anchor IDs for Extension Placement
- *
- * These anchor IDs are guaranteed to be stable and can be used by extensions
- * to specify their menu placement using semantic anchors.
- *
- * @example
- * ```typescript
- * import { MANAGE_ANCHORS } from '@netsapiens/horizon-sdk';
- *
- * sdk.registerRoute({
- *   id: 'my-crm',
- *   parentPath: '/apps',
- *   path: 'crm',
- *   label: 'CRM',
- *   placement: { after: MANAGE_ANCHORS.contacts }
- * });
- * ```
- */
-/**
- * Manage Menu Anchors
- * Available in both domain and no-domain contexts
- */
-declare const MANAGE_ANCHORS: {
-    readonly dashboard: "manage-dashboard";
-    readonly users: "manage-users";
-    readonly contacts: "manage-contacts";
-    readonly devices: "manage-devices";
-    readonly phoneNumbers: "manage-phone-numbers";
-    readonly callLogs: "manage-call-logs";
-    readonly voicemail: "manage-voicemail";
-    readonly fax: "manage-fax";
-    readonly settings: "manage-settings";
-};
-/**
- * Platform Menu Anchors
- * Available to Admin, Super User, and Reseller scopes
- */
-declare const PLATFORM_ANCHORS: {
-    readonly dashboard: "platform-dashboard";
-    readonly codeManagement: "platform-code-management";
-    readonly configManagement: "platform-config-management";
-    readonly sdkManagement: "platform-ui-sdk";
-    readonly branding: "platform-branding";
-    readonly recording: "platform-recording";
-    readonly logsAndDiagnostics: "platform-logs-and-diagnostics";
-};
-/**
- * Apps Menu Anchors
- * Extension apps typically register here
- */
-declare const APPS_ANCHORS: {
-    readonly home: "apps-home";
-};
-/**
- * My Account Menu Anchors
- * User-specific settings and preferences
- */
-declare const MY_ACCOUNT_ANCHORS: {
-    readonly profile: "my-account-profile";
-    readonly preferences: "my-account-preferences";
-    readonly security: "my-account-security";
-};
-/**
- * All anchor constants in one object for convenience
- */
-declare const ANCHORS: {
-    readonly manage: {
-        readonly dashboard: "manage-dashboard";
-        readonly users: "manage-users";
-        readonly contacts: "manage-contacts";
-        readonly devices: "manage-devices";
-        readonly phoneNumbers: "manage-phone-numbers";
-        readonly callLogs: "manage-call-logs";
-        readonly voicemail: "manage-voicemail";
-        readonly fax: "manage-fax";
-        readonly settings: "manage-settings";
-    };
-    readonly platform: {
-        readonly dashboard: "platform-dashboard";
-        readonly codeManagement: "platform-code-management";
-        readonly configManagement: "platform-config-management";
-        readonly sdkManagement: "platform-ui-sdk";
-        readonly branding: "platform-branding";
-        readonly recording: "platform-recording";
-        readonly logsAndDiagnostics: "platform-logs-and-diagnostics";
-    };
-    readonly apps: {
-        readonly home: "apps-home";
-    };
-    readonly myAccount: {
-        readonly profile: "my-account-profile";
-        readonly preferences: "my-account-preferences";
-        readonly security: "my-account-security";
-    };
-};
-/**
- * Type-safe anchor ID union
- */
-type AnchorId = (typeof MANAGE_ANCHORS)[keyof typeof MANAGE_ANCHORS] | (typeof PLATFORM_ANCHORS)[keyof typeof PLATFORM_ANCHORS] | (typeof APPS_ANCHORS)[keyof typeof APPS_ANCHORS] | (typeof MY_ACCOUNT_ANCHORS)[keyof typeof MY_ACCOUNT_ANCHORS];
-
 declare const VERSION: string;
 
-export { ANCHORS, APPS_ANCHORS, type AnchorId, type BreadcrumbItem, type CallEvent, type CallEventType, type DynamicColumnConfig, type DynamicColumnDefinition, type DynamicExtensionConfig, type ExtensionComponentProps, type ExtensionContext, type ExtensionZone, type ExtensionZoneId, type FormPanelStep, type HorizonApiClient, type HorizonAuth, type HorizonContext, HorizonContextProvider, type HorizonEventBus, HorizonSDKError, type HorizonSDKErrorCode, type HorizonSDKErrorOptions, type HorizonUI, type HorizonUITemplates, type HorizonUser, MANAGE_ANCHORS, MY_ACCOUNT_ANCHORS, PLATFORM_ANCHORS, RemoteAppSDK, type RemoteAuthError, type RemoteAuthOptions, type RemoteAuthRequest, type RemoteAuthResponse, type RemoteModuleConfig, type RouteConfig, type RoutePattern, type SemanticPlacement, type SidePanelConfig, type SidePanelContentProps, type TableFilterBarContext, type ThemeTokens, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };
+export { type BreadcrumbItem, type CallEvent, type CallEventType, type DynamicColumnConfig, type DynamicColumnDefinition, type DynamicExtensionConfig, type ExtensionComponentProps, type ExtensionContext, type ExtensionZone, type ExtensionZoneId, type FormPanelStep, type HorizonApiClient, type HorizonAuth, type HorizonContext, HorizonContextProvider, type HorizonEventBus, HorizonSDKError, type HorizonSDKErrorCode, type HorizonSDKErrorOptions, type HorizonUI, type HorizonUITemplates, type HorizonUser, RemoteAppSDK, type RemoteAuthError, type RemoteAuthOptions, type RemoteAuthRequest, type RemoteAuthResponse, type RemoteModuleConfig, type RouteConfig, type RoutePattern, type SemanticPlacement, type SidePanelConfig, type SidePanelContentProps, type TableFilterBarContext, type ThemeTokens, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, deriveAppId, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };

package/dist/index.d.ts

@@ -592,7 +592,12 @@ declare class RemoteAppSDK {
     private dynamicColumns;
     private callEventsSubscribed;
     private sidePanelOpen;
-    constructor(eventBus: HorizonEventBus, appId: string);
+    /**
+     * @param webpackModule Your Module Federation container name (the `name` in
+     *   ModuleFederationPlugin, camelCase). The app's `appId` is derived from it
+     *   via {@link deriveAppId} so it matches the host/API registry `id`.
+     */
+    constructor(eventBus: HorizonEventBus, webpackModule: string);
     registerRoute(config: Omit<RouteConfig, "appId">): Promise<void>;
     unregisterRoute(routeId: string): void;
     /**
@@ -639,8 +644,30 @@ declare class RemoteAppSDK {
     getRegisteredDynamicExtensions(): string[];
     getRegisteredDynamicColumns(): string[];
 }
-/** Factory: equivalent to `new RemoteAppSDK(...)`. */
-declare function createRemoteAppSDK(eventBus: HorizonEventBus, appId: string): RemoteAppSDK;
+/**
+ * Factory: equivalent to `new RemoteAppSDK(...)`. Pass your Module Federation
+ * container name (`webpack_module`, camelCase); the appId is derived from it.
+ */
+declare function createRemoteAppSDK(eventBus: HorizonEventBus, webpackModule: string): RemoteAppSDK;
+
+/**
+ * Derive a remote app's stable `appId` (the kebab-case registry `id`) from its
+ * Module Federation container name (`webpack_module`, camelCase).
+ *
+ * This mirrors the derivation the Horizon host and the `/ui-extensions` API use
+ * (`id = kebab(webpack_module)`), so a remote app specifies ONE identifier — the
+ * `name` in its `ModuleFederationPlugin` config — and the SDK, host, and API all
+ * agree on the resulting app id (used for registration attribution, audit, and
+ * the `/ui-extensions/{id}` route).
+ *
+ * Idempotent: an already-kebab value is returned unchanged, so passing either
+ * form works.
+ *
+ * @example
+ * deriveAppId("ucaasExtensionDemo");   // "ucaas-extension-demo"
+ * deriveAppId("ucaas-extension-demo"); // "ucaas-extension-demo" (unchanged)
+ */
+declare function deriveAppId(webpackModule: string): string;
 
 /**
  * Wrap your registered page components with this provider so they receive a
@@ -818,9 +845,15 @@ declare function useSidePanel(eventBus?: HorizonContext["eventBus"], appId?: str
  * Get an SDK instance bound to your app, plus a flat view of the Horizon
  * context. Returned `sdk.cleanup()` is called automatically on unmount.
  *
+ * Pass your **Module Federation container name** — the `name` in your
+ * `ModuleFederationPlugin` config (a.k.a. `webpack_module`, camelCase). That's
+ * the single identifier you maintain; the SDK derives the kebab-case app id
+ * (matching the host/API registry `id`) for you via {@link deriveAppId}.
+ *
  * @example
  * export default function MyApp(horizonContext: HorizonContext) {
- *   const { sdk, user } = useRemoteApp(horizonContext, 'my-app');
+ *   // 'myApp' === the name in your ModuleFederationPlugin config
+ *   const { sdk, user } = useRemoteApp(horizonContext, 'myApp');
  *
  *   useEffect(() => {
  *     sdk.registerDynamicExtension({
@@ -834,7 +867,7 @@ declare function useSidePanel(eventBus?: HorizonContext["eventBus"], appId?: str
  *   return <div>Hello {user.displayName}</div>;
  * }
  */
-declare function useRemoteApp(horizonContext: HorizonContext, appId: string): {
+declare function useRemoteApp(horizonContext: HorizonContext, webpackModule: string): {
     user: HorizonUser;
     auth: HorizonAuth;
     api: HorizonApiClient;
@@ -850,12 +883,12 @@ declare function useRemoteApp(horizonContext: HorizonContext, appId: string): {
 /**
  * Register a route for the lifetime of the calling component.
  */
-declare function useRoute(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<RouteConfig, "appId">): RemoteAppSDK;
+declare function useRoute(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<RouteConfig, "appId">): RemoteAppSDK;
 /**
  * Register a route by pulling its component out of a federated module's
  * webpack container.
  */
-declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], appId: string, routeConfig: Omit<RouteConfig, "appId" | "component">, moduleConfig: RemoteModuleConfig): {
+declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], webpackModule: string, routeConfig: Omit<RouteConfig, "appId" | "component">, moduleConfig: RemoteModuleConfig): {
     loading: boolean;
     error: Error | null;
     sdk: RemoteAppSDK;
@@ -864,7 +897,7 @@ declare function useRouteFromModule(eventBus: HorizonContext["eventBus"], appId:
  * Register a dynamic extension (pattern-based UI injection) for the lifetime
  * of the calling component.
  */
-declare function useDynamicExtension(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<DynamicExtensionConfig, "appId">): RemoteAppSDK;
+declare function useDynamicExtension(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<DynamicExtensionConfig, "appId">): RemoteAppSDK;
 /**
  * Returns the current page context as a typed value.
  *
@@ -892,7 +925,7 @@ declare function usePageContext<T = unknown>(context: ExtensionContext): T | und
 /**
  * Register a dynamic table column for the lifetime of the calling component.
  */
-declare function useDynamicColumn(eventBus: HorizonContext["eventBus"], appId: string, config: Omit<DynamicColumnConfig, "appId">): RemoteAppSDK;
+declare function useDynamicColumn(eventBus: HorizonContext["eventBus"], webpackModule: string, config: Omit<DynamicColumnConfig, "appId">): RemoteAppSDK;
 
 /**
  * Federation Error
@@ -1011,107 +1044,6 @@ declare global {
     }
 }
 
-/**
- * Stable Anchor IDs for Extension Placement
- *
- * These anchor IDs are guaranteed to be stable and can be used by extensions
- * to specify their menu placement using semantic anchors.
- *
- * @example
- * ```typescript
- * import { MANAGE_ANCHORS } from '@netsapiens/horizon-sdk';
- *
- * sdk.registerRoute({
- *   id: 'my-crm',
- *   parentPath: '/apps',
- *   path: 'crm',
- *   label: 'CRM',
- *   placement: { after: MANAGE_ANCHORS.contacts }
- * });
- * ```
- */
-/**
- * Manage Menu Anchors
- * Available in both domain and no-domain contexts
- */
-declare const MANAGE_ANCHORS: {
-    readonly dashboard: "manage-dashboard";
-    readonly users: "manage-users";
-    readonly contacts: "manage-contacts";
-    readonly devices: "manage-devices";
-    readonly phoneNumbers: "manage-phone-numbers";
-    readonly callLogs: "manage-call-logs";
-    readonly voicemail: "manage-voicemail";
-    readonly fax: "manage-fax";
-    readonly settings: "manage-settings";
-};
-/**
- * Platform Menu Anchors
- * Available to Admin, Super User, and Reseller scopes
- */
-declare const PLATFORM_ANCHORS: {
-    readonly dashboard: "platform-dashboard";
-    readonly codeManagement: "platform-code-management";
-    readonly configManagement: "platform-config-management";
-    readonly sdkManagement: "platform-ui-sdk";
-    readonly branding: "platform-branding";
-    readonly recording: "platform-recording";
-    readonly logsAndDiagnostics: "platform-logs-and-diagnostics";
-};
-/**
- * Apps Menu Anchors
- * Extension apps typically register here
- */
-declare const APPS_ANCHORS: {
-    readonly home: "apps-home";
-};
-/**
- * My Account Menu Anchors
- * User-specific settings and preferences
- */
-declare const MY_ACCOUNT_ANCHORS: {
-    readonly profile: "my-account-profile";
-    readonly preferences: "my-account-preferences";
-    readonly security: "my-account-security";
-};
-/**
- * All anchor constants in one object for convenience
- */
-declare const ANCHORS: {
-    readonly manage: {
-        readonly dashboard: "manage-dashboard";
-        readonly users: "manage-users";
-        readonly contacts: "manage-contacts";
-        readonly devices: "manage-devices";
-        readonly phoneNumbers: "manage-phone-numbers";
-        readonly callLogs: "manage-call-logs";
-        readonly voicemail: "manage-voicemail";
-        readonly fax: "manage-fax";
-        readonly settings: "manage-settings";
-    };
-    readonly platform: {
-        readonly dashboard: "platform-dashboard";
-        readonly codeManagement: "platform-code-management";
-        readonly configManagement: "platform-config-management";
-        readonly sdkManagement: "platform-ui-sdk";
-        readonly branding: "platform-branding";
-        readonly recording: "platform-recording";
-        readonly logsAndDiagnostics: "platform-logs-and-diagnostics";
-    };
-    readonly apps: {
-        readonly home: "apps-home";
-    };
-    readonly myAccount: {
-        readonly profile: "my-account-profile";
-        readonly preferences: "my-account-preferences";
-        readonly security: "my-account-security";
-    };
-};
-/**
- * Type-safe anchor ID union
- */
-type AnchorId = (typeof MANAGE_ANCHORS)[keyof typeof MANAGE_ANCHORS] | (typeof PLATFORM_ANCHORS)[keyof typeof PLATFORM_ANCHORS] | (typeof APPS_ANCHORS)[keyof typeof APPS_ANCHORS] | (typeof MY_ACCOUNT_ANCHORS)[keyof typeof MY_ACCOUNT_ANCHORS];
-
 declare const VERSION: string;
 
-export { ANCHORS, APPS_ANCHORS, type AnchorId, type BreadcrumbItem, type CallEvent, type CallEventType, type DynamicColumnConfig, type DynamicColumnDefinition, type DynamicExtensionConfig, type ExtensionComponentProps, type ExtensionContext, type ExtensionZone, type ExtensionZoneId, type FormPanelStep, type HorizonApiClient, type HorizonAuth, type HorizonContext, HorizonContextProvider, type HorizonEventBus, HorizonSDKError, type HorizonSDKErrorCode, type HorizonSDKErrorOptions, type HorizonUI, type HorizonUITemplates, type HorizonUser, MANAGE_ANCHORS, MY_ACCOUNT_ANCHORS, PLATFORM_ANCHORS, RemoteAppSDK, type RemoteAuthError, type RemoteAuthOptions, type RemoteAuthRequest, type RemoteAuthResponse, type RemoteModuleConfig, type RouteConfig, type RoutePattern, type SemanticPlacement, type SidePanelConfig, type SidePanelContentProps, type TableFilterBarContext, type ThemeTokens, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };
+export { type BreadcrumbItem, type CallEvent, type CallEventType, type DynamicColumnConfig, type DynamicColumnDefinition, type DynamicExtensionConfig, type ExtensionComponentProps, type ExtensionContext, type ExtensionZone, type ExtensionZoneId, type FormPanelStep, type HorizonApiClient, type HorizonAuth, type HorizonContext, HorizonContextProvider, type HorizonEventBus, HorizonSDKError, type HorizonSDKErrorCode, type HorizonSDKErrorOptions, type HorizonUI, type HorizonUITemplates, type HorizonUser, RemoteAppSDK, type RemoteAuthError, type RemoteAuthOptions, type RemoteAuthRequest, type RemoteAuthResponse, type RemoteModuleConfig, type RouteConfig, type RoutePattern, type SemanticPlacement, type SidePanelConfig, type SidePanelContentProps, type TableFilterBarContext, type ThemeTokens, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, deriveAppId, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };

package/dist/index.js

@@ -32,6 +32,11 @@ if (typeof window !== "undefined") {
   }
 }
 
+// src/appId.ts
+function deriveAppId(webpackModule) {
+  return webpackModule.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
 // src/RemoteAppSDK.ts
 var log = createLogger("RemoteAppSDK");
 var RemoteAppSDK = class {
@@ -45,10 +50,15 @@ var RemoteAppSDK = class {
   dynamicColumns = /* @__PURE__ */ new Set();
   callEventsSubscribed = false;
   sidePanelOpen = false;
-  constructor(eventBus, appId) {
+  /**
+   * @param webpackModule Your Module Federation container name (the `name` in
+   *   ModuleFederationPlugin, camelCase). The app's `appId` is derived from it
+   *   via {@link deriveAppId} so it matches the host/API registry `id`.
+   */
+  constructor(eventBus, webpackModule) {
     this.eventBus = eventBus;
-    this.appId = appId;
-    log.debug(`Initialized for app: ${appId}`);
+    this.appId = deriveAppId(webpackModule);
+    log.debug(`Initialized for app: ${this.appId}`);
   }
   // -------------------------------------------------------------------------
   // Routes
@@ -207,8 +217,8 @@ var RemoteAppSDK = class {
     return Array.from(this.dynamicColumns);
   }
 };
-function createRemoteAppSDK(eventBus, appId) {
-  return new RemoteAppSDK(eventBus, appId);
+function createRemoteAppSDK(eventBus, webpackModule) {
+  return new RemoteAppSDK(eventBus, webpackModule);
 }
 var HorizonContextReact = createContext(null);
 function HorizonContextProvider({
@@ -297,18 +307,18 @@ function useSidePanel(eventBus, appId) {
     [bus, appId]
   );
 }
-function useRemoteApp(horizonContext, appId) {
+function useRemoteApp(horizonContext, webpackModule) {
   const sdkRef = useRef(null);
   if (!sdkRef.current) {
-    sdkRef.current = createRemoteAppSDK(horizonContext.eventBus, appId);
+    sdkRef.current = createRemoteAppSDK(horizonContext.eventBus, webpackModule);
   }
   const sdk = sdkRef.current;
   return { sdk, ...horizonContext };
 }
-function useRoute(eventBus, appId, config) {
+function useRoute(eventBus, webpackModule, config) {
   const sdk = useMemo(
-    () => createRemoteAppSDK(eventBus, appId),
-    [eventBus, appId]
+    () => createRemoteAppSDK(eventBus, webpackModule),
+    [eventBus, webpackModule]
   );
   useEffect(() => {
     void sdk.registerRoute(config);
@@ -316,10 +326,10 @@ function useRoute(eventBus, appId, config) {
   }, [sdk, config]);
   return sdk;
 }
-function useRouteFromModule(eventBus, appId, routeConfig, moduleConfig) {
+function useRouteFromModule(eventBus, webpackModule, routeConfig, moduleConfig) {
   const sdk = useMemo(
-    () => createRemoteAppSDK(eventBus, appId),
-    [eventBus, appId]
+    () => createRemoteAppSDK(eventBus, webpackModule),
+    [eventBus, webpackModule]
   );
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState(null);
@@ -340,10 +350,10 @@ function useRouteFromModule(eventBus, appId, routeConfig, moduleConfig) {
   }, [sdk, moduleConfig, routeConfig]);
   return { loading, error, sdk };
 }
-function useDynamicExtension(eventBus, appId, config) {
+function useDynamicExtension(eventBus, webpackModule, config) {
   const sdk = useMemo(
-    () => createRemoteAppSDK(eventBus, appId),
-    [eventBus, appId]
+    () => createRemoteAppSDK(eventBus, webpackModule),
+    [eventBus, webpackModule]
   );
   useEffect(() => {
     sdk.registerDynamicExtension(config);
@@ -354,10 +364,10 @@ function useDynamicExtension(eventBus, appId, config) {
 function usePageContext(context) {
   return context.pageContext;
 }
-function useDynamicColumn(eventBus, appId, config) {
+function useDynamicColumn(eventBus, webpackModule, config) {
   const sdk = useMemo(
-    () => createRemoteAppSDK(eventBus, appId),
-    [eventBus, appId]
+    () => createRemoteAppSDK(eventBus, webpackModule),
+    [eventBus, webpackModule]
   );
   useEffect(() => {
     sdk.registerDynamicColumn(config);
@@ -506,51 +516,15 @@ function moduleLoadError(appId, url, cause) {
   });
 }
 
-// src/anchors.ts
-var MANAGE_ANCHORS = {
-  dashboard: "manage-dashboard",
-  users: "manage-users",
-  contacts: "manage-contacts",
-  devices: "manage-devices",
-  phoneNumbers: "manage-phone-numbers",
-  callLogs: "manage-call-logs",
-  voicemail: "manage-voicemail",
-  fax: "manage-fax",
-  settings: "manage-settings"
-};
-var PLATFORM_ANCHORS = {
-  dashboard: "platform-dashboard",
-  codeManagement: "platform-code-management",
-  configManagement: "platform-config-management",
-  sdkManagement: "platform-ui-sdk",
-  branding: "platform-branding",
-  recording: "platform-recording",
-  logsAndDiagnostics: "platform-logs-and-diagnostics"
-};
-var APPS_ANCHORS = {
-  home: "apps-home"
-};
-var MY_ACCOUNT_ANCHORS = {
-  profile: "my-account-profile",
-  preferences: "my-account-preferences",
-  security: "my-account-security"
-};
-var ANCHORS = {
-  manage: MANAGE_ANCHORS,
-  platform: PLATFORM_ANCHORS,
-  apps: APPS_ANCHORS,
-  myAccount: MY_ACCOUNT_ANCHORS
-};
-
 // package.json
 var package_default = {
-  version: "0.1.5"};
+  version: "0.1.7"};
 
 // src/index.ts
 var VERSION = package_default.version;
 var log2 = createLogger("FederationSDK");
 log2.info(`SDK v${VERSION} loaded`);
 
-export { ANCHORS, APPS_ANCHORS, HorizonContextProvider, HorizonSDKError, MANAGE_ANCHORS, MY_ACCOUNT_ANCHORS, PLATFORM_ANCHORS, RemoteAppSDK, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };
+export { HorizonContextProvider, HorizonSDKError, RemoteAppSDK, VERSION, apiError, createHorizonSDKError, createLogger, createRemoteAppSDK, deriveAppId, getLogLevel, invalidExtensionPointError, moduleLoadError, permissionDeniedError, rateLimitError, setLogLevel, signatureVerificationError, useDynamicColumn, useDynamicExtension, useHorizonContext, useLocale, usePageContext, useRemoteApp, useRoute, useRouteFromModule, useSidePanel, useTheme };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map