@maccesar/titools 2.2.4 → 2.2.8

package/skills/ti-howtos/references/notification-services.md

@@ -1,36 +1,36 @@
-# Push and Local Notifications
+# Push and local notifications
 
-Comprehensive guide for local and push notifications on iOS and Android.
+Guide to local and push notifications on iOS and Android.
 
-## Local Notifications Android
+## Local notifications: Android
 
-### Notification Display Locations
+### Notification display locations
 
-- **Notification Drawer**: Swipe down from status bar
-- **Lock Screen**: Android 5.0+ (API 21+)
-- **Status Bar**: Icon and ticker text
+- Notification drawer: swipe down from status bar
+- Lock screen: Android 5.0+ (API 21+)
+- Status bar: icon and ticker text
 
-### Create a Notification
+### Create a notification
 
-**Basic Layout:**
+Basic layout:
 ```javascript
 const notification = Ti.Android.createNotification({
-    contentTitle: 'Notification Title',
-    contentText: 'Notification message',
-    contentIntent: Ti.Android.createPendingIntent({
-        intent: Ti.Android.createIntent({})
-    }),
-    icon: Ti.App.Android.R.drawable.warn,  // or '/images/warn.png'
-    number: 5,           // Badge number
-    when: new Date(),    // Timestamp (does NOT schedule)
-    tickerText: 'Text in status bar when notification first appears'
+  contentTitle: 'Notification Title',
+  contentText: 'Notification message',
+  contentIntent: Ti.Android.createPendingIntent({
+    intent: Ti.Android.createIntent({})
+  }),
+  icon: Ti.App.Android.R.drawable.warn, // or '/images/warn.png'
+  number: 5, // Badge number
+  when: new Date(), // Timestamp (does not schedule)
+  tickerText: 'Text in status bar when notification first appears'
 });
 
 // Send immediately
 Ti.Android.NotificationManager.notify(1, notification);
 ```
 
-**Icon paths:**
+Icon paths:
 - Density-specific: `/app/assets/android/images/` (Alloy) or `/Resources/android/images/` (Classic), reference as `/images/filename.png`
 - Drawable folder: `/platform/android/res/drawable/filename.png`, reference as `Ti.App.Android.R.drawable.filename`
 
@@ -38,8 +38,8 @@ Ti.Android.NotificationManager.notify(1, notification);
 
 ```javascript
 const notification = Ti.Android.createNotification({
-    // ... other properties
-    sound: `${Ti.Filesystem.getResRawDirectory()}sound.wav`
+  // ... other properties
+  sound: `${Ti.Filesystem.getResRawDirectory()}sound.wav`
 });
 ```
 
@@ -48,9 +48,9 @@ Play only once (add flag):
 notification.flags |= Ti.Android.FLAG_ONLY_ALERT_ONCE;
 ```
 
-### Custom Layout with RemoteViews
+### Custom layout with RemoteViews
 
-**1. Create XML Layout** (`/platform/android/res/layout/customview.xml`):
+1. Create XML layout (`/platform/android/res/layout/customview.xml`):
 ```xml
 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
@@ -68,64 +68,64 @@ notification.flags |= Ti.Android.FLAG_ONLY_ALERT_ONCE;
 </LinearLayout>
 ```
 
-**2. Create RemoteViews and bind intents:**
+2. Create RemoteViews and bind intents:
 ```javascript
 const customView = Ti.Android.createRemoteViews({
-    layoutId: Ti.App.Android.R.layout.customview
+  layoutId: Ti.App.Android.R.layout.customview
 });
 
 // Modify text
-customView.setTextViewText(Ti.App.Android.R.id.message, "Update available!");
+customView.setTextViewText(Ti.App.Android.R.id.message, 'Update available!');
 
 // Bind intents to buttons
