@webority/mobile-core 0.96.0 → 0.99.0

package/lib/commonjs/auth/jwt.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.isJWTExpired=exports.getJWTExpiry=exports.decodeJWT=void 0;var _index=require("../logger/index.js");const base64UrlToBase64=e=>(e+"=".repeat((4-e.length%4)%4)).replace(/-/g,"+").replace(/_/g,"/"),BASE64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",decodeBase64Fallback=e=>{let t="";for(let r=0;r<e.length;r+=4){const o=[0,1,2,3].map(t=>BASE64_ALPHABET.indexOf(e[r+t]??"=")),n=Math.max(o[0],0)<<18|Math.max(o[1],0)<<12|Math.max(o[2],0)<<6|Math.max(o[3],0);t+=String.fromCharCode(n>>16&255),-1!==o[2]&&(t+=String.fromCharCode(n>>8&255)),-1!==o[3]&&(t+=String.fromCharCode(255&n))}return t},decodeBase64=e=>"function"==typeof atob?atob(e):decodeBase64Fallback(e),utf8FromBinary=e=>{try{return decodeURIComponent(e.split("").map(e=>"%"+e.charCodeAt(0).toString(16).padStart(2,"0")).join(""))}catch{return e}},decodeJWT=e=>{if(!e||"string"!=typeof e)return null;const t=e.split(".");if(3!==t.length)return _index.Logger.warn("[jwt] decodeJWT: token is not a valid JWT (expected 3 segments)"),null;try{const e=t[1],r=utf8FromBinary(decodeBase64(base64UrlToBase64(e)));return JSON.parse(r)}catch(e){return _index.Logger.warn("[jwt] decodeJWT failed to parse payload",e),null}};exports.decodeJWT=decodeJWT;const isJWTExpired=(e,t=30)=>{const r=decodeJWT(e);if(!r||"number"!=typeof r.exp)return!0;const o=Math.floor(Date.now()/1e3);return r.exp<=o+t};exports.isJWTExpired=isJWTExpired;const getJWTExpiry=e=>{const t=decodeJWT(e);return t&&"number"==typeof t.exp?new Date(1e3*t.exp):null};exports.getJWTExpiry=getJWTExpiry;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.isJWTExpired=exports.getJWTExpiry=exports.decodeJWT=void 0;var _index=require("../logger/index.js");const base64UrlToBase64=e=>(e+"=".repeat((4-e.length%4)%4)).replace(/-/g,"+").replace(/_/g,"/"),BASE64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",decodeBase64Fallback=e=>{let t="";for(let r=0;r<e.length;r+=4){const o=[0,1,2,3].map(t=>BASE64_ALPHABET.indexOf(e[r+t]??"=")),n=Math.max(o[0],0)<<18|Math.max(o[1],0)<<12|Math.max(o[2],0)<<6|Math.max(o[3],0);t+=String.fromCharCode(n>>16&255),-1!==o[2]&&(t+=String.fromCharCode(n>>8&255)),-1!==o[3]&&(t+=String.fromCharCode(255&n))}return t},decodeBase64=e=>"function"==typeof atob?atob(e):decodeBase64Fallback(e),utf8FromBinary=e=>{try{return decodeURIComponent(e.split("").map(e=>`%${e.charCodeAt(0).toString(16).padStart(2,"0")}`).join(""))}catch{return e}},decodeJWT=e=>{if(!e||"string"!=typeof e)return null;const t=e.split(".");if(3!==t.length)return _index.Logger.warn("[jwt] decodeJWT: token is not a valid JWT (expected 3 segments)"),null;try{const e=t[1],r=utf8FromBinary(decodeBase64(base64UrlToBase64(e)));return JSON.parse(r)}catch(e){return _index.Logger.warn("[jwt] decodeJWT failed to parse payload",e),null}};exports.decodeJWT=decodeJWT;const isJWTExpired=(e,t=30)=>{const r=decodeJWT(e);if(!r||"number"!=typeof r.exp)return!0;const o=Math.floor(Date.now()/1e3);return r.exp<=o+t};exports.isJWTExpired=isJWTExpired;const getJWTExpiry=e=>{const t=decodeJWT(e);return t&&"number"==typeof t.exp?new Date(1e3*t.exp):null};exports.getJWTExpiry=getJWTExpiry;

