@hubspot/app-connect-sdk 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/server/{api-client-core/client.js → binary-data-BOalJzKu.js}

@@ -1,4 +1,33 @@
-import { HubSpotApiError } from "./errors.js";
+//#region src/server/api-client-core/errors.ts
+/**
+* Error thrown when the HubSpot API returns a non-2xx HTTP response.
+*
+* Captures the full response metadata so callers can inspect the status code,
+* headers, and parsed error body for diagnostics or retry logic.
+*/
+var HubSpotApiError = class extends Error {
+	/** HTTP status code returned by the API (e.g. `404`, `429`). */
+	statusCode;
+	/** HTTP status text accompanying the status code (e.g. `"Not Found"`). */
+	statusText;
+	/** Response headers as key-value pairs. */
+	headers;
+	/** Parsed JSON body of the error response, if any. */
+	body;
+	/**
+	* @param response - The raw {@link ApiResponse} from the middleware pipeline
+	*   that triggered the error.
+	*/
+	constructor(response) {
+		super(`HubSpot API error: ${response.status} ${response.statusText}`);
+		this.name = "HubSpotApiError";
+		this.statusCode = response.status;
+		this.statusText = response.statusText;
+		this.headers = response.headers;
+		this.body = response.bodyJson;
+	}
+};
+//#endregion
 //#region src/server/api-client-core/client.ts
 /**
 * Throws a {@link HubSpotApiError} if the response status is outside the 2xx range.
@@ -70,6 +99,32 @@ function createHubSpotClient(options) {
 	return client;
 }
 //#endregion
-export { createHubSpotClient };
+//#region src/server/api-client-core/binary-data.ts
+/** Branded symbol used to distinguish {@link BinaryData} from plain objects at runtime. */
+const binaryDataSymbol = Symbol("BinaryData");
+/**
+* Wraps a binary source in a {@link BinaryData} branded object so the
+* transport layer can identify it as a file-upload field.
+*
+* @param source - The binary payload (e.g. a `Blob`, `File`, or `Buffer`).
+* @returns A branded {@link BinaryData} instance.
+*/
+function createBinaryData(source) {
+	return {
+		[binaryDataSymbol]: true,
+		source
+	};
+}
+/**
+* Type guard that checks whether a value is a {@link BinaryData} instance.
+*
+* @param value - The value to check.
+* @returns `true` if `value` is a branded `BinaryData` object.
+*/
+function isBinaryData(value) {
+	return typeof value === "object" && value !== null && binaryDataSymbol in value;
+}
+//#endregion
+export { HubSpotApiError as i, isBinaryData as n, createHubSpotClient as r, createBinaryData as t };
 
-//# sourceMappingURL=client.js.map
+//# sourceMappingURL=binary-data-BOalJzKu.js.map

