@zan-shop/push-notifications 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZAN
+
+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/README.md

@@ -0,0 +1,255 @@
+# @zan-shop/push-notifications
+
+Push notification module for Medusa.js using Firebase Cloud Messaging (FCM). Provides type-safe utilities for sending mobile push notifications with built-in formatters for common e-commerce events.
+
+## Features
+
+- 🔥 Firebase Cloud Messaging integration
+- 📱 iOS & Android support
+- 📦 Pre-built formatters (orders, shipments, returns, payouts)
+- 🔄 Batch sending (up to 500 devices)
+- ✅ Full TypeScript support
+- 🧪 Dry-run mode for testing
+
+## Installation
+
+```bash
+npm install @zan-shop/push-notifications
+```
+
+**Prerequisites:**
+- Firebase project with Cloud Messaging enabled
+- Firebase Admin SDK already initialized in your project
+- Node.js >= 18.0.0
+
+## Quick Start
+
+### 1. Create FCM Service
+
+```typescript
+import { FCMService } from '@zan-shop/push-notifications';
+
+const fcmService = new FCMService({
+  firebaseApp,
+  dryRun: false, // Set to true for testing
+});
+```
+
+### 2. Send Notifications
+
+```typescript
+import { formatShipmentNotification } from '@zan-shop/push-notifications';
+
+const notification = formatShipmentNotification({
+  type: 'shipment.created',
+  orderId: 'order_123',
+  trackingNumber: 'TRACK123',
+  carrier: 'FedEx',
+  estimatedDelivery: '2024-01-15',
+});
+
+const result = await fcmService.sendToDevice(deviceToken, notification);
+
+if (result.success) {
+  console.log('Notification sent:', result.messageId);
+} else {
+  console.error('Failed to send:', result.error);
+}
+```
+
+## Event Formatters
+
+Pre-built formatters for common e-commerce events:
+
+### Shipment Notifications
+
+```typescript
+import { formatShipmentNotification } from '@zan-shop/push-notifications';
+
+const notification = formatShipmentNotification({
+  type: 'shipment.created',
+  orderId: 'order_123',
+  trackingNumber: 'TRACK123',
+  carrier: 'FedEx',
+});
+// Output: "📦 Order Shipped - Your order #order_123 has been shipped! Track your package..."
+```
+
+### Order Notifications
+
+```typescript
+import { formatOrderNotification } from '@zan-shop/push-notifications';
+
+const notification = formatOrderNotification({
+  type: 'order.placed',
+  orderId: 'order_123',
+  orderNumber: 'ORD-2024-001',
+});
+// Output: "✅ Order Confirmed - Your order ORD-2024-001 has been confirmed!"
+```
+
+### Return Notifications
+
+```typescript
+import { formatReturnNotification } from '@zan-shop/push-notifications';
+
+const notification = formatReturnNotification({
+  type: 'return.approved',
+  returnId: 'return_123',
+  orderId: 'order_123',
+});
+// Output: "✅ Return Approved - Your return request for order #order_123 has been approved!"
+```
+
+### Custom Notifications
+
+```typescript
+import type { NotificationPayload } from '@zan-shop/push-notifications';
+
+const customNotification: NotificationPayload = {
+  title: '🎉 Special Offer',
+  body: 'Get 20% off your next purchase!',
+  data: {
+    type: 'promotion',
+    promoCode: 'SAVE20',
+  },
+  imageUrl: 'https://example.com/promo-banner.jpg',
+  clickAction: '/promotions/save20',
+  priority: 'high',
+  sound: 'default',
+  badge: 1,
+};
+
+await fcmService.sendToDevice(deviceToken, customNotification);
+```
+
+## Batch Sending
+
+```typescript
+const tokens = ['token1', 'token2', 'token3'];
+const result = await fcmService.sendToMultipleDevices(tokens, notification);
+
+console.log(`Success: ${result.successCount}, Failed: ${result.failureCount}`);
+```
+
+## Medusa Integration
+
+Example subscriber for shipment notifications:
+
+```typescript
+import type { SubscriberArgs } from '@medusajs/framework';
+import { FCMService, formatShipmentNotification } from '@zan-shop/push-notifications';
+
+export default async function handleShipmentCreated({
+  event,
+  container,
+}: SubscriberArgs<{ id: string }>) {
+  const fcmService = container.resolve<FCMService>('fcmService');
+  const deviceService = container.resolve('deviceService');
+  
+  const shipment = await fetchShipmentDetails(event.data.id);
+  
+  // Get customer's devices
+  const devices = await deviceService.getCustomerDevices(shipment.order.customer_id);
+  
+  if (devices.length === 0) return;
+  
+  // Format notification
+  const notification = formatShipmentNotification({
+    type: 'shipment.created',
+    orderId: shipment.order.id,
+    trackingNumber: shipment.tracking_number,
+    carrier: shipment.carrier,
+  });
+  
+  // Send to all customer devices
+  const tokens = devices.map(d => d.token);
+  const result = await fcmService.sendToMultipleDevices(tokens, notification);
+  
+  console.log(`Sent: ${result.successCount} succeeded, ${result.failureCount} failed`);
+}
+```
+
+## API Reference
+
+### FCMService
+
+- `sendToDevice(token, payload)` - Send to single device
+- `sendToMultipleDevices(tokens, payload)` - Batch send (auto-splits into batches of 500)
+- `sendToCustomer(customerId, payload)` - Send to all customer devices
+- `sendToTopic(topic, payload)` - Broadcast to topic subscribers
+- `validateToken(token)` - Check if token is valid
+
+### Formatters
+
+- `formatShipmentNotification(data)` - Shipment events
+- `formatOrderNotification(data)` - Order events
+- `formatReturnNotification(data)` - Return events
+- `formatPayoutNotification(data)` - Payout events
+
+### Types
+
+```typescript
+import type {
+  NotificationPayload,
+  SendResult,
+  BatchResult,
+  DeviceToken,
+  DeviceRegistration,
+} from '@zan-shop/push-notifications';
+```
+
+## Device Management
+
+The package provides an abstract `DeviceService` class. Extend it with your database implementation:
+
+```typescript
+import { DeviceService } from '@zan-shop/push-notifications';
+
+class MyDeviceService extends DeviceService {
+  async registerDevice(customerId, deviceData) { /* ... */ }
+  async getCustomerDevices(customerId) { /* ... */ }
+  async deactivateDevice(token) { /* ... */ }
+  // ... other methods
+}
+```
+
+## Testing
+
+Enable dry-run mode for testing without sending actual notifications:
+
+```typescript
+const fcmService = new FCMService({ firebaseApp, dryRun: true });
+```
+
+## Versioning
+
+This package uses [semantic-release](https://github.com/semantic-release/semantic-release) for automated versioning. Use conventional commits:
+
+```
+# For features (bumps minor version 1.0.0 -> 1.1.0)
+git commit -m "feat: add notification scheduling"
+
+# For fixes (bumps patch version 1.0.0 -> 1.0.1)
+git commit -m "fix: handle expired tokens correctly"
+
+# For breaking changes (bumps major version 1.0.0 -> 2.0.0)
+git commit -m "feat!: change FCM service API
+
+BREAKING CHANGE: sendToDevice now requires configuration object"
+
+# No version bump
+git commit -m "chore: update dependencies"
+git commit -m "docs: update README"
+```
+
+## License
+
+MIT
+
+## Links
+
+- [GitHub Repository](https://github.com/zan-shop/push-notifications)
+- [Issues](https://github.com/zan-shop/push-notifications/issues)
+- [Firebase Cloud Messaging Docs](https://firebase.google.com/docs/cloud-messaging)
+- [Medusa.js Docs](https://docs.medusajs.com)

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @zan-shop/push-notifications
+ *
+ * Reusable push notification module for Medusa.js using Firebase Cloud Messaging
+ *
+ * @example
+ * ```typescript
+ * import { FCMService, formatShipmentNotification } from '@zan-shop/push-notifications';
+ *
+ * const fcmService = new FCMService({ firebaseApp });
+ *
+ * const notification = formatShipmentNotification({
+ *   type: 'shipment.created',
+ *   orderId: '123',
+ *   trackingNumber: 'ABC123',
+ *   carrier: 'FedEx',
+ * });
+ *
+ * await fcmService.sendToDevice(deviceToken, notification);
+ * ```
+ */
+export type { DeviceToken, DeviceInfo, DeviceRegistration, Platform, } from './models/device-token';
+export { FCMService, DeviceService } from './services';
+export type { FCMServiceOptions } from './services';
+export type { NotificationPayload, NotificationPriority, SendResult, BatchResult, NotificationError, ShipmentNotification, OrderNotification, ReturnNotification, } from './types';
+export { validateFCMToken, validatePlatform, validateAppVersion, formatShipmentNotification, formatOrderNotification, formatReturnNotification, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,YAAY,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @zan-shop/push-notifications
+ *
+ * Reusable push notification module for Medusa.js using Firebase Cloud Messaging
+ *
+ * @example
+ * ```typescript
+ * import { FCMService, formatShipmentNotification } from '@zan-shop/push-notifications';
+ *
+ * const fcmService = new FCMService({ firebaseApp });
+ *
+ * const notification = formatShipmentNotification({
+ *   type: 'shipment.created',
+ *   orderId: '123',
+ *   trackingNumber: 'ABC123',
+ *   carrier: 'FedEx',
+ * });
+ *
+ * await fcmService.sendToDevice(deviceToken, notification);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatReturnNotification = exports.formatOrderNotification = exports.formatShipmentNotification = exports.validateAppVersion = exports.validatePlatform = exports.validateFCMToken = exports.DeviceService = exports.FCMService = void 0;
+// Services
+var services_1 = require("./services");
+Object.defineProperty(exports, "FCMService", { enumerable: true, get: function () { return services_1.FCMService; } });
+Object.defineProperty(exports, "DeviceService", { enumerable: true, get: function () { return services_1.DeviceService; } });
+// Utils
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "validateFCMToken", { enumerable: true, get: function () { return utils_1.validateFCMToken; } });
+Object.defineProperty(exports, "validatePlatform", { enumerable: true, get: function () { return utils_1.validatePlatform; } });
+Object.defineProperty(exports, "validateAppVersion", { enumerable: true, get: function () { return utils_1.validateAppVersion; } });
+Object.defineProperty(exports, "formatShipmentNotification", { enumerable: true, get: function () { return utils_1.formatShipmentNotification; } });
+Object.defineProperty(exports, "formatOrderNotification", { enumerable: true, get: function () { return utils_1.formatOrderNotification; } });
+Object.defineProperty(exports, "formatReturnNotification", { enumerable: true, get: function () { return utils_1.formatReturnNotification; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAUH,WAAW;AACX,uCAAuD;AAA9C,sGAAA,UAAU,OAAA;AAAE,yGAAA,aAAa,OAAA;AAelC,QAAQ;AACR,iCAOiB;AANf,yGAAA,gBAAgB,OAAA;AAChB,yGAAA,gBAAgB,OAAA;AAChB,2GAAA,kBAAkB,OAAA;AAClB,mHAAA,0BAA0B,OAAA;AAC1B,gHAAA,uBAAuB,OAAA;AACvB,iHAAA,wBAAwB,OAAA"}

package/dist/models/device-token.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Device Token Model
+ * Represents a registered mobile device for push notifications
+ */
+export interface DeviceToken {
+    id: string;
+    customer_id: string;
+    token: string;
+    platform: 'ios' | 'android';
+    app_version?: string;
+    device_info?: DeviceInfo;
+    is_active: boolean;
+    last_used_at: Date;
+    created_at: Date;
+    updated_at: Date;
+    deleted_at?: Date | null;
+}
+export interface DeviceInfo {
+    model?: string;
+    os_version?: string;
+    manufacturer?: string;
+}
+export interface DeviceRegistration {
+    token: string;
+    platform: 'ios' | 'android';
+    app_version?: string;
+    device_info?: DeviceInfo;
+}
+export type Platform = 'ios' | 'android';
+//# sourceMappingURL=device-token.d.ts.map

package/dist/models/device-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-token.d.ts","sourceRoot":"","sources":["../../src/models/device-token.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC"}

package/dist/models/device-token.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Device Token Model
+ * Represents a registered mobile device for push notifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=device-token.js.map

package/dist/models/device-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-token.js","sourceRoot":"","sources":["../../src/models/device-token.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/services/device-service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Device Service Interface
+ * Abstract interface for managing device tokens
+ *
+ * This is an abstract class that should be implemented with database-specific logic
+ * The implementing class in zan-backend will use Medusa's data layer
+ */
+import { DeviceToken, DeviceRegistration } from '../models/device-token';
+export declare abstract class DeviceService {
+    /**
+     * Register a new device token for a customer
+     * Should handle deduplication (same customer + token)
+     */
+    abstract registerDevice(customerId: string, deviceData: DeviceRegistration): Promise<DeviceToken>;
+    /**
+     * Update an existing device
+     */
+    abstract updateDevice(tokenId: string, updates: Partial<DeviceToken>): Promise<DeviceToken>;
+    /**
+     * Deactivate a device (e.g., on logout)
+     * Marks device as inactive rather than deleting
+     */
+    abstract deactivateDevice(token: string): Promise<void>;
+    /**
+     * Deactivate all devices for a customer (e.g., on account deletion)
+     */
+    abstract deactivateCustomerDevices(customerId: string): Promise<number>;
+    /**
+     * Get all active devices for a customer
+     */
+    abstract getCustomerDevices(customerId: string): Promise<DeviceToken[]>;
+    /**
+     * Get a specific device by token
+     */
+    abstract getDeviceByToken(token: string): Promise<DeviceToken | null>;
+    /**
+     * Update last_used_at timestamp for a device
+     */
+    abstract touchDevice(token: string): Promise<void>;
+    /**
+     * Clean up inactive tokens older than specified days
+     * Returns number of devices cleaned up
+     */
+    abstract cleanupInactiveTokens(daysThreshold: number): Promise<number>;
+    /**
+     * Handle invalid tokens (called when FCM reports token as invalid)
+     * Marks tokens as inactive
+     */
+    abstract markTokensAsInvalid(tokens: string[]): Promise<void>;
+}
+//# sourceMappingURL=device-service.d.ts.map

package/dist/services/device-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-service.d.ts","sourceRoot":"","sources":["../../src/services/device-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEzE,8BAAsB,aAAa;IACjC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CACrB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,YAAY,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEvE;;OAEG;IACH,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAErE;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAElD;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEtE;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAC9D"}

package/dist/services/device-service.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Device Service Interface
+ * Abstract interface for managing device tokens
+ *
+ * This is an abstract class that should be implemented with database-specific logic
+ * The implementing class in zan-backend will use Medusa's data layer
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceService = void 0;
+class DeviceService {
+}
+exports.DeviceService = DeviceService;
+//# sourceMappingURL=device-service.js.map

package/dist/services/device-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-service.js","sourceRoot":"","sources":["../../src/services/device-service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAIH,MAAsB,aAAa;CAuDlC;AAvDD,sCAuDC"}

package/dist/services/fcm-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FCM Service
+ * Handles sending push notifications via Firebase Cloud Messaging
+ */
+import * as admin from 'firebase-admin';
+import { NotificationPayload, SendResult, BatchResult } from '../types/notification';
+export interface FCMServiceOptions {
+    firebaseApp: admin.app.App;
+    dryRun?: boolean;
+}
+export declare class FCMService {
+    private messaging;
+    private dryRun;
+    constructor(options: FCMServiceOptions);
+    /**
+     * Send notification to a single device
+     */
+    sendToDevice(token: string, payload: NotificationPayload): Promise<SendResult>;
+    /**
+     * Send notification to multiple devices
+     */
+    sendToMultipleDevices(tokens: string[], payload: NotificationPayload): Promise<BatchResult>;
+    /**
+     * Send notification to a topic (broadcast)
+     */
+    sendToTopic(topic: string, payload: NotificationPayload): Promise<SendResult>;
+    /**
+     * Validate a device token
+     */
+    validateToken(token: string): Promise<boolean>;
+    /**
+     * Send batch of notifications
+     */
+    private sendBatch;
+    /**
+     * Build FCM message for a single device
+     */
+    private buildMessage;
+    /**
+     * Build FCM message for a topic
+     */
+    private buildTopicMessage;
+    /**
+     * Parse Firebase error into standardized format
+     */
+    private parseError;
+}
+//# sourceMappingURL=fcm-service.d.ts.map

package/dist/services/fcm-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fcm-service.d.ts","sourceRoot":"","sources":["../../src/services/fcm-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAU;gBAEZ,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC;IAkBtB;;OAEG;IACG,qBAAqB,CACzB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC;IA6BvB;;OAEG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC;IAkBtB;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpD;;OAEG;YACW,SAAS;IA+BvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,UAAU;CAUnB"}

package/dist/services/fcm-service.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * FCM Service
+ * Handles sending push notifications via Firebase Cloud Messaging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FCMService = void 0;
+class FCMService {
+    constructor(options) {
+        this.messaging = options.firebaseApp.messaging();
+        this.dryRun = options.dryRun || false;
+    }
+    /**
+     * Send notification to a single device
+     */
+    async sendToDevice(token, payload) {
+        try {
+            const message = this.buildMessage(token, payload);
+            const messageId = await this.messaging.send(message, this.dryRun);
+            return {
+                success: true,
+                messageId,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: this.parseError(error, token),
+            };
+        }
+    }
+    /**
+     * Send notification to multiple devices
+     */
+    async sendToMultipleDevices(tokens, payload) {
+        if (tokens.length === 0) {
+            return {
+                successCount: 0,
+                failureCount: 0,
+                results: [],
+            };
+        }
+        // FCM allows max 500 tokens per batch
+        const batchSize = 500;
+        const results = [];
+        for (let i = 0; i < tokens.length; i += batchSize) {
+            const batch = tokens.slice(i, i + batchSize);
+            const batchResults = await this.sendBatch(batch, payload);
+            results.push(...batchResults);
+        }
+        const successCount = results.filter((r) => r.success).length;
+        const failureCount = results.length - successCount;
+        return {
+            successCount,
+            failureCount,
+            results,
+        };
+    }
+    /**
+     * Send notification to a topic (broadcast)
+     */
+    async sendToTopic(topic, payload) {
+        try {
+            const message = this.buildTopicMessage(topic, payload);
+            const messageId = await this.messaging.send(message, this.dryRun);
+            return {
+                success: true,
+                messageId,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: this.parseError(error),
+            };
+        }
+    }
+    /**
+     * Validate a device token
+     */
+    async validateToken(token) {
+        try {
+            // Try to send a dry-run message
+            await this.messaging.send({
+                token,
+                notification: {
+                    title: 'Test',
+                    body: 'Test',
+                },
+            }, true // Always dry run for validation
+            );
+            return true;
+        }
+        catch (error) {
+            // Token is invalid if we get specific error codes
+            const invalidTokenCodes = [
+                'messaging/invalid-registration-token',
+                'messaging/registration-token-not-registered',
+            ];
+            return !invalidTokenCodes.includes(error?.code);
+        }
+    }
+    /**
+     * Send batch of notifications
+     */
+    async sendBatch(tokens, payload) {
+        try {
+            const messages = tokens.map((token) => this.buildMessage(token, payload));
+            const response = await this.messaging.sendEach(messages, this.dryRun);
+            return response.responses.map((resp, index) => {
+                if (resp.success) {
+                    return {
+                        success: true,
+                        messageId: resp.messageId,
+                    };
+                }
+                else {
+                    return {
+                        success: false,
+                        error: this.parseError(resp.error, tokens[index]),
+                    };
+                }
+            });
+        }
+        catch (error) {
+            // If entire batch fails, return error for all tokens
+            return tokens.map((token) => ({
+                success: false,
+                error: this.parseError(error, token),
+            }));
+        }
+    }
+    /**
+     * Build FCM message for a single device
+     */
+    buildMessage(token, payload) {
+        return {
+            token,
+            notification: {
+                title: payload.title,
+                body: payload.body,
+                ...(payload.imageUrl && { imageUrl: payload.imageUrl }),
+            },
+            data: payload.data,
+            android: {
+                priority: payload.priority === 'high' ? 'high' : 'normal',
+                notification: {
+                    sound: payload.sound || 'default',
+                    clickAction: payload.clickAction,
+                },
+            },
+            apns: {
+                payload: {
+                    aps: {
+                        badge: payload.badge,
+                        sound: payload.sound || 'default',
+                    },
+                },
+                fcmOptions: {
+                    ...(payload.imageUrl && { imageUrl: payload.imageUrl }),
+                },
+            },
+        };
+    }
+    /**
+     * Build FCM message for a topic
+     */
+    buildTopicMessage(topic, payload) {
+        return {
+            topic,
+            notification: {
+                title: payload.title,
+                body: payload.body,
+                ...(payload.imageUrl && { imageUrl: payload.imageUrl }),
+            },
+            data: payload.data,
+            android: {
+                priority: payload.priority === 'high' ? 'high' : 'normal',
+                notification: {
+                    sound: payload.sound || 'default',
+                    clickAction: payload.clickAction,
+                },
+            },
+            apns: {
+                payload: {
+                    aps: {
+                        badge: payload.badge,
+                        sound: payload.sound || 'default',
+                    },
+                },
+            },
+        };
+    }
+    /**
+     * Parse Firebase error into standardized format
+     */
+    parseError(error, token) {
+        const code = error?.code || 'unknown';
+        const message = error?.message || 'Unknown error occurred';
+        return {
+            code,
+            message,
+            ...(token && { token }),
+        };
+    }
+}
+exports.FCMService = FCMService;
+//# sourceMappingURL=fcm-service.js.map

package/dist/services/fcm-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fcm-service.js","sourceRoot":"","sources":["../../src/services/fcm-service.ts"],"names":[],"mappings":"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"}

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Services Index
+ * Exports all service classes
+ */
+export { FCMService } from './fcm-service';
+export type { FCMServiceOptions } from './fcm-service';
+export { DeviceService } from './device-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Services Index
+ * Exports all service classes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceService = exports.FCMService = void 0;
+var fcm_service_1 = require("./fcm-service");
+Object.defineProperty(exports, "FCMService", { enumerable: true, get: function () { return fcm_service_1.FCMService; } });
+var device_service_1 = require("./device-service");
+Object.defineProperty(exports, "DeviceService", { enumerable: true, get: function () { return device_service_1.DeviceService; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Type Definitions Index
+ * Exports all type definitions for external use
+ */
+export * from './notification';
+export type { DeviceToken, DeviceInfo, DeviceRegistration, Platform, } from '../models/device-token';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,QAAQ,GACT,MAAM,wBAAwB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Type Definitions Index
+ * Exports all type definitions for external use
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./notification"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,iDAA+B"}

package/dist/types/notification.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Notification Types
+ * Type definitions for push notification payloads and results
+ */
+export interface NotificationPayload {
+    title: string;
+    body: string;
+    data?: Record<string, string>;
+    imageUrl?: string;
+    sound?: string;
+    badge?: number;
+    clickAction?: string;
+    priority?: NotificationPriority;
+}
+export type NotificationPriority = 'high' | 'normal';
+export interface SendResult {
+    success: boolean;
+    messageId?: string;
+    error?: NotificationError;
+}
+export interface BatchResult {
+    successCount: number;
+    failureCount: number;
+    results: SendResult[];
+}
+export interface NotificationError {
+    code: string;
+    message: string;
+    token?: string;
+}
+export interface ShipmentNotification {
+    type: 'shipment.created';
+    orderId: string;
+    trackingNumber?: string;
+    carrier?: string;
+    estimatedDelivery?: string;
+}
+export interface OrderNotification {
+    type: 'order.placed' | 'order.delivered' | 'order.canceled';
+    orderId: string;
+    orderNumber?: string;
+}
+export interface ReturnNotification {
+    type: 'return.created' | 'return.approved' | 'return.rejected';
+    returnId: string;
+    orderId: string;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/types/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/notification.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Notification Types
+ * Type definitions for push notification payloads and results
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=notification.js.map

package/dist/types/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utils Index
+ * Exports all utility functions
+ */
+export * from './validators';
+export * from './notification-formatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Utils Index
+ * Exports all utility functions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./validators"), exports);
+__exportStar(require("./notification-formatter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,2DAAyC"}

package/dist/utils/notification-formatter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Notification Formatters
+ * Helper functions to format notifications for different event types
+ */
+import { NotificationPayload, ShipmentNotification, OrderNotification, ReturnNotification } from '../types/notification';
+/**
+ * Format shipment notification
+ */
+export declare function formatShipmentNotification(data: ShipmentNotification): NotificationPayload;
+/**
+ * Format order notification
+ */
+export declare function formatOrderNotification(data: OrderNotification): NotificationPayload;
+/**
+ * Format return notification
+ */
+export declare function formatReturnNotification(data: ReturnNotification): NotificationPayload;
+//# sourceMappingURL=notification-formatter.d.ts.map

package/dist/utils/notification-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/notification-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,oBAAoB,GACzB,mBAAmB,CA2BrB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,iBAAiB,GACtB,mBAAmB,CA0BrB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,kBAAkB,GACvB,mBAAmB,CA0BrB"}

package/dist/utils/notification-formatter.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Notification Formatters
+ * Helper functions to format notifications for different event types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatShipmentNotification = formatShipmentNotification;
+exports.formatOrderNotification = formatOrderNotification;
+exports.formatReturnNotification = formatReturnNotification;
+/**
+ * Format shipment notification
+ */
+function formatShipmentNotification(data) {
+    const { orderId, trackingNumber, carrier, estimatedDelivery } = data;
+    let body = `Your order #${orderId} has been shipped!`;
+    if (carrier && trackingNumber) {
+        body += ` Track your package with ${carrier}: ${trackingNumber}`;
+    }
+    else if (trackingNumber) {
+        body += ` Tracking: ${trackingNumber}`;
+    }
+    if (estimatedDelivery) {
+        body += ` Estimated delivery: ${estimatedDelivery}`;
+    }
+    return {
+        title: '📦 Order Shipped',
+        body,
+        data: {
+            type: 'shipment.created',
+            orderId,
+            ...(trackingNumber && { trackingNumber }),
+            ...(carrier && { carrier }),
+        },
+        clickAction: `/orders/${orderId}`,
+        priority: 'high',
+    };
+}
+/**
+ * Format order notification
+ */
+function formatOrderNotification(data) {
+    const { type, orderId, orderNumber } = data;
+    const titles = {
+        'order.placed': '✅ Order Confirmed',
+        'order.delivered': '🎉 Order Delivered',
+        'order.canceled': '❌ Order Canceled',
+    };
+    const bodies = {
+        'order.placed': `Your order ${orderNumber || `#${orderId}`} has been confirmed!`,
+        'order.delivered': `Your order ${orderNumber || `#${orderId}`} has been delivered!`,
+        'order.canceled': `Your order ${orderNumber || `#${orderId}`} has been canceled.`,
+    };
+    return {
+        title: titles[type],
+        body: bodies[type],
+        data: {
+            type,
+            orderId,
+            ...(orderNumber && { orderNumber }),
+        },
+        clickAction: `/orders/${orderId}`,
+        priority: type === 'order.placed' ? 'high' : 'normal',
+    };
+}
+/**
+ * Format return notification
+ */
+function formatReturnNotification(data) {
+    const { type, returnId, orderId } = data;
+    const titles = {
+        'return.created': '🔄 Return Initiated',
+        'return.approved': '✅ Return Approved',
+        'return.rejected': '❌ Return Rejected',
+    };
+    const bodies = {
+        'return.created': `Your return request for order #${orderId} has been submitted.`,
+        'return.approved': `Your return request for order #${orderId} has been approved!`,
+        'return.rejected': `Your return request for order #${orderId} was rejected.`,
+    };
+    return {
+        title: titles[type],
+        body: bodies[type],
+        data: {
+            type,
+            returnId,
+            orderId,
+        },
+        clickAction: `/returns/${returnId}`,
+        priority: 'normal',
+    };
+}
+//# sourceMappingURL=notification-formatter.js.map

package/dist/utils/notification-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-formatter.js","sourceRoot":"","sources":["../../src/utils/notification-formatter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAYH,gEA6BC;AAKD,0DA4BC;AAKD,4DA4BC;AAlGD;;GAEG;AACH,SAAgB,0BAA0B,CACxC,IAA0B;IAE1B,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAErE,IAAI,IAAI,GAAG,eAAe,OAAO,oBAAoB,CAAC;IAEtD,IAAI,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B,IAAI,IAAI,4BAA4B,OAAO,KAAK,cAAc,EAAE,CAAC;IACnE,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,IAAI,IAAI,cAAc,cAAc,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACtB,IAAI,IAAI,wBAAwB,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,kBAAkB;QACzB,IAAI;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,kBAAkB;YACxB,OAAO;YACP,GAAG,CAAC,cAAc,IAAI,EAAE,cAAc,EAAE,CAAC;YACzC,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;SAC5B;QACD,WAAW,EAAE,WAAW,OAAO,EAAE;QACjC,QAAQ,EAAE,MAAM;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CACrC,IAAuB;IAEvB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE5C,MAAM,MAAM,GAA8C;QACxD,cAAc,EAAE,mBAAmB;QACnC,iBAAiB,EAAE,oBAAoB;QACvC,gBAAgB,EAAE,kBAAkB;KACrC,CAAC;IAEF,MAAM,MAAM,GAA8C;QACxD,cAAc,EAAE,cAAc,WAAW,IAAI,IAAI,OAAO,EAAE,sBAAsB;QAChF,iBAAiB,EAAE,cAAc,WAAW,IAAI,IAAI,OAAO,EAAE,sBAAsB;QACnF,gBAAgB,EAAE,cAAc,WAAW,IAAI,IAAI,OAAO,EAAE,qBAAqB;KAClF,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,IAAI,EAAE;YACJ,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;SACpC;QACD,WAAW,EAAE,WAAW,OAAO,EAAE;QACjC,QAAQ,EAAE,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CACtC,IAAwB;IAExB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEzC,MAAM,MAAM,GAA+C;QACzD,gBAAgB,EAAE,qBAAqB;QACvC,iBAAiB,EAAE,mBAAmB;QACtC,iBAAiB,EAAE,mBAAmB;KACvC,CAAC;IAEF,MAAM,MAAM,GAA+C;QACzD,gBAAgB,EAAE,kCAAkC,OAAO,sBAAsB;QACjF,iBAAiB,EAAE,kCAAkC,OAAO,qBAAqB;QACjF,iBAAiB,EAAE,kCAAkC,OAAO,gBAAgB;KAC7E,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;QAClB,IAAI,EAAE;YACJ,IAAI;YACJ,QAAQ;YACR,OAAO;SACR;QACD,WAAW,EAAE,YAAY,QAAQ,EAAE;QACnC,QAAQ,EAAE,QAAQ;KACnB,CAAC;AACJ,CAAC"}

package/dist/utils/validators.d.ts

@@ -0,0 +1,18 @@
+/**
+ * FCM Token Validator
+ * Validates Firebase Cloud Messaging device tokens
+ */
+/**
+ * Validate FCM token format
+ * FCM tokens are typically 152+ characters, alphanumeric with special chars
+ */
+export declare function validateFCMToken(token: string): boolean;
+/**
+ * Validate platform value
+ */
+export declare function validatePlatform(platform: string): platform is 'ios' | 'android';
+/**
+ * Validate app version format (semver-like)
+ */
+export declare function validateAppVersion(version: string): boolean;
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,KAAK,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ3D"}

package/dist/utils/validators.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * FCM Token Validator
+ * Validates Firebase Cloud Messaging device tokens
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFCMToken = validateFCMToken;
+exports.validatePlatform = validatePlatform;
+exports.validateAppVersion = validateAppVersion;
+/**
+ * Validate FCM token format
+ * FCM tokens are typically 152+ characters, alphanumeric with special chars
+ */
+function validateFCMToken(token) {
+    if (!token || typeof token !== 'string') {
+        return false;
+    }
+    // FCM tokens are typically 152-163 characters long
+    if (token.length < 140 || token.length > 200) {
+        return false;
+    }
+    // Should contain only alphanumeric, hyphens, underscores, and colons
+    const validTokenRegex = /^[a-zA-Z0-9_:-]+$/;
+    return validTokenRegex.test(token);
+}
+/**
+ * Validate platform value
+ */
+function validatePlatform(platform) {
+    return platform === 'ios' || platform === 'android';
+}
+/**
+ * Validate app version format (semver-like)
+ */
+function validateAppVersion(version) {
+    if (!version || typeof version !== 'string') {
+        return false;
+    }
+    // Accept formats like: 1.0.0, 1.0, 1.0.0-beta, etc.
+    const versionRegex = /^\d+\.\d+(\.\d+)?(-[a-zA-Z0-9.-]+)?$/;
+    return versionRegex.test(version);
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,4CAaC;AAKD,4CAEC;AAKD,gDAQC;AArCD;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qEAAqE;IACrE,MAAM,eAAe,GAAG,mBAAmB,CAAC;IAC5C,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,SAAS,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oDAAoD;IACpD,MAAM,YAAY,GAAG,sCAAsC,CAAC;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@zan-shop/push-notifications",
+  "version": "1.0.0",
+  "description": "Push notification module for Medusa.js using Firebase Cloud Messaging",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "medusa",
+    "medusa-plugin",
+    "push-notifications",
+    "fcm",
+    "firebase",
+    "cloud-messaging"
+  ],
+  "author": "zan shop",
+  "license": "MIT",
+  "devDependencies": {
+    "@medusajs/framework": "^2.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.5.0",
+    "semantic-release": "^24.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "firebase-admin": "^12.0.0"
+  },
+  "peerDependencies": {
+    "@medusajs/framework": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zan-shop/push-notifications.git"
+  },
+  "homepage": "https://github.com/zan-shop/push-notifications#readme",
+  "bugs": {
+    "url": "https://github.com/zan-shop/push-notifications/issues"
+  }
+}