feat(logger): definePackage, the new api for global alwatr

packages/logger/src/define-package.ts

@@ -0,0 +1,23 @@
+import {createLogger} from './logger.js';
+
+import type {} from './type.js';
+
+globalThis.Alwatr ??= {packages: {}};
+Alwatr.packages ??= {};
+
+const logger = createLogger('logger');
+
+export const definePackage = (packageName: string, version: string) => {
+  logger.logMethodArgs?.('define-package', {packageName, version});
+
+  if (packageName in Alwatr.packages) {
+    logger.accident?.('define-package', 'duplicate_package_defined', {
+      packageName,
+      new: version,
+      old: Alwatr.packages[packageName],
+    });
+    return;
+  }
+
+  Alwatr.packages[packageName] = version;
+};

packages/logger/src/type.ts

@@ -1,3 +1,13 @@
+/* eslint-disable no-var */
+
+export interface GlobalAlwatr {
+  packages: Record<string, string>;
+}
+
+declare global {
+  var Alwatr: GlobalAlwatr;
+}
+
 export interface AlwatrLogger {
   /**
    * Debug state for current scope base on localStorage `ALWATR_LOG` pattern.