@flusys/nestjs-form-builder 1.0.0-rc → 2.0.0

package/fesm/docs/form-builder-swagger.config.js

@@ -34,7 +34,7 @@
     const enableCompanyFeature = bootstrapConfig?.enableCompanyFeature ?? true;
     return {
         title: 'Form Builder API',
-        description: enableCompanyFeature ? `
+        description: `
 # Form Builder API
 
 Dynamic form builder with schema versioning, conditional logic, and access control.
@@ -44,8 +44,7 @@ Dynamic form builder with schema versioning, conditional logic, and access contr
 ### 📋 Form Management
 - Create and manage dynamic forms
 - Schema versioning for form updates
-- Slug-based URLs for sharing
-- **Company isolation**
+- Slug-based URLs for sharing${enableCompanyFeature ? '\n- **Company isolation**' : ''}
 
 ### 🔒 Access Control
 - **Public**: No authentication required
@@ -55,114 +54,21 @@ Dynamic form builder with schema versioning, conditional logic, and access contr
 ### 📊 Form Results
 - Submit and track form responses
 - Draft support for partial submissions
-- Schema snapshot preservation
-- **Company-level permissions**
+- 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
-      ` : `
-# Form Builder API
-
-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
-
-### 🔒 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
-
-### 🔀 Conditional Logic
-- Show/hide fields based on values
-- Show/hide sections dynamically
-- Jump to sections based on conditions
-- Conditional required validation
-
+` : ''}
 ## Form Access Types
 
 ### Public Forms
@@ -227,7 +133,7 @@ POST /form-builder/result/submit-public with JSON body containing formId and for
 ### 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,

package/fesm/dtos/form-result.dto.js

@@ -22,6 +22,7 @@ function _ts_metadata(k, v) {
 }
 import { ApiProperty, PartialType } from '@nestjs/swagger';
 import { IsBoolean, IsInt, IsNotEmpty, IsObject, IsOptional, IsUUID, Min } from 'class-validator';
+import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
 export class SubmitFormDto {
     constructor(){
         _define_property(this, "formId", void 0);
@@ -66,6 +67,7 @@ _ts_decorate([
         description: 'Additional metadata',
         required: false
     }),
+    IsObject(),
     IsOptional(),
     _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
 ], SubmitFormDto.prototype, "metadata", void 0);
@@ -180,29 +182,11 @@ _ts_decorate([
     IsOptional(),
     _ts_metadata("design:type", Number)
 ], GetResultsByFormDto.prototype, "pageSize", void 0);
-export class FormResultResponseDto {
-    constructor(){
-        _define_property(this, "id", void 0);
-        _define_property(this, "formId", void 0);
-        _define_property(this, "schemaVersionSnapshot", void 0);
-        _define_property(this, "schemaVersion", void 0);
-        _define_property(this, "data", void 0);
-        _define_property(this, "submittedById", void 0);
-        _define_property(this, "submittedAt", void 0);
-        _define_property(this, "isDraft", void 0);
-        _define_property(this, "metadata", void 0);
-        _define_property(this, "createdAt", void 0);
-        _define_property(this, "updatedAt", void 0);
-        _define_property(this, "deletedAt", void 0);
-        _define_property(this, "createdById", void 0);
-        _define_property(this, "updatedById", void 0);
-        _define_property(this, "deletedById", void 0);
+export class FormResultResponseDto extends IdentityResponseDto {
+    constructor(...args){
+        super(...args), _define_property(this, "formId", void 0), _define_property(this, "schemaVersionSnapshot", void 0), _define_property(this, "schemaVersion", void 0), _define_property(this, "data", void 0), _define_property(this, "submittedById", void 0), _define_property(this, "submittedAt", void 0), _define_property(this, "isDraft", void 0), _define_property(this, "metadata", void 0);
     }
 }
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], FormResultResponseDto.prototype, "id", void 0);
 _ts_decorate([
     ApiProperty(),
     _ts_metadata("design:type", String)
@@ -237,35 +221,3 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], FormResultResponseDto.prototype, "metadata", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FormResultResponseDto.prototype, "createdAt", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FormResultResponseDto.prototype, "updatedAt", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResultResponseDto.prototype, "deletedAt", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResultResponseDto.prototype, "createdById", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResultResponseDto.prototype, "updatedById", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResultResponseDto.prototype, "deletedById", void 0);

package/fesm/dtos/form.dto.js

@@ -20,9 +20,10 @@ function _ts_decorate(decorators, target, key, desc) {
 function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-import { ApiProperty, PartialType } from '@nestjs/swagger';
+import { ApiProperty, PartialType, PickType } from '@nestjs/swagger';
 import { IsArray, IsBoolean, IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, MaxLength } from 'class-validator';
 import { FormAccessType } from '../enums/form-access-type.enum';
+import { IdentityResponseDto } from '@flusys/nestjs-shared/dtos';
 export class CreateFormDto {
     constructor(){
         _define_property(this, "name", void 0);
@@ -132,6 +133,7 @@ _ts_decorate([
         description: 'Additional metadata',
         required: false
     }),
+    IsObject(),
     IsOptional(),
     _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
 ], CreateFormDto.prototype, "metadata", void 0);
@@ -157,31 +159,11 @@ _ts_decorate([
     IsOptional(),
     _ts_metadata("design:type", Number)
 ], UpdateFormDto.prototype, "schemaVersion", void 0);
-export class FormResponseDto {
-    constructor(){
-        _define_property(this, "id", void 0);
-        _define_property(this, "name", void 0);
-        _define_property(this, "description", void 0);
-        _define_property(this, "slug", void 0);
-        _define_property(this, "schema", void 0);
-        _define_property(this, "schemaVersion", void 0);
-        _define_property(this, "accessType", void 0);
-        _define_property(this, "actionGroups", void 0);
-        _define_property(this, "companyId", void 0);
-        _define_property(this, "isActive", void 0);
-        _define_property(this, "metadata", void 0);
-        _define_property(this, "createdAt", void 0);
-        _define_property(this, "updatedAt", void 0);
-        _define_property(this, "deletedAt", void 0);
-        _define_property(this, "createdById", void 0);
-        _define_property(this, "updatedById", void 0);
-        _define_property(this, "deletedById", void 0);
+export class FormResponseDto extends IdentityResponseDto {
+    constructor(...args){
+        super(...args), _define_property(this, "name", void 0), _define_property(this, "description", void 0), _define_property(this, "slug", void 0), _define_property(this, "schema", void 0), _define_property(this, "schemaVersion", void 0), _define_property(this, "accessType", void 0), _define_property(this, "actionGroups", void 0), _define_property(this, "companyId", void 0), _define_property(this, "isActive", void 0), _define_property(this, "metadata", void 0);
     }
 }
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], FormResponseDto.prototype, "id", void 0);
 _ts_decorate([
     ApiProperty(),
     _ts_metadata("design:type", String)
@@ -226,105 +208,20 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", Object)
 ], FormResponseDto.prototype, "metadata", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FormResponseDto.prototype, "createdAt", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
-], FormResponseDto.prototype, "updatedAt", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResponseDto.prototype, "deletedAt", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResponseDto.prototype, "createdById", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResponseDto.prototype, "updatedById", void 0);
-_ts_decorate([
-    ApiProperty({
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormResponseDto.prototype, "deletedById", void 0);
-export class PublicFormResponseDto {
-    constructor(){
-        _define_property(this, "id", void 0);
-        _define_property(this, "name", void 0);
-        _define_property(this, "description", void 0);
-        _define_property(this, "schema", void 0);
-        _define_property(this, "schemaVersion", void 0);
-    }
+export class PublicFormResponseDto extends PickType(FormResponseDto, [
+    'id',
+    'name',
+    'description',
+    'schema',
+    'schemaVersion'
+]) {
 }
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], PublicFormResponseDto.prototype, "id", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], PublicFormResponseDto.prototype, "name", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", Object)
-], PublicFormResponseDto.prototype, "description", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
-], PublicFormResponseDto.prototype, "schema", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", Number)
-], PublicFormResponseDto.prototype, "schemaVersion", void 0);
-export class FormAccessInfoResponseDto {
-    constructor(){
-        _define_property(this, "id", void 0);
-        _define_property(this, "name", void 0);
-        _define_property(this, "description", void 0);
-        _define_property(this, "accessType", void 0);
-        _define_property(this, "actionGroups", void 0);
-        _define_property(this, "isActive", void 0);
-    }
+export class FormAccessInfoResponseDto extends PickType(FormResponseDto, [
+    'id',
+    'name',
+    'description',
+    'accessType',
+    'actionGroups',
+    'isActive'
+]) {
 }
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], FormAccessInfoResponseDto.prototype, "id", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", String)
-], FormAccessInfoResponseDto.prototype, "name", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", Object)
-], FormAccessInfoResponseDto.prototype, "description", void 0);
-_ts_decorate([
-    ApiProperty({
-        enum: FormAccessType
-    }),
-    _ts_metadata("design:type", typeof FormAccessType === "undefined" ? Object : FormAccessType)
-], FormAccessInfoResponseDto.prototype, "accessType", void 0);
-_ts_decorate([
-    ApiProperty({
-        type: [
-            String
-        ],
-        required: false
-    }),
-    _ts_metadata("design:type", Object)
-], FormAccessInfoResponseDto.prototype, "actionGroups", void 0);
-_ts_decorate([
-    ApiProperty(),
-    _ts_metadata("design:type", Boolean)
-], FormAccessInfoResponseDto.prototype, "isActive", void 0);

package/fesm/entities/form-with-company.entity.js

@@ -21,8 +21,8 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { Column, Entity, Index } from 'typeorm';
-import { FormBase } from './form-base.entity';
-export class FormWithCompany extends FormBase {
+import { Form } from './form.entity';
+export class FormWithCompany extends Form {
     constructor(...args){
         super(...args), _define_property(this, "companyId", void 0);
     }
@@ -41,5 +41,15 @@ FormWithCompany = _ts_decorate([
     }),
     Index([
         'companyId'
+    ]),
+    Index([
+        'companyId',
+        'slug'
+    ], {
+        unique: true
+    }),
+    Index([
+        'companyId',
+        'isActive'
     ])
 ], FormWithCompany);

package/fesm/entities/form.entity.js

@@ -1,15 +1,115 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
 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;
 }
-import { Entity } from 'typeorm';
-import { FormBase } from './form-base.entity';
-export class Form extends FormBase {
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+import { Identity } from '@flusys/nestjs-shared/entities';
+import { Column, Entity, Index } from 'typeorm';
+import { FormAccessType } from '../enums/form-access-type.enum';
+export class Form extends Identity {
+    constructor(...args){
+        super(...args), _define_property(this, "name", void 0), _define_property(this, "description", void 0), _define_property(this, "slug", void 0), _define_property(this, "schema", void 0), _define_property(this, "schemaVersion", void 0), _define_property(this, "accessType", void 0), _define_property(this, "actionGroups", void 0), _define_property(this, "isActive", void 0), _define_property(this, "metadata", void 0);
+    }
 }
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: false
+    }),
+    _ts_metadata("design:type", String)
+], Form.prototype, "name", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 500,
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], Form.prototype, "description", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], Form.prototype, "slug", void 0);
+_ts_decorate([
+    Column({
+        type: 'json',
+        nullable: false
+    }),
+    _ts_metadata("design:type", typeof Record === "undefined" ? Object : Record)
+], Form.prototype, "schema", void 0);
+_ts_decorate([
+    Column({
+        type: 'int',
+        nullable: false,
+        default: 1,
+        name: 'schema_version'
+    }),
+    _ts_metadata("design:type", Number)
+], Form.prototype, "schemaVersion", void 0);
+_ts_decorate([
+    Column({
+        type: 'enum',
+        enum: FormAccessType,
+        default: FormAccessType.AUTHENTICATED,
+        name: 'access_type'
+    }),
+    _ts_metadata("design:type", typeof FormAccessType === "undefined" ? Object : FormAccessType)
+], Form.prototype, "accessType", void 0);
+_ts_decorate([
+    Column({
+        type: 'simple-array',
+        nullable: true,
+        name: 'action_groups'
+    }),
+    _ts_metadata("design:type", Object)
+], Form.prototype, "actionGroups", void 0);
+_ts_decorate([
+    Column({
+        type: 'boolean',
+        nullable: false,
+        default: true,
+        name: 'is_active'
+    }),
+    _ts_metadata("design:type", Boolean)
+], Form.prototype, "isActive", void 0);
+_ts_decorate([
+    Column('simple-json', {
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], Form.prototype, "metadata", void 0);
 Form = _ts_decorate([
     Entity({
         name: 'form'
-    })
+    }),
+    Index([
+        'slug'
+    ], {
+        unique: true
+    }),
+    Index([
+        'isActive'
+    ])
 ], Form);

package/fesm/entities/index.js

@@ -1,29 +1,23 @@
-// Form Entities
-export * from './form-base.entity';
+// Entities without company feature
 export * from './form.entity';
-export * from './form-with-company.entity';
-// Form Result Entity (single - no company variant needed)
 export * from './form-result.entity';
-// Helper function to get entities based on config
+// Entities with company feature
+export * from './form-with-company.entity';
 import { Form } from './form.entity';
-import { FormWithCompany } from './form-with-company.entity';
 import { FormResult } from './form-result.entity';
-/**
- * Get form builder entities based on configuration
- * @param enableCompanyFeature Whether company feature is enabled
- * @returns Array of entity classes
- *
- * Note: FormResult is always the same regardless of company feature
- * because company context is derived from the linked Form via formId
- */ export function getFormBuilderEntitiesByConfig(enableCompanyFeature) {
-    if (enableCompanyFeature) {
-        return [
-            FormWithCompany,
-            FormResult
-        ];
-    }
-    return [
-        Form,
-        FormResult
-    ];
+import { FormWithCompany } from './form-with-company.entity';
+// Core entities (no company feature)
+export const FormCoreEntities = [
+    Form,
+    FormResult
+];
+// Company-specific entities
+export const FormCompanyEntities = [
+    FormWithCompany,
+    FormResult
+];
+export function getFormBuilderEntitiesByConfig(enableCompanyFeature) {
+    return enableCompanyFeature ? FormCompanyEntities : FormCoreEntities;
 }
+// Base type aliases for backwards compatibility with services
+export { Form as FormBase } from './form.entity';