package/lib/commonjs/push/broadcasts.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.withdrawBroadcastConsent=exports.initPushBroadcasts=exports.handleBroadcastOpen=exports.handleBroadcastAction=exports.grantBroadcastConsent=exports.getBroadcastConsent=exports.BROADCAST_OPT_OUT_ACTION=void 0;var _reactNative=require("react-native"),_publicClient=_interopRequireDefault(require("../api/publicClient.js")),_userClient=_interopRequireDefault(require("../api/userClient.js")),_index=require("../config/index.js"),_index2=require("../errors/index.js"),_index3=require("../logger/index.js"),_push=require("./push.js");function _interopRequireDefault(t){return t&&t.__esModule?t:{default:t}}const BROADCAST_OPT_OUT_ACTION=exports.BROADCAST_OPT_OUT_ACTION="broadcast-opt-out",WITHDRAW_FROM_PUSH_ROUTE="/consent/withdraw-from-push",OPENS_ROUTE="/opens";let broadcastsConfig=null;const reportedOpens=new Set,requireBroadcastsConfig=()=>{if(!broadcastsConfig)throw new Error("[@webority/mobile-core] call initPushBroadcasts before using push broadcasts.");return broadcastsConfig},clientName=()=>[_reactNative.Platform.OS,(0,_index.getConfigValue)("appId"),(0,_index.getConfigValue)("appVersion")].filter(Boolean).join(" "),toConsent=t=>({status:t.status,statusDateTimeUtc:t.statusDateTimeUtc??null}),initPushBroadcasts=t=>{if(!t.basePath.startsWith("/")||t.basePath.endsWith("/"))throw new Error("[@webority/mobile-core] PushBroadcastsConfig.basePath must start with / and not end with /.");broadcastsConfig=t,(0,_push.setCategories)([{id:t.categoryId,actions:[{id:BROADCAST_OPT_OUT_ACTION,title:t.optOutTitle,opensApp:!1}]}]).catch(t=>_index3.Logger.error("[push] registering the broadcast category failed",t))};exports.initPushBroadcasts=initPushBroadcasts;const getBroadcastConsent=async()=>{const{basePath:t}=requireBroadcastsConfig();try{const e=await _userClient.default.get(`${t}/consent`);return toConsent(e.data)}catch(t){throw(0,_index2.extractApiError)(t)}};exports.getBroadcastConsent=getBroadcastConsent;const grantBroadcastConsent=async()=>{const{basePath:t,consentTextVersion:e}=requireBroadcastsConfig();try{const a=await _userClient.default.post(`${t}/consent/grant`,{consentTextVersion:e,source:"MobileApp",client:clientName()});return toConsent(a.data)}catch(t){throw(0,_index2.extractApiError)(t)}};exports.grantBroadcastConsent=grantBroadcastConsent;const withdrawBroadcastConsent=async()=>{const{basePath:t}=requireBroadcastsConfig();try{const e=await _userClient.default.post(`${t}/consent/withdraw`,{source:"MobileApp",broadcastRecipientId:null,client:clientName()});return toConsent(e.data)}catch(t){throw(0,_index2.extractApiError)(t)}};exports.withdrawBroadcastConsent=withdrawBroadcastConsent;const handleBroadcastAction=async t=>{if(t.actionId!==BROADCAST_OPT_OUT_ACTION||"Broadcast"!==t.data.kind)return;if(!broadcastsConfig)return void _index3.Logger.error("[push] a broadcast opt-out arrived before initPushBroadcasts; call it at module scope in the entry file");const e=t.data.optOutToken;if(e)try{await _publicClient.default.post(`${broadcastsConfig.basePath}${WITHDRAW_FROM_PUSH_ROUTE}`,{token:e})}catch(t){_index3.Logger.warn(`[push] ${WITHDRAW_FROM_PUSH_ROUTE} failed with status ${(0,_index2.extractApiError)(t).status}`)}else _index3.Logger.error("[push] a broadcast opt-out carried no token")};exports.handleBroadcastAction=handleBroadcastAction;const handleBroadcastOpen=t=>{const e=t.broadcastRecipientId;"Broadcast"===t.kind&&e&&(broadcastsConfig?reportedOpens.has(e)||(reportedOpens.add(e),_userClient.default.post(`${broadcastsConfig.basePath}/opens`,{broadcastRecipientId:e}).catch(t=>_index3.Logger.warn(`[push] /opens failed with status ${(0,_index2.extractApiError)(t).status}`))):_index3.Logger.error("[push] a broadcast open arrived before initPushBroadcasts; call it at module scope in the entry file"))};exports.handleBroadcastOpen=handleBroadcastOpen;

