@antelopejs/dms-saas 0.0.1

package/dist/operator-actions/db/operator-action.model.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperatorActionModel = void 0;
+const node_crypto_1 = require("node:crypto");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const operator_action_table_1 = require("./operator-action.table");
+class OperatorActionModel extends (0, interface_database_decorators_1.BasicDataModel)(operator_action_table_1.OperatorAction, operator_action_table_1.operatorActionsTableName) {
+    async beginAttempt(current) {
+        if (!["pending", "failed"].includes(current.status))
+            throw new Error("Operator action requires reconciliation");
+        return this.mutate(current, {
+            status: "running",
+            attemptCount: current.attemptCount + 1,
+            startedAt: new Date(),
+            completedAt: null,
+            lastErrorCode: null,
+        });
+    }
+    async markSucceeded(current, outcome) {
+        return this.mutate(current, {
+            status: "succeeded",
+            ...outcome,
+            completedAt: new Date(),
+        });
+    }
+    async markFailed(current, errorCode) {
+        return this.mutate(current, {
+            status: "failed",
+            lastErrorCode: errorCode,
+            completedAt: new Date(),
+        });
+    }
+    async markReconciliationRequired(current, errorCode) {
+        return this.mutate(current, {
+            status: "reconciliation_required",
+            lastErrorCode: errorCode,
+            completedAt: new Date(),
+        });
+    }
+    async updateDetails(current, details) {
+        return this.mutate(current, { details });
+    }
+    async mutate(current, patch) {
+        const revision = (0, node_crypto_1.randomUUID)();
+        const updatedAt = new Date();
+        const outcome = await this.table
+            .atomicMutation(current._id, {
+            type: "update",
+            revisionField: "revision",
+            expectedRevision: current.revision === undefined
+                ? { kind: "missing" }
+                : current.revision,
+            nextRevision: revision,
+            patch: { ...patch, updatedAt },
+        })
+            .run();
+        if (outcome !== "applied")
+            throw new Error(`Operator action ${outcome}; reconciliation required`);
+        return Object.assign(current, patch, { revision, updatedAt });
+    }
+}
+exports.OperatorActionModel = OperatorActionModel;
+//# sourceMappingURL=operator-action.model.js.map

package/dist/operator-actions/db/operator-action.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-action.model.js","sourceRoot":"","sources":["../../../src/operator-actions/db/operator-action.model.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,6FAA2E;AAE3E,mEAGiC;AAQjC,MAAa,mBAAoB,SAAQ,IAAA,8CAAc,EACrD,sCAAc,EACd,gDAAwB,CACzB;IAEC,KAAK,CAAC,YAAY,CAAC,OAAuB;QACxC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC1B,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,CAAC;YACtC,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,aAAa,CACjB,OAAuB,EACvB,OAA8B;QAE9B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC1B,MAAM,EAAE,WAAW;YACnB,GAAG,OAAO;YACV,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,UAAU,CACd,OAAuB,EACvB,SAAiB;QAEjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC1B,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,0BAA0B,CAC9B,OAAuB,EACvB,SAAiB;QAEjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC1B,MAAM,EAAE,yBAAyB;YACjC,aAAa,EAAE,SAAS;YACxB,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,aAAa,CACjB,OAAuB,EACvB,OAA8B;QAE9B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,OAAuB,EACvB,KAA8B;QAE9B,MAAM,QAAQ,GAAG,IAAA,wBAAU,GAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE;YAC3B,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,UAAU;YACzB,gBAAgB,EACd,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACrB,CAAC,CAAC,OAAO,CAAC,QAAQ;YACtB,YAAY,EAAE,QAAQ;YACtB,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE;SAC/B,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,2BAA2B,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;CACF;AAnFD,kDAmFC"}

package/dist/operator-actions/db/operator-action.table.d.ts

@@ -0,0 +1,21 @@
+import { Table } from "@antelopejs/interface-database-decorators";
+import type { OperatorActionDetails, OperatorActionStatus, WorkspaceOperatorAction } from "../types";
+export declare const operatorActionsTableName = "saas_operator_actions";
+export declare class OperatorAction extends Table {
+    _id: string;
+    tenantId: string;
+    actorId: string;
+    actorEmail: string;
+    action: WorkspaceOperatorAction;
+    status: OperatorActionStatus;
+    requestFingerprint: string;
+    details: OperatorActionDetails;
+    attemptCount: number;
+    revision?: string;
+    lastErrorCode: string | null;
+    effectiveAt: Date | null;
+    createdAt: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    updatedAt: Date;
+}

