@flusys/nestjs-entity-builder 9.1.2 → 9.2.0

package/interfaces/definition-bundle.interface.d.ts

@@ -43,6 +43,7 @@ export interface IDefinitionBundle {
 export interface IImportBundleRequest {
     bundle: IDefinitionBundle;
     deprecateMissingFields?: boolean;
+    deactivateMissingFlows?: boolean;
     confirm?: boolean;
     expectedChecksum?: string;
     expectedPlanChecksum?: string;
@@ -52,7 +53,7 @@ export interface IBundleExport {
     checksum: string;
     warnings: IMessageRef[];
 }
-export type BundleStepKind = 'update_entity' | 'create_entity' | 'restore_field' | 'rename_field' | 'update_field' | 'add_field' | 'deprecate_field' | 'create_flow' | 'update_flow';
+export type BundleStepKind = 'update_entity' | 'create_entity' | 'restore_field' | 'rename_field' | 'update_field' | 'add_field' | 'deprecate_field' | 'create_flow' | 'update_flow' | 'deactivate_flow';
 export interface IBundleStep {
     kind: BundleStepKind;
     entityCode?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flusys/nestjs-entity-builder",
-  "version": "9.1.2",
+  "version": "9.2.0",
   "description": "Dynamic entity builder module - runtime entity/field metadata, driven DDL, and generic CRUD",
   "type": "module",
   "main": "./fesm/index.js",
@@ -85,8 +85,8 @@
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@flusys/nestjs-core": "9.1.2",
-    "@flusys/nestjs-shared": "9.1.2",
+    "@flusys/nestjs-core": "9.2.0",
+    "@flusys/nestjs-shared": "9.2.0",
     "quickjs-emscripten": "^0.32.0"
   }
 }

package/services/definition-bundle.diff.d.ts

@@ -16,6 +16,12 @@ export declare function applyVariables(nodes: IFlowNode[], variables: Record<str
     nodes: IFlowNode[];
     missing: string[];
 };
+export declare function fixedIds(nodes: IFlowNode[]): string[];
+export declare function permissionCodes(flow: Pick<IBundleFlow, 'slug' | 'nodes'>): string[];
+export declare function writtenSecrets(nodes: IFlowNode[]): Array<{
+    step: string;
+    name: string;
+}>;
 export declare function calledFlowSlugs(nodes: IFlowNode[]): string[];
 export declare function orderFlows(flows: IBundleFlow[]): IBundleFlow[];
 export interface ICurrentEntity {

package/services/definition-bundle.service.d.ts

@@ -1,9 +1,10 @@
-import { type ILoggedUserInfo } from '@flusys/nestjs-shared/interfaces';
+import { type ILoggedUserInfo, type IPermissionActionRegistry } from '@flusys/nestjs-shared/interfaces';
 import { type ExportBundleDto } from '../dtos/definition-bundle.dto.js';
 import { type IBundleExport, type IBundleImportPlan, type IBundleImportResult, type IImportBundleRequest } from '../interfaces/definition-bundle.interface.js';
 import { EntityBuilderConfigService } from './entity-builder-config.service.js';
 import { EntityBuilderDataSourceProvider } from './entity-builder-datasource.provider.js';
 import { FlowDefinitionService } from './flow-definition.service.js';
+import { SchemaDialectAdapterService } from './schema-dialect-adapter.service.js';
 import { SchemaEvolutionService } from './schema-evolution.service.js';
 import { SchemaSyncService } from './schema-sync.service.js';
 export declare class DefinitionBundleService {
@@ -12,12 +13,16 @@ export declare class DefinitionBundleService {
     private readonly schemaSync;
     private readonly evolution;
     private readonly flows;
-    constructor(provider: EntityBuilderDataSourceProvider, config: EntityBuilderConfigService, schemaSync: SchemaSyncService, evolution: SchemaEvolutionService, flows: FlowDefinitionService);
+    private readonly dialect;
+    private readonly actionRegistry?;
+    constructor(provider: EntityBuilderDataSourceProvider, config: EntityBuilderConfigService, schemaSync: SchemaSyncService, evolution: SchemaEvolutionService, flows: FlowDefinitionService, dialect: SchemaDialectAdapterService, actionRegistry?: IPermissionActionRegistry | undefined);
     private variables;
     export(dto: ExportBundleDto): Promise<IBundleExport>;
+    private leftBehind;
     private loadEntities;
     planImport(dto: IImportBundleRequest, user: ILoggedUserInfo | null): Promise<IBundleImportPlan>;
     private buildPlan;
+    private addPermissionWarnings;
     private relationNotYetCreated;
     private previewEntityStep;
     private diffFlows;
@@ -25,8 +30,11 @@ export declare class DefinitionBundleService {
     private createRequest;
     private changeRequest;
     applyImport(dto: IImportBundleRequest, user: ILoggedUserInfo | null): Promise<IBundleImportResult>;
+    private withImportLock;
+    private runImport;
     private applyEntityStep;
     private idIsFree;
     private freeFieldIds;
     private applyFlowStep;
+    private deactivateFlow;
 }

package/services/entity-flow-scaffold.d.ts

@@ -15,11 +15,12 @@ export interface IEntityFlowSource {
     label: string;
     fields: IEntityFlowField[];
 }
-type FlowInputLabel = 'id' | 'ids' | 'search';
+type FlowInputLabel = 'id';
 export interface IEntityFlowTexts {
     names?: Partial<Record<EntityFlowEndpoint, string>>;
     inputLabels?: Partial<Record<FlowInputLabel, string>>;
     noMatchMessage?: string;
+    deleteOnlyMessage?: string;
 }
 export declare const ENTITY_FLOW_PATHS: Record<EntityFlowEndpoint, string>;
 export declare const entityFlowSlug: (entityCode: string) => string;

package/services/entity-permission.service.d.ts

@@ -1,5 +1,6 @@
 import { type IPermissionActionRegistry } from '@flusys/nestjs-shared';
 import { EntityDefinition } from '../entities/entity-definition.entity.js';
+export declare const entityPermissionCodes: (entityCode: string) => string[];
 export declare class EntityPermissionService {
     private readonly actionRegistry?;
     constructor(actionRegistry?: IPermissionActionRegistry | undefined);

package/services/flow-definition.service.d.ts

@@ -13,6 +13,7 @@ import { type IFlowDefinition, type IFlowSnapshot, type IFlowVersion } from '../
 import { EntityBuilderDataSourceProvider } from './entity-builder-datasource.provider.js';
 export declare const defaultFlowPermissionCode: (slug: string) => string;
 export declare const flowPermissions: (endpoint: Pick<IFlowEndpoint, "permissions">, slug: string) => ILogicNode;
+export declare const asksExecutePermission: (endpoint: Pick<IFlowEndpoint, "authMode" | "permissions">) => boolean;
 export declare const flowNotFound: () => NotFoundException;
 export declare const isPublished: (flow: Pick<FlowDefinition, "version">) => boolean;
 export declare function snapshotOf(source: Partial<IFlowSnapshot>): IFlowSnapshot;
@@ -56,7 +57,6 @@ export declare class FlowDefinitionService extends ApiService<CreateFlowDefiniti
     restoreVersion(flowId: string, version: number, user: ILoggedUserInfo | null): Promise<FlowDefinition>;
     discardDraft(flowId: string, user: ILoggedUserInfo | null): Promise<FlowDefinition>;
     private saveDraft;
-    private clearCaches;
     protected beforeDeleteOperation(dto: DeleteDto, user: ILoggedUserInfo | null, _qr: QueryRunner): Promise<void>;
     private provisionPermissions;
 }

package/services/flow-runtime.service.d.ts

@@ -21,6 +21,7 @@ export declare class FlowRuntimeService {
     private readonly definitions;
     constructor(provider: EntityBuilderDataSourceProvider, executor: FlowExecutorService, executions: FlowExecutionService, definitions: FlowDefinitionService);
     findActive(slug: string): Promise<FlowDefinition | null>;
+    tenantScope(): string;
     handle(flow: FlowDefinition, endpoint: IFlowEndpoint, body: unknown, caller: IFlowCaller, user: ILoggedUserInfo | null): Promise<IFlowRunResult>;
     testRun(dto: TestFlowDto, user: ILoggedUserInfo | null, caller: IFlowCaller): Promise<{
         result: IFlowRunResult;

package/services/generic-entity.service.d.ts

@@ -14,6 +14,7 @@ export interface IGenericQuery {
         currentPage: number;
         pageSize: number;
     };
+    withDeleted?: boolean;
 }
 export interface IGenericWriteOptions {
     queryRunner?: QueryRunner;

package/services/schema-change-executor.service.d.ts

@@ -29,6 +29,7 @@ export declare class SchemaChangeExecutor {
         plan: ISchemaChangePlan;
         outcome: ISchemaChangeOutcome;
     }>;
+    private invalidateDefinitions;
     private compensate;
     private withUndo;
     private logFailure;

package/services/schema-dialect-adapter.service.d.ts

@@ -9,5 +9,7 @@ export declare class SchemaDialectAdapterService implements ISchemaDialectAdapte
     sqlLiteral(value: unknown, driver: SupportedDbDriver): string;
     lockName(lockKey: string): string;
     acquireEntityLock(queryRunner: QueryRunner, lockKey: string, driver: SupportedDbDriver): Promise<void>;
+    tryAcquireSessionLock(queryRunner: QueryRunner, lockKey: string, driver: SupportedDbDriver): Promise<boolean>;
+    releaseSessionLock(queryRunner: QueryRunner, lockKey: string, driver: SupportedDbDriver): Promise<void>;
     releaseEntityLock(queryRunner: QueryRunner, lockKey: string, driver: SupportedDbDriver): Promise<void>;
 }