@stacksjs/push 0.70.23 → 0.70.26

package/dist/index.js

@@ -1 +1 @@
-var p=Object.defineProperty;var i=(r,o)=>{for(var t in o)p(r,t,{get:o[t],enumerable:!0,configurable:!0,set:(e)=>o[t]=()=>e})};var n={};i(n,{expoWip:()=>a});var a=1;var s={};i(s,{fcmWip:()=>c});var c=1;export{s as fcm,n as expo};
+var y=Object.defineProperty;var h=(G)=>G;function T(G,J){this[G]=h.bind(null,J)}var C=(G,J)=>{for(var N in J)y(G,N,{get:J[N],enumerable:!0,configurable:!0,set:T.bind(J,N)})};var z={};C(z,{sendBatch:()=>L,send:()=>j,isExpoPushToken:()=>w,getReceipts:()=>E,default:()=>u,Send:()=>j});import{log as X}from"@stacksjs/cli";var d="https://exp.host/--/api/v2/push/send";function w(G){return/^Expo(?:nent)?PushToken\[.+\]$/.test(G)||/^[a-zA-Z0-9-_]+$/.test(G)}async function j(G){let J=Array.isArray(G.to)?G.to:[G.to],N=J.filter((W)=>!w(W));if(N.length>0)X.warn(`Invalid Expo push tokens found: ${N.join(", ")}`);let Q=J.filter(w);if(Q.length===0)return{success:!1,provider:"expo",message:"No valid Expo push tokens provided"};try{let W=Q.map(($)=>({to:$,title:G.title,body:G.body,data:G.data,sound:G.sound??"default",badge:G.badge,channelId:G.channelId,priority:G.priority??"high",ttl:G.ttl})),Z=4096;for(let $ of W){let K=new TextEncoder().encode(JSON.stringify($)).length;if(K>4096)return{success:!1,provider:"expo",message:`Expo message payload (${K} bytes) exceeds 4 KiB per-message limit`}}let q=await fetch(d,{method:"POST",headers:{Accept:"application/json","Accept-Encoding":"gzip, deflate","Content-Type":"application/json"},body:JSON.stringify(W)});if(!q.ok){let $=await q.text();return X.error(`Expo push failed: ${$}`),{success:!1,provider:"expo",message:`HTTP ${q.status}: ${$}`}}let A=(await q.json()).data,V=A.filter(($)=>$.status==="error");if(V.length>0)X.warn(`Some push notifications failed: ${JSON.stringify(V)}`);let I=A.filter(($)=>$.status==="ok").length;return X.info(`Expo push sent: ${I}/${A.length} successful`),{success:V.length===0,provider:"expo",message:`Sent ${I}/${A.length} notifications`,messageId:A.find(($)=>$.id)?.id,data:{tickets:A}}}catch(W){let Z=W instanceof Error?W:Error(String(W));return X.error(`Expo push error: ${Z.message}`),{success:!1,provider:"expo",message:Z.message}}}async function E(G){let J=await fetch("https://exp.host/--/api/v2/push/getReceipts",{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json"},body:JSON.stringify({ids:G})});if(!J.ok)throw Error(`Failed to get receipts: ${J.status}`);return(await J.json()).data}async function L(G,J=100){let N=[];for(let Q=0;Q<G.length;Q+=J){let W=G.slice(Q,Q+J),Z=await Promise.all(W.map((q)=>j(q)));N.push(...Z)}return N}var u={send:j,sendBatch:L,getReceipts:E,isExpoPushToken:w};var B={};C(B,{unsubscribeFromTopic:()=>M,subscribeToTopic:()=>b,sendToTopic:()=>S,sendMulticast:()=>U,sendLegacy:()=>P,send:()=>O,default:()=>f,configure:()=>F,Send:()=>O});import{log as H}from"@stacksjs/cli";var l="https://fcm.googleapis.com/fcm/send",p="https://fcm.googleapis.com/v1/projects",Y={};function F(G){Y={...Y,...G}}async function k(){if(!Y.serviceAccount)throw Error("Service account not configured for FCM v1 API");let{clientEmail:G,privateKey:J}=Y.serviceAccount,N=Math.floor(Date.now()/1000),Q={alg:"RS256",typ:"JWT"},W={iss:G,scope:"https://www.googleapis.com/auth/firebase.messaging",aud:"https://oauth2.googleapis.com/token",iat:N,exp:N+3600},Z=new TextEncoder,q=btoa(JSON.stringify(Q)),D=btoa(JSON.stringify(W)),A=`${q}.${D}`,V=J.replace(/-----BEGIN PRIVATE KEY-----/,"").replace(/-----END PRIVATE KEY-----/,"").replace(/\n/g,""),I=Uint8Array.from(atob(V),(v)=>v.charCodeAt(0)),$=await crypto.subtle.importKey("pkcs8",I,{name:"RSASSA-PKCS1-v1_5",hash:"SHA-256"},!1,["sign"]),K=await crypto.subtle.sign("RSASSA-PKCS1-v1_5",$,Z.encode(A)),R=btoa(String.fromCharCode(...new Uint8Array(K))).replace(/\+/g,"-").replace(/\//g,"_").replace(/=/g,""),x=`${q}.${D}.${R}`,_=await fetch("https://oauth2.googleapis.com/token",{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:`grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer&assertion=${x}`});if(!_.ok)throw Error(`Failed to get access token: ${_.status}`);return(await _.json()).access_token}async function P(G){if(!Y.serverKey)return{success:!1,provider:"fcm",message:"FCM server key not configured"};try{let J=await fetch(l,{method:"POST",headers:{Authorization:`key=${Y.serverKey}`,"Content-Type":"application/json"},body:JSON.stringify({to:G.to,registration_ids:G.registrationIds,topic:G.topic?`/topics/${G.topic}`:void 0,condition:G.condition,notification:G.notification,data:G.data,priority:G.priority??"high",time_to_live:G.ttl,collapse_key:G.collapseKey})});if(!J.ok){let Q=await J.text();return H.error(`FCM push failed: ${Q}`),{success:!1,provider:"fcm",message:`HTTP ${J.status}: ${Q}`}}let N=await J.json();if(N.failure>0)H.warn(`FCM: ${N.failure} notifications failed`);return H.info(`FCM push sent: ${N.success} successful, ${N.failure} failed`),{success:N.failure===0,provider:"fcm",message:`Sent ${N.success} notifications`,messageId:N.results?.[0]?.messageId,data:N}}catch(J){let N=J instanceof Error?J:Error(String(J));return H.error(`FCM push error: ${N.message}`),{success:!1,provider:"fcm",message:N.message}}}async function O(G){if(!Y.serviceAccount||!Y.projectId)return P(G);try{let J=await k(),N=`${p}/${Y.projectId}/messages:send`,Q={message:{notification:G.notification,data:G.data,android:{priority:G.priority??"high",ttl:G.ttl?`${G.ttl}s`:void 0,collapseKey:G.collapseKey},apns:{headers:{"apns-priority":G.priority==="high"?"10":"5"}}}};if(G.to)Q.message.token=G.to;else if(G.topic)Q.message.topic=G.topic;else if(G.condition)Q.message.condition=G.condition;let W=await fetch(N,{method:"POST",headers:{Authorization:`Bearer ${J}`,"Content-Type":"application/json"},body:JSON.stringify(Q)});if(!W.ok){let q=await W.text();return H.error(`FCM v1 push failed: ${q}`),{success:!1,provider:"fcm",message:`HTTP ${W.status}: ${q}`}}let Z=await W.json();return H.info(`FCM v1 push sent: ${Z.name}`),{success:!0,provider:"fcm",message:"Notification sent successfully",messageId:Z.name}}catch(J){let N=J instanceof Error?J:Error(String(J));return H.error(`FCM v1 push error: ${N.message}`),{success:!1,provider:"fcm",message:N.message}}}async function U(G,J){if(Y.serviceAccount&&Y.projectId)return Promise.all(G.map((N)=>O({...J,to:N})));return[await P({...J,registrationIds:G})]}async function S(G,J){return O({...J,topic:G})}async function b(G,J){if(!Y.serverKey)throw Error("FCM server key required for topic subscription");return(await fetch("https://iid.googleapis.com/iid/v1:batchAdd",{method:"POST",headers:{Authorization:`key=${Y.serverKey}`,"Content-Type":"application/json"},body:JSON.stringify({to:`/topics/${J}`,registration_tokens:G})})).ok}async function M(G,J){if(!Y.serverKey)throw Error("FCM server key required for topic unsubscription");return(await fetch("https://iid.googleapis.com/iid/v1:batchRemove",{method:"POST",headers:{Authorization:`key=${Y.serverKey}`,"Content-Type":"application/json"},body:JSON.stringify({to:`/topics/${J}`,registration_tokens:G})})).ok}var f={send:O,sendLegacy:P,sendMulticast:U,sendToTopic:S,subscribeToTopic:b,unsubscribeFromTopic:M,configure:F};async function t(G,J,N={}){let Q=N.driver??"expo";if(Q==="expo")return j({to:G,title:J.title,body:J.body,data:J.data,badge:J.badge,sound:J.sound,priority:J.priority});if(Q==="fcm"){let W=Array.isArray(G)?G:[G];if(W.length===1)return O({to:W[0],notification:{title:J.title??"",body:J.body},data:J.data,priority:J.priority==="default"?"normal":J.priority});let Z=await U(W,{notification:{title:J.title??"",body:J.body},data:J.data,priority:J.priority==="default"?"normal":J.priority});return{success:Z.every((D)=>D.success),provider:"fcm",message:`Sent to ${Z.filter((D)=>D.success).length}/${Z.length} devices`}}return{success:!1,provider:Q,message:`Unknown push driver: ${Q}`}}function n(G){F(G)}export{t as send,B as fcm,z as expo,n as configureFCM};

package/dist/src/drivers/expo.d.ts

@@ -0,0 +1,45 @@
+import type { PushResult } from '@stacksjs/types';
+/**
+ * Validates an Expo push token
+ */
+export declare function isExpoPushToken(token: string): boolean;
+/**
+ * Send a push notification via Expo Push Service
+ */
+export declare function send(message: ExpoPushMessage): Promise<PushResult>;
+/**
+ * Get push notification receipts from Expo
+ */
+export declare function getReceipts(ticketIds: string[]): Promise<Record<string, ExpoPushReceipt>>;
+/**
+ * Send multiple push notifications in chunks (Expo recommends max 100 per request)
+ */
+export declare function sendBatch(messages: ExpoPushMessage[], chunkSize?: number): Promise<PushResult[]>;
+export declare interface ExpoPushMessage {
+  to: string | string[]
+  title?: string
+  body: string
+  data?: Record<string, any>
+  sound?: 'default' | null
+  badge?: number
+  channelId?: string
+  priority?: 'default' | 'normal' | 'high'
+  ttl?: number
+}
+export declare interface ExpoPushTicket {
+  id?: string
+  status: 'ok' | 'error'
+  message?: string
+  details?: {
+    error?: 'DeviceNotRegistered' | 'MessageTooBig' | 'MessageRateExceeded' | 'InvalidCredentials'
+  }
+}
+export declare interface ExpoPushReceipt {
+  status: 'ok' | 'error'
+  message?: string
+  details?: {
+    error?: string
+  }
+}
+export { send as Send };
+export default { send, sendBatch, getReceipts, isExpoPushToken };

package/dist/src/drivers/fcm.d.ts

@@ -0,0 +1,76 @@
+import type { PushResult } from '@stacksjs/types';
+/**
+ * Configure FCM with server key or service account
+ */
+export declare function configure(options: FCMConfig): void;
+/**
+ * Send push notification via FCM Legacy API (using server key)
+ */
+export declare function sendLegacy(message: FCMMessage): Promise<PushResult>;
+/**
+ * Send push notification via FCM v1 API (using service account)
+ */
+export declare function send(message: FCMMessage): Promise<PushResult>;
+/**
+ * Send to multiple tokens
+ */
+export declare function sendMulticast(tokens: string[], message: Omit<FCMMessage, 'to' | 'registrationIds'>): Promise<PushResult[]>;
+/**
+ * Send to a topic
+ */
+export declare function sendToTopic(topic: string, message: Omit<FCMMessage, 'to' | 'registrationIds' | 'topic'>): Promise<PushResult>;
+/**
+ * Subscribe tokens to a topic
+ */
+export declare function subscribeToTopic(tokens: string[], topic: string): Promise<boolean>;
+/**
+ * Unsubscribe tokens from a topic
+ */
+export declare function unsubscribeFromTopic(tokens: string[], topic: string): Promise<boolean>;
+export declare interface FCMMessage {
+  to?: string
+  registrationIds?: string[]
+  topic?: string
+  condition?: string
+  notification?: {
+    title: string
+    body: string
+    icon?: string
+    image?: string
+    sound?: string
+    badge?: string
+    clickAction?: string
+    tag?: string
+  }
+  data?: Record<string, string>
+  priority?: 'high' | 'normal'
+  ttl?: number
+  collapseKey?: string
+}
+export declare interface FCMConfig {
+  serverKey?: string
+  projectId?: string
+  serviceAccount?: {
+    clientEmail: string
+    privateKey: string
+  }
+}
+export declare interface FCMResponse {
+  multicastId?: number
+  success: number
+  failure: number
+  results?: Array<{
+    messageId?: string
+    error?: string
+  }>
+}
+export { send as Send };
+export default {
+  send,
+  sendLegacy,
+  sendMulticast,
+  sendToTopic,
+  subscribeToTopic,
+  unsubscribeFromTopic,
+  configure,
+};

package/dist/src/drivers/index.d.ts

@@ -0,0 +1,2 @@
+export * as expo from './expo';
+export * as fcm from './fcm';

package/dist/src/index.d.ts

@@ -0,0 +1,25 @@
+import * as expo from './drivers/expo';
+import * as fcm from './drivers/fcm';
+import type { PushResult } from '@stacksjs/types';
+/**
+ * Send a push notification using the specified driver
+ */
+export declare function send(to: string | string[], notification: PushNotification, options?: SendOptions): Promise<PushResult>;
+/**
+ * Configure FCM with credentials
+ */
+export declare function configureFCM(config: fcm.FCMConfig): void;
+export declare interface PushNotification {
+  title?: string
+  body: string
+  data?: Record<string, any>
+  badge?: number
+  sound?: 'default' | null
+  priority?: 'high' | 'normal' | 'default'
+}
+export declare interface SendOptions {
+  driver?: PushDriver
+}
+export type PushDriver = 'expo' | 'fcm';
+export * from './drivers';
+export { expo, fcm };

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@stacksjs/push",
   "type": "module",
-  "version": "0.70.23",
+  "version": "0.70.26",
   "description": "The Stacks Push integration",
   "author": "Chris Breuer",
-  "contributors": ["Chris Breuer <chris@stacksjs.org>"],
+  "contributors": [
+    "Chris Breuer <chris@stacksjs.com>"
+  ],
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",
   "homepage": "https://github.com/stacksjs/stacks/tree/main/storage/framework/core/push#readme",
@@ -16,27 +18,37 @@
   "bugs": {
     "url": "https://github.com/stacksjs/stacks/issues"
   },
-  "keywords": ["push", "aws", "stacks"],
+  "keywords": [
+    "push",
+    "aws",
+    "stacks"
+  ],
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
       "import": "./dist/index.js"
     },
     "./*": {
+      "bun": "./src/*",
       "import": "./dist/*"
     }
   },
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["README.md", "dist"],
+  "files": [
+    "README.md",
+    "dist"
+  ],
   "scripts": {
     "build": "bun build.ts",
     "typecheck": "bun tsc --noEmit",
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.70.22",
-    "@stacksjs/config": "0.70.22",
-    "@stacksjs/development": "0.70.22",
-    "@stacksjs/error-handling": "0.70.22"
+    "@stacksjs/cli": "0.70.23",
+    "@stacksjs/config": "0.70.23",
+    "better-dx": "^0.2.12",
+    "@stacksjs/error-handling": "0.70.23"
   }
 }

package/dist/expo.d.ts

@@ -1 +0,0 @@
-export declare const expoWip: 1;

package/dist/fcm.d.ts

@@ -1 +0,0 @@
-export declare const fcmWip: 1;

package/dist/index.d.ts

@@ -1 +0,0 @@
-export * from './drivers'