package/dist/operator-actions/db/operator-action.table.js

@@ -0,0 +1,95 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperatorAction = exports.operatorActionsTableName = void 0;
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const constants_1 = require("@antelopejs/interface-dms/constants");
+const tenants_table_1 = require("@antelopejs/interface-dms/db/tables/tenants.table");
+exports.operatorActionsTableName = "saas_operator_actions";
+let OperatorAction = class OperatorAction extends interface_database_decorators_1.Table {
+};
+exports.OperatorAction = OperatorAction;
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "_id", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    (0, interface_database_decorators_1.Relation)({ to: () => tenants_table_1.Tenant }),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "tenantId", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "actorId", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "actorEmail", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "action", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "status", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "requestFingerprint", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("any"),
+    __metadata("design:type", Object)
+], OperatorAction.prototype, "details", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], OperatorAction.prototype, "attemptCount", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], OperatorAction.prototype, "revision", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], OperatorAction.prototype, "lastErrorCode", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], OperatorAction.prototype, "effectiveAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.CreationTime)(),
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Date)
+], OperatorAction.prototype, "createdAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], OperatorAction.prototype, "startedAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], OperatorAction.prototype, "completedAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.UpdateTime)(),
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Date)
+], OperatorAction.prototype, "updatedAt", void 0);
+exports.OperatorAction = OperatorAction = __decorate([
+    (0, interface_database_decorators_1.RegisterTable)(exports.operatorActionsTableName, constants_1.CORE_SCHEMA_NAME)
+], OperatorAction);
+//# sourceMappingURL=operator-action.table.js.map

package/dist/operator-actions/db/operator-action.table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-action.table.js","sourceRoot":"","sources":["../../../src/operator-actions/db/operator-action.table.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6FAQmD;AACnD,mEAAuE;AACvE,qFAA2E;AAO9D,QAAA,wBAAwB,GAAG,uBAAuB,CAAC;AAGzD,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,qCAAK;CAwDxC,CAAA;AAxDY,wCAAc;AAEjB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;2CACI;AAKZ;IAHP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;IACf,IAAA,wCAAQ,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,sBAAM,EAAE,CAAC;;gDACN;AAIjB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;+CACQ;AAGhB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kDACW;AAInB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;8CACwB;AAIhC;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;8CACqB;AAG7B;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;0DACmB;AAG3B;IADP,IAAA,qCAAK,EAAC,KAAK,CAAC;;+CAC0B;AAG/B;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACa;AAGrB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;gDACU;AAGlB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;qDACqB;AAG7B;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;mDACmB;AAKzB;IAHP,IAAA,4CAAY,GAAE;IACd,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;iDAAC;AAGhB;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;iDACiB;AAGvB;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;mDACmB;AAIzB;IAFP,IAAA,0CAAU,GAAE;IACZ,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;iDAAC;yBAvDb,cAAc;IAD1B,IAAA,6CAAa,EAAC,gCAAwB,EAAE,4BAAgB,CAAC;GAC7C,cAAc,CAwD1B"}

package/dist/operator-actions/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./commands";
+export * from "./journal";
+export * from "./lifecycle-outbox";

package/dist/operator-actions/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./commands"), exports);
+__exportStar(require("./journal"), exports);
+__exportStar(require("./lifecycle-outbox"), exports);
+//# sourceMappingURL=index.js.map

package/dist/operator-actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operator-actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,4CAA0B;AAC1B,qDAAmC"}

package/dist/operator-actions/journal.d.ts

