oro-sdk 3.12.0 → 3.15.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 ORO Health Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/helpers/workflow.d.ts

@@ -11,7 +11,53 @@ export declare function filterTriggeredAnsweredWithKind(workflowData: WorkflowDa
  */
 export declare function getWorkflowDataByCategory(workflowData: WorkflowData, category: MetadataCategory): Promise<PopulatedWorkflowData>;
 export declare function getImagesFromIndexDb(answer: SelectedAnswerData): Promise<WorkflowUploadedImage[]>;
-export declare function isTriggered(triggers: string[], answers: string[]): boolean;
+/**
+ * Determine if a question is triggered by some answers
+ *
+ * We use the following logical combinations of rules:
+ *
+ * #### Single string
+ *
+ * ```
+ * // Required: rule1
+ * rules: rule1
+ * ```
+ *
+ * #### Array of strings (AND is applied between statements):
+ *
+ * ```
+ * // Required: rule1 AND rule2
+ * rules: [ rule1, rule2 ]
+ * ```
+ *
+ * #### Array of arrays of strings (OR is applied between inner arrays. AND is applied between inner arrays statements)
+ *
+ * ```
+ * // Required: rule1 OR rule2
+ * rules: [
+ *   [ rule1 ],
+ *   [ rule2 ]
+ * ]
+ *
+ * // Required: rule1 OR (rule2 AND rule3)
+ * rules: [
+ *   [ rule1 ],
+ *   [ rule2, rule3 ]
+ * ]
+ *
+ * // THIS IS FORBIDDEN
+ * rules: [
+ *   rule1, // <-- THIS IS FORBIDDEN. Instead use [ rule1 ]
+ *   [ rule2, rule3 ]
+ * ]
+ * ```
+ *
+ * @param triggers the triggering rules
+ * @param answers the answers to check againts triggering rules
+ * @returns `true` if triggers are verified against ansers. Otherwise, returns `false`.
+ * @throws an Error if triggers typing is wrong
+ */
+export declare function isTriggered(triggers: string[][] | string[] | string, answers: string[]): boolean;
 export declare function flattenSelectedAnswers(answers: SelectedAnswersData): string[];
 /**
  * This function helps you to get a valid workflow selectedAnswers structure