@praxisui/files-upload 8.0.0-beta.11 → 8.0.0-beta.12

package/README.md

@@ -290,6 +290,13 @@ and the upload `strategy`. The direct, bulk and presign paths remain fixed as
 `baseUrl/upload`, `baseUrl/bulk` and `baseUrl/upload/presign?filename=...` so hosts
 do not create parallel endpoint semantics outside `FilesApiClient`.
 
+Every manifest operation declares its own editable target resolver, ambiguity policy,
+preconditions, validators, affected paths, effects and typed submission impact. Upload
+limits and accepted types are marked as submission-affecting; endpoint and security
+policy edits are marked as remote-binding changes and require confirmation; error
+messages are config-only; display changes are visual-only. These categories are the
+same metadata projected into `praxis-component-registry-ingestion.json`.
+
 ## Error handling
 
 `ErrorMapperService` translates backend error codes from `errors[0]` into user-facing messages and exposes rate limit information.

package/fesm2022/praxisui-files-upload.mjs

@@ -6565,18 +6565,6 @@ const FILES_UPLOAD_AI_CAPABILITIES = {
     ],
 };
 
-const conflictPolicyEnum = ['ERROR', 'SKIP', 'OVERWRITE', 'MAKE_UNIQUE', 'RENAME'];
-const displayModeEnum = ['full', 'compact'];
-const strategyEnum = ['direct', 'presign', 'auto'];
-const endpointInputSchema = {
-    type: 'object',
-    required: ['baseUrl'],
-    properties: {
-        baseUrl: { type: 'string' },
-        strategy: { enum: strategyEnum },
-        allowCrossOriginPresignedTarget: { type: 'boolean' },
-    },
-};
 const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
     schemaVersion: '1.0.0',
     componentId: 'praxis-files-upload',
@@ -6588,7 +6576,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
         { name: 'filesUploadId', type: 'string', description: 'Stable upload id used for config persistence and telemetry correlation.' },
         { name: 'componentInstanceId', type: 'string', description: 'Optional instance discriminator when the same upload id appears more than once.' },
         { name: 'baseUrl', type: 'string', description: 'Canonical files API base URL. Direct upload uses baseUrl/upload, bulk uses baseUrl/bulk and presign uses baseUrl/upload/presign.' },
-        { name: 'displayMode', type: "'full' | 'compact'", allowedValues: displayModeEnum, description: 'Runtime display mode input.' },
+        { name: 'displayMode', type: "'full' | 'compact'", allowedValues: ['full', 'compact'], description: 'Runtime display mode input.' },
         { name: 'context', type: 'Record<string, unknown>', description: 'Host context available to metadata and event consumers.' },
         { name: 'enableCustomization', type: 'boolean', description: 'Enables the Settings Panel configuration editor.' },
     ],
@@ -6623,9 +6611,11 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 { kind: 'set-value', path: 'options.allowedExtensions' },
                 { kind: 'set-value', path: 'options.acceptMimeTypes' },
             ],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['file-type-list-explicit', 'file-type-entry-valid', 'backend-accept-options-consistent', 'editor-runtime-round-trip'],
             affectedPaths: ['ui.accept', 'options.allowedExtensions', 'options.acceptMimeTypes'],
-            submissionImpact: true,
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
@@ -6646,9 +6636,11 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 { kind: 'set-value', path: 'limits.maxFileSizeBytes' },
                 { kind: 'set-value', path: 'options.maxUploadSizeMb' },
             ],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['size-limit-numeric', 'size-limit-within-platform-policy', 'size-limit-client-backend-consistent', 'editor-runtime-round-trip'],
             affectedPaths: ['limits.maxFileSizeBytes', 'options.maxUploadSizeMb'],
-            submissionImpact: true,
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
@@ -6669,9 +6661,11 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 { kind: 'set-value', path: 'limits.maxFilesPerBulk' },
                 { kind: 'set-value', path: 'limits.maxBulkSizeBytes' },
             ],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['file-count-limit-numeric', 'bulk-size-limit-numeric', 'bulk-limit-within-platform-policy', 'editor-runtime-round-trip'],
             affectedPaths: ['limits.maxFilesPerBulk', 'limits.maxBulkSizeBytes'],