@@ -0,0 +1,22 @@
+import { OperatorActionModel, type OperatorActionSuccess } from "./db/operator-action.model";
+import type { OperatorAction } from "./db/operator-action.table";
+import type { OperatorActionDetails, OperatorCommandResult, WorkspaceOperatorAction } from "./types";
+export declare const CUSTOMER_BALANCE_CREDIT_SAFE_RETRY_WINDOW_MS: number;
+export interface OperatorActor {
+    id: string;
+    email: string;
+}
+export interface OperatorActionRequest {
+    operationId: string;
+    tenantId: string;
+    actor: OperatorActor;
+    action: WorkspaceOperatorAction;
+    details: OperatorActionDetails;
+}
+export type OperatorActionEffect = (action: OperatorAction) => Promise<OperatorActionSuccess>;
+export declare function operatorActionFingerprint(request: OperatorActionRequest): string;
+export declare function assertOperationId(operationId: string): void;
+export declare function ensureOperatorActionIntent(model: OperatorActionModel, request: OperatorActionRequest): Promise<OperatorAction>;
+export declare function executeOperatorAction(request: OperatorActionRequest, effect: OperatorActionEffect): Promise<OperatorAction>;
+export declare function toOperatorCommandResult(action: OperatorAction): OperatorCommandResult;
+export declare function checkpointOperatorActionDetails(action: OperatorAction, patch: OperatorActionDetails): Promise<void>;

