@flusys/nestjs-form-builder 7.1.0 → 8.0.0

package/fesm/index.js

@@ -1,20 +1,492 @@
+export const __rspack_esm_id = 410;
+export const __rspack_esm_ids = [410];
+export const __webpack_modules__ = {
+511(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+/* import */ var _event_actions_js__rspack_import_0 = __webpack_require__(769);
+/* import */ var _form_builder_constants_js__rspack_import_1 = __webpack_require__(512);
+/* import */ var _message_keys_js__rspack_import_2 = __webpack_require__(137);
+
+
+
+
+__webpack_require__.d(__webpack_exports__, {
+  Ql: () => (/* reexport safe */ _message_keys_js__rspack_import_2.Q),
+  T$: () => (/* reexport safe */ _event_actions_js__rspack_import_0.T$),
+  eF: () => (/* reexport safe */ _event_actions_js__rspack_import_0.eF),
+  ov: () => (/* reexport safe */ _event_actions_js__rspack_import_0.ov),
+  vx: () => (/* reexport safe */ _form_builder_constants_js__rspack_import_1.v),
+  yF: () => (/* reexport safe */ _message_keys_js__rspack_import_2.y)
+});
+
+
+},
+625(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  a: () => (/* reexport */ formBuilderSwaggerConfig)
+});
+
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/docs/form-builder-swagger.config.ts
+/** Schema properties to exclude when company feature is disabled */ const COMPANY_SCHEMA_EXCLUSIONS = [
+    {
+        schemaName: 'CreateFormDto',
+        properties: [
+            'companyId'
+        ]
+    },
+    {
+        schemaName: 'UpdateFormDto',
+        properties: [
+            'companyId'
+        ]
+    },
+    {
+        schemaName: 'FormQueryDto',
+        properties: [
+            'companyId'
+        ]
+    },
+    {
+        schemaName: 'FormResponseDto',
+        properties: [
+            'companyId'
+        ]
+    }
+];
+/**
+ * Form Builder Module Swagger Configuration
+ * Use this with setupSwaggerDocs() from @flusys/nestjs-core
+ *
+ * @param bootstrapConfig - Bootstrap configuration to determine feature visibility
+ * @returns Swagger configuration with appropriate excludeSchemaProperties based on enableCompanyFeature
+ */ function formBuilderSwaggerConfig(bootstrapConfig) {
+    const enableCompanyFeature = bootstrapConfig?.enableCompanyFeature ?? true;
+    const isMultiTenant = bootstrapConfig?.databaseMode === 'multi-tenant';
+    const multiTenantNote = isMultiTenant ? `\n> **Multi-Tenant Mode**: Include \`x-tenant-id\` header to target a specific tenant database.\n` : '';
+    return {
+        title: 'Form Builder API',
+        description: `
+# Form Builder API
+${multiTenantNote}
+
+Dynamic form builder with schema versioning, conditional logic, and access control.
+
+## Features
+
+### 📋 Form Management
+- Create and manage dynamic forms
+- Schema versioning for form updates
+- Slug-based URLs for sharing${enableCompanyFeature ? '\n- **Company isolation**' : ''}
+
+### 🔒 Access Control
+- **Public**: No authentication required
+- **Authenticated**: JWT authentication required
+- **Action Group**: Permission-based access via IAM
+
+### 📊 Form Results
+- Submit and track form responses
+- Draft support for partial submissions
+- Schema snapshot preservation${enableCompanyFeature ? '\n- **Company-level permissions**' : ''}
+
+### 🔀 Conditional Logic
+- Show/hide fields based on values
+- Show/hide sections dynamically
+- Jump to sections based on conditions
+- Conditional required validation
+${enableCompanyFeature ? `
+## Multi-Tenant Support
+
+Forms and results are automatically isolated by:
+- **Company ID**: Company-level data isolation
+
+All queries automatically filter by current user's company context.
+` : ''}
+## Form Access Types
+
+### Public Forms
+- No authentication required
+- Anyone can view and submit
+- Use \`/form-builder/form/public/:id\` to get form
+- Use \`/form-builder/result/submit-public\` to submit
+
+### Authenticated Forms
+- JWT authentication required
+- User must be logged in
+- Use \`/form-builder/form/authenticated/:id\` to get form
+- Use \`/form-builder/result/submit\` to submit
+
+### Action Group Forms
+- Permission-based access via IAM
+- User must have specific permissions
+- Use \`/form-builder/form/authenticated/:id\` to get form
+- Use \`/form-builder/result/submit\` to submit
+
+## Draft Support
+
+Save form progress and complete later:
+1. Submit with \`isDraft: true\` to save draft
+2. Get draft with \`/form-builder/result/my-draft\`
+3. Update draft with \`/form-builder/result/update-draft\`
+4. Finalize by setting \`isDraft: false\`
+
+## Response Format
+
+All endpoints return standardized responses with success status, data, message, and timestamp.
+
+## Error Handling
+
+Errors return structured responses with success false, error message, error code, and timestamp.
+
+## Common Error Codes
+
+- **400 Bad Request**: Invalid input data
+- **401 Unauthorized**: Missing or invalid authentication
+- **403 Forbidden**: Insufficient permissions or wrong access type
+- **404 Not Found**: Form or result not found
+- **500 Internal Server Error**: Server error
+
+## API Endpoints
+
+All form builder endpoints are prefixed with \`/form-builder\`:
+- \`/form-builder/form/*\` - Form management
+- \`/form-builder/result/*\` - Form result/submission management
+
+## Examples
+
+### Get Form Access Info
+
+POST /form-builder/form/access-info/:id
+Returns access type and requirements (no auth required)
+
+### Submit Public Form
+
+POST /form-builder/result/submit-public with JSON body containing formId and formData
+
+### Submit Authenticated Form
+
+POST /form-builder/result/submit with JWT token and JSON body containing formId and formData
+    `,
+        version: '1.0',
+        path: 'api/docs/form-builder',
+        bearerAuth: true,
+        excludeTags: [],
+        excludeSchemaProperties: enableCompanyFeature ? undefined : COMPANY_SCHEMA_EXCLUSIONS
+    };
+}
+
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/docs/index.ts
+
+
+
+},
+817(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+/* import */ var _form_access_type_enum_js__rspack_import_0 = __webpack_require__(376);
+
+
+__webpack_require__.d(__webpack_exports__, {
+  h: () => (/* reexport safe */ _form_access_type_enum_js__rspack_import_0.h)
+});
+
+
+},
+851(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  YD: () => (/* reexport */ dtos/* .CreateFormDto */.YD),
+  pZ: () => (/* reexport */ dtos/* .CreateFormResultDto */.pZ),
+  ov: () => (/* reexport */ config/* .FORM_BUILDER_EVENT_ACTIONS */.ov),
+  eF: () => (/* reexport */ config/* .FORM_BUILDER_EVENT_ENTITIES */.eF),
+  T$: () => (/* reexport */ config/* .FORM_BUILDER_EVENT_MODULE */.T$),
+  vx: () => (/* reexport */ config/* .FORM_BUILDER_MODULE_OPTIONS */.vx),
+  Ql: () => (/* reexport */ config/* .FORM_MESSAGES */.Ql),
+  yF: () => (/* reexport */ config/* .FORM_RESULT_MESSAGES */.yF),
+  lV: () => (/* reexport */ entities/* .Form */.lV),
+  Xe: () => (/* reexport */ dtos/* .FormAccessInfoResponseDto */.Xe),
+  hi: () => (/* reexport */ enums/* .FormAccessType */.h),
+  C7: () => (/* reexport */ entities/* .FormBase */.C7),
+  jS: () => (/* reexport */ services/* .FormBuilderConfigService */.jS),
+  _Z: () => (/* reexport */ services/* .FormBuilderDataSourceProvider */._Z),
+  S7: () => (/* reexport */ modules/* .FormBuilderModule */.S),
+  Xl: () => (/* reexport */ entities/* .FormCompanyEntities */.Xl),
+  Xq: () => (/* reexport */ controllers/* .FormController */.X),
+  t$: () => (/* reexport */ entities/* .FormCoreEntities */.t$),
+  bV: () => (/* reexport */ dtos/* .FormResponseDto */.bV),
+  ez: () => (/* reexport */ entities/* .FormResult */.ez),
+  Ye: () => (/* reexport */ controllers/* .FormResultController */.Y),
+  _$: () => (/* reexport */ dtos/* .FormResultResponseDto */._$),
+  vF: () => (/* reexport */ services/* .FormResultService */.vF),
+  ux: () => (/* reexport */ services/* .FormService */.ux),
+  Wl: () => (/* reexport */ entities/* .FormWithCompany */.Wl),
+  D5: () => (/* reexport */ dtos/* .GetMyDraftDto */.D5),
+  rp: () => (/* reexport */ dtos/* .GetResultsByFormDto */.rp),
+  M4: () => (/* reexport */ dtos/* .PublicFormResponseDto */.M4),
+  sH: () => (/* reexport */ dtos/* .SubmitFormDto */.sH),
+  CQ: () => (/* reexport */ dtos/* .UpdateDraftDto */.CQ),
+  jQ: () => (/* reexport */ dtos/* .UpdateFormDto */.jQ),
+  Uj: () => (/* reexport */ dtos/* .UpdateFormResultDto */.Uj),
+  XZ: () => (/* reexport */ computed_field_utils/* .calculateComputedFields */.X),
+  aY: () => (/* reexport */ docs/* .formBuilderSwaggerConfig */.a),
+  iO: () => (/* reexport */ entities.getFormBuilderEntitiesByConfig),
+  io: () => (/* reexport */ permission_utils/* .validateUserPermissions */.i)
+});
+
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/config/index.ts
+var config = __webpack_require__(511);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/docs/index.ts + 1 modules
+var docs = __webpack_require__(625);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/controllers/index.ts + 3 modules
+var controllers = __webpack_require__(585);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/dtos/index.ts + 1 modules
+var dtos = __webpack_require__(998);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/entities/index.ts + 5 modules
+var entities = __webpack_require__(532);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/enums/index.ts
+var enums = __webpack_require__(817);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/modules/index.ts + 1 modules
+var modules = __webpack_require__(106);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/services/index.ts
+var services = __webpack_require__(949);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/utils/permission.utils.ts
+var permission_utils = __webpack_require__(988);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/utils/computed-field.utils.ts
+var computed_field_utils = __webpack_require__(801);
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/utils/index.ts
+
+
+
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/index.ts
 // Config