-const downloadIntent = Ti.Android.createPendingIntent({intent: Ti.Android.createIntent()});
+const downloadIntent = Ti.Android.createPendingIntent({ intent: Ti.Android.createIntent() });
 customView.setOnClickPendingIntent(Ti.App.Android.R.id.okbutton, downloadIntent);
 
 const notification = Ti.Android.createNotification({
-    contentView: customView  // Avoid setting contentTitle/contentText or they override this
+  contentView: customView // Avoid setting contentTitle/contentText or they override this
 });
 ```
 
-### Additional Properties
+### Additional properties
 
-**Defaults (device settings):**
+Defaults (device settings):
 ```javascript
-notification.defaults = Ti.Android.DEFAULT_ALL;  // or DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS
+notification.defaults = Ti.Android.DEFAULT_ALL; // or DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS
 ```
 
-**Flags (behavior):**
+Flags (behavior):
 ```javascript
-notification.flags |= Ti.Android.FLAG_AUTO_CANCEL;     // Clear on tap
-notification.flags |= Ti.Android.FLAG_INSISTENT;       // Repeat sound until canceled
-notification.flags |= Ti.Android.FLAG_NO_CLEAR;        // Don't clear with "clear all"
-notification.flags |= Ti.Android.FLAG_ONGOING_EVENT;   // Ongoing event (e.g., music player)
-notification.flags |= Ti.Android.FLAG_ONLY_ALERT_ONCE; // Don't replay sound/vibrate
-notification.flags |= Ti.Android.FLAG_SHOW_LIGHTS;     // Use LED (if device allows)
+notification.flags |= Ti.Android.FLAG_AUTO_CANCEL; // Clear on tap
+notification.flags |= Ti.Android.FLAG_INSISTENT; // Repeat sound until canceled
+notification.flags |= Ti.Android.FLAG_NO_CLEAR; // Do not clear with "clear all"
+notification.flags |= Ti.Android.FLAG_ONGOING_EVENT; // Ongoing event (for example, music player)
+notification.flags |= Ti.Android.FLAG_ONLY_ALERT_ONCE; // Do not replay sound/vibrate
+notification.flags |= Ti.Android.FLAG_SHOW_LIGHTS; // Use LED (if device allows)
 ```
 
-**Priority** (Android 4.1+):
+Priority (Android 4.1+):
 ```javascript
-notification.priority = Ti.Android.PRIORITY_HIGH;  // or PRIORITY_MAX, PRIORITY_DEFAULT, PRIORITY_LOW, PRIORITY_MIN
+notification.priority = Ti.Android.PRIORITY_HIGH; // or PRIORITY_MAX, PRIORITY_DEFAULT, PRIORITY_LOW, PRIORITY_MIN
 ```
 
-**Category** (Android 5.0+):
+Category (Android 5.0+):
 ```javascript
-notification.category = Ti.Android.CATEGORY_MESSAGE;  // or CATEGORY_ALARM, CALL, EMAIL, ERROR, EVENT, etc.
+notification.category = Ti.Android.CATEGORY_MESSAGE; // or CATEGORY_ALARM, CALL, EMAIL, ERROR, EVENT, etc.
 ```
 
-**Visibility** (Android 5.0+ - lock screen):
+Visibility (Android 5.0+ - lock screen):
 ```javascript
-notification.visibility = Ti.Android.VISIBILITY_PUBLIC;     // Show all
-// or VISIBILITY_PRIVATE (hide content), VISIBILITY_SECRET (don't show)
+notification.visibility = Ti.Android.VISIBILITY_PUBLIC; // Show all
+// or VISIBILITY_PRIVATE (hide content), VISIBILITY_SECRET (do not show)
 ```
 
-### Update Notification
+### Update notification
 
 ```javascript
 notification.setLatestEventInfo('New Title', 'New Message', notification.contentIntent);
 ```
 
-### Remove Notifications
+### Remove notifications
 
 ```javascript
 // Remove specific notification
