@formbricks/hub 0.4.4 → 0.5.1

package/resources/webhooks.mjs

@@ -10,12 +10,13 @@ export class Webhooks extends APIResource {
      * Creates a new webhook endpoint. When events occur (e.g.
      * feedback*record.created), the Hub POSTs a signed payload to the webhook URL. If
      * signing_key is omitted, a key is auto-generated (Standard Webhooks format,
-     * whsec*...). See WebhookDeliveryPayload for the payload structure sent to your
-     * URL.
+     * whsec*...). tenant_id is required; webhooks only receive events from that exact
+     * tenant. See WebhookDeliveryPayload for the payload structure sent to your URL.
      *
      * @example
      * ```ts
      * const webhook = await client.webhooks.create({
+     *   tenant_id: 'org-123',
      *   url: 'https://example.com/hub-events',
      *   enabled: true,
      *   event_types: [

package/resources/webhooks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.mjs","sourceRoot":"","sources":["../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"webhooks.mjs","sourceRoot":"","sources":["../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,IAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,gBAAgB,EAAE,EAAE,EAAE;YACnD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.d.mts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,sCAAkC"}

package/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,qCAAkC"}

package/resources.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":""}
+{"version":3,"file":"resources.mjs","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":"AAAA,sCAAkC"}

package/src/client.ts

@@ -190,6 +190,18 @@ export class FormbricksHub {
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
+    const customHeadersEnv = readEnv('FORMBRICKS_HUB_CUSTOM_HEADERS');
+    if (customHeadersEnv) {
+      const parsed: Record<string, string> = {};
+      for (const line of customHeadersEnv.split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon >= 0) {
+          parsed[line.substring(0, colon).trim()] = line.substring(colon + 1).trim();
+        }
+      }
+      options.defaultHeaders = { ...parsed, ...options.defaultHeaders };
+    }
+
     this._options = options;
 
     this.apiKey = apiKey;

package/src/internal/types.ts

@@ -40,7 +40,6 @@ type OverloadedParameters<T> =
   : T extends (...args: infer A) => unknown ? A
   : never;
 
-/* eslint-disable */
 /**
  * These imports attempt to get types from a parent package's dependencies.
  * Unresolved bare specifiers can trigger [automatic type acquisition][1] in some projects, which
@@ -63,19 +62,18 @@ type OverloadedParameters<T> =
  *
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
  */
-/** @ts-ignore For users with \@types/node */
+/** @ts-ignore For users with \@types/node */ /* prettier-ignore */
 type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
-/** @ts-ignore For users with undici */
+/** @ts-ignore For users with undici */ /* prettier-ignore */
 type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
-/** @ts-ignore For users with \@types/bun */
+/** @ts-ignore For users with \@types/bun */ /* prettier-ignore */
 type BunRequestInit = globalThis.FetchRequestInit;
-/** @ts-ignore For users with node-fetch@2 */
+/** @ts-ignore For users with node-fetch@2 */ /* prettier-ignore */
 type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
-/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
+/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */ /* prettier-ignore */
 type NodeFetch3RequestInit =  NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
-/** @ts-ignore For users who use Deno */
+/** @ts-ignore For users who use Deno */ /* prettier-ignore */
 type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
-/* eslint-enable */
 
 type RequestInits =
   | NotAny<UndiciTypesRequestInit>

package/src/internal/utils/log.ts

@@ -107,6 +107,8 @@ export const formatRequestDetails = (details: {
           name,
           (
             name.toLowerCase() === 'authorization' ||
+            name.toLowerCase() === 'api-key' ||
+            name.toLowerCase() === 'x-api-key' ||
             name.toLowerCase() === 'cookie' ||
             name.toLowerCase() === 'set-cookie'
           ) ?

package/src/resources/feedback-records/feedback-records.ts

@@ -30,7 +30,7 @@ export class FeedbackRecords extends APIResource {
    *     language: 'en',
    *     source_id: 'survey-123',
    *     source_name: 'Q1 NPS Survey',
-   *     user_identifier: 'user-abc-123',
+   *     user_id: 'user-abc-123',
    *     value_number: 9,
    *   });
    * ```
@@ -75,7 +75,8 @@ export class FeedbackRecords extends APIResource {
   }
 
   /**
-   * Lists feedback records with optional filters and pagination
+   * Lists feedback records for a required tenant_id with optional additional filters
+   * and pagination
    *
    * @example
    * ```ts
@@ -106,14 +107,15 @@ export class FeedbackRecords extends APIResource {
   }
 
   /**
-   * Permanently deletes all feedback record data points matching the specified
-   * user_identifier. This endpoint supports GDPR Article 17 (Right to Erasure)
-   * requests.
+   * Permanently deletes feedback record data points matching the specified user_id.
+   * Omit tenant_id to delete that user_id across all tenants for GDPR Article 17
+   * (Right to Erasure) requests. Provide tenant_id to restrict deletion to that
+   * tenant only.
    *
    * @example
    * ```ts
    * const response = await client.feedbackRecords.bulkDelete({
-   *   user_identifier: 'user-abc-123',
+   *   user_id: 'user-abc-123',
    * });
    * ```
    */
