@praxisui/dynamic-form 10.0.0-rc.15 → 10.0.0-rc.17

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-14T16:04:24.084Z",
+  "generatedAt": "2026-10-14T22:05:37.957Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "10.0.0-rc.15",
+  "packageVersion": "10.0.0-rc.17",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,

package/fesm2022/praxisui-dynamic-form.mjs

@@ -12023,6 +12023,8 @@ class PraxisDynamicForm {
     entitySelectionCleared = false;
     hydratedEntityId = null;
     loadedEntityData = null;
+    loadedEntityResourceVersion = null;
+    entityVersionInvalidated = false;
     entityHydrationPending = false;
     entityReadFailed = false;
     entityReadText(key) {
@@ -12550,9 +12552,9 @@ class PraxisDynamicForm {
         const method = this.normalizeSubmitMethod(this.submitMethod);
         const configuredSubmitUrl = String(this.submitUrl || '').trim();
         if (!method && !configuredSubmitUrl) {
-            return operation === 'update'
+            return (operation === 'update'
                 ? this.crud.update(this.resourceId, formData)
-                : this.crud.create(formData);
+                : this.crud.create(formData)).pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, operation === 'update')), catchError((err) => this.handleVersionedSubmitError(err)));
         }
         if (!method || !configuredSubmitUrl) {
             return throwError(() => new Error('PraxisDynamicForm requires submitMethod and submitUrl together for canonical submit execution.'));
@@ -12573,28 +12575,37 @@ class PraxisDynamicForm {
             }
             if (method === 'patch') {
                 return this.http
-                    .patch(resolvedUrl, formData, { headers })
-                    .pipe(map$1((response) => this.unwrapRestApiResponse(response)));
+                    .patch(resolvedUrl, formData, {
+                    headers,
+                    observe: 'response',
+                })
+                    .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, true)), catchError((err) => this.handleVersionedSubmitError(err)));
             }
             if (method === 'put') {
                 return this.http
-                    .put(resolvedUrl, formData, { headers })
-                    .pipe(map$1((response) => this.unwrapRestApiResponse(response)));
+                    .put(resolvedUrl, formData, {
+                    headers,
+                    observe: 'response',
+                })
+                    .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, true)), catchError((err) => this.handleVersionedSubmitError(err)));
             }
             return this.http
-                .post(resolvedUrl, formData, { headers })
-                .pipe(map$1((response) => this.unwrapRestApiResponse(response)));
+                .post(resolvedUrl, formData, {
+                headers,
+                observe: 'response',
+            })
+                .pipe(map$1((response) => this.unwrapAndCaptureSubmitResponse(response, this.mode === 'edit' || this.resourceId != null)), catchError((err) => this.handleVersionedSubmitError(err)));
         }));
     }
     resolveSubmitResourceVersion(formData) {
-        const explicitVersion = String(this.submitResourceVersion ?? '').trim();
+        const explicitVersion = this.normalizeResourceVersionToken(this.submitResourceVersion);
         if (explicitVersion) {
             return of(explicitVersion);
         }
         const targetResourceKey = String(this.submitResourceVersionTargetResourceKey ?? '').trim();
         const targetIdField = String(this.submitResourceVersionTargetIdField ?? '').trim();
         if (!targetResourceKey && !targetIdField) {
-            return of(null);
+            return of(this.resolveCurrentEntityResourceVersion(formData));
         }
         if (!targetResourceKey || !targetIdField) {
             return throwError(() => new Error('PraxisDynamicForm requires both submitResourceVersionTargetResourceKey and submitResourceVersionTargetIdField.'));
@@ -12635,12 +12646,119 @@ class PraxisDynamicForm {
                 observe: 'response',
             });
         }), switchMap((response) => {
-            const etag = String(response.headers.get('ETag') || '').trim();
+            const etag = this.normalizeResourceVersionToken(response.headers?.get?.('ETag')) ??
+                this.extractResourceVersionCandidate(this.unwrapRestApiResponse(response.body));
             return etag
                 ? of(etag)
                 : throwError(() => new Error(`PraxisDynamicForm did not receive an ETag for cross-resource target "${targetResourceKey}".`));
         }));
     }