package/lib/module/auth/jwt.js

@@ -1 +1 @@
-"use strict";import{Logger}from"../logger/index.js";const base64UrlToBase64=e=>(e+"=".repeat((4-e.length%4)%4)).replace(/-/g,"+").replace(/_/g,"/"),BASE64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",decodeBase64Fallback=e=>{let t="";for(let r=0;r<e.length;r+=4){const o=[0,1,2,3].map(t=>BASE64_ALPHABET.indexOf(e[r+t]??"=")),n=Math.max(o[0],0)<<18|Math.max(o[1],0)<<12|Math.max(o[2],0)<<6|Math.max(o[3],0);t+=String.fromCharCode(n>>16&255),-1!==o[2]&&(t+=String.fromCharCode(n>>8&255)),-1!==o[3]&&(t+=String.fromCharCode(255&n))}return t},decodeBase64=e=>"function"==typeof atob?atob(e):decodeBase64Fallback(e),utf8FromBinary=e=>{try{return decodeURIComponent(e.split("").map(e=>"%"+e.charCodeAt(0).toString(16).padStart(2,"0")).join(""))}catch{return e}};export const decodeJWT=e=>{if(!e||"string"!=typeof e)return null;const t=e.split(".");if(3!==t.length)return Logger.warn("[jwt] decodeJWT: token is not a valid JWT (expected 3 segments)"),null;try{const e=t[1],r=utf8FromBinary(decodeBase64(base64UrlToBase64(e)));return JSON.parse(r)}catch(e){return Logger.warn("[jwt] decodeJWT failed to parse payload",e),null}};export const isJWTExpired=(e,t=30)=>{const r=decodeJWT(e);if(!r||"number"!=typeof r.exp)return!0;const o=Math.floor(Date.now()/1e3);return r.exp<=o+t};export const getJWTExpiry=e=>{const t=decodeJWT(e);return t&&"number"==typeof t.exp?new Date(1e3*t.exp):null};
+"use strict";import{Logger}from"../logger/index.js";const base64UrlToBase64=e=>(e+"=".repeat((4-e.length%4)%4)).replace(/-/g,"+").replace(/_/g,"/"),BASE64_ALPHABET="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",decodeBase64Fallback=e=>{let t="";for(let r=0;r<e.length;r+=4){const o=[0,1,2,3].map(t=>BASE64_ALPHABET.indexOf(e[r+t]??"=")),n=Math.max(o[0],0)<<18|Math.max(o[1],0)<<12|Math.max(o[2],0)<<6|Math.max(o[3],0);t+=String.fromCharCode(n>>16&255),-1!==o[2]&&(t+=String.fromCharCode(n>>8&255)),-1!==o[3]&&(t+=String.fromCharCode(255&n))}return t},decodeBase64=e=>"function"==typeof atob?atob(e):decodeBase64Fallback(e),utf8FromBinary=e=>{try{return decodeURIComponent(e.split("").map(e=>`%${e.charCodeAt(0).toString(16).padStart(2,"0")}`).join(""))}catch{return e}};export const decodeJWT=e=>{if(!e||"string"!=typeof e)return null;const t=e.split(".");if(3!==t.length)return Logger.warn("[jwt] decodeJWT: token is not a valid JWT (expected 3 segments)"),null;try{const e=t[1],r=utf8FromBinary(decodeBase64(base64UrlToBase64(e)));return JSON.parse(r)}catch(e){return Logger.warn("[jwt] decodeJWT failed to parse payload",e),null}};export const isJWTExpired=(e,t=30)=>{const r=decodeJWT(e);if(!r||"number"!=typeof r.exp)return!0;const o=Math.floor(Date.now()/1e3);return r.exp<=o+t};export const getJWTExpiry=e=>{const t=decodeJWT(e);return t&&"number"==typeof t.exp?new Date(1e3*t.exp):null};

package/lib/module/push/broadcasts.js

