@metamask-previews/analytics-privacy-controller 0.0.0-preview-fa81dffb

package/dist/AnalyticsPrivacyService.mjs

@@ -0,0 +1,248 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AnalyticsPrivacyService_messenger, _AnalyticsPrivacyService_fetch, _AnalyticsPrivacyService_segmentSourceId, _AnalyticsPrivacyService_segmentRegulationsEndpoint, _AnalyticsPrivacyService_policy;
+import { createServicePolicy, HttpError } from "@metamask/controller-utils";
+import { projectLogger as log } from "./AnalyticsPrivacyLogger.mjs";
+import { SEGMENT_REGULATION_TYPE_DELETE_ONLY, SEGMENT_SUBJECT_TYPE_USER_ID, SEGMENT_CONTENT_TYPE } from "./constants.mjs";
+import { DataDeleteResponseStatus, DataDeleteStatus } from "./types.mjs";
+// === GENERAL ===
+/**
+ * The name of the {@link AnalyticsPrivacyService}, used to namespace the
+ * service's actions and events.
+ */
+export const serviceName = 'AnalyticsPrivacyService';
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = [
+    'createDataDeletionTask',
+    'checkDataDeleteStatus',
+];
+/**
+ * This service object is responsible for making requests to the Segment Regulations API
+ * via a proxy endpoint for GDPR/CCPA data deletion functionality.
+ *
+ * @example
+ *
+ * ```ts
+ * import { Messenger } from '@metamask/messenger';
+ * import type {
+ *   AnalyticsPrivacyServiceActions,
+ *   AnalyticsPrivacyServiceEvents,
+ * } from '@metamask/analytics-privacy-controller';
+ *
+ * const rootMessenger = new Messenger<
+ *   'Root',
+ *   AnalyticsPrivacyServiceActions,
+ *   AnalyticsPrivacyServiceEvents
+ * >({ namespace: 'Root' });
+ * const serviceMessenger = new Messenger<
+ *   'AnalyticsPrivacyService',
+ *   AnalyticsPrivacyServiceActions,
+ *   AnalyticsPrivacyServiceEvents,
+ *   typeof rootMessenger,
+ * >({
+ *   namespace: 'AnalyticsPrivacyService',
+ *   parent: rootMessenger,
+ * });
+ * // Instantiate the service to register its actions on the messenger
+ * new AnalyticsPrivacyService({
+ *   messenger: serviceMessenger,
+ *   fetch,
+ *   segmentSourceId: 'abc123',
+ *   segmentRegulationsEndpoint: 'https://proxy.example.com/v1beta',
+ * });
+ *
+ * // Later...
+ * // Create a data deletion task
+ * const response = await rootMessenger.call(
+ *   'AnalyticsPrivacyService:createDataDeletionTask',
+ *   'user-analytics-id',
+ * );
+ * ```
+ */
+export class AnalyticsPrivacyService {
+    /**
+     * Constructs a new AnalyticsPrivacyService object.
+     *
+     * @param options - The constructor options.
+     */
+    constructor(options) {
+        /**
+         * The messenger suited for this service.
+         */
+        _AnalyticsPrivacyService_messenger.set(this, void 0);
+        /**
+         * A function that can be used to make an HTTP request.
+         */
+        _AnalyticsPrivacyService_fetch.set(this, void 0);
+        /**
+         * Segment API source ID.
+         */
+        _AnalyticsPrivacyService_segmentSourceId.set(this, void 0);
+        /**
+         * Base URL for the proxy endpoint.
+         */
+        _AnalyticsPrivacyService_segmentRegulationsEndpoint.set(this, void 0);
+        /**
+         * The policy that wraps the request.
+         *
+         * @see {@link createServicePolicy}
+         */
+        _AnalyticsPrivacyService_policy.set(this, void 0);
+        this.name = serviceName;
+        __classPrivateFieldSet(this, _AnalyticsPrivacyService_messenger, options.messenger, "f");
+        __classPrivateFieldSet(this, _AnalyticsPrivacyService_fetch, options.fetch, "f");
+        __classPrivateFieldSet(this, _AnalyticsPrivacyService_segmentSourceId, options.segmentSourceId, "f");
+        __classPrivateFieldSet(this, _AnalyticsPrivacyService_segmentRegulationsEndpoint, options.segmentRegulationsEndpoint, "f");
+        __classPrivateFieldSet(this, _AnalyticsPrivacyService_policy, createServicePolicy(options.policyOptions ?? {}), "f");
+        __classPrivateFieldGet(this, _AnalyticsPrivacyService_messenger, "f").registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+    }
+    /**
+     * Registers a handler that will be called after a request returns a non-500
+     * response, causing a retry. Primarily useful in tests where timers are being
+     * mocked.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onRetry(listener) {
+        return __classPrivateFieldGet(this, _AnalyticsPrivacyService_policy, "f").onRetry(listener);
+    }
+    /**
+     * Registers a handler that will be called after a set number of retry rounds
+     * prove that requests to the API endpoint consistently return a 5xx response.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     * @see {@link createServicePolicy}
+     */
+    onBreak(listener) {
+        return __classPrivateFieldGet(this, _AnalyticsPrivacyService_policy, "f").onBreak(listener);
+    }
+    /**
+     * Registers a handler that will be called under one of two circumstances:
+     *
+     * 1. After a set number of retries prove that requests to the API
+     * consistently result in failures.
+     * 2. After a successful request is made to the API, but the response takes
+     * longer than a set duration to return.
+     *
+     * @param listener - The handler to be called.
+     * @returns An object that can be used to unregister the handler.
+     */
+    onDegraded(listener) {
+        return __classPrivateFieldGet(this, _AnalyticsPrivacyService_policy, "f").onDegraded(listener);
+    }
+    /**
+     * Creates a DELETE_ONLY regulation for the given analyticsId.
+     *
+     * @param analyticsId - The analytics ID of the user for whom to create the deletion task.
+     * @returns Promise resolving to the deletion regulation response.
+     */
+    async createDataDeletionTask(analyticsId) {
+        if (!__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentSourceId, "f") || !__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentRegulationsEndpoint, "f")) {
+            return {
+                status: DataDeleteResponseStatus.Failure,
+                error: 'Segment API source ID or endpoint not found',
+            };
+        }
+        try {
+            const url = `${__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentRegulationsEndpoint, "f")}/regulations/sources/${__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentSourceId, "f")}`;
+            const body = JSON.stringify({
+                regulationType: SEGMENT_REGULATION_TYPE_DELETE_ONLY,
+                subjectType: SEGMENT_SUBJECT_TYPE_USER_ID,
+                subjectIds: [analyticsId],
+            });
+            const response = await __classPrivateFieldGet(this, _AnalyticsPrivacyService_policy, "f").execute(async () => {
+                const localResponse = await __classPrivateFieldGet(this, _AnalyticsPrivacyService_fetch, "f").call(this, url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': SEGMENT_CONTENT_TYPE,
+                    },
+                    body,
+                });
+                if (!localResponse.ok) {
+                    throw new HttpError(localResponse.status, `Creating data deletion task failed with status '${localResponse.status}'`);
+                }
+                return localResponse;
+            });
+            const jsonResponse = (await response.json());
+            if (jsonResponse?.data?.data?.regulateId &&
+                typeof jsonResponse.data.data.regulateId === 'string') {
+                return {
+                    status: DataDeleteResponseStatus.Success,
+                    regulateId: jsonResponse.data.data.regulateId,
+                };
+            }
+            log('Analytics Deletion Task Error', new Error('Malformed response from Segment API'));
+            return {
+                status: DataDeleteResponseStatus.Failure,
+                error: 'Analytics Deletion Task Error',
+            };
+        }
+        catch (error) {
+            log('Analytics Deletion Task Error', error);
+            return {
+                status: DataDeleteResponseStatus.Failure,
+                error: 'Analytics Deletion Task Error',
+            };
+        }
+    }
+    /**
+     * Checks the status of a regulation by ID.
+     *
+     * @param regulationId - The regulation ID to check.
+     * @returns Promise resolving to the regulation status response.
+     */
+    async checkDataDeleteStatus(regulationId) {
+        // Early return if regulationId is missing (cannot check status) or endpoint is not configured
+        if (!regulationId || !__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentRegulationsEndpoint, "f")) {
+            return {
+                status: DataDeleteResponseStatus.Failure,
+                dataDeleteStatus: DataDeleteStatus.Unknown,
+            };
+        }
+        try {
+            const url = `${__classPrivateFieldGet(this, _AnalyticsPrivacyService_segmentRegulationsEndpoint, "f")}/regulations/${regulationId}`;
+            const response = await __classPrivateFieldGet(this, _AnalyticsPrivacyService_policy, "f").execute(async () => {
+                const localResponse = await __classPrivateFieldGet(this, _AnalyticsPrivacyService_fetch, "f").call(this, url, {
+                    method: 'GET',
+                    headers: {
+                        'Content-Type': SEGMENT_CONTENT_TYPE,
+                    },
+                });
+                if (!localResponse.ok) {
+                    throw new HttpError(localResponse.status, `Checking data deletion status failed with status '${localResponse.status}'`);
+                }
+                return localResponse;
+            });
+            const jsonResponse = (await response.json());
+            const rawStatus = jsonResponse?.data?.data?.regulation?.overallStatus;
+            const dataDeleteStatus = Object.values(DataDeleteStatus).includes(rawStatus)
+                ? rawStatus
+                : DataDeleteStatus.Unknown;
+            return {
+                status: DataDeleteResponseStatus.Success,
+                dataDeleteStatus,
+            };
+        }
+        catch (error) {
+            log('Analytics Deletion Task Check Error', error);
+            return {
+                status: DataDeleteResponseStatus.Failure,
+                dataDeleteStatus: DataDeleteStatus.Unknown,
+            };
+        }
+    }
+}
+_AnalyticsPrivacyService_messenger = new WeakMap(), _AnalyticsPrivacyService_fetch = new WeakMap(), _AnalyticsPrivacyService_segmentSourceId = new WeakMap(), _AnalyticsPrivacyService_segmentRegulationsEndpoint = new WeakMap(), _AnalyticsPrivacyService_policy = new WeakMap();
+//# sourceMappingURL=AnalyticsPrivacyService.mjs.map

