@brftech/filex-core 0.19.0 → 0.20.0

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.
Files changed (39) hide show
  1. package/README.md +34 -4
  2. package/dist/filex-core.js +10626 -6501
  3. package/dist/filex-core.js.map +1 -1
  4. package/dist/filex-core.umd.cjs +94 -63
  5. package/dist/filex-core.umd.cjs.map +1 -1
  6. package/dist/index.d.ts +1026 -7
  7. package/dist/style.css +1 -1
  8. package/package.json +3 -3
  9. package/src/FileExplorer.vue +103 -68
  10. package/src/components/ConnectionGuideView.vue +333 -0
  11. package/src/components/ConnectionsPanel.vue +912 -0
  12. package/src/components/NFSExportsPanel.vue +283 -0
  13. package/src/components/S3KeysPanel.vue +381 -0
  14. package/src/components/SSHKeysPanel.vue +222 -0
  15. package/src/components/StorageFields.vue +362 -0
  16. package/src/components/TokensPanel.vue +191 -0
  17. package/src/components/UploadProgress.vue +5 -1
  18. package/src/composables/useConnections.ts +271 -0
  19. package/src/composables/useFileApi.ts +15 -2
  20. package/src/composables/useNFSExports.ts +148 -0
  21. package/src/composables/useS3Keys.ts +175 -0
  22. package/src/composables/useSSHKeys.ts +119 -0
  23. package/src/composables/useThumbs.ts +1 -1
  24. package/src/composables/useTokens.ts +121 -0
  25. package/src/composables/useUploadChunked.ts +433 -164
  26. package/src/index.ts +77 -2
  27. package/src/lib/connectionGuides.ts +1279 -0
  28. package/src/lib/realtime.ts +1 -1
  29. package/src/lib/uploadResume.ts +157 -0
  30. package/src/locales/en.ts +413 -0
  31. package/src/locales/tr.ts +416 -0
  32. package/src/modals/ConvertModal.vue +1 -1
  33. package/src/styles/base.css +12 -12
  34. package/src/types/Connections.ts +122 -0
  35. package/src/types/ExplorerConfig.ts +23 -2
  36. package/src/types/NFSExports.ts +47 -0
  37. package/src/types/S3Keys.ts +55 -0
  38. package/src/types/SSHKeys.ts +54 -0
  39. package/src/types/Tokens.ts +39 -0
package/README.md CHANGED
@@ -2,10 +2,10 @@
2
2
 
3
3
  # @brftech/filex-core
4
4
 
5
- Vue 3 source of truth for the **filex** file manager. Ships a single
6
- `<FileExplorer>` SFC, the composables that drive it, and the type
7
- definitions consumers (Vue apps, the `@brftech/filex` Web Component
8
- wrapper, the `@brftech/filex-react` adapter) build against.
5
+ Vue 3 source of truth for the **filex** file manager. Ships the
6
+ `<FileExplorer>` SFC, the `<ConnectionsPanel>` surface, the composables that
7
+ drive them, and the type definitions consumers (Vue apps, the `@brftech/filex`
8
+ Web Component wrapper, the `@brftech/filex-react` adapter) build against.
9
9
 
10
10
  > Looking for a drop-in `<filex-explorer>` HTML tag? Use
11
11
  > [`@brftech/filex`](https://www.npmjs.com/package/@brftech/filex).
@@ -91,6 +91,36 @@ import {
91
91
  The composables are stable — feel free to compose your own UI without
92
92
  touching the SFC.
93
93
 
94
+ ### Connections
95
+
96
+ A second surface, for reaching the same server *without* a browser. filex can
97
+ be spoken to as **S3**, **SFTP**, **FTPS**, **NFSv3** and **WebDAV**, and
98
+ mounted with `filex mount`; `<ConnectionsPanel>` is where a user manages
99
+ storages, mints the credential each protocol takes, and reads instructions
100
+ built from *this* deployment — its host, its port, their login — rather than a
101
+ template with angle brackets in it.
102
+
103
+ ```ts
104
+ import {
105
+ ConnectionsPanel, // the whole surface: storages + guides
106
+ S3KeysPanel, // or mount the pieces yourself
107
+ SSHKeysPanel,
108
+ NFSExportsPanel,
109
+ TokensPanel, // FTPS / WebDAV / filex mount sign in with a token
110
+ ConnectionGuideView,
111
+ buildGuide, guideProtocols, guideName,
112
+ useS3Keys, useSSHKeys, useNFSExports, useTokens,
113
+ type ProtocolGuide, type ApiToken,
114
+ } from '@brftech/filex-core';
115
+ ```
116
+
117
+ ⚠ Mount the panel, not a copy of it. The admin panel, the web explorer and the
118
+ filex desktop app all render **this** component — a surface that mints
119
+ credentials one of them cannot see or revoke is the failure mode the shared
120
+ package exists to prevent.
121
+
122
+ See [docs/PROTOCOLS.md](https://github.com/BRF-Tech/filex/blob/main/docs/PROTOCOLS.md).
123
+
94
124
  ## Build
95
125
 
96
126
  ```bash