@mj-biz-apps/orders-server 5.17.0 → 5.19.0

package/dist/custom/enforce-payment-gated-access.action.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview `Orders: Enforce Payment-Gated Access` — the nightly pass for bc-aidp-next-golive#223.
+ *
+ * A renewal goes past its cutoff with nothing being written; only a day passes. The payment path
+ * moves grants when cash moves, and this is the caller for the other half: MJ's scheduler dispatches
+ * Actions, so the Action is how the clock reaches `EnforcePaymentGatedAccess`.
+ *
+ * NO ACCESS LOGIC LIVES HERE. Candidate selection, the decision and the writes are all in
+ * `PaymentGatedAccess.ts`; this reads parameters, calls it, and reports what came back.
+ *
+ * PREVIEW IS A PARAMETER. The scheduled job ships set to Preview, so the first runs report what they
+ * would suspend and write nothing. Setting Preview to false is the act that starts cutting access.
+ *
+ * @module @mj-biz-apps/orders-server
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Suspend renewals past the cutoff and restore grants whose payment has arrived.
+ *
+ * Inputs: `AsOfDate`, `Preview`, `MaxCount` — all optional.
+ * Outputs: `Activated`, `Suspended`, `Changes`, `Failures`, `PreviewedOnly`.
+ */
+export declare class EnforcePaymentGatedAccessAction extends BaseAction {
+    /** An action must not throw at its caller — same reasoning as the other hand-authored actions. */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private enforce;
+}
+/** Tree-shaking anchor — without it the decorator never runs and the action has nothing behind it. */
+export declare function LoadEnforcePaymentGatedAccessAction(): void;
+//# sourceMappingURL=enforce-payment-gated-access.action.d.ts.map

package/dist/custom/enforce-payment-gated-access.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforce-payment-gated-access.action.d.ts","sourceRoot":"","sources":["../../src/custom/enforce-payment-gated-access.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA0BrG;;;;;GAKG;AACH,qBACa,+BAAgC,SAAQ,UAAU;IAC3D,kGAAkG;cAClF,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAQzE,OAAO;CAkDxB;AAED,sGAAsG;AACtG,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D"}

