@23blocks/block-forms 3.1.4 → 3.1.6

package/dist/index.esm.js

@@ -68,7 +68,7 @@ const formMapper = {
     type: 'Form',
     map: (resource)=>({
             id: resource.id,
-            uniqueId: parseString(resource.attributes['unique_id']) || resource.id,
+            uniqueId: parseString(resource.attributes['unique_id']),
             createdAt: parseDate(resource.attributes['created_at']) || new Date(),
             updatedAt: parseDate(resource.attributes['updated_at']) || new Date(),
             code: parseString(resource.attributes['code']) || '',
@@ -135,7 +135,7 @@ const formSchemaMapper = {
     type: 'FormSchema',
     map: (resource)=>({
             id: resource.id,
-            uniqueId: parseString(resource.attributes['unique_id']) || resource.id,
+            uniqueId: parseString(resource.attributes['unique_id']),
             createdAt: parseDate(resource.attributes['created_at']) || new Date(),
             updatedAt: parseDate(resource.attributes['updated_at']) || new Date(),
             formUniqueId: parseString(resource.attributes['form_unique_id']) || '',
@@ -208,7 +208,7 @@ const formSchemaVersionMapper = {
     type: 'FormSchemaVersion',
     map: (resource)=>({
             id: resource.id,
-            uniqueId: parseString(resource.attributes['unique_id']) || resource.id,
+            uniqueId: parseString(resource.attributes['unique_id']),
             createdAt: parseDate(resource.attributes['created_at']) || new Date(),
             updatedAt: parseDate(resource.attributes['updated_at']) || new Date(),
             formUniqueId: parseString(resource.attributes['form_unique_id']) || '',
@@ -276,7 +276,7 @@ const formInstanceMapper = {
     type: 'FormInstance',
     map: (resource)=>({
             id: resource.id,
-            uniqueId: parseString(resource.attributes['unique_id']) || resource.id,
+            uniqueId: parseString(resource.attributes['unique_id']),
             createdAt: parseDate(resource.attributes['created_at']) || new Date(),
             updatedAt: parseDate(resource.attributes['updated_at']) || new Date(),
             formSchemaUniqueId: parseString(resource.attributes['form_schema_unique_id']) || '',
@@ -358,7 +358,7 @@ const formSetMapper = {
     type: 'FormSet',
     map: (resource)=>({
             id: resource.id,
-            uniqueId: parseString(resource.attributes['unique_id']) || resource.id,
+            uniqueId: parseString(resource.attributes['unique_id']),
             createdAt: parseDate(resource.attributes['created_at']) || new Date(),
             updatedAt: parseDate(resource.attributes['updated_at']) || new Date(),
             code: parseString(resource.attributes['code']) || '',
@@ -981,6 +981,15 @@ function createMailTemplatesService(transport, _config) {
     };
 }
 
+/**
+ * Parse verification status from API response
+ */ function parseVerificationStatus(value) {
+    const status = parseString(value);
+    if (status === 'pending' || status === 'verified') {
+        return status;
+    }
+    return undefined;
+}
 const applicationFormMapper = {
     type: 'public_form',
     map: (resource)=>{
@@ -996,10 +1005,27 @@ const applicationFormMapper = {
             status: parseStatus(resource.attributes['status']),
             payload: resource.attributes['payload'],
             createdAt: parseDate(resource.attributes['created_at']),
-            updatedAt: parseDate(resource.attributes['updated_at'])
+            updatedAt: parseDate(resource.attributes['updated_at']),
+            // OTP Verification fields
+            verificationStatus: parseVerificationStatus(resource.attributes['verification_status']),
+            assignedToName: parseString(resource.attributes['assigned_to_name']),
+            maskedEmail: parseString(resource.attributes['masked_email']),
+            otpSent: resource.attributes['otp_sent'] !== undefined ? parseBoolean(resource.attributes['otp_sent']) : undefined,
+            formName: parseString(resource.attributes['form_name'])
         };
     }
 };
+/**
+ * Map send-otp response (non-JSON:API format)
+ */ function mapSendOtpResponse(response) {
+    var _parseString, _parseString1;
+    return {
+        message: (_parseString = parseString(response['message'])) != null ? _parseString : '',
+        maskedEmail: (_parseString1 = parseString(response['masked_email'])) != null ? _parseString1 : '',
+        expiresIn: parseNumber(response['expires_in']),
+        sentCount: parseNumber(response['sent_count'])
+    };
+}
 const applicationFormResponseMapper = {
     type: 'form_response',
     map: (resource)=>{
@@ -1040,6 +1066,16 @@ function createApplicationFormsService(transport, _config) {
                 }
             });
             return decodeOne(response, applicationFormResponseMapper);
+        },
+        async sendOtp (urlId) {
+            const response = await transport.post(`/${urlId}/forms/public/send-otp`, {});
+            return mapSendOtpResponse(response);
+        },
+        async verifyOtp (urlId, data) {
+            const response = await transport.post(`/${urlId}/forms/public/verify-otp`, {
+                code: data.code
+            });
+            return decodeOne(response, applicationFormMapper);
         }
     };
 }
@@ -1161,4 +1197,4 @@ const formsBlockMetadata = {
     ]
 };
 
-export { applicationFormMapper, appointmentMapper, createApplicationFormsService, createAppointmentsService, createCrmSyncService, createFormInstancesService, createFormSchemaVersionsService, createFormSchemasService, createFormSetsService, createFormsBlock, createFormsService, createLandingsService, createMailTemplatesService, createReferralsService, createSubscriptionsService, createSurveysService, formInstanceMapper, formMapper, formSchemaMapper, formSchemaVersionMapper, formSetMapper, formsBlockMetadata, landingMapper, mailTemplateMapper, referralMapper, subscriptionMapper, surveyMapper };
+export { applicationFormMapper, appointmentMapper, createApplicationFormsService, createAppointmentsService, createCrmSyncService, createFormInstancesService, createFormSchemaVersionsService, createFormSchemasService, createFormSetsService, createFormsBlock, createFormsService, createLandingsService, createMailTemplatesService, createReferralsService, createSubscriptionsService, createSurveysService, formInstanceMapper, formMapper, formSchemaMapper, formSchemaVersionMapper, formSetMapper, formsBlockMetadata, landingMapper, mailTemplateMapper, mapSendOtpResponse, referralMapper, subscriptionMapper, surveyMapper };

package/dist/src/index.d.ts

@@ -11,9 +11,9 @@ export type { Appointment, CreateAppointmentRequest, UpdateAppointmentRequest, L
 export type { Survey, SurveyStatus, CreateSurveyRequest, UpdateSurveyRequest, UpdateSurveyStatusRequest, ListSurveysParams, } from './lib/types/survey';
 export type { Referral, CreateReferralRequest, UpdateReferralRequest, ListReferralsParams, } from './lib/types/referral';
 export type { MailTemplate, CreateMailTemplateRequest, UpdateMailTemplateRequest, ListMailTemplatesParams, } from './lib/types/mail-template';
-export type { ApplicationForm, ApplicationFormSubmission, ApplicationFormDraft, ApplicationFormResponse, } from './lib/types/application-form';
+export type { ApplicationForm, ApplicationFormSubmission, ApplicationFormDraft, ApplicationFormResponse, VerificationStatus, SendOtpResponse, VerifyOtpRequest, OtpErrorCode, OtpError, } from './lib/types/application-form';
 export type { CrmSyncResult, CrmSyncBatchRequest, CrmSyncBatchResult, CrmConnectionStatus, CrmSyncStatus, } from './lib/types/crm-sync';
 export type { FormsService, FormSchemasService, FormSchemaVersionsService, FormInstancesService, FormSetsService, LandingsService, SubscriptionsService, AppointmentsService, SurveysService, ReferralsService, MailTemplatesService, ApplicationFormsService, CrmSyncService, } from './lib/services';
 export { createFormsService, createFormSchemasService, createFormSchemaVersionsService, createFormInstancesService, createFormSetsService, createLandingsService, createSubscriptionsService, createAppointmentsService, createSurveysService, createReferralsService, createMailTemplatesService, createApplicationFormsService, createCrmSyncService, } from './lib/services';
-export { formMapper, formSchemaMapper, formSchemaVersionMapper, formInstanceMapper, formSetMapper, landingMapper, subscriptionMapper, appointmentMapper, surveyMapper, referralMapper, mailTemplateMapper, applicationFormMapper, } from './lib/mappers';
+export { formMapper, formSchemaMapper, formSchemaVersionMapper, formInstanceMapper, formSetMapper, landingMapper, subscriptionMapper, appointmentMapper, surveyMapper, referralMapper, mailTemplateMapper, applicationFormMapper, mapSendOtpResponse, } from './lib/mappers';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOtE,YAAY,EACV,IAAI,EACJ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,+BAA+B,EAC/B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOtE,YAAY,EACV,IAAI,EACJ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EAEvB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,+BAA+B,EAC/B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,EAC1B,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,eAAe,CAAC"}

package/dist/src/lib/mappers/application-form.mapper.d.ts

@@ -1,5 +1,9 @@
 import type { ResourceMapper } from '@23blocks/jsonapi-codec';
-import type { ApplicationForm, ApplicationFormResponse } from '../types/application-form';
+import type { ApplicationForm, ApplicationFormResponse, SendOtpResponse } from '../types/application-form';
 export declare const applicationFormMapper: ResourceMapper<ApplicationForm>;
+/**
+ * Map send-otp response (non-JSON:API format)
+ */
+export declare function mapSendOtpResponse(response: Record<string, unknown>): SendOtpResponse;
 export declare const applicationFormResponseMapper: ResourceMapper<ApplicationFormResponse>;
 //# sourceMappingURL=application-form.mapper.d.ts.map

package/dist/src/lib/mappers/application-form.mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-form.mapper.d.ts","sourceRoot":"","sources":["../../../../src/lib/mappers/application-form.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAG1F,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAejE,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,cAAc,CAAC,uBAAuB,CAYjF,CAAC"}
+{"version":3,"file":"application-form.mapper.d.ts","sourceRoot":"","sources":["../../../../src/lib/mappers/application-form.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAsB,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAc/H,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,eAAe,CAuBjE,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAOrF;AAED,eAAO,MAAM,6BAA6B,EAAE,cAAc,CAAC,uBAAuB,CAYjF,CAAC"}

package/dist/src/lib/mappers/index.d.ts

@@ -9,6 +9,6 @@ export * from './appointment.mapper';
 export * from './survey.mapper';
 export * from './referral.mapper';
 export * from './mail-template.mapper';
-export * from './application-form.mapper';
+export { applicationFormMapper, applicationFormResponseMapper, mapSendOtpResponse } from './application-form.mapper';
 export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/lib/mappers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/mappers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/mappers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACrH,cAAc,SAAS,CAAC"}

package/dist/src/lib/services/application-forms.service.d.ts

@@ -1,9 +1,37 @@
 import type { Transport } from '@23blocks/contracts';
-import type { ApplicationForm, ApplicationFormSubmission, ApplicationFormDraft, ApplicationFormResponse } from '../types/application-form';
+import type { ApplicationForm, ApplicationFormSubmission, ApplicationFormDraft, ApplicationFormResponse, SendOtpResponse, VerifyOtpRequest } from '../types/application-form';
 export interface ApplicationFormsService {
+    /**
+     * Get public form via magic link
+     * If OTP verification is required, returns form with verificationStatus: 'pending'
+     * and limited fields (no schema/uiSchema until verified)
+     */
     get(urlId: string): Promise<ApplicationForm>;
+    /**
+     * Submit a completed form
+     * Requires OTP verification if form has OTP enabled
+     */
     submit(urlId: string, data: ApplicationFormSubmission): Promise<ApplicationFormResponse>;
+    /**
+     * Save form as draft
+     * Requires OTP verification if form has OTP enabled
+     */
     draft(urlId: string, data: ApplicationFormDraft): Promise<ApplicationFormResponse>;
+    /**
+     * Send OTP verification code to user's email
+     * @throws Error with code RATE_LIMITED if called too frequently (60s cooldown)
+     * @throws Error with code ALREADY_VERIFIED if form is already verified
+     * @throws Error with code OTP_NOT_REQUIRED if form doesn't require OTP
+     */
+    sendOtp(urlId: string): Promise<SendOtpResponse>;
+    /**
+     * Verify OTP code and get full form access
+     * On success, returns full form with schema and fields
+     * @throws Error with code INVALID_CODE if code is wrong (includes attemptsRemaining)
+     * @throws Error with code CODE_EXPIRED if code has expired (10 min lifetime)
+     * @throws Error with code ATTEMPTS_EXCEEDED if max attempts (5) reached
+     */
+    verifyOtp(urlId: string, data: VerifyOtpRequest): Promise<ApplicationForm>;
 }
 export declare function createApplicationFormsService(transport: Transport, _config: {
     appId: string;

package/dist/src/lib/services/application-forms.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-forms.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/application-forms.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACpF;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CA2BvH"}
+{"version":3,"file":"application-forms.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/services/application-forms.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7C;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEzF;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEnF;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5E;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,uBAAuB,CAuCvH"}

package/dist/src/lib/types/application-form.d.ts

@@ -1,4 +1,12 @@
 import type { IdentityCore, EntityStatus } from '@23blocks/contracts';
+/**
+ * Verification status for OTP-protected forms
+ */
+export type VerificationStatus = 'pending' | 'verified';
+/**
+ * Application form retrieved via magic link (public access)
+ * When OTP verification is required but not completed, only verification-related fields are populated.
+ */
 export interface ApplicationForm extends IdentityCore {
     formUniqueId: string;
     title?: string;
@@ -8,6 +16,16 @@ export interface ApplicationForm extends IdentityCore {
     settings?: Record<string, unknown>;
     status: EntityStatus;
     payload?: Record<string, unknown>;
+    /** Current verification status - 'pending' requires OTP, 'verified' means full access */
+    verificationStatus?: VerificationStatus;
+    /** Name of the user assigned to fill the form (visible even when pending) */
+    assignedToName?: string;
+    /** Masked email address for display (e.g., "j***e@e***e.com") */
+    maskedEmail?: string;
+    /** Whether an OTP has already been sent */
+    otpSent?: boolean;
+    /** Form name for display during verification */
+    formName?: string;
 }
 export interface ApplicationFormSubmission {
     data: Record<string, unknown>;
@@ -24,4 +42,34 @@ export interface ApplicationFormResponse extends IdentityCore {
     submittedAt?: Date;
     payload?: Record<string, unknown>;
 }
+/**
+ * Response from sending an OTP code
+ */
+export interface SendOtpResponse {
+    message: string;
+    maskedEmail: string;
+    expiresIn: number;
+    sentCount: number;
+}
+/**
+ * Request to verify an OTP code
+ */
+export interface VerifyOtpRequest {
+    code: string;
+}
+/**
+ * OTP error codes returned by the API
+ */
+export type OtpErrorCode = 'OTP_NOT_REQUIRED' | 'ALREADY_VERIFIED' | 'RATE_LIMITED' | 'CODE_REQUIRED' | 'INVALID_CODE' | 'CODE_EXPIRED' | 'ATTEMPTS_EXCEEDED' | 'OTP_REQUIRED';
+/**
+ * Extended error information for OTP operations
+ */
+export interface OtpError {
+    code: OtpErrorCode;
+    message: string;
+    /** Seconds to wait before retrying (for RATE_LIMITED errors) */
+    retryAfter?: number;
+    /** Remaining verification attempts (for INVALID_CODE errors) */
+    attemptsRemaining?: number;
+}
 //# sourceMappingURL=application-form.d.ts.map

package/dist/src/lib/types/application-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-form.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/application-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"application-form.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/application-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,cAAc,GACd,cAAc,GACd,mBAAmB,GACnB,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@23blocks/block-forms",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "description": "Forms block for 23blocks SDK - dynamic forms, schemas, submissions, and form management",
   "license": "MIT",
   "author": "23blocks <hello@23blocks.com>",