package/dist/AnalyticsPrivacyService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPrivacyService.mjs","sourceRoot":"","sources":["../src/AnalyticsPrivacyService.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  CreateServicePolicyOptions,\n  ServicePolicy,\n} from '@metamask/controller-utils';\nimport { createServicePolicy, HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { IDisposable } from 'cockatiel';\n\nimport { projectLogger as log } from './AnalyticsPrivacyLogger';\nimport type { AnalyticsPrivacyServiceMethodActions } from './AnalyticsPrivacyService-method-action-types';\nimport {\n  SEGMENT_REGULATION_TYPE_DELETE_ONLY,\n  SEGMENT_SUBJECT_TYPE_USER_ID,\n  SEGMENT_CONTENT_TYPE,\n} from './constants';\nimport { DataDeleteResponseStatus, DataDeleteStatus } from './types';\nimport type {\n  IDeleteRegulationResponse,\n  IDeleteRegulationStatusResponse,\n} from './types';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link AnalyticsPrivacyService}, used to namespace the\n * service's actions and events.\n */\nexport const serviceName = 'AnalyticsPrivacyService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'createDataDeletionTask',\n  'checkDataDeleteStatus',\n] as const;\n\n/**\n * Actions that {@link AnalyticsPrivacyService} exposes to other consumers.\n */\nexport type AnalyticsPrivacyServiceActions =\n  AnalyticsPrivacyServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link AnalyticsPrivacyServiceMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Events that {@link AnalyticsPrivacyService} exposes to other consumers.\n */\nexport type AnalyticsPrivacyServiceEvents = never;\n\n/**\n * Events from other messengers that {@link AnalyticsPrivacyService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link AnalyticsPrivacyService}.\n */\nexport type AnalyticsPrivacyServiceMessenger = Messenger<\n  typeof serviceName,\n  AnalyticsPrivacyServiceActions | AllowedActions,\n  AnalyticsPrivacyServiceEvents | AllowedEvents\n>;\n\n// === SERVICE DEFINITION ===\n\n/**\n * Response structure from Segment API for creating a regulation.\n */\ntype CreateRegulationResponse = {\n  data: {\n    data: {\n      regulateId: string;\n    };\n  };\n};\n\n/**\n * Response structure from Segment API for getting regulation status.\n */\ntype GetRegulationStatusResponse = {\n  data: {\n    data: {\n      regulation: {\n        overallStatus: string;\n      };\n    };\n  };\n};\n\n/**\n * Options for constructing {@link AnalyticsPrivacyService}.\n */\nexport type AnalyticsPrivacyServiceOptions = {\n  /**\n   * The messenger suited for this service.\n   */\n  messenger: AnalyticsPrivacyServiceMessenger;\n\n  /**\n   * A function that can be used to make an HTTP request.\n   */\n  fetch: typeof fetch;\n\n  /**\n   * Segment API source ID (required for creating regulations).\n   */\n  segmentSourceId: string;\n\n  /**\n   * Base URL for the proxy endpoint (not Segment API directly).\n   * The proxy forwards requests to Segment API and adds authentication tokens.\n   */\n  segmentRegulationsEndpoint: string;\n\n  /**\n   * Options to pass to `createServicePolicy`, which is used to wrap each request.\n   */\n  policyOptions?: CreateServicePolicyOptions;\n};\n\n/**\n * This service object is responsible for making requests to the Segment Regulations API\n * via a proxy endpoint for GDPR/CCPA data deletion functionality.\n *\n * @example\n *\n * ```ts\n * import { Messenger } from '@metamask/messenger';\n * import type {\n *   AnalyticsPrivacyServiceActions,\n *   AnalyticsPrivacyServiceEvents,\n * } from '@metamask/analytics-privacy-controller';\n *\n * const rootMessenger = new Messenger<\n *   'Root',\n *   AnalyticsPrivacyServiceActions,\n *   AnalyticsPrivacyServiceEvents\n * >({ namespace: 'Root' });\n * const serviceMessenger = new Messenger<\n *   'AnalyticsPrivacyService',\n *   AnalyticsPrivacyServiceActions,\n *   AnalyticsPrivacyServiceEvents,\n *   typeof rootMessenger,\n * >({\n *   namespace: 'AnalyticsPrivacyService',\n *   parent: rootMessenger,\n * });\n * // Instantiate the service to register its actions on the messenger\n * new AnalyticsPrivacyService({\n *   messenger: serviceMessenger,\n *   fetch,\n *   segmentSourceId: 'abc123',\n *   segmentRegulationsEndpoint: 'https://proxy.example.com/v1beta',\n * });\n *\n * // Later...\n * // Create a data deletion task\n * const response = await rootMessenger.call(\n *   'AnalyticsPrivacyService:createDataDeletionTask',\n *   'user-analytics-id',\n * );\n * ```\n */\nexport class AnalyticsPrivacyService {\n  /**\n   * The name of the service.\n   */\n  readonly name: typeof serviceName;\n\n  /**\n   * The messenger suited for this service.\n   */\n  readonly #messenger: AnalyticsPrivacyServiceMessenger;\n\n  /**\n   * A function that can be used to make an HTTP request.\n   */\n  readonly #fetch: typeof fetch;\n\n  /**\n   * Segment API source ID.\n   */\n  readonly #segmentSourceId: string;\n\n  /**\n   * Base URL for the proxy endpoint.\n   */\n  readonly #segmentRegulationsEndpoint: string;\n\n  /**\n   * The policy that wraps the request.\n   *\n   * @see {@link createServicePolicy}\n   */\n  readonly #policy: ServicePolicy;\n\n  /**\n   * Constructs a new AnalyticsPrivacyService object.\n   *\n   * @param options - The constructor options.\n   */\n  constructor(options: AnalyticsPrivacyServiceOptions) {\n    this.name = serviceName;\n    this.#messenger = options.messenger;\n    this.#fetch = options.fetch;\n    this.#segmentSourceId = options.segmentSourceId;\n    this.#segmentRegulationsEndpoint = options.segmentRegulationsEndpoint;\n    this.#policy = createServicePolicy(options.policyOptions ?? {});\n\n    this.#messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Registers a handler that will be called after a request returns a non-500\n   * response, causing a retry. Primarily useful in tests where timers are being\n   * mocked.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   * @see {@link createServicePolicy}\n   */\n  onRetry(listener: Parameters<ServicePolicy['onRetry']>[0]): IDisposable {\n    return this.#policy.onRetry(listener);\n  }\n\n  /**\n   * Registers a handler that will be called after a set number of retry rounds\n   * prove that requests to the API endpoint consistently return a 5xx response.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   * @see {@link createServicePolicy}\n   */\n  onBreak(listener: Parameters<ServicePolicy['onBreak']>[0]): IDisposable {\n    return this.#policy.onBreak(listener);\n  }\n\n  /**\n   * Registers a handler that will be called under one of two circumstances:\n   *\n   * 1. After a set number of retries prove that requests to the API\n   * consistently result in failures.\n   * 2. After a successful request is made to the API, but the response takes\n   * longer than a set duration to return.\n   *\n   * @param listener - The handler to be called.\n   * @returns An object that can be used to unregister the handler.\n   */\n  onDegraded(\n    listener: Parameters<ServicePolicy['onDegraded']>[0],\n  ): IDisposable {\n    return this.#policy.onDegraded(listener);\n  }\n\n  /**\n   * Creates a DELETE_ONLY regulation for the given analyticsId.\n   *\n   * @param analyticsId - The analytics ID of the user for whom to create the deletion task.\n   * @returns Promise resolving to the deletion regulation response.\n   */\n  async createDataDeletionTask(\n    analyticsId: string,\n  ): Promise<IDeleteRegulationResponse> {\n    if (!this.#segmentSourceId || !this.#segmentRegulationsEndpoint) {\n      return {\n        status: DataDeleteResponseStatus.Failure,\n        error: 'Segment API source ID or endpoint not found',\n      };\n    }\n\n    try {\n      const url = `${this.#segmentRegulationsEndpoint}/regulations/sources/${this.#segmentSourceId}`;\n      const body = JSON.stringify({\n        regulationType: SEGMENT_REGULATION_TYPE_DELETE_ONLY,\n        subjectType: SEGMENT_SUBJECT_TYPE_USER_ID,\n        subjectIds: [analyticsId],\n      });\n\n      const response = await this.#policy.execute(async () => {\n        const localResponse = await this.#fetch(url, {\n          method: 'POST',\n          headers: {\n            'Content-Type': SEGMENT_CONTENT_TYPE,\n          },\n          body,\n        });\n\n        if (!localResponse.ok) {\n          throw new HttpError(\n            localResponse.status,\n            `Creating data deletion task failed with status '${localResponse.status}'`,\n          );\n        }\n\n        return localResponse;\n      });\n\n      const jsonResponse = (await response.json()) as CreateRegulationResponse;\n\n      if (\n        jsonResponse?.data?.data?.regulateId &&\n        typeof jsonResponse.data.data.regulateId === 'string'\n      ) {\n        return {\n          status: DataDeleteResponseStatus.Success,\n          regulateId: jsonResponse.data.data.regulateId,\n        };\n      }\n\n      log(\n        'Analytics Deletion Task Error',\n        new Error('Malformed response from Segment API'),\n      );\n      return {\n        status: DataDeleteResponseStatus.Failure,\n        error: 'Analytics Deletion Task Error',\n      };\n    } catch (error) {\n      log('Analytics Deletion Task Error', error);\n      return {\n        status: DataDeleteResponseStatus.Failure,\n        error: 'Analytics Deletion Task Error',\n      };\n    }\n  }\n\n  /**\n   * Checks the status of a regulation by ID.\n   *\n   * @param regulationId - The regulation ID to check.\n   * @returns Promise resolving to the regulation status response.\n   */\n  async checkDataDeleteStatus(\n    regulationId: string,\n  ): Promise<IDeleteRegulationStatusResponse> {\n    // Early return if regulationId is missing (cannot check status) or endpoint is not configured\n    if (!regulationId || !this.#segmentRegulationsEndpoint) {\n      return {\n        status: DataDeleteResponseStatus.Failure,\n        dataDeleteStatus: DataDeleteStatus.Unknown,\n      };\n    }\n\n    try {\n      const url = `${this.#segmentRegulationsEndpoint}/regulations/${regulationId}`;\n\n      const response = await this.#policy.execute(async () => {\n        const localResponse = await this.#fetch(url, {\n          method: 'GET',\n          headers: {\n            'Content-Type': SEGMENT_CONTENT_TYPE,\n          },\n        });\n\n        if (!localResponse.ok) {\n          throw new HttpError(\n            localResponse.status,\n            `Checking data deletion status failed with status '${localResponse.status}'`,\n          );\n        }\n\n        return localResponse;\n      });\n\n      const jsonResponse =\n        (await response.json()) as GetRegulationStatusResponse;\n\n      const rawStatus = jsonResponse?.data?.data?.regulation?.overallStatus;\n      const dataDeleteStatus = Object.values(DataDeleteStatus).includes(\n        rawStatus as DataDeleteStatus,\n      )\n        ? (rawStatus as DataDeleteStatus)\n        : DataDeleteStatus.Unknown;\n\n      return {\n        status: DataDeleteResponseStatus.Success,\n        dataDeleteStatus,\n      };\n    } catch (error) {\n      log('Analytics Deletion Task Check Error', error);\n      return {\n        status: DataDeleteResponseStatus.Failure,\n        dataDeleteStatus: DataDeleteStatus.Unknown,\n      };\n    }\n  }\n}\n"]}