package/dist/server/binary-data-BOalJzKu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-data-BOalJzKu.js","names":[],"sources":["../../src/server/api-client-core/errors.ts","../../src/server/api-client-core/client.ts","../../src/server/api-client-core/binary-data.ts"],"sourcesContent":["import type { ApiResponse } from './types.ts';\n\n/**\n * Error thrown when the HubSpot API returns a non-2xx HTTP response.\n *\n * Captures the full response metadata so callers can inspect the status code,\n * headers, and parsed error body for diagnostics or retry logic.\n */\nexport class HubSpotApiError extends Error {\n  /** HTTP status code returned by the API (e.g. `404`, `429`). */\n  public readonly statusCode: number;\n  /** HTTP status text accompanying the status code (e.g. `\"Not Found\"`). */\n  public readonly statusText: string;\n  /** Response headers as key-value pairs. */\n  public readonly headers: Record<string, string>;\n  /** Parsed JSON body of the error response, if any. */\n  public readonly body: unknown;\n\n  /**\n   * @param response - The raw {@link ApiResponse} from the middleware pipeline\n   *   that triggered the error.\n   */\n  constructor(response: ApiResponse) {\n    super(`HubSpot API error: ${response.status} ${response.statusText}`);\n    this.name = 'HubSpotApiError';\n    this.statusCode = response.status;\n    this.statusText = response.statusText;\n    this.headers = response.headers;\n    this.body = response.bodyJson;\n  }\n}\n","import { HubSpotApiError } from './errors.ts';\nimport type {\n  ApiResponse,\n  CreateHubSpotClientOptions,\n  HubSpotApiResponse,\n  HubSpotClient,\n  Middleware,\n  MiddlewareContext,\n  Operation,\n  PluginAPI,\n} from './types.ts';\n\n/**\n * Throws a {@link HubSpotApiError} if the response status is outside the 2xx range.\n *\n * @param response - The raw API response to validate.\n * @throws {HubSpotApiError} When `response.status` is not between 200 and 299.\n */\nfunction assertSuccess(response: ApiResponse): void {\n  if (response.status < 200 || response.status >= 300) {\n    throw new HubSpotApiError(response);\n  }\n}\n\n/**\n * Composes an array of {@link Middleware} functions into a single dispatch\n * chain (Koa-style). Each middleware receives a `next` callback that\n * invokes the subsequent middleware; the final middleware must produce the\n * response (typically the transport plugin).\n *\n * Guards against `next()` being called more than once per middleware and\n * against pipelines with no terminal handler.\n *\n * @param middleware - Ordered list of middleware to compose.\n * @returns A function that dispatches a {@link MiddlewareContext} through the chain.\n */\nfunction compose(\n  middleware: Middleware[]\n): (ctx: MiddlewareContext) => Promise<ApiResponse> {\n  return function (ctx) {\n    let index = -1;\n    function dispatch(i: number): Promise<ApiResponse> {\n      if (i <= index) {\n        return Promise.reject(new Error('next() called multiple times'));\n      }\n      index = i;\n      if (i >= middleware.length) {\n        return Promise.reject(\n          new Error(\n            'No middleware handled the request. Did you forget a transport plugin?'\n          )\n        );\n      }\n      const fn = middleware[i]!;\n      return Promise.resolve(fn(ctx, () => dispatch(i + 1)));\n    }\n    return dispatch(0);\n  };\n}\n\n/**\n * Creates a {@link HubSpotClient} by activating the provided plugins and\n * composing their middleware into a single request pipeline.\n *\n * @param options - Client configuration including the list of plugins to activate.\n * @returns A ready-to-use client whose `send` method executes operations through the pipeline.\n */\nexport function createHubSpotClient(\n  options: CreateHubSpotClientOptions\n): HubSpotClient {\n  const middlewareStack: Middleware[] = [];\n\n  const pluginApi: PluginAPI = {\n    addMiddleware(middleware) {\n      middlewareStack.push(middleware);\n    },\n  };\n\n  for (const plugin of options.plugins) {\n    plugin.activate(pluginApi);\n  }\n\n  const run = compose(middlewareStack);\n\n  const client: HubSpotClient = {\n    send(operation: any): any {\n      if (\n        operation._kind === 'syntheticStreaming' ||\n        operation._kind === 'synthetic'\n      ) {\n        return operation.run({ client });\n      }\n      const ctx: MiddlewareContext = { operation };\n      return run(ctx).then((response) => {\n        assertSuccess(response);\n        return response.bodyJson;\n      });\n    },\n    async sendWithResponse<TOutput>(\n      operation: Operation<TOutput>\n    ): Promise<HubSpotApiResponse<TOutput>> {\n      const ctx: MiddlewareContext = { operation };\n      const response = await run(ctx);\n      assertSuccess(response);\n      return {\n        status: response.status,\n        statusText: response.statusText,\n        headers: response.headers,\n        data: response.bodyJson as TOutput,\n      };\n    },\n  };\n\n  return client;\n}\n","/** Branded symbol used to distinguish {@link BinaryData} from plain objects at runtime. */\nconst binaryDataSymbol: unique symbol = Symbol('BinaryData');\n\n/**\n * A branded wrapper around a binary source (e.g. `Blob`, `File`, `Buffer`)\n * used to identify file-upload fields in multipart/form-data operations.\n *\n * The transport plugin inspects this brand to decide whether a field should\n * be appended to `FormData` as a `Blob` rather than a stringified value.\n */\nexport interface BinaryData {\n  readonly [binaryDataSymbol]: true;\n  /** The underlying binary source (typically a `Blob` or `File`). */\n  readonly source: unknown;\n}\n\n/**\n * Wraps a binary source in a {@link BinaryData} branded object so the\n * transport layer can identify it as a file-upload field.\n *\n * @param source - The binary payload (e.g. a `Blob`, `File`, or `Buffer`).\n * @returns A branded {@link BinaryData} instance.\n */\nexport function createBinaryData(source: unknown): BinaryData {\n  return { [binaryDataSymbol]: true, source } as BinaryData;\n}\n\n/**\n * Type guard that checks whether a value is a {@link BinaryData} instance.\n *\n * @param value - The value to check.\n * @returns `true` if `value` is a branded `BinaryData` object.\n */\nexport function isBinaryData(value: unknown): value is BinaryData {\n  return (\n    typeof value === 'object' && value !== null && binaryDataSymbol in value\n  );\n}\n"],"mappings":";;;;;;;AAQA,IAAa,kBAAb,cAAqC,MAAM;;CAEzC;;CAEA;;CAEA;;CAEA;;;;;CAMA,YAAY,UAAuB;EACjC,MAAM,sBAAsB,SAAS,OAAO,GAAG,SAAS,aAAa;EACrE,KAAK,OAAO;EACZ,KAAK,aAAa,SAAS;EAC3B,KAAK,aAAa,SAAS;EAC3B,KAAK,UAAU,SAAS;EACxB,KAAK,OAAO,SAAS;;;;;;;;;;;ACVzB,SAAS,cAAc,UAA6B;CAClD,IAAI,SAAS,SAAS,OAAO,SAAS,UAAU,KAC9C,MAAM,IAAI,gBAAgB,SAAS;;;;;;;;;;;;;;AAgBvC,SAAS,QACP,YACkD;CAClD,OAAO,SAAU,KAAK;EACpB,IAAI,QAAQ;EACZ,SAAS,SAAS,GAAiC;GACjD,IAAI,KAAK,OACP,OAAO,QAAQ,uBAAO,IAAI,MAAM,+BAA+B,CAAC;GAElE,QAAQ;GACR,IAAI,KAAK,WAAW,QAClB,OAAO,QAAQ,uBACb,IAAI,MACF,wEACD,CACF;GAEH,MAAM,KAAK,WAAW;GACtB,OAAO,QAAQ,QAAQ,GAAG,WAAW,SAAS,IAAI,EAAE,CAAC,CAAC;;EAExD,OAAO,SAAS,EAAE;;;;;;;;;;AAWtB,SAAgB,oBACd,SACe;CACf,MAAM,kBAAgC,EAAE;CAExC,MAAM,YAAuB,EAC3B,cAAc,YAAY;EACxB,gBAAgB,KAAK,WAAW;IAEnC;CAED,KAAK,MAAM,UAAU,QAAQ,SAC3B,OAAO,SAAS,UAAU;CAG5B,MAAM,MAAM,QAAQ,gBAAgB;CAEpC,MAAM,SAAwB;EAC5B,KAAK,WAAqB;GACxB,IACE,UAAU,UAAU,wBACpB,UAAU,UAAU,aAEpB,OAAO,UAAU,IAAI,EAAE,QAAQ,CAAC;GAGlC,OAAO,IAAI,EADsB,WACnB,CAAC,CAAC,MAAM,aAAa;IACjC,cAAc,SAAS;IACvB,OAAO,SAAS;KAChB;;EAEJ,MAAM,iBACJ,WACsC;GAEtC,MAAM,WAAW,MAAM,IAAI,EADM,WACH,CAAC;GAC/B,cAAc,SAAS;GACvB,OAAO;IACL,QAAQ,SAAS;IACjB,YAAY,SAAS;IACrB,SAAS,SAAS;IAClB,MAAM,SAAS;IAChB;;EAEJ;CAED,OAAO;;;;;AChHT,MAAM,mBAAkC,OAAO,aAAa;;;;;;;;AAsB5D,SAAgB,iBAAiB,QAA6B;CAC5D,OAAO;GAAG,mBAAmB;EAAM;EAAQ;;;;;;;;AAS7C,SAAgB,aAAa,OAAqC;CAChE,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,oBAAoB"}

