@metamask-previews/analytics-data-regulation-controller 0.0.0-preview-52f4a2ca

package/dist/AnalyticsDataRegulationService.mjs

@@ -0,0 +1,243 @@
+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 _AnalyticsDataRegulationService_messenger, _AnalyticsDataRegulationService_fetch, _AnalyticsDataRegulationService_segmentSourceId, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, _AnalyticsDataRegulationService_policy;
+import { createServicePolicy, HttpError } from "@metamask/controller-utils";
+import { DATA_DELETE_RESPONSE_STATUSES, DATA_DELETE_STATUSES } from "./types.mjs";
+/**
+ * Segment API regulation type for DELETE_ONLY operations.
+ */
+const SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';
+/**
+ * Segment API subject type for user ID operations.
+ */
+const SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';
+/**
+ * Segment API Content-Type header value.
+ */
+const SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';
+// === GENERAL ===
+/**
+ * The name of the {@link AnalyticsDataRegulationService}, used to namespace the
+ * service's actions and events.
+ */
+export const serviceName = 'AnalyticsDataRegulationService';
+// === MESSENGER ===
+const MESSENGER_EXPOSED_METHODS = [
+    'createDataDeletionTask',
+    'checkDataDeleteStatus',
+];
+/**
+ * Type guard to check if a value is a valid DataDeleteStatus.
+ *
+ * @param status - The value to check.
+ * @returns True if the value is a valid DataDeleteStatus.
+ */
+function isDataDeleteStatus(status) {
+    const dataDeleteStatuses = Object.values(DATA_DELETE_STATUSES);
+    return dataDeleteStatuses.includes(status);
+}
+/**
+ * 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 {
+ *   AnalyticsDataRegulationServiceActions,
+ *   AnalyticsDataRegulationServiceEvents,
+ * } from '@metamask/analytics-data-regulation-controller';
+ *
+ * const rootMessenger = new Messenger<
+ *   'Root',
+ *   AnalyticsDataRegulationServiceActions,
+ *   AnalyticsDataRegulationServiceEvents
+ * >({ namespace: 'Root' });
+ * const serviceMessenger = new Messenger<
+ *   'AnalyticsDataRegulationService',
+ *   AnalyticsDataRegulationServiceActions,
+ *   AnalyticsDataRegulationServiceEvents,
+ *   typeof rootMessenger,
+ * >({
+ *   namespace: 'AnalyticsDataRegulationService',
+ *   parent: rootMessenger,
+ * });
+ * // Instantiate the service to register its actions on the messenger
+ * new AnalyticsDataRegulationService({
+ *   messenger: serviceMessenger,
+ *   fetch,
+ *   segmentSourceId: 'abc123',
+ *   segmentRegulationsEndpoint: 'https://proxy.example.com/v1beta',
+ * });
+ *
+ * // Later...
+ * // Create a data deletion task
+ * const response = await rootMessenger.call(
+ *   'AnalyticsDataRegulationService:createDataDeletionTask',
+ *   'user-analytics-id',
+ * );
+ * ```
+ */
+export class AnalyticsDataRegulationService {
+    /**
+     * Constructs a new AnalyticsDataRegulationService object.
+     *
+     * @param options - The constructor options.
+     */
+    constructor(options) {
+        /**
+         * The messenger suited for this service.
+         */
+        _AnalyticsDataRegulationService_messenger.set(this, void 0);
+        /**
+         * A function that can be used to make an HTTP request.
+         */
+        _AnalyticsDataRegulationService_fetch.set(this, void 0);
+        /**
+         * Segment API source ID.
+         */
+        _AnalyticsDataRegulationService_segmentSourceId.set(this, void 0);
+        /**
+         * Base URL for the proxy endpoint that communicates with Segment's Regulations API.
+         * This endpoint varies by environment and forwards requests to Segment API with authentication.
+         */
+        _AnalyticsDataRegulationService_segmentRegulationsEndpoint.set(this, void 0);
+        /**
+         * The policy that wraps the request.
+         *
+         * @see {@link createServicePolicy}
+         */
+        _AnalyticsDataRegulationService_policy.set(this, void 0);
+        this.name = serviceName;
+        __classPrivateFieldSet(this, _AnalyticsDataRegulationService_messenger, options.messenger, "f");
+        __classPrivateFieldSet(this, _AnalyticsDataRegulationService_fetch, options.fetch, "f");
+        __classPrivateFieldSet(this, _AnalyticsDataRegulationService_segmentSourceId, options.segmentSourceId, "f");
+        __classPrivateFieldSet(this, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, options.segmentRegulationsEndpoint, "f");
+        __classPrivateFieldSet(this, _AnalyticsDataRegulationService_policy, createServicePolicy(options.policyOptions ?? {}), "f");
+        __classPrivateFieldGet(this, _AnalyticsDataRegulationService_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, _AnalyticsDataRegulationService_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, _AnalyticsDataRegulationService_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, _AnalyticsDataRegulationService_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 a successful deletion regulation response.
+     * @throws Error if the request fails or the response is invalid.
+     */
+    async createDataDeletionTask(analyticsId) {
+        if (!__classPrivateFieldGet(this, _AnalyticsDataRegulationService_segmentSourceId, "f") || !__classPrivateFieldGet(this, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, "f")) {
+            throw new Error('Segment API source ID or endpoint not found');
+        }
+        const url = `${__classPrivateFieldGet(this, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, "f")}/regulations/sources/${__classPrivateFieldGet(this, _AnalyticsDataRegulationService_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, _AnalyticsDataRegulationService_policy, "f").execute(async () => {
+            const localResponse = await __classPrivateFieldGet(this, _AnalyticsDataRegulationService_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' ||
+            jsonResponse.data.data.regulateId.trim() === '') {
+            throw new Error('Malformed response from Segment API: missing or invalid regulateId');
+        }
+        return {
+            status: DATA_DELETE_RESPONSE_STATUSES.Success,
+            regulateId: jsonResponse.data.data.regulateId,
+        };
+    }
+    /**
+     * Checks the status of a regulation by ID.
+     *
+     * @param regulationId - The regulation ID to check.
+     * @returns Promise resolving to a successful regulation status response.
+     * @throws Error if the request fails or the response is invalid.
+     */
+    async checkDataDeleteStatus(regulationId) {
+        if (!regulationId || !__classPrivateFieldGet(this, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, "f")) {
+            throw new Error('Regulation ID or endpoint not configured');
+        }
+        const url = `${__classPrivateFieldGet(this, _AnalyticsDataRegulationService_segmentRegulationsEndpoint, "f")}/regulations/${regulationId}`;
+        const response = await __classPrivateFieldGet(this, _AnalyticsDataRegulationService_policy, "f").execute(async () => {
+            const localResponse = await __classPrivateFieldGet(this, _AnalyticsDataRegulationService_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 = isDataDeleteStatus(rawStatus)
+            ? rawStatus
+            : DATA_DELETE_STATUSES.Unknown;
+        return {
+            status: DATA_DELETE_RESPONSE_STATUSES.Success,
+            dataDeleteStatus,
+        };
+    }
+}
+_AnalyticsDataRegulationService_messenger = new WeakMap(), _AnalyticsDataRegulationService_fetch = new WeakMap(), _AnalyticsDataRegulationService_segmentSourceId = new WeakMap(), _AnalyticsDataRegulationService_segmentRegulationsEndpoint = new WeakMap(), _AnalyticsDataRegulationService_policy = new WeakMap();
+//# sourceMappingURL=AnalyticsDataRegulationService.mjs.map

package/dist/AnalyticsDataRegulationService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsDataRegulationService.mjs","sourceRoot":"","sources":["../src/AnalyticsDataRegulationService.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 type { AnalyticsDataRegulationServiceMethodActions } from './AnalyticsDataRegulationService-method-action-types';\nimport { DATA_DELETE_RESPONSE_STATUSES, DATA_DELETE_STATUSES } from './types';\nimport type { DataDeleteStatus } from './types';\n\n/**\n * Segment API regulation type for DELETE_ONLY operations.\n */\nconst SEGMENT_REGULATION_TYPE_DELETE_ONLY = 'DELETE_ONLY';\n\n/**\n * Segment API subject type for user ID operations.\n */\nconst SEGMENT_SUBJECT_TYPE_USER_ID = 'USER_ID';\n\n/**\n * Segment API Content-Type header value.\n */\nconst SEGMENT_CONTENT_TYPE = 'application/vnd.segment.v1+json';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link AnalyticsDataRegulationService}, used to namespace the\n * service's actions and events.\n */\nexport const serviceName = 'AnalyticsDataRegulationService';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'createDataDeletionTask',\n  'checkDataDeleteStatus',\n] as const;\n\n/**\n * Actions that {@link AnalyticsDataRegulationService} exposes to other consumers.\n */\nexport type AnalyticsDataRegulationServiceActions =\n  AnalyticsDataRegulationServiceMethodActions;\n\n/**\n * Actions from other messengers that {@link AnalyticsDataRegulationServiceMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Events that {@link AnalyticsDataRegulationService} exposes to other consumers.\n */\nexport type AnalyticsDataRegulationServiceEvents = never;\n\n/**\n * Events from other messengers that {@link AnalyticsDataRegulationService} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger which is restricted to actions and events accessed by\n * {@link AnalyticsDataRegulationService}.\n */\nexport type AnalyticsDataRegulationServiceMessenger = Messenger<\n  typeof serviceName,\n  AnalyticsDataRegulationServiceActions | AllowedActions,\n  AnalyticsDataRegulationServiceEvents | 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 AnalyticsDataRegulationService}.\n */\nexport type AnalyticsDataRegulationServiceOptions = {\n  /**\n   * The messenger suited for this service.\n   */\n  messenger: AnalyticsDataRegulationServiceMessenger;\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 that communicates with Segment's Regulations API.\n   * This is a proxy endpoint (not Segment API directly) that forwards requests to Segment's\n   * Regulations API and adds authentication tokens. The endpoint URL varies by environment\n   * (e.g., development, staging, production) and should be configured accordingly.\n   * Example: 'https://proxy.example.com/v1beta'\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 * Type guard to check if a value is a valid DataDeleteStatus.\n *\n * @param status - The value to check.\n * @returns True if the value is a valid DataDeleteStatus.\n */\nfunction isDataDeleteStatus(status: unknown): status is DataDeleteStatus {\n  const dataDeleteStatuses: string[] = Object.values(DATA_DELETE_STATUSES);\n  return dataDeleteStatuses.includes(status as string);\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 *   AnalyticsDataRegulationServiceActions,\n *   AnalyticsDataRegulationServiceEvents,\n * } from '@metamask/analytics-data-regulation-controller';\n *\n * const rootMessenger = new Messenger<\n *   'Root',\n *   AnalyticsDataRegulationServiceActions,\n *   AnalyticsDataRegulationServiceEvents\n * >({ namespace: 'Root' });\n * const serviceMessenger = new Messenger<\n *   'AnalyticsDataRegulationService',\n *   AnalyticsDataRegulationServiceActions,\n *   AnalyticsDataRegulationServiceEvents,\n *   typeof rootMessenger,\n * >({\n *   namespace: 'AnalyticsDataRegulationService',\n *   parent: rootMessenger,\n * });\n * // Instantiate the service to register its actions on the messenger\n * new AnalyticsDataRegulationService({\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 *   'AnalyticsDataRegulationService:createDataDeletionTask',\n *   'user-analytics-id',\n * );\n * ```\n */\nexport class AnalyticsDataRegulationService {\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: AnalyticsDataRegulationServiceMessenger;\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 that communicates with Segment's Regulations API.\n   * This endpoint varies by environment and forwards requests to Segment API with authentication.\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 AnalyticsDataRegulationService object.\n   *\n   * @param options - The constructor options.\n   */\n  constructor(options: AnalyticsDataRegulationServiceOptions) {\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 a successful deletion regulation response.\n   * @throws Error if the request fails or the response is invalid.\n   */\n  async createDataDeletionTask(analyticsId: string): Promise<{\n    status: typeof DATA_DELETE_RESPONSE_STATUSES.Success;\n    regulateId: string;\n  }> {\n    if (!this.#segmentSourceId || !this.#segmentRegulationsEndpoint) {\n      throw new Error('Segment API source ID or endpoint not found');\n    }\n\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      jsonResponse.data.data.regulateId.trim() === ''\n    ) {\n      throw new Error(\n        'Malformed response from Segment API: missing or invalid regulateId',\n      );\n    }\n\n    return {\n      status: DATA_DELETE_RESPONSE_STATUSES.Success,\n      regulateId: jsonResponse.data.data.regulateId,\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 a successful regulation status response.\n   * @throws Error if the request fails or the response is invalid.\n   */\n  async checkDataDeleteStatus(regulationId: string): Promise<{\n    status: typeof DATA_DELETE_RESPONSE_STATUSES.Success;\n    dataDeleteStatus: DataDeleteStatus;\n  }> {\n    if (!regulationId || !this.#segmentRegulationsEndpoint) {\n      throw new Error('Regulation ID or endpoint not configured');\n    }\n\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 = (await response.json()) as GetRegulationStatusResponse;\n\n    const rawStatus = jsonResponse?.data?.data?.regulation?.overallStatus;\n    const dataDeleteStatus = isDataDeleteStatus(rawStatus)\n      ? rawStatus\n      : DATA_DELETE_STATUSES.Unknown;\n\n    return {\n      status: DATA_DELETE_RESPONSE_STATUSES.Success,\n      dataDeleteStatus,\n    };\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsDataRegulationControllerSelectors = exports.DATA_DELETE_RESPONSE_STATUSES = exports.DATA_DELETE_STATUSES = exports.AnalyticsDataRegulationService = exports.getDefaultAnalyticsDataRegulationControllerState = exports.AnalyticsDataRegulationController = void 0;
+var AnalyticsDataRegulationController_1 = require("./AnalyticsDataRegulationController.cjs");
+Object.defineProperty(exports, "AnalyticsDataRegulationController", { enumerable: true, get: function () { return AnalyticsDataRegulationController_1.AnalyticsDataRegulationController; } });
+Object.defineProperty(exports, "getDefaultAnalyticsDataRegulationControllerState", { enumerable: true, get: function () { return AnalyticsDataRegulationController_1.getDefaultAnalyticsDataRegulationControllerState; } });
+var AnalyticsDataRegulationService_1 = require("./AnalyticsDataRegulationService.cjs");
+Object.defineProperty(exports, "AnalyticsDataRegulationService", { enumerable: true, get: function () { return AnalyticsDataRegulationService_1.AnalyticsDataRegulationService; } });
+var types_1 = require("./types.cjs");
+Object.defineProperty(exports, "DATA_DELETE_STATUSES", { enumerable: true, get: function () { return types_1.DATA_DELETE_STATUSES; } });
+Object.defineProperty(exports, "DATA_DELETE_RESPONSE_STATUSES", { enumerable: true, get: function () { return types_1.DATA_DELETE_RESPONSE_STATUSES; } });
+var selectors_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "analyticsDataRegulationControllerSelectors", { enumerable: true, get: function () { return selectors_1.analyticsDataRegulationControllerSelectors; } });
+//# 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,6FAG6C;AAF3C,sJAAA,iCAAiC,OAAA;AACjC,qKAAA,gDAAgD,OAAA;AAIlD,uFAAkF;AAAzE,gJAAA,8BAA8B,OAAA;AAQvC,qCAKiB;AAJf,6GAAA,oBAAoB,OAAA;AACpB,sHAAA,6BAA6B,OAAA;AAQ/B,6CAAyE;AAAhE,uIAAA,0CAA0C,OAAA","sourcesContent":["export {\n  AnalyticsDataRegulationController,\n  getDefaultAnalyticsDataRegulationControllerState,\n} from './AnalyticsDataRegulationController';\nexport type { AnalyticsDataRegulationControllerOptions } from './AnalyticsDataRegulationController';\n\nexport { AnalyticsDataRegulationService } from './AnalyticsDataRegulationService';\nexport type {\n  AnalyticsDataRegulationServiceActions,\n  AnalyticsDataRegulationServiceEvents,\n  AnalyticsDataRegulationServiceMessenger,\n  AnalyticsDataRegulationServiceOptions,\n} from './AnalyticsDataRegulationService';\n\nexport {\n  DATA_DELETE_STATUSES,\n  DATA_DELETE_RESPONSE_STATUSES,\n  type DataDeleteStatus,\n  type DataDeleteResponseStatus,\n} from './types';\nexport type { DeleteRegulationResponse, DeleteRegulationStatus } from './types';\n\nexport type { AnalyticsDataRegulationControllerState } from './AnalyticsDataRegulationController';\n\nexport { analyticsDataRegulationControllerSelectors } from './selectors';\n\nexport type { AnalyticsDataRegulationControllerMessenger } from './AnalyticsDataRegulationController';\n\nexport type {\n  AnalyticsDataRegulationControllerActions,\n  AnalyticsDataRegulationControllerEvents,\n  AnalyticsDataRegulationControllerGetStateAction,\n  AnalyticsDataRegulationControllerStateChangeEvent,\n  DataDeletionTaskCreatedEvent,\n  DataRecordingFlagUpdatedEvent,\n} from './AnalyticsDataRegulationController';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+export { AnalyticsDataRegulationController, getDefaultAnalyticsDataRegulationControllerState, } from "./AnalyticsDataRegulationController.cjs";
+export type { AnalyticsDataRegulationControllerOptions } from "./AnalyticsDataRegulationController.cjs";
+export { AnalyticsDataRegulationService } from "./AnalyticsDataRegulationService.cjs";
+export type { AnalyticsDataRegulationServiceActions, AnalyticsDataRegulationServiceEvents, AnalyticsDataRegulationServiceMessenger, AnalyticsDataRegulationServiceOptions, } from "./AnalyticsDataRegulationService.cjs";
+export { DATA_DELETE_STATUSES, DATA_DELETE_RESPONSE_STATUSES, type DataDeleteStatus, type DataDeleteResponseStatus, } from "./types.cjs";
+export type { DeleteRegulationResponse, DeleteRegulationStatus } from "./types.cjs";
+export type { AnalyticsDataRegulationControllerState } from "./AnalyticsDataRegulationController.cjs";
+export { analyticsDataRegulationControllerSelectors } from "./selectors.cjs";
+export type { AnalyticsDataRegulationControllerMessenger } from "./AnalyticsDataRegulationController.cjs";
+export type { AnalyticsDataRegulationControllerActions, AnalyticsDataRegulationControllerEvents, AnalyticsDataRegulationControllerGetStateAction, AnalyticsDataRegulationControllerStateChangeEvent, DataDeletionTaskCreatedEvent, DataRecordingFlagUpdatedEvent, } from "./AnalyticsDataRegulationController.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,iCAAiC,EACjC,gDAAgD,GACjD,gDAA4C;AAC7C,YAAY,EAAE,wCAAwC,EAAE,gDAA4C;AAEpG,OAAO,EAAE,8BAA8B,EAAE,6CAAyC;AAClF,YAAY,EACV,qCAAqC,EACrC,oCAAoC,EACpC,uCAAuC,EACvC,qCAAqC,GACtC,6CAAyC;AAE1C,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC9B,oBAAgB;AACjB,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,oBAAgB;AAEhF,YAAY,EAAE,sCAAsC,EAAE,gDAA4C;AAElG,OAAO,EAAE,0CAA0C,EAAE,wBAAoB;AAEzE,YAAY,EAAE,0CAA0C,EAAE,gDAA4C;AAEtG,YAAY,EACV,wCAAwC,EACxC,uCAAuC,EACvC,+CAA+C,EAC/C,iDAAiD,EACjD,4BAA4B,EAC5B,6BAA6B,GAC9B,gDAA4C"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+export { AnalyticsDataRegulationController, getDefaultAnalyticsDataRegulationControllerState, } from "./AnalyticsDataRegulationController.mjs";
+export type { AnalyticsDataRegulationControllerOptions } from "./AnalyticsDataRegulationController.mjs";
+export { AnalyticsDataRegulationService } from "./AnalyticsDataRegulationService.mjs";
+export type { AnalyticsDataRegulationServiceActions, AnalyticsDataRegulationServiceEvents, AnalyticsDataRegulationServiceMessenger, AnalyticsDataRegulationServiceOptions, } from "./AnalyticsDataRegulationService.mjs";
+export { DATA_DELETE_STATUSES, DATA_DELETE_RESPONSE_STATUSES, type DataDeleteStatus, type DataDeleteResponseStatus, } from "./types.mjs";
+export type { DeleteRegulationResponse, DeleteRegulationStatus } from "./types.mjs";
+export type { AnalyticsDataRegulationControllerState } from "./AnalyticsDataRegulationController.mjs";
+export { analyticsDataRegulationControllerSelectors } from "./selectors.mjs";
+export type { AnalyticsDataRegulationControllerMessenger } from "./AnalyticsDataRegulationController.mjs";
+export type { AnalyticsDataRegulationControllerActions, AnalyticsDataRegulationControllerEvents, AnalyticsDataRegulationControllerGetStateAction, AnalyticsDataRegulationControllerStateChangeEvent, DataDeletionTaskCreatedEvent, DataRecordingFlagUpdatedEvent, } from "./AnalyticsDataRegulationController.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,iCAAiC,EACjC,gDAAgD,GACjD,gDAA4C;AAC7C,YAAY,EAAE,wCAAwC,EAAE,gDAA4C;AAEpG,OAAO,EAAE,8BAA8B,EAAE,6CAAyC;AAClF,YAAY,EACV,qCAAqC,EACrC,oCAAoC,EACpC,uCAAuC,EACvC,qCAAqC,GACtC,6CAAyC;AAE1C,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC9B,oBAAgB;AACjB,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,oBAAgB;AAEhF,YAAY,EAAE,sCAAsC,EAAE,gDAA4C;AAElG,OAAO,EAAE,0CAA0C,EAAE,wBAAoB;AAEzE,YAAY,EAAE,0CAA0C,EAAE,gDAA4C;AAEtG,YAAY,EACV,wCAAwC,EACxC,uCAAuC,EACvC,+CAA+C,EAC/C,iDAAiD,EACjD,4BAA4B,EAC5B,6BAA6B,GAC9B,gDAA4C"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { AnalyticsDataRegulationController, getDefaultAnalyticsDataRegulationControllerState } from "./AnalyticsDataRegulationController.mjs";
+export { AnalyticsDataRegulationService } from "./AnalyticsDataRegulationService.mjs";
+export { DATA_DELETE_STATUSES, DATA_DELETE_RESPONSE_STATUSES } from "./types.mjs";
+export { analyticsDataRegulationControllerSelectors } 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,iCAAiC,EACjC,gDAAgD,EACjD,gDAA4C;AAG7C,OAAO,EAAE,8BAA8B,EAAE,6CAAyC;AAQlF,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAG9B,oBAAgB;AAKjB,OAAO,EAAE,0CAA0C,EAAE,wBAAoB","sourcesContent":["export {\n  AnalyticsDataRegulationController,\n  getDefaultAnalyticsDataRegulationControllerState,\n} from './AnalyticsDataRegulationController';\nexport type { AnalyticsDataRegulationControllerOptions } from './AnalyticsDataRegulationController';\n\nexport { AnalyticsDataRegulationService } from './AnalyticsDataRegulationService';\nexport type {\n  AnalyticsDataRegulationServiceActions,\n  AnalyticsDataRegulationServiceEvents,\n  AnalyticsDataRegulationServiceMessenger,\n  AnalyticsDataRegulationServiceOptions,\n} from './AnalyticsDataRegulationService';\n\nexport {\n  DATA_DELETE_STATUSES,\n  DATA_DELETE_RESPONSE_STATUSES,\n  type DataDeleteStatus,\n  type DataDeleteResponseStatus,\n} from './types';\nexport type { DeleteRegulationResponse, DeleteRegulationStatus } from './types';\n\nexport type { AnalyticsDataRegulationControllerState } from './AnalyticsDataRegulationController';\n\nexport { analyticsDataRegulationControllerSelectors } from './selectors';\n\nexport type { AnalyticsDataRegulationControllerMessenger } from './AnalyticsDataRegulationController';\n\nexport type {\n  AnalyticsDataRegulationControllerActions,\n  AnalyticsDataRegulationControllerEvents,\n  AnalyticsDataRegulationControllerGetStateAction,\n  AnalyticsDataRegulationControllerStateChangeEvent,\n  DataDeletionTaskCreatedEvent,\n  DataRecordingFlagUpdatedEvent,\n} from './AnalyticsDataRegulationController';\n"]}

package/dist/logger.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/* istanbul ignore file */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectLogger = void 0;
+const utils_1 = require("@metamask/utils");
+exports.projectLogger = (0, utils_1.createProjectLogger)('analytics-data-regulation-controller');
+//# sourceMappingURL=logger.cjs.map

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA,0BAA0B;;;AAE1B,2CAAsD;AAEzC,QAAA,aAAa,GAAG,IAAA,2BAAmB,EAC9C,sCAAsC,CACvC,CAAC","sourcesContent":["/* istanbul ignore file */\n\nimport { createProjectLogger } from '@metamask/utils';\n\nexport const projectLogger = createProjectLogger(\n  'analytics-data-regulation-controller',\n);\n"]}

package/dist/logger.d.cts

@@ -0,0 +1,3 @@
+/// <reference types="debug" />
+export declare const projectLogger: import("debug").Debugger;
+//# sourceMappingURL=logger.d.cts.map

package/dist/logger.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.cts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAIA,eAAO,MAAM,aAAa,0BAEzB,CAAC"}

package/dist/logger.d.mts

@@ -0,0 +1,3 @@
+/// <reference types="debug" />
+export declare const projectLogger: import("debug").Debugger;
+//# sourceMappingURL=logger.d.mts.map

package/dist/logger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.mts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAIA,eAAO,MAAM,aAAa,0BAEzB,CAAC"}

package/dist/logger.mjs

@@ -0,0 +1,4 @@
+/* istanbul ignore file */
+import { createProjectLogger } from "@metamask/utils";
+export const projectLogger = createProjectLogger('analytics-data-regulation-controller');
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAE1B,OAAO,EAAE,mBAAmB,EAAE,wBAAwB;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAC9C,sCAAsC,CACvC,CAAC","sourcesContent":["/* istanbul ignore file */\n\nimport { createProjectLogger } from '@metamask/utils';\n\nexport const projectLogger = createProjectLogger(\n  'analytics-data-regulation-controller',\n);\n"]}

package/dist/selectors.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsDataRegulationControllerSelectors = 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 selectHasCollectedDataSinceDeletionRequest = (state) => state.hasCollectedDataSinceDeletionRequest;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * Selectors for the AnalyticsDataRegulationController state.
+ * These can be used with Redux or directly with controller state.
+ */
+exports.analyticsDataRegulationControllerSelectors = {
+    selectHasCollectedDataSinceDeletionRequest,
+    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,0CAA0C,GAAG,CACjD,KAA6C,EACpC,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,CAC/B,KAA6C,EACzB,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,CACtC,KAA6C,EACzB,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC;AAEzD;;;GAGG;AACU,QAAA,0CAA0C,GAAG;IACxD,0CAA0C;IAC1C,wBAAwB;IACxB,+BAA+B;CAChC,CAAC","sourcesContent":["import type { AnalyticsDataRegulationControllerState } from './AnalyticsDataRegulationController';\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 selectHasCollectedDataSinceDeletionRequest = (\n  state: AnalyticsDataRegulationControllerState,\n): boolean => state.hasCollectedDataSinceDeletionRequest;\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: AnalyticsDataRegulationControllerState,\n): string | undefined => state.deleteRegulationId;\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: AnalyticsDataRegulationControllerState,\n): number | undefined => state.deleteRegulationTimestamp;\n\n/**\n * Selectors for the AnalyticsDataRegulationController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsDataRegulationControllerSelectors = {\n  selectHasCollectedDataSinceDeletionRequest,\n  selectDeleteRegulationId,\n  selectDeleteRegulationTimestamp,\n};\n"]}

package/dist/selectors.d.cts

@@ -0,0 +1,11 @@
+import type { AnalyticsDataRegulationControllerState } from "./AnalyticsDataRegulationController.cjs";
+/**
+ * Selectors for the AnalyticsDataRegulationController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsDataRegulationControllerSelectors: {
+    selectHasCollectedDataSinceDeletionRequest: (state: AnalyticsDataRegulationControllerState) => boolean;
+    selectDeleteRegulationId: (state: AnalyticsDataRegulationControllerState) => string | undefined;
+    selectDeleteRegulationTimestamp: (state: AnalyticsDataRegulationControllerState) => 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,sCAAsC,EAAE,gDAA4C;AAgClG;;;GAGG;AACH,eAAO,MAAM,0CAA0C;wDA3B9C,sCAAsC,KAC5C,OAAO;sCASD,sCAAsC,KAC5C,MAAM,GAAG,SAAS;6CASZ,sCAAsC,KAC5C,MAAM,GAAG,SAAS;CAUpB,CAAC"}

package/dist/selectors.d.mts

@@ -0,0 +1,11 @@
+import type { AnalyticsDataRegulationControllerState } from "./AnalyticsDataRegulationController.mjs";
+/**
+ * Selectors for the AnalyticsDataRegulationController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsDataRegulationControllerSelectors: {
+    selectHasCollectedDataSinceDeletionRequest: (state: AnalyticsDataRegulationControllerState) => boolean;
+    selectDeleteRegulationId: (state: AnalyticsDataRegulationControllerState) => string | undefined;
+    selectDeleteRegulationTimestamp: (state: AnalyticsDataRegulationControllerState) => 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,sCAAsC,EAAE,gDAA4C;AAgClG;;;GAGG;AACH,eAAO,MAAM,0CAA0C;wDA3B9C,sCAAsC,KAC5C,OAAO;sCASD,sCAAsC,KAC5C,MAAM,GAAG,SAAS;6CASZ,sCAAsC,KAC5C,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 selectHasCollectedDataSinceDeletionRequest = (state) => state.hasCollectedDataSinceDeletionRequest;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * Selectors for the AnalyticsDataRegulationController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export const analyticsDataRegulationControllerSelectors = {
+    selectHasCollectedDataSinceDeletionRequest,
+    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,0CAA0C,GAAG,CACjD,KAA6C,EACpC,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,CAC/B,KAA6C,EACzB,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,+BAA+B,GAAG,CACtC,KAA6C,EACzB,EAAE,CAAC,KAAK,CAAC,yBAAyB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAG;IACxD,0CAA0C;IAC1C,wBAAwB;IACxB,+BAA+B;CAChC,CAAC","sourcesContent":["import type { AnalyticsDataRegulationControllerState } from './AnalyticsDataRegulationController';\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 selectHasCollectedDataSinceDeletionRequest = (\n  state: AnalyticsDataRegulationControllerState,\n): boolean => state.hasCollectedDataSinceDeletionRequest;\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: AnalyticsDataRegulationControllerState,\n): string | undefined => state.deleteRegulationId;\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: AnalyticsDataRegulationControllerState,\n): number | undefined => state.deleteRegulationTimestamp;\n\n/**\n * Selectors for the AnalyticsDataRegulationController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsDataRegulationControllerSelectors = {\n  selectHasCollectedDataSinceDeletionRequest,\n  selectDeleteRegulationId,\n  selectDeleteRegulationTimestamp,\n};\n"]}

package/dist/types.cjs

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_DELETE_RESPONSE_STATUSES = exports.DATA_DELETE_STATUSES = void 0;
+/**
+ * Status values for data deletion requests from Segment API.
+ * Values match Segment API response values exactly.
+ */
+exports.DATA_DELETE_STATUSES = {
+    Failed: 'FAILED',
+    Finished: 'FINISHED',
+    Initialized: 'INITIALIZED',
+    Invalid: 'INVALID',
+    NotSupported: 'NOT_SUPPORTED',
+    PartialSuccess: 'PARTIAL_SUCCESS',
+    Running: 'RUNNING',
+    Unknown: 'UNKNOWN',
+};
+/**
+ * Response status for deletion regulation operations.
+ */
+exports.DATA_DELETE_RESPONSE_STATUSES = {
+    Success: 'ok',
+    Failure: 'error',
+};
+//# 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;AACU,QAAA,oBAAoB,GAAG;IAClC,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,iBAAiB;IACjC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAQX;;GAEG;AACU,QAAA,6BAA6B,GAAG;IAC3C,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,OAAO;CACR,CAAC","sourcesContent":["/**\n * Status values for data deletion requests from Segment API.\n * Values match Segment API response values exactly.\n */\nexport const DATA_DELETE_STATUSES = {\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} as const;\n\n/**\n * Type union for data deletion status values.\n */\nexport type DataDeleteStatus =\n  (typeof DATA_DELETE_STATUSES)[keyof typeof DATA_DELETE_STATUSES];\n\n/**\n * Response status for deletion regulation operations.\n */\nexport const DATA_DELETE_RESPONSE_STATUSES = {\n  Success: 'ok',\n  Failure: 'error',\n} as const;\n\n/**\n * Type union for data deletion response status values.\n */\nexport type DataDeleteResponseStatus =\n  (typeof DATA_DELETE_RESPONSE_STATUSES)[keyof typeof DATA_DELETE_RESPONSE_STATUSES];\n\n/**\n * Response from creating a data deletion task.\n * The service throws errors on failure, so this type only represents the Success case.\n */\nexport type DeleteRegulationResponse = {\n  status: typeof DATA_DELETE_RESPONSE_STATUSES.Success;\n  regulateId: string; // Using exact API field name from Segment API response\n};\n\n/**\n * Status information for a data deletion request.\n */\nexport type DeleteRegulationStatus = {\n  deletionRequestTimestamp?: number;\n  hasCollectedDataSinceDeletionRequest: boolean;\n  dataDeletionRequestStatus: DataDeleteStatus;\n};\n"]}

package/dist/types.d.cts

@@ -0,0 +1,46 @@
+/**
+ * Status values for data deletion requests from Segment API.
+ * Values match Segment API response values exactly.
+ */
+export declare const DATA_DELETE_STATUSES: {
+    readonly Failed: "FAILED";
+    readonly Finished: "FINISHED";
+    readonly Initialized: "INITIALIZED";
+    readonly Invalid: "INVALID";
+    readonly NotSupported: "NOT_SUPPORTED";
+    readonly PartialSuccess: "PARTIAL_SUCCESS";
+    readonly Running: "RUNNING";
+    readonly Unknown: "UNKNOWN";
+};
+/**
+ * Type union for data deletion status values.
+ */
+export type DataDeleteStatus = (typeof DATA_DELETE_STATUSES)[keyof typeof DATA_DELETE_STATUSES];
+/**
+ * Response status for deletion regulation operations.
+ */
+export declare const DATA_DELETE_RESPONSE_STATUSES: {
+    readonly Success: "ok";
+    readonly Failure: "error";
+};
+/**
+ * Type union for data deletion response status values.
+ */
+export type DataDeleteResponseStatus = (typeof DATA_DELETE_RESPONSE_STATUSES)[keyof typeof DATA_DELETE_RESPONSE_STATUSES];
+/**
+ * Response from creating a data deletion task.
+ * The service throws errors on failure, so this type only represents the Success case.
+ */
+export type DeleteRegulationResponse = {
+    status: typeof DATA_DELETE_RESPONSE_STATUSES.Success;
+    regulateId: string;
+};
+/**
+ * Status information for a data deletion request.
+ */
+export type DeleteRegulationStatus = {
+    deletionRequestTimestamp?: number;
+    hasCollectedDataSinceDeletionRequest: boolean;
+    dataDeletionRequestStatus: DataDeleteStatus;
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CASvB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;CAGhC,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,OAAO,6BAA6B,CAAC,OAAO,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oCAAoC,EAAE,OAAO,CAAC;IAC9C,yBAAyB,EAAE,gBAAgB,CAAC;CAC7C,CAAC"}