+    resolveCurrentEntityResourceVersion(formData) {
+        const method = this.normalizeSubmitMethod(this.submitMethod);
+        const isEntityUpdate = this.mode === 'edit' || method === 'put' || method === 'patch';
+        if (!isEntityUpdate) {
+            return null;
+        }
+        const entityId = this.resourceId ?? this.pendingEntityId ?? this.loadedEntityId ?? null;
+        const crudCachedVersion = entityId != null
+            ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(entityId))
+            : null;
+        if (this.entityVersionInvalidated) {
+            return this.loadedEntityResourceVersion || crudCachedVersion || null;
+        }
+        return (this.loadedEntityResourceVersion ||
+            crudCachedVersion ||
+            this.extractResourceVersionCandidate(this.loadedEntityData) ||
+            this.extractResourceVersionCandidate(formData) ||
+            this.extractResourceVersionCandidate(this.initialValue) ||
+            null);
+    }
+    unwrapAndCaptureSubmitResponse(response, isEntityMutation) {
+        const isHttpResponse = response &&
+            typeof response === 'object' &&
+            'body' in response &&
+            'headers' in response;
+        const etagHeader = isHttpResponse
+            ? this.normalizeResourceVersionToken(response.headers?.get?.('ETag'))
+            : null;
+        const unwrapped = this.unwrapRestApiResponse(isHttpResponse ? response.body : response);
+        this.captureUpdatedEntityResourceVersion(unwrapped, etagHeader, isEntityMutation);
+        return unwrapped;
+    }
+    captureUpdatedEntityResourceVersion(payload, etagHeader = null, isEntityMutation = true) {
+        const payloadId = payload && typeof payload === 'object' && !Array.isArray(payload)
+            ? payload['id'] ?? null
+            : null;
+        const entityId = this.resourceId ??
+            this.pendingEntityId ??
+            this.loadedEntityId ??
+            payloadId ??
+            null;
+        const nextVersion = etagHeader ??
+            this.extractResourceVersionCandidate(payload) ??
+            (isEntityMutation && entityId != null
+                ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(entityId))
+                : null);
+        if (!nextVersion) {
+            return;
+        }
+        this.entityVersionInvalidated = false;
+        if (isEntityMutation || entityId != null) {
+            this.loadedEntityResourceVersion = nextVersion;
+        }
+        if (this.submitResourceVersion != null &&
+            !this.submitResourceVersionTargetResourceKey &&
+            !this.submitResourceVersionTargetIdField) {
+            this.submitResourceVersion = nextVersion;
+        }
+        if (this.loadedEntityData &&
+            typeof this.loadedEntityData === 'object' &&
+            !Array.isArray(this.loadedEntityData) &&
+            'resourceVersion' in this.loadedEntityData) {
+            this.loadedEntityData = {
+                ...this.loadedEntityData,
+                resourceVersion: nextVersion,
+            };
+        }
+        if (entityId != null) {
+            this.crud?.setResourceVersion?.(entityId, nextVersion);
+        }
+    }
+    handleVersionedSubmitError(err) {
+        if (err?.status === 412 || err?.status === 428) {
+            if (!this.submitResourceVersionTargetResourceKey &&
+                !this.submitResourceVersionTargetIdField) {
+                this.entityVersionInvalidated = true;
+                this.loadedEntityResourceVersion = null;
+                this.submitResourceVersion = null;
+                const entityId = this.resourceId ?? this.pendingEntityId ?? this.loadedEntityId ?? null;
+                if (entityId != null) {
+                    this.crud?.setResourceVersion?.(entityId, null);
+                }
+            }
+        }
+        return throwError(() => err);
+    }
+    normalizeResourceVersionToken(raw) {
+        if (typeof raw !== 'string' && typeof raw !== 'number') {
+            return null;
+        }
+        const trimmed = String(raw).trim();
+        if (!trimmed) {
+            return null;
+        }
+        const unquoted = trimmed
+            .replace(/^W\//i, '')
+            .replace(/^"|"$/g, '')
+            .trim();
+        return unquoted ? trimmed : null;
+    }
+    extractResourceVersionCandidate(source) {
+        if (!source || typeof source !== 'object' || Array.isArray(source)) {
+            return null;
+        }
+        return this.normalizeResourceVersionToken(source['resourceVersion']);
+    }
     normalizeSubmitMethod(value) {
         const normalized = String(value || '')
             .trim()
@@ -12651,10 +12769,15 @@ class PraxisDynamicForm {
         return null;
     }
     formatResourceVersion(version) {
-        if (/^(?:W\/)?".*"$/.test(version)) {
-            return version;
+        const trimmed = version.trim();
+        if (/^(?:W\/)?"[^"]+"$/.test(trimmed)) {
+            return trimmed;
         }
-        return `"${version.replace(/^"|"$/g, '')}"`;
+        const unquoted = trimmed
+            .replace(/^W\//i, '')
+            .replace(/^"|"$/g, '')
+            .trim();
+        return `"${unquoted}"`;
     }
     resolveSubmitHref(submitUrl) {
         return this.resolveEntityAwareHref(submitUrl, 'PraxisDynamicForm cannot resolve submitUrl placeholders without a resourceId.');
@@ -13088,6 +13211,8 @@ class PraxisDynamicForm {
                 this.entityReadCancel$.next();
                 this.loadedEntityId = null;
                 this.loadedEntityData = null;
+                this.loadedEntityResourceVersion = null;
+                this.entityVersionInvalidated = false;
                 this.hydratedEntityId = null;
                 this.entityHydrationPending = false;
             }
@@ -13107,6 +13232,9 @@ class PraxisDynamicForm {
                 this.loadEntity();
             }
         }
+        if (changes['submitResourceVersion']) {
+            this.entityVersionInvalidated = false;
+        }
         if (changes['initialValue'] &&
             !changes['initialValue'].firstChange &&
             this.usesInitialValueAsAuthoritativeSnapshot() &&
@@ -13119,6 +13247,9 @@ class PraxisDynamicForm {
             this.form.markAsPristine();
             this.form.markAsUntouched();
             this.loadedEntityData = normalized;
+            this.loadedEntityResourceVersion =
+                this.extractResourceVersionCandidate(this.initialValue);
+            this.entityVersionInvalidated = false;
             this.hydratedEntityId = this.pendingEntityId;
             this.flushEntityHydrationState();
             this.emitPayloadPreview('entity-hydrated');
@@ -13135,6 +13266,8 @@ class PraxisDynamicForm {
             this.debugLog('[PDF] ngOnChanges readUrl=', this.readUrl);
             this.loadedEntityId = null;
             this.loadedEntityData = null;
+            this.loadedEntityResourceVersion = null;
+            this.entityVersionInvalidated = false;
             this.hydratedEntityId = null;
             if (this.config.fieldMetadata?.length && this.pendingEntityId != null) {
                 this.loadEntity();
@@ -13766,6 +13899,8 @@ class PraxisDynamicForm {
         // A new identity or read projection supersedes any in-flight entity read.
         this.entityReadCancel$.next();
         this.loadedEntityData = null;
+        this.loadedEntityResourceVersion = null;
+        this.entityVersionInvalidated = false;
         this.loadedEntityId = this.pendingEntityId;
         this.entityHydrationPending = true;
         this.entityReadFailed = false;
@@ -13777,8 +13912,24 @@ class PraxisDynamicForm {
                 .get(this.resolveReadHref(configuredReadUrl), {
                 context: httpContext,
                 headers: composeHeadersWithVersion(this.resolveApiEntry()),
+                observe: 'response',
             })
-                .pipe(map$1((response) => this.unwrapRestApiResponse(response)))
+                .pipe(map$1((response) => {
+                const isHttpResponse = response &&
+                    typeof response === 'object' &&
+                    'body' in response &&
+                    'headers' in response;
+                const etagHeader = isHttpResponse
+                    ? this.normalizeResourceVersionToken(response.headers?.get?.('ETag'))
+                    : null;
+                if (etagHeader) {
+                    this.loadedEntityResourceVersion = etagHeader;
+                    if (this.pendingEntityId != null) {
+                        this.crud?.setResourceVersion?.(this.pendingEntityId, etagHeader);
+                    }
+                }
+                return this.unwrapRestApiResponse(isHttpResponse ? response.body : response);
+            }))
             : this.crud.getById(this.pendingEntityId, { httpContext });
         request$
             .pipe(takeUntil(this.entityReadCancel$), takeUntil(this.destroy$))
@@ -13786,6 +13937,16 @@ class PraxisDynamicForm {
             next: (data) => {
                 this.entityHydrationPending = false;
                 if (data && typeof data === 'object' && !Array.isArray(data)) {
+                    const capturedVersion = this.loadedEntityResourceVersion ??
+                        this.extractResourceVersionCandidate(data) ??
+                        (this.pendingEntityId != null
+                            ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(this.pendingEntityId))
+                            : null);
+                    this.loadedEntityResourceVersion = capturedVersion;
+                    this.entityVersionInvalidated = false;
+                    if (capturedVersion && this.pendingEntityId != null) {
+                        this.crud?.setResourceVersion?.(this.pendingEntityId, capturedVersion);
+                    }
                     const normalized = this.normalizeFormPatchValue(data);
                     this.loadedEntityData = normalized;
                     if (Object.keys(this.form.controls).length) {
@@ -13804,6 +13965,7 @@ class PraxisDynamicForm {
                 else {
                     this.entityReadFailed = true;
                     this.loadedEntityId = null;
+                    this.loadedEntityResourceVersion = null;
                     this.warnLog('Invalid entity data received:', data, { actionId: 'entity.load', throttleKey: 'praxis-dynamic-form:invalid-entity-data' });
                     this.emitLoadingState('data', 'error', 'Dados inválidos recebidos.');
                     this.flushEntityHydrationState();
@@ -13813,6 +13975,7 @@ class PraxisDynamicForm {
                 this.entityHydrationPending = false;
                 this.entityReadFailed = true;
                 this.loadedEntityId = null;
+                this.loadedEntityResourceVersion = null;
                 this.flushEntityHydrationState();
                 this.emitLoadingState('data', 'error', 'Erro ao carregar dados.', err);
             },
@@ -13823,6 +13986,15 @@ class PraxisDynamicForm {
         if (!normalized) {
             return false;
         }
+        const capturedVersion = this.extractResourceVersionCandidate(this.initialValue) ??
+            (this.pendingEntityId != null
+                ? this.normalizeResourceVersionToken(this.crud?.getResourceVersion?.(this.pendingEntityId))
+                : null);
+        this.loadedEntityResourceVersion = capturedVersion;
+        this.entityVersionInvalidated = false;
+        if (capturedVersion && this.pendingEntityId != null) {
+            this.crud?.setResourceVersion?.(this.pendingEntityId, capturedVersion);
+        }
         this.loadedEntityId = this.pendingEntityId;
         this.loadedEntityData = normalized;
         this.entityHydrationPending = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisui/dynamic-form",
-  "version": "10.0.0-rc.15",
+  "version": "10.0.0-rc.17",
   "description": "Angular dynamic form engine for Praxis UI: metadata-driven forms, hooks, and services integrating @praxisui/* packages.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
@@ -9,13 +9,13 @@
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.15",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.15",
-    "@praxisui/metadata-editor": "^10.0.0-rc.15",
-    "@praxisui/rich-content": "^10.0.0-rc.15",
-    "@praxisui/settings-panel": "^10.0.0-rc.15",
-    "@praxisui/visual-builder": "^10.0.0-rc.15",
-    "@praxisui/core": "^10.0.0-rc.15",
+    "@praxisui/ai": "^10.0.0-rc.17",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.17",
+    "@praxisui/metadata-editor": "^10.0.0-rc.17",
+    "@praxisui/rich-content": "^10.0.0-rc.17",
+    "@praxisui/settings-panel": "^10.0.0-rc.17",
+    "@praxisui/visual-builder": "^10.0.0-rc.17",
+    "@praxisui/core": "^10.0.0-rc.17",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/types/praxisui-dynamic-form.d.ts

@@ -1016,6 +1016,8 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private entitySelectionCleared;
     private hydratedEntityId;
     private loadedEntityData;
+    private loadedEntityResourceVersion;
+    private entityVersionInvalidated;
     protected entityHydrationPending: boolean;
     protected entityReadFailed: boolean;
     protected entityReadText(key: 'loading' | 'error' | 'retry' | 'region' | 'success'): string;
@@ -1136,6 +1138,12 @@ declare class PraxisDynamicForm implements OnInit, OnChanges, OnDestroy {
     private resolveSubmitOperation;
     private buildSubmitRequest;
     private resolveSubmitResourceVersion;
+    private resolveCurrentEntityResourceVersion;
+    private unwrapAndCaptureSubmitResponse;
+    private captureUpdatedEntityResourceVersion;
+    private handleVersionedSubmitError;
+    private normalizeResourceVersionToken;
+    private extractResourceVersionCandidate;
     private normalizeSubmitMethod;
     private formatResourceVersion;
     private resolveSubmitHref;