package/dist/custom/enforce-payment-gated-access.action.js

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview `Orders: Enforce Payment-Gated Access` — the nightly pass for bc-aidp-next-golive#223.
+ *
+ * A renewal goes past its cutoff with nothing being written; only a day passes. The payment path
+ * moves grants when cash moves, and this is the caller for the other half: MJ's scheduler dispatches
+ * Actions, so the Action is how the clock reaches `EnforcePaymentGatedAccess`.
+ *
+ * NO ACCESS LOGIC LIVES HERE. Candidate selection, the decision and the writes are all in
+ * `PaymentGatedAccess.ts`; this reads parameters, calls it, and reports what came back.
+ *
+ * PREVIEW IS A PARAMETER. The scheduled job ships set to Preview, so the first runs report what they
+ * would suspend and write nothing. Setting Preview to false is the act that starts cutting access.
+ *
+ * @module @mj-biz-apps/orders-server
+ */
+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;
+};
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { EnforcePaymentGatedAccess } from '@mj-biz-apps/orders-core-entities-server';
+function param(params, name) {
+    const raw = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase())?.Value;
+    if (raw == null)
+        return null;
+    const value = String(raw).trim();
+    // A scheduler writes an unset parameter as an empty string, so blank is absent.
+    return value.length ? value : null;
+}
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        existing.Type = 'Output';
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+const refuse = (ResultCode, Message) => ({ Success: false, ResultCode, Message });
+/**
+ * Suspend renewals past the cutoff and restore grants whose payment has arrived.
+ *
+ * Inputs: `AsOfDate`, `Preview`, `MaxCount` — all optional.
+ * Outputs: `Activated`, `Suspended`, `Changes`, `Failures`, `PreviewedOnly`.
+ */
+let EnforcePaymentGatedAccessAction = class EnforcePaymentGatedAccessAction extends BaseAction {
+    /** An action must not throw at its caller — same reasoning as the other hand-authored actions. */
+    async InternalRunAction(params) {
+        try {
+            return await this.enforce(params);
+        }
+        catch (error) {
+            return refuse('ERROR', `The payment-gated access pass failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async enforce(params) {
+        const user = params.ContextUser;
+        if (!user)
+            return refuse('NO_CONTEXT_USER', 'ContextUser is required: suspending access has to be attributable to somebody.');
+        const input = {};
+        const asOf = param(params, 'AsOfDate');
+        if (asOf !== null) {
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(asOf) || Number.isNaN(new Date(asOf).getTime())) {
+                return refuse('INVALID_AS_OF_DATE', `'${asOf}' is not a date. AsOfDate takes YYYY-MM-DD, and is omitted for "today".`);
+            }
+            input.AsOfDate = asOf;
+        }
+        const preview = param(params, 'Preview');
+        if (preview !== null) {
+            // Refused rather than guessed: the wrong guess suspends customers.
+            const v = preview.toLowerCase();
+            if (['true', '1', 'yes', 'y'].includes(v))
+                input.Preview = true;
+            else if (['false', '0', 'no', 'n'].includes(v))
+                input.Preview = false;
+            else
+                return refuse('INVALID_PREVIEW', `Preview takes true or false — got '${preview}'.`);
+        }
+        const maxCount = param(params, 'MaxCount');
+        if (maxCount !== null) {
+            const n = Number(maxCount);
+            if (!Number.isInteger(n) || n < 1) {
+                return refuse('INVALID_MAX_COUNT', `MaxCount must be a whole number of at least 1 — got '${maxCount}'.`);
+            }
+            input.MaxCount = n;
+        }
+        const provider = params.Provider ?? Metadata.Provider;
+        const output = await EnforcePaymentGatedAccess(input, provider, user);
+        setOutput(params, 'Activated', output.Activated);
+        setOutput(params, 'Suspended', output.Suspended);
+        setOutput(params, 'Changes', output.Changes);
+        setOutput(params, 'Failures', output.Failures);
+        // Not named `Preview`: an output overwrites the param row of the same name, and whether a
+        // run was a rehearsal is the one fact the run record has to keep.
+        setOutput(params, 'PreviewedOnly', input.Preview === true);
+        return {
+            Success: output.Success,
+            ResultCode: !output.Success ? 'PARTIAL' : input.Preview ? 'PREVIEWED' : 'COMPLETED',
+            Params: params.Params,
+            Message: output.Message ?? '',
+        };
+    }
+};
+EnforcePaymentGatedAccessAction = __decorate([
+    RegisterClass(BaseAction, 'Orders.EnforcePaymentGatedAccess')
+], EnforcePaymentGatedAccessAction);
+export { EnforcePaymentGatedAccessAction };
+/** Tree-shaking anchor — without it the decorator never runs and the action has nothing behind it. */
+export function LoadEnforcePaymentGatedAccessAction() {
+    void EnforcePaymentGatedAccessAction;
+}
+//# sourceMappingURL=enforce-payment-gated-access.action.js.map

package/dist/custom/enforce-payment-gated-access.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforce-payment-gated-access.action.js","sourceRoot":"","sources":["../../src/custom/enforce-payment-gated-access.action.ts"],"names":[],"mappings":"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"}

package/dist/generated/graphql-schemas/__mj_BizAppsOrders.d.ts

@@ -504,6 +504,9 @@ export declare class mjBizAppsOrdersEntitlementGrant_ {
     RevocationReason?: string;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    GrantTimingApplied?: string;
+    SuspendedAt?: Date;
+    SuspensionReason?: string;
     ProductEntitlement?: string;
     Subscription?: string;
     BeneficiaryPerson?: string;
@@ -526,6 +529,9 @@ export declare class CreatemjBizAppsOrdersEntitlementGrantInput {
     SubscriptionTermID: string | null;
     RevokedAt: Date | null;
     RevocationReason: string | null;
+    GrantTimingApplied: string | null;
+    SuspendedAt: Date | null;
+    SuspensionReason: string | null;
     RestoreContext___?: RestoreContextInput;
 }
 export declare class UpdatemjBizAppsOrdersEntitlementGrantInput {
@@ -544,6 +550,9 @@ export declare class UpdatemjBizAppsOrdersEntitlementGrantInput {
     SubscriptionTermID?: string | null;
     RevokedAt?: Date | null;
     RevocationReason?: string | null;
+    GrantTimingApplied?: string | null;
+    SuspendedAt?: Date | null;
+    SuspensionReason?: string | null;
     OldValues___?: KeyValuePairInput[];
     RestoreContext___?: RestoreContextInput;
 }
@@ -615,6 +624,7 @@ export declare class mjBizAppsOrdersEventOrderLine_ {
     PriceOverrideReason?: string;
     DimensionID?: string;
     DimensionValueID?: string;
+    ShipToAddressSnapshot?: string;
     Person?: string;
     BilledToDate: number;
     ReadableFields___?: string[];
@@ -670,6 +680,7 @@ export declare class CreatemjBizAppsOrdersEventOrderLineInput {
     DimensionValueID: string | null;
     BilledToDate?: number;
     RecognizedToDate?: number;
+    ShipToAddressSnapshot: string | null;
     RestoreContext___?: RestoreContextInput;
 }
 export declare class UpdatemjBizAppsOrdersEventOrderLineInput {
@@ -722,6 +733,7 @@ export declare class UpdatemjBizAppsOrdersEventOrderLineInput {
     DimensionValueID?: string | null;
     BilledToDate?: number;
     RecognizedToDate?: number;
+    ShipToAddressSnapshot?: string | null;
     OldValues___?: KeyValuePairInput[];
     RestoreContext___?: RestoreContextInput;
 }
@@ -1269,6 +1281,8 @@ export declare class mjBizAppsOrdersOrderHeader_ {
     Origin?: string;
     SourceCheckoutWidgetID?: string;
     FulfillmentStatus?: string;
+    BillToAddressSnapshot?: string;
+    ShipToAddressSnapshot?: string;
     Company?: string;
     BillToPerson?: string;
     BillToOrganization?: string;
@@ -1326,6 +1340,8 @@ export declare class CreatemjBizAppsOrdersOrderHeaderInput {
     Origin?: string;
     SourceCheckoutWidgetID: string | null;
     FulfillmentStatus?: string;
+    BillToAddressSnapshot: string | null;
+    ShipToAddressSnapshot: string | null;
     RestoreContext___?: RestoreContextInput;
 }
 export declare class UpdatemjBizAppsOrdersOrderHeaderInput {
@@ -1363,6 +1379,8 @@ export declare class UpdatemjBizAppsOrdersOrderHeaderInput {
     Origin?: string;
     SourceCheckoutWidgetID?: string | null;
     FulfillmentStatus?: string;
+    BillToAddressSnapshot?: string | null;
+    ShipToAddressSnapshot?: string | null;
     OldValues___?: KeyValuePairInput[];
     RestoreContext___?: RestoreContextInput;
 }
@@ -1522,6 +1540,7 @@ export declare class mjBizAppsOrdersOrderLine_ {
     PriceOverrideReason?: string;
     DimensionID?: string;
     DimensionValueID?: string;
+    ShipToAddressSnapshot?: string;
     BilledToDate: number;
     RecognizedToDate: number;
     OrderHeader?: string;
@@ -1578,6 +1597,7 @@ export declare class CreatemjBizAppsOrdersOrderLineInput {
     DimensionValueID: string | null;
     BilledToDate?: number;
     RecognizedToDate?: number;
+    ShipToAddressSnapshot: string | null;
     RestoreContext___?: RestoreContextInput;
 }
 export declare class UpdatemjBizAppsOrdersOrderLineInput {
@@ -1616,6 +1636,7 @@ export declare class UpdatemjBizAppsOrdersOrderLineInput {
     DimensionValueID?: string | null;
     BilledToDate?: number;
     RecognizedToDate?: number;
+    ShipToAddressSnapshot?: string | null;
     OldValues___?: KeyValuePairInput[];
     RestoreContext___?: RestoreContextInput;
 }
@@ -1797,6 +1818,7 @@ export declare class mjBizAppsOrdersPaymentHeader_ {
     IdempotencyKey?: string;
     _mj__CreatedAt: Date;
     _mj__UpdatedAt: Date;
+    ReversalSource?: string;
     ReceivingCompany?: string;
     BillToPerson?: string;
     BillToOrganization?: string;
@@ -1831,6 +1853,7 @@ export declare class CreatemjBizAppsOrdersPaymentHeaderInput {
     Description: string | null;
     Notes: string | null;
     IdempotencyKey: string | null;
+    ReversalSource: string | null;
     RestoreContext___?: RestoreContextInput;
 }
 export declare class UpdatemjBizAppsOrdersPaymentHeaderInput {
@@ -1856,6 +1879,7 @@ export declare class UpdatemjBizAppsOrdersPaymentHeaderInput {
     Description?: string | null;
     Notes?: string | null;
     IdempotencyKey?: string | null;
+    ReversalSource?: string | null;
     OldValues___?: KeyValuePairInput[];
     RestoreContext___?: RestoreContextInput;
 }