@resconet/qp-bridge 1.4.1-alpha.9 → 1.5.0-alpha.13

package/lib/qp-bridge-types.d.ts

@@ -2,9 +2,9 @@ import { z } from 'zod';
 /**
  * Feature version for qp-bridge protocol.
  * Increment this version when making breaking changes to the bridge API.
- * Current version: 1
+ * Current version: 2
  */
-export declare const QP_BRIDGE_FEATURE_VERSION = 1;
+export declare const QP_BRIDGE_FEATURE_VERSION = 3;
 export declare const qpBridgeBaseMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"qp-bridge">;
     id: z.ZodOptional<z.ZodString>;
@@ -132,44 +132,50 @@ export declare const responseErrorMessageSchema: z.ZodObject<{
     id?: string | undefined;
     instanceId?: string | undefined;
 }>;
+export declare const questionTypeSchema: z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>;
 export declare const questionSchema: z.ZodObject<{
+    type: z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>;
     semanticColor: z.ZodOptional<z.ZodString>;
-    label: z.ZodString;
-    description: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
     disabled: z.ZodBoolean;
     required: z.ZodBoolean;
     hidden: z.ZodBoolean;
     errorMessage: z.ZodOptional<z.ZodString>;
     answer: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
-    label: string;
-    description: string;
+    type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
     disabled: boolean;
     required: boolean;
     hidden: boolean;
     answer?: unknown;
     semanticColor?: string | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
     errorMessage?: string | undefined;
 }, {
-    label: string;
-    description: string;
+    type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
     disabled: boolean;
     required: boolean;
     hidden: boolean;
     answer?: unknown;
     semanticColor?: string | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
     errorMessage?: string | undefined;
 }>;
 export declare const questionOptionalScheme: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>>;
     semanticColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-    label: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     required: z.ZodOptional<z.ZodBoolean>;
     hidden: z.ZodOptional<z.ZodBoolean>;
     errorMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     answer: z.ZodOptional<z.ZodOptional<z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
+    type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
     answer?: unknown;
     semanticColor?: string | undefined;
     label?: string | undefined;
