@formbricks/hub 0.3.0 → 0.4.1

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

@@ -0,0 +1,473 @@
+import { APIResource } from "../../core/resource.js";
+import * as SearchAPI from "./search.js";
+import { Search, SearchPerformSemanticSearchParams, SearchPerformSemanticSearchResponse } from "./search.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Feedback record CRUD and search
+ */
+export declare class FeedbackRecords extends APIResource {
+    search: SearchAPI.Search;
+    /**
+     * Creates a new feedback record data point
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.create({
+     *     field_id: 'q1',
+     *     field_type: 'rating',
+     *     source_type: 'survey',
+     *     submission_id: '550e8400-e29b-41d4-a716-446655440000',
+     *     tenant_id: 'org-123',
+     *     field_label: 'How satisfied are you?',
+     *     language: 'en',
+     *     source_id: 'survey-123',
+     *     source_name: 'Q1 NPS Survey',
+     *     user_identifier: 'user-abc-123',
+     *     value_number: 9,
+     *   });
+     * ```
+     */
+    create(body: FeedbackRecordCreateParams, options?: RequestOptions): APIPromise<FeedbackRecordData>;
+    /**
+     * Retrieves a single feedback record data point by its UUID
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<FeedbackRecordData>;
+    /**
+     * Updates specific fields of a feedback record data point
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { value_text: 'Updated feedback text' },
+     *   );
+     * ```
+     */
+    update(id: string, body: FeedbackRecordUpdateParams, options?: RequestOptions): APIPromise<FeedbackRecordData>;
+    /**
+     * Lists feedback records with optional filters and pagination
+     *
+     * @example
+     * ```ts
+     * const feedbackRecords = await client.feedbackRecords.list({
+     *   tenant_id: 'org-123',
+     * });
+     * ```
+     */
+    list(query: FeedbackRecordListParams, options?: RequestOptions): APIPromise<FeedbackRecordListResponse>;
+    /**
+     * Permanently deletes a feedback record data point
+     *
+     * @example
+     * ```ts
+     * await client.feedbackRecords.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Permanently deletes all feedback record data points matching the specified
+     * user_identifier. This endpoint supports GDPR Article 17 (Right to Erasure)
+     * requests.
+     *
+     * @example
+     * ```ts
+     * const response = await client.feedbackRecords.bulkDelete({
+     *   user_identifier: 'user-abc-123',
+     * });
+     * ```
+     */
+    bulkDelete(params: FeedbackRecordBulkDeleteParams, options?: RequestOptions): APIPromise<FeedbackRecordBulkDeleteResponse>;
+    /**
+     * 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). When embeddings are disabled, this
+     * endpoint returns 503 Service Unavailable. The source feedback record must belong
+     * to the given tenant_id (enforced).
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.feedbackRecords.retrieveSimilar(
+     *     '018e1234-5678-9abc-def0-123456789abc',
+     *     { tenant_id: 'org-123' },
+     *   );
+     * ```
+     */
+    retrieveSimilar(id: string, query: FeedbackRecordRetrieveSimilarParams, options?: RequestOptions): APIPromise<FeedbackRecordRetrieveSimilarResponse>;
+}
+export interface FeedbackRecordData {
+    /**
+     * UUIDv7 primary key
+     */
+    id: string;
+    /**
+     * When the feedback was collected
+     */
+    collected_at: string;
+    /**
+     * When this record was created
+     */
+    created_at: string;
+    /**
+     * Identifier for the question/field
+     */
+    field_id: string;
+    /**
+     * Type of field
+     */
+    field_type: 'text' | 'categorical' | 'nps' | 'csat' | 'ces' | 'rating' | 'number' | 'boolean' | 'date';
+    /**
+     * Type of feedback source
+     */
+    source_type: string;
+    /**
+     * Identifier for the logical submission this record belongs to (required).
+     */
+    submission_id: string;
+    /**
+     * Tenant/organization identifier. NULL bytes not allowed.
+     */
+    tenant_id: string;
+    /**
+     * When this record was last updated
+     */
+    updated_at: string;
+    /**
+     * Stable identifier grouping related fields (for ranking, matrix, grid questions)
+     */
+    field_group_id?: string;
+    /**
+     * Human-readable question text for the group
+     */
+    field_group_label?: string;
+    /**
+     * The actual question text
+     */
+    field_label?: string;
+    /**
+     * ISO language code. NULL bytes not allowed.
+     */
+    language?: string;
+    /**
+     * Additional context
+     */
+    metadata?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Reference to survey/form/ticket ID
+     */
+    source_id?: string;
+    /**
+     * Human-readable name
+     */
+    source_name?: string;
+    /**
+     * User identifier
+     */
+    user_identifier?: string;
+    /**
+     * Boolean response
+     */
+    value_boolean?: boolean;
+    /**
+     * Date response
+     */
+    value_date?: string;
+    /**
+     * Numeric response
+     */
+    value_number?: number;
+    /**
+     * Text response. NULL bytes not allowed.
+     */
+    value_text?: string;
+}
+export interface FeedbackRecordListResponse {
+    /**
+     * List of feedback records
+     */
+    data: Array<FeedbackRecordData>;
+    /**
+     * Limit used in query
+     */
+    limit: number;
+    /**
+     * Opaque cursor for the next page (keyset paging). Present only when there may be
+     * more results. Use as the cursor query param for the next page.
+     */
+    next_cursor?: string;
+}
+export interface FeedbackRecordBulkDeleteResponse {
+    /**
+     * Number of records deleted
+     */
+    deleted_count: number;
+    /**
+     * Human-readable status message
+     */
+    message: string;
+}
+export interface FeedbackRecordRetrieveSimilarResponse {
+    /**
+     * List of feedback record IDs with similarity scores (0 = unrelated, 1 =
+     * identical). Consistent with list endpoints.
+     */
+    data: Array<FeedbackRecordRetrieveSimilarResponse.Data>;
+    /**
+     * Limit used in query (echoed for consistency with list endpoints)
+     */
+    limit: number;
+    /**
+     * Opaque cursor for the next page (keyset paging). Present only when there may be
+     * more results (full page returned). Omit when no next page. Use this exact value
+     * as the cursor query param for the next page.
+     */
+    next_cursor?: string;
+}
+export declare namespace FeedbackRecordRetrieveSimilarResponse {
+    interface Data {
+        /**
+         * Feedback record UUID
+         */
+        feedback_record_id: string;
+        /**
+         * Label of the feedback field (included in embedding for context). May be empty if
+         * the source record had no label.
+         */
+        field_label: string;
+        /**
+         * Similarity score (0..1)
+         */
+        score: number;
+        /**
+         * value_text of the feedback record (the text that was embedded). May be empty if
+         * the source had no text; embeddings are only created for records with non-empty
+         * value_text, but the field can be cleared after embedding creation.
+         */
+        value_text: string;
+    }
+}
+export interface FeedbackRecordCreateParams {
+    /**
+     * Identifier for the question/field. NULL bytes not allowed.
+     */
+    field_id: string;
+    /**
+     * Field type: text (enrichable), categorical, nps, csat, ces, rating, number,
+     * boolean, date
+     */
+    field_type: 'text' | 'categorical' | 'nps' | 'csat' | 'ces' | 'rating' | 'number' | 'boolean' | 'date';
+    /**
+     * Type of feedback source (e.g., survey, review, feedback_form). NULL bytes not
+     * allowed.
+     */
+    source_type: string;
+    /**
+     * Identifier for the logical submission this record belongs to (tenant-scoped).
+     * Required. Enables grouping multi-field submissions and idempotent ingestion.
+     * Unique per (tenant_id, submission_id, field_id). If a record has no logical
+     * submission, use e.g. field_id.
+     */
+    submission_id: string;
+    /**
+     * Tenant/organization identifier for multi-tenancy. Required.
+     */
+    tenant_id: string;
+    /**
+     * When the feedback was collected (defaults to now). Must be between 1970-01-01
+     * and 2080-12-31.
+     */
+    collected_at?: string;
+    /**
+     * Stable identifier grouping related fields (for ranking, matrix, grid questions).
+     * NULL bytes not allowed.
+     */
+    field_group_id?: string;
+    /**
+     * Human-readable question text for the group
+     */
+    field_group_label?: string | null;
+    /**
+     * The actual question text
+     */
+    field_label?: string | null;
+    /**
+     * ISO language code. NULL bytes not allowed.
+     */
+    language?: string;
+    /**
+     * User agent, device, location, referrer, tags, etc. NULL bytes (\x00 or \u0000)
+     * are not allowed in JSON keys or values.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Reference to survey/form/ticket ID
+     */
+    source_id?: string | null;
+    /**
+     * Human-readable name
+     */
+    source_name?: string | null;
+    /**
+     * Anonymous ID or email hash
+     */
+    user_identifier?: string;
+    /**
+     * For yes/no questions
+     */
+    value_boolean?: boolean;
+    /**
+     * For date responses. Must be between 1970-01-01 and 2080-12-31.
+     */
+    value_date?: string;
+    /**
+     * For ratings, NPS scores, numeric responses. Must be between -1e15 and +1e15.
+     */
+    value_number?: number;
+    /**
+     * For open-ended text responses. Omit or null if not applicable. NULL bytes not
+     * allowed when present.
+     */
+    value_text?: string | null;
+}
+export interface FeedbackRecordUpdateParams {
+    /**
+     * Update language. NULL bytes not allowed.
+     */
+    language?: string;
+    /**
+     * Update metadata. NULL bytes (\x00 or \u0000) are not allowed in JSON keys or
+     * values.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Update user identifier
+     */
+    user_identifier?: string;
+    /**
+     * Update boolean response
+     */
+    value_boolean?: boolean;
+    /**
+     * Update date response. Must be between 1970-01-01 and 2080-12-31.
+     */
+    value_date?: string;
+    /**
+     * Update numeric response. Must be between -1e15 and +1e15.
+     */
+    value_number?: number;
+    /**
+     * Update text response. NULL bytes not allowed.
+     */
+    value_text?: string;
+}
+export interface FeedbackRecordListParams {
+    /**
+     * Tenant ID (required for isolation). NULL bytes not allowed.
+     */
+    tenant_id: string;
+    /**
+     * Omit for the first page. For the next page, use the exact value from the
+     * previous response's next_cursor. Opaque (base64-encoded); keyset pagination.
+     */
+    cursor?: string;
+    /**
+     * Filter by field group ID (for ranking/matrix questions). NULL bytes not allowed.
+     */
+    field_group_id?: string;
+    /**
+     * Filter by field ID. NULL bytes not allowed.
+     */
+    field_id?: string;
+    /**
+     * Filter by field type. NULL bytes not allowed.
+     */
+    field_type?: 'text' | 'categorical' | 'nps' | 'csat' | 'ces' | 'rating' | 'number' | 'boolean' | 'date';
+    /**
+     * Number of results to return (max 1000)
+     */
+    limit?: number;
+    /**
+     * Filter by collected_at >= since (ISO 8601 format). Must be between 1970-01-01
+     * and 2080-12-31.
+     */
+    since?: string;
+    /**
+     * Filter by source ID (NULL bytes not allowed)
+     */
+    source_id?: string;
+    /**
+     * Filter by source type. NULL bytes not allowed.
+     */
+    source_type?: string;
+    /**
+     * Filter by submission ID to group records belonging to one logical submission.
+     * NULL bytes not allowed.
+     */
+    submission_id?: string;
+    /**
+     * Filter by collected_at <= until (ISO 8601 format). Must be between 1970-01-01
+     * and 2080-12-31.
+     */
+    until?: string;
+    /**
+     * Filter by user identifier. NULL bytes not allowed.
+     */
+    user_identifier?: string;
+}
+export interface FeedbackRecordBulkDeleteParams {
+    /**
+     * Delete all records matching this user identifier (required). NULL bytes not
+     * allowed.
+     */
+    user_identifier: string;
+    /**
+     * Filter by tenant ID (optional, for multi-tenant deployments). NULL bytes not
+     * allowed.
+     */
+    tenant_id?: string;
+}
+export interface FeedbackRecordRetrieveSimilarParams {
+    /**
+     * Tenant ID (required for isolation; must match feedback record tenant_id)
+     */
+    tenant_id: string;
+    /**
+     * Omit for the first page. For the next page, use the exact value from the
+     * previous response's next_cursor. Opaque (base64-encoded); keyset pagination.
+     */
+    cursor?: string;
+    /**
+     * Number of results to return (default 10, max 100). Consistent with list
+     * endpoints.
+     */
+    limit?: number;
+    /**
+     * Minimum similarity score (0..1); only results with score >= min_score are
+     * returned. Default 0.7 to reduce noise.
+     */
+    min_score?: number;
+}
+export declare namespace FeedbackRecords {
+    export { type FeedbackRecordData as FeedbackRecordData, type FeedbackRecordListResponse as FeedbackRecordListResponse, type FeedbackRecordBulkDeleteResponse as FeedbackRecordBulkDeleteResponse, type FeedbackRecordRetrieveSimilarResponse as FeedbackRecordRetrieveSimilarResponse, type FeedbackRecordCreateParams as FeedbackRecordCreateParams, type FeedbackRecordUpdateParams as FeedbackRecordUpdateParams, type FeedbackRecordListParams as FeedbackRecordListParams, type FeedbackRecordBulkDeleteParams as FeedbackRecordBulkDeleteParams, type FeedbackRecordRetrieveSimilarParams as FeedbackRecordRetrieveSimilarParams, };
+    export { Search as Search, type SearchPerformSemanticSearchResponse as SearchPerformSemanticSearchResponse, type SearchPerformSemanticSearchParams as SearchPerformSemanticSearchParams, };
+}
+//# sourceMappingURL=feedback-records.d.ts.map