-            submissionImpact: true,
+            submissionImpact: 'affects-submission',
             preconditions: ['config-initialized'],
         },
         {
@@ -6680,15 +6674,31 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             scope: 'global',
             targetKind: 'presignEndpoint',
             target: { kind: 'presignEndpoint', resolver: 'files-api-base-url-presign-contract', ambiguityPolicy: 'fail', required: false },
-            inputSchema: endpointInputSchema,
+            inputSchema: {
+                type: 'object',
+                required: ['baseUrl'],
+                properties: {
+                    baseUrl: { type: 'string' },
+                    strategy: { enum: ['direct', 'presign', 'auto'] },
+                    allowCrossOriginPresignedTarget: { type: 'boolean' },
+                },
+            },
             effects: [{
                     kind: 'compile-domain-patch',
                     handler: 'files-upload-presign-base-url',
                     handlerContract: {
-                        reads: ['baseUrl', 'strategy', 'config.strategy'],
-                        writes: ['baseUrl', 'config.strategy'],
+                        reads: ['baseUrl', 'strategy'],
+                        writes: ['baseUrl', 'strategy'],
                         identityKeys: ['baseUrl'],
-                        inputSchema: endpointInputSchema,
+                        inputSchema: {
+                            type: 'object',
+                            required: ['baseUrl'],
+                            properties: {
+                                baseUrl: { type: 'string' },
+                                strategy: { enum: ['direct', 'presign', 'auto'] },
+                                allowCrossOriginPresignedTarget: { type: 'boolean' },
+                            },
+                        },
                         failureModes: ['unsafe-url', 'non-praxis-backend-surface', 'presign-path-override', 'cross-origin-presigned-fields-leak'],
                         description: 'Validates the files API base URL and preserves the canonical POST baseUrl/upload/presign?filename=... contract; arbitrary presign URLs are rejected.',
                     },
@@ -6697,7 +6707,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             requiresConfirmation: true,
             validators: ['endpoint-url-safe', 'endpoint-uses-praxis-backend-surface', 'presign-endpoint-fixed-contract', 'presign-cross-origin-fields-safe', 'security-change-confirmed'],
             affectedPaths: ['baseUrl', 'strategy'],
-            submissionImpact: true,
+            submissionImpact: 'affects-remote-binding',
             preconditions: ['config-initialized', 'confirmation-collected'],
         },
         {
@@ -6706,15 +6716,31 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             scope: 'global',
             targetKind: 'uploadEndpoint',
             target: { kind: 'uploadEndpoint', resolver: 'files-api-base-url-upload-contract', ambiguityPolicy: 'fail', required: false },
-            inputSchema: endpointInputSchema,
+            inputSchema: {
+                type: 'object',
+                required: ['baseUrl'],
+                properties: {
+                    baseUrl: { type: 'string' },
+                    strategy: { enum: ['direct', 'presign', 'auto'] },
+                    allowCrossOriginPresignedTarget: { type: 'boolean' },
+                },
+            },
             effects: [{
                     kind: 'compile-domain-patch',
                     handler: 'files-upload-direct-base-url',
                     handlerContract: {
-                        reads: ['baseUrl', 'strategy', 'config.strategy'],
-                        writes: ['baseUrl', 'config.strategy'],
+                        reads: ['baseUrl', 'strategy'],
+                        writes: ['baseUrl', 'strategy'],
                         identityKeys: ['baseUrl'],
-                        inputSchema: endpointInputSchema,
+                        inputSchema: {
+                            type: 'object',
+                            required: ['baseUrl'],
+                            properties: {
+                                baseUrl: { type: 'string' },
+                                strategy: { enum: ['direct', 'presign', 'auto'] },
+                                allowCrossOriginPresignedTarget: { type: 'boolean' },
+                            },
+                        },
                         failureModes: ['unsafe-url', 'non-praxis-backend-surface', 'upload-path-override', 'bulk-path-override'],
                         description: 'Validates the files API base URL and preserves the canonical POST baseUrl/upload and POST baseUrl/bulk contracts.',
                     },
@@ -6723,7 +6749,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             requiresConfirmation: true,
             validators: ['endpoint-url-safe', 'endpoint-uses-praxis-backend-surface', 'upload-endpoint-fixed-contract', 'bulk-endpoint-fixed-contract', 'security-change-confirmed'],
             affectedPaths: ['baseUrl', 'strategy'],
-            submissionImpact: true,
+            submissionImpact: 'affects-remote-binding',
             preconditions: ['config-initialized', 'confirmation-collected'],
         },
         {
@@ -6737,7 +6763,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 properties: {
                     strictValidation: { type: 'boolean' },
                     enableVirusScanning: { type: 'boolean' },
-                    defaultConflictPolicy: { enum: conflictPolicyEnum },
+                    defaultConflictPolicy: { enum: ['ERROR', 'SKIP', 'OVERWRITE', 'MAKE_UNIQUE', 'RENAME'] },
                     targetDirectory: { type: 'string' },
                     showQuotaWarnings: { type: 'boolean' },
                     blockOnExceed: { type: 'boolean' },
@@ -6759,7 +6785,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             requiresConfirmation: true,
             validators: ['security-change-confirmed', 'security-policy-compatible', 'target-directory-safe', 'conflict-policy-valid', 'quota-rate-policy-valid', 'header-names-safe', 'editor-runtime-round-trip'],
             affectedPaths: ['options.strictValidation', 'options.enableVirusScanning', 'options.defaultConflictPolicy', 'options.targetDirectory', 'quotas', 'rateLimit', 'headers'],
-            submissionImpact: true,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized', 'confirmation-collected'],
         },
         {
@@ -6777,9 +6803,11 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 },
             },
             effects: [{ kind: 'merge-object', path: 'messages.errors' }],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['error-code-known', 'error-message-i18n-compatible', 'message-not-empty', 'editor-runtime-round-trip'],
             affectedPaths: ['messages.errors'],
-            submissionImpact: false,
+            submissionImpact: 'config-only',
             preconditions: ['config-initialized'],
         },
         {
@@ -6791,7 +6819,7 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
             inputSchema: {
                 type: 'object',
                 properties: {
-                    displayMode: { enum: displayModeEnum },
+                    displayMode: { enum: ['full', 'compact'] },
                     dense: { type: 'boolean' },
                     showDropzone: { type: 'boolean' },
                     showProgress: { type: 'boolean' },
@@ -6804,9 +6832,11 @@ const PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST = {
                 { kind: 'set-value', path: 'displayMode' },
                 { kind: 'merge-object', path: 'ui' },
             ],
+            destructive: false,
+            requiresConfirmation: false,
             validators: ['display-mode-valid', 'display-ui-compatible', 'editor-runtime-round-trip'],
             affectedPaths: ['displayMode', 'ui.dense', 'ui.showDropzone', 'ui.showProgress', 'ui.manualUpload', 'ui.showMetadataForm', 'ui.showConflictPolicySelector'],
-            submissionImpact: false,
+            submissionImpact: 'visual-only',
             preconditions: ['config-initialized'],
         },
     ],

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/files-upload",
-  "version": "8.0.0-beta.11",
+  "version": "8.0.0-beta.12",
   "description": "File upload components and services for Praxis UI with presigned and direct strategies, quotas and rate-limit handling.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/cdk": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/material": "^20.0.0",
-    "@praxisui/core": "^8.0.0-beta.11",
-    "@praxisui/dynamic-fields": "^8.0.0-beta.11",
-    "@praxisui/settings-panel": "^8.0.0-beta.11"
+    "@praxisui/core": "^8.0.0-beta.12",
+    "@praxisui/dynamic-fields": "^8.0.0-beta.12",
+    "@praxisui/settings-panel": "^8.0.0-beta.12"
   },
   "dependencies": {
     "tslib": "^2.3.0"