@hubspot/app-connect-sdk 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/browser/react/lovable.d.ts

@@ -1,5 +1,5 @@
+import { a as OAuthConnectMode } from "../types-C3wed8dU.js";
 import { ReactNode } from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/browser/react/lovable/LovableHubSpotAppConnect.d.ts
 /**
@@ -15,6 +15,12 @@ interface LovableHubSpotAppConnectProps {
    * @example `${import.meta.env.VITE_SUPABASE_URL}/functions/v1/hubspot-connect`
    */
   hubSpotConnectBaseUrl: string;
+  /**
+   * How connect navigates to HubSpot OAuth. Defaults to `'auto'` (popup
+   * when embedded in an iframe). Set to `'popup'` to test the popup flow
+   * without embedding.
+   */
+  oauthConnectMode?: OAuthConnectMode;
   /** Title text rendered in the standard SDK header. */
   title: string;
   /** Content rendered when the controller is in the `connected` state. */
@@ -35,10 +41,11 @@ interface LovableHubSpotAppConnectProps {
  */
 declare function LovableHubSpotAppConnect({
   hubSpotConnectBaseUrl,
+  oauthConnectMode,
   title,
   connected,
   disconnectedMessage
-}: LovableHubSpotAppConnectProps): _$react_jsx_runtime0.JSX.Element;
+}: LovableHubSpotAppConnectProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 export { LovableHubSpotAppConnect, type LovableHubSpotAppConnectProps };
 //# sourceMappingURL=lovable.d.ts.map

package/dist/browser/react/lovable.js