package/resources/feedback-records/feedback-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-records.d.ts","sourceRoot":"","sources":["../../src/resources/feedback-records/feedback-records.ts"],"names":[],"mappings":"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"}

package/resources/feedback-records/feedback-records.js

@@ -0,0 +1,139 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedbackRecords = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const SearchAPI = tslib_1.__importStar(require("./search.js"));
+const search_1 = require("./search.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Feedback record CRUD and search
+ */
+class FeedbackRecords extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.search = new SearchAPI.Search(this._client);
+    }
+    /**
+     * Creates a new feedback record data point
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.create({
+     *     field_id: 'q1',
+     *     field_type: 'rating',
+     *     source_type: 'survey',
+     *     submission_id: '550e8400-e29b-41d4-a716-446655440000',
+     *     tenant_id: 'org-123',
+     *     field_label: 'How satisfied are you?',
+     *     language: 'en',
+     *     source_id: 'survey-123',
+     *     source_name: 'Q1 NPS Survey',
+     *     user_identifier: 'user-abc-123',
+     *     value_number: 9,
+     *   });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/feedback-records', { body, ...options });
+    }
+    /**
+     * Retrieves a single feedback record data point by its UUID
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/v1/feedback-records/${id}`, options);
+    }
+    /**
+     * Updates specific fields of a feedback record data point
+     *
+     * @example
+     * ```ts
+     * const feedbackRecordData =
+     *   await client.feedbackRecords.update(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { value_text: 'Updated feedback text' },
+     *   );
+     * ```
+     */
+    update(id, body, options) {
+        return this._client.patch((0, path_1.path) `/v1/feedback-records/${id}`, { body, ...options });
+    }
+    /**
+     * Lists feedback records with optional filters and pagination
+     *
+     * @example
+     * ```ts
+     * const feedbackRecords = await client.feedbackRecords.list({
+     *   tenant_id: 'org-123',
+     * });
+     * ```
+     */
+    list(query, options) {
+        return this._client.get('/v1/feedback-records', { query, ...options });
+    }
+    /**
+     * Permanently deletes a feedback record data point
+     *
+     * @example
+     * ```ts
+     * await client.feedbackRecords.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/v1/feedback-records/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Permanently deletes all feedback record data points matching the specified
+     * user_identifier. This endpoint supports GDPR Article 17 (Right to Erasure)
+     * requests.
+     *
+     * @example
+     * ```ts
+     * const response = await client.feedbackRecords.bulkDelete({
+     *   user_identifier: 'user-abc-123',
+     * });
+     * ```
+     */
+    bulkDelete(params, options) {
+        const { user_identifier, tenant_id } = params;
+        return this._client.delete('/v1/feedback-records', { query: { user_identifier, 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). When embeddings are disabled, this
+     * endpoint returns 503 Service Unavailable. The source feedback record must belong
+     * to the given tenant_id (enforced).
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.feedbackRecords.retrieveSimilar(
+     *     '018e1234-5678-9abc-def0-123456789abc',
+     *     { tenant_id: 'org-123' },
+     *   );
+     * ```
+     */
+    retrieveSimilar(id, query, options) {
+        return this._client.get((0, path_1.path) `/v1/feedback-records/${id}/similar`, { query, ...options });
+    }
+}
+exports.FeedbackRecords = FeedbackRecords;
+FeedbackRecords.Search = search_1.Search;
+//# sourceMappingURL=feedback-records.js.map

package/resources/feedback-records/feedback-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-records.js","sourceRoot":"","sources":["../../src/resources/feedback-records/feedback-records.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,+DAAsC;AACtC,wCAA0G;AAE1G,uDAAsD;AAEtD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,eAAgB,SAAQ,sBAAW;IAAhD;;QACE,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAwIhE,CAAC;IAtIC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,IAAgC,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,EAAU,EACV,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,KAA+B,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,EAAE,EAAE;YAC3D,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CACR,MAAsC,EACtC,OAAwB;QAExB,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,EAAU,EACV,KAA0C,EAC1C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;CACF;AAzID,0CAyIC;AA8aD,eAAe,CAAC,MAAM,GAAG,eAAM,CAAC"}