@appbuildersph/core 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,76 @@
+# @appbuildersph/core
+
+The Trust, Identity, Monitoring & AI SDK for Modern Applications — a single
+`AppBuilders.init()` call wires up identity, logging, notifications, the
+verified badge, and (opt-in) app health watching.
+
+## Install
+
+```bash
+npm install @appbuildersph/core
+```
+
+## Usage
+
+```ts
+import { AppBuilders } from "@appbuildersph/core";
+
+AppBuilders.init({
+  appName: "My App",
+  organization: "Acme Inc",
+  developer: "jane@acme.com",
+  environment: "production", // defaults to NODE_ENV-derived value
+
+  // feature flags — see table below for defaults
+  identity: true,
+  logger: true,
+  notifications: true,
+  badge: true,
+  watcher: false,
+
+  plugins: [
+    {
+      name: "my-plugin",
+      setup: ({ config, registerHook }) => {
+        registerHook("incident", (incident) => console.error("incident!", incident));
+      },
+    },
+  ],
+});
+
+AppBuilders.verify(); // true once identity is generated
+AppBuilders.identity().get(); // IdentitySnapshot | null
+AppBuilders.logger()?.info("server started");
+await AppBuilders.notifications()?.success("Deployed", "v1.2.3 is live");
+AppBuilders.badge(); // Badge | null — auto-mounted on init() in a browser
+AppBuilders.watcher()?.health(); // only non-null if `watcher: true` (auto-started)
+
+AppBuilders.shutdown(); // stops the watcher and unmounts the badge
+```
+
+## Feature flags
+
+| Config key      | Default | Package                                        |
+| ---------------- | ------- | ----------------------------------------------- |
+| `identity`       | `true`  | built-in (application identity + verification hash) |
+| `logger`         | `true`  | [`@appbuildersph/logger`](../logger)             |
+| `notifications`  | `true`  | [`@appbuildersph/notifications`](../notifications) |
+| `badge`          | `true`  | [`@appbuildersph/badge`](../badge)               |
+| `watcher`        | `false` | [`@appbuildersph/watcher`](../watcher) — opt-in since it starts an interval timer and installs process crash hooks |
+
+Each accessor (`logger()`, `notifications()`, `badge()`, `watcher()`) returns
+`null` if its flag is disabled — always guard with `?.` or a null check.
+
+## Plugins
+
+`plugins` is a list of `{ name, setup(ctx) }` objects run once during
+`init()`. `ctx.registerHook(event, handler)` subscribes to internal events —
+currently `"incident"` and `"metrics"`, both emitted by the watcher when
+enabled.
+
+## Identity
+
+Every app gets a signed `IdentitySnapshot` (uuid, org/developer, environment,
+git commit/branch, hostname, a SHA-256 verification hash) unless
+`identity: false`. See `AppBuilders.identity()` for `get()`, `refresh()`,
+`verify()`, and `export()` (JSON string).

package/dist/index.cjs

@@ -1,10 +1,14 @@
 'use strict';
 
+var badge = require('@appbuildersph/badge');
+var logger = require('@appbuildersph/logger');
+var notifications = require('@appbuildersph/notifications');
+var watcher = require('@appbuildersph/watcher');
 var crypto = require('crypto');
 var os = require('os');
 var shared = require('@appbuildersph/shared');
 