@@ -1,5 +1,5 @@
-import { t as createAppConnectController } from "../create-vctOhpX9.js";
-import { t as HubSpotAppConnect } from "../HubSpotAppConnect-BW45gyDs.js";
+import { t as createAppConnectController } from "../create-DxEyGG-k.js";
+import { t as HubSpotAppConnect } from "../HubSpotAppConnect-721kYr9d.js";
 import { useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/browser/react/lovable/LovableHubSpotAppConnect.tsx
@@ -11,9 +11,12 @@ import { jsx } from "react/jsx-runtime";
 * canonical `HubSpotAppConnect` from `@hubspot/app-connect-sdk/react`
 * instead.
 */
-function LovableHubSpotAppConnect({ hubSpotConnectBaseUrl, title, connected, disconnectedMessage }) {
+function LovableHubSpotAppConnect({ hubSpotConnectBaseUrl, oauthConnectMode, title, connected, disconnectedMessage }) {
 	const controllerRef = useRef(null);
-	if (controllerRef.current === null) controllerRef.current = createAppConnectController({ config: { hubSpotConnectBaseUrl } });
+	if (controllerRef.current === null) controllerRef.current = createAppConnectController({ config: {
+		hubSpotConnectBaseUrl,
+		oauthConnectMode: oauthConnectMode || "auto"
+	} });
 	return /* @__PURE__ */ jsx(HubSpotAppConnect, {
 		title,
 		connected,

package/dist/browser/react/lovable.js.map

@@ -1 +1 @@
-{"version":3,"file":"lovable.js","names":[],"sources":["../../../src/browser/react/lovable/LovableHubSpotAppConnect.tsx"],"sourcesContent":["import { useRef, type ReactNode } from 'react';\n\nimport { createAppConnectController } from '../../app-connect-controller/create.ts';\nimport type { AppConnectController } from '../../types.ts';\nimport { HubSpotAppConnect } from '../components/HubSpotAppConnect/HubSpotAppConnect.tsx';\n\n/**\n * Props accepted by {@link LovableHubSpotAppConnect}.\n */\nexport interface LovableHubSpotAppConnectProps {\n  /**\n   * URL prefix the Lovable backend mounts the SDK's `hubspot-connect`\n   * routes on (no trailing slash). In a Vite + Supabase Lovable app,\n   * read the Supabase origin from `import.meta.env.VITE_SUPABASE_URL`\n   * and append `/functions/v1/hubspot-connect`.\n   *\n   * @example `${import.meta.env.VITE_SUPABASE_URL}/functions/v1/hubspot-connect`\n   */\n  hubSpotConnectBaseUrl: string;\n  /** Title text rendered in the standard SDK header. */\n  title: string;\n  /** Content rendered when the controller is in the `connected` state. */\n  connected: ReactNode;\n  /**\n   * Description text rendered inside the SDK-owned disconnected card,\n   * above the primary \"Connect to HubSpot\" button.\n   */\n  disconnectedMessage: ReactNode;\n}\n\n/**\n * Lovable-preset variant of `HubSpotAppConnect`. Takes\n * `hubSpotConnectBaseUrl` as a prop and lazily creates a single\n * controller per component instance. Callers that need a custom\n * logger or full control over controller construction should use the\n * canonical `HubSpotAppConnect` from `@hubspot/app-connect-sdk/react`\n * instead.\n */\nexport function LovableHubSpotAppConnect({\n  hubSpotConnectBaseUrl,\n  title,\n  connected,\n  disconnectedMessage,\n}: LovableHubSpotAppConnectProps) {\n  // useRef null-check pattern: create the controller exactly once per\n  // component instance and never recreate it when props change. The\n  // first hubSpotConnectBaseUrl wins; later changes are ignored, which\n  // matches the \"one controller per app\" semantics the canonical\n  // HubSpotAppConnect also enforces.\n  const controllerRef = useRef<AppConnectController | null>(null);\n  if (controllerRef.current === null) {\n    controllerRef.current = createAppConnectController({\n      config: { hubSpotConnectBaseUrl },\n    });\n  }\n  return (\n    <HubSpotAppConnect\n      title={title}\n      connected={connected}\n      disconnectedMessage={disconnectedMessage}\n      controller={controllerRef.current}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAsCA,SAAgB,yBAAyB,EACvC,uBACA,OACA,WACA,uBACgC;CAMhC,MAAM,gBAAgB,OAAoC,KAAK;CAC/D,IAAI,cAAc,YAAY,MAC5B,cAAc,UAAU,2BAA2B,EACjD,QAAQ,EAAE,uBAAuB,EAClC,CAAC;CAEJ,OACE,oBAAC,mBAAD;EACS;EACI;EACU;EACrB,YAAY,cAAc;EAC1B,CAAA"}
+{"version":3,"file":"lovable.js","names":[],"sources":["../../../src/browser/react/lovable/LovableHubSpotAppConnect.tsx"],"sourcesContent":["import { useRef, type ReactNode } from 'react';\n\nimport { createAppConnectController } from '../../app-connect-controller/create.ts';\nimport type { AppConnectController, OAuthConnectMode } from '../../types.ts';\nimport { HubSpotAppConnect } from '../components/HubSpotAppConnect/HubSpotAppConnect.tsx';\n\n/**\n * Props accepted by {@link LovableHubSpotAppConnect}.\n */\nexport interface LovableHubSpotAppConnectProps {\n  /**\n   * URL prefix the Lovable backend mounts the SDK's `hubspot-connect`\n   * routes on (no trailing slash). In a Vite + Supabase Lovable app,\n   * read the Supabase origin from `import.meta.env.VITE_SUPABASE_URL`\n   * and append `/functions/v1/hubspot-connect`.\n   *\n   * @example `${import.meta.env.VITE_SUPABASE_URL}/functions/v1/hubspot-connect`\n   */\n  hubSpotConnectBaseUrl: string;\n  /**\n   * How connect navigates to HubSpot OAuth. Defaults to `'auto'` (popup\n   * when embedded in an iframe). Set to `'popup'` to test the popup flow\n   * without embedding.\n   */\n  oauthConnectMode?: OAuthConnectMode;\n  /** Title text rendered in the standard SDK header. */\n  title: string;\n  /** Content rendered when the controller is in the `connected` state. */\n  connected: ReactNode;\n  /**\n   * Description text rendered inside the SDK-owned disconnected card,\n   * above the primary \"Connect to HubSpot\" button.\n   */\n  disconnectedMessage: ReactNode;\n}\n\n/**\n * Lovable-preset variant of `HubSpotAppConnect`. Takes\n * `hubSpotConnectBaseUrl` as a prop and lazily creates a single\n * controller per component instance. Callers that need a custom\n * logger or full control over controller construction should use the\n * canonical `HubSpotAppConnect` from `@hubspot/app-connect-sdk/react`\n * instead.\n */\nexport function LovableHubSpotAppConnect({\n  hubSpotConnectBaseUrl,\n  oauthConnectMode,\n  title,\n  connected,\n  disconnectedMessage,\n}: LovableHubSpotAppConnectProps) {\n  // useRef null-check pattern: create the controller exactly once per\n  // component instance and never recreate it when props change. The\n  // first hubSpotConnectBaseUrl wins; later changes are ignored, which\n  // matches the \"one controller per app\" semantics the canonical\n  // HubSpotAppConnect also enforces.\n  const controllerRef = useRef<AppConnectController | null>(null);\n  if (controllerRef.current === null) {\n    controllerRef.current = createAppConnectController({\n      config: {\n        hubSpotConnectBaseUrl,\n        oauthConnectMode: oauthConnectMode || 'auto',\n      },\n    });\n  }\n  return (\n    <HubSpotAppConnect\n      title={title}\n      connected={connected}\n      disconnectedMessage={disconnectedMessage}\n      controller={controllerRef.current}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA4CA,SAAgB,yBAAyB,EACvC,uBACA,kBACA,OACA,WACA,uBACgC;CAMhC,MAAM,gBAAgB,OAAoC,IAAI;CAC9D,IAAI,cAAc,YAAY,MAC5B,cAAc,UAAU,2BAA2B,EACjD,QAAQ;EACN;EACA,kBAAkB,oBAAoB;CACxC,EACF,CAAC;CAEH,OACE,oBAAC,mBAAD;EACS;EACI;EACU;EACrB,YAAY,cAAc;CAC3B,CAAA;AAEL"}

package/dist/browser/react.d.ts

@@ -1,6 +1,5 @@
-import { n as AppConnectController, r as AppConnectState } from "./types-rTQw6A54.js";
+import { n as AppConnectController, r as AppConnectState } from "./types-C3wed8dU.js";
 import { ReactNode } from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/browser/react/components/HubSpotAppConnect/HubSpotAppConnect.d.ts
 /**
@@ -29,7 +28,7 @@ declare function HubSpotAppConnect({
   controller,
   connected,
   disconnectedMessage
-}: HubSpotAppConnectProps): _$react_jsx_runtime0.JSX.Element;
+}: HubSpotAppConnectProps): import("react/jsx-runtime").JSX.Element;
 //#endregion
 //#region src/browser/react/hooks.d.ts
 type UseHubSpotAppConnectResult = AppConnectState;

package/dist/browser/react.js

@@ -1,2 +1,2 @@
-import { n as useHubSpotAppConnect, t as HubSpotAppConnect } from "./HubSpotAppConnect-BW45gyDs.js";
+import { n as useHubSpotAppConnect, t as HubSpotAppConnect } from "./HubSpotAppConnect-721kYr9d.js";
 export { HubSpotAppConnect, useHubSpotAppConnect };

package/dist/browser/{types-rTQw6A54.d.ts → types-C3wed8dU.d.ts}

@@ -1,4 +1,32 @@
+//#region src/shared/wire-types.d.ts
+interface AuthCompleteWhoamiUser {
+  id?: string | undefined;
+  email?: string | undefined;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+}
+interface AuthCompleteWhoamiHub {
+  id?: number | undefined;
+  domain?: string | undefined;
+  uiDomain?: string | undefined;
+}
+/**
+ * Identity information for the authenticated user and their HubSpot
+ * account. Both fields are optional because the access token may not
+ * carry the scopes needed to fetch each piece (`public-users-read` for
+ * `user`, `external-settings-access` for `hub`).
+ */
+interface AuthCompleteWhoami {
+  user: AuthCompleteWhoamiUser;
+  hub: AuthCompleteWhoamiHub;
+}
+//#endregion
 //#region src/browser/types.d.ts
+/**
+ * How the browser navigates to HubSpot's OAuth authorize endpoint when
+ * the user calls `connectToHubSpot`.
+ */
+type OAuthConnectMode = 'auto' | 'redirect' | 'popup';
 /**
  * Runtime configuration for an `AppConnectController`. The browser
  * controller uses these URLs to talk to the SDK's server-side OAuth
@@ -12,6 +40,15 @@ interface AppConnectBrowserConfig {
    * @example '/functions/v1/hubspot-connect'
    */
   hubSpotConnectBaseUrl: string;
+  /**
+   * Controls whether connect uses a full-page redirect or a popup.
+   *
+   * - `'auto'` (default): popup when the app is embedded in an iframe,
+   *   full-page redirect otherwise.
+   * - `'redirect'`: always full-page redirect.
+   * - `'popup'`: always open a popup (useful for local iframe testing).
+   */
+  oauthConnectMode?: OAuthConnectMode;
 }
 /**
  * Public lifecycle of an `AppConnectController`. Every state in the
@@ -19,8 +56,7 @@ interface AppConnectBrowserConfig {
  *
  * - `initializing`: the controller hasn't finished `start()` yet.
  * - `disconnected`: no active session, ready to call `connectToHubSpot`.
- * - `connecting`: a connect flow is in flight (the browser is about
- *   to redirect to HubSpot).
+ * - `connecting`: a connect flow is in flight (redirect or OAuth popup).
  * - `connected`: a refresh-token cookie is present and the access
  *   token is being refreshed in the background.
  * - `disconnecting`: a `disconnectFromHubSpot()` call is in flight.
@@ -36,9 +72,18 @@ interface AppConnectState {
   /** Last error message that occurred, or `null` if no error. */
   error: string | null;
   /**
-   * Begins the OAuth connect flow. On success the browser redirects
-   * to HubSpot's authorize endpoint; the promise resolves before the
-   * redirect.
+   * Identity of the connected HubSpot user and their account. Populated
+   * after a successful OAuth flow on a best-effort basis (fields may be
+   * absent if the access token lacked the required scopes). `null` before
+   * connect or after disconnect.
+   */
+  whoami: AuthCompleteWhoami | null;
+  /**
+   * Begins the OAuth connect flow. On success the browser either
+   * redirects to HubSpot's authorize endpoint or opens it in a popup
+   * (when embedded in an iframe or when `oauthConnectMode` is
+   * `'popup'`). The promise resolves when the popup flow completes, or
+   * just before a full-page redirect begins.
    */
   connectToHubSpot: () => Promise<void>;
   /**
@@ -75,5 +120,5 @@ interface AppConnectController {
   start: () => void;
 }
 //#endregion
-export { AppConnectStatus as i, AppConnectController as n, AppConnectState as r, AppConnectBrowserConfig as t };
-//# sourceMappingURL=types-rTQw6A54.d.ts.map
+export { OAuthConnectMode as a, AppConnectStatus as i, AppConnectController as n, AppConnectState as r, AppConnectBrowserConfig as t };
+//# sourceMappingURL=types-C3wed8dU.d.ts.map

package/dist/server/api-client-core/apis/account/account-info-types.generated.d.ts

@@ -1,111 +1,99 @@
 import { Operation } from "../../types.js";
 
 //#region src/server/api-client-core/apis/account/account-info-types.generated.d.ts
-declare namespace AccountAccountInfo {
-  namespace Basic {
-    type GetDailyPrivateAppsUsageOutput = Schemas.CollectionResponseApiUsageNoPaging;
-    type GetOutput = Schemas.PortalInformationResponse;
+declare namespace AccountAccountInfoSchemas {
+  interface ApiUsage {
+    /**
+     * Indicates when the cache was last updated.
+     */
+    collectedAt: string;
+    /**
+     * How many API calls an account has made for the current day.
+     */
+    currentUsage: number;
+    /**
+     * Status of fetching the information, including if the data came from the cache.
+     */
+    fetchStatus: 'CACHED' | 'FAILURE' | 'NOTFOUND' | 'SUCCESS' | 'TIMEOUT';
+    /**
+     * Name of the limit type.
+     */
+    name: string;
+    /**
+     * Time that the limit will reset.
+     */
+    resetsAt?: string;
+    /**
+     * Limits by which a single integration can consume the HubSpot public APIs.
+     */
+    usageLimit: number;
+  }
+  interface CollectionResponseApiUsageNoPaging {
+    results: ApiUsage[];
   }
-  namespace Schemas {
-    interface ApiUsage {
-      /**
-       * Indicates when the cache was last updated.
-       */
-      collectedAt: string;
-      /**
-       * How many API calls an account has made for the current day.
-       */
-      currentUsage: number;
-      /**
-       * Status of fetching the information, including if the data came from the cache.
-       */
-      fetchStatus: 'CACHED' | 'FAILURE' | 'NOTFOUND' | 'SUCCESS' | 'TIMEOUT';
-      /**
-       * Name of the limit type.
-       */
-      name: string;
-      /**
-       * Time that the limit will reset.
-       */
-      resetsAt?: string;
-      /**
-       * Limits by which a single integration can consume the HubSpot public APIs.
-       */
-      usageLimit: number;
-    }
-    interface CollectionResponseApiUsageNoPaging {
-      results: Schemas.ApiUsage[];
-    }
-    interface PortalInformationResponse {
-      /**
-       * The type of account, such as APP_DEVELOPER, DEVELOPER_TEST, SANDBOX, or STANDARD.
-       */
-      accountType: 'APP_DEVELOPER' | 'DEVELOPER_TEST' | 'SANDBOX' | 'STANDARD';
-      additionalCurrencies: string[];
-      /**
-       * The primary currency used by the company.
-       */
-      companyCurrency: string;
-      /**
-       * The location where the account's data is hosted.
-       */
-      dataHostingLocation: string;
-      /**
-       * The unique identifier for the HubSpot account.
-       */
-      portalId: number;
-      /**
-       * The time zone in which the account operates.
-       */
-      timeZone: string;
-      /**
-       * The domain used for accessing the HubSpot user interface.
-       */
-      uiDomain: string;
-      /**
-       * The time zone offset from UTC in hours and minutes.
-       */
-      utcOffset: string;
-      /**
-       * The time zone offset from UTC in milliseconds.
-       */
-      utcOffsetMilliseconds: number;
-    }
+  interface PortalInformationResponse {
+    /**
+     * The type of account, such as APP_DEVELOPER, DEVELOPER_TEST, SANDBOX, or STANDARD.
+     */
+    accountType: 'APP_DEVELOPER' | 'DEVELOPER_TEST' | 'SANDBOX' | 'STANDARD';
+    additionalCurrencies: string[];
+    /**
+     * The primary currency used by the company.
+     */
+    companyCurrency: string;
+    /**
+     * The location where the account's data is hosted.
+     */
+    dataHostingLocation: string;
+    /**
+     * The unique identifier for the HubSpot account.
+     */
+    portalId: number;
+    /**
+     * The time zone in which the account operates.
+     */
+    timeZone: string;
+    /**
+     * The domain used for accessing the HubSpot user interface.
+     */
+    uiDomain: string;
+    /**
+     * The time zone offset from UTC in hours and minutes.
+     */
+    utcOffset: string;
+    /**
+     * The time zone offset from UTC in milliseconds.
+     */
+    utcOffsetMilliseconds: number;
   }
+}
+declare namespace Account {
+  type GetDailyPrivateAppsUsageOutput = AccountAccountInfoSchemas.CollectionResponseApiUsageNoPaging;
+  type GetOutput = AccountAccountInfoSchemas.PortalInformationResponse;
   /**
    * Usage example:
    * ```ts
-   * import { accountAccountInfo } from '@hubspot/api-client-core';
-   * client.send(accountAccountInfo.basic.get(input));
+   * import { account } from '@hubspot/api-client-core';
+   * client.send(account.get(input));
    * ```
    */
-  interface BasicAPI {
+  interface API {
     /**
      * Retrieve account details
      * @apiPath /account-info/2026-03/details
      * @apiMethod GET
      * @requiredScopes external-settings-access
      */
-    get: () => Operation<Basic.GetOutput>;
+    get: () => Operation<GetOutput>;
     /**
      * Retrieve private app daily API usage
      * @apiPath /account-info/2026-03/api-usage/daily/private-apps
      * @apiMethod GET
      * @requiredScopes external-settings-access
      */
-    getDailyPrivateAppsUsage: () => Operation<Basic.GetDailyPrivateAppsUsageOutput>;
-  }
-  /**
-   * Usage example:
-   * ```ts
-   * import { accountAccountInfo } from '@hubspot/api-client-core';
-   * client.send(accountAccountInfo.basic.get(input));
-   * ```
-   */
-  interface API {
-    basic: BasicAPI;
+    getDailyPrivateAppsUsage: () => Operation<GetDailyPrivateAppsUsageOutput>;
   }
 }
 //#endregion
-export { AccountAccountInfo };
+export { Account, AccountAccountInfoSchemas };
 //# sourceMappingURL=account-info-types.generated.d.ts.map

package/dist/server/api-client-core/apis/account/account-info.generated.d.ts

@@ -1,7 +1,7 @@
-import { AccountAccountInfo } from "./account-info-types.generated.js";
+import { Account, AccountAccountInfoSchemas } from "./account-info-types.generated.js";
 
 //#region src/server/api-client-core/apis/account/account-info.generated.d.ts
-declare const accountAccountInfo: AccountAccountInfo.API;
+declare const account: Account.API;
 //#endregion
-export { accountAccountInfo };
+export { account };
 //# sourceMappingURL=account-info.generated.d.ts.map

package/dist/server/api-client-core/apis/account/account-info.generated.js

@@ -1,9 +1,10 @@
 import { op } from "../../op.js";
-const accountAccountInfo = { basic: {
+//#region src/server/api-client-core/apis/account/account-info.generated.ts
+const account = {
 	get: () => op.get("/account-info/2026-03/details"),
 	getDailyPrivateAppsUsage: () => op.get("/account-info/2026-03/api-usage/daily/private-apps")
-} };
+};
 //#endregion
-export { accountAccountInfo };
+export { account };
 
 //# sourceMappingURL=account-info.generated.js.map

package/dist/server/api-client-core/apis/account/account-info.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-info.generated.js","names":[],"sources":["../../../../../src/server/api-client-core/apis/account/account-info.generated.ts"],"sourcesContent":["import { op } from '../../op.ts';\nimport type { AccountAccountInfo } from './account-info-types.generated.ts';\n\n// DO NOT MODIFY - This code was generated by @hubspot/api-client-next-generator\n\nexport * from './account-info-types.generated.ts';\n\nconst basic: AccountAccountInfo.BasicAPI = {\n  get: () => op.get('/account-info/2026-03/details'),\n  getDailyPrivateAppsUsage: () =>\n    op.get('/account-info/2026-03/api-usage/daily/private-apps'),\n};\n\nexport const accountAccountInfo: AccountAccountInfo.API = { basic: basic };\n"],"mappings":";AAaA,MAAa,qBAA6C,EAAS;CALjE,WAAW,GAAG,IAAI,gCAAgC;CAClD,gCACE,GAAG,IAAI,qDAAqD;CAGG,EAAO"}
+{"version":3,"file":"account-info.generated.js","names":[],"sources":["../../../../../src/server/api-client-core/apis/account/account-info.generated.ts"],"sourcesContent":["import { op } from '../../op.ts';\nimport type { Account } from './account-info-types.generated.ts';\n\n// DO NOT MODIFY - This code was generated by @hubspot/api-client-next-generator\n\nexport * from './account-info-types.generated.ts';\n\nexport const account: Account.API = {\n  get: () => op.get('/account-info/2026-03/details'),\n  getDailyPrivateAppsUsage: () =>\n    op.get('/account-info/2026-03/api-usage/daily/private-apps'),\n};\n"],"mappings":";;AAOA,MAAa,UAAuB;CAClC,WAAW,GAAG,IAAI,+BAA+B;CACjD,gCACE,GAAG,IAAI,oDAAoD;AAC/D"}