@encatch/schema 1.3.0-beta.4 → 1.3.0-beta.5

package/dist/esm/index.js

@@ -2361,8 +2361,10 @@ var formConfigSchema = z13.object({
 }).describe("Configuration information for the feedback form");
 var questionResponseSchema = z13.object({
   questionId: z13.string().uuid().describe("Unique identifier for the question"),
-  answer: AnswerSchema.describe("The answer provided for this question"),
-  type: z13.string().describe("Type of the question (e.g., 'rating', 'single_choice')"),
+  answer: AnswerSchema.nullable().optional().describe(
+    "The answer provided for this question; null for display-only types (thank_you, welcome, exit_form) or unanswered questions on the respondent's path"
+  ),
+  type: z13.string().optional().describe("Type of the question (e.g., 'rating', 'single_choice')"),
   error: z13.string().optional().describe("Error message if any validation failed"),
   isOnPath: z13.boolean().optional().describe(
     "When present, whether this question was on the respondent's navigation path (e.g. logic jumps); false for questions not reached"
@@ -2405,6 +2407,26 @@ var submitFeedbackSchema = baseSubmitFeedbackSchema.extend({
   response: responseSchema.describe("User responses (required for full submit)")
 }).describe("Full submit feedback request schema (response required)");
 var feedbackRequestSchema = z13.union([partialFeedbackSchema, submitFeedbackSchema]).describe("Union schema for both partial and full feedback submissions");
+var formDetailsSchema = z13.object({
+  formConfigurationId: z13.string().uuid().describe("Server-issued configuration ID for this form"),
+  feedbackIdentifier: z13.string().optional().describe("Instance identifier for the feedback session"),
+  responseLanguageCode: z13.string().optional().describe("Two-letter language code for the response (e.g., 'en')"),
+  isPartialSubmit: z13.boolean().optional().describe("When true, marks this as a partial (mid-journey) submission"),
+  completionTimeInSeconds: z13.number().int().min(0).optional().describe("Total time taken to complete the form in seconds"),
+  response: z13.object({
+    questions: z13.array(questionResponseSchema).optional().describe("Array of per-question responses"),
+    context: z13.record(z13.string(), z13.unknown()).optional().describe("Liquid variable substitution values from the showForm context option"),
+    contact: z13.record(z13.string(), z13.unknown()).optional().describe("Contact properties from the server for Liquid substitution"),
+    sourceTrackingFieldValues: z13.record(z13.string(), z13.string()).optional().describe("Source tracking field values captured at survey load time")
+  }).optional().describe("User responses to the form questions"),
+  visitedQuestionIds: z13.array(z13.string()).optional().describe("Ordered list of question IDs the respondent actually navigated to"),
+  context: z13.record(z13.string(), z13.union([z13.string(), z13.number(), z13.boolean()])).optional().describe("Caller-provided metadata attached to this submission")
+}).describe("Form details for an SDK-style submit-form request");
+var submitFormRequestSchema = z13.object({
+  triggerType: z13.enum(["automatic", "manual"]).optional().describe("Whether the form was triggered automatically or manually"),
+  formDetails: formDetailsSchema.describe("Core submission payload"),
+  $deviceInfo: z13.record(z13.string(), z13.unknown()).optional().describe("Device and SDK metadata automatically injected by the SDK")
+}).describe("Complete submit-form request envelope (SDK-facing contract)");
 
 // src/schemas/api/fetch-feedback-schema.ts
 import { z as z14 } from "zod";
@@ -2749,6 +2771,7 @@ export {
   focalPointSchema,
   formConfigSchema,
   formConfigurationResponseSchema,
+  formDetailsSchema,
   formPropertiesSchema,
   gradientAttachmentSchema,
   imageAttachmentSchema,
@@ -2840,6 +2863,7 @@ export {
   splitLayoutSchema,
   stackLayoutSchema,
   submitFeedbackSchema,
+  submitFormRequestSchema,
   thankYouQuestionSchema,
   thankYouQuestionTranslationSchema,
   themeColorsSchema,