package/dist/constants.cjs

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Constants used by the analytics privacy controller and service.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEGMENT_CONTENT_TYPE = exports.SEGMENT_SUBJECT_TYPE_USER_ID = exports.SEGMENT_REGULATION_TYPE_DELETE_ONLY = void 0;
+/**
+ * Segment API regulation type for DELETE_ONLY operations.
+ */
+exports.SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';
+/**
+ * Segment API subject type for user ID operations.
+ */
+exports.SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';
+/**
+ * Segment API Content-Type header value.
+ */
+exports.SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';
+//# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACU,QAAA,mCAAmC,GAAG,aAAa,CAAC;AAEjE;;GAEG;AACU,QAAA,4BAA4B,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACU,QAAA,oBAAoB,GAAG,iCAAiC,CAAC","sourcesContent":["/**\n * Constants used by the analytics privacy controller and service.\n */\n\n/**\n * Segment API regulation type for DELETE_ONLY operations.\n */\nexport const SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';\n\n/**\n * Segment API subject type for user ID operations.\n */\nexport const SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';\n\n/**\n * Segment API Content-Type header value.\n */\nexport const SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';\n"]}

package/dist/constants.d.cts

@@ -0,0 +1,16 @@
+/**
+ * Constants used by the analytics privacy controller and service.
+ */
+/**
+ * Segment API regulation type for DELETE_ONLY operations.
+ */
+export declare const SEGMENT_REGULATION_TYPE_DELETE_ONLY = "DELETE_ONLY";
+/**
+ * Segment API subject type for user ID operations.
+ */
+export declare const SEGMENT_SUBJECT_TYPE_USER_ID = "USER_ID";
+/**
+ * Segment API Content-Type header value.
+ */
+export declare const SEGMENT_CONTENT_TYPE = "application/vnd.segment.v1+json";
+//# sourceMappingURL=constants.d.cts.map

