@mj-biz-apps/contracts-actions 0.11.0 → 0.12.1

package/dist/index.d.ts

@@ -1,31 +1,3 @@
-/**
- * @mj-biz-apps/contracts-actions — the app's ACTIONS package (OPTIONAL — delete the
- * package + its manifest entry if your app exposes no Actions).
- *
- * Actions are metadata-driven integration points for agents / workflows /
- * low-code — NOT for code-to-code calls (import classes directly for that).
- *
- * WHAT LIVES HERE
- *   src/generated/  — CodeGen ActionSubclasses output (do not hand-edit)
- *   src/            — your hand-written BaseAction subclasses
- *
- * EXAMPLE — a hand-written action (uncomment once @memberjunction/* deps are
- * present in your workspace, register the action row via metadata + a
- * migration, then run codegen):
- *
- *   import { RegisterClass } from '@memberjunction/global';
- *   import { BaseAction } from '@memberjunction/actions';
- *   import { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
- *
- *   @RegisterClass(BaseAction, 'MJ_BizApps_Contracts: Do Something')
- *   export class DoSomethingAction extends BaseAction {
- *       protected async InternalRunAction(params: RunActionParams): Promise<ActionResultSimple> {
- *           return { Success: true, ResultCode: 'SUCCESS' };
- *       }
- *   }
- *
- * The Load function below is imported by the server bootstrap so bundlers
- * cannot tree-shake the @RegisterClass side effects away.
- */
+export { RECORD_NON_RENEWAL_OUTCOMES_SQL, RecordNonRenewalOutcomesAction } from './record-nonrenewal-outcomes.action.js';
 export declare function LoadMjBizappsContractsActions(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAEzH,wBAAgB,6BAA6B,IAAI,IAAI,CAGpD"}

package/dist/index.js

@@ -27,7 +27,10 @@
  * The Load function below is imported by the server bootstrap so bundlers
  * cannot tree-shake the @RegisterClass side effects away.
  */
+import { LoadRecordNonRenewalOutcomesAction } from './record-nonrenewal-outcomes.action.js';
+export { RECORD_NON_RENEWAL_OUTCOMES_SQL, RecordNonRenewalOutcomesAction } from './record-nonrenewal-outcomes.action.js';
 export function LoadMjBizappsContractsActions() {
-    // No-op: importing this module registers the action classes above.
+    // Importing this module registers the action classes; the call keeps bundlers from dropping them.
+    LoadRecordNonRenewalOutcomesAction();
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,6BAA6B;IACzC,mEAAmE;AACvE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAAE,kCAAkC,EAAE,MAAM,wCAAwC,CAAC;AAE5F,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAEzH,MAAM,UAAU,6BAA6B;IACzC,kGAAkG;IAClG,kCAAkC,EAAE,CAAC;AACzC,CAAC"}

package/dist/record-nonrenewal-outcomes.action.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview `Contracts.RecordNonRenewalOutcomes` — records the renewal-risk label on contracts whose
+ * end date has passed (issue #159).
+ *
+ * `Contract.NonRenewalOutcome` is a stored column. The database writes it on every save (a trigger) and
+ * holds the rule in one function, so a termination or a supersession is recorded by the save that makes
+ * it. An expiry has no save behind it: the end date passes. This action runs the procedure that applies
+ * the same rule to every row whose stored value differs from it today, and a scheduled job runs it hourly.
+ *
+ * The rule stays in SQL, in `fnContractNonRenewalOutcome`. This file only calls it.
+ *
+ * @module @mj-biz-apps/contracts-actions
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+import { type PlatformSQL } from '@memberjunction/core';
+/**
+ * The call, one form per database. SQL Server: a procedure that ends with `SELECT @Changed AS Changed`.
+ * PostgreSQL: a function of the same name returning the count. The schema is unquoted and the function
+ * name quoted, the converter's convention (see `ASSIGN_CONTRACT_NUMBER_SQL` in CoreEntitiesServer).
+ */
+export declare const RECORD_NON_RENEWAL_OUTCOMES_SQL: PlatformSQL;
+export declare class RecordNonRenewalOutcomesAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+/** Anti-tree-shaking anchor — `@RegisterClass` is a side effect of import. */
+export declare function LoadRecordNonRenewalOutcomesAction(): void;
+//# sourceMappingURL=record-nonrenewal-outcomes.action.d.ts.map

package/dist/record-nonrenewal-outcomes.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-nonrenewal-outcomes.action.d.ts","sourceRoot":"","sources":["../src/record-nonrenewal-outcomes.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACrG,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG7F;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,EAAE,WAG7C,CAAC;AAYF,qBACa,8BAA+B,SAAQ,UAAU;cAC1C,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0B1F;AAED,8EAA8E;AAC9E,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/record-nonrenewal-outcomes.action.js

@@ -0,0 +1,73 @@
+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;
+};
+/**
+ * @fileoverview `Contracts.RecordNonRenewalOutcomes` — records the renewal-risk label on contracts whose
+ * end date has passed (issue #159).
+ *
+ * `Contract.NonRenewalOutcome` is a stored column. The database writes it on every save (a trigger) and
+ * holds the rule in one function, so a termination or a supersession is recorded by the save that makes
+ * it. An expiry has no save behind it: the end date passes. This action runs the procedure that applies
+ * the same rule to every row whose stored value differs from it today, and a scheduled job runs it hourly.
+ *
+ * The rule stays in SQL, in `fnContractNonRenewalOutcome`. This file only calls it.
+ *
+ * @module @mj-biz-apps/contracts-actions
+ */
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+/**
+ * The call, one form per database. SQL Server: a procedure that ends with `SELECT @Changed AS Changed`.
+ * PostgreSQL: a function of the same name returning the count. The schema is unquoted and the function
+ * name quoted, the converter's convention (see `ASSIGN_CONTRACT_NUMBER_SQL` in CoreEntitiesServer).
+ */
+export const RECORD_NON_RENEWAL_OUTCOMES_SQL = {
+    default: `EXEC __mj_BizAppsContracts.spRecordContractNonRenewalOutcomes;`,
+    postgresql: `SELECT __mj_BizAppsContracts."spRecordContractNonRenewalOutcomes"() AS "Changed";`,
+};
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+let RecordNonRenewalOutcomesAction = class RecordNonRenewalOutcomesAction extends BaseAction {
+    async InternalRunAction(params) {
+        try {
+            // A server-side action always runs on a database provider; the metadata-provider type does not
+            // declare ExecuteSQL, so this narrows to the base class that does.
+            const db = Metadata.Provider;
+            const rows = await db.ExecuteSQL(db.ResolveSQL(RECORD_NON_RENEWAL_OUTCOMES_SQL), undefined, { isMutation: true, description: 'spRecordContractNonRenewalOutcomes' }, params.ContextUser);
+            const changed = Number(rows?.[0]?.Changed ?? 0);
+            setOutput(params, 'Changed', changed);
+            return {
+                Success: true,
+                ResultCode: 'SUCCESS',
+                Message: `Recorded the renewal outcome on ${changed} contract(s).`,
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `Recording renewal outcomes failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+};
+RecordNonRenewalOutcomesAction = __decorate([
+    RegisterClass(BaseAction, 'Contracts.RecordNonRenewalOutcomes')
+], RecordNonRenewalOutcomesAction);
+export { RecordNonRenewalOutcomesAction };
+/** Anti-tree-shaking anchor — `@RegisterClass` is a side effect of import. */
+export function LoadRecordNonRenewalOutcomesAction() {
+    void RecordNonRenewalOutcomesAction;
+}
+//# sourceMappingURL=record-nonrenewal-outcomes.action.js.map

package/dist/record-nonrenewal-outcomes.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-nonrenewal-outcomes.action.js","sourceRoot":"","sources":["../src/record-nonrenewal-outcomes.action.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAA6B,QAAQ,EAAoB,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAgB;IACxD,OAAO,EAAE,gEAAgE;IACzE,UAAU,EAAE,mFAAmF;CAClG,CAAC;AAEF,SAAS,SAAS,CAAC,MAAuB,EAAE,IAAY,EAAE,KAAc;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1F,IAAI,QAAQ,EAAE,CAAC;QACX,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,OAAO;IACX,CAAC;IACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAiB,CAAC,CAAC;AACpF,CAAC;AAGM,IAAM,8BAA8B,GAApC,MAAM,8BAA+B,SAAQ,UAAU;IAChD,KAAK,CAAC,iBAAiB,CAAC,MAAuB;QACrD,IAAI,CAAC;YACD,+FAA+F;YAC/F,mEAAmE;YACnE,MAAM,EAAE,GAAG,QAAQ,CAAC,QAA2C,CAAC;YAChE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,UAAU,CAC5B,EAAE,CAAC,UAAU,CAAC,+BAA+B,CAAC,EAC9C,SAAS,EACT,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,oCAAoC,EAAE,EACvE,MAAM,CAAC,WAAW,CACrB,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;YAChD,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,mCAAmC,OAAO,eAAe;aACrE,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,OAAO;gBACnB,OAAO,EAAE,sCAAsC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC1G,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAA;AA3BY,8BAA8B;IAD1C,aAAa,CAAC,UAAU,EAAE,oCAAoC,CAAC;GACnD,8BAA8B,CA2B1C;;AAED,8EAA8E;AAC9E,MAAM,UAAU,kCAAkC;IAC9C,KAAK,8BAA8B,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mj-biz-apps/contracts-actions",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "type": "module",
   "description": "MemberJunction Actions exposed by the Contracts application (generated subclasses and hand-written actions).",
   "main": "dist/index.js",