@openmdm/core 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { WebhookConfig, MDMEvent, WebhookEndpoint, EventType, DatabaseAdapter, TenantManager, AuthorizationManager, AuditConfig, AuditManager, ScheduleManager, MessageQueueManager, DashboardManager, PluginStorageAdapter, MDMConfig, MDMInstance, EnrollmentRequest } from './types.js';
-export { AppInstallationSummary, AppRollback, AppVersion, Application, ApplicationManager, ApplicationNotFoundError, AuditAction, AuditLog, AuditLogFilter, AuditLogListResult, AuditSummary, AuthConfig, AuthenticationError, AuthorizationError, Command, CommandFilter, CommandManager, CommandNotFoundError, CommandResult, CommandStatus, CommandSuccessRates, CommandType, CreateAppRollbackInput, CreateApplicationInput, CreateAuditLogInput, CreateDeviceInput, CreateGroupInput, CreatePolicyInput, CreateRoleInput, CreateScheduledTaskInput, CreateTenantInput, CreateUserInput, DashboardStats, DeployTarget, Device, DeviceFilter, DeviceListResult, DeviceLocation, DeviceManager, DeviceNotFoundError, DeviceStatus, DeviceStatusBreakdown, EnqueueMessageInput, EnrollmentConfig, EnrollmentError, EnrollmentMethod, EnrollmentResponse, EnrollmentTrendPoint, EventFilter, EventHandler, EventPayloadMap, Group, GroupHierarchyStats, GroupManager, GroupNotFoundError, GroupTreeNode, HardwareControl, Heartbeat, InstalledApp, MDMError, MDMPlugin, MaintenanceWindow, PasswordPolicy, Permission, PermissionAction, PermissionResource, PluginMiddleware, PluginRoute, PluginStorageEntry, Policy, PolicyApplication, PolicyManager, PolicyNotFoundError, PolicySettings, PushAdapter, PushBatchResult, PushConfig, PushMessage, PushProviderConfig, PushResult, PushToken, QueueMessageStatus, QueueStats, QueuedMessage, RegisterPushTokenInput, Role, RoleNotFoundError, ScheduledTask, ScheduledTaskFilter, ScheduledTaskListResult, ScheduledTaskStatus, SendCommandInput, StorageConfig, SystemUpdatePolicy, TaskExecution, TaskSchedule, TaskType, Tenant, TenantFilter, TenantListResult, TenantNotFoundError, TenantSettings, TenantStats, TenantStatus, TimeWindow, UpdateApplicationInput, UpdateDeviceInput, UpdateGroupInput, UpdatePolicyInput, UpdateRoleInput, UpdateScheduledTaskInput, UpdateTenantInput, UpdateUserInput, User, UserFilter, UserListResult, UserNotFoundError, UserWithRoles, ValidationError, VpnConfig, WebhookDeliveryResult, WebhookManager, WifiConfig } from './types.js';
+import { WebhookConfig, Logger, MDMEvent, WebhookEndpoint, EventType, DatabaseAdapter, TenantManager, AuthorizationManager, AuditConfig, AuditManager, ScheduleManager, MessageQueueManager, DashboardManager, PluginStorageAdapter, MDMConfig, MDMInstance, EnrollmentRequest } from './types.js';
+export { AppInstallationSummary, AppRollback, AppVersion, Application, ApplicationManager, ApplicationNotFoundError, AuditAction, AuditLog, AuditLogFilter, AuditLogListResult, AuditSummary, AuthConfig, AuthenticationError, AuthorizationError, Command, CommandFilter, CommandManager, CommandNotFoundError, CommandResult, CommandStatus, CommandSuccessRates, CommandType, CreateAppRollbackInput, CreateApplicationInput, CreateAuditLogInput, CreateDeviceInput, CreateGroupInput, CreatePolicyInput, CreateRoleInput, CreateScheduledTaskInput, CreateTenantInput, CreateUserInput, DashboardStats, DeployTarget, Device, DeviceFilter, DeviceListResult, DeviceLocation, DeviceManager, DeviceNotFoundError, DeviceStatus, DeviceStatusBreakdown, EnqueueMessageInput, EnrollmentConfig, EnrollmentError, EnrollmentMethod, EnrollmentResponse, EnrollmentTrendPoint, EventFilter, EventHandler, EventPayloadMap, Group, GroupHierarchyStats, GroupManager, GroupNotFoundError, GroupTreeNode, HardwareControl, Heartbeat, InstalledApp, LogContext, MDMError, MDMPlugin, MaintenanceWindow, PasswordPolicy, Permission, PermissionAction, PermissionResource, PluginMiddleware, PluginRoute, PluginStorageEntry, Policy, PolicyApplication, PolicyManager, PolicyNotFoundError, PolicySettings, PushAdapter, PushBatchResult, PushConfig, PushMessage, PushProviderConfig, PushResult, PushToken, QueueMessageStatus, QueueStats, QueuedMessage, RegisterPushTokenInput, Role, RoleNotFoundError, ScheduledTask, ScheduledTaskFilter, ScheduledTaskListResult, ScheduledTaskStatus, SendCommandInput, StorageConfig, SystemUpdatePolicy, TaskExecution, TaskSchedule, TaskType, Tenant, TenantFilter, TenantListResult, TenantNotFoundError, TenantSettings, TenantStats, TenantStatus, TimeWindow, UpdateApplicationInput, UpdateDeviceInput, UpdateGroupInput, UpdatePolicyInput, UpdateRoleInput, UpdateScheduledTaskInput, UpdateTenantInput, UpdateUserInput, User, UserFilter, UserListResult, UserNotFoundError, UserWithRoles, ValidationError, VpnConfig, WebhookDeliveryResult, WebhookManager, WifiConfig } from './types.js';
 export { ColumnDefinition, ColumnType, IndexDefinition, SchemaDefinition, TableDefinition, camelToSnake, getColumnNames, getPrimaryKey, getTableNames, mdmSchema, snakeToCamel, transformToCamelCase, transformToSnakeCase } from './schema.js';
 
 /**
@@ -164,13 +164,37 @@ interface WebhookManager {
 /**
  * Create a webhook manager instance
  */