package/dist/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,mCAAmC,gBAAgB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB,oCAAoC,CAAC"}

package/dist/constants.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Constants used by the analytics privacy controller and service.
+ */
+/**
+ * Segment API regulation type for DELETE_ONLY operations.
+ */
+export declare const SEGMENT_REGULATION_TYPE_DELETE_ONLY = "DELETE_ONLY";
+/**
+ * Segment API subject type for user ID operations.
+ */
+export declare const SEGMENT_SUBJECT_TYPE_USER_ID = "USER_ID";
+/**
+ * Segment API Content-Type header value.
+ */
+export declare const SEGMENT_CONTENT_TYPE = "application/vnd.segment.v1+json";
+//# sourceMappingURL=constants.d.mts.map

package/dist/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,mCAAmC,gBAAgB,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB,oCAAoC,CAAC"}

package/dist/constants.mjs

@@ -0,0 +1,16 @@
+/**
+ * Constants used by the analytics privacy controller and service.
+ */
+/**
+ * Segment API regulation type for DELETE_ONLY operations.
+ */
+export const SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';
+/**
+ * Segment API subject type for user ID operations.
+ */
+export const SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';
+/**
+ * Segment API Content-Type header value.
+ */
+export const SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,aAAa,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iCAAiC,CAAC","sourcesContent":["/**\n * Constants used by the analytics privacy controller and service.\n */\n\n/**\n * Segment API regulation type for DELETE_ONLY operations.\n */\nexport const SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';\n\n/**\n * Segment API subject type for user ID operations.\n */\nexport const SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';\n\n/**\n * Segment API Content-Type header value.\n */\nexport const SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';\n"]}