-// src/identity.ts
+// src/app-builders.ts
 function createIdentitySnapshot(config) {
   const timestamp = shared.nowIso();
   const environment = config.environment ?? shared.resolveEnvironment();
@@ -27,15 +31,69 @@ function createIdentitySnapshot(config) {
   return { ...base, verificationHash };
 }
 
+// src/hooks.ts
+function createHookRegistry() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    register(event, handler) {
+      const existing = handlers.get(event);
+      if (existing) {
+        existing.push(handler);
+      } else {
+        handlers.set(event, [handler]);
+      }
+    },
+    emit(event, ...args) {
+      for (const handler of handlers.get(event) ?? []) {
+        handler(...args);
+      }
+    }
+  };
+}
+
 // src/app-builders.ts
 var AppBuildersInstance = class {
   config;
   identitySnapshot = null;
+  loggerInstance = null;
+  notificationCenter = null;
+  watcherInstance = null;
+  badgeInstance = null;
+  hooks = createHookRegistry();
   constructor(config) {
     this.config = config;
     if (config.identity ?? true) {
       this.identitySnapshot = createIdentitySnapshot(config);
     }
+    if (config.logger ?? true) {
+      this.loggerInstance = new logger.Logger();
+    }
+    if (config.notifications ?? true) {
+      this.notificationCenter = new notifications.NotificationCenter();
+    }
+    if (config.badge ?? true) {
+      this.badgeInstance = new badge.Badge(
+        {
+          appName: config.appName,
+          organization: config.organization,
+          developer: config.developer,
+          environment: config.environment,
+          verified: this.identitySnapshot !== null
+        },
+        config.badge
+      );
+      this.badgeInstance.mount();
+    }
+    if (config.watcher) {
+      this.watcherInstance = new watcher.Watcher({
+        onIncident: (incident) => this.hooks.emit("incident", incident),
+        onMetrics: (snapshot) => this.hooks.emit("metrics", snapshot)
+      });
+      this.watcherInstance.start();
+    }
+    for (const plugin of config.plugins ?? []) {
+      plugin.setup({ config, registerHook: this.hooks.register });
+    }
   }
   identity() {
     return {
@@ -48,9 +106,25 @@ var AppBuildersInstance = class {
       export: () => JSON.stringify(this.identitySnapshot, null, 2)
     };
   }
+  logger() {
+    return this.loggerInstance;
+  }
+  notifications() {
+    return this.notificationCenter;
+  }
+  watcher() {
+    return this.watcherInstance;
+  }
+  badge() {
+    return this.badgeInstance;
+  }
   verify() {
     return this.identitySnapshot !== null;
   }
+  shutdown() {
+    this.watcherInstance?.stop();
+    this.badgeInstance?.unmount();
+  }
 };
 var instance = null;
 function init(config) {
@@ -68,7 +142,12 @@ function getInstance() {
 var AppBuilders = {
   init,
   verify: () => getInstance().verify(),
-  identity: () => getInstance().identity()
+  identity: () => getInstance().identity(),
+  logger: () => getInstance().logger(),
+  notifications: () => getInstance().notifications(),
+  watcher: () => getInstance().watcher(),
+  badge: () => getInstance().badge(),
+  shutdown: () => getInstance().shutdown()
 };
 
 exports.AppBuilders = AppBuilders;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/identity.ts","../src/app-builders.ts","../src/index.ts"],"names":["nowIso","resolveEnvironment","randomUUID","hostname","createHash"],"mappings":";;;;;;;AAKO,SAAS,uBAAuB,MAAA,EAA6C;AAClF,EAAA,MAAM,YAAYA,aAAA,EAAO;AACzB,EAAA,MAAM,WAAA,GAAc,MAAA,CAAO,WAAA,IAAeC,yBAAA,EAAmB;AAE7D,EAAA,MAAM,IAAA,GAAmD;AAAA,IACvD,SAASC,iBAAA,EAAW;AAAA,IACpB,aAAaA,iBAAA,EAAW;AAAA,IACxB,aAAa,MAAA,CAAO,SAAA;AAAA,IACpB,gBAAgB,MAAA,CAAO,YAAA;AAAA,IACvB,UAAUC,WAAA,EAAS;AAAA,IACnB,MAAA,EAAQ,QAAQ,GAAA,CAAI,kBAAA;AAAA,IACpB,WAAA;AAAA,IACA,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,WAAA,EAAa,QAAQ,GAAA,CAAI,YAAA;AAAA,IACzB,cAAA,EAAgB,QAAQ,GAAA,CAAI,mBAAA;AAAA,IAC5B,kBAAA,EAAoB,OAAA,CAAQ,GAAA,CAAI,MAAA,GAAS,QAAA,GAAW,MAAA;AAAA,IACpD;AAAA,GACF;AAEA,EAAA,MAAM,gBAAA,GAAmBC,iBAAA,CAAW,QAAQ,CAAA,CACzC,MAAA,CAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA,CAC3B,MAAA,CAAO,KAAK,CAAA;AAEf,EAAA,OAAO,EAAE,GAAG,IAAA,EAAM,gBAAA,EAAiB;AACrC;;;AC3BO,IAAM,sBAAN,MAA0B;AAAA,EACtB,MAAA;AAAA,EACD,gBAAA,GAA4C,IAAA;AAAA,EAEpD,YAAY,MAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,IAAI,MAAA,CAAO,YAAY,IAAA,EAAM;AAC3B,MAAA,IAAA,CAAK,gBAAA,GAAmB,uBAAuB,MAAM,CAAA;AAAA,IACvD;AAAA,EACF;AAAA,EAEA,QAAA,GAAW;AACT,IAAA,OAAO;AAAA,MACL,GAAA,EAAK,MAA+B,IAAA,CAAK,gBAAA;AAAA,MACzC,SAAS,MAAwB;AAC/B,QAAA,IAAA,CAAK,gBAAA,GAAmB,sBAAA,CAAuB,IAAA,CAAK,MAAM,CAAA;AAC1D,QAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,MACd,CAAA;AAAA,MACA,MAAA,EAAQ,MAAe,IAAA,CAAK,gBAAA,KAAqB,IAAA;AAAA,MACjD,QAAQ,MAAc,IAAA,CAAK,UAAU,IAAA,CAAK,gBAAA,EAAkB,MAAM,CAAC;AAAA,KACrE;AAAA,EACF;AAAA,EAEA,MAAA,GAAkB;AAChB,IAAA,OAAO,KAAK,gBAAA,KAAqB,IAAA;AAAA,EACnC;AACF,CAAA;AAEA,IAAI,QAAA,GAAuC,IAAA;AAEpC,SAAS,KAAK,MAAA,EAAgD;AACnE,EAAA,QAAA,GAAW,IAAI,oBAAoB,MAAM,CAAA;AACzC,EAAA,OAAO,QAAA;AACT;AAEO,SAAS,WAAA,GAAmC;AACjD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AC5CO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA;AAAA,EACA,MAAA,EAAQ,MAAM,WAAA,EAAY,CAAE,MAAA,EAAO;AAAA,EACnC,QAAA,EAAU,MAAM,WAAA,EAAY,CAAE,QAAA;AAChC","file":"index.cjs","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { hostname } from \"node:os\";\nimport type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { nowIso, resolveEnvironment } from \"@appbuildersph/shared\";\n\nexport function createIdentitySnapshot(config: AppBuildersConfig): IdentitySnapshot {\n  const timestamp = nowIso();\n  const environment = config.environment ?? resolveEnvironment();\n\n  const base: Omit<IdentitySnapshot, \"verificationHash\"> = {\n    appUuid: randomUUID(),\n    projectUuid: randomUUID(),\n    developerId: config.developer,\n    organizationId: config.organization,\n    hostname: hostname(),\n    domain: process.env.APPBUILDERS_DOMAIN,\n    environment,\n    gitCommit: process.env.GIT_COMMIT ?? process.env.VERCEL_GIT_COMMIT_SHA,\n    gitBranch: process.env.GIT_BRANCH ?? process.env.VERCEL_GIT_COMMIT_REF,\n    buildNumber: process.env.BUILD_NUMBER,\n    packageVersion: process.env.npm_package_version,\n    deploymentProvider: process.env.VERCEL ? \"vercel\" : undefined,\n    timestamp,\n  };\n\n  const verificationHash = createHash(\"sha256\")\n    .update(JSON.stringify(base))\n    .digest(\"hex\");\n\n  return { ...base, verificationHash };\n}\n","import type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { createIdentitySnapshot } from \"./identity.js\";\n\nexport class AppBuildersInstance {\n  readonly config: AppBuildersConfig;\n  private identitySnapshot: IdentitySnapshot | null = null;\n\n  constructor(config: AppBuildersConfig) {\n    this.config = config;\n\n    if (config.identity ?? true) {\n      this.identitySnapshot = createIdentitySnapshot(config);\n    }\n  }\n\n  identity() {\n    return {\n      get: (): IdentitySnapshot | null => this.identitySnapshot,\n      refresh: (): IdentitySnapshot => {\n        this.identitySnapshot = createIdentitySnapshot(this.config);\n        return this.identitySnapshot;\n      },\n      verify: (): boolean => this.identitySnapshot !== null,\n      export: (): string => JSON.stringify(this.identitySnapshot, null, 2),\n    };\n  }\n\n  verify(): boolean {\n    return this.identitySnapshot !== null;\n  }\n}\n\nlet instance: AppBuildersInstance | null = null;\n\nexport function init(config: AppBuildersConfig): AppBuildersInstance {\n  instance = new AppBuildersInstance(config);\n  return instance;\n}\n\nexport function getInstance(): AppBuildersInstance {\n  if (!instance) {\n    throw new Error(\n      \"@appbuildersph/core: AppBuilders.init() must be called before using the SDK.\",\n    );\n  }\n  return instance;\n}\n","import { init, getInstance } from \"./app-builders.js\";\n\nexport const AppBuilders = {\n  init,\n  verify: () => getInstance().verify(),\n  identity: () => getInstance().identity(),\n};\n\nexport type { AppBuildersInstance } from \"./app-builders.js\";\nexport * from \"@appbuildersph/shared\";\n"]}
+{"version":3,"sources":["../src/identity.ts","../src/hooks.ts","../src/app-builders.ts","../src/index.ts"],"names":["nowIso","resolveEnvironment","randomUUID","hostname","createHash","Logger","NotificationCenter","Badge","Watcher"],"mappings":"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","file":"index.cjs","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { hostname } from \"node:os\";\nimport type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { nowIso, resolveEnvironment } from \"@appbuildersph/shared\";\n\nexport function createIdentitySnapshot(config: AppBuildersConfig): IdentitySnapshot {\n  const timestamp = nowIso();\n  const environment = config.environment ?? resolveEnvironment();\n\n  const base: Omit<IdentitySnapshot, \"verificationHash\"> = {\n    appUuid: randomUUID(),\n    projectUuid: randomUUID(),\n    developerId: config.developer,\n    organizationId: config.organization,\n    hostname: hostname(),\n    domain: process.env.APPBUILDERS_DOMAIN,\n    environment,\n    gitCommit: process.env.GIT_COMMIT ?? process.env.VERCEL_GIT_COMMIT_SHA,\n    gitBranch: process.env.GIT_BRANCH ?? process.env.VERCEL_GIT_COMMIT_REF,\n    buildNumber: process.env.BUILD_NUMBER,\n    packageVersion: process.env.npm_package_version,\n    deploymentProvider: process.env.VERCEL ? \"vercel\" : undefined,\n    timestamp,\n  };\n\n  const verificationHash = createHash(\"sha256\")\n    .update(JSON.stringify(base))\n    .digest(\"hex\");\n\n  return { ...base, verificationHash };\n}\n","export interface HookRegistry {\n  register: (event: string, handler: (...args: unknown[]) => void) => void;\n  emit: (event: string, ...args: unknown[]) => void;\n}\n\nexport function createHookRegistry(): HookRegistry {\n  const handlers = new Map<string, Array<(...args: unknown[]) => void>>();\n\n  return {\n    register(event, handler) {\n      const existing = handlers.get(event);\n      if (existing) {\n        existing.push(handler);\n      } else {\n        handlers.set(event, [handler]);\n      }\n    },\n    emit(event, ...args) {\n      for (const handler of handlers.get(event) ?? []) {\n        handler(...args);\n      }\n    },\n  };\n}\n","import type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { Badge } from \"@appbuildersph/badge\";\nimport { Logger } from \"@appbuildersph/logger\";\nimport { NotificationCenter } from \"@appbuildersph/notifications\";\nimport { Watcher } from \"@appbuildersph/watcher\";\nimport { createIdentitySnapshot } from \"./identity.js\";\nimport { createHookRegistry } from \"./hooks.js\";\n\nexport class AppBuildersInstance {\n  readonly config: AppBuildersConfig;\n  private identitySnapshot: IdentitySnapshot | null = null;\n  private readonly loggerInstance: Logger | null = null;\n  private readonly notificationCenter: NotificationCenter | null = null;\n  private readonly watcherInstance: Watcher | null = null;\n  private readonly badgeInstance: Badge | null = null;\n  private readonly hooks = createHookRegistry();\n\n  constructor(config: AppBuildersConfig) {\n    this.config = config;\n\n    if (config.identity ?? true) {\n      this.identitySnapshot = createIdentitySnapshot(config);\n    }\n\n    if (config.logger ?? true) {\n      this.loggerInstance = new Logger();\n    }\n\n    if (config.notifications ?? true) {\n      this.notificationCenter = new NotificationCenter();\n    }\n\n    if (config.badge ?? true) {\n      this.badgeInstance = new Badge(\n        {\n          appName: config.appName,\n          organization: config.organization,\n          developer: config.developer,\n          environment: config.environment,\n          verified: this.identitySnapshot !== null,\n        },\n        config.badge,\n      );\n      this.badgeInstance.mount();\n    }\n\n    if (config.watcher) {\n      this.watcherInstance = new Watcher({\n        onIncident: (incident) => this.hooks.emit(\"incident\", incident),\n        onMetrics: (snapshot) => this.hooks.emit(\"metrics\", snapshot),\n      });\n      this.watcherInstance.start();\n    }\n\n    for (const plugin of config.plugins ?? []) {\n      plugin.setup({ config, registerHook: this.hooks.register });\n    }\n  }\n\n  identity() {\n    return {\n      get: (): IdentitySnapshot | null => this.identitySnapshot,\n      refresh: (): IdentitySnapshot => {\n        this.identitySnapshot = createIdentitySnapshot(this.config);\n        return this.identitySnapshot;\n      },\n      verify: (): boolean => this.identitySnapshot !== null,\n      export: (): string => JSON.stringify(this.identitySnapshot, null, 2),\n    };\n  }\n\n  logger(): Logger | null {\n    return this.loggerInstance;\n  }\n\n  notifications(): NotificationCenter | null {\n    return this.notificationCenter;\n  }\n\n  watcher(): Watcher | null {\n    return this.watcherInstance;\n  }\n\n  badge(): Badge | null {\n    return this.badgeInstance;\n  }\n\n  verify(): boolean {\n    return this.identitySnapshot !== null;\n  }\n\n  shutdown(): void {\n    this.watcherInstance?.stop();\n    this.badgeInstance?.unmount();\n  }\n}\n\nlet instance: AppBuildersInstance | null = null;\n\nexport function init(config: AppBuildersConfig): AppBuildersInstance {\n  instance = new AppBuildersInstance(config);\n  return instance;\n}\n\nexport function getInstance(): AppBuildersInstance {\n  if (!instance) {\n    throw new Error(\n      \"@appbuildersph/core: AppBuilders.init() must be called before using the SDK.\",\n    );\n  }\n  return instance;\n}\n","import { init, getInstance } from \"./app-builders.js\";\n\nexport const AppBuilders = {\n  init,\n  verify: () => getInstance().verify(),\n  identity: () => getInstance().identity(),\n  logger: () => getInstance().logger(),\n  notifications: () => getInstance().notifications(),\n  watcher: () => getInstance().watcher(),\n  badge: () => getInstance().badge(),\n  shutdown: () => getInstance().shutdown(),\n};\n\nexport type { AppBuildersInstance } from \"./app-builders.js\";\nexport * from \"@appbuildersph/shared\";\n"]}

