@praxisui/files-upload 8.0.0-beta.4 → 8.0.0-beta.41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -0
- package/fesm2022/praxisui-files-upload.mjs +2771 -2171
- package/package.json +16 -11
- package/{index.d.ts → types/praxisui-files-upload.d.ts} +41 -5
package/README.md
CHANGED
|
@@ -271,6 +271,32 @@ const cfg: FilesUploadConfig = {
|
|
|
271
271
|
- `maxFilesPerBulkValidator`
|
|
272
272
|
- `maxBulkSizeValidator`
|
|
273
273
|
|
|
274
|
+
## Agentic Authoring Contract
|
|
275
|
+
|
|
276
|
+
`@praxisui/files-upload` publishes an executable `ComponentAuthoringManifest` through
|
|
277
|
+
`PRAXIS_FILES_UPLOAD_AUTHORING_MANIFEST`.
|
|
278
|
+
|
|
279
|
+
The contract exposes typed operation families for:
|
|
280
|
+
|
|
281
|
+
- accepted types: `accept.types.set`
|
|
282
|
+
- single-file and batch limits: `limit.fileSize.set`, `limit.fileCount.set`
|
|
283
|
+
- backend upload surfaces: `endpoint.presign.set`, `endpoint.upload.set`
|
|
284
|
+
- upload policy: `security.policy.set`
|
|
285
|
+
- error message overrides: `message.error.set`
|
|
286
|
+
- display mode and UI flags: `display.mode.set`
|
|
287
|
+
|
|
288
|
+
Endpoint authoring intentionally changes only the canonical `baseUrl` runtime input
|
|
289
|
+
and the upload `strategy`. The direct, bulk and presign paths remain fixed as
|
|
290
|
+
`baseUrl/upload`, `baseUrl/bulk` and `baseUrl/upload/presign?filename=...` so hosts
|
|
291
|
+
do not create parallel endpoint semantics outside `FilesApiClient`.
|
|
292
|
+
|
|
293
|
+
Every manifest operation declares its own editable target resolver, ambiguity policy,
|
|
294
|
+
preconditions, validators, affected paths, effects and typed submission impact. Upload
|
|
295
|
+
limits and accepted types are marked as submission-affecting; endpoint and security
|
|
296
|
+
policy edits are marked as remote-binding changes and require confirmation; error
|
|
297
|
+
messages are config-only; display changes are visual-only. These categories are the
|
|
298
|
+
same metadata projected into `praxis-component-registry-ingestion.json`.
|
|
299
|
+
|
|
274
300
|
## Error handling
|
|
275
301
|
|
|
276
302
|
`ErrorMapperService` translates backend error codes from `errors[0]` into user-facing messages and exposes rate limit information.
|