@@ -121,15 +123,16 @@ export class FeedbackRecords extends APIResource {
     params: FeedbackRecordBulkDeleteParams,
     options?: RequestOptions,
   ): APIPromise<FeedbackRecordBulkDeleteResponse> {
-    const { user_identifier, tenant_id } = params;
-    return this._client.delete('/v1/feedback-records', { query: { user_identifier, tenant_id }, ...options });
+    const { user_id, tenant_id } = params;
+    return this._client.delete('/v1/feedback-records', { query: { user_id, tenant_id }, ...options });
   }
 
   /**
    * Returns feedback record IDs and similarity scores for records similar to the
    * given one (by embedding). **Only available when embeddings are configured**
    * (EMBEDDING_PROVIDER and EMBEDDING_MODEL set). Supported providers: openai,
-   * google (AI Studio), google-vertex. When embeddings are disabled, this endpoint
+   * google (Gemini Developer API / Google AI Studio), google-gemini (Gemini
+   * Enterprise Agent Platform API). When embeddings are disabled, this endpoint
    * returns 503 Service Unavailable. The source feedback record must belong to the
    * given tenant_id (enforced).
    *
@@ -233,9 +236,9 @@ export interface FeedbackRecordData {
   source_name?: string;
 
   /**
-   * User identifier
+   * User ID (e.g., anonymous ID or email hash)
    */
-  user_identifier?: string;
+  user_id?: string;
 
   /**
    * Boolean response
@@ -410,9 +413,9 @@ export interface FeedbackRecordCreateParams {
   source_name?: string | null;
 
   /**
-   * Anonymous ID or email hash
+   * User ID (e.g., anonymous ID or email hash)
    */
-  user_identifier?: string;
+  user_id?: string;
 
   /**
    * For yes/no questions
@@ -449,9 +452,9 @@ export interface FeedbackRecordUpdateParams {
   metadata?: { [key: string]: unknown };
 
   /**
-   * Update user identifier
+   * User ID (e.g., anonymous ID or email hash)
    */
-  user_identifier?: string;
+  user_id?: string;
 
   /**
    * Update boolean response
@@ -535,21 +538,21 @@ export interface FeedbackRecordListParams {
   until?: string;
 
   /**
-   * Filter by user identifier. NULL bytes not allowed.
+   * Filter by user ID. NULL bytes not allowed.
    */
-  user_identifier?: string;
+  user_id?: string;
 }
 
 export interface FeedbackRecordBulkDeleteParams {
   /**
-   * Delete all records matching this user identifier (required). NULL bytes not
-   * allowed.
+   * Delete records matching this user ID (required). NULL bytes not allowed.
    */
-  user_identifier: string;
+  user_id: string;
 
   /**
-   * Filter by tenant ID (optional, for multi-tenant deployments). NULL bytes not
-   * allowed.
+   * Optional tenant scope. Omit this parameter to delete all records matching
+   * user_id across tenants; provide it to delete only records for this tenant. Empty
+   * strings and NULL bytes are not allowed.
    */
   tenant_id?: string;
 }

package/src/resources/feedback-records/search.ts

@@ -12,7 +12,8 @@ export class Search extends APIResource {
    * Embeds the search query and returns feedback record IDs with similarity scores
    * (cosine, 0..1). **Only available when embeddings are configured**
    * (EMBEDDING_PROVIDER and EMBEDDING_MODEL set). Supported providers: openai,
-   * google (AI Studio), google-vertex. When embeddings are disabled, this endpoint
+   * google (Gemini Developer API / Google AI Studio), google-gemini (Gemini
+   * Enterprise Agent Platform API). When embeddings are disabled, this endpoint
    * returns 503 Service Unavailable. Request body must include query and tenant_id
    * (required for tenant isolation).
    *

package/src/resources/webhooks.ts

@@ -14,12 +14,13 @@ export class Webhooks extends APIResource {
    * Creates a new webhook endpoint. When events occur (e.g.
    * feedback*record.created), the Hub POSTs a signed payload to the webhook URL. If
    * signing_key is omitted, a key is auto-generated (Standard Webhooks format,
-   * whsec*...). See WebhookDeliveryPayload for the payload structure sent to your
-   * URL.
+   * whsec*...). tenant_id is required; webhooks only receive events from that exact
+   * tenant. See WebhookDeliveryPayload for the payload structure sent to your URL.
    *
    * @example
    * ```ts
    * const webhook = await client.webhooks.create({
+   *   tenant_id: 'org-123',
    *   url: 'https://example.com/hub-events',
    *   enabled: true,
    *   event_types: [
@@ -360,6 +361,12 @@ export namespace WebhookListResponse {
 }
 
 export interface WebhookCreateParams {
+  /**
+   * Tenant/organization identifier. Required for webhook isolation; NULL bytes not
+   * allowed.
+   */
+  tenant_id: string;
+
   /**
    * URL to receive webhook POSTs. Must be an HTTP or HTTPS URL. NULL bytes not
    * allowed.
@@ -390,11 +397,6 @@ export interface WebhookCreateParams {
    * allowed.
    */
   signing_key?: string;
-
-  /**
-   * Tenant/organization identifier. NULL bytes not allowed.
-   */
-  tenant_id?: string;
 }
 
 export interface WebhookUpdateParams {
@@ -422,10 +424,9 @@ export interface WebhookUpdateParams {
   signing_key?: string;
 
   /**
-   * Omit or send null to leave unchanged. Send empty string to clear (store as
-   * null).
+   * Omit to leave unchanged. Empty strings are rejected; webhooks cannot be global.
    */
-  tenant_id?: string | null;
+  tenant_id?: string;
 
   /**
    * New webhook URL. Must be an HTTP or HTTPS URL. NULL bytes not allowed.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.4.4'; // x-release-please-version
+export const VERSION = '0.5.1'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.4";
+export declare const VERSION = "0.5.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.4";
+export declare const VERSION = "0.5.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.4.4'; // x-release-please-version
+exports.VERSION = '0.5.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.4.4'; // x-release-please-version
+export const VERSION = '0.5.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map