package/dist/operator-actions/journal.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CUSTOMER_BALANCE_CREDIT_SAFE_RETRY_WINDOW_MS = void 0;
+exports.operatorActionFingerprint = operatorActionFingerprint;
+exports.assertOperationId = assertOperationId;
+exports.ensureOperatorActionIntent = ensureOperatorActionIntent;
+exports.executeOperatorAction = executeOperatorAction;
+exports.toOperatorCommandResult = toOperatorCommandResult;
+exports.checkpointOperatorActionDetails = checkpointOperatorActionDetails;
+const node_crypto_1 = require("node:crypto");
+const interface_api_1 = require("@antelopejs/interface-api");
+const interface_api_util_1 = require("@antelopejs/interface-api-util");
+const logging_1 = require("@antelopejs/interface-core/logging");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const db_1 = require("../db");
+const operator_action_model_1 = require("./db/operator-action.model");
+const HTTP_BAD_REQUEST = 400;
+const HTTP_CONFLICT = 409;
+const HTTP_BAD_GATEWAY = 502;
+const HOUR_MS = 60 * 60 * 1000;
+const STRIPE_MINIMUM_IDEMPOTENCY_RETENTION_MS = 24 * HOUR_MS;
+const STRIPE_IDEMPOTENCY_SAFETY_MARGIN_MS = HOUR_MS;
+const OPERATION_ID_PATTERN = /^[A-Za-z0-9-]{8,64}$/;
+const GENERIC_FAILURE_CODE = "saas.errors.operator.external_effect_failed";
+const RECONCILIATION_REQUIRED_CODE = "saas.errors.operator.reconciliation_required";
+exports.CUSTOMER_BALANCE_CREDIT_SAFE_RETRY_WINDOW_MS = STRIPE_MINIMUM_IDEMPOTENCY_RETENTION_MS - STRIPE_IDEMPOTENCY_SAFETY_MARGIN_MS;
+function canonicalize(value) {
+    if (value === null ||
+        ["boolean", "number", "string"].includes(typeof value)) {
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    const entries = Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, entry]) => [key, canonicalize(entry)]);
+    return Object.fromEntries(entries);
+}
+function operatorActionFingerprint(request) {
+    const payload = canonicalize({
+        tenantId: request.tenantId,
+        action: request.action,
+        details: request.details,
+    });
+    return (0, node_crypto_1.createHash)("sha256").update(JSON.stringify(payload)).digest("hex");
+}
+function assertOperationId(operationId) {
+    (0, interface_api_util_1.assert)(OPERATION_ID_PATTERN.test(operationId), HTTP_BAD_REQUEST, "saas.errors.operator.invalid_operation_id");
+}
+async function insertIntent(model, request, fingerprint) {
+    const now = new Date();
+    await model.insert({
+        _id: request.operationId,
+        tenantId: request.tenantId,
+        actorId: request.actor.id,
+        actorEmail: request.actor.email,
+        action: request.action,
+        status: "pending",
+        requestFingerprint: fingerprint,
+        details: request.details,
+        attemptCount: 0,
+        revision: (0, node_crypto_1.randomUUID)(),
+        lastErrorCode: null,
+        effectiveAt: null,
+        createdAt: now,
+        startedAt: null,
+        completedAt: null,
+        updatedAt: now,
+    });
+    const inserted = await model.get(request.operationId);
+    if (!inserted)
+        throw new Error("Operator action intent was not persisted");
+    return inserted;
+}
+async function ensureOperatorActionIntent(model, request) {
+    assertOperationId(request.operationId);
+    const fingerprint = operatorActionFingerprint(request);
+    try {
+        return await insertIntent(model, request, fingerprint);
+    }
+    catch (error) {
+        const existing = await model.get(request.operationId);
+        if (!existing)
+            throw error;
+        (0, interface_api_util_1.assert)(existing.requestFingerprint === fingerprint, HTTP_CONFLICT, "saas.errors.operator.idempotency_mismatch");
+        return existing;
+    }
+}
+function errorCodeOf(error) {
+    if (!(error instanceof interface_api_1.HTTPResult))
+        return GENERIC_FAILURE_CODE;
+    const body = error.getBody();
+    return typeof body === "string" && body.startsWith("saas.errors.")
+        ? body
+        : GENERIC_FAILURE_CODE;
+}
+function throwSafeActionError(error, operationId) {
+    if (error instanceof interface_api_1.HTTPResult &&
+        errorCodeOf(error) !== GENERIC_FAILURE_CODE) {
+        throw error;
+    }
+    logging_1.Logging.Error(`[dms-saas:operator] operation ${operationId} failed`, error);
+    throw new interface_api_1.HTTPResult(HTTP_BAD_GATEWAY, GENERIC_FAILURE_CODE);
+}
+async function isRetryableValidationFailure(action, error) {
+    if (!(error instanceof interface_api_1.HTTPResult))
+        return false;
+    try {
+        const subscription = await (0, interface_database_decorators_1.GetModel)(db_1.TenantSubscriptionModel, action.tenantId).findOne();
+        return subscription?.domainTransition?.operationId !== action._id;
+    }
+    catch {
+        return false;
+    }
+}
+async function failAction(model, action, error) {
+    const failure = (await isRetryableValidationFailure(action, error))
+        ? model.markFailed(action, errorCodeOf(error))
+        : model.markReconciliationRequired(action, RECONCILIATION_REQUIRED_CODE);
+    await failure.catch(() => { });
+    throwSafeActionError(error, action._id);
+}
+async function runEffect(model, action, effect) {
+    try {
+        const outcome = await effect(action);
+        await model.markSucceeded(action, outcome);
+    }
+    catch (error) {
+        return failAction(model, action, error);
+    }
+    const completed = await model.get(action._id);
+    if (!completed)
+        throw new Error("Completed operator action is missing");
+    await completeSubscriptionIntent(completed);
+    return completed;
+}
+async function completeSubscriptionIntent(action) {
+    if (action.status !== "succeeded")
+        return;
+    if (action.action === "customer_balance.credit")
+        return;
+    const subscriptions = (0, interface_database_decorators_1.GetModel)(db_1.TenantSubscriptionModel, action.tenantId);
+    const subscription = await subscriptions.findOne();
+    if (subscription?.domainTransition?.operationId !== action._id)
+        return;
+    await subscriptions.completeTransition(subscription._id, action._id, {});
+}
+async function blockUnsafeRetry(model, action) {
+    const expired = action.attemptCount > 0 &&
+        Date.now() - action.createdAt.getTime() >=
+            exports.CUSTOMER_BALANCE_CREDIT_SAFE_RETRY_WINDOW_MS;
+    if (action.status !== "running" && !expired)
+        return;
+    await model.markReconciliationRequired(action, RECONCILIATION_REQUIRED_CODE);
+    throw new interface_api_1.HTTPResult(HTTP_CONFLICT, RECONCILIATION_REQUIRED_CODE);
+}
+async function executeOperatorAction(request, effect) {
+    const model = (0, interface_database_decorators_1.GetModel)(operator_action_model_1.OperatorActionModel);
+    const action = await ensureOperatorActionIntent(model, request);
+    if (action.status === "succeeded") {
+        await completeSubscriptionIntent(action);
+        return action;
+    }
+    if (action.status === "reconciliation_required") {
+        throw new interface_api_1.HTTPResult(HTTP_CONFLICT, RECONCILIATION_REQUIRED_CODE);
+    }
+    await blockUnsafeRetry(model, action);
+    const running = await model.beginAttempt(action);
+    return runEffect(model, running, effect);
+}
+function toOperatorCommandResult(action) {
+    return {
+        operationId: action._id,
+        status: action.status,
+        effectiveAt: action.effectiveAt,
+    };
+}
+async function checkpointOperatorActionDetails(action, patch) {
+    (0, interface_api_util_1.assert)(action.status === "running", HTTP_CONFLICT, "saas.errors.operator.operation_in_progress");
+    const details = { ...action.details, ...patch };
+    await (0, interface_database_decorators_1.GetModel)(operator_action_model_1.OperatorActionModel).updateDetails(action, details);
+}
+//# sourceMappingURL=journal.js.map