-declare function createWebhookManager(config: WebhookConfig): WebhookManager;
+declare function createWebhookManager(config: WebhookConfig, logger?: Logger): WebhookManager;
 /**
  * Verify a webhook signature from incoming requests
  * (Utility for consumers to verify our webhooks)
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
+/**
+ * OpenMDM Logger
+ *
+ * Default logger implementations and helpers. Production users are
+ * expected to pass their own pino/winston/bunyan instance via
+ * `createMDM({ logger })`; these defaults are for development and
+ * for the zero-config path.
+ */
+
+/**
+ * Console-backed logger. Writes JSON-ish lines to stdout/stderr with
+ * an `[openmdm]` prefix so they stand out in a mixed-log stream.
+ *
+ * This is the zero-config default — it intentionally does the
+ * minimum viable thing. Hosts running in production should replace
+ * it with a real structured logger.
+ */
+declare function createConsoleLogger(scope?: string[]): Logger;
+/**
+ * No-op logger. Use to silence OpenMDM entirely — e.g. in tests or in
+ * environments where log noise is inappropriate.
+ */
+declare function createSilentLogger(): Logger;
+
 /**
  * OpenMDM Tenant Manager
  *
@@ -303,4 +327,4 @@ declare function parsePluginKey(key: string): {
 declare function createMDM(config: MDMConfig): MDMInstance;
 declare function verifyEnrollmentSignature(request: EnrollmentRequest, secret: string): boolean;
 
-export { AGENT_PROTOCOL_HEADER, AGENT_PROTOCOL_V2, type AgentAction, type AgentResponse, AuditConfig, AuditManager, AuthorizationManager, DashboardManager, DatabaseAdapter, EnrollmentRequest, EventType, MDMConfig, MDMEvent, MDMInstance, MessageQueueManager, PluginStorageAdapter, ScheduleManager, TenantManager, WebhookConfig, WebhookEndpoint, type WebhookPayload, agentFail, agentOk, createAuditManager, createAuthorizationManager, createDashboardManager, createMDM, createMemoryPluginStorageAdapter, createMessageQueueManager, createPluginKey, createPluginStorageAdapter, createScheduleManager, createTenantManager, createWebhookManager, parsePluginKey, verifyEnrollmentSignature, verifyWebhookSignature, wantsAgentProtocolV2 };
+export { AGENT_PROTOCOL_HEADER, AGENT_PROTOCOL_V2, type AgentAction, type AgentResponse, AuditConfig, AuditManager, AuthorizationManager, DashboardManager, DatabaseAdapter, EnrollmentRequest, EventType, Logger, MDMConfig, MDMEvent, MDMInstance, MessageQueueManager, PluginStorageAdapter, ScheduleManager, TenantManager, WebhookConfig, WebhookEndpoint, type WebhookPayload, agentFail, agentOk, createAuditManager, createAuthorizationManager, createConsoleLogger, createDashboardManager, createMDM, createMemoryPluginStorageAdapter, createMessageQueueManager, createPluginKey, createPluginStorageAdapter, createScheduleManager, createSilentLogger, createTenantManager, createWebhookManager, parsePluginKey, verifyEnrollmentSignature, verifyWebhookSignature, wantsAgentProtocolV2 };

package/dist/index.js

@@ -72,14 +72,69 @@ var ValidationError = class extends MDMError {
     super(message, "VALIDATION_ERROR", 400, details);
   }
 };
+
+// src/logger.ts
+function normalize(...args) {
+  if (args.length === 1) {
+    return { context: void 0, message: args[0] };
+  }
+  return { context: args[0], message: args[1] };
+}
+function createConsoleLogger(scope = []) {
+  const prefix = scope.length > 0 ? `[openmdm:${scope.join(":")}]` : "[openmdm]";
+  const render = (context) => {
+    if (!context || Object.keys(context).length === 0) return "";
+    try {
+      return " " + JSON.stringify(context);
+    } catch {
+      return " " + String(context);
+    }
+  };
+  return {
+    debug: (...args) => {
+      const { context, message } = normalize(...args);
+      if (!process.env.DEBUG) return;
+      console.debug(`${prefix} ${message}${render(context)}`);
+    },
+    info: (...args) => {
+      const { context, message } = normalize(...args);
+      console.log(`${prefix} ${message}${render(context)}`);
+    },
+    warn: (...args) => {
+      const { context, message } = normalize(...args);
+      console.warn(`${prefix} ${message}${render(context)}`);
+    },
+    error: (...args) => {
+      const { context, message } = normalize(...args);
+      console.error(`${prefix} ${message}${render(context)}`);
+    },
+    child: (bindings) => {
+      const componentPart = typeof bindings.component === "string" ? [bindings.component] : [];
+      return createConsoleLogger([...scope, ...componentPart]);
+    }
+  };
+}
+function createSilentLogger() {
+  const silent = {
+    debug: () => void 0,
+    info: () => void 0,
+    warn: () => void 0,
+    error: () => void 0,
+    child: () => silent
+  };
+  return silent;
+}
+
+// src/webhooks.ts
 var DEFAULT_RETRY_CONFIG = {
   maxRetries: 3,
   initialDelay: 1e3,
   maxDelay: 3e4
 };
-function createWebhookManager(config) {
+function createWebhookManager(config, logger = createSilentLogger()) {
   const endpoints = /* @__PURE__ */ new Map();
   const retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config.retry };
