@endora-commerce/mod-pwa 0.100.0

package/dist/backend/services/pwa-config-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-config-resolver.js","sourceRoot":"","sources":["../../../src/backend/services/pwa-config-resolver.ts"],"names":[],"mappings":"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"}

package/dist/backend/services/pwa-icon-service.d.ts

@@ -0,0 +1,44 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type PwaIconPurpose, type PwaIconRendition as PwaIconRenditionDto } from '@endora-commerce/contracts';
+/** Thrown when an uploaded icon fails validation (FR-010). */
+export declare class PwaIconInvalid extends Error {
+    readonly name = "PwaIconInvalid";
+    readonly code: "PWA_ICON_INVALID";
+    constructor(message: string);
+}
+/** Minimal upload port over the assets_library service. */
+export interface AssetUploadPort {
+    upload(input: {
+        filename: string;
+        declaredMime: string;
+        stream: NodeJS.ReadableStream;
+        declaredSize: number;
+        folderId: string | null;
+        label: string | null;
+        visibility: 'public' | 'private';
+    }): Promise<{
+        id: string;
+    }>;
+}
+/**
+ * Derives the PWA icon rendition set (FR-005) from a single admin-uploaded
+ * source image using `sharp`, after validating format/dimensions/aspect
+ * (FR-010). Source + derived PNGs are stored via the assets_library; rendition
+ * rows replace the channel's prior set transactionally.
+ */
+export declare class PwaIconService {
+    private readonly emFactory;
+    private readonly assets;
+    constructor(emFactory: () => EntityManager, assets: AssetUploadPort);
+    ingest(input: {
+        salesChannelId: string | null;
+        declaredMime: string;
+        buffer: Buffer;
+    }): Promise<{
+        sourceAssetId: string;
+        renditions: PwaIconRenditionDto[];
+    }>;
+    /** Resolve the asset id of a rendition for a channel (or global fallback). */
+    resolveRenditionAssetId(salesChannelId: string, size: number, purpose: PwaIconPurpose): Promise<string | null>;
+}
+//# sourceMappingURL=pwa-icon-service.d.ts.map

package/dist/backend/services/pwa-icon-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-icon-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/pwa-icon-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,gBAAgB,IAAI,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/H,8DAA8D;AAC9D,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAkB,IAAI,oBAAoB;IAC1C,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;gBAChC,OAAO,EAAE,MAAM;CAG5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;KAClC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7B;AAUD;;;;;GAKG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,SAAS,EAAE,MAAM,aAAa,EAC9B,MAAM,EAAE,eAAe;IAGpC,MAAM,CAAC,KAAK,EAAE;QAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;IAkEzE,8EAA8E;IACxE,uBAAuB,CAC3B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAO1B"}

package/dist/backend/services/pwa-icon-service.js