package/dist/index.d.cts

@@ -1,3 +1,11 @@
+import * as _appbuildersph_badge from '@appbuildersph/badge';
+import { Badge } from '@appbuildersph/badge';
+import * as _appbuildersph_watcher from '@appbuildersph/watcher';
+import { Watcher } from '@appbuildersph/watcher';
+import * as _appbuildersph_notifications from '@appbuildersph/notifications';
+import { NotificationCenter } from '@appbuildersph/notifications';
+import * as _appbuildersph_logger from '@appbuildersph/logger';
+import { Logger } from '@appbuildersph/logger';
 import * as _appbuildersph_shared from '@appbuildersph/shared';
 import { AppBuildersConfig, IdentitySnapshot } from '@appbuildersph/shared';
 export * from '@appbuildersph/shared';
@@ -5,6 +13,11 @@ export * from '@appbuildersph/shared';
 declare class AppBuildersInstance {
     readonly config: AppBuildersConfig;
     private identitySnapshot;
+    private readonly loggerInstance;
+    private readonly notificationCenter;
+    private readonly watcherInstance;
+    private readonly badgeInstance;
+    private readonly hooks;
     constructor(config: AppBuildersConfig);
     identity(): {
         get: () => IdentitySnapshot | null;
@@ -12,7 +25,12 @@ declare class AppBuildersInstance {
         verify: () => boolean;
         export: () => string;
     };
+    logger(): Logger | null;
+    notifications(): NotificationCenter | null;
+    watcher(): Watcher | null;
+    badge(): Badge | null;
     verify(): boolean;
+    shutdown(): void;
 }
 declare function init(config: AppBuildersConfig): AppBuildersInstance;
 
@@ -25,6 +43,11 @@ declare const AppBuilders: {
         verify: () => boolean;
         export: () => string;
     };
+    logger: () => _appbuildersph_logger.Logger | null;
+    notifications: () => _appbuildersph_notifications.NotificationCenter | null;
+    watcher: () => _appbuildersph_watcher.Watcher | null;
+    badge: () => _appbuildersph_badge.Badge | null;
+    shutdown: () => void;
 };
 
 export { AppBuilders, AppBuildersInstance };