package/dist/index.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsPrivacyControllerSelectors = exports.DataDeleteResponseStatus = exports.DataDeleteStatus = exports.AnalyticsPrivacyService = exports.getDefaultAnalyticsPrivacyControllerState = exports.AnalyticsPrivacyController = void 0;
+var AnalyticsPrivacyController_1 = require("./AnalyticsPrivacyController.cjs");
+Object.defineProperty(exports, "AnalyticsPrivacyController", { enumerable: true, get: function () { return AnalyticsPrivacyController_1.AnalyticsPrivacyController; } });
+Object.defineProperty(exports, "getDefaultAnalyticsPrivacyControllerState", { enumerable: true, get: function () { return AnalyticsPrivacyController_1.getDefaultAnalyticsPrivacyControllerState; } });
+var AnalyticsPrivacyService_1 = require("./AnalyticsPrivacyService.cjs");
+Object.defineProperty(exports, "AnalyticsPrivacyService", { enumerable: true, get: function () { return AnalyticsPrivacyService_1.AnalyticsPrivacyService; } });
+var types_1 = require("./types.cjs");
+Object.defineProperty(exports, "DataDeleteStatus", { enumerable: true, get: function () { return types_1.DataDeleteStatus; } });
+Object.defineProperty(exports, "DataDeleteResponseStatus", { enumerable: true, get: function () { return types_1.DataDeleteResponseStatus; } });
+var selectors_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "analyticsPrivacyControllerSelectors", { enumerable: true, get: function () { return selectors_1.analyticsPrivacyControllerSelectors; } });
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+EAGsC;AAFpC,wIAAA,0BAA0B,OAAA;AAC1B,uJAAA,yCAAyC,OAAA;AAI3C,yEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAOhC,qCAAqE;AAA5D,yGAAA,gBAAgB,OAAA;AAAE,iHAAA,wBAAwB,OAAA;AASnD,6CAAkE;AAAzD,gIAAA,mCAAmC,OAAA","sourcesContent":["export {\n  AnalyticsPrivacyController,\n  getDefaultAnalyticsPrivacyControllerState,\n} from './AnalyticsPrivacyController';\nexport type { AnalyticsPrivacyControllerOptions } from './AnalyticsPrivacyController';\n\nexport { AnalyticsPrivacyService } from './AnalyticsPrivacyService';\nexport type {\n  AnalyticsPrivacyServiceActions,\n  AnalyticsPrivacyServiceEvents,\n  AnalyticsPrivacyServiceOptions,\n} from './AnalyticsPrivacyService';\n\nexport { DataDeleteStatus, DataDeleteResponseStatus } from './types';\nexport type {\n  IDeleteRegulationResponse,\n  IDeleteRegulationStatus,\n  IDeleteRegulationStatusResponse,\n} from './types';\n\nexport type { AnalyticsPrivacyControllerState } from './AnalyticsPrivacyController';\n\nexport { analyticsPrivacyControllerSelectors } from './selectors';\n\nexport type { AnalyticsPrivacyControllerMessenger } from './AnalyticsPrivacyController';\n\nexport type {\n  AnalyticsPrivacyControllerActions,\n  AnalyticsPrivacyControllerEvents,\n  AnalyticsPrivacyControllerGetStateAction,\n  AnalyticsPrivacyControllerStateChangeEvent,\n  DataDeletionTaskCreatedEvent,\n  DataRecordingFlagUpdatedEvent,\n} from './AnalyticsPrivacyController';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+export { AnalyticsPrivacyController, getDefaultAnalyticsPrivacyControllerState, } from "./AnalyticsPrivacyController.cjs";
+export type { AnalyticsPrivacyControllerOptions } from "./AnalyticsPrivacyController.cjs";
+export { AnalyticsPrivacyService } from "./AnalyticsPrivacyService.cjs";
+export type { AnalyticsPrivacyServiceActions, AnalyticsPrivacyServiceEvents, AnalyticsPrivacyServiceOptions, } from "./AnalyticsPrivacyService.cjs";
+export { DataDeleteStatus, DataDeleteResponseStatus } from "./types.cjs";
+export type { IDeleteRegulationResponse, IDeleteRegulationStatus, IDeleteRegulationStatusResponse, } from "./types.cjs";
+export type { AnalyticsPrivacyControllerState } from "./AnalyticsPrivacyController.cjs";
+export { analyticsPrivacyControllerSelectors } from "./selectors.cjs";
+export type { AnalyticsPrivacyControllerMessenger } from "./AnalyticsPrivacyController.cjs";
+export type { AnalyticsPrivacyControllerActions, AnalyticsPrivacyControllerEvents, AnalyticsPrivacyControllerGetStateAction, AnalyticsPrivacyControllerStateChangeEvent, DataDeletionTaskCreatedEvent, DataRecordingFlagUpdatedEvent, } from "./AnalyticsPrivacyController.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,yCAAyC,GAC1C,yCAAqC;AACtC,YAAY,EAAE,iCAAiC,EAAE,yCAAqC;AAEtF,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,GAC/B,sCAAkC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,oBAAgB;AACrE,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,+BAA+B,GAChC,oBAAgB;AAEjB,YAAY,EAAE,+BAA+B,EAAE,yCAAqC;AAEpF,OAAO,EAAE,mCAAmC,EAAE,wBAAoB;AAElE,YAAY,EAAE,mCAAmC,EAAE,yCAAqC;AAExF,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,wCAAwC,EACxC,0CAA0C,EAC1C,4BAA4B,EAC5B,6BAA6B,GAC9B,yCAAqC"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+export { AnalyticsPrivacyController, getDefaultAnalyticsPrivacyControllerState, } from "./AnalyticsPrivacyController.mjs";
+export type { AnalyticsPrivacyControllerOptions } from "./AnalyticsPrivacyController.mjs";
+export { AnalyticsPrivacyService } from "./AnalyticsPrivacyService.mjs";
+export type { AnalyticsPrivacyServiceActions, AnalyticsPrivacyServiceEvents, AnalyticsPrivacyServiceOptions, } from "./AnalyticsPrivacyService.mjs";
+export { DataDeleteStatus, DataDeleteResponseStatus } from "./types.mjs";
+export type { IDeleteRegulationResponse, IDeleteRegulationStatus, IDeleteRegulationStatusResponse, } from "./types.mjs";
+export type { AnalyticsPrivacyControllerState } from "./AnalyticsPrivacyController.mjs";
+export { analyticsPrivacyControllerSelectors } from "./selectors.mjs";
+export type { AnalyticsPrivacyControllerMessenger } from "./AnalyticsPrivacyController.mjs";
+export type { AnalyticsPrivacyControllerActions, AnalyticsPrivacyControllerEvents, AnalyticsPrivacyControllerGetStateAction, AnalyticsPrivacyControllerStateChangeEvent, DataDeletionTaskCreatedEvent, DataRecordingFlagUpdatedEvent, } from "./AnalyticsPrivacyController.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,yCAAyC,GAC1C,yCAAqC;AACtC,YAAY,EAAE,iCAAiC,EAAE,yCAAqC;AAEtF,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AACpE,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,GAC/B,sCAAkC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,oBAAgB;AACrE,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,+BAA+B,GAChC,oBAAgB;AAEjB,YAAY,EAAE,+BAA+B,EAAE,yCAAqC;AAEpF,OAAO,EAAE,mCAAmC,EAAE,wBAAoB;AAElE,YAAY,EAAE,mCAAmC,EAAE,yCAAqC;AAExF,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,wCAAwC,EACxC,0CAA0C,EAC1C,4BAA4B,EAC5B,6BAA6B,GAC9B,yCAAqC"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { AnalyticsPrivacyController, getDefaultAnalyticsPrivacyControllerState } from "./AnalyticsPrivacyController.mjs";
+export { AnalyticsPrivacyService } from "./AnalyticsPrivacyService.mjs";
+export { DataDeleteStatus, DataDeleteResponseStatus } from "./types.mjs";
+export { analyticsPrivacyControllerSelectors } from "./selectors.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,yCAAyC,EAC1C,yCAAqC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,sCAAkC;AAOpE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,oBAAgB;AASrE,OAAO,EAAE,mCAAmC,EAAE,wBAAoB","sourcesContent":["export {\n  AnalyticsPrivacyController,\n  getDefaultAnalyticsPrivacyControllerState,\n} from './AnalyticsPrivacyController';\nexport type { AnalyticsPrivacyControllerOptions } from './AnalyticsPrivacyController';\n\nexport { AnalyticsPrivacyService } from './AnalyticsPrivacyService';\nexport type {\n  AnalyticsPrivacyServiceActions,\n  AnalyticsPrivacyServiceEvents,\n  AnalyticsPrivacyServiceOptions,\n} from './AnalyticsPrivacyService';\n\nexport { DataDeleteStatus, DataDeleteResponseStatus } from './types';\nexport type {\n  IDeleteRegulationResponse,\n  IDeleteRegulationStatus,\n  IDeleteRegulationStatusResponse,\n} from './types';\n\nexport type { AnalyticsPrivacyControllerState } from './AnalyticsPrivacyController';\n\nexport { analyticsPrivacyControllerSelectors } from './selectors';\n\nexport type { AnalyticsPrivacyControllerMessenger } from './AnalyticsPrivacyController';\n\nexport type {\n  AnalyticsPrivacyControllerActions,\n  AnalyticsPrivacyControllerEvents,\n  AnalyticsPrivacyControllerGetStateAction,\n  AnalyticsPrivacyControllerStateChangeEvent,\n  DataDeletionTaskCreatedEvent,\n  DataRecordingFlagUpdatedEvent,\n} from './AnalyticsPrivacyController';\n"]}