+  const log = logger.child({ component: "webhooks" });
   if (config.endpoints) {
     for (const endpoint of config.endpoints) {
       endpoints.set(endpoint.id, endpoint);
@@ -181,9 +236,14 @@ function createWebhookManager(config) {
       const results = await Promise.all(deliveryPromises);
       for (const result of results) {
         if (!result.success) {
-          console.error(
-            `[OpenMDM] Webhook delivery failed to endpoint ${result.endpointId}:`,
-            result.error
+          log.error(
+            {
+              endpointId: result.endpointId,
+              statusCode: result.statusCode,
+              retryCount: result.retryCount,
+              err: result.error
+            },
+            "Webhook delivery failed"
           );
         }
       }
@@ -1277,7 +1337,6 @@ function createPluginStorageAdapter(db) {
         const value = await db.getPluginValue(pluginName, key);
         return value;
       }
-      console.warn("Plugin storage not supported by database adapter");
       return null;
     },
     async set(pluginName, key, value) {
@@ -1285,20 +1344,17 @@ function createPluginStorageAdapter(db) {
         await db.setPluginValue(pluginName, key, value);
         return;
       }
-      console.warn("Plugin storage not supported by database adapter");
     },
     async delete(pluginName, key) {
       if (db.deletePluginValue) {
         await db.deletePluginValue(pluginName, key);
         return;
       }
-      console.warn("Plugin storage not supported by database adapter");
     },
     async list(pluginName, prefix) {
       if (db.listPluginKeys) {
         return db.listPluginKeys(pluginName, prefix);
       }
-      console.warn("Plugin storage not supported by database adapter");
       return [];
     },
     async clear(pluginName) {
@@ -1306,7 +1362,6 @@ function createPluginStorageAdapter(db) {
         await db.clearPluginData(pluginName);
         return;
       }
-      console.warn("Plugin storage not supported by database adapter");
     }
   };
 }
@@ -2042,9 +2097,19 @@ function wantsAgentProtocolV2(headerValue) {
 // src/index.ts
 function createMDM(config) {
   const { database, push, enrollment, webhooks: webhooksConfig, plugins = [] } = config;
+  const logger = config.logger ?? createConsoleLogger();
+  const errorMessage = (err) => {
+    if (err instanceof Error) return err.message;
+    if (typeof err === "string") return err;
+    try {
+      return JSON.stringify(err);
+    } catch {
+      return String(err);
+    }
+  };
   const eventHandlers = /* @__PURE__ */ new Map();
-  const pushAdapter = push ? createPushAdapter(push, database) : createStubPushAdapter();
-  const webhookManager = webhooksConfig ? createWebhookManager(webhooksConfig) : void 0;
+  const pushAdapter = push ? createPushAdapter(push, database, logger) : createStubPushAdapter(logger);
+  const webhookManager = webhooksConfig ? createWebhookManager(webhooksConfig, logger) : void 0;
   const tenantManager = config.multiTenancy?.enabled ? createTenantManager(database) : void 0;
   const authorizationManager = config.authorization?.enabled ? createAuthorizationManager(database) : void 0;
   const auditManager = config.audit?.enabled ? createAuditManager(database) : void 0;
@@ -2078,11 +2143,14 @@ function createMDM(config) {
         payload: eventRecord.payload
       });
     } catch (error) {
-      console.error("[OpenMDM] Failed to persist event:", error);
+      logger.error({ err: errorMessage(error), event }, "Failed to persist event");
     }
     if (webhookManager) {
       webhookManager.deliver(eventRecord).catch((error) => {
-        console.error("[OpenMDM] Webhook delivery error:", error);
+        logger.error(
+          { err: errorMessage(error), event },
+          "Webhook delivery error"
+        );
       });
     }
     if (handlers) {
@@ -2090,7 +2158,10 @@ function createMDM(config) {
         try {
           await handler(eventRecord);
         } catch (error) {
-          console.error(`[OpenMDM] Event handler error for ${event}:`, error);
+          logger.error(
+            { err: errorMessage(error), event },
+            "Event handler threw"
+          );
         }
       }
     }
@@ -2098,7 +2169,7 @@ function createMDM(config) {
       try {
         await config.onEvent(eventRecord);
       } catch (error) {
-        console.error("[OpenMDM] onEvent hook error:", error);
+        logger.error({ err: errorMessage(error) }, "onEvent hook threw");
       }
     }
   };