@@ -0,0 +1 @@
+"use strict";import{Platform}from"react-native";import publicClient from"../api/publicClient.js";import userClient from"../api/userClient.js";import{getConfigValue}from"../config/index.js";import{extractApiError}from"../errors/index.js";import{Logger}from"../logger/index.js";import{setCategories}from"./push.js";export const BROADCAST_OPT_OUT_ACTION="broadcast-opt-out";const WITHDRAW_FROM_PUSH_ROUTE="/consent/withdraw-from-push",OPENS_ROUTE="/opens";let broadcastsConfig=null;const reportedOpens=new Set,requireBroadcastsConfig=()=>{if(!broadcastsConfig)throw new Error("[@webority/mobile-core] call initPushBroadcasts before using push broadcasts.");return broadcastsConfig},clientName=()=>[Platform.OS,getConfigValue("appId"),getConfigValue("appVersion")].filter(Boolean).join(" "),toConsent=t=>({status:t.status,statusDateTimeUtc:t.statusDateTimeUtc??null});export const initPushBroadcasts=t=>{if(!t.basePath.startsWith("/")||t.basePath.endsWith("/"))throw new Error("[@webority/mobile-core] PushBroadcastsConfig.basePath must start with / and not end with /.");broadcastsConfig=t,setCategories([{id:t.categoryId,actions:[{id:"broadcast-opt-out",title:t.optOutTitle,opensApp:!1}]}]).catch(t=>Logger.error("[push] registering the broadcast category failed",t))};export const getBroadcastConsent=async()=>{const{basePath:t}=requireBroadcastsConfig();try{const o=await userClient.get(`${t}/consent`);return toConsent(o.data)}catch(t){throw extractApiError(t)}};export const grantBroadcastConsent=async()=>{const{basePath:t,consentTextVersion:o}=requireBroadcastsConfig();try{const r=await userClient.post(`${t}/consent/grant`,{consentTextVersion:o,source:"MobileApp",client:clientName()});return toConsent(r.data)}catch(t){throw extractApiError(t)}};export const withdrawBroadcastConsent=async()=>{const{basePath:t}=requireBroadcastsConfig();try{const o=await userClient.post(`${t}/consent/withdraw`,{source:"MobileApp",broadcastRecipientId:null,client:clientName()});return toConsent(o.data)}catch(t){throw extractApiError(t)}};export const handleBroadcastAction=async t=>{if("broadcast-opt-out"!==t.actionId||"Broadcast"!==t.data.kind)return;if(!broadcastsConfig)return void Logger.error("[push] a broadcast opt-out arrived before initPushBroadcasts; call it at module scope in the entry file");const o=t.data.optOutToken;if(o)try{await publicClient.post(`${broadcastsConfig.basePath}${WITHDRAW_FROM_PUSH_ROUTE}`,{token:o})}catch(t){Logger.warn(`[push] ${WITHDRAW_FROM_PUSH_ROUTE} failed with status ${extractApiError(t).status}`)}else Logger.error("[push] a broadcast opt-out carried no token")};export const handleBroadcastOpen=t=>{const o=t.broadcastRecipientId;"Broadcast"===t.kind&&o&&(broadcastsConfig?reportedOpens.has(o)||(reportedOpens.add(o),userClient.post(`${broadcastsConfig.basePath}/opens`,{broadcastRecipientId:o}).catch(t=>Logger.warn(`[push] /opens failed with status ${extractApiError(t).status}`))):Logger.error("[push] a broadcast open arrived before initPushBroadcasts; call it at module scope in the entry file"))};

package/lib/typescript/commonjs/push/broadcasts.d.ts