@@ -135,35 +135,35 @@ Ti.Android.NotificationManager.cancel(1);
 Ti.Android.NotificationManager.cancelAll();
 ```
 
-### Respond to Notification Tap
+### Respond to notification tap
 
-**Launch app when tapped:**
+Launch app when tapped:
 ```javascript
 const intent = Ti.Android.createIntent({
-    action: Ti.Android.ACTION_MAIN,
-    className: 'com.titaniumsdk.testapp.MyappActivity',  // ProjectName + Activity
-    packageName: 'com.titaniumsdk.testapp'
+  action: Ti.Android.ACTION_MAIN,
+  className: 'com.titaniumsdk.testapp.MyappActivity', // ProjectName + Activity
+  packageName: 'com.titaniumsdk.testapp'
 });
 intent.flags |= Ti.Android.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED | Ti.Android.FLAG_ACTIVITY_SINGLE_TOP;
 intent.addCategory(Ti.Android.CATEGORY_LAUNCHER);
 
-notification.contentIntent = Ti.Android.createPendingIntent({intent: intent});
+notification.contentIntent = Ti.Android.createPendingIntent({ intent: intent });
 ```
 
-### Delete Intent (Notification Cleared)
+### Delete intent (notification cleared)
 
 ```javascript
 // Execute intent when user clears notification
 notification.deleteIntent = Ti.Android.createPendingIntent({
-    intent: Ti.Android.createIntent({
-        action: 'com.myapp.NOTIFICATION_CLEARED'
-    })
+  intent: Ti.Android.createIntent({
+    action: 'com.myapp.NOTIFICATION_CLEARED'
+  })
 });
 ```
 
-### Schedule Future Notification (Background Service)
+### Schedule future notification (background service)
 
-**tiapp.xml:**
+`tiapp.xml`:
 ```xml
 <android xmlns:android="http://schemas.android.com/apk/res/android">
     <services>
