@metamask-previews/profile-sync-controller 19.0.0-preview-48b44963 → 19.0.0-preview-bfad74b0

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add MetaMetrics event library to standardize event properties across clients ([#6044](https://github.com/MetaMask/core/pull/6044))
+
 ## [19.0.0]
 
 ### Changed

package/dist/index.cjs

@@ -23,8 +23,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserStorageController = exports.AuthenticationController = exports.SDK = void 0;
+exports.MetaMetrics = exports.UserStorageController = exports.AuthenticationController = exports.SDK = void 0;
 exports.SDK = __importStar(require("./sdk/index.cjs"));
 exports.AuthenticationController = __importStar(require("./controllers/authentication/index.cjs"));
 exports.UserStorageController = __importStar(require("./controllers/user-storage/index.cjs"));
+exports.MetaMetrics = __importStar(require("./shared/metametrics.cjs"));
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAA6B;AAC7B,mGAAyE;AACzE,8FAAoE","sourcesContent":["export * as SDK from './sdk';\nexport * as AuthenticationController from './controllers/authentication';\nexport * as UserStorageController from './controllers/user-storage';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAA6B;AAC7B,mGAAyE;AACzE,8FAAoE;AACpE,wEAAoD","sourcesContent":["export * as SDK from './sdk';\nexport * as AuthenticationController from './controllers/authentication';\nexport * as UserStorageController from './controllers/user-storage';\nexport * as MetaMetrics from './shared/metametrics';\n"]}

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 export * as SDK from "./sdk/index.cjs";
 export * as AuthenticationController from "./controllers/authentication/index.cjs";
 export * as UserStorageController from "./controllers/user-storage/index.cjs";
+export * as MetaMetrics from "./shared/metametrics.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC;AACpE,OAAO,KAAK,WAAW,iCAA6B"}

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 export * as SDK from "./sdk/index.mjs";
 export * as AuthenticationController from "./controllers/authentication/index.mjs";
 export * as UserStorageController from "./controllers/user-storage/index.mjs";
+export * as MetaMetrics from "./shared/metametrics.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC;AACpE,OAAO,KAAK,WAAW,iCAA6B"}

package/dist/index.mjs

@@ -1,4 +1,5 @@
 export * as SDK from "./sdk/index.mjs";
 export * as AuthenticationController from "./controllers/authentication/index.mjs";
 export * as UserStorageController from "./controllers/user-storage/index.mjs";
+export * as MetaMetrics from "./shared/metametrics.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC","sourcesContent":["export * as SDK from './sdk';\nexport * as AuthenticationController from './controllers/authentication';\nexport * as UserStorageController from './controllers/user-storage';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,wBAAc;AAC7B,OAAO,KAAK,wBAAwB,+CAAqC;AACzE,OAAO,KAAK,qBAAqB,6CAAmC;AACpE,OAAO,KAAK,WAAW,iCAA6B","sourcesContent":["export * as SDK from './sdk';\nexport * as AuthenticationController from './controllers/authentication';\nexport * as UserStorageController from './controllers/user-storage';\nexport * as MetaMetrics from './shared/metametrics';\n"]}

package/dist/shared/metametrics.cjs

