@form-engine-ts/core 2.8.0 → 2.9.0

package/README.md

@@ -104,4 +104,9 @@ may push supported nodes to their native query language while preserving identic
 implement `listTextAnswerPage` expose stable cursor pagination over individual text answers.
 `TextAnswerPageQueryOptions.fieldIds` can select multiple free-text fields for item-level paging.
 
+`iterateSubmissionPages(adapter, formId, query, options)` safely traverses every page as an async generator. It supports
+`pageSize`, `maxItems`, and `AbortSignal`, continues through empty pages with a next cursor, and rejects missing or cyclic
+cursors instead of looping indefinitely. Publish transition validation also rejects mismatched form IDs, non-Published
+records, and an unexpected current record with typed errors.
+
 See the [project documentation](https://github.com/nitta-a/form-engine-ts#readme) for the complete schema and API guide.

package/dist/index.cjs

@@ -46,6 +46,7 @@ __export(index_exports, {
   exportResponsesToCsvStream: () => exportResponsesToCsvStream,
   isDisplayConditionSatisfied: () => isDisplayConditionSatisfied,
   isQuestionVisible: () => isQuestionVisible,
+  iterateSubmissionPages: () => iterateSubmissionPages,
   jsonValuesEqual: () => jsonValuesEqual,
   matchesSubmissionFilter: () => matchesSubmissionFilter,
   matchesSubmissionPageFilters: () => matchesSubmissionPageFilters,
@@ -1523,6 +1524,54 @@ function transformFieldType(field, nextType) {
 }
 
 // src/pagination.ts
+function asFormResponse2(submission) {
+  return {
+    responseId: submission.id,
+    formId: submission.formId,
+    formVersion: submission.formVersion,
+    sourceLocale: submission.locale,
+    answers: submission.values,
+    submittedAt: submission.submittedAt,
+    ...submission.metadata === void 0 ? {} : { metadata: submission.metadata }
+  };
+}
+async function* iterateSubmissionPages(adapter, formId, queryOptions = {}, options = {}) {
+  const pageSize = normalizeSubmissionPageSize(options.pageSize ?? queryOptions.pageSize);
+  const maxItems = options.maxItems ?? Number.POSITIVE_INFINITY;
+  if (maxItems !== Number.POSITIVE_INFINITY && (!Number.isSafeInteger(maxItems) || maxItems < 0)) {
+    throw new TypeError("maxItems must be a non-negative safe integer.");
+  }
+  if (maxItems === 0) return;
+  const seenCursors = /* @__PURE__ */ new Set();
+  let cursor = queryOptions.cursor;
+  const { cursor: _initialCursor, pageSize: _initialPageSize, ...baseQueryOptions } = queryOptions;
+  if (cursor !== void 0) seenCursors.add(cursor);
+  let emitted = 0;
+  while (emitted < maxItems) {
+    options.signal?.throwIfAborted();
+    const remaining = maxItems - emitted;
+    const requestedPageSize = Number.isFinite(remaining) ? Math.min(pageSize, remaining) : pageSize;
+    const page = await adapter.listSubmissionPage(formId, {
+      ...baseQueryOptions,
+      pageSize: requestedPageSize,
+      ...cursor === void 0 ? {} : { cursor }
+    });
+    options.signal?.throwIfAborted();
+    const available = Number.isFinite(remaining) ? page.items.slice(0, remaining) : page.items;
+    if (available.length > 0) {
+      emitted += available.length;
+      yield available.map(asFormResponse2);
+    }
+    if (!page.hasMore || emitted >= maxItems) return;
+    const nextCursor = page.nextCursor;
+    if (nextCursor === void 0 || nextCursor.length === 0) {
+      throw new Error("Submission pagination returned hasMore without a next cursor.");
+    }
+    if (seenCursors.has(nextCursor)) throw new Error(`Submission pagination cursor cycle detected: ${nextCursor}`);
+    seenCursors.add(nextCursor);
+    cursor = nextCursor;
+  }
+}
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function encodeBase64(bytes) {
   let result = "";
@@ -2203,14 +2252,23 @@ function createCloneTransitionPlan(state, sourceRecord, options = {}) {
   };
 }
 function validatePublishedRecord(state, record) {
-  if (state.publishedVersion !== void 0 && record?.version !== state.publishedVersion) {
+  if (state.publishedVersion === void 0) {
+    return record === void 0 ? void 0 : { success: false, error: { type: "unexpected_published_record" } };
+  }
+  if (record !== void 0 && record.formId !== state.formId) {
+    return { success: false, error: { type: "form_id_mismatch" } };
+  }
+  if (record !== void 0 && record.status !== "published") {
+    return { success: false, error: { type: "invalid_published_status" } };
+  }
+  if (record?.version !== state.publishedVersion) {
     return {
       success: false,
       error: { type: "missing_published_record", expectedVersion: state.publishedVersion }
     };
   }
   if (record === void 0) return void 0;
-  if (record.formId !== state.formId || record.status !== "published" || record.schema.id !== record.formId || record.schema.version !== record.version) {
+  if (record.schema.id !== record.formId || record.schema.version !== record.version) {
     throw new TypeError("currentPublishedRecord must match the state's published version.");
   }
   return void 0;
@@ -2386,6 +2444,7 @@ function assertVersionMutable(status) {
   exportResponsesToCsvStream,
   isDisplayConditionSatisfied,
   isQuestionVisible,
+  iterateSubmissionPages,
   jsonValuesEqual,
   matchesSubmissionFilter,
   matchesSubmissionPageFilters,

package/dist/index.d.cts

@@ -40,6 +40,12 @@ type VersionTransitionError = {
 } | {
     readonly type: "missing_published_record";
     readonly expectedVersion: number;
+} | {
+    readonly type: "form_id_mismatch";
+} | {
+    readonly type: "invalid_published_status";
+} | {
+    readonly type: "unexpected_published_record";
 } | {
     readonly type: "revision_conflict";
     readonly expectedRevision: number;
@@ -354,6 +360,8 @@ type StorageCommitError = {
 } | {
     readonly type: "draft_already_exists";
     readonly currentDraftVersion: number;
+} | {
+    readonly type: "transaction_unsupported";
 } | {
     readonly type: "invalid_transition";
     readonly message: string;
@@ -523,6 +531,12 @@ declare function dispatchWebhook<T>(event: FormEvent<T>, config: WebhookConfig,
  */
 declare function transformFieldType(field: FormField, nextType: QuestionType): FormField;
 
+interface PaginationIteratorOptions {
+    readonly pageSize?: number;
+    readonly maxItems?: number;
+    readonly signal?: AbortSignal;
+}
+declare function iterateSubmissionPages(adapter: PagedSubmissionStorageAdapter, formId: string, queryOptions?: SubmissionPageQueryOptions, options?: PaginationIteratorOptions): AsyncIterable<readonly FormResponse[]>;
 interface SubmissionCursorValue {
     readonly submittedAt: string;
     readonly responseId: string;
@@ -613,4 +627,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.d.ts

@@ -40,6 +40,12 @@ type VersionTransitionError = {
 } | {
     readonly type: "missing_published_record";
     readonly expectedVersion: number;
+} | {
+    readonly type: "form_id_mismatch";
+} | {
+    readonly type: "invalid_published_status";
+} | {
+    readonly type: "unexpected_published_record";
 } | {
     readonly type: "revision_conflict";
     readonly expectedRevision: number;
@@ -354,6 +360,8 @@ type StorageCommitError = {
 } | {
     readonly type: "draft_already_exists";
     readonly currentDraftVersion: number;
+} | {
+    readonly type: "transaction_unsupported";
 } | {
     readonly type: "invalid_transition";
     readonly message: string;
@@ -523,6 +531,12 @@ declare function dispatchWebhook<T>(event: FormEvent<T>, config: WebhookConfig,
  */
 declare function transformFieldType(field: FormField, nextType: QuestionType): FormField;
 
+interface PaginationIteratorOptions {
+    readonly pageSize?: number;
+    readonly maxItems?: number;
+    readonly signal?: AbortSignal;
+}
+declare function iterateSubmissionPages(adapter: PagedSubmissionStorageAdapter, formId: string, queryOptions?: SubmissionPageQueryOptions, options?: PaginationIteratorOptions): AsyncIterable<readonly FormResponse[]>;
 interface SubmissionCursorValue {
     readonly submittedAt: string;
     readonly responseId: string;
@@ -613,4 +627,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, type DeleteDraftOptions, type DisplayCondition, type ExtensibleNode, type FieldOption, type FieldType, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.js

@@ -1456,6 +1456,54 @@ function transformFieldType(field, nextType) {
 }
 
 // src/pagination.ts
+function asFormResponse2(submission) {
+  return {
+    responseId: submission.id,
+    formId: submission.formId,
+    formVersion: submission.formVersion,
+    sourceLocale: submission.locale,
+    answers: submission.values,
+    submittedAt: submission.submittedAt,
+    ...submission.metadata === void 0 ? {} : { metadata: submission.metadata }
+  };
+}
+async function* iterateSubmissionPages(adapter, formId, queryOptions = {}, options = {}) {
+  const pageSize = normalizeSubmissionPageSize(options.pageSize ?? queryOptions.pageSize);
+  const maxItems = options.maxItems ?? Number.POSITIVE_INFINITY;
+  if (maxItems !== Number.POSITIVE_INFINITY && (!Number.isSafeInteger(maxItems) || maxItems < 0)) {
+    throw new TypeError("maxItems must be a non-negative safe integer.");
+  }
+  if (maxItems === 0) return;
+  const seenCursors = /* @__PURE__ */ new Set();
+  let cursor = queryOptions.cursor;
+  const { cursor: _initialCursor, pageSize: _initialPageSize, ...baseQueryOptions } = queryOptions;
+  if (cursor !== void 0) seenCursors.add(cursor);
+  let emitted = 0;
+  while (emitted < maxItems) {
+    options.signal?.throwIfAborted();
+    const remaining = maxItems - emitted;
+    const requestedPageSize = Number.isFinite(remaining) ? Math.min(pageSize, remaining) : pageSize;
+    const page = await adapter.listSubmissionPage(formId, {
+      ...baseQueryOptions,
+      pageSize: requestedPageSize,
+      ...cursor === void 0 ? {} : { cursor }
+    });
+    options.signal?.throwIfAborted();
+    const available = Number.isFinite(remaining) ? page.items.slice(0, remaining) : page.items;
+    if (available.length > 0) {
+      emitted += available.length;
+      yield available.map(asFormResponse2);
+    }
+    if (!page.hasMore || emitted >= maxItems) return;
+    const nextCursor = page.nextCursor;
+    if (nextCursor === void 0 || nextCursor.length === 0) {
+      throw new Error("Submission pagination returned hasMore without a next cursor.");
+    }
+    if (seenCursors.has(nextCursor)) throw new Error(`Submission pagination cursor cycle detected: ${nextCursor}`);
+    seenCursors.add(nextCursor);
+    cursor = nextCursor;
+  }
+}
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function encodeBase64(bytes) {
   let result = "";
@@ -2136,14 +2184,23 @@ function createCloneTransitionPlan(state, sourceRecord, options = {}) {
   };
 }
 function validatePublishedRecord(state, record) {
-  if (state.publishedVersion !== void 0 && record?.version !== state.publishedVersion) {
+  if (state.publishedVersion === void 0) {
+    return record === void 0 ? void 0 : { success: false, error: { type: "unexpected_published_record" } };
+  }
+  if (record !== void 0 && record.formId !== state.formId) {
+    return { success: false, error: { type: "form_id_mismatch" } };
+  }
+  if (record !== void 0 && record.status !== "published") {
+    return { success: false, error: { type: "invalid_published_status" } };
+  }
+  if (record?.version !== state.publishedVersion) {
     return {
       success: false,
       error: { type: "missing_published_record", expectedVersion: state.publishedVersion }
     };
   }
   if (record === void 0) return void 0;
-  if (record.formId !== state.formId || record.status !== "published" || record.schema.id !== record.formId || record.schema.version !== record.version) {
+  if (record.schema.id !== record.formId || record.schema.version !== record.version) {
     throw new TypeError("currentPublishedRecord must match the state's published version.");
   }
   return void 0;
@@ -2318,6 +2375,7 @@ export {
   exportResponsesToCsvStream,
   isDisplayConditionSatisfied,
   isQuestionVisible,
+  iterateSubmissionPages,
   jsonValuesEqual,
   matchesSubmissionFilter,
   matchesSubmissionPageFilters,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/core",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "publishConfig": {
     "access": "public"
   },