package/dist/selectors.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsPrivacyControllerSelectors = void 0;
+/**
+ * Selects the data recorded flag from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether data has been recorded since the last deletion request
+ */
+const selectDataRecorded = (state) => state.dataRecorded;
+/**
+ * Selects the delete regulation ID from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The regulation ID, or undefined if not set
+ */
+const selectDeleteRegulationId = (state) => state.deleteRegulationId ?? undefined;
+/**
+ * Selects the delete regulation creation timestamp from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The deletion timestamp (in milliseconds since epoch), or undefined if not set
+ */
+const selectDeleteRegulationTimestamp = (state) => state.deleteRegulationTimestamp ?? undefined;
+/**
+ * Selectors for the AnalyticsPrivacyController state.
+ * These can be used with Redux or directly with controller state.
+ */
+exports.analyticsPrivacyControllerSelectors = {
+    selectDataRecorded,
+    selectDeleteRegulationId,
+    selectDeleteRegulationTimestamp,
+};
+//# sourceMappingURL=selectors.cjs.map

package/dist/selectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.cjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAsC,EAAW,EAAE,CAC7E,KAAK,CAAC,YAAY,CAAC;AAErB;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,CAC/B,KAAsC,EAClB,EAAE,CAAC,KAAK,CAAC,kBAAkB,IAAI,SAAS,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,CACtC,KAAsC,EAClB,EAAE,CAAC,KAAK,CAAC,yBAAyB,IAAI,SAAS,CAAC;AAEtE;;;GAGG;AACU,QAAA,mCAAmC,GAAG;IACjD,kBAAkB;IAClB,wBAAwB;IACxB,+BAA+B;CAChC,CAAC","sourcesContent":["import type { AnalyticsPrivacyControllerState } from './AnalyticsPrivacyController';\n\n/**\n * Selects the data recorded flag from the controller state.\n *\n * @param state - The controller state\n * @returns Whether data has been recorded since the last deletion request\n */\nconst selectDataRecorded = (state: AnalyticsPrivacyControllerState): boolean =>\n  state.dataRecorded;\n\n/**\n * Selects the delete regulation ID from the controller state.\n *\n * @param state - The controller state\n * @returns The regulation ID, or undefined if not set\n */\nconst selectDeleteRegulationId = (\n  state: AnalyticsPrivacyControllerState,\n): string | undefined => state.deleteRegulationId ?? undefined;\n\n/**\n * Selects the delete regulation creation timestamp from the controller state.\n *\n * @param state - The controller state\n * @returns The deletion timestamp (in milliseconds since epoch), or undefined if not set\n */\nconst selectDeleteRegulationTimestamp = (\n  state: AnalyticsPrivacyControllerState,\n): number | undefined => state.deleteRegulationTimestamp ?? undefined;\n\n/**\n * Selectors for the AnalyticsPrivacyController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsPrivacyControllerSelectors = {\n  selectDataRecorded,\n  selectDeleteRegulationId,\n  selectDeleteRegulationTimestamp,\n};\n"]}

package/dist/selectors.d.cts

@@ -0,0 +1,11 @@
+import type { AnalyticsPrivacyControllerState } from "./AnalyticsPrivacyController.cjs";
+/**
+ * Selectors for the AnalyticsPrivacyController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsPrivacyControllerSelectors: {
+    selectDataRecorded: (state: AnalyticsPrivacyControllerState) => boolean;
+    selectDeleteRegulationId: (state: AnalyticsPrivacyControllerState) => string | undefined;
+    selectDeleteRegulationTimestamp: (state: AnalyticsPrivacyControllerState) => number | undefined;
+};
+//# sourceMappingURL=selectors.d.cts.map

package/dist/selectors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.cts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,yCAAqC;AA+BpF;;;GAGG;AACH,eAAO,MAAM,mCAAmC;gCA3Bb,+BAA+B,KAAG,OAAO;sCAUnE,+BAA+B,KACrC,MAAM,GAAG,SAAS;6CASZ,+BAA+B,KACrC,MAAM,GAAG,SAAS;CAUpB,CAAC"}

package/dist/selectors.d.mts

@@ -0,0 +1,11 @@
+import type { AnalyticsPrivacyControllerState } from "./AnalyticsPrivacyController.mjs";
+/**
+ * Selectors for the AnalyticsPrivacyController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsPrivacyControllerSelectors: {
+    selectDataRecorded: (state: AnalyticsPrivacyControllerState) => boolean;
+    selectDeleteRegulationId: (state: AnalyticsPrivacyControllerState) => string | undefined;
+    selectDeleteRegulationTimestamp: (state: AnalyticsPrivacyControllerState) => number | undefined;
+};
+//# sourceMappingURL=selectors.d.mts.map

package/dist/selectors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.mts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,yCAAqC;AA+BpF;;;GAGG;AACH,eAAO,MAAM,mCAAmC;gCA3Bb,+BAA+B,KAAG,OAAO;sCAUnE,+BAA+B,KACrC,MAAM,GAAG,SAAS;6CASZ,+BAA+B,KACrC,MAAM,GAAG,SAAS;CAUpB,CAAC"}

package/dist/selectors.mjs

@@ -0,0 +1,31 @@
+/**
+ * Selects the data recorded flag from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether data has been recorded since the last deletion request
+ */
+const selectDataRecorded = (state) => state.dataRecorded;
+/**
+ * Selects the delete regulation ID from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The regulation ID, or undefined if not set
+ */
+const selectDeleteRegulationId = (state) => state.deleteRegulationId ?? undefined;
+/**
+ * Selects the delete regulation creation timestamp from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The deletion timestamp (in milliseconds since epoch), or undefined if not set
+ */
+const selectDeleteRegulationTimestamp = (state) => state.deleteRegulationTimestamp ?? undefined;
+/**
+ * Selectors for the AnalyticsPrivacyController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export const analyticsPrivacyControllerSelectors = {
+    selectDataRecorded,
+    selectDeleteRegulationId,
+    selectDeleteRegulationTimestamp,
+};
+//# sourceMappingURL=selectors.mjs.map

package/dist/selectors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.mjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAsC,EAAW,EAAE,CAC7E,KAAK,CAAC,YAAY,CAAC;AAErB;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,CAC/B,KAAsC,EAClB,EAAE,CAAC,KAAK,CAAC,kBAAkB,IAAI,SAAS,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,CACtC,KAAsC,EAClB,EAAE,CAAC,KAAK,CAAC,yBAAyB,IAAI,SAAS,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,kBAAkB;IAClB,wBAAwB;IACxB,+BAA+B;CAChC,CAAC","sourcesContent":["import type { AnalyticsPrivacyControllerState } from './AnalyticsPrivacyController';\n\n/**\n * Selects the data recorded flag from the controller state.\n *\n * @param state - The controller state\n * @returns Whether data has been recorded since the last deletion request\n */\nconst selectDataRecorded = (state: AnalyticsPrivacyControllerState): boolean =>\n  state.dataRecorded;\n\n/**\n * Selects the delete regulation ID from the controller state.\n *\n * @param state - The controller state\n * @returns The regulation ID, or undefined if not set\n */\nconst selectDeleteRegulationId = (\n  state: AnalyticsPrivacyControllerState,\n): string | undefined => state.deleteRegulationId ?? undefined;\n\n/**\n * Selects the delete regulation creation timestamp from the controller state.\n *\n * @param state - The controller state\n * @returns The deletion timestamp (in milliseconds since epoch), or undefined if not set\n */\nconst selectDeleteRegulationTimestamp = (\n  state: AnalyticsPrivacyControllerState,\n): number | undefined => state.deleteRegulationTimestamp ?? undefined;\n\n/**\n * Selectors for the AnalyticsPrivacyController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsPrivacyControllerSelectors = {\n  selectDataRecorded,\n  selectDeleteRegulationId,\n  selectDeleteRegulationTimestamp,\n};\n"]}

package/dist/types.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataDeleteResponseStatus = exports.DataDeleteStatus = void 0;
+/**
+ * Status values for data deletion requests from Segment API.
+ * Enum values match Segment API response values exactly.
+ */
+var DataDeleteStatus;
+(function (DataDeleteStatus) {
+    DataDeleteStatus["Failed"] = "FAILED";
+    DataDeleteStatus["Finished"] = "FINISHED";
+    DataDeleteStatus["Initialized"] = "INITIALIZED";
+    DataDeleteStatus["Invalid"] = "INVALID";
+    DataDeleteStatus["NotSupported"] = "NOT_SUPPORTED";
+    DataDeleteStatus["PartialSuccess"] = "PARTIAL_SUCCESS";
+    DataDeleteStatus["Running"] = "RUNNING";
+    DataDeleteStatus["Unknown"] = "UNKNOWN";
+})(DataDeleteStatus || (exports.DataDeleteStatus = DataDeleteStatus = {}));
+/**
+ * Response status for deletion regulation operations.
+ */
+var DataDeleteResponseStatus;
+(function (DataDeleteResponseStatus) {
+    DataDeleteResponseStatus["Success"] = "ok";
+    DataDeleteResponseStatus["Failure"] = "error";
+})(DataDeleteResponseStatus || (exports.DataDeleteResponseStatus = DataDeleteResponseStatus = {}));
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;IACrB,+CAA2B,CAAA;IAC3B,uCAAmB,CAAA;IACnB,kDAA8B,CAAA;IAC9B,sDAAkC,CAAA;IAClC,uCAAmB,CAAA;IACnB,uCAAmB,CAAA;AACrB,CAAC,EATW,gBAAgB,gCAAhB,gBAAgB,QAS3B;AAED;;GAEG;AACH,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,0CAAc,CAAA;IACd,6CAAiB,CAAA;AACnB,CAAC,EAHW,wBAAwB,wCAAxB,wBAAwB,QAGnC","sourcesContent":["/**\n * Status values for data deletion requests from Segment API.\n * Enum values match Segment API response values exactly.\n */\nexport enum DataDeleteStatus {\n  Failed = 'FAILED',\n  Finished = 'FINISHED',\n  Initialized = 'INITIALIZED',\n  Invalid = 'INVALID',\n  NotSupported = 'NOT_SUPPORTED',\n  PartialSuccess = 'PARTIAL_SUCCESS',\n  Running = 'RUNNING',\n  Unknown = 'UNKNOWN',\n}\n\n/**\n * Response status for deletion regulation operations.\n */\nexport enum DataDeleteResponseStatus {\n  Success = 'ok',\n  Failure = 'error',\n}\n\n/**\n * Response from creating a data deletion task.\n */\nexport type IDeleteRegulationResponse = {\n  status: DataDeleteResponseStatus;\n  regulateId?: string; // Using exact API field name from Segment API response\n  error?: string;\n};\n\n/**\n * Status information for a data deletion request.\n */\nexport type IDeleteRegulationStatus = {\n  deletionRequestTimestamp?: number;\n  hasCollectedDataSinceDeletionRequest: boolean;\n  dataDeletionRequestStatus: DataDeleteStatus;\n};\n\n/**\n * Response from checking data deletion status.\n */\nexport type IDeleteRegulationStatusResponse = {\n  status: DataDeleteResponseStatus;\n  dataDeleteStatus: DataDeleteStatus;\n};\n\n/**\n * Timestamp for deletion regulation creation (milliseconds since epoch).\n */\nexport type DataDeleteTimestamp = number | undefined;\n\n/**\n * Regulation ID from Segment API.\n */\nexport type DataDeleteRegulationId = string | undefined;\n"]}