@@ -2775,6 +2846,7 @@ function createMDM(config) {
     push: pushAdapter,
     webhooks: webhookManager,
     db: database,
+    logger,
     config,
     on,
     emit,
@@ -2797,11 +2869,11 @@ function createMDM(config) {
       if (plugin.onInit) {
         try {
           await plugin.onInit(instance);
-          console.log(`[OpenMDM] Plugin initialized: ${plugin.name}`);
+          logger.info({ plugin: plugin.name }, "Plugin initialized");
         } catch (error) {
-          console.error(
-            `[OpenMDM] Failed to initialize plugin ${plugin.name}:`,
-            error
+          logger.error(
+            { plugin: plugin.name, err: errorMessage(error) },
+            "Failed to initialize plugin"
           );
         }
       }
@@ -2809,21 +2881,23 @@ function createMDM(config) {
   })();
   return instance;
 }
-function createPushAdapter(config, database) {
+function createPushAdapter(config, database, logger) {
   if (!config) {
-    return createStubPushAdapter();
+    return createStubPushAdapter(logger);
   }
+  const pushLogger = logger.child({ component: "push" });
   return {
     async send(deviceId, message) {
-      console.log(
-        `[OpenMDM] Push to ${deviceId}: ${message.type}`,
-        message.payload
+      pushLogger.debug(
+        { deviceId, type: message.type, payload: message.payload },
+        "send"
       );
       return { success: true, messageId: randomUUID() };
     },
     async sendBatch(deviceIds, message) {
-      console.log(
-        `[OpenMDM] Push to ${deviceIds.length} devices: ${message.type}`
+      pushLogger.debug(
+        { count: deviceIds.length, type: message.type },
+        "sendBatch"
       );
       const results = deviceIds.map((deviceId) => ({
         deviceId,
@@ -2853,15 +2927,17 @@ function createPushAdapter(config, database) {
     }
   };
 }
-function createStubPushAdapter() {
+function createStubPushAdapter(logger) {
+  const stubLogger = logger.child({ component: "push-stub" });
   return {
     async send(deviceId, message) {
-      console.log(`[OpenMDM] Push (stub): ${deviceId} <- ${message.type}`);
+      stubLogger.debug({ deviceId, type: message.type }, "send (stub)");
       return { success: true, messageId: "stub" };
     },
     async sendBatch(deviceIds, message) {
-      console.log(
-        `[OpenMDM] Push (stub): ${deviceIds.length} devices <- ${message.type}`
+      stubLogger.debug(
+        { count: deviceIds.length, type: message.type },
+        "sendBatch (stub)"
       );
       return {
         successCount: deviceIds.length,
@@ -2917,6 +2993,6 @@ function generateDeviceToken(deviceId, secret, expirationSeconds) {
   return `${header}.${payload}.${signature}`;
 }
 
-export { AGENT_PROTOCOL_HEADER, AGENT_PROTOCOL_V2, ApplicationNotFoundError, AuthenticationError, AuthorizationError, CommandNotFoundError, DeviceNotFoundError, EnrollmentError, GroupNotFoundError, MDMError, PolicyNotFoundError, RoleNotFoundError, TenantNotFoundError, UserNotFoundError, ValidationError, agentFail, agentOk, camelToSnake, createAuditManager, createAuthorizationManager, createDashboardManager, createMDM, createMemoryPluginStorageAdapter, createMessageQueueManager, createPluginKey, createPluginStorageAdapter, createScheduleManager, createTenantManager, createWebhookManager, getColumnNames, getPrimaryKey, getTableNames, mdmSchema, parsePluginKey, snakeToCamel, transformToCamelCase, transformToSnakeCase, verifyEnrollmentSignature, verifyWebhookSignature, wantsAgentProtocolV2 };
+export { AGENT_PROTOCOL_HEADER, AGENT_PROTOCOL_V2, ApplicationNotFoundError, AuthenticationError, AuthorizationError, CommandNotFoundError, DeviceNotFoundError, EnrollmentError, GroupNotFoundError, MDMError, PolicyNotFoundError, RoleNotFoundError, TenantNotFoundError, UserNotFoundError, ValidationError, agentFail, agentOk, camelToSnake, createAuditManager, createAuthorizationManager, createConsoleLogger, createDashboardManager, createMDM, createMemoryPluginStorageAdapter, createMessageQueueManager, createPluginKey, createPluginStorageAdapter, createScheduleManager, createSilentLogger, createTenantManager, createWebhookManager, getColumnNames, getPrimaryKey, getTableNames, mdmSchema, parsePluginKey, snakeToCamel, transformToCamelCase, transformToSnakeCase, verifyEnrollmentSignature, verifyWebhookSignature, wantsAgentProtocolV2 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map