multivendor-notification 0.0.1

package/dist/index.cjs

@@ -0,0 +1,467 @@
+'use strict';
+
+var app = require('firebase-admin/app');
+var messaging = require('firebase-admin/messaging');
+
+// src/client.ts
+
+// src/errors.ts
+var FcmConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FcmConfigError";
+  }
+};
+var FcmPayloadError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FcmPayloadError";
+  }
+};
+var FcmApiError = class extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "FcmApiError";
+    this.statusCode = options.statusCode;
+    this.errorCode = options.errorCode;
+    this.attemptCount = options.attemptCount ?? 1;
+    this.details = options.details;
+  }
+};
+
+// src/config.ts
+var PEM_HEADER = "-----BEGIN PRIVATE KEY-----";
+var PEM_FOOTER = "-----END PRIVATE KEY-----";
+function normalizePrivateKey(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.includes("\\n")) {
+    return trimmed.replace(/\\n/g, "\n");
+  }
+  return trimmed;
+}
+function isValidPemPrivateKey(key) {
+  const normalized = normalizePrivateKey(key);
+  return normalized.includes(PEM_HEADER) && normalized.includes(PEM_FOOTER);
+}
+function resolveConfig(config) {
+  const projectId = config.projectId?.trim() || "";
+  const clientEmail = config.clientEmail?.trim() || "";
+  const privateKeyRaw = config.privateKey?.trim() || "";
+  if (!projectId) {
+    throw new FcmConfigError("FCM projectId is required");
+  }
+  if (!clientEmail || !clientEmail.includes("@")) {
+    throw new FcmConfigError("FCM clientEmail must be a valid service account email");
+  }
+  if (!privateKeyRaw) {
+    throw new FcmConfigError("FCM privateKey is required");
+  }
+  const privateKey = normalizePrivateKey(privateKeyRaw);
+  if (!isValidPemPrivateKey(privateKey)) {
+    throw new FcmConfigError("FCM privateKey must be a valid PEM private key");
+  }
+  return {
+    projectId,
+    clientEmail,
+    privateKey,
+    retryBackoffMs: config.retryBackoffMs ?? 250,
+    maxPayloadBytes: config.maxPayloadBytes ?? 4096
+  };
+}
+
+// src/validate.ts
+var DEFAULT_TITLE_MAX = 200;
+var DEFAULT_BODY_MAX = 1e3;
+function estimatePayloadBytes(message) {
+  let bytes = 0;
+  const notification = message.notification;
+  if (notification?.title) {
+    bytes += Buffer.byteLength(notification.title, "utf8");
+  }
+  if (notification?.body) {
+    bytes += Buffer.byteLength(notification.body, "utf8");
+  }
+  if (notification?.imageUrl) {
+    bytes += Buffer.byteLength(notification.imageUrl, "utf8");
+  }
+  if (message.data) {
+    for (const [key, value] of Object.entries(message.data)) {
+      bytes += Buffer.byteLength(key, "utf8") + Buffer.byteLength(value, "utf8");
+    }
+  }
+  if (message.collapseKey) {
+    bytes += Buffer.byteLength(message.collapseKey, "utf8");
+  }
+  if (message.messageId) {
+    bytes += Buffer.byteLength(message.messageId, "utf8");
+  }
+  return bytes;
+}
+function validatePayload(message, options = {}) {
+  const maxPayloadBytes = options.maxPayloadBytes ?? 4096;
+  const titleMax = options.titleMax ?? DEFAULT_TITLE_MAX;
+  const bodyMax = options.bodyMax ?? DEFAULT_BODY_MAX;
+  const title = message.notification?.title;
+  const body = message.notification?.body;
+  if (title && title.length > titleMax) {
+    throw new FcmPayloadError(`Notification title exceeds ${titleMax} characters`);
+  }
+  if (body && body.length > bodyMax) {
+    throw new FcmPayloadError(`Notification body exceeds ${bodyMax} characters`);
+  }
+  const estimated = estimatePayloadBytes(message);
+  if (estimated > maxPayloadBytes) {
+    throw new FcmPayloadError(
+      `Push payload estimated at ${estimated} bytes exceeds limit of ${maxPayloadBytes} bytes`
+    );
+  }
+}
+
+// src/batch.ts
+var FCM_MULTICAST_BATCH_SIZE = 500;
+function dedupeTokens(tokens) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const raw of tokens) {
+    const token = raw?.trim();
+    if (!token || seen.has(token)) {
+      continue;
+    }
+    seen.add(token);
+    result.push(token);
+  }
+  return result;
+}
+function chunkTokens(tokens, batchSize = FCM_MULTICAST_BATCH_SIZE) {
+  const chunks = [];
+  for (let i = 0; i < tokens.length; i += batchSize) {
+    chunks.push(tokens.slice(i, i + batchSize));
+  }
+  return chunks;
+}
+function mergeMulticastResults(results) {
+  const merged = {
+    successCount: 0,
+    failureCount: 0,
+    invalidTokens: [],
+    transientFailures: [],
+    tokenFailures: []
+  };
+  const invalidSet = /* @__PURE__ */ new Set();
+  for (const result of results) {
+    merged.successCount += result.successCount;
+    merged.failureCount += result.failureCount;
+    for (const token of result.invalidTokens) {
+      if (!invalidSet.has(token)) {
+        invalidSet.add(token);
+        merged.invalidTokens.push(token);
+      }
+    }
+    merged.transientFailures.push(...result.transientFailures);
+    merged.tokenFailures.push(...result.tokenFailures);
+  }
+  return merged;
+}
+function emptyMulticastResult() {
+  return {
+    successCount: 0,
+    failureCount: 0,
+    invalidTokens: [],
+    transientFailures: [],
+    tokenFailures: []
+  };
+}
+function appendTokenFailure(target, failure) {
+  target.tokenFailures.push(failure);
+  target.failureCount += 1;
+  if (failure.permanent) {
+    target.invalidTokens.push(failure.token);
+  } else {
+    target.transientFailures.push(failure);
+  }
+}
+
+// src/retry.ts
+var PERMANENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "invalid-registration-token",
+  "registration-token-not-registered",
+  "messaging/registration-token-not-registered",
+  "messaging/invalid-registration-token",
+  "not-registered",
+  "permission-denied",
+  "messaging/permission-denied",
+  "sender-id-mismatch",
+  "messaging/sender-id-mismatch",
+  "invalid-argument",
+  "messaging/invalid-argument"
+]);
+var TRANSIENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "unavailable",
+  "messaging/unavailable",
+  "internal",
+  "messaging/internal",
+  "resource-exhausted",
+  "messaging/resource-exhausted",
+  "deadline-exceeded",
+  "messaging/deadline-exceeded"
+]);
+function extractErrorCode(err) {
+  if (!err || typeof err !== "object") {
+    return void 0;
+  }
+  const e = err;
+  return e.code || e.errorInfo?.code;
+}
+function extractMessage(err) {
+  if (err instanceof Error) {
+    return err.message;
+  }
+  return String(err);
+}
+function isPermanentTokenError(err) {
+  const code = (extractErrorCode(err) || "").toLowerCase();
+  if (PERMANENT_ERROR_CODES.has(code)) {
+    return true;
+  }
+  const msg = extractMessage(err).toLowerCase();
+  return msg.includes("not-registered") || msg.includes("invalid-registration-token") || msg.includes("registration-token-not-registered");
+}
+function isTransientError(err) {
+  const code = (extractErrorCode(err) || "").toLowerCase();
+  if (TRANSIENT_ERROR_CODES.has(code)) {
+    return true;
+  }
+  if (!err || typeof err !== "object") {
+    return false;
+  }
+  const e = err;
+  if (typeof e.status === "number" && e.status >= 500) {
+    return true;
+  }
+  const msg = String(e.message || e.code || "").toLowerCase();
+  return msg.includes("timeout") || msg.includes("econnreset") || msg.includes("enotfound") || msg.includes("network") || msg.includes("socket") || msg.includes("unavailable");
+}
+function shouldRetryError(err) {
+  if (isPermanentTokenError(err)) {
+    return false;
+  }
+  return isTransientError(err);
+}
+function classifyTokenError(err) {
+  const errorCode = extractErrorCode(err);
+  const message = extractMessage(err);
+  const permanent = isPermanentTokenError(err) || !isTransientError(err) && !shouldRetryError(err);
+  return { permanent, errorCode, message };
+}
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/client.ts
+function buildAdminMessage(message, token) {
+  const payload = {};
+  if (message.notification) {
+    payload.notification = {
+      title: message.notification.title,
+      body: message.notification.body,
+      imageUrl: message.notification.imageUrl
+    };
+  }
+  if (message.data) {
+    payload.data = message.data;
+  }
+  if (message.webpush) {
+    payload.webpush = message.webpush;
+  }
+  if (message.android) {
+    payload.android = message.android;
+  }
+  if (message.apns) {
+    payload.apns = message.apns;
+  }
+  if (message.collapseKey) {
+    payload.collapseKey = message.collapseKey;
+  }
+  if (token) {
+    payload.token = token;
+  }
+  if (message.ttlSeconds !== void 0) {
+    payload.android = {
+      ...payload.android || {},
+      ttl: message.ttlSeconds * 1e3
+    };
+  }
+  return payload;
+}
+var FcmClient = class {
+  constructor(config, messagingClient, app$1) {
+    this.closed = false;
+    try {
+      this.resolved = resolveConfig(config);
+    } catch (err) {
+      throw new FcmConfigError(err.message);
+    }
+    if (messagingClient) {
+      this.messaging = messagingClient;
+      this.app = app$1 ?? null;
+    } else {
+      const existing = app.getApps().find((a) => a.name === "multivendor-notification");
+      this.app = existing ?? app.initializeApp({
+        credential: app.cert({
+          projectId: this.resolved.projectId,
+          clientEmail: this.resolved.clientEmail,
+          privateKey: this.resolved.privateKey
+        }),
+        projectId: this.resolved.projectId
+      }, "multivendor-notification");
+      this.messaging = messaging.getMessaging(this.app);
+    }
+  }
+  getConfig() {
+    return this.resolved;
+  }
+  async validate() {
+    resolveConfig(this.resolved);
+  }
+  async close() {
+    this.closed = true;
+    if (this.app) {
+      await app.deleteApp(this.app).catch(() => void 0);
+    }
+  }
+  async send(message) {
+    return this.sendToToken({ token: message.token, message });
+  }
+  async sendToToken(params) {
+    this.assertOpen();
+    const token = params.token?.trim();
+    if (!token) {
+      throw new FcmConfigError("FCM token is required");
+    }
+    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });
+    let lastError;
+    const maxAttempts = 2;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const messageId = await this.messaging.send(
+          buildAdminMessage(params.message, token)
+        );
+        return { messageId, attemptCount: attempt };
+      } catch (err) {
+        lastError = err;
+        if (isPermanentTokenFailure(err) || !shouldRetryError(err) || attempt >= maxAttempts) {
+          break;
+        }
+        await sleep(this.resolved.retryBackoffMs);
+      }
+    }
+    const classified = classifyTokenError(lastError);
+    throw new FcmApiError(classified.message, {
+      errorCode: classified.errorCode,
+      attemptCount: maxAttempts,
+      details: lastError
+    });
+  }
+  async sendMulticast(params) {
+    this.assertOpen();
+    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });
+    const uniqueTokens = dedupeTokens(params.tokens);
+    if (uniqueTokens.length === 0) {
+      return emptyMulticastResult();
+    }
+    const chunks = chunkTokens(uniqueTokens);
+    const batchResults = [];
+    for (const batch of chunks) {
+      batchResults.push(await this.sendMulticastBatch(batch, params.message));
+    }
+    return mergeMulticastResults(batchResults);
+  }
+  async sendMulticastBatch(tokens, message) {
+    const result = emptyMulticastResult();
+    let lastBatchError;
+    const maxAttempts = 2;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const response = await this.messaging.sendEachForMulticast({
+          tokens,
+          notification: message.notification ? {
+            title: message.notification.title,
+            body: message.notification.body,
+            imageUrl: message.notification.imageUrl
+          } : void 0,
+          data: message.data,
+          webpush: message.webpush,
+          android: message.android,
+          apns: message.apns
+        });
+        result.successCount += response.successCount;
+        result.failureCount += response.failureCount;
+        response.responses.forEach((res, index) => {
+          if (res.success) {
+            return;
+          }
+          const token = tokens[index];
+          const classified2 = classifyTokenError(res.error);
+          const failure = {
+            token,
+            errorCode: classified2.errorCode,
+            message: classified2.message,
+            permanent: classified2.permanent
+          };
+          appendTokenFailure(result, failure);
+        });
+        return result;
+      } catch (err) {
+        lastBatchError = err;
+        if (!shouldRetryError(err) || attempt >= maxAttempts) {
+          break;
+        }
+        await sleep(this.resolved.retryBackoffMs);
+      }
+    }
+    const classified = classifyTokenError(lastBatchError);
+    if (!classified.permanent && shouldRetryError(lastBatchError)) {
+      for (const token of tokens) {
+        appendTokenFailure(result, {
+          token,
+          errorCode: classified.errorCode,
+          message: classified.message,
+          permanent: false
+        });
+      }
+      return result;
+    }
+    throw new FcmApiError(classified.message, {
+      errorCode: classified.errorCode,
+      attemptCount: maxAttempts,
+      details: lastBatchError
+    });
+  }
+  assertOpen() {
+    if (this.closed) {
+      throw new FcmConfigError("FcmClient is closed");
+    }
+  }
+};
+function isPermanentTokenFailure(err) {
+  return classifyTokenError(err).permanent;
+}
+
+exports.FCM_MULTICAST_BATCH_SIZE = FCM_MULTICAST_BATCH_SIZE;
+exports.FcmApiError = FcmApiError;
+exports.FcmClient = FcmClient;
+exports.FcmConfigError = FcmConfigError;
+exports.FcmPayloadError = FcmPayloadError;
+exports.chunkTokens = chunkTokens;
+exports.classifyTokenError = classifyTokenError;
+exports.dedupeTokens = dedupeTokens;
+exports.estimatePayloadBytes = estimatePayloadBytes;
+exports.isPermanentTokenError = isPermanentTokenError;
+exports.isTransientError = isTransientError;
+exports.isValidPemPrivateKey = isValidPemPrivateKey;
+exports.mergeMulticastResults = mergeMulticastResults;
+exports.resolveConfig = resolveConfig;
+exports.shouldRetryError = shouldRetryError;
+exports.validatePayload = validatePayload;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/validate.ts","../src/batch.ts","../src/retry.ts","../src/client.ts"],"names":["app","getApps","initializeApp","cert","getMessaging","deleteApp","classified"],"mappings":"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","file":"index.cjs","sourcesContent":["export class FcmConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'FcmConfigError';\n  }\n}\n\nexport class FcmPayloadError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'FcmPayloadError';\n  }\n}\n\nexport class FcmApiError extends Error {\n  public readonly statusCode?: number;\n  public readonly errorCode?: string;\n  public readonly attemptCount: number;\n  public readonly details?: unknown;\n\n  constructor(\n    message: string,\n    options: { statusCode?: number; errorCode?: string; attemptCount?: number; details?: unknown } = {},\n  ) {\n    super(message);\n    this.name = 'FcmApiError';\n    this.statusCode = options.statusCode;\n    this.errorCode = options.errorCode;\n    this.attemptCount = options.attemptCount ?? 1;\n    this.details = options.details;\n  }\n}\n","import { FcmConfigError } from './errors';\n\nexport interface FcmConfig {\n  projectId?: string;\n  clientEmail?: string;\n  privateKey?: string;\n  retryBackoffMs?: number;\n  maxPayloadBytes?: number;\n}\n\nexport interface ResolvedFcmConfig {\n  projectId: string;\n  clientEmail: string;\n  privateKey: string;\n  retryBackoffMs: number;\n  maxPayloadBytes: number;\n}\n\nconst PEM_HEADER = '-----BEGIN PRIVATE KEY-----';\nconst PEM_FOOTER = '-----END PRIVATE KEY-----';\n\nfunction normalizePrivateKey(raw: string): string {\n  const trimmed = raw.trim();\n  if (trimmed.includes('\\\\n')) {\n    return trimmed.replace(/\\\\n/g, '\\n');\n  }\n  return trimmed;\n}\n\nexport function isValidPemPrivateKey(key: string): boolean {\n  const normalized = normalizePrivateKey(key);\n  return normalized.includes(PEM_HEADER) && normalized.includes(PEM_FOOTER);\n}\n\nexport function resolveConfig(config: FcmConfig): ResolvedFcmConfig {\n  const projectId = config.projectId?.trim() || '';\n  const clientEmail = config.clientEmail?.trim() || '';\n  const privateKeyRaw = config.privateKey?.trim() || '';\n\n  if (!projectId) {\n    throw new FcmConfigError('FCM projectId is required');\n  }\n  if (!clientEmail || !clientEmail.includes('@')) {\n    throw new FcmConfigError('FCM clientEmail must be a valid service account email');\n  }\n  if (!privateKeyRaw) {\n    throw new FcmConfigError('FCM privateKey is required');\n  }\n\n  const privateKey = normalizePrivateKey(privateKeyRaw);\n  if (!isValidPemPrivateKey(privateKey)) {\n    throw new FcmConfigError('FCM privateKey must be a valid PEM private key');\n  }\n\n  return {\n    projectId,\n    clientEmail,\n    privateKey,\n    retryBackoffMs: config.retryBackoffMs ?? 250,\n    maxPayloadBytes: config.maxPayloadBytes ?? 4096,\n  };\n}\n","import { FcmPayloadError } from './errors';\nimport type { PushMessage } from './types';\n\nconst DEFAULT_TITLE_MAX = 200;\nconst DEFAULT_BODY_MAX = 1000;\n\nexport function estimatePayloadBytes(message: PushMessage): number {\n  let bytes = 0;\n  const notification = message.notification;\n  if (notification?.title) {\n    bytes += Buffer.byteLength(notification.title, 'utf8');\n  }\n  if (notification?.body) {\n    bytes += Buffer.byteLength(notification.body, 'utf8');\n  }\n  if (notification?.imageUrl) {\n    bytes += Buffer.byteLength(notification.imageUrl, 'utf8');\n  }\n  if (message.data) {\n    for (const [key, value] of Object.entries(message.data)) {\n      bytes += Buffer.byteLength(key, 'utf8') + Buffer.byteLength(value, 'utf8');\n    }\n  }\n  if (message.collapseKey) {\n    bytes += Buffer.byteLength(message.collapseKey, 'utf8');\n  }\n  if (message.messageId) {\n    bytes += Buffer.byteLength(message.messageId, 'utf8');\n  }\n  return bytes;\n}\n\nexport function validatePayload(\n  message: PushMessage,\n  options: { maxPayloadBytes?: number; titleMax?: number; bodyMax?: number } = {},\n): void {\n  const maxPayloadBytes = options.maxPayloadBytes ?? 4096;\n  const titleMax = options.titleMax ?? DEFAULT_TITLE_MAX;\n  const bodyMax = options.bodyMax ?? DEFAULT_BODY_MAX;\n\n  const title = message.notification?.title;\n  const body = message.notification?.body;\n\n  if (title && title.length > titleMax) {\n    throw new FcmPayloadError(`Notification title exceeds ${titleMax} characters`);\n  }\n  if (body && body.length > bodyMax) {\n    throw new FcmPayloadError(`Notification body exceeds ${bodyMax} characters`);\n  }\n\n  const estimated = estimatePayloadBytes(message);\n  if (estimated > maxPayloadBytes) {\n    throw new FcmPayloadError(\n      `Push payload estimated at ${estimated} bytes exceeds limit of ${maxPayloadBytes} bytes`,\n    );\n  }\n}\n","import type { MulticastResult, TokenSendFailure } from './types';\n\nexport const FCM_MULTICAST_BATCH_SIZE = 500;\n\nexport function dedupeTokens(tokens: string[]): string[] {\n  const seen = new Set<string>();\n  const result: string[] = [];\n  for (const raw of tokens) {\n    const token = raw?.trim();\n    if (!token || seen.has(token)) {\n      continue;\n    }\n    seen.add(token);\n    result.push(token);\n  }\n  return result;\n}\n\nexport function chunkTokens(tokens: string[], batchSize: number = FCM_MULTICAST_BATCH_SIZE): string[][] {\n  const chunks: string[][] = [];\n  for (let i = 0; i < tokens.length; i += batchSize) {\n    chunks.push(tokens.slice(i, i + batchSize));\n  }\n  return chunks;\n}\n\nexport function mergeMulticastResults(results: MulticastResult[]): MulticastResult {\n  const merged: MulticastResult = {\n    successCount: 0,\n    failureCount: 0,\n    invalidTokens: [],\n    transientFailures: [],\n    tokenFailures: [],\n  };\n\n  const invalidSet = new Set<string>();\n\n  for (const result of results) {\n    merged.successCount += result.successCount;\n    merged.failureCount += result.failureCount;\n    for (const token of result.invalidTokens) {\n      if (!invalidSet.has(token)) {\n        invalidSet.add(token);\n        merged.invalidTokens.push(token);\n      }\n    }\n    merged.transientFailures.push(...result.transientFailures);\n    merged.tokenFailures.push(...result.tokenFailures);\n  }\n\n  return merged;\n}\n\nexport function emptyMulticastResult(): MulticastResult {\n  return {\n    successCount: 0,\n    failureCount: 0,\n    invalidTokens: [],\n    transientFailures: [],\n    tokenFailures: [],\n  };\n}\n\nexport function appendTokenFailure(\n  target: MulticastResult,\n  failure: TokenSendFailure,\n): void {\n  target.tokenFailures.push(failure);\n  target.failureCount += 1;\n  if (failure.permanent) {\n    target.invalidTokens.push(failure.token);\n  } else {\n    target.transientFailures.push(failure);\n  }\n}\n","const PERMANENT_ERROR_CODES = new Set([\n  'invalid-registration-token',\n  'registration-token-not-registered',\n  'messaging/registration-token-not-registered',\n  'messaging/invalid-registration-token',\n  'not-registered',\n  'permission-denied',\n  'messaging/permission-denied',\n  'sender-id-mismatch',\n  'messaging/sender-id-mismatch',\n  'invalid-argument',\n  'messaging/invalid-argument',\n]);\n\nconst TRANSIENT_ERROR_CODES = new Set([\n  'unavailable',\n  'messaging/unavailable',\n  'internal',\n  'messaging/internal',\n  'resource-exhausted',\n  'messaging/resource-exhausted',\n  'deadline-exceeded',\n  'messaging/deadline-exceeded',\n]);\n\nfunction extractErrorCode(err: unknown): string | undefined {\n  if (!err || typeof err !== 'object') {\n    return undefined;\n  }\n  const e = err as { code?: string; errorInfo?: { code?: string } };\n  return e.code || e.errorInfo?.code;\n}\n\nfunction extractMessage(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  return String(err);\n}\n\nexport function isPermanentTokenError(err: unknown): boolean {\n  const code = (extractErrorCode(err) || '').toLowerCase();\n  if (PERMANENT_ERROR_CODES.has(code)) {\n    return true;\n  }\n  const msg = extractMessage(err).toLowerCase();\n  return msg.includes('not-registered')\n    || msg.includes('invalid-registration-token')\n    || msg.includes('registration-token-not-registered');\n}\n\nexport function isTransientError(err: unknown): boolean {\n  const code = (extractErrorCode(err) || '').toLowerCase();\n  if (TRANSIENT_ERROR_CODES.has(code)) {\n    return true;\n  }\n  if (!err || typeof err !== 'object') {\n    return false;\n  }\n  const e = err as { status?: number; message?: string; code?: string };\n  if (typeof e.status === 'number' && e.status >= 500) {\n    return true;\n  }\n  const msg = String(e.message || e.code || '').toLowerCase();\n  return msg.includes('timeout')\n    || msg.includes('econnreset')\n    || msg.includes('enotfound')\n    || msg.includes('network')\n    || msg.includes('socket')\n    || msg.includes('unavailable');\n}\n\nexport function shouldRetryError(err: unknown): boolean {\n  if (isPermanentTokenError(err)) {\n    return false;\n  }\n  return isTransientError(err);\n}\n\nexport function classifyTokenError(err: unknown): { permanent: boolean; errorCode?: string; message: string } {\n  const errorCode = extractErrorCode(err);\n  const message = extractMessage(err);\n  const permanent = isPermanentTokenError(err) || (!isTransientError(err) && !shouldRetryError(err));\n  return { permanent, errorCode, message };\n}\n\nexport async function sleep(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => setTimeout(resolve, ms));\n}\n","import type { Message, Messaging } from 'firebase-admin/messaging';\nimport { initializeApp, cert, getApps, deleteApp, type App } from 'firebase-admin/app';\nimport { getMessaging } from 'firebase-admin/messaging';\nimport { resolveConfig, type FcmConfig, type ResolvedFcmConfig } from './config';\nimport { FcmApiError, FcmConfigError } from './errors';\nimport { validatePayload } from './validate';\nimport {\n  appendTokenFailure,\n  chunkTokens,\n  dedupeTokens,\n  emptyMulticastResult,\n  mergeMulticastResults,\n} from './batch';\nimport {\n  classifyTokenError,\n  shouldRetryError,\n  sleep,\n} from './retry';\nimport type {\n  MulticastResult,\n  PushMessage,\n  SendMulticastParams,\n  SendResult,\n  SendToTokenParams,\n  TokenSendFailure,\n} from './types';\n\nexport type FcmMessagingClient = Pick<Messaging, 'send' | 'sendEachForMulticast'>;\n\nfunction buildAdminMessage(message: PushMessage, token?: string): Record<string, unknown> {\n  const payload: Record<string, unknown> = {};\n  if (message.notification) {\n    payload.notification = {\n      title: message.notification.title,\n      body: message.notification.body,\n      imageUrl: message.notification.imageUrl,\n    };\n  }\n  if (message.data) {\n    payload.data = message.data;\n  }\n  if (message.webpush) {\n    payload.webpush = message.webpush;\n  }\n  if (message.android) {\n    payload.android = message.android;\n  }\n  if (message.apns) {\n    payload.apns = message.apns;\n  }\n  if (message.collapseKey) {\n    payload.collapseKey = message.collapseKey;\n  }\n  if (token) {\n    payload.token = token;\n  }\n  if (message.ttlSeconds !== undefined) {\n    payload.android = {\n      ...(payload.android as Record<string, unknown> || {}),\n      ttl: message.ttlSeconds * 1000,\n    };\n  }\n  return payload;\n}\n\nexport class FcmClient {\n  private readonly resolved: ResolvedFcmConfig;\n  private readonly messaging: FcmMessagingClient;\n  private readonly app: App | null;\n  private closed = false;\n\n  constructor(config: FcmConfig, messagingClient?: FcmMessagingClient, app?: App) {\n    try {\n      this.resolved = resolveConfig(config);\n    } catch (err) {\n      throw new FcmConfigError((err as Error).message);\n    }\n\n    if (messagingClient) {\n      this.messaging = messagingClient;\n      this.app = app ?? null;\n    } else {\n      const existing = getApps().find((a) => a.name === 'multivendor-notification');\n      this.app = existing ?? initializeApp({\n        credential: cert({\n          projectId: this.resolved.projectId,\n          clientEmail: this.resolved.clientEmail,\n          privateKey: this.resolved.privateKey,\n        }),\n        projectId: this.resolved.projectId,\n      }, 'multivendor-notification');\n      this.messaging = getMessaging(this.app);\n    }\n  }\n\n  getConfig(): ResolvedFcmConfig {\n    return this.resolved;\n  }\n\n  async validate(): Promise<void> {\n    resolveConfig(this.resolved);\n  }\n\n  async close(): Promise<void> {\n    this.closed = true;\n    if (this.app) {\n      await deleteApp(this.app).catch(() => undefined);\n    }\n  }\n\n  async send(message: PushMessage & { token: string }): Promise<SendResult> {\n    return this.sendToToken({ token: message.token, message });\n  }\n\n  async sendToToken(params: SendToTokenParams): Promise<SendResult> {\n    this.assertOpen();\n    const token = params.token?.trim();\n    if (!token) {\n      throw new FcmConfigError('FCM token is required');\n    }\n\n    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });\n\n    let lastError: unknown;\n    const maxAttempts = 2;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        const messageId = await this.messaging.send(\n          buildAdminMessage(params.message, token) as unknown as Message,\n        );\n        return { messageId, attemptCount: attempt };\n      } catch (err) {\n        lastError = err;\n        if (isPermanentTokenFailure(err) || !shouldRetryError(err) || attempt >= maxAttempts) {\n          break;\n        }\n        await sleep(this.resolved.retryBackoffMs);\n      }\n    }\n\n    const classified = classifyTokenError(lastError);\n    throw new FcmApiError(classified.message, {\n      errorCode: classified.errorCode,\n      attemptCount: maxAttempts,\n      details: lastError,\n    });\n  }\n\n  async sendMulticast(params: SendMulticastParams): Promise<MulticastResult> {\n    this.assertOpen();\n    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });\n\n    const uniqueTokens = dedupeTokens(params.tokens);\n    if (uniqueTokens.length === 0) {\n      return emptyMulticastResult();\n    }\n\n    const chunks = chunkTokens(uniqueTokens);\n    const batchResults: MulticastResult[] = [];\n\n    for (const batch of chunks) {\n      batchResults.push(await this.sendMulticastBatch(batch, params.message));\n    }\n\n    return mergeMulticastResults(batchResults);\n  }\n\n  private async sendMulticastBatch(tokens: string[], message: PushMessage): Promise<MulticastResult> {\n    const result = emptyMulticastResult();\n\n    let lastBatchError: unknown;\n    const maxAttempts = 2;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        const response = await this.messaging.sendEachForMulticast({\n          tokens,\n          notification: message.notification\n            ? {\n              title: message.notification.title,\n              body: message.notification.body,\n              imageUrl: message.notification.imageUrl,\n            }\n            : undefined,\n          data: message.data,\n          webpush: message.webpush as never,\n          android: message.android as never,\n          apns: message.apns as never,\n        });\n\n        result.successCount += response.successCount;\n        result.failureCount += response.failureCount;\n\n        response.responses.forEach((res, index) => {\n          if (res.success) {\n            return;\n          }\n          const token = tokens[index];\n          const classified = classifyTokenError(res.error);\n          const failure: TokenSendFailure = {\n            token,\n            errorCode: classified.errorCode,\n            message: classified.message,\n            permanent: classified.permanent,\n          };\n          appendTokenFailure(result, failure);\n        });\n\n        return result;\n      } catch (err) {\n        lastBatchError = err;\n        if (!shouldRetryError(err) || attempt >= maxAttempts) {\n          break;\n        }\n        await sleep(this.resolved.retryBackoffMs);\n      }\n    }\n\n    const classified = classifyTokenError(lastBatchError);\n    if (!classified.permanent && shouldRetryError(lastBatchError)) {\n      for (const token of tokens) {\n        appendTokenFailure(result, {\n          token,\n          errorCode: classified.errorCode,\n          message: classified.message,\n          permanent: false,\n        });\n      }\n      return result;\n    }\n\n    throw new FcmApiError(classified.message, {\n      errorCode: classified.errorCode,\n      attemptCount: maxAttempts,\n      details: lastBatchError,\n    });\n  }\n\n  private assertOpen(): void {\n    if (this.closed) {\n      throw new FcmConfigError('FcmClient is closed');\n    }\n  }\n}\n\nfunction isPermanentTokenFailure(err: unknown): boolean {\n  return classifyTokenError(err).permanent;\n}\n"]}

