@nominalso/vibe-host 0.0.1

package/dist/index.js

@@ -0,0 +1,657 @@
+// package.json
+var version = "0.0.1";
+
+// ../protocol-types/dist/index.js
+var PROTOCOL_ID = "nominal-vibe-bridge";
+var PROTOCOL_VERSION = 1;
+var BRIDGE_KINDS = ["request", "response", "push", "command", "progress"];
+var CORRELATED_KINDS = ["request", "response", "progress"];
+var BRIDGE_KINDS_SET = new Set(BRIDGE_KINDS);
+var CORRELATED_KINDS_SET = new Set(CORRELATED_KINDS);
+function isBridgeMessage(data) {
+  if (typeof data !== "object" || data === null) return false;
+  const d = data;
+  if (d.__protocol !== PROTOCOL_ID) return false;
+  if (d.__version !== PROTOCOL_VERSION) return false;
+  if (typeof d.kind !== "string" || !BRIDGE_KINDS_SET.has(d.kind)) return false;
+  if (typeof d.type !== "string") return false;
+  if (CORRELATED_KINDS_SET.has(d.kind) && typeof d.requestId !== "string") return false;
+  return true;
+}
+
+// ../api-client/dist/index.js
+import {
+  createClient,
+  createConfig
+} from "@hey-api/client-fetch";
+import { createClient as createClient2, createConfig as createConfig2 } from "@hey-api/client-fetch";
+var client = createClient(createConfig());
+var getAccountsApiAccountingAccountGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/accounting/account",
+    ...options
+  });
+};
+var getAccountApiAccountingAccountAccountIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/account/{account_id}",
+    ...options
+  });
+};
+var getCoaTreeApiAccountingSubsidiarySubsidiaryIdCoaGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa",
+    ...options
+  });
+};
+var getCoaFlatApiAccountingSubsidiarySubsidiaryIdCoaAccountGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa/account",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getSubsidiaryAvailableCurrenciesApiAccountingSubsidiarySubsidiaryIdCoaAvailableCurrenciesGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa/available-currencies",
+    ...options
+  });
+};
+var getCoaFlatSimpleApiAccountingSubsidiarySubsidiaryIdCoaAccountSimpleGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa/account/simple",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getGroupedCoaFlatApiAccountingSubsidiarySubsidiaryIdCoaAccountGroupGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa/account/group",
+    ...options
+  });
+};
+var getAccountByIdApiAccountingSubsidiarySubsidiaryIdCoaAccountAccountIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/coa/account/{account_id}",
+    ...options
+  });
+};
+var getConversionRateApiAccountingCurrencyCurrencyConversionRatesGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/currency/{currency}/conversion-rates",
+    ...options
+  });
+};
+var getSubsidiaryJournalLinesApiAccountingSubsidiarySubsidiaryIdJournalEntryLinesGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/journal-entry/lines",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getSubsidiaryJournalApiAccountingSubsidiarySubsidiaryIdJournalEntryGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/journal-entry",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getJournalEntryApiAccountingSubsidiarySubsidiaryIdJournalEntryJournalEntryIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/subsidiary/{subsidiary_id}/journal-entry/{journal_entry_id}",
+    ...options
+  });
+};
+var getDimensionsApiAccountingDimensionGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/accounting/dimension",
+    ...options
+  });
+};
+var getAccountDimensionAssignmentsForDimensionApiAccountingDimensionDimensionIdAccountAccountIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/dimension/{dimension_id}/account/{account_id}",
+    ...options
+  });
+};
+var getDimensionValuesApiAccountingDimensionValueGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/accounting/dimension-value",
+    ...options
+  });
+};
+var getDimensionValuesHierarchicalApiAccountingDimensionValueHierarchicalGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/accounting/dimension-value/hierarchical",
+    ...options
+  });
+};
+var getEffectiveExchangeRateApiAccountingConsolidationExchangeRateGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/accounting/consolidation-exchange-rate",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getPeriodByDateApiAccountingConsolidationExchangeRatePeriodInputDateGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/accounting/consolidation-exchange-rate/period/{input_date}",
+    ...options
+  });
+};
+var getActivityDefinitionsApiActivityActivityDefinitionGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/activity/activity-definition",
+    ...options
+  });
+};
+var getActivityDefinitionByIdApiActivityActivityDefinitionActivityDefinitionIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/activity-definition/{activity_definition_id}",
+    ...options
+  });
+};
+var getPeriodInstancesApiActivityPeriodInstanceGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/activity/period-instance",
+    ...options
+  });
+};
+var getPeriodInstanceApiActivityPeriodInstancePeriodInstanceIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/period-instance/{period_instance_id}",
+    ...options
+  });
+};
+var getPeriodInstanceBySlugApiActivityPeriodInstanceBySlugPeriodDisplayIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/period-instance/by-slug/{period_display_id}",
+    ...options
+  });
+};
+var getPeriodInstanceProgressBreakdownBySlugApiActivityPeriodInstanceBySlugPeriodDisplayIdProgressBreakdownGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/period-instance/by-slug/{period_display_id}/progress-breakdown",
+    ...options
+  });
+};
+var getAllTasksDefinitionsApiActivityTaskDefinitionGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/activity/task-definition",
+    ...options
+  });
+};
+var createTaskDefinitionApiActivityTaskDefinitionPost = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/activity/task-definition",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getAllTasksDefinitionsByFilterApiActivityTaskDefinitionQueryPost = (options) => {
+  return (options?.client ?? client).post({
+    url: "/api/activity/task-definition/query",
+    ...options
+  });
+};
+var getTaskDefinitionByIdApiActivityTaskDefinitionTaskDefinitionIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/task-definition/{task_definition_id}",
+    ...options
+  });
+};
+var updateTaskDefinitionApiActivityTaskDefinitionTaskDefinitionIdPut = (options) => {
+  return (options.client ?? client).put({
+    url: "/api/activity/task-definition/{task_definition_id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getActivityInstanceApiActivityActivityInstanceActivityInstanceIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/activity-instance/{activity_instance_id}",
+    ...options
+  });
+};
+var getTaskInstancesByActivityApiActivityActivityInstanceActivityInstanceIdTaskGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/activity-instance/{activity_instance_id}/task",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getActivityInstancesApiActivityActivityInstanceGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/activity/activity-instance",
+    ...options
+  });
+};
+var getActivityInstanceByPeriodApiActivityActivityInstanceByPeriodPeriodDisplayIdActivityDefinitionIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/activity-instance/by-period/{period_display_id}/{activity_definition_id}",
+    ...options
+  });
+};
+var getTaskInstancesByActivityPeriodApiActivityActivityInstanceByPeriodPeriodDisplayIdActivityDefinitionIdTaskGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/activity-instance/by-period/{period_display_id}/{activity_definition_id}/task",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getAllTaskInstancesApiActivityTaskInstanceGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/activity/task-instance",
+    ...options
+  });
+};
+var getAllTaskInstancesByFilterApiActivityTaskInstanceQueryPost = (options) => {
+  return (options?.client ?? client).post({
+    url: "/api/activity/task-instance/query",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getTaskInstanceByIdApiActivityTaskInstanceTaskInstanceIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/activity/task-instance/{task_instance_id}",
+    ...options
+  });
+};
+var updateTaskInstanceApiActivityTaskInstanceTaskInstanceIdPut = (options) => {
+  return (options.client ?? client).put({
+    url: "/api/activity/task-instance/{task_instance_id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getEventsApiAuditTrailEventGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/audit-trail/event",
+    ...options
+  });
+};
+var getEntityEventsApiAuditTrailEventEntityTargetTypeTargetIdPost = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/audit-trail/event/entity/{target_type}/{target_id}",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getFiscalCalendarsBySubsidiaryApiPeriodManagerFiscalCalendarBySubsidiarySubsidiaryIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/period-manager/fiscal-calendar/by-subsidiary/{subsidiary_id}",
+    ...options
+  });
+};
+var getFiscalCalendarByIdApiPeriodManagerFiscalCalendarCalendarIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/period-manager/fiscal-calendar/{calendar_id}",
+    ...options
+  });
+};
+var getTenantUsersApiTenancyTenantTenantIdOrNameUsersGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/tenancy/tenant/{tenant_id_or_name}/users",
+    ...options
+  });
+};
+var getAllSubsidiariesApiTenancySubsidiaryGet = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/tenancy/subsidiary",
+    ...options
+  });
+};
+var getSubsidiaryApiTenancySubsidiarySubsidiaryIdGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/tenancy/subsidiary/{subsidiary_id}",
+    ...options
+  });
+};
+var getSubsidiaryParentCurrenciesApiTenancySubsidiarySubsidiaryIdParentCurrenciesGet = (options) => {
+  return (options.client ?? client).get({
+    url: "/api/tenancy/subsidiary/{subsidiary_id}/parent-currencies",
+    ...options
+  });
+};
+function createVibeApiClient({ baseUrl, stripApiPrefix }) {
+  const client2 = createClient2(createConfig2({ baseUrl }));
+  client2.interceptors.request.use((request) => {
+    console.log("[vibe-api-client] request url:", request.url);
+    return request;
+  });
+  if (stripApiPrefix) {
+    client2.interceptors.request.use(
+      (request) => new Request(request.url.replace(`${baseUrl}/api/`, `${baseUrl}/`), request)
+    );
+  }
+  return client2;
+}
+
+// src/handlerMap.ts
+async function call(fn, payload, client2) {
+  const { data } = await fn({ ...payload, client: client2 });
+  if (data == null) throw new Error("API returned no data");
+  return data;
+}
+function createHandlerMap(options) {
+  const client2 = createVibeApiClient(options);
+  return {
+    // Accounting — chart of accounts
+    GET_CHART_OF_ACCOUNTS: (p) => call(getCoaFlatApiAccountingSubsidiarySubsidiaryIdCoaAccountGet, p, client2),
+    GET_COA_TREE: (p) => call(getCoaTreeApiAccountingSubsidiarySubsidiaryIdCoaGet, p, client2),
+    GET_COA_FLAT_SIMPLE: (p) => call(
+      getCoaFlatSimpleApiAccountingSubsidiarySubsidiaryIdCoaAccountSimpleGet,
+      p,
+      client2
+    ),
+    GET_COA_GROUPED: (p) => call(
+      getGroupedCoaFlatApiAccountingSubsidiarySubsidiaryIdCoaAccountGroupGet,
+      p,
+      client2
+    ),
+    GET_COA_ACCOUNT: (p) => call(
+      getAccountByIdApiAccountingSubsidiarySubsidiaryIdCoaAccountAccountIdGet,
+      p,
+      client2
+    ),
+    GET_SUBSIDIARY_AVAILABLE_CURRENCIES: (p) => call(
+      getSubsidiaryAvailableCurrenciesApiAccountingSubsidiarySubsidiaryIdCoaAvailableCurrenciesGet,
+      p,
+      client2
+    ),
+    GET_ACCOUNTS: (p) => call(getAccountsApiAccountingAccountGet, p, client2),
+    GET_ACCOUNT: (p) => call(getAccountApiAccountingAccountAccountIdGet, p, client2),
+    // Accounting — exchange rates
+    GET_CONVERSION_RATES: (p) => call(getConversionRateApiAccountingCurrencyCurrencyConversionRatesGet, p, client2),
+    GET_EFFECTIVE_EXCHANGE_RATE: (p) => call(getEffectiveExchangeRateApiAccountingConsolidationExchangeRateGet, p, client2),
+    GET_EXCHANGE_RATE_BY_DATE: (p) => call(
+      getPeriodByDateApiAccountingConsolidationExchangeRatePeriodInputDateGet,
+      p,
+      client2
+    ),
+    // Accounting — dimensions
+    GET_DIMENSIONS: (p) => call(getDimensionsApiAccountingDimensionGet, p, client2),
+    GET_DIMENSION_VALUES: (p) => call(getDimensionValuesApiAccountingDimensionValueGet, p, client2),
+    GET_DIMENSION_VALUES_HIERARCHICAL: (p) => call(
+      getDimensionValuesHierarchicalApiAccountingDimensionValueHierarchicalGet,
+      p,
+      client2
+    ),
+    GET_DIMENSION_ACCOUNT_ASSIGNMENTS: (p) => call(
+      getAccountDimensionAssignmentsForDimensionApiAccountingDimensionDimensionIdAccountAccountIdGet,
+      p,
+      client2
+    ),
+    // Accounting — journal entries
+    GET_JOURNAL_ENTRIES: (p) => call(
+      getSubsidiaryJournalApiAccountingSubsidiarySubsidiaryIdJournalEntryGet,
+      p,
+      client2
+    ),
+    GET_JOURNAL_LINES: (p) => call(
+      getSubsidiaryJournalLinesApiAccountingSubsidiarySubsidiaryIdJournalEntryLinesGet,
+      p,
+      client2
+    ),
+    GET_JOURNAL_ENTRY: (p) => call(
+      getJournalEntryApiAccountingSubsidiarySubsidiaryIdJournalEntryJournalEntryIdGet,
+      p,
+      client2
+    ),
+    // Activity — period instances
+    GET_PERIODS: (p) => call(getPeriodInstancesApiActivityPeriodInstanceGet, p, client2),
+    GET_PERIOD_INSTANCE: (p) => call(getPeriodInstanceApiActivityPeriodInstancePeriodInstanceIdGet, p, client2),
+    GET_PERIOD_INSTANCE_BY_SLUG: (p) => call(
+      getPeriodInstanceBySlugApiActivityPeriodInstanceBySlugPeriodDisplayIdGet,
+      p,
+      client2
+    ),
+    GET_PERIOD_PROGRESS_BREAKDOWN: (p) => call(
+      getPeriodInstanceProgressBreakdownBySlugApiActivityPeriodInstanceBySlugPeriodDisplayIdProgressBreakdownGet,
+      p,
+      client2
+    ),
+    // Activity — activity definitions
+    GET_ACTIVITY_DEFINITIONS: (p) => call(getActivityDefinitionsApiActivityActivityDefinitionGet, p, client2),
+    GET_ACTIVITY_DEFINITION: (p) => call(
+      getActivityDefinitionByIdApiActivityActivityDefinitionActivityDefinitionIdGet,
+      p,
+      client2
+    ),
+    // Activity — activity instances
+    GET_ACTIVITY_INSTANCES: (p) => call(getActivityInstancesApiActivityActivityInstanceGet, p, client2),
+    GET_ACTIVITY_INSTANCE: (p) => call(getActivityInstanceApiActivityActivityInstanceActivityInstanceIdGet, p, client2),
+    GET_ACTIVITY_INSTANCE_BY_PERIOD: (p) => call(
+      getActivityInstanceByPeriodApiActivityActivityInstanceByPeriodPeriodDisplayIdActivityDefinitionIdGet,
+      p,
+      client2
+    ),
+    GET_ACTIVITY_INSTANCE_TASKS: (p) => call(
+      getTaskInstancesByActivityApiActivityActivityInstanceActivityInstanceIdTaskGet,
+      p,
+      client2
+    ),
+    GET_ACTIVITY_PERIOD_TASKS: (p) => call(
+      getTaskInstancesByActivityPeriodApiActivityActivityInstanceByPeriodPeriodDisplayIdActivityDefinitionIdTaskGet,
+      p,
+      client2
+    ),
+    // Activity — task definitions
+    GET_TASK_DEFINITIONS: (p) => call(getAllTasksDefinitionsApiActivityTaskDefinitionGet, p, client2),
+    GET_TASK_DEFINITION: (p) => call(getTaskDefinitionByIdApiActivityTaskDefinitionTaskDefinitionIdGet, p, client2),
+    CREATE_TASK_DEFINITION: (p) => call(createTaskDefinitionApiActivityTaskDefinitionPost, p, client2),
+    UPDATE_TASK_DEFINITION: (p) => call(updateTaskDefinitionApiActivityTaskDefinitionTaskDefinitionIdPut, p, client2),
+    GET_TASK_DEFINITIONS_BY_FILTER: (p) => call(getAllTasksDefinitionsByFilterApiActivityTaskDefinitionQueryPost, p, client2),
+    // Activity — task instances
+    GET_TASK_INSTANCES: (p) => call(getAllTaskInstancesApiActivityTaskInstanceGet, p, client2),
+    GET_TASK_INSTANCE: (p) => call(getTaskInstanceByIdApiActivityTaskInstanceTaskInstanceIdGet, p, client2),
+    POST_TASK_OUTPUT: (p) => call(updateTaskInstanceApiActivityTaskInstanceTaskInstanceIdPut, p, client2),
+    GET_TASK_INSTANCES_BY_FILTER: (p) => call(getAllTaskInstancesByFilterApiActivityTaskInstanceQueryPost, p, client2),
+    // Audit trail
+    GET_AUDIT_EVENTS: (p) => call(getEventsApiAuditTrailEventGet, p, client2),
+    GET_ENTITY_AUDIT_EVENTS: (p) => call(getEntityEventsApiAuditTrailEventEntityTargetTypeTargetIdPost, p, client2),
+    // Period manager
+    GET_FISCAL_CALENDARS: (p) => call(
+      getFiscalCalendarsBySubsidiaryApiPeriodManagerFiscalCalendarBySubsidiarySubsidiaryIdGet,
+      p,
+      client2
+    ),
+    GET_FISCAL_CALENDAR: (p) => call(getFiscalCalendarByIdApiPeriodManagerFiscalCalendarCalendarIdGet, p, client2),
+    // Tenancy
+    GET_SUBSIDIARIES: (p) => call(getAllSubsidiariesApiTenancySubsidiaryGet, p, client2),
+    GET_SUBSIDIARY: (p) => call(getSubsidiaryApiTenancySubsidiarySubsidiaryIdGet, p, client2),
+    GET_SUBSIDIARY_PARENT_CURRENCIES: (p) => call(
+      getSubsidiaryParentCurrenciesApiTenancySubsidiarySubsidiaryIdParentCurrenciesGet,
+      p,
+      client2
+    ),
+    GET_TENANT_USERS: (p) => call(getTenantUsersApiTenancyTenantTenantIdOrNameUsersGet, p, client2)
+  };
+}
+
+// src/uploadHandler.ts
+async function uploadHandler(payload, sendProgress) {
+  const attachmentId = crypto.randomUUID();
+  for (const progress of [25, 50, 75, 100]) {
+    await new Promise((r) => setTimeout(r, 400));
+    sendProgress({ attachmentId, progress });
+  }
+  return { attachmentId, name: payload.fileName };
+}
+
+// src/VibeAppHost.ts
+var VibeAppHost = class {
+  constructor({ trustedOrigins, getContext, appBasePath, clientConfig }) {
+    this.iframeWindow = null;
+    this.kindHandlers = {
+      request: (msg, source, origin) => this.handleRequest(msg, source, origin),
+      command: (msg) => this.dispatchCommand(msg)
+    };
+    this.commandHandlers = {
+      REPORT_SUBROUTE: (payload) => {
+        const newPath = payload.subroute === "/" ? this.appBasePath : `${this.appBasePath}${payload.subroute}`;
+        const method = payload.replace ? "replaceState" : "pushState";
+        window.history[method](null, "", newPath);
+      }
+    };
+    this.trustedOrigins = new Set(trustedOrigins);
+    this.getContext = getContext;
+    this.appBasePath = appBasePath;
+    this.boundHandleMessage = this.handleMessage.bind(this);
+    this.boundHandlePopState = this.handlePopState.bind(this);
+    this.handlers = this.initializeHandlers(clientConfig || { baseUrl: "", stripApiPrefix: false });
+  }
+  dispatchCommand(msg) {
+    const handler = this.commandHandlers[msg.type];
+    handler(msg.payload);
+  }
+  initializeHandlers(clientConfig) {
+    return {
+      ...createHandlerMap(clientConfig),
+      UPLOAD_FILE: uploadHandler
+    };
+  }
+  /**
+   * Starts listening for bridge messages and sets up browser back/forward sync.
+   * Returns a cleanup function to call on unmount.
+   *
+   * Pass `iframeWindow` to immediately push context to the iframe. If omitted,
+   * the host will respond to GET_CONTEXT polls from the bridge but won't
+   * proactively push — call `pushContextTo(iframeWindow)` once the iframe has
+   * loaded to trigger the proactive push.
+   */
+  mount(iframeWindow) {
+    if (iframeWindow) this.iframeWindow = iframeWindow;
+    window.addEventListener("message", this.boundHandleMessage);
+    window.addEventListener("popstate", this.boundHandlePopState);
+    if (iframeWindow) this.pushContext(iframeWindow);
+    return () => {
+      window.removeEventListener("message", this.boundHandleMessage);
+      window.removeEventListener("popstate", this.boundHandlePopState);
+      this.iframeWindow = null;
+    };
+  }
+  /**
+   * Pushes the current context to the iframe and updates the stored iframe
+   * window reference. Call this once the iframe has loaded if `mount()` was
+   * called without an `iframeWindow`.
+   */
+  pushContextTo(iframeWindow) {
+    this.iframeWindow = iframeWindow;
+    this.pushContext(iframeWindow);
+  }
+  pushContext(target) {
+    const message = {
+      __protocol: PROTOCOL_ID,
+      __version: PROTOCOL_VERSION,
+      kind: "push",
+      type: "CONTEXT_PUSH",
+      payload: { ...this.getContext(), hostVersion: version }
+    };
+    for (const origin of this.trustedOrigins) {
+      target.postMessage(message, origin);
+    }
+  }
+  handlePopState() {
+    if (!this.iframeWindow) return;
+    const currentPath = window.location.pathname;
+    if (!currentPath.startsWith(this.appBasePath)) return;
+    const subroute = currentPath.slice(this.appBasePath.length) || "/";
+    this.pushToIframe("SUBROUTE_PUSH", { subroute });
+  }
+  pushToIframe(type, payload) {
+    if (!this.iframeWindow) return;
+    const message = {
+      __protocol: PROTOCOL_ID,
+      __version: PROTOCOL_VERSION,
+      kind: "push",
+      type,
+      payload
+    };
+    for (const origin of this.trustedOrigins) {
+      this.iframeWindow.postMessage(message, origin);
+    }
+  }
+  async handleMessage(event) {
+    if (!this.trustedOrigins.has(event.origin)) return;
+    if (!isBridgeMessage(event.data)) return;
+    await this.kindHandlers[event.data.kind]?.(event.data, event.source, event.origin);
+  }
+  async handleRequest(msg, source, origin) {
+    const { requestId, type } = msg;
+    if (type === "GET_CONTEXT") {
+      const ctx = { ...this.getContext(), hostVersion: version };
+      const bridgeVersion = msg.payload?.bridgeVersion ?? "unknown";
+      console.log(
+        `[vibe-host] Vibe App connected \u2014 bridge: ${bridgeVersion}, host: ${version}, tenant: ${ctx.tenant}, user: ${ctx.user.displayName}`
+      );
+      this.respond(source, origin, { kind: "response", type, requestId, ok: true, data: ctx });
+      return;
+    }
+    const sendProgress = (payload) => {
+      const message = {
+        __protocol: PROTOCOL_ID,
+        __version: PROTOCOL_VERSION,
+        kind: "progress",
+        type,
+        requestId,
+        payload
+      };
+      source.postMessage(message, origin);
+    };
+    try {
+      const handler = this.handlers[type];
+      const data = await handler(msg.payload, sendProgress);
+      this.respond(source, origin, { kind: "response", type, requestId, ok: true, data });
+    } catch (err) {
+      const error = err instanceof Error ? err.message : String(err);
+      this.respond(source, origin, { kind: "response", type, requestId, ok: false, error });
+    }
+  }
+  respond(target, origin, response) {
+    target.postMessage(
+      { __protocol: PROTOCOL_ID, __version: PROTOCOL_VERSION, ...response },
+      origin
+    );
+  }
+};
+export {
+  VibeAppHost
+};