@rytass/bpm-core-shared 0.18.0 → 0.19.0

package/src/lib/workflow.d.ts

@@ -93,6 +93,26 @@ export type ApproverResolver = {
 } | {
     readonly expression: string;
     readonly type: 'EXPRESSION';
+} | {
+    readonly fallback?: ApproverResolverFallback;
+    readonly formPath: string;
+    readonly levelsUp: number;
+    readonly preferClosestOrgUnit?: boolean;
+    readonly type: 'FORM_MEMBER_MANAGER';
+} | {
+    readonly fallback?: ApproverResolverFallback;
+    readonly formPath: string;
+    readonly preferClosestOrgUnit?: boolean;
+    readonly type: 'FORM_ORG_UNIT_MANAGER';
+} | {
+    readonly nodeIds: readonly string[];
+    readonly type: 'NODE_ACTOR';
+} | {
+    readonly fallback?: ApproverResolverFallback;
+    readonly levelsUp: number;
+    readonly nodeIds: readonly string[];
+    readonly preferClosestOrgUnit?: boolean;
+    readonly type: 'NODE_ACTOR_MANAGER';
 };
 export type ApproverResolverFallback = {
     readonly type: 'NONE';
@@ -103,8 +123,10 @@ export type ApproverResolverFallback = {
 } | {
     /**
      * Members of this position, resolved the way a POSITION node resolves
-     * them at the moment the node starts. Only ORG_MANAGER, ORG_UNIT_MANAGER
-     * and ORG_MANAGER_CHAIN take it. Older engines reject it at run time.
+     * them at the moment the node starts. Only the manager resolvers take
+     * it: ORG_MANAGER, ORG_UNIT_MANAGER, ORG_MANAGER_CHAIN,
+     * FORM_MEMBER_MANAGER, FORM_ORG_UNIT_MANAGER and NODE_ACTOR_MANAGER.
+     * Older engines reject it at run time.
      */
     readonly allowInitiatorSelfApproval?: boolean;
     readonly positionId: string;
@@ -120,6 +142,20 @@ export type ApproverResolverFallback = {
 export declare function readUnsupportedApproverFallbackType(fallback: {
     readonly type: string;
 }): string | null;
+/**
+ * The resolver's type when this build does not know it (a definition saved by
+ * a newer version), or `null` when it does. Takes a bare `type` so a newer
+ * definition can be checked without the compiler having narrowed it away.
+ * The engine refuses such a resolver at run time instead of guessing; the
+ * designer keeps it untouched and shows it read-only.
+ */
+export declare function readUnsupportedApproverResolverType(resolver: {
+    readonly type: string;
+}): string | null;
+/** Whether a notify node may use this resolver type for its recipients. */
+export declare function isNotifyRecipientResolverType(type: string): boolean;
+/** Whether a resolver of this type may carry a "no manager" fallback. */
+export declare function isFallbackCapableApproverResolverType(type: string): boolean;
 export type DecisionPolicy = {
     readonly type: 'SINGLE';
 } | {

package/src/lib/workflow.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readUnsupportedApproverFallbackType = readUnsupportedApproverFallbackType;
+exports.readUnsupportedApproverResolverType = readUnsupportedApproverResolverType;
+exports.isNotifyRecipientResolverType = isNotifyRecipientResolverType;
+exports.isFallbackCapableApproverResolverType = isFallbackCapableApproverResolverType;
 // Keyed by the union so that adding a fallback type fails to compile until it
 // is listed here: the engine and the designer both read this one table.
 const KNOWN_APPROVER_FALLBACK_TYPES = {
@@ -20,4 +23,66 @@ function readUnsupportedApproverFallbackType(fallback) {
         ? null
         : fallback.type;
 }
+// Keyed by the union so that adding a resolver type fails to compile until it
+// is listed here: the engine and the designer both read this one table.
+const KNOWN_APPROVER_RESOLVER_TYPES = {
+    DIRECT: true,
+    DYNAMIC_FORM: true,
+    EXPRESSION: true,
+    FORM_MEMBER_MANAGER: true,
+    FORM_ORG_UNIT_MANAGER: true,
+    NODE_ACTOR: true,
+    NODE_ACTOR_MANAGER: true,
+    ORG_MANAGER: true,
+    ORG_MANAGER_CHAIN: true,
+    ORG_UNIT_MANAGER: true,
+    ORG_UNIT_MEMBER: true,
+    ORG_UNIT_POSITION: true,
+    POSITION: true,
+};
+// A notify node's recipients are resolved without a running approval path, so
+// the sources that need a form pick or earlier signers are not offered there.
+const NOTIFY_RECIPIENT_RESOLVER_TYPES = {
+    DIRECT: true,
+    DYNAMIC_FORM: true,
+    EXPRESSION: true,
+    ORG_MANAGER: true,
+    ORG_MANAGER_CHAIN: true,
+    ORG_UNIT_MANAGER: true,
+    ORG_UNIT_MEMBER: true,
+    ORG_UNIT_POSITION: true,
+    POSITION: true,
+};
+// Resolvers that look a manager up, so "no manager" is a state they can reach.
+const FALLBACK_CAPABLE_RESOLVER_TYPES = {
+    FORM_MEMBER_MANAGER: true,
+    FORM_ORG_UNIT_MANAGER: true,
+    NODE_ACTOR_MANAGER: true,
+    ORG_MANAGER: true,
+    ORG_MANAGER_CHAIN: true,
+    ORG_UNIT_MANAGER: true,
+};
+function hasOwnKey(table, key) {
+    return Object.prototype.hasOwnProperty.call(table, key);
+}
+/**
+ * The resolver's type when this build does not know it (a definition saved by
+ * a newer version), or `null` when it does. Takes a bare `type` so a newer
+ * definition can be checked without the compiler having narrowed it away.
+ * The engine refuses such a resolver at run time instead of guessing; the
+ * designer keeps it untouched and shows it read-only.
+ */
+function readUnsupportedApproverResolverType(resolver) {
+    return hasOwnKey(KNOWN_APPROVER_RESOLVER_TYPES, resolver.type)
+        ? null
+        : resolver.type;
+}
+/** Whether a notify node may use this resolver type for its recipients. */
+function isNotifyRecipientResolverType(type) {
+    return hasOwnKey(NOTIFY_RECIPIENT_RESOLVER_TYPES, type);
+}
+/** Whether a resolver of this type may carry a "no manager" fallback. */
+function isFallbackCapableApproverResolverType(type) {
+    return hasOwnKey(FALLBACK_CAPABLE_RESOLVER_TYPES, type);
+}
 //# sourceMappingURL=workflow.js.map

package/src/lib/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../libs/shared/src/lib/workflow.ts"],"names":[],"mappings":";;AA6JA,kFASC;AA1BD,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,6BAA6B,GAE/B;IACF,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF;;;;;;GAMG;AACH,SAAgB,mCAAmC,CAAC,QAEnD;IACC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACzC,6BAA6B,EAC7B,QAAQ,CAAC,IAAI,CACd;QACC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACpB,CAAC"}
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../libs/shared/src/lib/workflow.ts"],"names":[],"mappings":";;AAoLA,kFASC;AAyED,kFAMC;AAGD,sEAEC;AAGD,sFAEC;AAnHD,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,6BAA6B,GAE/B;IACF,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF;;;;;;GAMG;AACH,SAAgB,mCAAmC,CAAC,QAEnD;IACC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACzC,6BAA6B,EAC7B,QAAQ,CAAC,IAAI,CACd;QACC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,6BAA6B,GAE/B;IACF,MAAM,EAAE,IAAI;IACZ,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,mBAAmB,EAAE,IAAI;IACzB,qBAAqB,EAAE,IAAI;IAC3B,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,IAAI;CACf,CAAC;AAEF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,+BAA+B,GAEjC;IACF,MAAM,EAAE,IAAI;IACZ,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,IAAI;CACf,CAAC;AAQF,+EAA+E;AAC/E,MAAM,+BAA+B,GAQjC;IACF,mBAAmB,EAAE,IAAI;IACzB,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAEF,SAAS,SAAS,CAAC,KAAa,EAAE,GAAW;IAC3C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mCAAmC,CAAC,QAEnD;IACC,OAAO,SAAS,CAAC,6BAA6B,EAAE,QAAQ,CAAC,IAAI,CAAC;QAC5D,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,2EAA2E;AAC3E,SAAgB,6BAA6B,CAAC,IAAY;IACxD,OAAO,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,yEAAyE;AACzE,SAAgB,qCAAqC,CAAC,IAAY;IAChE,OAAO,SAAS,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC"}