@serve.zone/platformclient 2.2.0 → 2.3.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/platformclient',
-    version: '2.2.0',
+    version: '2.3.0',
     description: 'a module that makes it really easy to use the serve.zone platform inside your app'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSw0QkFBNEI7SUFDbEMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG1GQUFtRjtDQUNqRyxDQUFBIn0=

package/dist_ts/classes.platformclient.d.ts

@@ -2,6 +2,7 @@ import { SzEmailConnector } from './email/classes.emailconnector.js';
 import { SzSmsConnector } from './email/classes.smsconnector.js';
 import { SzPushNotificationConnector } from './email/classes.pushnotificationconnector.js';
 import { SzLetterConnector } from './email/classes.letterconnector.js';
+import { SzWebPushConnector } from './webpush/classes.webpushconnector.js';
 import * as plugins from './plugins.js';
 export interface ISzPlatformClientOptions {
     authorizationString?: string;
@@ -23,6 +24,7 @@ export declare class SzPlatformClient {
     emailConnector: SzEmailConnector;
     smsConnector: SzSmsConnector;
     pushNotificationConnector: SzPushNotificationConnector;
+    webPushConnector: SzWebPushConnector;
     letterConnector: SzLetterConnector;
     constructor(authorizationStringArg?: string | ISzPlatformClientOptions);
     init(authorizationStringArg?: string | ISzPlatformClientOptions): Promise<void>;

package/dist_ts/classes.platformclient.js

@@ -2,6 +2,7 @@ import { SzEmailConnector } from './email/classes.emailconnector.js';
 import { SzSmsConnector } from './email/classes.smsconnector.js';
 import { SzPushNotificationConnector } from './email/classes.pushnotificationconnector.js';
 import { SzLetterConnector } from './email/classes.letterconnector.js';
+import { SzWebPushConnector } from './webpush/classes.webpushconnector.js';
 import * as plugins from './plugins.js';
 export class SzPlatformClient {
     constructor(authorizationStringArg) {
@@ -12,6 +13,7 @@ export class SzPlatformClient {
         this.emailConnector = new SzEmailConnector(this);
         this.smsConnector = new SzSmsConnector(this);
         this.pushNotificationConnector = new SzPushNotificationConnector(this);
+        this.webPushConnector = new SzWebPushConnector(this);
         this.letterConnector = new SzLetterConnector(this);
         this.applyOptions(authorizationStringArg);
     }
@@ -129,7 +131,10 @@ export class SzPlatformClient {
         }
     }
     async stop() {
-        await this.emailConnector.stop();
+        await Promise.all([
+            this.emailConnector.stop(),
+            this.webPushConnector.stop(),
+        ]);
         if (this.typedsocket) {
             await this.typedsocket.stop();
         }
@@ -181,4 +186,4 @@ export class SzPlatformClient {
         return processEnv?.[envNameArg];
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5wbGF0Zm9ybWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2NsYXNzZXMucGxhdGZvcm1jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFDckUsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pFLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLDhDQUE4QyxDQUFDO0FBQzNGLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLG9DQUFvQyxDQUFDO0FBQ3ZFLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBWXhDLE1BQU0sT0FBTyxnQkFBZ0I7SUFjM0IsWUFBWSxzQkFBMEQ7UUFiL0QsY0FBUyxHQUFHLEtBQUssQ0FBQztRQUdsQixxQkFBZ0IsR0FBNEQsRUFBRSxDQUFDO1FBQy9FLGdCQUFXLEdBQXFDLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUV0RixpQkFBWSxHQUFHLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUV4QyxtQkFBYyxHQUFHLElBQUksZ0JBQWdCLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDNUMsaUJBQVksR0FBRyxJQUFJLGNBQWMsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN4Qyw4QkFBeUIsR0FBRyxJQUFJLDJCQUEyQixDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ2xFLG9CQUFlLEdBQUcsSUFBSSxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUduRCxJQUFJLENBQUMsWUFBWSxDQUFDLHNCQUFzQixDQUFDLENBQUM7SUFDNUMsQ0FBQztJQUVNLEtBQUssQ0FBQyxJQUFJLENBQUMsc0JBQTBEO1FBQzFFLElBQUksQ0FBQyxZQUFZLENBQUMsc0JBQXNCLENBQUMsQ0FBQztRQUMxQyxJQUFJLENBQUMsSUFBSSxDQUFDLG1CQUFtQixFQUFFLENBQUM7WUFDOUIsSUFBSSxDQUFDLG1CQUFtQixHQUFHLE1BQU0sSUFBSSxDQUFDLGdDQUFnQyxFQUFFLENBQUM7UUFDM0UsQ0FBQztRQUNELElBQUksSUFBSSxDQUFDLG1CQUFtQixLQUFLLE1BQU0sRUFBRSxDQUFDO1lBQ3hDLElBQUksQ0FBQyxpQkFBaUIsRUFBRSxDQUFDO1lBQ3pCLE9BQU87UUFDVCxDQUFDO1FBRUQsSUFBSSxDQUFDLGdCQUFnQixHQUFHLElBQUksQ0FBQyxxQkFBcUIsQ0FDaEQsSUFBSSxDQUFDLGdCQUFnQixFQUNyQixNQUFNLElBQUksQ0FBQyx3QkFBd0IsRUFBRSxDQUN0QyxDQUFDO1FBQ0YsSUFBSSxDQUFDLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1lBQzlCLElBQUksQ0FBQyxtQkFBbUIsR0FBRyxJQUFJLENBQUMsa0NBQWtDLEVBQUUsQ0FBQztRQUN2RSxDQUFDO1FBQ0QsSUFBSSxDQUFDLElBQUksQ0FBQyxtQkFBbUI7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLGlDQUFpQyxDQUFDLENBQUM7UUFDbEYsSUFBSSxJQUFJLENBQUMsbUJBQW1CLEtBQUssTUFBTSxFQUFFLENBQUM7WUFDeEMsSUFBSSxDQUFDLGlCQUFpQixFQUFFLENBQUM7WUFDekIsT0FBTztRQUNULENBQUM7UUFDRCxJQUFJLENBQUMsV0FBVyxHQUFHLE1BQU0sT0FBTyxDQUFDLFdBQVcsQ0FBQyxXQUFXLENBQUMsWUFBWSxDQUNuRSxJQUFJLENBQUMsV0FBa0IsRUFDdkIsTUFBTSxJQUFJLENBQUMsb0JBQW9CLEVBQUUsQ0FDbEMsQ0FBQztRQUNGLE1BQU0sSUFBSSxDQUFDLG1CQUFtQixFQUFFLENBQUM7SUFDbkMsQ0FBQztJQUVPLGlCQUFpQjtRQUN2QixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQztRQUN0QixPQUFPLENBQUMsR0FBRyxDQUFDLHVCQUF1QixDQUFDLENBQUM7SUFDdkMsQ0FBQztJQUVNLGtCQUFrQixDQUN2QixhQUF3RTtRQUV4RSxPQUFPLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFJLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRTtZQUMvQyxPQUFPLENBQ0wsVUFBVSxDQUFDLFlBQVksS0FBSyxVQUFVO2dCQUN0QyxVQUFVLENBQUMsTUFBTSxLQUFLLFFBQVE7Z0JBQzlCLENBQUMsQ0FBQyxhQUFhLElBQUksVUFBVSxDQUFDLFVBQVUsS0FBSyxhQUFhLENBQUMsQ0FDNUQsQ0FBQztRQUNKLENBQUMsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVPLFlBQVksQ0FBQyxVQUE4QztRQUNqRSxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDaEIsT0FBTztRQUNULENBQUM7UUFDRCxJQUFJLE9BQU8sVUFBVSxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQ25DLElBQUksQ0FBQyxtQkFBbUIsR0FBRyxVQUFVLENBQUM7WUFDdEMsT0FBTztRQUNULENBQUM7UUFFRCxJQUFJLENBQUMsbUJBQW1CO1lBQ3RCLFVBQVUsQ0FBQyxtQkFBbUI7Z0JBQzlCLFVBQVUsQ0FBQyxhQUFhO2dCQUN4QixVQUFVLENBQUMsS0FBSztnQkFDaEIsSUFBSSxDQUFDLG1CQUFtQixDQUFDO1FBQzNCLElBQUksQ0FBQyxpQkFBaUIsR0FBRyxVQUFVLENBQUMsR0FBRyxJQUFJLFVBQVUsQ0FBQyxXQUFXLElBQUksSUFBSSxDQUFDLGlCQUFpQixDQUFDO1FBQzVGLElBQUksQ0FBQyxnQkFBZ0IsR0FBRyxJQUFJLENBQUMscUJBQXFCLENBQ2hELElBQUksQ0FBQyxnQkFBZ0IsRUFDckIsQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFLEdBQUcsQ0FBQyxVQUFVLENBQUMsUUFBUSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUN6RCxPQUFPLENBQ21ELENBQzdELENBQUM7SUFDSixDQUFDO0lBRU8sS0FBSyxDQUFDLG9CQUFvQjtRQUNoQyxNQUFNLGlCQUFpQixHQUNyQixJQUFJLENBQUMsaUJBQWlCO1lBQ3RCLENBQUMsTUFBTSxJQUFJLENBQUMsbUJBQW1CLENBQUMsd0JBQXdCLENBQUMsQ0FBQztZQUMxRCxJQUFJLENBQUMsZ0NBQWdDLEVBQUUsQ0FBQztRQUMxQyxJQUFJLENBQUMsaUJBQWlCO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxpRUFBaUUsQ0FBQyxDQUFDO1FBQzNHLE9BQU8saUJBQWlCLENBQUM7SUFDM0IsQ0FBQztJQUVPLGdDQUFnQztRQUN0QyxLQUFLLE1BQU0sT0FBTyxJQUFJLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1lBQzVDLElBQUksT0FBTyxDQUFDLFlBQVksS0FBSyxVQUFVLElBQUksT0FBTyxDQUFDLE1BQU0sS0FBSyxRQUFRLEVBQUUsQ0FBQztnQkFDdkUsU0FBUztZQUNYLENBQUM7WUFDRCxJQUFJLENBQUMsSUFBSSxDQUFDLDhCQUE4QixDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsRUFBRSxDQUFDO2dCQUM3RCxTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sUUFBUSxHQUFHLE9BQU8sQ0FBQyxTQUFTLEVBQUUsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUU7Z0JBQ3ZELE9BQU8sV0FBVyxDQUFDLFFBQVEsS0FBSyxjQUFjLElBQUksV0FBVyxDQUFDLFFBQVEsS0FBSyxNQUFNLENBQUM7WUFDcEYsQ0FBQyxDQUFDLENBQUM7WUFDSCxNQUFNLFdBQVcsR0FBRyxRQUFRLEVBQUUsV0FBVyxJQUFJLFFBQVEsRUFBRSxXQUFXLENBQUM7WUFDbkUsSUFBSSxXQUFXLEVBQUUsQ0FBQztnQkFDaEIsT0FBTyxXQUFXLENBQUM7WUFDckIsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBRU8sOEJBQThCLENBQ3BDLGFBQXVFO1FBRXZFLE9BQU8sQ0FBQyxPQUFPLEVBQUUsS0FBSyxFQUFFLGtCQUFrQixFQUFFLFFBQVEsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUNoRixDQUFDO0lBRU8sS0FBSyxDQUFDLGdDQUFnQztRQUM1QyxPQUFPLENBQ0wsQ0FBQyxNQUFNLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO1lBQ3BFLENBQUMsTUFBTSxJQUFJLENBQUMsbUJBQW1CLENBQUMsMEJBQTBCLENBQUMsQ0FBQyxDQUM3RCxDQUFDO0lBQ0osQ0FBQztJQUVPLGtDQUFrQztRQUN4QyxNQUFNLFlBQVksR0FBRztZQUNuQixrQ0FBa0M7WUFDbEMsMEJBQTBCO1lBQzFCLHFCQUFxQjtZQUNyQixlQUFlO1lBQ2YsT0FBTztTQUNSLENBQUM7UUFDRixLQUFLLE1BQU0sT0FBTyxJQUFJLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1lBQzVDLEtBQUssTUFBTSxVQUFVLElBQUksT0FBTyxDQUFDLFdBQVcsSUFBSSxFQUFFLEVBQUUsQ0FBQztnQkFDbkQsS0FBSyxNQUFNLE9BQU8sSUFBSSxZQUFZLEVBQUUsQ0FBQztvQkFDbkMsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLEdBQUcsRUFBRSxDQUFDLE9BQU8sQ0FBQyxDQUFDO29CQUN4QyxJQUFJLEtBQUssRUFBRSxDQUFDO3dCQUNWLE9BQU8sS0FBSyxDQUFDO29CQUNmLENBQUM7Z0JBQ0gsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyxtQkFBbUI7UUFDL0IsSUFBSSxDQUFDLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxDQUFDO1lBQzlCLE9BQU87UUFDVCxDQUFDO1FBQ0QsSUFBSSxDQUFDO1lBQ0gsTUFBTSxJQUFJLENBQUMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxlQUFzQixFQUFFLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDO1FBQ2xGLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxNQUFNLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxnQ0FBZ0MsQ0FBQyxFQUFFLENBQUM7Z0JBQ3JFLE9BQU8sQ0FBQyxJQUFJLENBQUMsMkNBQTJDLEVBQUcsS0FBZSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ3RGLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVNLEtBQUssQ0FBQyxJQUFJO1FBQ2YsTUFBTSxJQUFJLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ2pDLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ3JCLE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNoQyxDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyx3QkFBd0I7UUFDcEMsTUFBTSxRQUFRLEdBQTRELEVBQUUsQ0FBQztRQUM3RSxNQUFNLFdBQVcsR0FBRyxNQUFNLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyw2QkFBNkIsQ0FBQyxDQUFDO1FBQ2xGLE1BQU0sVUFBVSxHQUFHLE1BQU0sSUFBSSxDQUFDLG1CQUFtQixDQUFDLDRCQUE0QixDQUFDLENBQUM7UUFFaEYsSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUNoQixRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsSUFBSSxDQUFDLHdCQUF3QixDQUFDLDZCQUE2QixFQUFFLFdBQVcsQ0FBQyxDQUFDLENBQUM7UUFDOUYsQ0FBQztRQUNELElBQUksVUFBVSxFQUFFLENBQUM7WUFDZixRQUFRLENBQUMsSUFBSSxDQUFDLEdBQUcsSUFBSSxDQUFDLHdCQUF3QixDQUFDLDRCQUE0QixFQUFFLFVBQVUsQ0FBQyxDQUFDLENBQUM7UUFDNUYsQ0FBQztRQUVELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7SUFFTyx3QkFBd0IsQ0FBQyxVQUFrQixFQUFFLFdBQW1CO1FBQ3RFLElBQUksV0FBb0IsQ0FBQztRQUN6QixJQUFJLENBQUM7WUFDSCxXQUFXLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUN4QyxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxVQUFVLDBCQUEwQixDQUFDLENBQUM7UUFDM0QsQ0FBQztRQUVELElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDO1lBQy9CLE9BQU8sV0FBc0UsQ0FBQztRQUNoRixDQUFDO1FBQ0QsSUFBSSxXQUFXLElBQUksT0FBTyxXQUFXLEtBQUssUUFBUSxFQUFFLENBQUM7WUFDbkQsT0FBTyxDQUFDLFdBQW9FLENBQUMsQ0FBQztRQUNoRixDQUFDO1FBQ0QsTUFBTSxJQUFJLEtBQUssQ0FBQyxHQUFHLFVBQVUsa0RBQWtELENBQUMsQ0FBQztJQUNuRixDQUFDO0lBRU8scUJBQXFCLENBQzNCLG1CQUE0RSxFQUM1RSxjQUF1RTtRQUV2RSxNQUFNLFVBQVUsR0FBRyxJQUFJLEdBQUcsRUFBaUUsQ0FBQztRQUM1RixLQUFLLE1BQU0sT0FBTyxJQUFJLENBQUMsR0FBRyxtQkFBbUIsRUFBRSxHQUFHLGNBQWMsQ0FBQyxFQUFFLENBQUM7WUFDbEUsVUFBVSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBQ3RDLENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUM7SUFDekMsQ0FBQztJQUVNLEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxVQUFrQjtRQUNqRCxNQUFNLFlBQVksR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDdkQsSUFBSSxZQUFZLEVBQUUsQ0FBQztZQUNqQixPQUFPLFlBQVksQ0FBQztRQUN0QixDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsWUFBWSxDQUFDLGlCQUFpQixDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ3pELENBQUM7SUFFTyxnQkFBZ0IsQ0FBQyxVQUFrQjtRQUN6QyxNQUFNLFVBQVUsR0FBSSxVQUVsQixDQUFDLE9BQU8sRUFBRSxHQUFHLENBQUM7UUFDaEIsT0FBTyxVQUFVLEVBQUUsQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUNsQyxDQUFDO0NBQ0YifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5wbGF0Zm9ybWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2NsYXNzZXMucGxhdGZvcm1jbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFDckUsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2pFLE9BQU8sRUFBRSwyQkFBMkIsRUFBRSxNQUFNLDhDQUE4QyxDQUFDO0FBQzNGLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLG9DQUFvQyxDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQzNFLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBWXhDLE1BQU0sT0FBTyxnQkFBZ0I7SUFlM0IsWUFBWSxzQkFBMEQ7UUFkL0QsY0FBUyxHQUFHLEtBQUssQ0FBQztRQUdsQixxQkFBZ0IsR0FBNEQsRUFBRSxDQUFDO1FBQy9FLGdCQUFXLEdBQXFDLElBQUksT0FBTyxDQUFDLFlBQVksQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUV0RixpQkFBWSxHQUFHLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUV4QyxtQkFBYyxHQUFHLElBQUksZ0JBQWdCLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDNUMsaUJBQVksR0FBRyxJQUFJLGNBQWMsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUN4Qyw4QkFBeUIsR0FBRyxJQUFJLDJCQUEyQixDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ2xFLHFCQUFnQixHQUFHLElBQUksa0JBQWtCLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDaEQsb0JBQWUsR0FBRyxJQUFJLGlCQUFpQixDQUFDLElBQUksQ0FBQyxDQUFDO1FBR25ELElBQUksQ0FBQyxZQUFZLENBQUMsc0JBQXNCLENBQUMsQ0FBQztJQUM1QyxDQUFD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

package/dist_ts/index.d.ts

@@ -1,2 +1,3 @@
 export * from './classes.platformclient.js';
 export * from './email/classes.emailconnector.js';
+export * from './webpush/classes.webpushconnector.js';

package/dist_ts/index.js

@@ -1,3 +1,4 @@
 export * from './classes.platformclient.js';
 export * from './email/classes.emailconnector.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsbUNBQW1DLENBQUMifQ==
+export * from './webpush/classes.webpushconnector.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsbUNBQW1DLENBQUM7QUFDbEQsY0FBYyx1Q0FBdUMsQ0FBQyJ9

package/dist_ts/webpush/classes.webpushconnector.d.ts

@@ -0,0 +1,47 @@
+import type { SzPlatformClient } from '../classes.platformclient.js';
+import * as plugins from '../plugins.js';
+export interface IServiceWebPushCredentials {
+    typedUrl: string;
+    credentialId: string;
+    credentialSecret: string;
+}
+export interface IServiceWebPushConfigurationStatus {
+    configured: boolean;
+    typedUrl?: string;
+    credentialIdConfigured: boolean;
+    credentialSecretConfigured: boolean;
+    missing: string[];
+}
+export interface IServiceWebPushEnqueueOptions extends Omit<plugins.servezoneInterfaces.requests.webpush.IReq_EnqueueWebPush['request'], 'auth' | 'owner'> {
+}
+export type TServiceWebPushCancellationTarget = plugins.servezoneInterfaces.data.TWebPushCancellationTarget;
+/**
+ * Credential-scoped Web Push delivery for a deployed service.
+ *
+ * This connector is separate from the legacy device-token push connector. It
+ * only accepts the service credential injected into the workload and never
+ * sends a caller-provided owner scope.
+ */
+export declare class SzWebPushConnector {
+    platformClientRef: SzPlatformClient;
+    private webPushTypedSocket?;
+    private webPushTypedSocketUrl?;
+    private webPushTypedSocketPromise?;
+    private webPushTypedSocketAbortController?;
+    constructor(platformClientRefArg: SzPlatformClient);
+    getConfigurationStatus(): Promise<IServiceWebPushConfigurationStatus>;
+    getWebPushServiceStatus(): Promise<plugins.servezoneInterfaces.data.IWebPushServiceStatus>;
+    getWebPushPublicKey(): Promise<string>;
+    enqueueWebPush(optionsArg: IServiceWebPushEnqueueOptions): Promise<plugins.servezoneInterfaces.requests.webpush.IReq_EnqueueWebPush['response']>;
+    cancelWebPush(targetArg: TServiceWebPushCancellationTarget): Promise<plugins.servezoneInterfaces.requests.webpush.IReq_CancelWebPush['response']>;
+    getWebPushDeliveryStatus(spoolItemIdArg: string): Promise<plugins.servezoneInterfaces.data.IWebPushDeliveryStatus | undefined>;
+    stop(): Promise<void>;
+    private getAuthenticatedClient;
+    private getCredentials;
+    private readWebPushEnv;
+    private normalizeCredentialBundle;
+    private hasCredentialBundleValue;
+    private normalizeConfigValue;
+    private getWebPushTypedSocket;
+    private normalizeTypedSocketUrl;
+}

package/dist_ts/webpush/classes.webpushconnector.js

@@ -0,0 +1,260 @@
+import * as plugins from '../plugins.js';
+/**
+ * Credential-scoped Web Push delivery for a deployed service.
+ *
+ * This connector is separate from the legacy device-token push connector. It
+ * only accepts the service credential injected into the workload and never
+ * sends a caller-provided owner scope.
+ */
+export class SzWebPushConnector {
+    constructor(platformClientRefArg) {
+        this.platformClientRef = platformClientRefArg;
+    }
+    async getConfigurationStatus() {
+        const env = await this.readWebPushEnv();
+        const missing = [];
+        if (!env.typedUrl)
+            missing.push('WEB_PUSH_TYPED_URL');
+        if (!env.credentialId)
+            missing.push('WEB_PUSH_API_CREDENTIAL_ID');
+        if (!env.credentialSecret)
+            missing.push('WEB_PUSH_API_CREDENTIAL_SECRET');
+        return {
+            configured: missing.length === 0,
+            typedUrl: env.typedUrl ? this.normalizeTypedSocketUrl(env.typedUrl) : undefined,
+            credentialIdConfigured: Boolean(env.credentialId),
+            credentialSecretConfigured: Boolean(env.credentialSecret),
+            missing,
+        };
+    }
+    async getWebPushServiceStatus() {
+        if (this.platformClientRef.debugMode) {
+            return {
+                ready: false,
+                bindingId: 'debug',
+                bindingStatus: 'disabled',
+                retiringVapidKeys: [],
+                maxPayloadBytes: 0,
+                maxTtlSeconds: 0,
+                contentEncoding: 'aes128gcm',
+                message: 'Web Push is disabled in platformclient debug mode',
+            };
+        }
+        const { typedSocket, auth } = await this.getAuthenticatedClient();
+        const request = typedSocket.createTypedRequest('getWebPushServiceStatus');
+        return await request.fire({ auth });
+    }
+    async getWebPushPublicKey() {
+        const status = await this.getWebPushServiceStatus();
+        if (!status.ready || !status.activeVapidKey?.publicKey) {
+            throw new Error(status.message || 'Web Push is not ready');
+        }
+        return status.activeVapidKey.publicKey;
+    }
+    async enqueueWebPush(optionsArg) {
+        if (!optionsArg.idempotencyKey?.trim()) {
+            throw new Error('idempotencyKey is required');
+        }
+        if (!optionsArg.subscriptionId?.trim()) {
+            throw new Error('subscriptionId is required');
+        }
+        if (this.platformClientRef.debugMode) {
+            return {
+                accepted: true,
+                spoolItemId: 'debug',
+                message: 'Web Push accepted in platformclient debug mode',
+            };
+        }
+        const { typedSocket, auth } = await this.getAuthenticatedClient();
+        const request = typedSocket.createTypedRequest('enqueueWebPush');
+        return await request.fire({
+            auth,
+            idempotencyKey: optionsArg.idempotencyKey.trim(),
+            subscriptionId: optionsArg.subscriptionId.trim(),
+            subscription: optionsArg.subscription,
+            vapidKeyId: optionsArg.vapidKeyId,
+            payload: optionsArg.payload,
+            ttlSeconds: optionsArg.ttlSeconds,
+            urgency: optionsArg.urgency,
+            collapseKey: optionsArg.collapseKey,
+        });
+    }
+    async cancelWebPush(targetArg) {
+        if (targetArg.type === 'spoolItem' && !targetArg.spoolItemId?.trim()) {
+            throw new Error('spoolItemId is required');
+        }
+        if (targetArg.type === 'subscription' && !targetArg.subscriptionId?.trim()) {
+            throw new Error('subscriptionId is required');
+        }
+        const target = targetArg.type === 'spoolItem'
+            ? { type: 'spoolItem', spoolItemId: targetArg.spoolItemId.trim() }
+            : { type: 'subscription', subscriptionId: targetArg.subscriptionId.trim() };
+        if (this.platformClientRef.debugMode) {
+            return {
+                success: true,
+                cancelledCount: 0,
+                alreadyTerminalCount: 0,
+                message: 'Web Push cancellation accepted in platformclient debug mode',
+            };
+        }
+        const { typedSocket, auth } = await this.getAuthenticatedClient();
+        const request = typedSocket.createTypedRequest('cancelWebPush');
+        return await request.fire({ auth, target });
+    }
+    async getWebPushDeliveryStatus(spoolItemIdArg) {
+        const spoolItemId = String(spoolItemIdArg || '').trim();
+        if (!spoolItemId) {
+            throw new Error('spoolItemId is required');
+        }
+        if (this.platformClientRef.debugMode) {
+            return {
+                spoolItemId,
+                state: 'queued',
+                attempts: 0,
+                acceptedAt: 0,
+                updatedAt: 0,
+            };
+        }
+        const { typedSocket, auth } = await this.getAuthenticatedClient();
+        const request = typedSocket.createTypedRequest('getWebPushDeliveryStatus');
+        const result = await request.fire({ auth, spoolItemId });
+        return result.delivery;
+    }
+    async stop() {
+        const socket = this.webPushTypedSocket;
+        const socketPromise = this.webPushTypedSocketPromise;
+        this.webPushTypedSocket = undefined;
+        this.webPushTypedSocketPromise = undefined;
+        this.webPushTypedSocketUrl = undefined;
+        this.webPushTypedSocketAbortController?.abort();
+        this.webPushTypedSocketAbortController = undefined;
+        if (socket) {
+            await socket.stop();
+            return;
+        }
+        if (socketPromise) {
+            try {
+                const pendingSocket = await socketPromise;
+                await pendingSocket.stop();
+            }
+            catch {
+                // A failed or aborted connection leaves no socket to close.
+            }
+        }
+    }
+    async getAuthenticatedClient() {
+        const credentials = await this.getCredentials();
+        return {
+            typedSocket: await this.getWebPushTypedSocket(credentials.typedUrl),
+            auth: {
+                credentialId: credentials.credentialId,
+                credentialSecret: credentials.credentialSecret,
+            },
+        };
+    }
+    async getCredentials() {
+        const env = await this.readWebPushEnv();
+        if (!env.typedUrl)
+            throw new Error('WEB_PUSH_TYPED_URL is required for Web Push');
+        if (!env.credentialId) {
+            throw new Error('WEB_PUSH_API_CREDENTIAL_ID is required for Web Push');
+        }
+        if (!env.credentialSecret) {
+            throw new Error('WEB_PUSH_API_CREDENTIAL_SECRET is required for Web Push');
+        }
+        return {
+            typedUrl: env.typedUrl,
+            credentialId: env.credentialId,
+            credentialSecret: env.credentialSecret,
+        };
+    }
+    async readWebPushEnv() {
+        const directEnv = this.normalizeCredentialBundle({
+            typedUrl: await this.platformClientRef.getConfiguredEnvVar('WEB_PUSH_TYPED_URL'),
+            credentialId: await this.platformClientRef.getConfiguredEnvVar('WEB_PUSH_API_CREDENTIAL_ID'),
+            credentialSecret: await this.platformClientRef.getConfiguredEnvVar('WEB_PUSH_API_CREDENTIAL_SECRET'),
+        });
+        if (this.hasCredentialBundleValue(directEnv)) {
+            return directEnv;
+        }
+        const bindingCredentialBundles = [];
+        for (const binding of this.platformClientRef.platformBindings || []) {
+            if (binding.capability !== 'pushnotification'
+                || binding.desiredState !== 'enabled'
+                || binding.status !== 'ready') {
+                continue;
+            }
+            for (const credential of binding.credentials || []) {
+                const credentialBundle = this.normalizeCredentialBundle({
+                    typedUrl: credential.env?.WEB_PUSH_TYPED_URL,
+                    credentialId: credential.env?.WEB_PUSH_API_CREDENTIAL_ID,
+                    credentialSecret: credential.env?.WEB_PUSH_API_CREDENTIAL_SECRET,
+                });
+                if (this.hasCredentialBundleValue(credentialBundle)) {
+                    bindingCredentialBundles.push(credentialBundle);
+                }
+            }
+        }
+        if (bindingCredentialBundles.length > 1) {
+            throw new Error('Multiple ready Web Push credential bundles are configured; exactly one is required');
+        }
+        return bindingCredentialBundles[0] || {};
+    }
+    normalizeCredentialBundle(bundleArg) {
+        const typedUrl = this.normalizeConfigValue(bundleArg.typedUrl);
+        return {
+            typedUrl: typedUrl ? this.normalizeTypedSocketUrl(typedUrl) || undefined : undefined,
+            credentialId: this.normalizeConfigValue(bundleArg.credentialId),
+            credentialSecret: this.normalizeConfigValue(bundleArg.credentialSecret),
+        };
+    }
+    hasCredentialBundleValue(bundleArg) {
+        return Boolean(bundleArg.typedUrl
+            || bundleArg.credentialId
+            || bundleArg.credentialSecret);
+    }
+    normalizeConfigValue(valueArg) {
+        const value = valueArg?.trim();
+        return value || undefined;
+    }
+    async getWebPushTypedSocket(urlArg) {
+        const normalizedUrl = this.normalizeTypedSocketUrl(urlArg);
+        if (this.webPushTypedSocket && this.webPushTypedSocketUrl === normalizedUrl) {
+            return this.webPushTypedSocket;
+        }
+        if (this.webPushTypedSocketPromise && this.webPushTypedSocketUrl === normalizedUrl) {
+            return await this.webPushTypedSocketPromise;
+        }
+        if (this.webPushTypedSocket || this.webPushTypedSocketPromise) {
+            await this.stop();
+        }
+        this.webPushTypedSocketUrl = normalizedUrl;
+        const abortController = new AbortController();
+        this.webPushTypedSocketAbortController = abortController;
+        const socketPromise = plugins.typedsocket.TypedSocket.createClient(this.platformClientRef.typedrouter, normalizedUrl, { autoReconnect: true, abortSignal: abortController.signal });
+        this.webPushTypedSocketPromise = socketPromise;
+        try {
+            const socket = await socketPromise;
+            if (this.webPushTypedSocketPromise === socketPromise
+                && this.webPushTypedSocketUrl === normalizedUrl) {
+                this.webPushTypedSocket = socket;
+            }
+            else {
+                await socket.stop();
+            }
+            return socket;
+        }
+        catch (error) {
+            if (this.webPushTypedSocketPromise === socketPromise) {
+                this.webPushTypedSocketPromise = undefined;
+                this.webPushTypedSocketUrl = undefined;
+                this.webPushTypedSocketAbortController = undefined;
+            }
+            throw error;
+        }
+    }
+    normalizeTypedSocketUrl(urlArg) {
+        return urlArg.trim().replace(/\/typedrequest\/?$/, '').replace(/\/+$/, '');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy53ZWJwdXNoY29ubmVjdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvd2VicHVzaC9jbGFzc2VzLndlYnB1c2hjb25uZWN0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUF3QnpDOzs7Ozs7R0FNRztBQUNILE1BQU0sT0FBTyxrQkFBa0I7SUFPN0IsWUFBWSxvQkFBc0M7UUFDaEQsSUFBSSxDQUFDLGlCQUFpQixHQUFHLG9CQUFvQixDQUFDO0lBQ2hELENBQUM7SUFFTSxLQUFLLENBQUMsc0JBQXNCO1FBQ2pDLE1BQU0sR0FBRyxHQUFHLE1BQU0sSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO1FBQ3hDLE1BQU0sT0FBTyxHQUFhLEVBQUUsQ0FBQztRQUM3QixJQUFJLENBQUMsR0FBRyxDQUFDLFFBQVE7WUFBRSxPQUFPLENBQUMsSUFBSSxDQUFDLG9CQUFvQixDQUFDLENBQUM7UUFDdEQsSUFBSSxDQUFDLEdBQUcsQ0FBQyxZQUFZO1lBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyw0QkFBNEIsQ0FBQyxDQUFDO1FBQ2xFLElBQUksQ0FBQyxHQUFHLENBQUMsZ0JBQWdCO1lBQUUsT0FBTyxDQUFDLElBQUksQ0FBQyxnQ0FBZ0MsQ0FBQyxDQUFDO1FBQzFFLE9BQU87WUFDTCxVQUFVLEVBQUUsT0FBTyxDQUFDLE1BQU0sS0FBSyxDQUFDO1lBQ2hDLFFBQVEsRUFBRSxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsdUJBQXVCLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTO1lBQy9FLHNCQUFzQixFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsWUFBWSxDQUFDO1lBQ2pELDBCQUEwQixFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsZ0JBQWdCLENBQUM7WUFDekQsT0FBTztTQUNSLENBQUM7SUFDSixD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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/platformclient",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "private": false,
   "description": "a module that makes it really easy to use the serve.zone platform inside your app",
   "main": "dist_ts/index.js",
@@ -22,7 +22,7 @@
     "@push.rocks/qenv": "^6.1.4",
     "@push.rocks/smartlog": "^3.2.2",
     "@push.rocks/smartntml": "^2.0.9",
-    "@serve.zone/interfaces": "^16.4.1"
+    "@serve.zone/interfaces": "^17.4.0"
   },
   "repository": {
     "type": "git",

package/readme.md

@@ -41,6 +41,7 @@ await platformClient.emailConnector.sendEmail({
 | `emailConnector` | `getServiceMailStatus()`, `getServiceMailCredentials()`, `sendMail()`, `sendText()`, `sendHtml()`, `getMailDeliveryStatus()`, `registerInboundHandler()`, `normalizeInboundMessage()`, `handleInboundPayload()`, `createInboundHandler()`, `sendEmail()` | `email` |
 | `smsConnector` | `sendSms()`, `sendSmsVerifcation()` | `sms` |
 | `pushNotificationConnector` | `sendPushNotification()` | `pushnotification` |
+| `webPushConnector` | `getConfigurationStatus()`, `getWebPushServiceStatus()`, `getWebPushPublicKey()`, `enqueueWebPush()`, `cancelWebPush()`, `getWebPushDeliveryStatus()` | `pushnotification` |
 | `letterConnector` | `sendLetter()` | `letter` |
 
 The request and response payloads come from `@serve.zone/interfaces`, so TypeScript stays aligned with the serve.zone platform contracts.
@@ -59,6 +60,8 @@ Binding environment variables must contain JSON encoded `IPlatformBinding` objec
 
 Service mail credentials can be provided directly as environment variables or through `email` platform binding credentials. Standard platformclient mail uses dcrouter TypedSocket/TypedRequest service credentials. The default sender uses `MAIL_FROM`, `MAIL_TYPED_URL`, `MAIL_API_CREDENTIAL_ID`, and `MAIL_API_CREDENTIAL_SECRET`. Additional configured sender addresses use scoped variables such as `MAIL_TEST_SERVICE_GATED_ONE_FROM`, `MAIL_TEST_SERVICE_GATED_ONE_TYPED_URL`, `MAIL_TEST_SERVICE_GATED_ONE_API_CREDENTIAL_ID`, and `MAIL_TEST_SERVICE_GATED_ONE_API_CREDENTIAL_SECRET`.
 
+Managed Web Push uses a separate, credential-scoped TypedSocket connection configured with `WEB_PUSH_TYPED_URL`, `WEB_PUSH_API_CREDENTIAL_ID`, and `WEB_PUSH_API_CREDENTIAL_SECRET`. These values form one atomic bundle: if any direct variable is present, all three direct variables are required; otherwise exactly one credential object from a ready `pushnotification` binding must provide the bundle. Partial or ambiguous bundles fail closed and are never combined. `webPushConnector` never accepts or sends caller-provided authentication or resource-owner fields; dcrouter derives the service scope from the injected credential.
+
 SMTP compatibility credentials are still discoverable with `getServiceMailCredentials()` for applications that explicitly implement SMTP themselves. Those compatibility variables are `SMTP_HOST`, `SMTP_PORT`, `SMTP_TLS_MODE`, `SMTP_USERNAME`, and `SMTP_PASSWORD`, plus scoped `MAIL_<TOKEN>_SMTP_*` variants. They are not used by `sendMail()`, `sendText()`, `sendHtml()`, or `registerInboundHandler()`.
 
 ```typescript
@@ -106,7 +109,7 @@ The current SMS verification method is spelled `sendSmsVerifcation()` in code. U
 
 ## Lifecycle
 
-`SzPlatformClient` keeps TypedSocket connections open for platform requests and typed service-mail delivery. Call `stop()` when a short-lived process, worker, or test is done with the client.
+`SzPlatformClient` keeps TypedSocket connections open for platform requests, typed service-mail delivery, and managed Web Push delivery. Call `stop()` when a short-lived process, worker, or test is done with the client.
 
 ```typescript
 const client = new SzPlatformClient({
@@ -202,7 +205,57 @@ const status = await client.smsConnector.sendSms({
 });
 ```
 
-Push notification:
+Managed Web Push:
+
+```typescript
+const serviceStatus = await client.webPushConnector.getWebPushServiceStatus();
+if (!serviceStatus.ready || !serviceStatus.activeVapidKey) {
+  throw new Error(serviceStatus.message || 'Web Push is not ready');
+}
+const activeVapidKey = serviceStatus.activeVapidKey;
+const applicationServerKey = activeVapidKey.publicKey;
+
+const browserSubscription = await serviceWorkerRegistration.pushManager.subscribe({
+  userVisibleOnly: true,
+  applicationServerKey,
+});
+
+const enqueueResult = await client.webPushConnector.enqueueWebPush({
+  idempotencyKey: 'notification-delivery-42',
+  subscriptionId: 'opaque-application-subscription-id',
+  subscription: browserSubscription.toJSON(),
+  vapidKeyId: activeVapidKey.id,
+  payload: {
+    schemaVersion: 1,
+    event: 'notificationAvailable',
+    eventId: 'notification-event-42',
+    route: '/notifications',
+  },
+  ttlSeconds: 300,
+  urgency: 'normal',
+  collapseKey: 'notification-inbox',
+});
+
+if (enqueueResult.spoolItemId) {
+  const delivery = await client.webPushConnector.getWebPushDeliveryStatus(
+    enqueueResult.spoolItemId,
+  );
+  console.log(delivery?.state);
+}
+```
+
+The active VAPID key ID and public key come from one service-status snapshot, so a rotation cannot mismatch the subscription key and enqueue key ID. Store browser subscriptions as sensitive application data and only send the privacy-minimal `notificationAvailable` payload shown above. `enqueueWebPush().accepted` means dcrouter accepted the item into its delivery spool; it does not prove browser receipt or display. A terminal `pushServiceAccepted` state means the remote push service accepted the encrypted request.
+
+Pending delivery can be cancelled by spool item or by opaque application subscription ID:
+
+```typescript
+await client.webPushConnector.cancelWebPush({
+  type: 'subscription',
+  subscriptionId: 'opaque-application-subscription-id',
+});
+```
+
+Legacy device-token push:
 
 ```typescript
 const status = await client.pushNotificationConnector.sendPushNotification({
@@ -223,7 +276,7 @@ await client.letterConnector.sendLetter({
 });
 ```
 
-Service-mail helper option and result types are exported from `@serve.zone/platformclient`. `IServiceMailSendResult.spoolItemId` identifies the dcrouter delivery spool item for follow-up status queries through `getMailDeliveryStatus(spoolItemId, address?)`. The legacy platform-service request fields are defined in `@serve.zone/interfaces` under `platform.email`, `platform.sms`, `platform.pushnotification`, and `platform.letter`.
+Service-mail and managed Web Push helper types are exported from `@serve.zone/platformclient`. `IServiceMailSendResult.spoolItemId` identifies the dcrouter delivery spool item for follow-up status queries through `getMailDeliveryStatus(spoolItemId, address?)`. `IServiceWebPushEnqueueOptions` and `TServiceWebPushCancellationTarget` mirror the credential-scoped Web Push delivery contract without exposing auth or owner fields. The legacy platform-service request fields remain under `platform.email`, `platform.sms`, `platform.pushnotification`, and `platform.letter`.
 
 ## Platform Bindings
 

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/platformclient',
-  version: '2.2.0',
+  version: '2.3.0',
   description: 'a module that makes it really easy to use the serve.zone platform inside your app'
 }

package/ts/classes.platformclient.ts

@@ -2,6 +2,7 @@ import { SzEmailConnector } from './email/classes.emailconnector.js';
 import { SzSmsConnector } from './email/classes.smsconnector.js';
 import { SzPushNotificationConnector } from './email/classes.pushnotificationconnector.js';
 import { SzLetterConnector } from './email/classes.letterconnector.js';
+import { SzWebPushConnector } from './webpush/classes.webpushconnector.js';
 import * as plugins from './plugins.js';
 
 export interface ISzPlatformClientOptions {
@@ -26,6 +27,7 @@ export class SzPlatformClient {
   public emailConnector = new SzEmailConnector(this);
   public smsConnector = new SzSmsConnector(this);
   public pushNotificationConnector = new SzPushNotificationConnector(this);
+  public webPushConnector = new SzWebPushConnector(this);
   public letterConnector = new SzLetterConnector(this);
 
   constructor(authorizationStringArg?: string | ISzPlatformClientOptions) {
@@ -175,7 +177,10 @@ export class SzPlatformClient {
   }
 
   public async stop(): Promise<void> {
-    await this.emailConnector.stop();
+    await Promise.all([
+      this.emailConnector.stop(),
+      this.webPushConnector.stop(),
+    ]);
     if (this.typedsocket) {
       await this.typedsocket.stop();
     }

package/ts/index.ts

@@ -1,2 +1,3 @@
 export * from './classes.platformclient.js';
 export * from './email/classes.emailconnector.js';
+export * from './webpush/classes.webpushconnector.js';

package/ts/webpush/classes.webpushconnector.ts

@@ -0,0 +1,341 @@
+import type { SzPlatformClient } from '../classes.platformclient.js';
+import * as plugins from '../plugins.js';
+
+export interface IServiceWebPushCredentials {
+  typedUrl: string;
+  credentialId: string;
+  credentialSecret: string;
+}
+
+export interface IServiceWebPushConfigurationStatus {
+  configured: boolean;
+  typedUrl?: string;
+  credentialIdConfigured: boolean;
+  credentialSecretConfigured: boolean;
+  missing: string[];
+}
+
+export interface IServiceWebPushEnqueueOptions extends Omit<
+  plugins.servezoneInterfaces.requests.webpush.IReq_EnqueueWebPush['request'],
+  'auth' | 'owner'
+> {}
+
+export type TServiceWebPushCancellationTarget =
+  plugins.servezoneInterfaces.data.TWebPushCancellationTarget;
+
+/**
+ * Credential-scoped Web Push delivery for a deployed service.
+ *
+ * This connector is separate from the legacy device-token push connector. It
+ * only accepts the service credential injected into the workload and never
+ * sends a caller-provided owner scope.
+ */
+export class SzWebPushConnector {
+  public platformClientRef: SzPlatformClient;
+  private webPushTypedSocket?: plugins.typedsocket.TypedSocket;
+  private webPushTypedSocketUrl?: string;
+  private webPushTypedSocketPromise?: Promise<plugins.typedsocket.TypedSocket>;
+  private webPushTypedSocketAbortController?: AbortController;
+
+  constructor(platformClientRefArg: SzPlatformClient) {
+    this.platformClientRef = platformClientRefArg;
+  }
+
+  public async getConfigurationStatus(): Promise<IServiceWebPushConfigurationStatus> {
+    const env = await this.readWebPushEnv();
+    const missing: string[] = [];
+    if (!env.typedUrl) missing.push('WEB_PUSH_TYPED_URL');
+    if (!env.credentialId) missing.push('WEB_PUSH_API_CREDENTIAL_ID');
+    if (!env.credentialSecret) missing.push('WEB_PUSH_API_CREDENTIAL_SECRET');
+    return {
+      configured: missing.length === 0,
+      typedUrl: env.typedUrl ? this.normalizeTypedSocketUrl(env.typedUrl) : undefined,
+      credentialIdConfigured: Boolean(env.credentialId),
+      credentialSecretConfigured: Boolean(env.credentialSecret),
+      missing,
+    };
+  }
+
+  public async getWebPushServiceStatus():
+    Promise<plugins.servezoneInterfaces.data.IWebPushServiceStatus> {
+    if (this.platformClientRef.debugMode) {
+      return {
+        ready: false,
+        bindingId: 'debug',
+        bindingStatus: 'disabled',
+        retiringVapidKeys: [],
+        maxPayloadBytes: 0,
+        maxTtlSeconds: 0,
+        contentEncoding: 'aes128gcm',
+        message: 'Web Push is disabled in platformclient debug mode',
+      };
+    }
+    const { typedSocket, auth } = await this.getAuthenticatedClient();
+    const request = typedSocket.createTypedRequest<
+      plugins.servezoneInterfaces.requests.webpush.IReq_GetWebPushServiceStatus
+    >('getWebPushServiceStatus');
+    return await request.fire({ auth });
+  }
+
+  public async getWebPushPublicKey(): Promise<string> {
+    const status = await this.getWebPushServiceStatus();
+    if (!status.ready || !status.activeVapidKey?.publicKey) {
+      throw new Error(status.message || 'Web Push is not ready');
+    }
+    return status.activeVapidKey.publicKey;
+  }
+
+  public async enqueueWebPush(
+    optionsArg: IServiceWebPushEnqueueOptions,
+  ): Promise<plugins.servezoneInterfaces.requests.webpush.IReq_EnqueueWebPush['response']> {
+    if (!optionsArg.idempotencyKey?.trim()) {
+      throw new Error('idempotencyKey is required');
+    }
+    if (!optionsArg.subscriptionId?.trim()) {
+      throw new Error('subscriptionId is required');
+    }
+    if (this.platformClientRef.debugMode) {
+      return {
+        accepted: true,
+        spoolItemId: 'debug',
+        message: 'Web Push accepted in platformclient debug mode',
+      };
+    }
+    const { typedSocket, auth } = await this.getAuthenticatedClient();
+    const request = typedSocket.createTypedRequest<
+      plugins.servezoneInterfaces.requests.webpush.IReq_EnqueueWebPush
+    >('enqueueWebPush');
+    return await request.fire({
+      auth,
+      idempotencyKey: optionsArg.idempotencyKey.trim(),
+      subscriptionId: optionsArg.subscriptionId.trim(),
+      subscription: optionsArg.subscription,
+      vapidKeyId: optionsArg.vapidKeyId,
+      payload: optionsArg.payload,
+      ttlSeconds: optionsArg.ttlSeconds,
+      urgency: optionsArg.urgency,
+      collapseKey: optionsArg.collapseKey,
+    });
+  }
+
+  public async cancelWebPush(
+    targetArg: TServiceWebPushCancellationTarget,
+  ): Promise<plugins.servezoneInterfaces.requests.webpush.IReq_CancelWebPush['response']> {
+    if (targetArg.type === 'spoolItem' && !targetArg.spoolItemId?.trim()) {
+      throw new Error('spoolItemId is required');
+    }
+    if (targetArg.type === 'subscription' && !targetArg.subscriptionId?.trim()) {
+      throw new Error('subscriptionId is required');
+    }
+    const target = targetArg.type === 'spoolItem'
+      ? { type: 'spoolItem' as const, spoolItemId: targetArg.spoolItemId.trim() }
+      : { type: 'subscription' as const, subscriptionId: targetArg.subscriptionId.trim() };
+    if (this.platformClientRef.debugMode) {
+      return {
+        success: true,
+        cancelledCount: 0,
+        alreadyTerminalCount: 0,
+        message: 'Web Push cancellation accepted in platformclient debug mode',
+      };
+    }
+    const { typedSocket, auth } = await this.getAuthenticatedClient();
+    const request = typedSocket.createTypedRequest<
+      plugins.servezoneInterfaces.requests.webpush.IReq_CancelWebPush
+    >('cancelWebPush');
+    return await request.fire({ auth, target });
+  }
+
+  public async getWebPushDeliveryStatus(
+    spoolItemIdArg: string,
+  ): Promise<plugins.servezoneInterfaces.data.IWebPushDeliveryStatus | undefined> {
+    const spoolItemId = String(spoolItemIdArg || '').trim();
+    if (!spoolItemId) {
+      throw new Error('spoolItemId is required');
+    }
+    if (this.platformClientRef.debugMode) {
+      return {
+        spoolItemId,
+        state: 'queued',
+        attempts: 0,
+        acceptedAt: 0,
+        updatedAt: 0,
+      };
+    }
+    const { typedSocket, auth } = await this.getAuthenticatedClient();
+    const request = typedSocket.createTypedRequest<
+      plugins.servezoneInterfaces.requests.webpush.IReq_GetWebPushDeliveryStatus
+    >('getWebPushDeliveryStatus');
+    const result = await request.fire({ auth, spoolItemId });
+    return result.delivery;
+  }
+
+  public async stop(): Promise<void> {
+    const socket = this.webPushTypedSocket;
+    const socketPromise = this.webPushTypedSocketPromise;
+    this.webPushTypedSocket = undefined;
+    this.webPushTypedSocketPromise = undefined;
+    this.webPushTypedSocketUrl = undefined;
+    this.webPushTypedSocketAbortController?.abort();
+    this.webPushTypedSocketAbortController = undefined;
+    if (socket) {
+      await socket.stop();
+      return;
+    }
+    if (socketPromise) {
+      try {
+        const pendingSocket = await socketPromise;
+        await pendingSocket.stop();
+      } catch {
+        // A failed or aborted connection leaves no socket to close.
+      }
+    }
+  }
+
+  private async getAuthenticatedClient(): Promise<{
+    typedSocket: plugins.typedsocket.TypedSocket;
+    auth: plugins.servezoneInterfaces.requests.webpush.IWebPushAppCredentialAuth;
+  }> {
+    const credentials = await this.getCredentials();
+    return {
+      typedSocket: await this.getWebPushTypedSocket(credentials.typedUrl),
+      auth: {
+        credentialId: credentials.credentialId,
+        credentialSecret: credentials.credentialSecret,
+      },
+    };
+  }
+
+  private async getCredentials(): Promise<IServiceWebPushCredentials> {
+    const env = await this.readWebPushEnv();
+    if (!env.typedUrl) throw new Error('WEB_PUSH_TYPED_URL is required for Web Push');
+    if (!env.credentialId) {
+      throw new Error('WEB_PUSH_API_CREDENTIAL_ID is required for Web Push');
+    }
+    if (!env.credentialSecret) {
+      throw new Error('WEB_PUSH_API_CREDENTIAL_SECRET is required for Web Push');
+    }
+    return {
+      typedUrl: env.typedUrl,
+      credentialId: env.credentialId,
+      credentialSecret: env.credentialSecret,
+    };
+  }
+
+  private async readWebPushEnv(): Promise<{
+    typedUrl?: string;
+    credentialId?: string;
+    credentialSecret?: string;
+  }> {
+    const directEnv = this.normalizeCredentialBundle({
+      typedUrl: await this.platformClientRef.getConfiguredEnvVar('WEB_PUSH_TYPED_URL'),
+      credentialId: await this.platformClientRef.getConfiguredEnvVar(
+        'WEB_PUSH_API_CREDENTIAL_ID',
+      ),
+      credentialSecret: await this.platformClientRef.getConfiguredEnvVar(
+        'WEB_PUSH_API_CREDENTIAL_SECRET',
+      ),
+    });
+    if (this.hasCredentialBundleValue(directEnv)) {
+      return directEnv;
+    }
+
+    const bindingCredentialBundles: Array<Partial<IServiceWebPushCredentials>> = [];
+    for (const binding of this.platformClientRef.platformBindings || []) {
+      if (
+        binding.capability !== 'pushnotification'
+        || binding.desiredState !== 'enabled'
+        || binding.status !== 'ready'
+      ) {
+        continue;
+      }
+      for (const credential of binding.credentials || []) {
+        const credentialBundle = this.normalizeCredentialBundle({
+          typedUrl: credential.env?.WEB_PUSH_TYPED_URL,
+          credentialId: credential.env?.WEB_PUSH_API_CREDENTIAL_ID,
+          credentialSecret: credential.env?.WEB_PUSH_API_CREDENTIAL_SECRET,
+        });
+        if (this.hasCredentialBundleValue(credentialBundle)) {
+          bindingCredentialBundles.push(credentialBundle);
+        }
+      }
+    }
+
+    if (bindingCredentialBundles.length > 1) {
+      throw new Error(
+        'Multiple ready Web Push credential bundles are configured; exactly one is required',
+      );
+    }
+    return bindingCredentialBundles[0] || {};
+  }
+
+  private normalizeCredentialBundle(bundleArg: {
+    typedUrl?: string;
+    credentialId?: string;
+    credentialSecret?: string;
+  }): Partial<IServiceWebPushCredentials> {
+    const typedUrl = this.normalizeConfigValue(bundleArg.typedUrl);
+    return {
+      typedUrl: typedUrl ? this.normalizeTypedSocketUrl(typedUrl) || undefined : undefined,
+      credentialId: this.normalizeConfigValue(bundleArg.credentialId),
+      credentialSecret: this.normalizeConfigValue(bundleArg.credentialSecret),
+    };
+  }
+
+  private hasCredentialBundleValue(bundleArg: Partial<IServiceWebPushCredentials>): boolean {
+    return Boolean(
+      bundleArg.typedUrl
+      || bundleArg.credentialId
+      || bundleArg.credentialSecret,
+    );
+  }
+
+  private normalizeConfigValue(valueArg?: string): string | undefined {
+    const value = valueArg?.trim();
+    return value || undefined;
+  }
+
+  private async getWebPushTypedSocket(urlArg: string): Promise<plugins.typedsocket.TypedSocket> {
+    const normalizedUrl = this.normalizeTypedSocketUrl(urlArg);
+    if (this.webPushTypedSocket && this.webPushTypedSocketUrl === normalizedUrl) {
+      return this.webPushTypedSocket;
+    }
+    if (this.webPushTypedSocketPromise && this.webPushTypedSocketUrl === normalizedUrl) {
+      return await this.webPushTypedSocketPromise;
+    }
+    if (this.webPushTypedSocket || this.webPushTypedSocketPromise) {
+      await this.stop();
+    }
+    this.webPushTypedSocketUrl = normalizedUrl;
+    const abortController = new AbortController();
+    this.webPushTypedSocketAbortController = abortController;
+    const socketPromise = plugins.typedsocket.TypedSocket.createClient(
+      this.platformClientRef.typedrouter,
+      normalizedUrl,
+      { autoReconnect: true, abortSignal: abortController.signal },
+    );
+    this.webPushTypedSocketPromise = socketPromise;
+    try {
+      const socket = await socketPromise;
+      if (
+        this.webPushTypedSocketPromise === socketPromise
+        && this.webPushTypedSocketUrl === normalizedUrl
+      ) {
+        this.webPushTypedSocket = socket;
+      } else {
+        await socket.stop();
+      }
+      return socket;
+    } catch (error) {
+      if (this.webPushTypedSocketPromise === socketPromise) {
+        this.webPushTypedSocketPromise = undefined;
+        this.webPushTypedSocketUrl = undefined;
+        this.webPushTypedSocketAbortController = undefined;
+      }
+      throw error;
+    }
+  }
+
+  private normalizeTypedSocketUrl(urlArg: string): string {
+    return urlArg.trim().replace(/\/typedrequest\/?$/, '').replace(/\/+$/, '');
+  }
+}