@@ -172,379 +172,369 @@ notification.deleteIntent = Ti.Android.createPendingIntent({
 </android>
 ```
 
-**ExampleService.js:**
+`ExampleService.js`:
 ```javascript
 const service = Ti.Android.currentService;
 const serviceIntent = service.getIntent();
 const timestamp = new Date(serviceIntent.getStringExtra('timestamp'));
 
 if (new Date() > timestamp) {
-    const title = serviceIntent.getStringExtra('title');
-    const message = serviceIntent.getStringExtra('message');
+  const title = serviceIntent.getStringExtra('title');
+  const message = serviceIntent.getStringExtra('message');
 
-    const notification = Ti.Android.createNotification({
-        contentTitle: title,
-        contentText: message,
-        contentIntent: Ti.Android.createPendingIntent({intent: Ti.Android.createIntent()})
-    });
+  const notification = Ti.Android.createNotification({
+    contentTitle: title,
+    contentText: message,
+    contentIntent: Ti.Android.createPendingIntent({ intent: Ti.Android.createIntent() })
+  });
 
-    Ti.Android.NotificationManager.notify(1, notification);
-    Ti.Android.stopService(serviceIntent);
+  Ti.Android.NotificationManager.notify(1, notification);
+  Ti.Android.stopService(serviceIntent);
 }
 ```
 
-**Main app:**
+Main app:
 ```javascript
-const intent = Ti.Android.createServiceIntent({url: 'ExampleService.js'});
-intent.putExtra('interval', 5000);  // Check every 5 seconds
-intent.putExtra('timestamp', new Date(new Date().getTime() + (30 * 1000)));  // Fire in 30 seconds
+const intent = Ti.Android.createServiceIntent({ url: 'ExampleService.js' });
+intent.putExtra('interval', 5000); // Check every 5 seconds
+intent.putExtra('timestamp', new Date(new Date().getTime() + (30 * 1000))); // Fire in 30 seconds
 intent.putExtra('title', 'Scheduled Notification');
 intent.putExtra('message', 'This was scheduled!');
 Ti.Android.startService(intent);
 ```
 
----
-
-## Local Notifications iOS
+## Local notifications: iOS
 
-### Notification Display Locations
+### Notification display locations
 
-- **Alert Dialog**: "Open" or "Close" buttons (background, unlocked)
-- **Banner Message**: Swipe down for actions, tap to launch (background, unlocked)
-- **Lock Screen**: Swipe right to launch
-- **Notification Center**: Queued notifications
-- **Badge**: Number on app icon
-- **Sound**: Audio alert
+- Alert dialog: Open or Close buttons (background, unlocked)
+- Banner message: swipe down for actions, tap to launch (background, unlocked)
+- Lock screen: swipe right to launch
+- Notification Center: queued notifications
+- Badge: number on app icon
+- Sound: audio alert
 
-### Register for Notifications (iOS 8+)
+### Register for notifications (iOS 8+)
 
 ```javascript
 if (Ti.Platform.name === 'iPhone OS' && parseInt(Ti.Platform.version.split('.')[0]) >= 8) {
-    Ti.App.iOS.registerUserNotificationSettings({
-        types: [
-            Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT,
-            Ti.App.iOS.USER_NOTIFICATION_TYPE_SOUND,
-            Ti.App.iOS.USER_NOTIFICATION_TYPE_BADGE
-        ]
-        // Add 'categories' for interactive notifications
-    });
+  Ti.App.iOS.registerUserNotificationSettings({
+    types: [
+      Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT,
+      Ti.App.iOS.USER_NOTIFICATION_TYPE_SOUND,
+      Ti.App.iOS.USER_NOTIFICATION_TYPE_BADGE
+    ]
+    // Add 'categories' for interactive notifications
+  });
 }
 ```
 
-**Note**: iOS will show a system prompt asking the user to allow notifications on the first call. Check current settings with:
+Note: iOS shows a system prompt the first time. Check current settings with:
 ```javascript
 Ti.App.iOS.addEventListener('usernotificationsettings', (e) => {
-    Ti.API.info(`Notification types allowed: ${e.types}`);
+  Ti.API.info(`Notification types allowed: ${e.types}`);
 });
 ```
 
-### Schedule Local Notification
+### Schedule local notification
 
 ```javascript
 const notification = Ti.App.iOS.scheduleLocalNotification({
-    date: new Date(new Date().getTime() + 3000),  // 3 seconds from now
-    alertBody: 'New content available!',
-    alertAction: 'update',  // Changes "slide to view" to "slide to update" or "Open" to "Update"
-    alertLaunchImage: 'splash.png',  // Custom splash image
-    badge: 1,             // Set badge number (negative to clear)
-    sound: '/alert.wav',  // Sound file in Resources or app/assets
-    category: 'CATEGORY_ID',  // For interactive notifications
-    repeat: 'daily',      // or 'weekly', 'monthly', 'yearly'
-    timezone: 'America/Los_Angeles',  // Optional (default: system timezone)
-    userInfo: { url: 'http://example.com/data.json', id: '123' }  // Custom data
+  date: new Date(new Date().getTime() + 3000), // 3 seconds from now
+  alertBody: 'New content available!',
+  alertAction: 'update', // Changes "slide to view" to "slide to update" or "Open" to "Update"
+  alertLaunchImage: 'splash.png', // Custom splash image
+  badge: 1, // Set badge number (negative to clear)
+  sound: '/alert.wav', // Sound file in Resources or app/assets
+  category: 'CATEGORY_ID', // For interactive notifications
+  repeat: 'daily', // or 'weekly', 'monthly', 'yearly'
+  timezone: 'America/Los_Angeles', // Optional (default: system timezone)
+  userInfo: { url: 'http://example.com/data.json', id: '123' } // Custom data
 });
 ```
 
-### Monitor Notifications
+### Monitor notifications
 
-**While app is in foreground or returns to foreground:**
+While app is in foreground or returns to foreground:
 ```javascript
 Ti.App.iOS.addEventListener('notification', (e) => {
-    // Process custom data
-    if (e.userInfo && e.userInfo.url) {
-        // Handle URL
-    }
-
-    // Reset badge
-    if (e.badge > 0) {
-        Ti.App.iOS.scheduleLocalNotification({
-            date: new Date(),
-            badge: -1
-        });
-    }
+  // Process custom data
+  if (e.userInfo && e.userInfo.url) {
+    // Handle URL
+  }
+
+  // Reset badge
+  if (e.badge > 0) {
+    Ti.App.iOS.scheduleLocalNotification({
+      date: new Date(),
+      badge: -1
+    });
+  }
 });
 ```
 
-### Cancel Notifications
+### Cancel notifications
 
 ```javascript
 // Cancel all
 Ti.App.iOS.cancelAllLocalNotifications();
 
 // Cancel specific notification
-const notification = Ti.App.iOS.scheduleLocalNotification({...});
+const notification = Ti.App.iOS.scheduleLocalNotification({ ... });
 notification.cancel();
 
 // Or by ID
 Ti.App.iOS.scheduleLocalNotification({
-    userInfo: {id: 'foo'},
-    alertBody: 'Test'
+  userInfo: { id: 'foo' },
+  alertBody: 'Test'
 });
 Ti.App.iOS.cancelLocalNotification('foo');
 ```
 
----
+## Interactive notifications: iOS (iOS 8+)
 
-## Interactive Notifications iOS (iOS 8+)
-
-### Create Notification Actions
+### Create notification actions
 
 ```javascript
 const acceptAction = Ti.App.iOS.createUserNotificationAction({
-    identifier: 'ACCEPT_IDENTIFIER',
-    title: 'Accept',
-    activationMode: Ti.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_FOREGROUND,  // or BACKGROUND
-    destructive: false,
-    authenticationRequired: true  // Require device unlock
+  identifier: 'ACCEPT_IDENTIFIER',
+  title: 'Accept',
+  activationMode: Ti.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_FOREGROUND, // or BACKGROUND
+  destructive: false,
+  authenticationRequired: true // Require device unlock
 });
 
 const rejectAction = Ti.App.iOS.createUserNotificationAction({
-    identifier: 'REJECT_IDENTIFIER',
-    title: 'Reject',
-    activationMode: Ti.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND,
-    destructive: true,  // Red background in lock screen/notification center
-    authenticationRequired: false
+  identifier: 'REJECT_IDENTIFIER',
+  title: 'Reject',
+  activationMode: Ti.App.iOS.USER_NOTIFICATION_ACTIVATION_MODE_BACKGROUND,
+  destructive: true, // Red background in lock screen/notification center
+  authenticationRequired: false
 });
 ```
 
-### Create Notification Category
+### Create notification category
 
 ```javascript
 const category = Ti.App.iOS.createUserNotificationCategory({
-    identifier: 'INVITE_CATEGORY',
-    actionsForDefaultContext: [acceptAction, rescheduleAction, delayAction, rejectAction],  // Alert dialog (4 max)
-    actionsForMinimalContext: [acceptAction, rejectAction]  // Other styles (2 max)
+  identifier: 'INVITE_CATEGORY',
+  actionsForDefaultContext: [acceptAction, rescheduleAction, delayAction, rejectAction], // Alert dialog (4 max)
+  actionsForMinimalContext: [acceptAction, rejectAction] // Other styles (2 max)
 });
 ```
 
-### Register Categories
+### Register categories
 
 ```javascript
 Ti.App.iOS.registerUserNotificationSettings({
-    types: [
-        Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT,
-        Ti.App.iOS.USER_NOTIFICATION_TYPE_BADGE,
-        Ti.App.iOS.USER_NOTIFICATION_TYPE_SOUND
-    ],
-    categories: [category]
+  types: [
+    Ti.App.iOS.USER_NOTIFICATION_TYPE_ALERT,
+    Ti.App.iOS.USER_NOTIFICATION_TYPE_BADGE,
+    Ti.App.iOS.USER_NOTIFICATION_TYPE_SOUND
+  ],
+  categories: [category]
 });
 ```
 
-### Monitor Interactive Notifications
+### Monitor interactive notifications
 
-**Local notifications:**
+Local notifications:
 ```javascript
 Ti.App.iOS.addEventListener('localnotificationaction', (e) => {
-    // e.category: category identifier
-    // e.identifier: action identifier
-    // e.userInfo: custom data
-
-    if (e.category === 'INVITE_CATEGORY' && e.identifier === 'ACCEPT_IDENTIFIER') {
-        // Handle accept
-        if (e.userInfo && e.userInfo.url) {
-            // Process URL
-        }
-    }
+  // e.category: category identifier
+  // e.identifier: action identifier
+  // e.userInfo: custom data
 
-    // Reset badge
-    if (e.badge > 0) {
-        Ti.App.iOS.scheduleLocalNotification({ date: new Date(), badge: -1 });
+  if (e.category === 'INVITE_CATEGORY' && e.identifier === 'ACCEPT_IDENTIFIER') {
+    // Handle accept
+    if (e.userInfo && e.userInfo.url) {
+      // Process URL
     }
+  }
+
+  // Reset badge
+  if (e.badge > 0) {
+    Ti.App.iOS.scheduleLocalNotification({ date: new Date(), badge: -1 });
+  }
 });
 ```
 
-**Push notifications:**
+Push notifications:
 ```javascript
 Ti.App.iOS.addEventListener('remotenotificationaction', (e) => {
-    // e.category: category identifier
-    // e.identifier: action identifier
-    // e.data: push notification payload (JSON)
-
-    if (e.category === 'DOWNLOAD_CATEGORY' && e.identifier === 'ACCEPT_IDENTIFIER') {
-        if (e.data && e.data.url) {
-            // Process URL
-        }
+  // e.category: category identifier
+  // e.identifier: action identifier
+  // e.data: push notification payload (JSON)
+
+  if (e.category === 'DOWNLOAD_CATEGORY' && e.identifier === 'ACCEPT_IDENTIFIER') {
+    if (e.data && e.data.url) {
+      // Process URL
     }
+  }
 });
 ```
 
-### Schedule Interactive Local Notification
+### Schedule interactive local notification
 
 ```javascript
 Ti.App.iOS.scheduleLocalNotification({
-    date: new Date(new Date().getTime() + 3000),
-    alertBody: 'New content available! Download now?',
-    badge: 1,
-    userInfo: {url: 'http://example.com/data.json'},
-    category: 'INVITE_CATEGORY'  // Must match registered category identifier
+  date: new Date(new Date().getTime() + 3000),
+  alertBody: 'New content available! Download now?',
+  badge: 1,
+  userInfo: { url: 'http://example.com/data.json' },
+  category: 'INVITE_CATEGORY' // Must match registered category identifier
 });
 ```
 
-### Send Interactive Push Notification
+### Send interactive push notification
 
-**Payload format:**
+Payload format:
 ```json
 {
-    "alert": "New content available! Download now?",
-    "badge": 1,
-    "url": "http://example.com/data.json",
-    "category": "INVITE_CATEGORY"
+  "alert": "New content available! Download now?",
+  "badge": 1,
+  "url": "http://example.com/data.json",
+  "category": "INVITE_CATEGORY"
 }
 ```
 
----
-
-## Push Notifications
+## Push notifications
 
 ### Overview
 
 Push notifications allow server-to-device communication. Infrastructure differs by platform:
 
-- **Android**: Firebase Cloud Messaging (FCM)
-- **iOS**: Apple Push Notification service (APNs)
+- Android: Firebase Cloud Messaging (FCM)
+- iOS: Apple Push Notification service (APNs)
 
-> **Note**: The legacy Appcelerator Cloud Services (ACS/ArrowDB) push backend is no longer available. Use Firebase Cloud Messaging (FCM) for Android and Apple Push Notification service (APNs) for iOS, either directly or through a third-party service.
+Note: the legacy Appcelerator Cloud Services (ACS/ArrowDB) push backend is no longer available. Use FCM for Android and APNs for iOS, either directly or via a third-party service.
 
-> Google has deprecated Google Cloud Messaging (GCM) in favor of Firebase Cloud Messaging (FCM). All new implementations should use FCM.
+Google has deprecated Google Cloud Messaging (GCM) in favor of FCM. All new implementations should use FCM.
 
-For FCM on Titanium, use the community Firebase Cloud Messaging module: `titanium-firebase-cloud-messaging` (by Hans Knöchel).
+For FCM on Titanium, use the community module `titanium-firebase-cloud-messaging` (by Hans Knöchel).
 
-### Register for Push Notifications
+### Register for push notifications
 
 ```javascript
 Ti.Network.registerForPushNotifications({
-    success: (e) => {
-        // e.deviceToken: token to send to your push server
-        Ti.API.info(`Device Token: ${e.deviceToken}`);
-        // Send this token to your server
-    },
-    error: (e) => {
-        Ti.API.error(`Push registration error: ${e.error}`);
-    },
-    callback: (e) => {
-        // Incoming push notification
-        // e.data: push payload (iOS)
-        // e.data: JSON object (Android)
-        Ti.API.info(`Push received: ${JSON.stringify(e.data)}`);
-    }
+  success: (e) => {
+    // e.deviceToken: token to send to your push server
+    Ti.API.info(`Device Token: ${e.deviceToken}`);
+    // Send this token to your server
+  },
+  error: (e) => {
+    Ti.API.error(`Push registration error: ${e.error}`);
+  },
+  callback: (e) => {
+    // Incoming push notification
+    // e.data: push payload (iOS)
+    // e.data: JSON object (Android)
+    Ti.API.info(`Push received: ${JSON.stringify(e.data)}`);
+  }
 });
 ```
 
-### APNs Configuration (iOS)
+### APNs configuration (iOS)
 
-1. Register an **Explicit App ID** (not Wildcard) with Push Notifications enabled in Apple Developer Portal
-2. Generate an APNs certificate (Development for sandbox, Production for App Store)
-3. Export the certificate as PKCS#12 (.p12) from Keychain Access
-4. Upload the .p12 to your push service provider
-5. In your app, call `Ti.Network.registerForPushNotifications()` to get the device token
+1. Register an explicit App ID (not wildcard) with Push Notifications enabled in Apple Developer Portal.
+2. Generate an APNs certificate (Development for sandbox, Production for App Store).
+3. Export the certificate as PKCS#12 (.p12) from Keychain Access.
+4. Upload the .p12 to your push service provider.
+5. In your app, call `Ti.Network.registerForPushNotifications()` to get the device token.
 
-### FCM Configuration (Android)
+### FCM configuration (Android)
 
-1. Create a project in Firebase Console
-2. Add your Android app (use your app's package name)
-3. Download `google-services.json` and place in project root
-4. Add the `titanium-firebase-cloud-messaging` module to tiapp.xml
-5. Register for push and obtain the FCM token
+1. Create a project in Firebase Console.
+2. Add your Android app (use your app's package name).
+3. Download `google-services.json` and place it in the project root.
+4. Add `titanium-firebase-cloud-messaging` to `tiapp.xml`.
+5. Register for push and obtain the FCM token.
 
-### Push Notification Payload Format
+### Push notification payload format
 
-**iOS:**
+iOS:
 ```json
 {
-    "aps": {
-        "alert": "Message text",
-        "badge": 1,
-        "sound": "default"
-    },
-    "custom_field": "custom_value"
+  "aps": {
+    "alert": "Message text",
+    "badge": 1,
+    "sound": "default"
+  },
+  "custom_field": "custom_value"
 }
 ```
 
-**Android:**
+Android:
 ```json
 {
-    "message": "Message text",
-    "title": "Notification Title",
-    "custom_field": "custom_value"
+  "message": "Message text",
+  "title": "Notification Title",
+  "custom_field": "custom_value"
 }
 ```
 
-### Send Push Notifications
+### Send push notifications
 
 Send push notifications from your server using the FCM HTTP API or APNs. Collect device tokens from client registration and target them with your push payload.
 
-### Best Practices
+### Best practices
 
-1. **Permissions**: iOS requires user permission (prompted on first call to `registerForPushNotifications`)
-2. **Device Tokens**: Cache and send to your server; can change on app updates
-3. **Background Handling**: Use proper activation modes for interactive notifications
-4. **Badge Management**: Always reset badge after processing notification
-5. **Error Handling**: Handle registration failures gracefully
-6. **Testing**: Use development certificates/sandbox for testing iOS
+1. Permissions: iOS requires user permission (prompted on first call to `registerForPushNotifications`).
+2. Device tokens: cache and send to your server; they can change on app updates.
+3. Background handling: use proper activation modes for interactive notifications.
+4. Badge management: reset the badge after processing a notification.
+5. Error handling: handle registration failures gracefully.
+6. Testing: use development certificates/sandbox for iOS testing.
 
----
+## Common patterns
 
-## Common Patterns
-
-### Check Notification Permissions
+### Check notification permissions
 
 ```javascript
 // Android 4.1+ can disable notifications per app
 // Check via Settings or handle gracefully (notification may not be shown)
 ```
 
-### PendingIntent for Notification Actions
+### PendingIntent for notification actions
 
 ```javascript
 const intent = Ti.Android.createIntent({
-    action: 'com.example.MY_ACTION',
-    // Add data/flags
+  action: 'com.example.MY_ACTION'
+  // Add data/flags
 });
 const pendingIntent = Ti.Android.createPendingIntent({
-    intent: intent,
-    flags: Ti.Android.FLAG_UPDATE_CURRENT
+  intent: intent,
+  flags: Ti.Android.FLAG_UPDATE_CURRENT
 });
 ```
 
-### Notification Groups (Android 7.0+)
+### Notification groups (Android 7.0+)
 
 ```javascript
 // Requires API 24+; check documentation for latest implementation
 ```
 
-### Rich Notifications (iOS 10+)
+### Rich notifications (iOS 10+)
 
 Use `UNMutableNotificationContent` with attachments (images, video, audio).
 
-### Silent Push
+### Silent push
 
 ```javascript
 // iOS: include "content-available": 1 in payload
 // Android: use data messages (FCM)
 ```
 
----
-
-## Platform-Specific Notes
+## Platform-specific notes
 
 ### Android
 
-- **Service lifecycle**: Services may be killed if app is swiped away. **Warning**: Android services may stop if the app is killed (user backs out or removes from recent apps). For critical notifications, use FCM push notifications instead of local services
-- **Notification channels**: Android 8.0+ requires notification channels
-- **Limitations**: Legacy MapView only supports single map view
+- Service lifecycle: services may be killed if app is swiped away. For critical notifications, use FCM instead of local services.
+- Notification channels: Android 8.0+ requires notification channels.
+- Limitations: legacy MapView only supports a single map view.
 
 ### iOS
 
-- **Sandbox vs Production**: Use correct certificates and endpoints
-- **Background app refresh**: May be needed for certain push scenarios
-- **LiveView**: Callbacks only work properly when LiveView is enabled
+- Sandbox vs production: use correct certificates and endpoints.
+- Background app refresh: may be needed for certain push scenarios.
+- LiveView: callbacks only work properly when LiveView is enabled.