@serve.zone/coremail 1.0.0

package/dist_ts/classes.desiredstate.d.ts

@@ -0,0 +1,40 @@
+import * as plugins from './plugins.js';
+import { type ICoreMailModels } from './classes.models.js';
+import { CoreMailStorage } from './classes.storage.js';
+import { CoreMailTransferService } from './classes.transfer.js';
+import type { ICoreMailReplicaRuntime } from './interfaces.js';
+type TCoreMailDesiredState = plugins.serveZoneInterfaces.data.ICoreMailDesiredState;
+type TCoreMailStatus = plugins.serveZoneInterfaces.data.ICoreMailReconciliationStatus;
+export declare class CoreMailDesiredStateService {
+    private readonly database;
+    private readonly models;
+    private readonly storage;
+    private readonly transfers;
+    private readonly replica;
+    private readonly activeSessionCounts;
+    private readonly now;
+    private activeDesiredState;
+    private activeStatePointer;
+    private refreshTask;
+    constructor(database: plugins.smartdata.SmartdataDb, models: ICoreMailModels, storage: CoreMailStorage, transfers: CoreMailTransferService, replica: ICoreMailReplicaRuntime, activeSessionCounts: (bindingArg: plugins.serveZoneInterfaces.data.ICoreMailBindingDesiredState, configEpochArg: number) => Array<{
+        credentialId: string;
+        version: number;
+        count: number;
+    }>, now?: () => number);
+    private controlAuthority;
+    start(): Promise<void>;
+    getActiveDesiredState: () => Promise<TCoreMailDesiredState | null>;
+    private refresh;
+    private refreshFromPointer;
+    private loadDesiredState;
+    private parseDesiredState;
+    prepare(requestArg: plugins.serveZoneInterfaces.requests.coremail.IReq_CoreMailPrepareDesiredStateUpload['request']): Promise<{
+        reconciliationId: string;
+        grant: plugins.serveZoneInterfaces.data.ICoreMailUploadGrant;
+        replayed: boolean;
+    }>;
+    apply(requestArg: plugins.serveZoneInterfaces.requests.coremail.IReq_CoreMailApplyDesiredState['request']): Promise<TCoreMailStatus>;
+    getStatus(requestArg: plugins.serveZoneInterfaces.requests.coremail.IReq_CoreMailGetReconciliationStatus['request']): Promise<TCoreMailStatus>;
+    private createStatus;
+}
+export {};

package/dist_ts/classes.desiredstate.js