@@ -0,0 +1,105 @@
+import { Readable } from 'node:stream';
+import { createHash } from 'node:crypto';
+import sharp from 'sharp';
+import { PWA_ICON_SIZES } from '@endora-commerce/contracts';
+import { PwaIconRendition } from '../entities/pwa-icon-rendition.entity.js';
+/** Thrown when an uploaded icon fails validation (FR-010). */
+export class PwaIconInvalid extends Error {
+    name = 'PwaIconInvalid';
+    code = 'PWA_ICON_INVALID';
+    constructor(message) {
+        super(message);
+    }
+}
+const MIN_SIZE = 512;
+const ALLOWED_MIME = new Set(['image/png', 'image/webp']);
+/** (size, purpose) pairs to derive. 'maskable' only for the largest size. */
+const RENDITION_PLAN = [
+    ...PWA_ICON_SIZES.map((size) => ({ size, purpose: 'any' })),
+    { size: 512, purpose: 'maskable' },
+];
+/**
+ * Derives the PWA icon rendition set (FR-005) from a single admin-uploaded
+ * source image using `sharp`, after validating format/dimensions/aspect
+ * (FR-010). Source + derived PNGs are stored via the assets_library; rendition
+ * rows replace the channel's prior set transactionally.
+ */
+export class PwaIconService {
+    emFactory;
+    assets;
+    constructor(emFactory, assets) {
+        this.emFactory = emFactory;
+        this.assets = assets;
+    }
+    async ingest(input) {
+        // command-coverage-ignore: push-notification infrastructure — device
+        // subscription / message delivery / icon asset, not audited domain state.
+        if (!ALLOWED_MIME.has(input.declaredMime)) {
+            throw new PwaIconInvalid('The icon must be a PNG or WebP image.');
+        }
+        const meta = await sharp(input.buffer).metadata();
+        const width = meta.width ?? 0;
+        const height = meta.height ?? 0;
+        if (width < MIN_SIZE || height < MIN_SIZE) {
+            throw new PwaIconInvalid(`The icon must be at least ${MIN_SIZE}×${MIN_SIZE} pixels.`);
+        }
+        // Square within ±1%.
+        if (Math.abs(width - height) / Math.max(width, height) > 0.01) {
+            throw new PwaIconInvalid('The icon must be square.');
+        }
+        // Store the source image.
+        const source = await this.assets.upload({
+            filename: 'pwa-icon-source.png',
+            declaredMime: 'image/png',
+            stream: Readable.from(input.buffer),
+            declaredSize: input.buffer.length,
+            folderId: null,
+            label: 'PWA icon source',
+            visibility: 'public',
+        });
+        // Derive + store each rendition.
+        const renditions = [];
+        const em = this.emFactory();
+        // Replace the channel's prior renditions (best-effort cleanup of rows).
+        const prior = await em.find(PwaIconRendition, { salesChannelId: input.salesChannelId });
+        if (prior.length > 0)
+            await em.removeAndFlush(prior);
+        for (const plan of RENDITION_PLAN) {
+            const pipeline = sharp(input.buffer).resize(plan.size, plan.size, { fit: 'cover' });
+            // Maskable icons need safe padding; keep it simple — cover then flatten.
+            const png = await pipeline.png().toBuffer();
+            const contentHash = createHash('sha256').update(png).digest('hex');
+            const asset = await this.assets.upload({
+                filename: `pwa-icon-${plan.size}-${plan.purpose}.png`,
+                declaredMime: 'image/png',
+                stream: Readable.from(png),
+                declaredSize: png.length,
+                folderId: null,
+                label: `PWA icon ${plan.size} ${plan.purpose}`,
+                visibility: 'public',
+            });
+            const row = em.create(PwaIconRendition, {
+                salesChannelId: input.salesChannelId,
+                sourceAssetId: source.id,
+                size: plan.size,
+                purpose: plan.purpose,
+                assetId: asset.id,
+                contentHash,
+            });
+            em.persist(row);
+            renditions.push({ size: plan.size, purpose: plan.purpose, assetId: asset.id, contentHash });
+        }
+        await em.flush();
+        return { sourceAssetId: source.id, renditions };
+    }
+    /** Resolve the asset id of a rendition for a channel (or global fallback). */
+    async resolveRenditionAssetId(salesChannelId, size, purpose) {
+        const em = this.emFactory();
+        const channelRow = await em.findOne(PwaIconRendition, { salesChannelId, size, purpose });
+        if (channelRow)
+            return channelRow.assetId;
+        const globalRow = await em.findOne(PwaIconRendition, { salesChannelId: null, size, purpose });
+        return globalRow?.assetId ?? null;
+    }
+}
+//# sourceMappingURL=pwa-icon-service.js.map

package/dist/backend/services/pwa-icon-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa-icon-service.js","sourceRoot":"","sources":["../../../src/backend/services/pwa-icon-service.ts"],"names":[],"mappings":"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"}

package/dist/backend/workers/push-delivery-worker.d.ts

@@ -0,0 +1,17 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { Job } from 'bullmq';
+import type { PushProviderRegistryPort } from '@endora-commerce/contracts';
+import type { PushDeliveryJobData } from '../services/push-delivery-queue.js';
+export interface PushDeliveryProcessorDeps {
+    emFactory: () => EntityManager;
+    registry: PushProviderRegistryPort;
+}
+/**
+ * Push delivery processor (Principle X). Sends one delivery row, idempotent on
+ * the unique (message_id, subscription_id): an already-`sent` row is skipped so
+ * BullMQ retries never produce a duplicate user-visible push. A `gone` result
+ * prunes the dead subscription (FR-022). Retryable failures throw to let BullMQ
+ * back off and retry.
+ */
+export declare function makePushDeliveryProcessor(deps: PushDeliveryProcessorDeps): (job: Job<PushDeliveryJobData>) => Promise<void>;
+//# sourceMappingURL=push-delivery-worker.d.ts.map

package/dist/backend/workers/push-delivery-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-delivery-worker.d.ts","sourceRoot":"","sources":["../../../src/backend/workers/push-delivery-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAI3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,yBAAyB,IAYzD,KAAK,GAAG,CAAC,mBAAmB,CAAC,KAAG,OAAO,CAAC,IAAI,CAAC,CAyE5D"}

package/dist/backend/workers/push-delivery-worker.js