package/dist/index.d.mts

@@ -0,0 +1,122 @@
+import { Messaging } from 'firebase-admin/messaging';
+import { App } from 'firebase-admin/app';
+
+interface FcmConfig {
+    projectId?: string;
+    clientEmail?: string;
+    privateKey?: string;
+    retryBackoffMs?: number;
+    maxPayloadBytes?: number;
+}
+interface ResolvedFcmConfig {
+    projectId: string;
+    clientEmail: string;
+    privateKey: string;
+    retryBackoffMs: number;
+    maxPayloadBytes: number;
+}
+declare function isValidPemPrivateKey(key: string): boolean;
+declare function resolveConfig(config: FcmConfig): ResolvedFcmConfig;
+
+interface PushNotificationPayload {
+    title?: string;
+    body?: string;
+    imageUrl?: string;
+}
+interface PushMessage {
+    notification?: PushNotificationPayload;
+    data?: Record<string, string>;
+    webpush?: Record<string, unknown>;
+    android?: Record<string, unknown>;
+    apns?: Record<string, unknown>;
+    collapseKey?: string;
+    messageId?: string;
+    ttlSeconds?: number;
+    priority?: 'normal' | 'high';
+}
+interface SendToTokenParams {
+    token: string;
+    message: PushMessage;
+}
+interface SendMulticastParams {
+    tokens: string[];
+    message: PushMessage;
+}
+interface SendResult {
+    messageId: string;
+    attemptCount: number;
+}
+interface TokenSendFailure {
+    token: string;
+    errorCode?: string;
+    message: string;
+    permanent: boolean;
+}
+interface MulticastResult {
+    successCount: number;
+    failureCount: number;
+    invalidTokens: string[];
+    transientFailures: TokenSendFailure[];
+    tokenFailures: TokenSendFailure[];
+}
+
+type FcmMessagingClient = Pick<Messaging, 'send' | 'sendEachForMulticast'>;
+declare class FcmClient {
+    private readonly resolved;
+    private readonly messaging;
+    private readonly app;
+    private closed;
+    constructor(config: FcmConfig, messagingClient?: FcmMessagingClient, app?: App);
+    getConfig(): ResolvedFcmConfig;
+    validate(): Promise<void>;
+    close(): Promise<void>;
+    send(message: PushMessage & {
+        token: string;
+    }): Promise<SendResult>;
+    sendToToken(params: SendToTokenParams): Promise<SendResult>;
+    sendMulticast(params: SendMulticastParams): Promise<MulticastResult>;
+    private sendMulticastBatch;
+    private assertOpen;
+}
+
+declare class FcmConfigError extends Error {
+    constructor(message: string);
+}
+declare class FcmPayloadError extends Error {
+    constructor(message: string);
+}
+declare class FcmApiError extends Error {
+    readonly statusCode?: number;
+    readonly errorCode?: string;
+    readonly attemptCount: number;
+    readonly details?: unknown;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        errorCode?: string;
+        attemptCount?: number;
+        details?: unknown;
+    });
+}
+
+declare function estimatePayloadBytes(message: PushMessage): number;
+declare function validatePayload(message: PushMessage, options?: {
+    maxPayloadBytes?: number;
+    titleMax?: number;
+    bodyMax?: number;
+}): void;
+
+declare function isPermanentTokenError(err: unknown): boolean;
+declare function isTransientError(err: unknown): boolean;
+declare function shouldRetryError(err: unknown): boolean;
+declare function classifyTokenError(err: unknown): {
+    permanent: boolean;
+    errorCode?: string;
+    message: string;
+};
+
+declare const FCM_MULTICAST_BATCH_SIZE = 500;
+declare function dedupeTokens(tokens: string[]): string[];
+declare function chunkTokens(tokens: string[], batchSize?: number): string[][];
+declare function mergeMulticastResults(results: MulticastResult[]): MulticastResult;
+
+export { FCM_MULTICAST_BATCH_SIZE, FcmApiError, FcmClient, type FcmConfig, FcmConfigError, type FcmMessagingClient, FcmPayloadError, type MulticastResult, type PushMessage, type PushNotificationPayload, type ResolvedFcmConfig, type SendMulticastParams, type SendResult, type SendToTokenParams, type TokenSendFailure, chunkTokens, classifyTokenError, dedupeTokens, estimatePayloadBytes, isPermanentTokenError, isTransientError, isValidPemPrivateKey, mergeMulticastResults, resolveConfig, shouldRetryError, validatePayload };

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+import { Messaging } from 'firebase-admin/messaging';
+import { App } from 'firebase-admin/app';
+
+interface FcmConfig {
+    projectId?: string;
+    clientEmail?: string;
+    privateKey?: string;
+    retryBackoffMs?: number;
+    maxPayloadBytes?: number;
+}
+interface ResolvedFcmConfig {
+    projectId: string;
+    clientEmail: string;
+    privateKey: string;
+    retryBackoffMs: number;
+    maxPayloadBytes: number;
+}
+declare function isValidPemPrivateKey(key: string): boolean;
+declare function resolveConfig(config: FcmConfig): ResolvedFcmConfig;
+
+interface PushNotificationPayload {
+    title?: string;
+    body?: string;
+    imageUrl?: string;
+}
+interface PushMessage {
+    notification?: PushNotificationPayload;
+    data?: Record<string, string>;
+    webpush?: Record<string, unknown>;
+    android?: Record<string, unknown>;
+    apns?: Record<string, unknown>;
+    collapseKey?: string;
+    messageId?: string;
+    ttlSeconds?: number;
+    priority?: 'normal' | 'high';
+}
+interface SendToTokenParams {
+    token: string;
+    message: PushMessage;
+}
+interface SendMulticastParams {
+    tokens: string[];
+    message: PushMessage;
+}
+interface SendResult {
+    messageId: string;
+    attemptCount: number;
+}
+interface TokenSendFailure {
+    token: string;
+    errorCode?: string;
+    message: string;
+    permanent: boolean;
+}
+interface MulticastResult {
+    successCount: number;
+    failureCount: number;
+    invalidTokens: string[];
+    transientFailures: TokenSendFailure[];
+    tokenFailures: TokenSendFailure[];
+}
+
+type FcmMessagingClient = Pick<Messaging, 'send' | 'sendEachForMulticast'>;
+declare class FcmClient {
+    private readonly resolved;
+    private readonly messaging;
+    private readonly app;
+    private closed;
+    constructor(config: FcmConfig, messagingClient?: FcmMessagingClient, app?: App);
+    getConfig(): ResolvedFcmConfig;
+    validate(): Promise<void>;
+    close(): Promise<void>;
+    send(message: PushMessage & {
+        token: string;
+    }): Promise<SendResult>;
+    sendToToken(params: SendToTokenParams): Promise<SendResult>;
+    sendMulticast(params: SendMulticastParams): Promise<MulticastResult>;
+    private sendMulticastBatch;
+    private assertOpen;
+}
+
+declare class FcmConfigError extends Error {
+    constructor(message: string);
+}
+declare class FcmPayloadError extends Error {
+    constructor(message: string);
+}
+declare class FcmApiError extends Error {
+    readonly statusCode?: number;
+    readonly errorCode?: string;
+    readonly attemptCount: number;
+    readonly details?: unknown;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        errorCode?: string;
+        attemptCount?: number;
+        details?: unknown;
+    });
+}
+
+declare function estimatePayloadBytes(message: PushMessage): number;
+declare function validatePayload(message: PushMessage, options?: {
+    maxPayloadBytes?: number;
+    titleMax?: number;
+    bodyMax?: number;
+}): void;
+
+declare function isPermanentTokenError(err: unknown): boolean;
+declare function isTransientError(err: unknown): boolean;
+declare function shouldRetryError(err: unknown): boolean;
+declare function classifyTokenError(err: unknown): {
+    permanent: boolean;
+    errorCode?: string;
+    message: string;
+};
+
+declare const FCM_MULTICAST_BATCH_SIZE = 500;
+declare function dedupeTokens(tokens: string[]): string[];
+declare function chunkTokens(tokens: string[], batchSize?: number): string[][];
+declare function mergeMulticastResults(results: MulticastResult[]): MulticastResult;
+
+export { FCM_MULTICAST_BATCH_SIZE, FcmApiError, FcmClient, type FcmConfig, FcmConfigError, type FcmMessagingClient, FcmPayloadError, type MulticastResult, type PushMessage, type PushNotificationPayload, type ResolvedFcmConfig, type SendMulticastParams, type SendResult, type SendToTokenParams, type TokenSendFailure, chunkTokens, classifyTokenError, dedupeTokens, estimatePayloadBytes, isPermanentTokenError, isTransientError, isValidPemPrivateKey, mergeMulticastResults, resolveConfig, shouldRetryError, validatePayload };