@@ -0,0 +1,39 @@
+import { type PushActionHandler } from "./push";
+export type BroadcastConsentStatus = "None" | "Granted" | "Withdrawn";
+export interface BroadcastConsent {
+    status: BroadcastConsentStatus;
+    /** When the status last changed, as UTC text; null when it never did. */
+    statusDateTimeUtc: string | null;
+}
+export interface PushBroadcastsConfig {
+    /** The route the server maps the broadcast endpoints on. Starts with `/`, does not end with `/`. */
+    basePath: string;
+    /** The notification category the opt-out button belongs to. */
+    categoryId: string;
+    /** The wording version the person is shown; the server refuses one it does not list. */
+    consentTextVersion: string;
+    /** The label of the opt-out button, in the app's own wording. */
+    optOutTitle: string;
+}
+export declare const BROADCAST_OPT_OUT_ACTION = "broadcast-opt-out";
+/**
+ * Wires the broadcast opt-out for this app. Call it at module scope in the entry
+ * file, before definePushActionTask from `/push/task`: a tap on a killed Android
+ * app runs that background task without the UI, so the config must already exist.
+ */
+export declare const initPushBroadcasts: (config: PushBroadcastsConfig) => void;
+export declare const getBroadcastConsent: () => Promise<BroadcastConsent>;
+export declare const grantBroadcastConsent: () => Promise<BroadcastConsent>;
+export declare const withdrawBroadcastConsent: () => Promise<BroadcastConsent>;
+/**
+ * Handles the opt-out button. Call it from the action handler of definePushActionTask,
+ * then run the app's own actions. Never throws: a background task has no screen to
+ * show a failure on. Logs never carry the token.
+ */
+export declare const handleBroadcastAction: PushActionHandler;
+/**
+ * Reports that a broadcast was opened. Call it from the onOpen of initPush. Each
+ * recipient is reported once per process; a failed report is not retried.
+ */
+export declare const handleBroadcastOpen: (data: Record<string, string>) => void;
+//# sourceMappingURL=broadcasts.d.ts.map

package/lib/typescript/module/push/broadcasts.d.ts

@@ -0,0 +1,39 @@
+import { type PushActionHandler } from "./push.js";
+export type BroadcastConsentStatus = "None" | "Granted" | "Withdrawn";
+export interface BroadcastConsent {
+    status: BroadcastConsentStatus;
+    /** When the status last changed, as UTC text; null when it never did. */
+    statusDateTimeUtc: string | null;
+}
+export interface PushBroadcastsConfig {
+    /** The route the server maps the broadcast endpoints on. Starts with `/`, does not end with `/`. */
+    basePath: string;
+    /** The notification category the opt-out button belongs to. */
+    categoryId: string;
+    /** The wording version the person is shown; the server refuses one it does not list. */
+    consentTextVersion: string;
+    /** The label of the opt-out button, in the app's own wording. */
+    optOutTitle: string;
+}
+export declare const BROADCAST_OPT_OUT_ACTION = "broadcast-opt-out";
+/**
+ * Wires the broadcast opt-out for this app. Call it at module scope in the entry
+ * file, before definePushActionTask from `/push/task`: a tap on a killed Android
+ * app runs that background task without the UI, so the config must already exist.
+ */
+export declare const initPushBroadcasts: (config: PushBroadcastsConfig) => void;
+export declare const getBroadcastConsent: () => Promise<BroadcastConsent>;
+export declare const grantBroadcastConsent: () => Promise<BroadcastConsent>;
+export declare const withdrawBroadcastConsent: () => Promise<BroadcastConsent>;
+/**
+ * Handles the opt-out button. Call it from the action handler of definePushActionTask,
+ * then run the app's own actions. Never throws: a background task has no screen to
+ * show a failure on. Logs never carry the token.
+ */
+export declare const handleBroadcastAction: PushActionHandler;
+/**
+ * Reports that a broadcast was opened. Call it from the onOpen of initPush. Each
+ * recipient is reported once per process; a failed report is not retried.
+ */
+export declare const handleBroadcastOpen: (data: Record<string, string>) => void;
+//# sourceMappingURL=broadcasts.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-core",
-  "version": "0.96.0",
+  "version": "0.99.0",
   "description": "Platform layer for Webority React Native apps: HTTP clients, auth/token storage, config, logging, formatters, validators, network status, permissions, storage, version checks and over-the-air updates. No UI.",
   "keywords": [
     "react-native",
@@ -202,6 +202,16 @@
         "default": "./lib/commonjs/push/task.js"
       }
     },
+    "./push/broadcasts": {
+      "import": {
+        "types": "./lib/typescript/module/push/broadcasts.d.ts",
+        "default": "./lib/module/push/broadcasts.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/push/broadcasts.d.ts",
+        "default": "./lib/commonjs/push/broadcasts.js"
+      }
+    },
     "./smsRetriever": {
       "import": {
         "types": "./lib/typescript/module/smsRetriever/index.d.ts",