package/dist/server/lovable.d.ts

@@ -1,6 +1,117 @@
-import { SecureStartContext, SecureStartLoader } from "./secure-start-core.js";
-import { secureStart } from "./deno/start.js";
-import { HubSpotConnectCimdClientMetadata } from "./hono/hubspot-connect-routes/cimd-client-metadata-types.js";
-import { StartHubSpotConnectFunctionOptions, startHubSpotConnectFunction } from "./lovable/hubspot-connect/index.js";
-import { AppFunctionStart, CreateAppFunctionStartOptions, RegisterAppFunctionRoutesFunction, createAppFunctionStart } from "./lovable/create-app-function-start.js";
-export { type AppFunctionStart, type CreateAppFunctionStartOptions, type HubSpotConnectCimdClientMetadata, type RegisterAppFunctionRoutesFunction, type SecureStartContext, type SecureStartLoader, type StartHubSpotConnectFunctionOptions, createAppFunctionStart, secureStart, startHubSpotConnectFunction };
+import { i as HubSpotClient } from "./types-DEOUH4wE.js";
+import { n as HubSpotProxy, t as AppKeys } from "./types-5gfN91Fq.js";
+import { Hono } from "hono";
+
+//#region src/server/secure-start-core.d.ts
+/**
+ * Context passed to a function-style entrypoint loaded by `runSecureStart`.
+ * Contains imported `AppKeys` when CIMD or DPoP is enabled; otherwise
+ * `null` (traditional OAuth with `client_secret` and Bearer API calls).
+ */
+interface SecureStartContext {
+  appKeys: AppKeys | null;
+}
+interface SecureEntryPointExports {
+  start: (context: SecureStartContext) => Promise<void>;
+}
+/**
+ * Loader returned to `runSecureStart` that produces the entrypoint
+ * module. Always pass an `() => import('...')` arrow so the bundler
+ * preserves dynamic-import semantics.
+ */
+type SecureStartLoader = () => Promise<SecureEntryPointExports>;
+//#endregion
+//#region src/server/deno/start.d.ts
+/**
+ * Deno entrypoint helper. Reads `HUBSPOT_APP_PRIVATE_KEY` from `Deno.env`
+ * when CIMD or DPoP is enabled, imports the supplied loader, and invokes
+ * `start` with `AppKeys` or `null`.
+ */
+declare function secureStart(loader: SecureStartLoader): Promise<void>;
+//#endregion
+//#region src/server/hono/hubspot-connect-routes/cimd-client-metadata-types.d.ts
+/**
+ * Caller-supplied scope configuration for the CIMD document served at
+ * `{basePath}/client.json`. `redirect_uri` and `jwks_uri` are derived at
+ * request time by the hubspot-connect routes.
+ */
+interface HubSpotConnectCimdClientMetadata {
+  scope: HubSpotConnectCimdClientScope;
+}
+interface HubSpotConnectCimdClientScope {
+  required: string[];
+  optional?: string[];
+}
+//#endregion
+//#region src/server/lovable/hubspot-connect/index.d.ts
+interface StartHubSpotConnectFunctionOptions {
+  client: HubSpotConnectCimdClientMetadata;
+}
+/**
+ * Lovable-style entry point for the hubspot-connect Deno function.
+ * Loads `HUBSPOT_APP_PRIVATE_KEY` via `secureStart`, then serves OAuth
+ * and CIMD routes under `/functions/v1/hubspot-connect`.
+ */
+declare function startHubSpotConnectFunction(options: StartHubSpotConnectFunctionOptions): Promise<void>;
+//#endregion
+//#region src/shared/logger.d.ts
+/**
+ * Pluggable logger contract used by the SDK on both the browser and
+ * server. Consumers can pass `console`-like loggers, structured
+ * loggers (pino / winston / etc.) or no-op stubs in tests.
+ */
+interface Logger {
+  debug: (message: string, ...args: unknown[]) => void;
+  info: (message: string, ...args: unknown[]) => void;
+  warn: (message: string, ...args: unknown[]) => void;
+  error: (message: string, ...args: unknown[]) => void;
+}
+//#endregion
+//#region src/server/hono/types.d.ts
+interface AppConnectRequestContext {
+  /**
+   * HubSpot API proxy.
+   */
+  proxy: HubSpotProxy;
+  /**
+   * HubSpot API client.
+   */
+  client: HubSpotClient;
+  /**
+   * Whether the browser session is authenticated.
+   */
+  authenticated: boolean;
+}
+interface AppConnectHonoBindings {
+  hubSpot: AppConnectRequestContext;
+}
+/**
+ * Hono environment shape used by handlers running inside a hubspot-
+ * connect request handler. Exposes the per-request
+ * {@link AppConnectRequestContext} as `c.env.hubSpot`.
+ */
+interface AppConnectHonoEnv {
+  Bindings: AppConnectHonoBindings;
+}
+//#endregion
+//#region src/server/lovable/create-app-function-start.d.ts
+type RegisterAppFunctionRoutesFunction = (app: Hono<AppConnectHonoEnv>) => void;
+interface CreateAppFunctionStartOptions {
+  /** Base path the user's routes are mounted under (e.g. `/functions/v1/api`). */
+  basePath: string;
+  /** Attach app routes to the SDK-owned Hono instance. */
+  registerRoutes: RegisterAppFunctionRoutesFunction;
+  /** Optional logger forwarded to `createAppConnectRequestHandler`. */
+  logger?: Logger;
+}
+type AppFunctionStart = (context: SecureStartContext) => Promise<void>;
+/**
+ * Builds a Deno-style `start({ appKeys })` entry point that boots a
+ * Hono app under `basePath`, wires the SDK's per-request HubSpot
+ * proxy via `createAppConnectRequestHandler`, and serves it with
+ * `Deno.serve` on `PORT`.
+ */
+declare function createAppFunctionStart(options: CreateAppFunctionStartOptions): AppFunctionStart;
+//#endregion
+export { type AppFunctionStart, type CreateAppFunctionStartOptions, type HubSpotConnectCimdClientMetadata, type RegisterAppFunctionRoutesFunction, type SecureStartContext, type SecureStartLoader, type StartHubSpotConnectFunctionOptions, createAppFunctionStart, secureStart, startHubSpotConnectFunction };
+//# sourceMappingURL=lovable.d.ts.map