@@ -0,0 +1,382 @@
+import * as plugins from './plugins.js';
+import {} from './classes.models.js';
+import { CoreMailStorage, createSha256 } from './classes.storage.js';
+import { CoreMailTransferService } from './classes.transfer.js';
+import { logCoreMailFailure } from './coremail.log.js';
+import { withCoreMailTransaction } from './coremail.quota.js';
+import { requireCoreMailSafeInteger, requireCoreMailUuid, } from './coremail.selectors.js';
+const emptyStateDigest = createSha256('');
+export class CoreMailDesiredStateService {
+    database;
+    models;
+    storage;
+    transfers;
+    replica;
+    activeSessionCounts;
+    now;
+    activeDesiredState = null;
+    activeStatePointer;
+    refreshTask = null;
+    constructor(database, models, storage, transfers, replica, activeSessionCounts, now = Date.now) {
+        this.database = database;
+        this.models = models;
+        this.storage = storage;
+        this.transfers = transfers;
+        this.replica = replica;
+        this.activeSessionCounts = activeSessionCounts;
+        this.now = now;
+    }
+    controlAuthority() {
+        return {
+            kind: 'control',
+            tenantId: '-',
+            serviceId: this.replica.serviceId,
+            bindingId: '-',
+        };
+    }
+    async start() {
+        const initialized = await this.models.State.exact.insert({
+            stateId: 'active',
+            appliedConfigEpoch: 0,
+            appliedDesiredStateDigest: emptyStateDigest,
+            snapshotId: '-',
+            updatedAt: this.now(),
+        });
+        const state = initialized.document;
+        if (!state) {
+            throw new Error('CoreMail could not initialize its desired-state pointer.');
+        }
+        this.activeStatePointer = state;
+        await this.refreshFromPointer(state);
+    }
+    getActiveDesiredState = async () => {
+        await this.refresh();
+        return this.activeDesiredState;
+    };
+    async refresh() {
+        if (this.refreshTask) {
+            await this.refreshTask;
+            return;
+        }
+        const task = (async () => {
+            const pointer = await this.models.State.exact.findStoredOne({
+                stateId: 'active',
+            });
+            if (!pointer) {
+                throw new Error('CoreMail desired-state pointer is unavailable.');
+            }
+            await this.refreshFromPointer(pointer);
+        })();
+        this.refreshTask = task;
+        try {
+            await task;
+        }
+        finally {
+            if (this.refreshTask === task) {
+                this.refreshTask = null;
+            }
+        }
+    }
+    async refreshFromPointer(pointerArg) {
+        if (pointerArg.appliedConfigEpoch === 0) {
+            this.activeStatePointer = pointerArg;
+            this.activeDesiredState = null;
+            return;
+        }
+        if (this.activeDesiredState?.configEpoch === pointerArg.appliedConfigEpoch
+            && this.activeStatePointer?.snapshotId === pointerArg.snapshotId
+            && this.activeStatePointer.appliedDesiredStateDigest
+                === pointerArg.appliedDesiredStateDigest) {
+            this.activeStatePointer = pointerArg;
+            return;
+        }
+        const desiredState = await this.loadDesiredState(pointerArg);
+        this.activeStatePointer = pointerArg;
+        this.activeDesiredState = desiredState;
+    }
+    async loadDesiredState(stateArg) {
+        const snapshot = await this.models.DesiredSnapshot.exact.findStoredOne({
+            snapshotId: stateArg.snapshotId,
+            configEpoch: stateArg.appliedConfigEpoch,
+            desiredStateDigest: stateArg.appliedDesiredStateDigest,
+        });
+        if (!snapshot
+            || (snapshot.state !== 'staged' && snapshot.state !== 'active')) {
+            throw new Error('CoreMail active desired-state snapshot is unavailable.');
+        }
+        const bytes = await this.storage.getVerifiedBytes(snapshot.objectKey, snapshot.lengthBytes, snapshot.desiredStateDigest, plugins.serveZoneInterfaces.data.coreMailLimits.desiredStateBytes);
+        const desiredState = await this.parseDesiredState(bytes, snapshot.configEpoch, snapshot.desiredStateDigest);
+        if (snapshot.state === 'staged') {
+            await this.models.DesiredSnapshot.exact.transition({
+                current: snapshot,
+                change: (modelArg) => {
+                    modelArg.state = 'active';
+                    modelArg.activatedAt = stateArg.updatedAt;
+                },
+            }).catch(async () => {
+                await logCoreMailFailure('desired-state', 'SNAPSHOT_REPAIR_FAILED')
+                    .catch(() => undefined);
+            });
+        }
+        return desiredState;
+    }
+    async parseDesiredState(bytesArg, configEpochArg, digestArg) {
+        let parsed;
+        try {
+            parsed = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytesArg));
+        }
+        catch {
+            throw new Error('CoreMail desired state is not canonical UTF-8 JSON.');
+        }
+        const desiredState = plugins.serveZoneInterfaces.data.normalizeCoreMailDesiredState(parsed);
+        if (desiredState.configEpoch !== configEpochArg
+            || !await plugins.serveZoneInterfaces.data.verifyCoreMailDesiredStateDigest(desiredState, digestArg)) {
+            throw new Error('CoreMail desired-state digest or epoch does not match.');
+        }
+        const canonical = plugins.serveZoneInterfaces.data.canonicalizeCoreMailDesiredState(desiredState);
+        if (!Buffer.from(bytesArg).equals(Buffer.from(canonical, 'utf8'))) {
+            throw new Error('CoreMail desired-state bytes are not canonical.');
+        }
+        return desiredState;
+    }
+    async prepare(requestArg) {
+        await this.refresh();
+        const desiredStateDigest = plugins.serveZoneInterfaces.data.normalizeCoreMailSha256(requestArg.desiredStateDigest);
+        const expectedAppliedConfigEpoch = requireCoreMailSafeInteger(requestArg.expectedAppliedConfigEpoch, 'expectedAppliedConfigEpoch');
+        const configEpoch = requireCoreMailSafeInteger(requestArg.configEpoch, 'configEpoch', 1);
+        if (configEpoch <= expectedAppliedConfigEpoch
+            || !Number.isSafeInteger(requestArg.lengthBytes)
+            || requestArg.lengthBytes < 2
+            || requestArg.lengthBytes >
+                plugins.serveZoneInterfaces.data.coreMailLimits.desiredStateBytes) {
+            throw new Error('CoreMail desired-state preparation is invalid.');
+        }
+        const current = await this.models.State.exact.findStoredOne({
+            stateId: 'active',
+            appliedConfigEpoch: expectedAppliedConfigEpoch,
+        });
+        if (!current || current.appliedConfigEpoch !== this.activeStatePointer.appliedConfigEpoch) {
+            throw new Error('CoreMail desired-state compare-and-set fence changed.');
+        }
+        let snapshot = await this.models.DesiredSnapshot.exact.findStoredOne({
+            configEpoch,
+            desiredStateDigest,
+        });
+        let replayed = Boolean(snapshot);
+        if (snapshot) {
+            if (snapshot.expectedAppliedConfigEpoch !== expectedAppliedConfigEpoch
+                || snapshot.lengthBytes !== requestArg.lengthBytes
+                || (snapshot.state !== 'staged' && snapshot.state !== 'active')) {
+                throw new Error('CoreMail desired-state replay conflicts with persisted intent.');
+            }
+        }
+        else {
+            const snapshotId = plugins.nodeCrypto.randomUUID();
+            const createdAt = this.now();
+            const candidate = {
+                snapshotId,
+                reconciliationId: plugins.nodeCrypto.randomUUID(),
+                expectedAppliedConfigEpoch,
+                configEpoch,
+                desiredStateDigest,
+                lengthBytes: requestArg.lengthBytes,
+                objectKey: `desired-state/${snapshotId}.json`,
+                state: 'staged',
+                createdAt,
+                updatedAt: createdAt,
+            };
+            try {
+                const inserted = await this.models.DesiredSnapshot.exact.insert(candidate);
+                if (inserted.status === 'conflict') {
+                    throw new Error('CoreMail desired-state preparation conflicts with persisted intent.');
+                }
+                snapshot = inserted.document;
+            }
+            catch (error) {
+                if (!(error instanceof plugins.smartdata.SmartdataExactPersistenceError)
+                    || error.code !== 'unique_conflict') {
+                    throw error;
+                }
+                const concurrent = await this.models.DesiredSnapshot.exact.findStoredOne({
+                    configEpoch,
+                    desiredStateDigest,
+                });
+                if (!concurrent
+                    || concurrent.expectedAppliedConfigEpoch
+                        !== expectedAppliedConfigEpoch
+                    || concurrent.lengthBytes !== requestArg.lengthBytes
+                    || (concurrent.state !== 'staged' && concurrent.state !== 'active')) {
+                    throw new Error('CoreMail desired-state preparation conflicts with persisted intent.');
+                }
+                snapshot = concurrent;
+                replayed = true;
+            }
+        }
+        if (snapshot.state === 'staged') {
+            const touchedAt = this.now();
+            const touch = await this.models.DesiredSnapshot.exact.transition({
+                current: snapshot,
+                change: (modelArg) => {
+                    modelArg.updatedAt = touchedAt;
+                },
+            });
+            if (touch.status !== 'transitioned') {
+                throw new Error('CoreMail desired-state preparation fence changed.');
+            }
+            snapshot = touch.document;
+        }
+        const grant = await this.transfers.issueGrant({
+            authority: this.controlAuthority(),
+            purpose: 'desired-state-upload',
+            method: 'PUT',
+            expectedSha256: snapshot.desiredStateDigest,
+            lengthBytes: snapshot.lengthBytes,
+            contentType: 'application/json',
+            objectKey: snapshot.objectKey,
+        });
+        return {
+            reconciliationId: snapshot.reconciliationId,
+            grant: grant,
+            replayed,
+        };
+    }
+    async apply(requestArg) {
+        await this.refresh();
+        const desiredStateDigest = plugins.serveZoneInterfaces.data.normalizeCoreMailSha256(requestArg.desiredStateDigest);
+        const reconciliationId = requireCoreMailUuid(requestArg.reconciliationId, 'reconciliationId');
+        const grantId = requireCoreMailUuid(requestArg.grantId, 'grantId');
+        const lengthBytes = requireCoreMailSafeInteger(requestArg.lengthBytes, 'lengthBytes', 2);
+        const snapshot = await this.models.DesiredSnapshot.exact.findStoredOne({
+            reconciliationId,
+            desiredStateDigest,
+            lengthBytes,
+        });
+        if (!snapshot || (snapshot.state !== 'staged' && snapshot.state !== 'active')) {
+            throw new Error('CoreMail desired-state reconciliation is unavailable.');
+        }
+        await this.transfers.assertConsumed({
+            grantId,
+            authority: this.controlAuthority(),
+            purpose: 'desired-state-upload',
+            expectedSha256: desiredStateDigest,
+            lengthBytes,
+            objectKey: snapshot.objectKey,
+        });
+        const bytes = await this.storage.getVerifiedBytes(snapshot.objectKey, snapshot.lengthBytes, snapshot.desiredStateDigest, plugins.serveZoneInterfaces.data.coreMailLimits.desiredStateBytes);
+        const desiredState = await this.parseDesiredState(bytes, snapshot.configEpoch, snapshot.desiredStateDigest);
+        if (snapshot.state === 'active'
+            && this.activeStatePointer.snapshotId === snapshot.snapshotId) {
+            return await this.createStatus('ready', desiredState);
+        }
+        const activatedAt = this.now();
+        const activation = await withCoreMailTransaction(this.database, async (transactionArg) => {
+            const transactionSnapshot = await this.models.DesiredSnapshot.exact.findStoredOne({
+                snapshotId: snapshot.snapshotId,
+                reconciliationId: snapshot.reconciliationId,
+                state: 'staged',
+            }, { session: transactionArg });
+            const current = await this.models.State.exact.findStoredOne({
+                stateId: 'active',
+                appliedConfigEpoch: snapshot.expectedAppliedConfigEpoch,
+            }, { session: transactionArg });
+            if (!transactionSnapshot
+                || !current
+                || snapshot.configEpoch <= current.appliedConfigEpoch
+                || current.snapshotId !== this.activeStatePointer.snapshotId
+                || current.appliedDesiredStateDigest
+                    !== this.activeStatePointer.appliedDesiredStateDigest) {
+                throw new Error('CoreMail desired-state anti-rollback fence changed.');
+            }
+            const snapshotActivation = await this.models.DesiredSnapshot.exact.transition({
+                current: transactionSnapshot,
+                change: (modelArg) => {
+                    modelArg.state = 'active';
+                    modelArg.activatedAt = activatedAt;
+                    modelArg.updatedAt = activatedAt;
+                },
+            }, { session: transactionArg });
+            if (snapshotActivation.status !== 'transitioned') {
+                throw new Error('CoreMail desired-state snapshot activation was contended.');
+            }
+            if (current.snapshotId !== '-') {
+                const prior = await this.models.DesiredSnapshot.exact.findStoredOne({
+                    snapshotId: current.snapshotId,
+                }, { session: transactionArg });
+                if (!prior) {
+                    throw new Error('CoreMail prior desired-state snapshot is unavailable.');
+                }
+                const superseded = await this.models.DesiredSnapshot.exact.transition({
+                    current: prior,
+                    change: (modelArg) => {
+                        modelArg.state = 'superseded';
+                        modelArg.activatedAt ??= current.updatedAt;
+                        modelArg.updatedAt = activatedAt;
+                    },
+                }, { session: transactionArg });
+                if (superseded.status !== 'transitioned') {
+                    throw new Error('CoreMail prior desired-state snapshot was contended.');
+                }
+            }
+            const pointerActivation = await this.models.State.exact.transition({
+                current,
+                change: (modelArg) => {
+                    modelArg.appliedConfigEpoch = snapshot.configEpoch;
+                    modelArg.appliedDesiredStateDigest = snapshot.desiredStateDigest;
+                    modelArg.snapshotId = snapshot.snapshotId;
+                    modelArg.updatedAt = activatedAt;
+                },
+            }, { session: transactionArg });
+            if (pointerActivation.status !== 'transitioned') {
+                throw new Error('CoreMail desired-state activation was contended.');
+            }
+            return pointerActivation.document;
+        });
+        this.activeStatePointer = activation;
+        this.activeDesiredState = desiredState;
+        return await this.createStatus('ready', desiredState);
+    }
+    async getStatus(requestArg) {
+        await this.refresh();
+        if (this.activeStatePointer.appliedConfigEpoch === 0) {
+            throw new Error('CoreMail has no applied desired state.');
+        }
+        const digest = plugins.serveZoneInterfaces.data.normalizeCoreMailSha256(requestArg.desiredStateDigest);
+        if (this.activeDesiredState?.configEpoch === requestArg.configEpoch
+            && this.activeStatePointer.appliedDesiredStateDigest === digest) {
+            return await this.createStatus('ready', this.activeDesiredState);
+        }
+        const snapshot = await this.models.DesiredSnapshot.exact.findStoredOne({
+            configEpoch: requestArg.configEpoch,
+            desiredStateDigest: digest,
+        });
+        return await this.createStatus(snapshot?.state === 'staged' ? 'applying' : 'failed', this.activeDesiredState, snapshot?.errorCode ?? 'RECONCILIATION_FENCE_MISMATCH');
+    }
+    async createStatus(stateArg, desiredStateArg, errorCodeArg) {
+        const bindings = await Promise.all((desiredStateArg?.bindings ?? []).map(async (bindingArg) => ({
+            bindingId: bindingArg.bindingId,
+            revision: bindingArg.revision,
+            state: bindingArg.state,
+            pendingInboundCount: await this.models.InboundDelivery.exact.count({
+                tenantId: bindingArg.tenantId,
+                serviceId: bindingArg.serviceId,
+                bindingId: bindingArg.bindingId,
+                bindingRevision: bindingArg.revision,
+                state: {
+                    $in: [...plugins.serveZoneInterfaces.data.coreMailQuotaPolicy
+                            .pendingInboundStates],
+                },
+            }),
+            activeSessionsByCredential: this.activeSessionCounts(bindingArg, desiredStateArg.configEpoch),
+        })));
+        return {
+            replica: { ...this.replica },
+            state: stateArg,
+            appliedConfigEpoch: this.activeStatePointer.appliedConfigEpoch,
+            appliedDesiredStateDigest: this.activeStatePointer.appliedDesiredStateDigest,
+            bindings,
+            updatedAt: this.now(),
+            ...(errorCodeArg ? { errorCode: errorCodeArg } : {}),
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kZXNpcmVkc3RhdGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jbGFzc2VzLmRlc2lyZWRzdGF0ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQXdCLE1BQU0scUJBQXFCLENBQUM7QUFDM0QsT0FBTyxFQUFFLGVBQWUsRUFBRSxZQUFZLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNyRSxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVoRSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUN2RCxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUs5RCxPQUFPLEVBQ0wsMEJBQTBCLEVBQzFCLG1CQUFtQixHQUNwQixNQUFNLHlCQUF5QixDQUFDO0FBU2pDLE1BQU0sZ0JBQWdCLEdBQUcsWUFBWSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0FBRTFDLE1BQU0sT0FBTywyQkFBMkI7SUFNbkI7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBSUE7SUFkWCxrQkFBa0IsR0FBaUMsSUFBSSxDQUFDO0lBQ3hELGtCQUFrQixDQUFnQjtJQUNsQyxXQUFXLEdBQXlCLElBQUksQ0FBQztJQUVqRCxZQUNtQixRQUF1QyxFQUN2QyxNQUF1QixFQUN2QixPQUF3QixFQUN4QixTQUFrQyxFQUNsQyxPQUFnQyxFQUNoQyxtQkFHbUQsRUFDbkQsTUFBb0IsSUFBSSxDQUFDLEdBQUc7UUFUNUIsYUFBUSxHQUFSLFFBQVEsQ0FBK0I7UUFDdkMsV0FBTSxHQUFOLE1BQU0sQ0FBaUI7UUFDdkIsWUFBTyxHQUFQLE9BQU8sQ0FBaUI7UUFDeEIsY0FBUyxHQUFULFNBQVMsQ0FBeUI7UUFDbEMsWUFBTyxHQUFQLE9BQU8sQ0FBeUI7UUFDaEMsd0JBQW1CLEdBQW5CLG1CQUFtQixDQUdnQztR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

package/dist_ts/classes.gateway.d.ts

@@ -0,0 +1,62 @@
+import * as plugins from './plugins.js';
+import { type ICoreMailModels } from './classes.models.js';
+import { CoreMailTransferService } from './classes.transfer.js';
+import type { CoreMailInboundService } from './classes.inbound.js';
+import type { ICoreMailConfig } from './interfaces.js';
+import type { ICoreMailSubmissionRecord } from './coremail.persistence.js';
+type TDesiredState = plugins.serveZoneInterfaces.data.ICoreMailDesiredState;
+type TGatewayStatus = plugins.serveZoneInterfaces.data.ICoreMailGatewayOutboundStatus;
+type TStoredSubmission = plugins.smartdata.TStoredDocument<ICoreMailSubmissionRecord>;
+export declare const requireMatchingCoreMailTransferOrigin: (valueArg: unknown, expectedArg: string) => string;
+export declare class CoreMailGateway {
+    private readonly config;
+    private readonly models;
+    private readonly transfers;
+    private readonly inbound;
+    private readonly getDesiredState;
+    private readonly now;
+    private socket;
+    private socketSignature;
+    private authenticatedSignature;
+    private transferOrigin;
+    private readonly stopController;
+    private reconcileTask;
+    private statusSubscription;
+    private authenticationTask;
+    private authenticatingSignature;
+    constructor(config: ICoreMailConfig, models: ICoreMailModels, transfers: CoreMailTransferService, inbound: CoreMailInboundService, getDesiredState: () => Promise<TDesiredState | null>, now?: () => number);
+    start(): void;
+    stop(): Promise<void>;
+    isReady(): boolean;
+    getTransferOrigin(): string | null;
+    private runReconciliationLoop;
+    private connect;
+    private queueAuthentication;
+    private requireAuthenticated;
+    private disconnect;
+    prepareOutbound(submissionArg: ICoreMailSubmissionRecord, grantArg: plugins.serveZoneInterfaces.data.ICoreMailDownloadGrant): Promise<{
+        transportMessageId: string;
+        status: TGatewayStatus;
+        replayed: boolean;
+    }>;
+    getOutboundStatus(transportMessageIdArg: string): Promise<TGatewayStatus>;
+    private completeOutboundHandoff;
+    persistStatus(initialSubmissionArg: TStoredSubmission, statusArg: TGatewayStatus, leaseTokenArg?: string): Promise<TStoredSubmission>;
+}
+export declare class CoreMailOutboundWorker {
+    private readonly models;
+    private readonly transfers;
+    private readonly gateway;
+    private readonly replicaTaskId;
+    private readonly serviceId;
+    private readonly now;
+    private readonly stopController;
+    private workerTask;
+    constructor(models: ICoreMailModels, transfers: CoreMailTransferService, gateway: CoreMailGateway, replicaTaskId: string, serviceId: string, now?: () => number);
+    start(): void;
+    stop(): Promise<void>;
+    private run;
+    private processBatch;
+    private processClaimed;
+}
+export {};