package/dist/index.d.ts

@@ -1,3 +1,11 @@
+import * as _appbuildersph_badge from '@appbuildersph/badge';
+import { Badge } from '@appbuildersph/badge';
+import * as _appbuildersph_watcher from '@appbuildersph/watcher';
+import { Watcher } from '@appbuildersph/watcher';
+import * as _appbuildersph_notifications from '@appbuildersph/notifications';
+import { NotificationCenter } from '@appbuildersph/notifications';
+import * as _appbuildersph_logger from '@appbuildersph/logger';
+import { Logger } from '@appbuildersph/logger';
 import * as _appbuildersph_shared from '@appbuildersph/shared';
 import { AppBuildersConfig, IdentitySnapshot } from '@appbuildersph/shared';
 export * from '@appbuildersph/shared';
@@ -5,6 +13,11 @@ export * from '@appbuildersph/shared';
 declare class AppBuildersInstance {
     readonly config: AppBuildersConfig;
     private identitySnapshot;
+    private readonly loggerInstance;
+    private readonly notificationCenter;
+    private readonly watcherInstance;
+    private readonly badgeInstance;
+    private readonly hooks;
     constructor(config: AppBuildersConfig);
     identity(): {
         get: () => IdentitySnapshot | null;
@@ -12,7 +25,12 @@ declare class AppBuildersInstance {
         verify: () => boolean;
         export: () => string;
     };
+    logger(): Logger | null;
+    notifications(): NotificationCenter | null;
+    watcher(): Watcher | null;
+    badge(): Badge | null;
     verify(): boolean;
+    shutdown(): void;
 }
 declare function init(config: AppBuildersConfig): AppBuildersInstance;
 
@@ -25,6 +43,11 @@ declare const AppBuilders: {
         verify: () => boolean;
         export: () => string;
     };
+    logger: () => _appbuildersph_logger.Logger | null;
+    notifications: () => _appbuildersph_notifications.NotificationCenter | null;
+    watcher: () => _appbuildersph_watcher.Watcher | null;
+    badge: () => _appbuildersph_badge.Badge | null;
+    shutdown: () => void;
 };
 
 export { AppBuilders, AppBuildersInstance };

package/dist/index.js

@@ -1,9 +1,13 @@
+import { Badge } from '@appbuildersph/badge';
+import { Logger } from '@appbuildersph/logger';
+import { NotificationCenter } from '@appbuildersph/notifications';
+import { Watcher } from '@appbuildersph/watcher';
 import { randomUUID, createHash } from 'crypto';
 import { hostname } from 'os';
 import { nowIso, resolveEnvironment } from '@appbuildersph/shared';
 export * from '@appbuildersph/shared';
 