@@ -0,0 +1,105 @@
+import { PushMessage } from '../entities/push-message.entity.js';
+import { PushMessageDelivery } from '../entities/push-message-delivery.entity.js';
+import { PushSubscription } from '../entities/push-subscription.entity.js';
+/**
+ * Push delivery processor (Principle X). Sends one delivery row, idempotent on
+ * the unique (message_id, subscription_id): an already-`sent` row is skipped so
+ * BullMQ retries never produce a duplicate user-visible push. A `gone` result
+ * prunes the dead subscription (FR-022). Retryable failures throw to let BullMQ
+ * back off and retry.
+ */
+export function makePushDeliveryProcessor(deps) {
+    // command-coverage-ignore: delivery-state bookkeeping for an operation already
+    // audited at its start — the operator's write was creating and sending the
+    // PushMessage. Attempt counters, `sent`/`failed`/`pruned` transitions and the
+    // pruning of a subscription the push endpoint reported `gone` are the machine
+    // reporting on that one decision; an audit row per delivery would say nothing
+    // about who did what, and there are as many as there are subscribers.
+    //
+    // Feature 050 — a BullMQ job runs detached and needs an ambient tenant
+    // context for the PushSubscription reads (fail-closed guard). Feature 072
+    // (T033) moved that wrapper out to the `new Worker(...)` site, where every
+    // other queue in the tree puts it, so the processor is a plain function again.
+    return async (job) => {
+        const em = deps.emFactory();
+        const delivery = await em.findOne(PushMessageDelivery, { id: job.data.deliveryId });
+        if (!delivery)
+            return; // delivery (or its message) was removed — nothing to do
+        if (delivery.status === 'sent' || delivery.status === 'pruned')
+            return; // idempotent
+        const [message, subscription] = await Promise.all([
+            em.findOne(PushMessage, { id: delivery.messageId }),
+            em.findOne(PushSubscription, { id: delivery.subscriptionId }),
+        ]);
+        if (!message || !subscription || subscription.status !== 'active') {
+            delivery.status = 'failed';
+            delivery.lastError = 'message or subscription missing/inactive';
+            delivery.attemptedAt = new Date();
+            await em.flush();
+            return;
+        }
+        const provider = deps.registry.get(subscription.provider) ??
+            (await deps.registry.resolveDefault(message.salesChannelId));
+        delivery.attempts += 1;
+        delivery.attemptedAt = new Date();
+        const result = await provider.send({
+            endpoint: subscription.endpoint,
+            keys: { p256dh: subscription.p256dh, auth: subscription.auth },
+            provider: subscription.provider,
+            salesChannelId: message.salesChannelId,
+        }, {
+            title: message.title,
+            body: message.body,
+            ...(message.iconUrl ? { iconUrl: message.iconUrl } : {}),
+            ...(message.url ? { url: message.url } : {}),
+            tag: message.id,
+        });
+        if (result.ok) {
+            delivery.status = 'sent';
+            message.sentCount += 1;
+            await em.flush();
+            await maybeFinalize(em, message);
+            return;
+        }
+        if (result.gone === true) {
+            delivery.status = 'pruned';
+            subscription.status = 'invalid';
+            message.failedCount += 1;
+            await em.flush();
+            await em.removeAndFlush(subscription);
+            await maybeFinalize(em, message);
+            return;
+        }
+        // Non-`gone` failure.
+        delivery.lastError = result.error;
+        if (result.retryable) {
+            // Persist the attempt counter, then throw so BullMQ retries/backs off.
+            delivery.status = 'pending';
+            await em.flush();
+            throw new Error(`push delivery ${delivery.id} failed (retryable): ${result.error}`);
+        }
+        delivery.status = 'failed';
+        message.failedCount += 1;
+        await em.flush();
+        await maybeFinalize(em, message);
+    };
+}
+/**
+ * Flip the parent message to a terminal status once every delivery has resolved.
+ * Best-effort — not transactional with the delivery write (the counts are the
+ * source of truth for the admin history).
+ */
+async function maybeFinalize(em, message) {
+    // command-coverage-ignore: closes out the same already-audited send. The
+    // terminal status is derived from the delivery counts, not chosen by anybody.
+    const pending = await em.count(PushMessageDelivery, {
+        messageId: message.id,
+        status: 'pending',
+    });
+    if (pending > 0)
+        return;
+    message.status = message.failedCount > 0 && message.sentCount === 0 ? 'failed' : 'sent';
+    message.sentAt = new Date();
+    await em.flush();
+}
+//# sourceMappingURL=push-delivery-worker.js.map

package/dist/backend/workers/push-delivery-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-delivery-worker.js","sourceRoot":"","sources":["../../../src/backend/workers/push-delivery-worker.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,184 @@
+/** Settings-only export consumed by the boot-time ManifestReconciler list. */
+export declare const pwaSettingsManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("invoice" | "email" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAyIA,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAE5C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8EnB,CAAC"}