-export * from './config/index';
+
 // Docs
-export * from './docs/index';
+
 // Controllers
-export * from './controllers/index';
+
 // DTOs
-export * from './dtos/index';
+
 // Entities
-export * from './entities/index';
+
 // Enums
-export * from './enums/index';
+
 // Interfaces
-export * from './interfaces/index';
+
 // Modules
-export * from './modules/index';
+
 // Services
-export * from './services/index';
+
 // Utils
-export * from './utils/index';
+
+
+
+},
+106(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  S: () => (/* reexport */ FormBuilderModule)
+});
+
+// EXTERNAL MODULE: external "@flusys/nestjs-shared/modules"
+var modules_ = __webpack_require__(236);
+// EXTERNAL MODULE: external "@nestjs/common"
+var common_ = __webpack_require__(157);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/config/form-builder.constants.ts
+var form_builder_constants = __webpack_require__(512);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/controllers/index.ts + 3 modules
+var controllers = __webpack_require__(585);
+// EXTERNAL MODULE: ./projects/nestjs-form-builder/src/services/index.ts
+var services = __webpack_require__(949);
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/modules/form-builder.module.ts
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+        r = Reflect.decorate(decorators, target, key, desc);
+    } else {
+        for(var i = decorators.length - 1; i >= 0; i--){
+            if (d = decorators[i]) {
+                r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+            }
+        }
+    }
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+
+
+
+
+class FormBuilderModule {
+    static CONTROLLERS = [
+        controllers/* .FormController */.X,
+        controllers/* .FormResultController */.Y
+    ];
+    static EXPORTS = [
+        services/* .FormBuilderConfigService */.jS,
+        services/* .FormBuilderDataSourceProvider */._Z,
+        services/* .FormService */.ux,
+        services/* .FormResultService */.vF
+    ];
+    /**
+   * Register FormBuilderModule synchronously
+   */ static forRoot(options) {
+        return {
+            module: FormBuilderModule,
+            global: options.global ?? false,
+            imports: [
+                modules_.CacheModule,
+                modules_.UtilsModule
+            ],
+            controllers: options.includeController !== false ? this.CONTROLLERS : [],
+            providers: this.buildProviders(options),
+            exports: this.EXPORTS
+        };
+    }
+    /**
+   * Register FormBuilderModule asynchronously
+   */ static forRootAsync(options) {
+        return {
+            module: FormBuilderModule,
+            global: options.global ?? false,
+            imports: [
+                ...options.imports || [],
+                modules_.CacheModule,
+                modules_.UtilsModule
+            ],
+            controllers: options.includeController !== false ? this.CONTROLLERS : [],
+            providers: [
+                ...this.buildAsyncProviders(options),
+                ...this.buildProviders()
+            ],
+            exports: this.EXPORTS
+        };
+    }
+    static buildProviders(options) {
+        const providers = [
+            services/* .FormBuilderConfigService */.jS,
+            services/* .FormBuilderDataSourceProvider */._Z,
+            services/* .FormService */.ux,
+            services/* .FormResultService */.vF
+        ];
+        if (options) {
+            providers.unshift({
+                provide: form_builder_constants/* .FORM_BUILDER_MODULE_OPTIONS */.v,
+                useValue: options
+            });
+        }
+        providers.push((0,modules_.createModuleEventsProvider)('form-builder', form_builder_constants/* .FORM_BUILDER_MODULE_OPTIONS */.v));
+        return providers;
+    }
+    static buildAsyncProviders(options) {
+        if (options.useFactory) {
+            return [
+                {
+                    provide: form_builder_constants/* .FORM_BUILDER_MODULE_OPTIONS */.v,
+                    useFactory: async (...args)=>({
+                            ...options,
+                            config: await options.useFactory(...args)
+                        }),
+                    inject: options.inject || []
+                }
+            ];
+        }
+        const factoryClass = options.useClass || options.useExisting;
+        if (!factoryClass) {
+            return [];
+        }
+        const providers = [
+            {
+                provide: form_builder_constants/* .FORM_BUILDER_MODULE_OPTIONS */.v,
+                useFactory: async (factory)=>({
+                        ...options,
+                        config: await factory.createFormBuilderOptions()
+                    }),
+                inject: [
+                    factoryClass
+                ]
+            }
+        ];
+        if (options.useClass) {
+            providers.push({
+                provide: options.useClass,
+                useClass: options.useClass
+            });
+        }
+        return providers;
+    }
+}
+FormBuilderModule = _ts_decorate([
+    (0,common_.Module)({})
+], FormBuilderModule);
+
+;// CONCATENATED MODULE: ./projects/nestjs-form-builder/src/modules/index.ts
+
+
+
+},
+949(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+/* import */ var _form_builder_config_service_js__rspack_import_0 = __webpack_require__(781);
+/* import */ var _form_builder_datasource_provider_js__rspack_import_1 = __webpack_require__(593);
+/* import */ var _form_service_js__rspack_import_2 = __webpack_require__(148);
+/* import */ var _form_result_service_js__rspack_import_3 = __webpack_require__(160);
+
+
+
+
+
+__webpack_require__.d(__webpack_exports__, {
+  _Z: () => (/* reexport safe */ _form_builder_datasource_provider_js__rspack_import_1._),
+  jS: () => (/* reexport safe */ _form_builder_config_service_js__rspack_import_0.j),
+  ux: () => (/* reexport safe */ _form_service_js__rspack_import_2.u),
+  vF: () => (/* reexport safe */ _form_result_service_js__rspack_import_3.v)
+});
+
+
+},
+
+};
+import { __webpack_require__ } from './runtime.js';
+var __webpack_exec__ = function(moduleId) { return __webpack_require__(__webpack_require__.s = moduleId); }
+import * as __rspack_chunk_1 from './262.js';
+__webpack_require__.C(__rspack_chunk_1);
+import * as __rspack_chunk_2 from './98.js';
+__webpack_require__.C(__rspack_chunk_2);
+import * as __rspack_chunk_3 from './index.js';
+__webpack_require__.C(__rspack_chunk_3);
+var __webpack_exports__ = __webpack_exec__(851);var __webpack_exports__CreateFormDto = __webpack_exports__.YD;
+var __webpack_exports__CreateFormResultDto = __webpack_exports__.pZ;
+var __webpack_exports__FORM_BUILDER_EVENT_ACTIONS = __webpack_exports__.ov;
+var __webpack_exports__FORM_BUILDER_EVENT_ENTITIES = __webpack_exports__.eF;
+var __webpack_exports__FORM_BUILDER_EVENT_MODULE = __webpack_exports__.T$;
+var __webpack_exports__FORM_BUILDER_MODULE_OPTIONS = __webpack_exports__.vx;
+var __webpack_exports__FORM_MESSAGES = __webpack_exports__.Ql;
+var __webpack_exports__FORM_RESULT_MESSAGES = __webpack_exports__.yF;
+var __webpack_exports__Form = __webpack_exports__.lV;
+var __webpack_exports__FormAccessInfoResponseDto = __webpack_exports__.Xe;
+var __webpack_exports__FormAccessType = __webpack_exports__.hi;
+var __webpack_exports__FormBase = __webpack_exports__.C7;
+var __webpack_exports__FormBuilderConfigService = __webpack_exports__.jS;
+var __webpack_exports__FormBuilderDataSourceProvider = __webpack_exports__._Z;
+var __webpack_exports__FormBuilderModule = __webpack_exports__.S7;
+var __webpack_exports__FormCompanyEntities = __webpack_exports__.Xl;
+var __webpack_exports__FormController = __webpack_exports__.Xq;
+var __webpack_exports__FormCoreEntities = __webpack_exports__.t$;
+var __webpack_exports__FormResponseDto = __webpack_exports__.bV;
+var __webpack_exports__FormResult = __webpack_exports__.ez;
+var __webpack_exports__FormResultController = __webpack_exports__.Ye;
+var __webpack_exports__FormResultResponseDto = __webpack_exports__._$;
+var __webpack_exports__FormResultService = __webpack_exports__.vF;
+var __webpack_exports__FormService = __webpack_exports__.ux;
+var __webpack_exports__FormWithCompany = __webpack_exports__.Wl;
+var __webpack_exports__GetMyDraftDto = __webpack_exports__.D5;
+var __webpack_exports__GetResultsByFormDto = __webpack_exports__.rp;
+var __webpack_exports__PublicFormResponseDto = __webpack_exports__.M4;
+var __webpack_exports__SubmitFormDto = __webpack_exports__.sH;
+var __webpack_exports__UpdateDraftDto = __webpack_exports__.CQ;
+var __webpack_exports__UpdateFormDto = __webpack_exports__.jQ;
+var __webpack_exports__UpdateFormResultDto = __webpack_exports__.Uj;
+var __webpack_exports__calculateComputedFields = __webpack_exports__.XZ;
+var __webpack_exports__formBuilderSwaggerConfig = __webpack_exports__.aY;
+var __webpack_exports__getFormBuilderEntitiesByConfig = __webpack_exports__.iO;
+var __webpack_exports__validateUserPermissions = __webpack_exports__.io;
+export { __webpack_exports__CreateFormDto as CreateFormDto, __webpack_exports__CreateFormResultDto as CreateFormResultDto, __webpack_exports__FORM_BUILDER_EVENT_ACTIONS as FORM_BUILDER_EVENT_ACTIONS, __webpack_exports__FORM_BUILDER_EVENT_ENTITIES as FORM_BUILDER_EVENT_ENTITIES, __webpack_exports__FORM_BUILDER_EVENT_MODULE as FORM_BUILDER_EVENT_MODULE, __webpack_exports__FORM_BUILDER_MODULE_OPTIONS as FORM_BUILDER_MODULE_OPTIONS, __webpack_exports__FORM_MESSAGES as FORM_MESSAGES, __webpack_exports__FORM_RESULT_MESSAGES as FORM_RESULT_MESSAGES, __webpack_exports__Form as Form, __webpack_exports__FormAccessInfoResponseDto as FormAccessInfoResponseDto, __webpack_exports__FormAccessType as FormAccessType, __webpack_exports__FormBase as FormBase, __webpack_exports__FormBuilderConfigService as FormBuilderConfigService, __webpack_exports__FormBuilderDataSourceProvider as FormBuilderDataSourceProvider, __webpack_exports__FormBuilderModule as FormBuilderModule, __webpack_exports__FormCompanyEntities as FormCompanyEntities, __webpack_exports__FormController as FormController, __webpack_exports__FormCoreEntities as FormCoreEntities, __webpack_exports__FormResponseDto as FormResponseDto, __webpack_exports__FormResult as FormResult, __webpack_exports__FormResultController as FormResultController, __webpack_exports__FormResultResponseDto as FormResultResponseDto, __webpack_exports__FormResultService as FormResultService, __webpack_exports__FormService as FormService, __webpack_exports__FormWithCompany as FormWithCompany, __webpack_exports__GetMyDraftDto as GetMyDraftDto, __webpack_exports__GetResultsByFormDto as GetResultsByFormDto, __webpack_exports__PublicFormResponseDto as PublicFormResponseDto, __webpack_exports__SubmitFormDto as SubmitFormDto, __webpack_exports__UpdateDraftDto as UpdateDraftDto, __webpack_exports__UpdateFormDto as UpdateFormDto, __webpack_exports__UpdateFormResultDto as UpdateFormResultDto, __webpack_exports__calculateComputedFields as calculateComputedFields, __webpack_exports__formBuilderSwaggerConfig as formBuilderSwaggerConfig, __webpack_exports__getFormBuilderEntitiesByConfig as getFormBuilderEntitiesByConfig, __webpack_exports__validateUserPermissions as validateUserPermissions };

package/fesm/interfaces/index.js

@@ -1,3 +1,17 @@
-export * from './form.interface';
-export * from './form-result.interface';
-export * from './form-builder-module.interface';
+export const __rspack_esm_id = 471;
+export const __rspack_esm_ids = [471];
+export const __webpack_modules__ = {
+945() {
+
+
+
+
+
+},
+
+};
+import { __webpack_require__ } from '../runtime.js';
+var __webpack_exec__ = function(moduleId) { return __webpack_require__(__webpack_require__.s = moduleId); }
+import * as __rspack_chunk_1 from './index.js';
+__webpack_require__.C(__rspack_chunk_1);
+var __webpack_exports__ = __webpack_exec__(945);