@@ -0,0 +1,157 @@
+"use strict";
+/**
+ * MetaMetrics events library for profile-sync-controller
+ *
+ * This library provides type-safe event definitions that mirror the segment schema,
+ * ensuring consistency and providing compile-time validation for event properties.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIdentityEvent = exports.IDENTITY_EVENTS = void 0;
+/**
+ * Identity events definitions matching the segment schema
+ */
+exports.IDENTITY_EVENTS = {
+    ACCOUNT_SYNCING: {
+        ACCOUNTS_SYNC_ADDED: {
+            name: 'Accounts Sync Added',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        ACCOUNTS_SYNC_NAME_UPDATED: {
+            name: 'Accounts Sync Name Updated',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {
+            name: 'Accounts Sync Erroneous Situation',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                situation_message: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+    },
+    NETWORK_SYNCING: {
+        NETWORK_SYNC_ADDED: {
+            name: 'Network Sync Added',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        NETWORK_SYNC_UPDATED: {
+            name: 'Network Sync Updated',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        NETWORK_SYNC_REMOVED: {
+            name: 'Network Sync Removed',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+    },
+    PROFILE: {
+        ACTIVITY_UPDATED: {
+            name: 'Profile Activity Updated',
+            properties: {
+                profile_id: {
+                    required: false,
+                    type: 'string',
+                },
+                feature_name: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        BACKUP_AND_SYNC: 'Backup And Sync',
+                        AUTHENTICATION: 'Authentication',
+                    },
+                },
+                action: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        CONTACTS_SYNC_CONTACT_UPDATED: 'Contacts Sync Contact Updated',
+                        CONTACTS_SYNC_CONTACT_DELETED: 'Contacts Sync Contact Deleted',
+                        CONTACTS_SYNC_ERRONEOUS_SITUATION: 'Contacts Sync Erroneous Situation',
+                        SETTINGS_TOGGLE_ENABLED: 'settings_toggle_enabled',
+                        SETTINGS_TOGGLE_DISABLED: 'settings_toggle_disabled',
+                        SIGN_IN: 'Sign In',
+                        SIGN_OUT: 'Sign Out',
+                        AUTHENTICATION_FAILED: 'Authentication Failed',
+                    },
+                },
+                additional_description: {
+                    required: false,
+                    type: 'string',
+                },
+            },
+        },
+        BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {
+            name: 'Backup And Sync Introduction Modal Interaction',
+            properties: {
+                profile_id: {
+                    required: false,
+                    type: 'string',
+                },
+                action: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        MODAL_OPENED: 'modal_opened',
+                        MODAL_CLOSED: 'modal_closed',
+                        ENABLE_CLICKED: 'enable_clicked',
+                        DISMISS_CLICKED: 'dismiss_clicked',
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Type-safe event builder function
+ *
+ * @param event - The event definition
+ * @param properties - The event properties (type-checked)
+ * @returns An object with the event name and properties
+ */
+const buildIdentityEvent = (event, properties) => ({
+    name: event.name,
+    properties,
+});
+exports.buildIdentityEvent = buildIdentityEvent;
+//# sourceMappingURL=metametrics.cjs.map

package/dist/shared/metametrics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metametrics.cjs","sourceRoot":"","sources":["../../src/shared/metametrics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MetaMetrics events library for profile-sync-controller\n *\n * This library provides type-safe event definitions that mirror the segment schema,\n * ensuring consistency and providing compile-time validation for event properties.\n */\n\n/**\n * Interface defining the structure of an identity event\n */\nexport type IdentityEvent = {\n  name: string;\n  properties: {\n    [key: string]: {\n      required: boolean;\n      type: 'string' | 'number' | 'boolean';\n      fromObject?: Record<string, string>;\n    };\n  };\n};\n\n/**\n * Type utility to extract property types from event definitions\n */\ntype PropertyType<T, FromObject> =\n  FromObject extends Record<string, string>\n    ? FromObject[keyof FromObject]\n    : T extends 'string'\n      ? string\n      : T extends 'number'\n        ? number\n        : T extends 'boolean'\n          ? boolean\n          : never;\n\n/**\n * Type utility to generate event properties with proper required/optional handling\n */\ntype EventProperties<T extends IdentityEvent> = {\n  [K in keyof T['properties'] as T['properties'][K]['required'] extends true\n    ? K\n    : never]: PropertyType<\n    T['properties'][K]['type'],\n    T['properties'][K]['fromObject']\n  >;\n} & {\n  [K in keyof T['properties'] as T['properties'][K]['required'] extends false\n    ? K\n    : never]?: PropertyType<\n    T['properties'][K]['type'],\n    T['properties'][K]['fromObject']\n  >;\n};\n\n/**\n * Identity events definitions matching the segment schema\n */\nexport const IDENTITY_EVENTS = {\n  ACCOUNT_SYNCING: {\n    ACCOUNTS_SYNC_ADDED: {\n      name: 'Accounts Sync Added',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    ACCOUNTS_SYNC_NAME_UPDATED: {\n      name: 'Accounts Sync Name Updated',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {\n      name: 'Accounts Sync Erroneous Situation',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        situation_message: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n  },\n  NETWORK_SYNCING: {\n    NETWORK_SYNC_ADDED: {\n      name: 'Network Sync Added',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    NETWORK_SYNC_UPDATED: {\n      name: 'Network Sync Updated',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    NETWORK_SYNC_REMOVED: {\n      name: 'Network Sync Removed',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n  },\n  PROFILE: {\n    ACTIVITY_UPDATED: {\n      name: 'Profile Activity Updated',\n      properties: {\n        profile_id: {\n          required: false,\n          type: 'string',\n        },\n        feature_name: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            BACKUP_AND_SYNC: 'Backup And Sync',\n            AUTHENTICATION: 'Authentication',\n          },\n        },\n        action: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            CONTACTS_SYNC_CONTACT_UPDATED: 'Contacts Sync Contact Updated',\n            CONTACTS_SYNC_CONTACT_DELETED: 'Contacts Sync Contact Deleted',\n            CONTACTS_SYNC_ERRONEOUS_SITUATION:\n              'Contacts Sync Erroneous Situation',\n            SETTINGS_TOGGLE_ENABLED: 'settings_toggle_enabled',\n            SETTINGS_TOGGLE_DISABLED: 'settings_toggle_disabled',\n            SIGN_IN: 'Sign In',\n            SIGN_OUT: 'Sign Out',\n            AUTHENTICATION_FAILED: 'Authentication Failed',\n          },\n        },\n        additional_description: {\n          required: false,\n          type: 'string',\n        },\n      },\n    },\n    BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {\n      name: 'Backup And Sync Introduction Modal Interaction',\n      properties: {\n        profile_id: {\n          required: false,\n          type: 'string',\n        },\n        action: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            MODAL_OPENED: 'modal_opened',\n            MODAL_CLOSED: 'modal_closed',\n            ENABLE_CLICKED: 'enable_clicked',\n            DISMISS_CLICKED: 'dismiss_clicked',\n          },\n        },\n      },\n    },\n  },\n} as const satisfies Record<string, Record<string, IdentityEvent>>;\n\n/**\n * Type-safe event builder function\n *\n * @param event - The event definition\n * @param properties - The event properties (type-checked)\n * @returns An object with the event name and properties\n */\nexport const buildIdentityEvent = <T extends IdentityEvent>(\n  event: T,\n  properties: EventProperties<T>,\n): { name: (typeof event)['name']; properties: typeof properties } => ({\n  name: event.name,\n  properties,\n});\n\n// Export types for external use\nexport type IdentityEventBuilder = typeof buildIdentityEvent;\nexport type IdentityEventDefinitions = typeof IDENTITY_EVENTS;\n"]}

package/dist/shared/metametrics.d.cts

@@ -0,0 +1,181 @@
+/**
+ * MetaMetrics events library for profile-sync-controller
+ *
+ * This library provides type-safe event definitions that mirror the segment schema,
+ * ensuring consistency and providing compile-time validation for event properties.
+ */
+/**
+ * Interface defining the structure of an identity event
+ */
+export type IdentityEvent = {
+    name: string;
+    properties: {
+        [key: string]: {
+            required: boolean;
+            type: 'string' | 'number' | 'boolean';
+            fromObject?: Record<string, string>;
+        };
+    };
+};
+/**
+ * Type utility to extract property types from event definitions
+ */
+type PropertyType<T, FromObject> = FromObject extends Record<string, string> ? FromObject[keyof FromObject] : T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : never;
+/**
+ * Type utility to generate event properties with proper required/optional handling
+ */
+type EventProperties<T extends IdentityEvent> = {
+    [K in keyof T['properties'] as T['properties'][K]['required'] extends true ? K : never]: PropertyType<T['properties'][K]['type'], T['properties'][K]['fromObject']>;
+} & {
+    [K in keyof T['properties'] as T['properties'][K]['required'] extends false ? K : never]?: PropertyType<T['properties'][K]['type'], T['properties'][K]['fromObject']>;
+};
+/**
+ * Identity events definitions matching the segment schema
+ */
+export declare const IDENTITY_EVENTS: {
+    readonly ACCOUNT_SYNCING: {
+        readonly ACCOUNTS_SYNC_ADDED: {
+            readonly name: "Accounts Sync Added";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly ACCOUNTS_SYNC_NAME_UPDATED: {
+            readonly name: "Accounts Sync Name Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {
+            readonly name: "Accounts Sync Erroneous Situation";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly situation_message: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly NETWORK_SYNCING: {
+        readonly NETWORK_SYNC_ADDED: {
+            readonly name: "Network Sync Added";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly NETWORK_SYNC_UPDATED: {
+            readonly name: "Network Sync Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly NETWORK_SYNC_REMOVED: {
+            readonly name: "Network Sync Removed";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly PROFILE: {
+        readonly ACTIVITY_UPDATED: {
+            readonly name: "Profile Activity Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+                readonly feature_name: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly BACKUP_AND_SYNC: "Backup And Sync";
+                        readonly AUTHENTICATION: "Authentication";
+                    };
+                };
+                readonly action: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly CONTACTS_SYNC_CONTACT_UPDATED: "Contacts Sync Contact Updated";
+                        readonly CONTACTS_SYNC_CONTACT_DELETED: "Contacts Sync Contact Deleted";
+                        readonly CONTACTS_SYNC_ERRONEOUS_SITUATION: "Contacts Sync Erroneous Situation";
+                        readonly SETTINGS_TOGGLE_ENABLED: "settings_toggle_enabled";
+                        readonly SETTINGS_TOGGLE_DISABLED: "settings_toggle_disabled";
+                        readonly SIGN_IN: "Sign In";
+                        readonly SIGN_OUT: "Sign Out";
+                        readonly AUTHENTICATION_FAILED: "Authentication Failed";
+                    };
+                };
+                readonly additional_description: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {
+            readonly name: "Backup And Sync Introduction Modal Interaction";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+                readonly action: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly MODAL_OPENED: "modal_opened";
+                        readonly MODAL_CLOSED: "modal_closed";
+                        readonly ENABLE_CLICKED: "enable_clicked";
+                        readonly DISMISS_CLICKED: "dismiss_clicked";
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * Type-safe event builder function
+ *
+ * @param event - The event definition
+ * @param properties - The event properties (type-checked)
+ * @returns An object with the event name and properties
+ */
+export declare const buildIdentityEvent: <T extends IdentityEvent>(event: T, properties: EventProperties<T>) => {
+    name: T["name"];
+    properties: EventProperties<T>;
+};
+export type IdentityEventBuilder = typeof buildIdentityEvent;
+export type IdentityEventDefinitions = typeof IDENTITY_EVENTS;
+export {};
+//# sourceMappingURL=metametrics.d.cts.map

package/dist/shared/metametrics.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metametrics.d.cts","sourceRoot":"","sources":["../../src/shared/metametrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;YACtC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACrC,CAAC;KACH,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,EAAE,UAAU,IAC7B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,UAAU,CAAC,MAAM,UAAU,CAAC,GAC5B,CAAC,SAAS,QAAQ,GAChB,MAAM,GACN,CAAC,SAAS,QAAQ,GAChB,MAAM,GACN,CAAC,SAAS,SAAS,GACjB,OAAO,GACP,KAAK,CAAC;AAElB;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GACtE,CAAC,GACD,KAAK,GAAG,YAAY,CACtB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAC1B,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CACjC;CACF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,KAAK,GACvE,CAAC,GACD,KAAK,CAAC,CAAC,EAAE,YAAY,CACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAC1B,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CACjC;CACF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIsC,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;CAM7B,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,OAAO,kBAAkB,CAAC;AAC7D,MAAM,MAAM,wBAAwB,GAAG,OAAO,eAAe,CAAC"}

package/dist/shared/metametrics.d.mts

@@ -0,0 +1,181 @@
+/**
+ * MetaMetrics events library for profile-sync-controller
+ *
+ * This library provides type-safe event definitions that mirror the segment schema,
+ * ensuring consistency and providing compile-time validation for event properties.
+ */
+/**
+ * Interface defining the structure of an identity event
+ */
+export type IdentityEvent = {
+    name: string;
+    properties: {
+        [key: string]: {
+            required: boolean;
+            type: 'string' | 'number' | 'boolean';
+            fromObject?: Record<string, string>;
+        };
+    };
+};
+/**
+ * Type utility to extract property types from event definitions
+ */
+type PropertyType<T, FromObject> = FromObject extends Record<string, string> ? FromObject[keyof FromObject] : T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : never;
+/**
+ * Type utility to generate event properties with proper required/optional handling
+ */
+type EventProperties<T extends IdentityEvent> = {
+    [K in keyof T['properties'] as T['properties'][K]['required'] extends true ? K : never]: PropertyType<T['properties'][K]['type'], T['properties'][K]['fromObject']>;
+} & {
+    [K in keyof T['properties'] as T['properties'][K]['required'] extends false ? K : never]?: PropertyType<T['properties'][K]['type'], T['properties'][K]['fromObject']>;
+};
+/**
+ * Identity events definitions matching the segment schema
+ */
+export declare const IDENTITY_EVENTS: {
+    readonly ACCOUNT_SYNCING: {
+        readonly ACCOUNTS_SYNC_ADDED: {
+            readonly name: "Accounts Sync Added";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly ACCOUNTS_SYNC_NAME_UPDATED: {
+            readonly name: "Accounts Sync Name Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {
+            readonly name: "Accounts Sync Erroneous Situation";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly situation_message: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly NETWORK_SYNCING: {
+        readonly NETWORK_SYNC_ADDED: {
+            readonly name: "Network Sync Added";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly NETWORK_SYNC_UPDATED: {
+            readonly name: "Network Sync Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly NETWORK_SYNC_REMOVED: {
+            readonly name: "Network Sync Removed";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+                readonly chain_id: {
+                    readonly required: true;
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+    readonly PROFILE: {
+        readonly ACTIVITY_UPDATED: {
+            readonly name: "Profile Activity Updated";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+                readonly feature_name: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly BACKUP_AND_SYNC: "Backup And Sync";
+                        readonly AUTHENTICATION: "Authentication";
+                    };
+                };
+                readonly action: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly CONTACTS_SYNC_CONTACT_UPDATED: "Contacts Sync Contact Updated";
+                        readonly CONTACTS_SYNC_CONTACT_DELETED: "Contacts Sync Contact Deleted";
+                        readonly CONTACTS_SYNC_ERRONEOUS_SITUATION: "Contacts Sync Erroneous Situation";
+                        readonly SETTINGS_TOGGLE_ENABLED: "settings_toggle_enabled";
+                        readonly SETTINGS_TOGGLE_DISABLED: "settings_toggle_disabled";
+                        readonly SIGN_IN: "Sign In";
+                        readonly SIGN_OUT: "Sign Out";
+                        readonly AUTHENTICATION_FAILED: "Authentication Failed";
+                    };
+                };
+                readonly additional_description: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {
+            readonly name: "Backup And Sync Introduction Modal Interaction";
+            readonly properties: {
+                readonly profile_id: {
+                    readonly required: false;
+                    readonly type: "string";
+                };
+                readonly action: {
+                    readonly required: true;
+                    readonly type: "string";
+                    readonly fromObject: {
+                        readonly MODAL_OPENED: "modal_opened";
+                        readonly MODAL_CLOSED: "modal_closed";
+                        readonly ENABLE_CLICKED: "enable_clicked";
+                        readonly DISMISS_CLICKED: "dismiss_clicked";
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * Type-safe event builder function
+ *
+ * @param event - The event definition
+ * @param properties - The event properties (type-checked)
+ * @returns An object with the event name and properties
+ */
+export declare const buildIdentityEvent: <T extends IdentityEvent>(event: T, properties: EventProperties<T>) => {
+    name: T["name"];
+    properties: EventProperties<T>;
+};
+export type IdentityEventBuilder = typeof buildIdentityEvent;
+export type IdentityEventDefinitions = typeof IDENTITY_EVENTS;
+export {};
+//# sourceMappingURL=metametrics.d.mts.map

package/dist/shared/metametrics.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metametrics.d.mts","sourceRoot":"","sources":["../../src/shared/metametrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;YACtC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACrC,CAAC;KACH,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,EAAE,UAAU,IAC7B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,UAAU,CAAC,MAAM,UAAU,CAAC,GAC5B,CAAC,SAAS,QAAQ,GAChB,MAAM,GACN,CAAC,SAAS,QAAQ,GAChB,MAAM,GACN,CAAC,SAAS,SAAS,GACjB,OAAO,GACP,KAAK,CAAC;AAElB;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GACtE,CAAC,GACD,KAAK,GAAG,YAAY,CACtB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAC1B,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CACjC;CACF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,KAAK,GACvE,CAAC,GACD,KAAK,CAAC,CAAC,EAAE,YAAY,CACvB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAC1B,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CACjC;CACF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoIsC,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;CAM7B,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,OAAO,kBAAkB,CAAC;AAC7D,MAAM,MAAM,wBAAwB,GAAG,OAAO,eAAe,CAAC"}

package/dist/shared/metametrics.mjs

@@ -0,0 +1,153 @@
+/**
+ * MetaMetrics events library for profile-sync-controller
+ *
+ * This library provides type-safe event definitions that mirror the segment schema,
+ * ensuring consistency and providing compile-time validation for event properties.
+ */
+/**
+ * Identity events definitions matching the segment schema
+ */
+export const IDENTITY_EVENTS = {
+    ACCOUNT_SYNCING: {
+        ACCOUNTS_SYNC_ADDED: {
+            name: 'Accounts Sync Added',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        ACCOUNTS_SYNC_NAME_UPDATED: {
+            name: 'Accounts Sync Name Updated',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {
+            name: 'Accounts Sync Erroneous Situation',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                situation_message: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+    },
+    NETWORK_SYNCING: {
+        NETWORK_SYNC_ADDED: {
+            name: 'Network Sync Added',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        NETWORK_SYNC_UPDATED: {
+            name: 'Network Sync Updated',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+        NETWORK_SYNC_REMOVED: {
+            name: 'Network Sync Removed',
+            properties: {
+                profile_id: {
+                    required: true,
+                    type: 'string',
+                },
+                chain_id: {
+                    required: true,
+                    type: 'string',
+                },
+            },
+        },
+    },
+    PROFILE: {
+        ACTIVITY_UPDATED: {
+            name: 'Profile Activity Updated',
+            properties: {
+                profile_id: {
+                    required: false,
+                    type: 'string',
+                },
+                feature_name: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        BACKUP_AND_SYNC: 'Backup And Sync',
+                        AUTHENTICATION: 'Authentication',
+                    },
+                },
+                action: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        CONTACTS_SYNC_CONTACT_UPDATED: 'Contacts Sync Contact Updated',
+                        CONTACTS_SYNC_CONTACT_DELETED: 'Contacts Sync Contact Deleted',
+                        CONTACTS_SYNC_ERRONEOUS_SITUATION: 'Contacts Sync Erroneous Situation',
+                        SETTINGS_TOGGLE_ENABLED: 'settings_toggle_enabled',
+                        SETTINGS_TOGGLE_DISABLED: 'settings_toggle_disabled',
+                        SIGN_IN: 'Sign In',
+                        SIGN_OUT: 'Sign Out',
+                        AUTHENTICATION_FAILED: 'Authentication Failed',
+                    },
+                },
+                additional_description: {
+                    required: false,
+                    type: 'string',
+                },
+            },
+        },
+        BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {
+            name: 'Backup And Sync Introduction Modal Interaction',
+            properties: {
+                profile_id: {
+                    required: false,
+                    type: 'string',
+                },
+                action: {
+                    required: true,
+                    type: 'string',
+                    fromObject: {
+                        MODAL_OPENED: 'modal_opened',
+                        MODAL_CLOSED: 'modal_closed',
+                        ENABLE_CLICKED: 'enable_clicked',
+                        DISMISS_CLICKED: 'dismiss_clicked',
+                    },
+                },
+            },
+        },
+    },
+};
+/**
+ * Type-safe event builder function
+ *
+ * @param event - The event definition
+ * @param properties - The event properties (type-checked)
+ * @returns An object with the event name and properties
+ */
+export const buildIdentityEvent = (event, properties) => ({
+    name: event.name,
+    properties,
+});
+//# sourceMappingURL=metametrics.mjs.map

package/dist/shared/metametrics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metametrics.mjs","sourceRoot":"","sources":["../../src/shared/metametrics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MetaMetrics events library for profile-sync-controller\n *\n * This library provides type-safe event definitions that mirror the segment schema,\n * ensuring consistency and providing compile-time validation for event properties.\n */\n\n/**\n * Interface defining the structure of an identity event\n */\nexport type IdentityEvent = {\n  name: string;\n  properties: {\n    [key: string]: {\n      required: boolean;\n      type: 'string' | 'number' | 'boolean';\n      fromObject?: Record<string, string>;\n    };\n  };\n};\n\n/**\n * Type utility to extract property types from event definitions\n */\ntype PropertyType<T, FromObject> =\n  FromObject extends Record<string, string>\n    ? FromObject[keyof FromObject]\n    : T extends 'string'\n      ? string\n      : T extends 'number'\n        ? number\n        : T extends 'boolean'\n          ? boolean\n          : never;\n\n/**\n * Type utility to generate event properties with proper required/optional handling\n */\ntype EventProperties<T extends IdentityEvent> = {\n  [K in keyof T['properties'] as T['properties'][K]['required'] extends true\n    ? K\n    : never]: PropertyType<\n    T['properties'][K]['type'],\n    T['properties'][K]['fromObject']\n  >;\n} & {\n  [K in keyof T['properties'] as T['properties'][K]['required'] extends false\n    ? K\n    : never]?: PropertyType<\n    T['properties'][K]['type'],\n    T['properties'][K]['fromObject']\n  >;\n};\n\n/**\n * Identity events definitions matching the segment schema\n */\nexport const IDENTITY_EVENTS = {\n  ACCOUNT_SYNCING: {\n    ACCOUNTS_SYNC_ADDED: {\n      name: 'Accounts Sync Added',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    ACCOUNTS_SYNC_NAME_UPDATED: {\n      name: 'Accounts Sync Name Updated',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    ACCOUNTS_SYNC_ERRONEOUS_SITUATION: {\n      name: 'Accounts Sync Erroneous Situation',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        situation_message: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n  },\n  NETWORK_SYNCING: {\n    NETWORK_SYNC_ADDED: {\n      name: 'Network Sync Added',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    NETWORK_SYNC_UPDATED: {\n      name: 'Network Sync Updated',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n    NETWORK_SYNC_REMOVED: {\n      name: 'Network Sync Removed',\n      properties: {\n        profile_id: {\n          required: true,\n          type: 'string',\n        },\n        chain_id: {\n          required: true,\n          type: 'string',\n        },\n      },\n    },\n  },\n  PROFILE: {\n    ACTIVITY_UPDATED: {\n      name: 'Profile Activity Updated',\n      properties: {\n        profile_id: {\n          required: false,\n          type: 'string',\n        },\n        feature_name: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            BACKUP_AND_SYNC: 'Backup And Sync',\n            AUTHENTICATION: 'Authentication',\n          },\n        },\n        action: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            CONTACTS_SYNC_CONTACT_UPDATED: 'Contacts Sync Contact Updated',\n            CONTACTS_SYNC_CONTACT_DELETED: 'Contacts Sync Contact Deleted',\n            CONTACTS_SYNC_ERRONEOUS_SITUATION:\n              'Contacts Sync Erroneous Situation',\n            SETTINGS_TOGGLE_ENABLED: 'settings_toggle_enabled',\n            SETTINGS_TOGGLE_DISABLED: 'settings_toggle_disabled',\n            SIGN_IN: 'Sign In',\n            SIGN_OUT: 'Sign Out',\n            AUTHENTICATION_FAILED: 'Authentication Failed',\n          },\n        },\n        additional_description: {\n          required: false,\n          type: 'string',\n        },\n      },\n    },\n    BACKUP_AND_SYNC_INTRODUCTION_MODAL_INTERACTION: {\n      name: 'Backup And Sync Introduction Modal Interaction',\n      properties: {\n        profile_id: {\n          required: false,\n          type: 'string',\n        },\n        action: {\n          required: true,\n          type: 'string',\n          fromObject: {\n            MODAL_OPENED: 'modal_opened',\n            MODAL_CLOSED: 'modal_closed',\n            ENABLE_CLICKED: 'enable_clicked',\n            DISMISS_CLICKED: 'dismiss_clicked',\n          },\n        },\n      },\n    },\n  },\n} as const satisfies Record<string, Record<string, IdentityEvent>>;\n\n/**\n * Type-safe event builder function\n *\n * @param event - The event definition\n * @param properties - The event properties (type-checked)\n * @returns An object with the event name and properties\n */\nexport const buildIdentityEvent = <T extends IdentityEvent>(\n  event: T,\n  properties: EventProperties<T>,\n): { name: (typeof event)['name']; properties: typeof properties } => ({\n  name: event.name,\n  properties,\n});\n\n// Export types for external use\nexport type IdentityEventBuilder = typeof buildIdentityEvent;\nexport type IdentityEventDefinitions = typeof IDENTITY_EVENTS;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/profile-sync-controller",
-  "version": "19.0.0-preview-48b44963",
+  "version": "19.0.0-preview-bfad74b0",
   "description": "The profile sync helps developers synchronize data across multiple clients and devices in a privacy-preserving way. All data saved in the user storage database is encrypted client-side to preserve privacy. The user storage provides a modular design, giving developers the flexibility to construct and manage their storage spaces in a way that best suits their needs",
   "keywords": [
     "MetaMask",