@@ -179,6 +185,7 @@ export declare const questionOptionalScheme: z.ZodObject<{
     hidden?: boolean | undefined;
     errorMessage?: string | undefined;
 }, {
+    type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
     answer?: unknown;
     semanticColor?: string | undefined;
     label?: string | undefined;
@@ -188,6 +195,44 @@ export declare const questionOptionalScheme: z.ZodObject<{
     hidden?: boolean | undefined;
     errorMessage?: string | undefined;
 }>;
+export declare const questionnaireQuestionSchema: z.ZodObject<{
+    type: z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>;
+    semanticColor: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodBoolean;
+    required: z.ZodBoolean;
+    hidden: z.ZodBoolean;
+    errorMessage: z.ZodOptional<z.ZodString>;
+    answer: z.ZodOptional<z.ZodUnknown>;
+} & {
+    itemType: z.ZodLiteral<"question">;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
+    disabled: boolean;
+    required: boolean;
+    hidden: boolean;
+    itemType: "question";
+    name: string;
+    answer?: unknown;
+    semanticColor?: string | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    errorMessage?: string | undefined;
+}, {
+    type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
+    disabled: boolean;
+    required: boolean;
+    hidden: boolean;
+    itemType: "question";
+    name: string;
+    answer?: unknown;
+    semanticColor?: string | undefined;
+    label?: string | undefined;
+    description?: string | undefined;
+    errorMessage?: string | undefined;
+}>;
 export declare const mediaItemSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -231,9 +276,107 @@ export declare const groupOptionalScheme: z.ZodObject<{
     hidden?: boolean | undefined;
     collapsed?: boolean | undefined;
 }>;
+export declare const questionnaireStaticComponentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    itemType: z.ZodLiteral<"staticComponent">;
+    type: z.ZodLiteral<"staticDescription">;
+    name: z.ZodString;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "staticDescription";
+    itemType: "staticComponent";
+    name: string;
+    content: string;
+    hidden?: boolean | undefined;
+}, {
+    type: "staticDescription";
+    itemType: "staticComponent";
+    name: string;
+    content: string;
+    hidden?: boolean | undefined;
+}>, z.ZodObject<{
+    itemType: z.ZodLiteral<"staticComponent">;
+    type: z.ZodLiteral<"button">;
+    name: z.ZodString;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    clickText: z.ZodString;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    semanticColor: z.ZodOptional<z.ZodString>;
+    commandName: z.ZodOptional<z.ZodString>;
+    commandLabel: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "button";
+    itemType: "staticComponent";
+    name: string;
+    clickText: string;
+    commandName?: string | undefined;
+    semanticColor?: string | undefined;
+    disabled?: boolean | undefined;
+    hidden?: boolean | undefined;
+    commandLabel?: string | undefined;
+}, {
+    type: "button";
+    itemType: "staticComponent";
+    name: string;
+    clickText: string;
+    commandName?: string | undefined;
+    semanticColor?: string | undefined;
+    disabled?: boolean | undefined;
+    hidden?: boolean | undefined;
+    commandLabel?: string | undefined;
+}>]>;
+declare const questionnaireGroupBaseSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    collapsed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    itemType: z.ZodLiteral<"group">;
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    itemType: "group";
+    name: string;
+    label?: string | undefined;
+    hidden?: boolean | undefined;
+    collapsed?: boolean | undefined;
+}, {
+    itemType: "group";
+    name: string;
+    label?: string | undefined;
+    hidden?: boolean | undefined;
+    collapsed?: boolean | undefined;
+}>;
+declare const questionnaireRepeatableGroupBaseSchema: z.ZodObject<{
+    itemType: z.ZodLiteral<"repeatableGroup">;
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    itemType: "repeatableGroup";
+    name: string;
+    label?: string | undefined;
+    hidden?: boolean | undefined;
+}, {
+    itemType: "repeatableGroup";
+    name: string;
+    label?: string | undefined;
+    hidden?: boolean | undefined;
+}>;
+export type QuestionnaireQuestion = z.infer<typeof questionnaireQuestionSchema>;
+export type QuestionnaireStaticComponent = z.infer<typeof questionnaireStaticComponentSchema>;
+export type QuestionnaireGroup = z.infer<typeof questionnaireGroupBaseSchema> & {
+    readonly items: readonly QuestionnaireItem[];
+};
+export type QuestionnaireRepeatableGroup = z.infer<typeof questionnaireRepeatableGroupBaseSchema> & {
+    readonly groups: readonly QuestionnaireGroup[];
+};
+export type QuestionnaireItem = QuestionnaireQuestion | QuestionnaireGroup | QuestionnaireRepeatableGroup | QuestionnaireStaticComponent;
+export declare const questionnaireItemSchema: z.ZodType<QuestionnaireItem>;
+export declare const questionnaireGroupSchema: z.ZodType<QuestionnaireGroup>;
+export declare const questionnaireRepeatableGroupSchema: z.ZodType<QuestionnaireRepeatableGroup>;
 export declare const questionnaireSchema: z.ZodObject<{
     isNew: z.ZodBoolean;
     id: z.ZodString;
+    name: z.ZodString;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     regarding: z.ZodOptional<z.ZodObject<{
@@ -249,9 +392,12 @@ export declare const questionnaireSchema: z.ZodObject<{
         name: string;
         entityName: string;
     }>>;
+    items: z.ZodArray<z.ZodType<QuestionnaireItem, z.ZodTypeDef, QuestionnaireItem>, "many">;
 }, "strip", z.ZodTypeAny, {
     id: string;
     label: string;
+    name: string;
+    items: QuestionnaireItem[];
     isNew: boolean;
     description?: string | undefined;
     regarding?: {
@@ -262,6 +408,8 @@ export declare const questionnaireSchema: z.ZodObject<{
 }, {
     id: string;
     label: string;
+    name: string;
+    items: QuestionnaireItem[];
     isNew: boolean;
     description?: string | undefined;
     regarding?: {
@@ -302,44 +450,48 @@ export declare const getQuestionSuccessResponseMessageSchema: z.ZodObject<{
     status: z.ZodLiteral<"success">;
 } & {
     question: z.ZodObject<{
+        type: z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>;
         semanticColor: z.ZodOptional<z.ZodString>;
-        label: z.ZodString;
-        description: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         disabled: z.ZodBoolean;
         required: z.ZodBoolean;
         hidden: z.ZodBoolean;
         errorMessage: z.ZodOptional<z.ZodString>;
         answer: z.ZodOptional<z.ZodUnknown>;
     }, "strip", z.ZodTypeAny, {
-        label: string;
-        description: string;
+        type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
         disabled: boolean;
         required: boolean;
         hidden: boolean;
         answer?: unknown;
         semanticColor?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
         errorMessage?: string | undefined;
     }, {
-        label: string;
-        description: string;
+        type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
         disabled: boolean;
         required: boolean;
         hidden: boolean;
         answer?: unknown;
         semanticColor?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
         errorMessage?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     type: "qp-bridge";
     status: "success";
     question: {
-        label: string;
-        description: string;
+        type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
         disabled: boolean;
         required: boolean;
         hidden: boolean;
         answer?: unknown;
         semanticColor?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
         errorMessage?: string | undefined;
     };
     id?: string | undefined;
@@ -348,13 +500,14 @@ export declare const getQuestionSuccessResponseMessageSchema: z.ZodObject<{
     type: "qp-bridge";
     status: "success";
     question: {
-        label: string;
-        description: string;
+        type: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup";
         disabled: boolean;
         required: boolean;
         hidden: boolean;
         answer?: unknown;
         semanticColor?: string | undefined;
+        label?: string | undefined;
+        description?: string | undefined;
         errorMessage?: string | undefined;
     };
     id?: string | undefined;
@@ -370,15 +523,17 @@ export declare const setQuestionRequestMessageSchema: z.ZodObject<{
     action: z.ZodLiteral<"setQuestion">;
     question: z.ZodString;
     questionData: z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<["imageMedia", "shortText", "longText", "url", "email", "wholeNumber", "decimalNumber", "date", "dateTime", "singleSelect", "multiSelect", "optionSet", "rating", "yesNo", "signature", "lookup"]>>;
         semanticColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-        label: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         disabled: z.ZodOptional<z.ZodBoolean>;
         required: z.ZodOptional<z.ZodBoolean>;
         hidden: z.ZodOptional<z.ZodBoolean>;
         errorMessage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
         answer: z.ZodOptional<z.ZodOptional<z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
+        type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
         answer?: unknown;
         semanticColor?: string | undefined;
         label?: string | undefined;
@@ -388,6 +543,7 @@ export declare const setQuestionRequestMessageSchema: z.ZodObject<{
         hidden?: boolean | undefined;
         errorMessage?: string | undefined;
     }, {
+        type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
         answer?: unknown;
         semanticColor?: string | undefined;
         label?: string | undefined;
@@ -402,6 +558,7 @@ export declare const setQuestionRequestMessageSchema: z.ZodObject<{
     question: string;
     action: "setQuestion";
     questionData: {
+        type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
         answer?: unknown;
         semanticColor?: string | undefined;
         label?: string | undefined;
@@ -419,6 +576,7 @@ export declare const setQuestionRequestMessageSchema: z.ZodObject<{
     question: string;
     action: "setQuestion";
     questionData: {
+        type?: "date" | "imageMedia" | "shortText" | "longText" | "url" | "email" | "wholeNumber" | "decimalNumber" | "dateTime" | "singleSelect" | "multiSelect" | "optionSet" | "rating" | "yesNo" | "signature" | "lookup" | undefined;
         answer?: unknown;
         semanticColor?: string | undefined;
         label?: string | undefined;
@@ -528,6 +686,7 @@ export declare const getQuestionnaireSuccessResponseMessageSchema: z.ZodObject<{
     questionnaire: z.ZodObject<{
         isNew: z.ZodBoolean;
         id: z.ZodString;
+        name: z.ZodString;
         label: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         regarding: z.ZodOptional<z.ZodObject<{
@@ -543,9 +702,12 @@ export declare const getQuestionnaireSuccessResponseMessageSchema: z.ZodObject<{
             name: string;
             entityName: string;
         }>>;
+        items: z.ZodArray<z.ZodType<QuestionnaireItem, z.ZodTypeDef, QuestionnaireItem>, "many">;
     }, "strip", z.ZodTypeAny, {
         id: string;
         label: string;
+        name: string;
+        items: QuestionnaireItem[];
         isNew: boolean;
         description?: string | undefined;
         regarding?: {
@@ -556,6 +718,8 @@ export declare const getQuestionnaireSuccessResponseMessageSchema: z.ZodObject<{
     }, {
         id: string;
         label: string;
+        name: string;
+        items: QuestionnaireItem[];
         isNew: boolean;
         description?: string | undefined;
         regarding?: {
@@ -570,6 +734,8 @@ export declare const getQuestionnaireSuccessResponseMessageSchema: z.ZodObject<{
     questionnaire: {
         id: string;
         label: string;
+        name: string;
+        items: QuestionnaireItem[];
         isNew: boolean;
         description?: string | undefined;
         regarding?: {
@@ -586,6 +752,8 @@ export declare const getQuestionnaireSuccessResponseMessageSchema: z.ZodObject<{
     questionnaire: {
         id: string;
         label: string;
+        name: string;
+        items: QuestionnaireItem[];
         isNew: boolean;
         description?: string | undefined;
         regarding?: {
@@ -639,6 +807,30 @@ export declare const canSaveRequestMessageSchema: z.ZodObject<{
     instanceId?: string | undefined;
     featureVersion?: number | undefined;
 }>;
+export declare const postSaveRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"qp-bridge">;
+    id: z.ZodOptional<z.ZodString>;
+    instanceId: z.ZodOptional<z.ZodString>;
+} & {
+    featureVersion: z.ZodOptional<z.ZodNumber>;
+} & {
+    action: z.ZodLiteral<"postSave">;
+    answerId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "qp-bridge";
+    action: "postSave";
+    answerId: string;
+    id?: string | undefined;
+    instanceId?: string | undefined;
+    featureVersion?: number | undefined;
+}, {
+    type: "qp-bridge";
+    action: "postSave";
+    answerId: string;
+    id?: string | undefined;
+    instanceId?: string | undefined;
+    featureVersion?: number | undefined;
+}>;
 export declare const setGroupRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"qp-bridge">;
     id: z.ZodOptional<z.ZodString>;
@@ -1020,6 +1212,7 @@ export type QpBridgeBaseMessage = z.infer<typeof qpBridgeBaseMessageSchema>;
 export type QpBridgeRequestMessage = z.infer<typeof qpBridgeRequestMessageSchema>;
 export type ResponseSuccessMessage = z.infer<typeof responseSuccessMessageSchema>;
 export type ResponseErrorMessage = z.infer<typeof responseErrorMessageSchema>;
+export type QuestionType = z.infer<typeof questionTypeSchema>;
 export type Question = z.infer<typeof questionSchema>;
 export type QuestionOptional = z.infer<typeof questionOptionalScheme>;
 export type Group = z.infer<typeof groupSchema>;
@@ -1048,6 +1241,7 @@ export type SaveQuestionnaireRequestMessage = z.infer<typeof saveQuestionnaireRe
 export type CompleteAndCloseQuestionnaireRequestMessage = z.infer<typeof completeAndCloseQuestionnaireRequestMessageSchema>;
 export type ExecuteCustomCommandRequestMessage = z.infer<typeof executeCustomCommandRequestMessageSchema>;
 export type CanSaveRequestMessage = z.infer<typeof canSaveRequestMessageSchema>;
+export type PostSaveRequestMessage = z.infer<typeof postSaveRequestMessageSchema>;
 export type FetchEntitiesRequestMessage = z.infer<typeof fetchEntitiesRequestMessageSchema>;
 export type GetEntityByIdRequestMessage = z.infer<typeof getEntityByIdRequestMessageSchema>;
 export type SaveEntityRequestMessage = z.infer<typeof saveEntityRequestMessageSchema>;
@@ -1074,6 +1268,7 @@ export declare function isGetGroupSuccessResponseMessage(data: unknown): data is
 export declare function isGetQuestionnaireSuccessResponseMessage(data: unknown): data is GetQuestionnaireSuccessResponseMessage;
 export declare function isCanSaveSuccessResponseMessage(data: unknown): data is CanSaveSuccessResponseMessage;
 export declare function isCanSaveRequestMessage(data: unknown): data is CanSaveRequestMessage;
+export declare function isPostSaveRequestMessage(data: unknown): data is PostSaveRequestMessage;
 export declare function isBusyIndicatorStartRequestMessage(data: unknown): data is BusyIndicatorStartRequestMessage;
 export declare function isBusyIndicatorEndRequestMessage(data: unknown): data is BusyIndicatorEndRequestMessage;
 export declare function isSaveQuestionnaireRequestMessage(data: unknown): data is SaveQuestionnaireRequestMessage;
@@ -1089,3 +1284,4 @@ export declare function isSaveEntityRequestMessage(data: unknown): data is SaveE
 export declare function isRepeatGroupRequestMessage(data: unknown): data is RepeatGroupRequestMessage;
 export declare function isAddNewGroupRequestMessage(data: unknown): data is AddNewGroupRequestMessage;
 export declare function isDeleteGroupRequestMessage(data: unknown): data is DeleteGroupRequestMessage;
+export {};

package/lib/qp-bridge.d.ts

@@ -1,4 +1,4 @@
-import { Entity, Group, GroupOptional, MediaItem, Question, QuestionOptional, Questionnaire } from './qp-bridge-types';
+import { Entity, Group, GroupOptional, MediaItem, Question, QuestionnaireItem, QuestionnaireQuestion, QuestionOptional, Questionnaire } from './qp-bridge-types';
 export type QpBridgeOptions = {
     instanceId?: string;
 };
@@ -77,19 +77,37 @@ export declare function removeOnSaveMessageHandler(): void;
  * The resolved `Questionnaire` object has the following properties:
  * - `isNew` — Whether the questionnaire is a new (unsaved) record.
  * - `id` — Unique identifier (UUID) of the questionnaire record.
- * - `label` — Display name of the questionnaire.
+ * - `name` — Logical questionnaire name.
+ * - `label` — Display name of the questionnaire. Kept as an alias for existing bridge consumers.
  * - `description` _(optional)_ — Description or notes for the questionnaire.
  * - `regarding` _(optional)_ — Reference to the related entity this questionnaire is associated with (`entityName`, `id`, `name`).
+ * - `items` — Questionnaire item tree in domain-model order. Items can be questions, groups, repeatable groups, or static components.
  *
  * @throws {Error} Throws if the questionnaire is not found or the operation fails.
  * @example
  * ```typescript
  * const questionnaire = await getQuestionnaire();
- * console.log(questionnaire.id); // Outputs the ID of the questionnaire
- * console.log(questionnaire.isNew); // Outputs whether the questionnaire is new
+ * console.log(questionnaire.id);
+ * console.log(questionnaire.items.map(item => item.name));
+ * console.log(flattenQuestions(questionnaire).map(question => question.name));
  * ```
  */
 export declare function getQuestionnaire(options?: QpBridgeOptions): Promise<Questionnaire>;
+export type QuestionnaireItemVisitor = (item: QuestionnaireItem, parents: readonly QuestionnaireItem[]) => void;
+/**
+ * Traverses the questionnaire item tree in pre-order and passes parent context to the visitor.
+ *
+ * Repeatable groups are visited before their group instances.
+ */
+export declare function traverseQuestionnaireItems(questionnaire: Questionnaire, visitor: QuestionnaireItemVisitor): void;
+/**
+ * Returns every questionnaire item in tree order.
+ */
+export declare function flattenQuestionnaireItems(questionnaire: Questionnaire): QuestionnaireItem[];
+/**
+ * Returns every question from the questionnaire item tree in tree order.
+ */
+export declare function flattenQuestions(questionnaire: Questionnaire): QuestionnaireQuestion[];
 /**
  * Sets the answer for a specific question in the questionnaire.
  *
@@ -237,6 +255,7 @@ export declare function completeAndCloseQuestionnaire(options?: QpBridgeOptions)
  */
 export declare function executeCustomCommand(commandName: string, options?: QpBridgeOptions): Promise<void>;
 type Validator = () => Promise<boolean>;
+type PostSaveHandler = (answerId: string) => Promise<void> | void;
 /**
  * Registers a handler function to be called when the questionnaire is fully loaded.
  * Useful for performing actions that depend on the questionnaire being ready.
@@ -298,6 +317,26 @@ export declare function onCommandExecuted(handler: (commandName: string) => void
 export declare function onSave(validator: Validator, options?: QpBridgeOptions): {
     cancelSubscription: () => void;
 };
+/**
+ * Registers a handler function to be called after the questionnaire is successfully saved.
+ * The handler receives the saved answer ID and the save flow waits for all handlers to finish before continuing.
+ *
+ * @param handler - A function called with the saved answer ID after save.
+ * @returns An object with a `cancelSubscription` method to unregister the handler.
+ * @example
+ * ```typescript
+ * import { onPostSave } from 'qp-bridge';
+ * const { cancelSubscription } = onPostSave(async answerId => {
+ *   // create related records and set their regarding to answerId
+ * });
+ *
+ * // To stop listening for post-save events:
+ * cancelSubscription();
+ * ```
+ */
+export declare function onPostSave(handler: PostSaveHandler, options?: QpBridgeOptions): {
+    cancelSubscription: () => void;
+};
 /**
  * Fetches entities from the CRM system using the provided FetchXML query.
  *

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@resconet/qp-bridge",
-	"version": "1.4.1-alpha.9",
+	"version": "1.5.0-alpha.13",
 	"main": "./index.js",
 	"module": "./index.mjs",
 	"typings": "./index.d.ts",
 	"dependencies": {
-		"uuid": "^9.0.1",
+		"uuid": "^14.0.0",
 		"zod": "^3.23.8"
 	}
 }