-// src/identity.ts
+// src/app-builders.ts
 function createIdentitySnapshot(config) {
   const timestamp = nowIso();
   const environment = config.environment ?? resolveEnvironment();
@@ -26,15 +30,69 @@ function createIdentitySnapshot(config) {
   return { ...base, verificationHash };
 }
 
+// src/hooks.ts
+function createHookRegistry() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    register(event, handler) {
+      const existing = handlers.get(event);
+      if (existing) {
+        existing.push(handler);
+      } else {
+        handlers.set(event, [handler]);
+      }
+    },
+    emit(event, ...args) {
+      for (const handler of handlers.get(event) ?? []) {
+        handler(...args);
+      }
+    }
+  };
+}
+
 // src/app-builders.ts
 var AppBuildersInstance = class {
   config;
   identitySnapshot = null;
+  loggerInstance = null;
+  notificationCenter = null;
+  watcherInstance = null;
+  badgeInstance = null;
+  hooks = createHookRegistry();
   constructor(config) {
     this.config = config;
     if (config.identity ?? true) {
       this.identitySnapshot = createIdentitySnapshot(config);
     }
+    if (config.logger ?? true) {
+      this.loggerInstance = new Logger();
+    }
+    if (config.notifications ?? true) {
+      this.notificationCenter = new NotificationCenter();
+    }
+    if (config.badge ?? true) {
+      this.badgeInstance = new Badge(
+        {
+          appName: config.appName,
+          organization: config.organization,
+          developer: config.developer,
+          environment: config.environment,
+          verified: this.identitySnapshot !== null
+        },
+        config.badge
+      );
+      this.badgeInstance.mount();
+    }
+    if (config.watcher) {
+      this.watcherInstance = new Watcher({
+        onIncident: (incident) => this.hooks.emit("incident", incident),
+        onMetrics: (snapshot) => this.hooks.emit("metrics", snapshot)
+      });
+      this.watcherInstance.start();
+    }
+    for (const plugin of config.plugins ?? []) {
+      plugin.setup({ config, registerHook: this.hooks.register });
+    }
   }
   identity() {
     return {
@@ -47,9 +105,25 @@ var AppBuildersInstance = class {
       export: () => JSON.stringify(this.identitySnapshot, null, 2)
     };
   }
+  logger() {
+    return this.loggerInstance;
+  }
+  notifications() {
+    return this.notificationCenter;
+  }
+  watcher() {
+    return this.watcherInstance;
+  }
+  badge() {
+    return this.badgeInstance;
+  }
   verify() {
     return this.identitySnapshot !== null;
   }
+  shutdown() {
+    this.watcherInstance?.stop();
+    this.badgeInstance?.unmount();
+  }
 };
 var instance = null;
 function init(config) {
@@ -67,7 +141,12 @@ function getInstance() {
 var AppBuilders = {
   init,
   verify: () => getInstance().verify(),
-  identity: () => getInstance().identity()
+  identity: () => getInstance().identity(),
+  logger: () => getInstance().logger(),
+  notifications: () => getInstance().notifications(),
+  watcher: () => getInstance().watcher(),
+  badge: () => getInstance().badge(),
+  shutdown: () => getInstance().shutdown()
 };
 
 export { AppBuilders };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/identity.ts","../src/app-builders.ts","../src/index.ts"],"names":[],"mappings":";;;;;;AAKO,SAAS,uBAAuB,MAAA,EAA6C;AAClF,EAAA,MAAM,YAAY,MAAA,EAAO;AACzB,EAAA,MAAM,WAAA,GAAc,MAAA,CAAO,WAAA,IAAe,kBAAA,EAAmB;AAE7D,EAAA,MAAM,IAAA,GAAmD;AAAA,IACvD,SAAS,UAAA,EAAW;AAAA,IACpB,aAAa,UAAA,EAAW;AAAA,IACxB,aAAa,MAAA,CAAO,SAAA;AAAA,IACpB,gBAAgB,MAAA,CAAO,YAAA;AAAA,IACvB,UAAU,QAAA,EAAS;AAAA,IACnB,MAAA,EAAQ,QAAQ,GAAA,CAAI,kBAAA;AAAA,IACpB,WAAA;AAAA,IACA,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,WAAA,EAAa,QAAQ,GAAA,CAAI,YAAA;AAAA,IACzB,cAAA,EAAgB,QAAQ,GAAA,CAAI,mBAAA;AAAA,IAC5B,kBAAA,EAAoB,OAAA,CAAQ,GAAA,CAAI,MAAA,GAAS,QAAA,GAAW,MAAA;AAAA,IACpD;AAAA,GACF;AAEA,EAAA,MAAM,gBAAA,GAAmB,UAAA,CAAW,QAAQ,CAAA,CACzC,MAAA,CAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA,CAC3B,MAAA,CAAO,KAAK,CAAA;AAEf,EAAA,OAAO,EAAE,GAAG,IAAA,EAAM,gBAAA,EAAiB;AACrC;;;AC3BO,IAAM,sBAAN,MAA0B;AAAA,EACtB,MAAA;AAAA,EACD,gBAAA,GAA4C,IAAA;AAAA,EAEpD,YAAY,MAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,IAAI,MAAA,CAAO,YAAY,IAAA,EAAM;AAC3B,MAAA,IAAA,CAAK,gBAAA,GAAmB,uBAAuB,MAAM,CAAA;AAAA,IACvD;AAAA,EACF;AAAA,EAEA,QAAA,GAAW;AACT,IAAA,OAAO;AAAA,MACL,GAAA,EAAK,MAA+B,IAAA,CAAK,gBAAA;AAAA,MACzC,SAAS,MAAwB;AAC/B,QAAA,IAAA,CAAK,gBAAA,GAAmB,sBAAA,CAAuB,IAAA,CAAK,MAAM,CAAA;AAC1D,QAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,MACd,CAAA;AAAA,MACA,MAAA,EAAQ,MAAe,IAAA,CAAK,gBAAA,KAAqB,IAAA;AAAA,MACjD,QAAQ,MAAc,IAAA,CAAK,UAAU,IAAA,CAAK,gBAAA,EAAkB,MAAM,CAAC;AAAA,KACrE;AAAA,EACF;AAAA,EAEA,MAAA,GAAkB;AAChB,IAAA,OAAO,KAAK,gBAAA,KAAqB,IAAA;AAAA,EACnC;AACF,CAAA;AAEA,IAAI,QAAA,GAAuC,IAAA;AAEpC,SAAS,KAAK,MAAA,EAAgD;AACnE,EAAA,QAAA,GAAW,IAAI,oBAAoB,MAAM,CAAA;AACzC,EAAA,OAAO,QAAA;AACT;AAEO,SAAS,WAAA,GAAmC;AACjD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AC5CO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA;AAAA,EACA,MAAA,EAAQ,MAAM,WAAA,EAAY,CAAE,MAAA,EAAO;AAAA,EACnC,QAAA,EAAU,MAAM,WAAA,EAAY,CAAE,QAAA;AAChC","file":"index.js","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { hostname } from \"node:os\";\nimport type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { nowIso, resolveEnvironment } from \"@appbuildersph/shared\";\n\nexport function createIdentitySnapshot(config: AppBuildersConfig): IdentitySnapshot {\n  const timestamp = nowIso();\n  const environment = config.environment ?? resolveEnvironment();\n\n  const base: Omit<IdentitySnapshot, \"verificationHash\"> = {\n    appUuid: randomUUID(),\n    projectUuid: randomUUID(),\n    developerId: config.developer,\n    organizationId: config.organization,\n    hostname: hostname(),\n    domain: process.env.APPBUILDERS_DOMAIN,\n    environment,\n    gitCommit: process.env.GIT_COMMIT ?? process.env.VERCEL_GIT_COMMIT_SHA,\n    gitBranch: process.env.GIT_BRANCH ?? process.env.VERCEL_GIT_COMMIT_REF,\n    buildNumber: process.env.BUILD_NUMBER,\n    packageVersion: process.env.npm_package_version,\n    deploymentProvider: process.env.VERCEL ? \"vercel\" : undefined,\n    timestamp,\n  };\n\n  const verificationHash = createHash(\"sha256\")\n    .update(JSON.stringify(base))\n    .digest(\"hex\");\n\n  return { ...base, verificationHash };\n}\n","import type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { createIdentitySnapshot } from \"./identity.js\";\n\nexport class AppBuildersInstance {\n  readonly config: AppBuildersConfig;\n  private identitySnapshot: IdentitySnapshot | null = null;\n\n  constructor(config: AppBuildersConfig) {\n    this.config = config;\n\n    if (config.identity ?? true) {\n      this.identitySnapshot = createIdentitySnapshot(config);\n    }\n  }\n\n  identity() {\n    return {\n      get: (): IdentitySnapshot | null => this.identitySnapshot,\n      refresh: (): IdentitySnapshot => {\n        this.identitySnapshot = createIdentitySnapshot(this.config);\n        return this.identitySnapshot;\n      },\n      verify: (): boolean => this.identitySnapshot !== null,\n      export: (): string => JSON.stringify(this.identitySnapshot, null, 2),\n    };\n  }\n\n  verify(): boolean {\n    return this.identitySnapshot !== null;\n  }\n}\n\nlet instance: AppBuildersInstance | null = null;\n\nexport function init(config: AppBuildersConfig): AppBuildersInstance {\n  instance = new AppBuildersInstance(config);\n  return instance;\n}\n\nexport function getInstance(): AppBuildersInstance {\n  if (!instance) {\n    throw new Error(\n      \"@appbuildersph/core: AppBuilders.init() must be called before using the SDK.\",\n    );\n  }\n  return instance;\n}\n","import { init, getInstance } from \"./app-builders.js\";\n\nexport const AppBuilders = {\n  init,\n  verify: () => getInstance().verify(),\n  identity: () => getInstance().identity(),\n};\n\nexport type { AppBuildersInstance } from \"./app-builders.js\";\nexport * from \"@appbuildersph/shared\";\n"]}
+{"version":3,"sources":["../src/identity.ts","../src/hooks.ts","../src/app-builders.ts","../src/index.ts"],"names":[],"mappings":";;;;;;;;;;AAKO,SAAS,uBAAuB,MAAA,EAA6C;AAClF,EAAA,MAAM,YAAY,MAAA,EAAO;AACzB,EAAA,MAAM,WAAA,GAAc,MAAA,CAAO,WAAA,IAAe,kBAAA,EAAmB;AAE7D,EAAA,MAAM,IAAA,GAAmD;AAAA,IACvD,SAAS,UAAA,EAAW;AAAA,IACpB,aAAa,UAAA,EAAW;AAAA,IACxB,aAAa,MAAA,CAAO,SAAA;AAAA,IACpB,gBAAgB,MAAA,CAAO,YAAA;AAAA,IACvB,UAAU,QAAA,EAAS;AAAA,IACnB,MAAA,EAAQ,QAAQ,GAAA,CAAI,kBAAA;AAAA,IACpB,WAAA;AAAA,IACA,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,UAAA,IAAc,QAAQ,GAAA,CAAI,qBAAA;AAAA,IACjD,WAAA,EAAa,QAAQ,GAAA,CAAI,YAAA;AAAA,IACzB,cAAA,EAAgB,QAAQ,GAAA,CAAI,mBAAA;AAAA,IAC5B,kBAAA,EAAoB,OAAA,CAAQ,GAAA,CAAI,MAAA,GAAS,QAAA,GAAW,MAAA;AAAA,IACpD;AAAA,GACF;AAEA,EAAA,MAAM,gBAAA,GAAmB,UAAA,CAAW,QAAQ,CAAA,CACzC,MAAA,CAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA,CAC3B,MAAA,CAAO,KAAK,CAAA;AAEf,EAAA,OAAO,EAAE,GAAG,IAAA,EAAM,gBAAA,EAAiB;AACrC;;;ACzBO,SAAS,kBAAA,GAAmC;AACjD,EAAA,MAAM,QAAA,uBAAe,GAAA,EAAiD;AAEtE,EAAA,OAAO;AAAA,IACL,QAAA,CAAS,OAAO,OAAA,EAAS;AACvB,MAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA;AACnC,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,MACvB,CAAA,MAAO;AACL,QAAA,QAAA,CAAS,GAAA,CAAI,KAAA,EAAO,CAAC,OAAO,CAAC,CAAA;AAAA,MAC/B;AAAA,IACF,CAAA;AAAA,IACA,IAAA,CAAK,UAAU,IAAA,EAAM;AACnB,MAAA,KAAA,MAAW,WAAW,QAAA,CAAS,GAAA,CAAI,KAAK,CAAA,IAAK,EAAC,EAAG;AAC/C,QAAA,OAAA,CAAQ,GAAG,IAAI,CAAA;AAAA,MACjB;AAAA,IACF;AAAA,GACF;AACF;;;ACfO,IAAM,sBAAN,MAA0B;AAAA,EACtB,MAAA;AAAA,EACD,gBAAA,GAA4C,IAAA;AAAA,EACnC,cAAA,GAAgC,IAAA;AAAA,EAChC,kBAAA,GAAgD,IAAA;AAAA,EAChD,eAAA,GAAkC,IAAA;AAAA,EAClC,aAAA,GAA8B,IAAA;AAAA,EAC9B,QAAQ,kBAAA,EAAmB;AAAA,EAE5C,YAAY,MAAA,EAA2B;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,IAAI,MAAA,CAAO,YAAY,IAAA,EAAM;AAC3B,MAAA,IAAA,CAAK,gBAAA,GAAmB,uBAAuB,MAAM,CAAA;AAAA,IACvD;AAEA,IAAA,IAAI,MAAA,CAAO,UAAU,IAAA,EAAM;AACzB,MAAA,IAAA,CAAK,cAAA,GAAiB,IAAI,MAAA,EAAO;AAAA,IACnC;AAEA,IAAA,IAAI,MAAA,CAAO,iBAAiB,IAAA,EAAM;AAChC,MAAA,IAAA,CAAK,kBAAA,GAAqB,IAAI,kBAAA,EAAmB;AAAA,IACnD;AAEA,IAAA,IAAI,MAAA,CAAO,SAAS,IAAA,EAAM;AACxB,MAAA,IAAA,CAAK,gBAAgB,IAAI,KAAA;AAAA,QACvB;AAAA,UACE,SAAS,MAAA,CAAO,OAAA;AAAA,UAChB,cAAc,MAAA,CAAO,YAAA;AAAA,UACrB,WAAW,MAAA,CAAO,SAAA;AAAA,UAClB,aAAa,MAAA,CAAO,WAAA;AAAA,UACpB,QAAA,EAAU,KAAK,gBAAA,KAAqB;AAAA,SACtC;AAAA,QACA,MAAA,CAAO;AAAA,OACT;AACA,MAAA,IAAA,CAAK,cAAc,KAAA,EAAM;AAAA,IAC3B;AAEA,IAAA,IAAI,OAAO,OAAA,EAAS;AAClB,MAAA,IAAA,CAAK,eAAA,GAAkB,IAAI,OAAA,CAAQ;AAAA,QACjC,YAAY,CAAC,QAAA,KAAa,KAAK,KAAA,CAAM,IAAA,CAAK,YAAY,QAAQ,CAAA;AAAA,QAC9D,WAAW,CAAC,QAAA,KAAa,KAAK,KAAA,CAAM,IAAA,CAAK,WAAW,QAAQ;AAAA,OAC7D,CAAA;AACD,MAAA,IAAA,CAAK,gBAAgB,KAAA,EAAM;AAAA,IAC7B;AAEA,IAAA,KAAA,MAAW,MAAA,IAAU,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG;AACzC,MAAA,MAAA,CAAO,MAAM,EAAE,MAAA,EAAQ,cAAc,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,QAAA,GAAW;AACT,IAAA,OAAO;AAAA,MACL,GAAA,EAAK,MAA+B,IAAA,CAAK,gBAAA;AAAA,MACzC,SAAS,MAAwB;AAC/B,QAAA,IAAA,CAAK,gBAAA,GAAmB,sBAAA,CAAuB,IAAA,CAAK,MAAM,CAAA;AAC1D,QAAA,OAAO,IAAA,CAAK,gBAAA;AAAA,MACd,CAAA;AAAA,MACA,MAAA,EAAQ,MAAe,IAAA,CAAK,gBAAA,KAAqB,IAAA;AAAA,MACjD,QAAQ,MAAc,IAAA,CAAK,UAAU,IAAA,CAAK,gBAAA,EAAkB,MAAM,CAAC;AAAA,KACrE;AAAA,EACF;AAAA,EAEA,MAAA,GAAwB;AACtB,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA,EAEA,aAAA,GAA2C;AACzC,IAAA,OAAO,IAAA,CAAK,kBAAA;AAAA,EACd;AAAA,EAEA,OAAA,GAA0B;AACxB,IAAA,OAAO,IAAA,CAAK,eAAA;AAAA,EACd;AAAA,EAEA,KAAA,GAAsB;AACpB,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EACd;AAAA,EAEA,MAAA,GAAkB;AAChB,IAAA,OAAO,KAAK,gBAAA,KAAqB,IAAA;AAAA,EACnC;AAAA,EAEA,QAAA,GAAiB;AACf,IAAA,IAAA,CAAK,iBAAiB,IAAA,EAAK;AAC3B,IAAA,IAAA,CAAK,eAAe,OAAA,EAAQ;AAAA,EAC9B;AACF,CAAA;AAEA,IAAI,QAAA,GAAuC,IAAA;AAEpC,SAAS,KAAK,MAAA,EAAgD;AACnE,EAAA,QAAA,GAAW,IAAI,oBAAoB,MAAM,CAAA;AACzC,EAAA,OAAO,QAAA;AACT;AAEO,SAAS,WAAA,GAAmC;AACjD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AC7GO,IAAM,WAAA,GAAc;AAAA,EACzB,IAAA;AAAA,EACA,MAAA,EAAQ,MAAM,WAAA,EAAY,CAAE,MAAA,EAAO;AAAA,EACnC,QAAA,EAAU,MAAM,WAAA,EAAY,CAAE,QAAA,EAAS;AAAA,EACvC,MAAA,EAAQ,MAAM,WAAA,EAAY,CAAE,MAAA,EAAO;AAAA,EACnC,aAAA,EAAe,MAAM,WAAA,EAAY,CAAE,aAAA,EAAc;AAAA,EACjD,OAAA,EAAS,MAAM,WAAA,EAAY,CAAE,OAAA,EAAQ;AAAA,EACrC,KAAA,EAAO,MAAM,WAAA,EAAY,CAAE,KAAA,EAAM;AAAA,EACjC,QAAA,EAAU,MAAM,WAAA,EAAY,CAAE,QAAA;AAChC","file":"index.js","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport { hostname } from \"node:os\";\nimport type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { nowIso, resolveEnvironment } from \"@appbuildersph/shared\";\n\nexport function createIdentitySnapshot(config: AppBuildersConfig): IdentitySnapshot {\n  const timestamp = nowIso();\n  const environment = config.environment ?? resolveEnvironment();\n\n  const base: Omit<IdentitySnapshot, \"verificationHash\"> = {\n    appUuid: randomUUID(),\n    projectUuid: randomUUID(),\n    developerId: config.developer,\n    organizationId: config.organization,\n    hostname: hostname(),\n    domain: process.env.APPBUILDERS_DOMAIN,\n    environment,\n    gitCommit: process.env.GIT_COMMIT ?? process.env.VERCEL_GIT_COMMIT_SHA,\n    gitBranch: process.env.GIT_BRANCH ?? process.env.VERCEL_GIT_COMMIT_REF,\n    buildNumber: process.env.BUILD_NUMBER,\n    packageVersion: process.env.npm_package_version,\n    deploymentProvider: process.env.VERCEL ? \"vercel\" : undefined,\n    timestamp,\n  };\n\n  const verificationHash = createHash(\"sha256\")\n    .update(JSON.stringify(base))\n    .digest(\"hex\");\n\n  return { ...base, verificationHash };\n}\n","export interface HookRegistry {\n  register: (event: string, handler: (...args: unknown[]) => void) => void;\n  emit: (event: string, ...args: unknown[]) => void;\n}\n\nexport function createHookRegistry(): HookRegistry {\n  const handlers = new Map<string, Array<(...args: unknown[]) => void>>();\n\n  return {\n    register(event, handler) {\n      const existing = handlers.get(event);\n      if (existing) {\n        existing.push(handler);\n      } else {\n        handlers.set(event, [handler]);\n      }\n    },\n    emit(event, ...args) {\n      for (const handler of handlers.get(event) ?? []) {\n        handler(...args);\n      }\n    },\n  };\n}\n","import type { AppBuildersConfig, IdentitySnapshot } from \"@appbuildersph/shared\";\nimport { Badge } from \"@appbuildersph/badge\";\nimport { Logger } from \"@appbuildersph/logger\";\nimport { NotificationCenter } from \"@appbuildersph/notifications\";\nimport { Watcher } from \"@appbuildersph/watcher\";\nimport { createIdentitySnapshot } from \"./identity.js\";\nimport { createHookRegistry } from \"./hooks.js\";\n\nexport class AppBuildersInstance {\n  readonly config: AppBuildersConfig;\n  private identitySnapshot: IdentitySnapshot | null = null;\n  private readonly loggerInstance: Logger | null = null;\n  private readonly notificationCenter: NotificationCenter | null = null;\n  private readonly watcherInstance: Watcher | null = null;\n  private readonly badgeInstance: Badge | null = null;\n  private readonly hooks = createHookRegistry();\n\n  constructor(config: AppBuildersConfig) {\n    this.config = config;\n\n    if (config.identity ?? true) {\n      this.identitySnapshot = createIdentitySnapshot(config);\n    }\n\n    if (config.logger ?? true) {\n      this.loggerInstance = new Logger();\n    }\n\n    if (config.notifications ?? true) {\n      this.notificationCenter = new NotificationCenter();\n    }\n\n    if (config.badge ?? true) {\n      this.badgeInstance = new Badge(\n        {\n          appName: config.appName,\n          organization: config.organization,\n          developer: config.developer,\n          environment: config.environment,\n          verified: this.identitySnapshot !== null,\n        },\n        config.badge,\n      );\n      this.badgeInstance.mount();\n    }\n\n    if (config.watcher) {\n      this.watcherInstance = new Watcher({\n        onIncident: (incident) => this.hooks.emit(\"incident\", incident),\n        onMetrics: (snapshot) => this.hooks.emit(\"metrics\", snapshot),\n      });\n      this.watcherInstance.start();\n    }\n\n    for (const plugin of config.plugins ?? []) {\n      plugin.setup({ config, registerHook: this.hooks.register });\n    }\n  }\n\n  identity() {\n    return {\n      get: (): IdentitySnapshot | null => this.identitySnapshot,\n      refresh: (): IdentitySnapshot => {\n        this.identitySnapshot = createIdentitySnapshot(this.config);\n        return this.identitySnapshot;\n      },\n      verify: (): boolean => this.identitySnapshot !== null,\n      export: (): string => JSON.stringify(this.identitySnapshot, null, 2),\n    };\n  }\n\n  logger(): Logger | null {\n    return this.loggerInstance;\n  }\n\n  notifications(): NotificationCenter | null {\n    return this.notificationCenter;\n  }\n\n  watcher(): Watcher | null {\n    return this.watcherInstance;\n  }\n\n  badge(): Badge | null {\n    return this.badgeInstance;\n  }\n\n  verify(): boolean {\n    return this.identitySnapshot !== null;\n  }\n\n  shutdown(): void {\n    this.watcherInstance?.stop();\n    this.badgeInstance?.unmount();\n  }\n}\n\nlet instance: AppBuildersInstance | null = null;\n\nexport function init(config: AppBuildersConfig): AppBuildersInstance {\n  instance = new AppBuildersInstance(config);\n  return instance;\n}\n\nexport function getInstance(): AppBuildersInstance {\n  if (!instance) {\n    throw new Error(\n      \"@appbuildersph/core: AppBuilders.init() must be called before using the SDK.\",\n    );\n  }\n  return instance;\n}\n","import { init, getInstance } from \"./app-builders.js\";\n\nexport const AppBuilders = {\n  init,\n  verify: () => getInstance().verify(),\n  identity: () => getInstance().identity(),\n  logger: () => getInstance().logger(),\n  notifications: () => getInstance().notifications(),\n  watcher: () => getInstance().watcher(),\n  badge: () => getInstance().badge(),\n  shutdown: () => getInstance().shutdown(),\n};\n\nexport type { AppBuildersInstance } from \"./app-builders.js\";\nexport * from \"@appbuildersph/shared\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appbuildersph/core",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "The Trust, Identity, Monitoring & AI SDK for Modern Applications.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -17,7 +17,11 @@
     "dist"
   ],
   "dependencies": {
-    "@appbuildersph/shared": "0.0.1"
+    "@appbuildersph/shared": "0.0.3",
+    "@appbuildersph/badge": "0.1.1",
+    "@appbuildersph/watcher": "0.0.3",
+    "@appbuildersph/notifications": "0.0.3",
+    "@appbuildersph/logger": "0.0.3"
   },
   "devDependencies": {
     "tsup": "^8.3.5",