package/dist/index.js

@@ -0,0 +1,450 @@
+import { getApps, initializeApp, cert, deleteApp } from 'firebase-admin/app';
+import { getMessaging } from 'firebase-admin/messaging';
+
+// src/client.ts
+
+// src/errors.ts
+var FcmConfigError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FcmConfigError";
+  }
+};
+var FcmPayloadError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FcmPayloadError";
+  }
+};
+var FcmApiError = class extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "FcmApiError";
+    this.statusCode = options.statusCode;
+    this.errorCode = options.errorCode;
+    this.attemptCount = options.attemptCount ?? 1;
+    this.details = options.details;
+  }
+};
+
+// src/config.ts
+var PEM_HEADER = "-----BEGIN PRIVATE KEY-----";
+var PEM_FOOTER = "-----END PRIVATE KEY-----";
+function normalizePrivateKey(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.includes("\\n")) {
+    return trimmed.replace(/\\n/g, "\n");
+  }
+  return trimmed;
+}
+function isValidPemPrivateKey(key) {
+  const normalized = normalizePrivateKey(key);
+  return normalized.includes(PEM_HEADER) && normalized.includes(PEM_FOOTER);
+}
+function resolveConfig(config) {
+  const projectId = config.projectId?.trim() || "";
+  const clientEmail = config.clientEmail?.trim() || "";
+  const privateKeyRaw = config.privateKey?.trim() || "";
+  if (!projectId) {
+    throw new FcmConfigError("FCM projectId is required");
+  }
+  if (!clientEmail || !clientEmail.includes("@")) {
+    throw new FcmConfigError("FCM clientEmail must be a valid service account email");
+  }
+  if (!privateKeyRaw) {
+    throw new FcmConfigError("FCM privateKey is required");
+  }
+  const privateKey = normalizePrivateKey(privateKeyRaw);
+  if (!isValidPemPrivateKey(privateKey)) {
+    throw new FcmConfigError("FCM privateKey must be a valid PEM private key");
+  }
+  return {
+    projectId,
+    clientEmail,
+    privateKey,
+    retryBackoffMs: config.retryBackoffMs ?? 250,
+    maxPayloadBytes: config.maxPayloadBytes ?? 4096
+  };
+}
+
+// src/validate.ts
+var DEFAULT_TITLE_MAX = 200;
+var DEFAULT_BODY_MAX = 1e3;
+function estimatePayloadBytes(message) {
+  let bytes = 0;
+  const notification = message.notification;
+  if (notification?.title) {
+    bytes += Buffer.byteLength(notification.title, "utf8");
+  }
+  if (notification?.body) {
+    bytes += Buffer.byteLength(notification.body, "utf8");
+  }
+  if (notification?.imageUrl) {
+    bytes += Buffer.byteLength(notification.imageUrl, "utf8");
+  }
+  if (message.data) {
+    for (const [key, value] of Object.entries(message.data)) {
+      bytes += Buffer.byteLength(key, "utf8") + Buffer.byteLength(value, "utf8");
+    }
+  }
+  if (message.collapseKey) {
+    bytes += Buffer.byteLength(message.collapseKey, "utf8");
+  }
+  if (message.messageId) {
+    bytes += Buffer.byteLength(message.messageId, "utf8");
+  }
+  return bytes;
+}
+function validatePayload(message, options = {}) {
+  const maxPayloadBytes = options.maxPayloadBytes ?? 4096;
+  const titleMax = options.titleMax ?? DEFAULT_TITLE_MAX;
+  const bodyMax = options.bodyMax ?? DEFAULT_BODY_MAX;
+  const title = message.notification?.title;
+  const body = message.notification?.body;
+  if (title && title.length > titleMax) {
+    throw new FcmPayloadError(`Notification title exceeds ${titleMax} characters`);
+  }
+  if (body && body.length > bodyMax) {
+    throw new FcmPayloadError(`Notification body exceeds ${bodyMax} characters`);
+  }
+  const estimated = estimatePayloadBytes(message);
+  if (estimated > maxPayloadBytes) {
+    throw new FcmPayloadError(
+      `Push payload estimated at ${estimated} bytes exceeds limit of ${maxPayloadBytes} bytes`
+    );
+  }
+}
+
+// src/batch.ts
+var FCM_MULTICAST_BATCH_SIZE = 500;
+function dedupeTokens(tokens) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const raw of tokens) {
+    const token = raw?.trim();
+    if (!token || seen.has(token)) {
+      continue;
+    }
+    seen.add(token);
+    result.push(token);
+  }
+  return result;
+}
+function chunkTokens(tokens, batchSize = FCM_MULTICAST_BATCH_SIZE) {
+  const chunks = [];
+  for (let i = 0; i < tokens.length; i += batchSize) {
+    chunks.push(tokens.slice(i, i + batchSize));
+  }
+  return chunks;
+}
+function mergeMulticastResults(results) {
+  const merged = {
+    successCount: 0,
+    failureCount: 0,
+    invalidTokens: [],
+    transientFailures: [],
+    tokenFailures: []
+  };
+  const invalidSet = /* @__PURE__ */ new Set();
+  for (const result of results) {
+    merged.successCount += result.successCount;
+    merged.failureCount += result.failureCount;
+    for (const token of result.invalidTokens) {
+      if (!invalidSet.has(token)) {
+        invalidSet.add(token);
+        merged.invalidTokens.push(token);
+      }
+    }
+    merged.transientFailures.push(...result.transientFailures);
+    merged.tokenFailures.push(...result.tokenFailures);
+  }
+  return merged;
+}
+function emptyMulticastResult() {
+  return {
+    successCount: 0,
+    failureCount: 0,
+    invalidTokens: [],
+    transientFailures: [],
+    tokenFailures: []
+  };
+}
+function appendTokenFailure(target, failure) {
+  target.tokenFailures.push(failure);
+  target.failureCount += 1;
+  if (failure.permanent) {
+    target.invalidTokens.push(failure.token);
+  } else {
+    target.transientFailures.push(failure);
+  }
+}
+
+// src/retry.ts
+var PERMANENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "invalid-registration-token",
+  "registration-token-not-registered",
+  "messaging/registration-token-not-registered",
+  "messaging/invalid-registration-token",
+  "not-registered",
+  "permission-denied",
+  "messaging/permission-denied",
+  "sender-id-mismatch",
+  "messaging/sender-id-mismatch",
+  "invalid-argument",
+  "messaging/invalid-argument"
+]);
+var TRANSIENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "unavailable",
+  "messaging/unavailable",
+  "internal",
+  "messaging/internal",
+  "resource-exhausted",
+  "messaging/resource-exhausted",
+  "deadline-exceeded",
+  "messaging/deadline-exceeded"
+]);
+function extractErrorCode(err) {
+  if (!err || typeof err !== "object") {
+    return void 0;
+  }
+  const e = err;
+  return e.code || e.errorInfo?.code;
+}
+function extractMessage(err) {
+  if (err instanceof Error) {
+    return err.message;
+  }
+  return String(err);
+}
+function isPermanentTokenError(err) {
+  const code = (extractErrorCode(err) || "").toLowerCase();
+  if (PERMANENT_ERROR_CODES.has(code)) {
+    return true;
+  }
+  const msg = extractMessage(err).toLowerCase();
+  return msg.includes("not-registered") || msg.includes("invalid-registration-token") || msg.includes("registration-token-not-registered");
+}
+function isTransientError(err) {
+  const code = (extractErrorCode(err) || "").toLowerCase();
+  if (TRANSIENT_ERROR_CODES.has(code)) {
+    return true;
+  }
+  if (!err || typeof err !== "object") {
+    return false;
+  }
+  const e = err;
+  if (typeof e.status === "number" && e.status >= 500) {
+    return true;
+  }
+  const msg = String(e.message || e.code || "").toLowerCase();
+  return msg.includes("timeout") || msg.includes("econnreset") || msg.includes("enotfound") || msg.includes("network") || msg.includes("socket") || msg.includes("unavailable");
+}
+function shouldRetryError(err) {
+  if (isPermanentTokenError(err)) {
+    return false;
+  }
+  return isTransientError(err);
+}
+function classifyTokenError(err) {
+  const errorCode = extractErrorCode(err);
+  const message = extractMessage(err);
+  const permanent = isPermanentTokenError(err) || !isTransientError(err) && !shouldRetryError(err);
+  return { permanent, errorCode, message };
+}
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/client.ts
+function buildAdminMessage(message, token) {
+  const payload = {};
+  if (message.notification) {
+    payload.notification = {
+      title: message.notification.title,
+      body: message.notification.body,
+      imageUrl: message.notification.imageUrl
+    };
+  }
+  if (message.data) {
+    payload.data = message.data;
+  }
+  if (message.webpush) {
+    payload.webpush = message.webpush;
+  }
+  if (message.android) {
+    payload.android = message.android;
+  }
+  if (message.apns) {
+    payload.apns = message.apns;
+  }
+  if (message.collapseKey) {
+    payload.collapseKey = message.collapseKey;
+  }
+  if (token) {
+    payload.token = token;
+  }
+  if (message.ttlSeconds !== void 0) {
+    payload.android = {
+      ...payload.android || {},
+      ttl: message.ttlSeconds * 1e3
+    };
+  }
+  return payload;
+}
+var FcmClient = class {
+  constructor(config, messagingClient, app) {
+    this.closed = false;
+    try {
+      this.resolved = resolveConfig(config);
+    } catch (err) {
+      throw new FcmConfigError(err.message);
+    }
+    if (messagingClient) {
+      this.messaging = messagingClient;
+      this.app = app ?? null;
+    } else {
+      const existing = getApps().find((a) => a.name === "multivendor-notification");
+      this.app = existing ?? initializeApp({
+        credential: cert({
+          projectId: this.resolved.projectId,
+          clientEmail: this.resolved.clientEmail,
+          privateKey: this.resolved.privateKey
+        }),
+        projectId: this.resolved.projectId
+      }, "multivendor-notification");
+      this.messaging = getMessaging(this.app);
+    }
+  }
+  getConfig() {
+    return this.resolved;
+  }
+  async validate() {
+    resolveConfig(this.resolved);
+  }
+  async close() {
+    this.closed = true;
+    if (this.app) {
+      await deleteApp(this.app).catch(() => void 0);
+    }
+  }
+  async send(message) {
+    return this.sendToToken({ token: message.token, message });
+  }
+  async sendToToken(params) {
+    this.assertOpen();
+    const token = params.token?.trim();
+    if (!token) {
+      throw new FcmConfigError("FCM token is required");
+    }
+    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });
+    let lastError;
+    const maxAttempts = 2;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const messageId = await this.messaging.send(
+          buildAdminMessage(params.message, token)
+        );
+        return { messageId, attemptCount: attempt };
+      } catch (err) {
+        lastError = err;
+        if (isPermanentTokenFailure(err) || !shouldRetryError(err) || attempt >= maxAttempts) {
+          break;
+        }
+        await sleep(this.resolved.retryBackoffMs);
+      }
+    }
+    const classified = classifyTokenError(lastError);
+    throw new FcmApiError(classified.message, {
+      errorCode: classified.errorCode,
+      attemptCount: maxAttempts,
+      details: lastError
+    });
+  }
+  async sendMulticast(params) {
+    this.assertOpen();
+    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });
+    const uniqueTokens = dedupeTokens(params.tokens);
+    if (uniqueTokens.length === 0) {
+      return emptyMulticastResult();
+    }
+    const chunks = chunkTokens(uniqueTokens);
+    const batchResults = [];
+    for (const batch of chunks) {
+      batchResults.push(await this.sendMulticastBatch(batch, params.message));
+    }
+    return mergeMulticastResults(batchResults);
+  }
+  async sendMulticastBatch(tokens, message) {
+    const result = emptyMulticastResult();
+    let lastBatchError;
+    const maxAttempts = 2;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const response = await this.messaging.sendEachForMulticast({
+          tokens,
+          notification: message.notification ? {
+            title: message.notification.title,
+            body: message.notification.body,
+            imageUrl: message.notification.imageUrl
+          } : void 0,
+          data: message.data,
+          webpush: message.webpush,
+          android: message.android,
+          apns: message.apns
+        });
+        result.successCount += response.successCount;
+        result.failureCount += response.failureCount;
+        response.responses.forEach((res, index) => {
+          if (res.success) {
+            return;
+          }
+          const token = tokens[index];
+          const classified2 = classifyTokenError(res.error);
+          const failure = {
+            token,
+            errorCode: classified2.errorCode,
+            message: classified2.message,
+            permanent: classified2.permanent
+          };
+          appendTokenFailure(result, failure);
+        });
+        return result;
+      } catch (err) {
+        lastBatchError = err;
+        if (!shouldRetryError(err) || attempt >= maxAttempts) {
+          break;
+        }
+        await sleep(this.resolved.retryBackoffMs);
+      }
+    }
+    const classified = classifyTokenError(lastBatchError);
+    if (!classified.permanent && shouldRetryError(lastBatchError)) {
+      for (const token of tokens) {
+        appendTokenFailure(result, {
+          token,
+          errorCode: classified.errorCode,
+          message: classified.message,
+          permanent: false
+        });
+      }
+      return result;
+    }
+    throw new FcmApiError(classified.message, {
+      errorCode: classified.errorCode,
+      attemptCount: maxAttempts,
+      details: lastBatchError
+    });
+  }
+  assertOpen() {
+    if (this.closed) {
+      throw new FcmConfigError("FcmClient is closed");
+    }
+  }
+};
+function isPermanentTokenFailure(err) {
+  return classifyTokenError(err).permanent;
+}
+
+export { FCM_MULTICAST_BATCH_SIZE, FcmApiError, FcmClient, FcmConfigError, FcmPayloadError, chunkTokens, classifyTokenError, dedupeTokens, estimatePayloadBytes, isPermanentTokenError, isTransientError, isValidPemPrivateKey, mergeMulticastResults, resolveConfig, shouldRetryError, validatePayload };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/config.ts","../src/validate.ts","../src/batch.ts","../src/retry.ts","../src/client.ts"],"names":["classified"],"mappings":"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","file":"index.js","sourcesContent":["export class FcmConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'FcmConfigError';\n  }\n}\n\nexport class FcmPayloadError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'FcmPayloadError';\n  }\n}\n\nexport class FcmApiError extends Error {\n  public readonly statusCode?: number;\n  public readonly errorCode?: string;\n  public readonly attemptCount: number;\n  public readonly details?: unknown;\n\n  constructor(\n    message: string,\n    options: { statusCode?: number; errorCode?: string; attemptCount?: number; details?: unknown } = {},\n  ) {\n    super(message);\n    this.name = 'FcmApiError';\n    this.statusCode = options.statusCode;\n    this.errorCode = options.errorCode;\n    this.attemptCount = options.attemptCount ?? 1;\n    this.details = options.details;\n  }\n}\n","import { FcmConfigError } from './errors';\n\nexport interface FcmConfig {\n  projectId?: string;\n  clientEmail?: string;\n  privateKey?: string;\n  retryBackoffMs?: number;\n  maxPayloadBytes?: number;\n}\n\nexport interface ResolvedFcmConfig {\n  projectId: string;\n  clientEmail: string;\n  privateKey: string;\n  retryBackoffMs: number;\n  maxPayloadBytes: number;\n}\n\nconst PEM_HEADER = '-----BEGIN PRIVATE KEY-----';\nconst PEM_FOOTER = '-----END PRIVATE KEY-----';\n\nfunction normalizePrivateKey(raw: string): string {\n  const trimmed = raw.trim();\n  if (trimmed.includes('\\\\n')) {\n    return trimmed.replace(/\\\\n/g, '\\n');\n  }\n  return trimmed;\n}\n\nexport function isValidPemPrivateKey(key: string): boolean {\n  const normalized = normalizePrivateKey(key);\n  return normalized.includes(PEM_HEADER) && normalized.includes(PEM_FOOTER);\n}\n\nexport function resolveConfig(config: FcmConfig): ResolvedFcmConfig {\n  const projectId = config.projectId?.trim() || '';\n  const clientEmail = config.clientEmail?.trim() || '';\n  const privateKeyRaw = config.privateKey?.trim() || '';\n\n  if (!projectId) {\n    throw new FcmConfigError('FCM projectId is required');\n  }\n  if (!clientEmail || !clientEmail.includes('@')) {\n    throw new FcmConfigError('FCM clientEmail must be a valid service account email');\n  }\n  if (!privateKeyRaw) {\n    throw new FcmConfigError('FCM privateKey is required');\n  }\n\n  const privateKey = normalizePrivateKey(privateKeyRaw);\n  if (!isValidPemPrivateKey(privateKey)) {\n    throw new FcmConfigError('FCM privateKey must be a valid PEM private key');\n  }\n\n  return {\n    projectId,\n    clientEmail,\n    privateKey,\n    retryBackoffMs: config.retryBackoffMs ?? 250,\n    maxPayloadBytes: config.maxPayloadBytes ?? 4096,\n  };\n}\n","import { FcmPayloadError } from './errors';\nimport type { PushMessage } from './types';\n\nconst DEFAULT_TITLE_MAX = 200;\nconst DEFAULT_BODY_MAX = 1000;\n\nexport function estimatePayloadBytes(message: PushMessage): number {\n  let bytes = 0;\n  const notification = message.notification;\n  if (notification?.title) {\n    bytes += Buffer.byteLength(notification.title, 'utf8');\n  }\n  if (notification?.body) {\n    bytes += Buffer.byteLength(notification.body, 'utf8');\n  }\n  if (notification?.imageUrl) {\n    bytes += Buffer.byteLength(notification.imageUrl, 'utf8');\n  }\n  if (message.data) {\n    for (const [key, value] of Object.entries(message.data)) {\n      bytes += Buffer.byteLength(key, 'utf8') + Buffer.byteLength(value, 'utf8');\n    }\n  }\n  if (message.collapseKey) {\n    bytes += Buffer.byteLength(message.collapseKey, 'utf8');\n  }\n  if (message.messageId) {\n    bytes += Buffer.byteLength(message.messageId, 'utf8');\n  }\n  return bytes;\n}\n\nexport function validatePayload(\n  message: PushMessage,\n  options: { maxPayloadBytes?: number; titleMax?: number; bodyMax?: number } = {},\n): void {\n  const maxPayloadBytes = options.maxPayloadBytes ?? 4096;\n  const titleMax = options.titleMax ?? DEFAULT_TITLE_MAX;\n  const bodyMax = options.bodyMax ?? DEFAULT_BODY_MAX;\n\n  const title = message.notification?.title;\n  const body = message.notification?.body;\n\n  if (title && title.length > titleMax) {\n    throw new FcmPayloadError(`Notification title exceeds ${titleMax} characters`);\n  }\n  if (body && body.length > bodyMax) {\n    throw new FcmPayloadError(`Notification body exceeds ${bodyMax} characters`);\n  }\n\n  const estimated = estimatePayloadBytes(message);\n  if (estimated > maxPayloadBytes) {\n    throw new FcmPayloadError(\n      `Push payload estimated at ${estimated} bytes exceeds limit of ${maxPayloadBytes} bytes`,\n    );\n  }\n}\n","import type { MulticastResult, TokenSendFailure } from './types';\n\nexport const FCM_MULTICAST_BATCH_SIZE = 500;\n\nexport function dedupeTokens(tokens: string[]): string[] {\n  const seen = new Set<string>();\n  const result: string[] = [];\n  for (const raw of tokens) {\n    const token = raw?.trim();\n    if (!token || seen.has(token)) {\n      continue;\n    }\n    seen.add(token);\n    result.push(token);\n  }\n  return result;\n}\n\nexport function chunkTokens(tokens: string[], batchSize: number = FCM_MULTICAST_BATCH_SIZE): string[][] {\n  const chunks: string[][] = [];\n  for (let i = 0; i < tokens.length; i += batchSize) {\n    chunks.push(tokens.slice(i, i + batchSize));\n  }\n  return chunks;\n}\n\nexport function mergeMulticastResults(results: MulticastResult[]): MulticastResult {\n  const merged: MulticastResult = {\n    successCount: 0,\n    failureCount: 0,\n    invalidTokens: [],\n    transientFailures: [],\n    tokenFailures: [],\n  };\n\n  const invalidSet = new Set<string>();\n\n  for (const result of results) {\n    merged.successCount += result.successCount;\n    merged.failureCount += result.failureCount;\n    for (const token of result.invalidTokens) {\n      if (!invalidSet.has(token)) {\n        invalidSet.add(token);\n        merged.invalidTokens.push(token);\n      }\n    }\n    merged.transientFailures.push(...result.transientFailures);\n    merged.tokenFailures.push(...result.tokenFailures);\n  }\n\n  return merged;\n}\n\nexport function emptyMulticastResult(): MulticastResult {\n  return {\n    successCount: 0,\n    failureCount: 0,\n    invalidTokens: [],\n    transientFailures: [],\n    tokenFailures: [],\n  };\n}\n\nexport function appendTokenFailure(\n  target: MulticastResult,\n  failure: TokenSendFailure,\n): void {\n  target.tokenFailures.push(failure);\n  target.failureCount += 1;\n  if (failure.permanent) {\n    target.invalidTokens.push(failure.token);\n  } else {\n    target.transientFailures.push(failure);\n  }\n}\n","const PERMANENT_ERROR_CODES = new Set([\n  'invalid-registration-token',\n  'registration-token-not-registered',\n  'messaging/registration-token-not-registered',\n  'messaging/invalid-registration-token',\n  'not-registered',\n  'permission-denied',\n  'messaging/permission-denied',\n  'sender-id-mismatch',\n  'messaging/sender-id-mismatch',\n  'invalid-argument',\n  'messaging/invalid-argument',\n]);\n\nconst TRANSIENT_ERROR_CODES = new Set([\n  'unavailable',\n  'messaging/unavailable',\n  'internal',\n  'messaging/internal',\n  'resource-exhausted',\n  'messaging/resource-exhausted',\n  'deadline-exceeded',\n  'messaging/deadline-exceeded',\n]);\n\nfunction extractErrorCode(err: unknown): string | undefined {\n  if (!err || typeof err !== 'object') {\n    return undefined;\n  }\n  const e = err as { code?: string; errorInfo?: { code?: string } };\n  return e.code || e.errorInfo?.code;\n}\n\nfunction extractMessage(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  return String(err);\n}\n\nexport function isPermanentTokenError(err: unknown): boolean {\n  const code = (extractErrorCode(err) || '').toLowerCase();\n  if (PERMANENT_ERROR_CODES.has(code)) {\n    return true;\n  }\n  const msg = extractMessage(err).toLowerCase();\n  return msg.includes('not-registered')\n    || msg.includes('invalid-registration-token')\n    || msg.includes('registration-token-not-registered');\n}\n\nexport function isTransientError(err: unknown): boolean {\n  const code = (extractErrorCode(err) || '').toLowerCase();\n  if (TRANSIENT_ERROR_CODES.has(code)) {\n    return true;\n  }\n  if (!err || typeof err !== 'object') {\n    return false;\n  }\n  const e = err as { status?: number; message?: string; code?: string };\n  if (typeof e.status === 'number' && e.status >= 500) {\n    return true;\n  }\n  const msg = String(e.message || e.code || '').toLowerCase();\n  return msg.includes('timeout')\n    || msg.includes('econnreset')\n    || msg.includes('enotfound')\n    || msg.includes('network')\n    || msg.includes('socket')\n    || msg.includes('unavailable');\n}\n\nexport function shouldRetryError(err: unknown): boolean {\n  if (isPermanentTokenError(err)) {\n    return false;\n  }\n  return isTransientError(err);\n}\n\nexport function classifyTokenError(err: unknown): { permanent: boolean; errorCode?: string; message: string } {\n  const errorCode = extractErrorCode(err);\n  const message = extractMessage(err);\n  const permanent = isPermanentTokenError(err) || (!isTransientError(err) && !shouldRetryError(err));\n  return { permanent, errorCode, message };\n}\n\nexport async function sleep(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => setTimeout(resolve, ms));\n}\n","import type { Message, Messaging } from 'firebase-admin/messaging';\nimport { initializeApp, cert, getApps, deleteApp, type App } from 'firebase-admin/app';\nimport { getMessaging } from 'firebase-admin/messaging';\nimport { resolveConfig, type FcmConfig, type ResolvedFcmConfig } from './config';\nimport { FcmApiError, FcmConfigError } from './errors';\nimport { validatePayload } from './validate';\nimport {\n  appendTokenFailure,\n  chunkTokens,\n  dedupeTokens,\n  emptyMulticastResult,\n  mergeMulticastResults,\n} from './batch';\nimport {\n  classifyTokenError,\n  shouldRetryError,\n  sleep,\n} from './retry';\nimport type {\n  MulticastResult,\n  PushMessage,\n  SendMulticastParams,\n  SendResult,\n  SendToTokenParams,\n  TokenSendFailure,\n} from './types';\n\nexport type FcmMessagingClient = Pick<Messaging, 'send' | 'sendEachForMulticast'>;\n\nfunction buildAdminMessage(message: PushMessage, token?: string): Record<string, unknown> {\n  const payload: Record<string, unknown> = {};\n  if (message.notification) {\n    payload.notification = {\n      title: message.notification.title,\n      body: message.notification.body,\n      imageUrl: message.notification.imageUrl,\n    };\n  }\n  if (message.data) {\n    payload.data = message.data;\n  }\n  if (message.webpush) {\n    payload.webpush = message.webpush;\n  }\n  if (message.android) {\n    payload.android = message.android;\n  }\n  if (message.apns) {\n    payload.apns = message.apns;\n  }\n  if (message.collapseKey) {\n    payload.collapseKey = message.collapseKey;\n  }\n  if (token) {\n    payload.token = token;\n  }\n  if (message.ttlSeconds !== undefined) {\n    payload.android = {\n      ...(payload.android as Record<string, unknown> || {}),\n      ttl: message.ttlSeconds * 1000,\n    };\n  }\n  return payload;\n}\n\nexport class FcmClient {\n  private readonly resolved: ResolvedFcmConfig;\n  private readonly messaging: FcmMessagingClient;\n  private readonly app: App | null;\n  private closed = false;\n\n  constructor(config: FcmConfig, messagingClient?: FcmMessagingClient, app?: App) {\n    try {\n      this.resolved = resolveConfig(config);\n    } catch (err) {\n      throw new FcmConfigError((err as Error).message);\n    }\n\n    if (messagingClient) {\n      this.messaging = messagingClient;\n      this.app = app ?? null;\n    } else {\n      const existing = getApps().find((a) => a.name === 'multivendor-notification');\n      this.app = existing ?? initializeApp({\n        credential: cert({\n          projectId: this.resolved.projectId,\n          clientEmail: this.resolved.clientEmail,\n          privateKey: this.resolved.privateKey,\n        }),\n        projectId: this.resolved.projectId,\n      }, 'multivendor-notification');\n      this.messaging = getMessaging(this.app);\n    }\n  }\n\n  getConfig(): ResolvedFcmConfig {\n    return this.resolved;\n  }\n\n  async validate(): Promise<void> {\n    resolveConfig(this.resolved);\n  }\n\n  async close(): Promise<void> {\n    this.closed = true;\n    if (this.app) {\n      await deleteApp(this.app).catch(() => undefined);\n    }\n  }\n\n  async send(message: PushMessage & { token: string }): Promise<SendResult> {\n    return this.sendToToken({ token: message.token, message });\n  }\n\n  async sendToToken(params: SendToTokenParams): Promise<SendResult> {\n    this.assertOpen();\n    const token = params.token?.trim();\n    if (!token) {\n      throw new FcmConfigError('FCM token is required');\n    }\n\n    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });\n\n    let lastError: unknown;\n    const maxAttempts = 2;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        const messageId = await this.messaging.send(\n          buildAdminMessage(params.message, token) as unknown as Message,\n        );\n        return { messageId, attemptCount: attempt };\n      } catch (err) {\n        lastError = err;\n        if (isPermanentTokenFailure(err) || !shouldRetryError(err) || attempt >= maxAttempts) {\n          break;\n        }\n        await sleep(this.resolved.retryBackoffMs);\n      }\n    }\n\n    const classified = classifyTokenError(lastError);\n    throw new FcmApiError(classified.message, {\n      errorCode: classified.errorCode,\n      attemptCount: maxAttempts,\n      details: lastError,\n    });\n  }\n\n  async sendMulticast(params: SendMulticastParams): Promise<MulticastResult> {\n    this.assertOpen();\n    validatePayload(params.message, { maxPayloadBytes: this.resolved.maxPayloadBytes });\n\n    const uniqueTokens = dedupeTokens(params.tokens);\n    if (uniqueTokens.length === 0) {\n      return emptyMulticastResult();\n    }\n\n    const chunks = chunkTokens(uniqueTokens);\n    const batchResults: MulticastResult[] = [];\n\n    for (const batch of chunks) {\n      batchResults.push(await this.sendMulticastBatch(batch, params.message));\n    }\n\n    return mergeMulticastResults(batchResults);\n  }\n\n  private async sendMulticastBatch(tokens: string[], message: PushMessage): Promise<MulticastResult> {\n    const result = emptyMulticastResult();\n\n    let lastBatchError: unknown;\n    const maxAttempts = 2;\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        const response = await this.messaging.sendEachForMulticast({\n          tokens,\n          notification: message.notification\n            ? {\n              title: message.notification.title,\n              body: message.notification.body,\n              imageUrl: message.notification.imageUrl,\n            }\n            : undefined,\n          data: message.data,\n          webpush: message.webpush as never,\n          android: message.android as never,\n          apns: message.apns as never,\n        });\n\n        result.successCount += response.successCount;\n        result.failureCount += response.failureCount;\n\n        response.responses.forEach((res, index) => {\n          if (res.success) {\n            return;\n          }\n          const token = tokens[index];\n          const classified = classifyTokenError(res.error);\n          const failure: TokenSendFailure = {\n            token,\n            errorCode: classified.errorCode,\n            message: classified.message,\n            permanent: classified.permanent,\n          };\n          appendTokenFailure(result, failure);\n        });\n\n        return result;\n      } catch (err) {\n        lastBatchError = err;\n        if (!shouldRetryError(err) || attempt >= maxAttempts) {\n          break;\n        }\n        await sleep(this.resolved.retryBackoffMs);\n      }\n    }\n\n    const classified = classifyTokenError(lastBatchError);\n    if (!classified.permanent && shouldRetryError(lastBatchError)) {\n      for (const token of tokens) {\n        appendTokenFailure(result, {\n          token,\n          errorCode: classified.errorCode,\n          message: classified.message,\n          permanent: false,\n        });\n      }\n      return result;\n    }\n\n    throw new FcmApiError(classified.message, {\n      errorCode: classified.errorCode,\n      attemptCount: maxAttempts,\n      details: lastBatchError,\n    });\n  }\n\n  private assertOpen(): void {\n    if (this.closed) {\n      throw new FcmConfigError('FcmClient is closed');\n    }\n  }\n}\n\nfunction isPermanentTokenFailure(err: unknown): boolean {\n  return classifyTokenError(err).permanent;\n}\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "multivendor-notification",
+  "version": "0.0.1",
+  "description": "Framework-agnostic FCM push notification client with batching, retry, and payload validation for multivendor SaaS apps",
+  "license": "MIT",
+  "author": "SmartByteLabs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SmartByteLabs/multivendor-saas-components.git",
+    "directory": "multivendor-notification"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "firebase-admin": "^13.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.19",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "keywords": [
+    "fcm",
+    "firebase",
+    "push",
+    "notification",
+    "multivendor"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}