@openmdm/core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present OpenMDM Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+import { WebhookConfig, MDMEvent, WebhookEndpoint, EventType, MDMConfig, MDMInstance } from './types.js';
+export { AppRollback, AppVersion, Application, ApplicationManager, ApplicationNotFoundError, AuthConfig, AuthenticationError, AuthorizationError, Command, CommandFilter, CommandManager, CommandResult, CommandStatus, CommandType, CreateAppRollbackInput, CreateApplicationInput, CreateDeviceInput, CreateGroupInput, CreatePolicyInput, DatabaseAdapter, DeployTarget, Device, DeviceFilter, DeviceListResult, DeviceLocation, DeviceManager, DeviceNotFoundError, DeviceStatus, EnrollmentConfig, EnrollmentError, EnrollmentMethod, EnrollmentRequest, EnrollmentResponse, EventFilter, EventHandler, EventPayloadMap, Group, GroupManager, HardwareControl, Heartbeat, InstalledApp, MDMError, MDMPlugin, PasswordPolicy, PluginMiddleware, PluginRoute, Policy, PolicyApplication, PolicyManager, PolicyNotFoundError, PolicySettings, PushAdapter, PushBatchResult, PushConfig, PushMessage, PushProviderConfig, PushResult, PushToken, RegisterPushTokenInput, SendCommandInput, StorageConfig, SystemUpdatePolicy, TimeWindow, UpdateApplicationInput, UpdateDeviceInput, UpdateGroupInput, UpdatePolicyInput, 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';
+
+/**
+ * OpenMDM Webhook Delivery System
+ *
+ * Handles outbound webhook delivery with HMAC signing and retry logic.
+ */
+
+interface WebhookDeliveryResult {
+    endpointId: string;
+    success: boolean;
+    statusCode?: number;
+    error?: string;
+    retryCount: number;
+    deliveredAt?: Date;
+}
+interface WebhookPayload<T = unknown> {
+    id: string;
+    event: EventType;
+    timestamp: string;
+    data: T;
+}
+interface WebhookManager {
+    /**
+     * Deliver an event to all matching webhook endpoints
+     */
+    deliver<T>(event: MDMEvent<T>): Promise<WebhookDeliveryResult[]>;
+    /**
+     * Add a webhook endpoint at runtime
+     */
+    addEndpoint(endpoint: WebhookEndpoint): void;
+    /**
+     * Remove a webhook endpoint
+     */
+    removeEndpoint(endpointId: string): void;
+    /**
+     * Update a webhook endpoint
+     */
+    updateEndpoint(endpointId: string, updates: Partial<WebhookEndpoint>): void;
+    /**
+     * Get all configured endpoints
+     */
+    getEndpoints(): WebhookEndpoint[];
+    /**
+     * Test a webhook endpoint with a test payload
+     */
+    testEndpoint(endpointId: string): Promise<WebhookDeliveryResult>;
+}
+/**
+ * Create a webhook manager instance
+ */
+declare function createWebhookManager(config: WebhookConfig): 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 Core
+ *
+ * A flexible, embeddable MDM (Mobile Device Management) SDK.
+ * Inspired by better-auth's design philosophy.
+ *
+ * @example
+ * ```typescript
+ * import { createMDM } from '@openmdm/core';
+ * import { drizzleAdapter } from '@openmdm/drizzle-adapter';
+ *
+ * const mdm = createMDM({
+ *   database: drizzleAdapter(db),
+ *   enrollment: {
+ *     deviceSecret: process.env.DEVICE_HMAC_SECRET!,
+ *     autoEnroll: true,
+ *   },
+ * });
+ *
+ * // Use in your routes
+ * const devices = await mdm.devices.list();
+ * ```
+ */
+
+/**
+ * Create an MDM instance with the given configuration.
+ */
+declare function createMDM(config: MDMConfig): MDMInstance;
+
+export { EventType, MDMConfig, MDMEvent, MDMInstance, WebhookConfig, WebhookEndpoint, type WebhookPayload, createMDM, createWebhookManager, verifyWebhookSignature };