package/dist/operator-actions/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/operator-actions/journal.ts"],"names":[],"mappings":"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"}

package/dist/operator-actions/lifecycle-consumers.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceLifecycleConsumer } from "@antelopejs/interface-dms-saas/workspace-lifecycle";
+declare function register(name: string, consumer: WorkspaceLifecycleConsumer): void;
+declare function unregister(name: string): void;
+export declare namespace internal {
+    const RegisterWorkspaceLifecycleConsumer: {
+        register: typeof register;
+        unregister: typeof unregister;
+    };
+}
+export declare function getWorkspaceLifecycleConsumers(): WorkspaceLifecycleConsumer[];
+export declare function getWorkspaceLifecycleConsumer(name: string): WorkspaceLifecycleConsumer | undefined;
+export {};

package/dist/operator-actions/lifecycle-consumers.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = void 0;
+exports.getWorkspaceLifecycleConsumers = getWorkspaceLifecycleConsumers;
+exports.getWorkspaceLifecycleConsumer = getWorkspaceLifecycleConsumer;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const LOG_PREFIX = "[dms-saas:workspace-lifecycle]";
+const consumers = new Map();
+function register(name, consumer) {
+    if (consumers.has(name)) {
+        logging_1.Logging.Error(`${LOG_PREFIX} consumer name '${name}' is already taken: the previous consumer is replaced`);
+    }
+    consumers.set(name, consumer);
+}
+function unregister(name) {
+    consumers.delete(name);
+}
+var internal;
+(function (internal) {
+    internal.RegisterWorkspaceLifecycleConsumer = { register, unregister };
+})(internal || (exports.internal = internal = {}));
+function getWorkspaceLifecycleConsumers() {
+    return [...consumers.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+function getWorkspaceLifecycleConsumer(name) {
+    return consumers.get(name);
+}
+//# sourceMappingURL=lifecycle-consumers.js.map

package/dist/operator-actions/lifecycle-consumers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-consumers.js","sourceRoot":"","sources":["../../src/operator-actions/lifecycle-consumers.ts"],"names":[],"mappings":";;;AA2BA,wEAIC;AAGD,sEAIC;AAtCD,gEAA6D;AAG7D,MAAM,UAAU,GAAG,gCAAgC,CAAC;AACpD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;AAKhE,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAoC;IAClE,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,iBAAO,CAAC,KAAK,CACX,GAAG,UAAU,mBAAmB,IAAI,uDAAuD,CAC5F,CAAC;IACJ,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,IAAiB,QAAQ,CAExB;AAFD,WAAiB,QAAQ;IACV,2CAAkC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC7E,CAAC,EAFgB,QAAQ,wBAAR,QAAQ,QAExB;AAGD,SAAgB,8BAA8B;IAC5C,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAClD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CACpC,CAAC;AACJ,CAAC;AAGD,SAAgB,6BAA6B,CAC3C,IAAY;IAEZ,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/operator-actions/lifecycle-outbox.d.ts

@@ -0,0 +1,19 @@
+import type { WorkspaceLifecycleTransition } from "@antelopejs/interface-dms-saas/workspace-lifecycle";
+export interface LifecycleDispatchInput {
+    tenantId: string;
+    operationId: string;
+    transition: WorkspaceLifecycleTransition;
+    requestedAt: Date;
+}
+export interface LifecycleReconciliationResult {
+    delivered: number;
+    failed: number;
+    waitingForConsumer: number;
+}
+export declare function beginWorkspaceCreation(tenantId: string): Promise<void>;
+export declare function prepareWorkspaceCreated(tenantId: string, invoiceId: string | null): Promise<void>;
+export declare function isWorkspaceProvisioningCommitted(tenantId: string): Promise<boolean>;
+export declare function cancelWorkspaceCreated(tenantId: string): Promise<void>;
+export declare function deliverWorkspaceCreated(tenantId: string): Promise<void>;
+export declare function dispatchWorkspaceLifecycle(input: LifecycleDispatchInput): Promise<void>;
+export declare function reconcileWorkspaceLifecycleDeliveries(): Promise<LifecycleReconciliationResult>;