@svadmin/core 0.74.0 → 0.75.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.
- package/package.json +1 -1
- package/src/context.svelte.ts +28 -0
- package/src/index.ts +11 -0
- package/src/provider-bundle.ts +2 -0
- package/src/storage-contract.ts +40 -0
- package/src/storage-hooks.svelte.ts +86 -0
package/package.json
CHANGED
package/src/context.svelte.ts
CHANGED
|
@@ -4,6 +4,7 @@ import { definedOptions } from './defined-options';
|
|
|
4
4
|
|
|
5
5
|
import { createContext } from 'svelte';
|
|
6
6
|
import type { DataProvider,AuthProvider,ResourceDefinition,TaskProvider } from './types';
|
|
7
|
+
import type { StorageProvider } from './storage-contract';
|
|
7
8
|
import type { RouterProvider } from './router-provider';
|
|
8
9
|
import type { LiveProvider } from './live.svelte';
|
|
9
10
|
import type { RegisteredAccessControlProvider } from './permissions.svelte';
|
|
@@ -90,6 +91,7 @@ export interface AdminContextValue {
|
|
|
90
91
|
readonly identityGovernanceProvider: ProviderBundle['identityGovernanceProvider'];
|
|
91
92
|
readonly sessionProvider: ProviderBundle['sessionProvider'];
|
|
92
93
|
readonly credentialProvider: ProviderBundle['credentialProvider'];
|
|
94
|
+
readonly storageProvider: StorageProvider|null|undefined;
|
|
93
95
|
readonly tenant: TenantContext|undefined;
|
|
94
96
|
readonly tenantAdapter: TenantAdapter|undefined;
|
|
95
97
|
}
|
|
@@ -119,6 +121,7 @@ export interface AdminContextAccessor {
|
|
|
119
121
|
readonly identityGovernanceProvider: ProviderBundle['identityGovernanceProvider'];
|
|
120
122
|
readonly sessionProvider: ProviderBundle['sessionProvider'];
|
|
121
123
|
readonly credentialProvider: ProviderBundle['credentialProvider'];
|
|
124
|
+
readonly storageProvider: StorageProvider|null|undefined;
|
|
122
125
|
readonly tenant: TenantContext|undefined;
|
|
123
126
|
readonly tenantAdapter: TenantAdapter|undefined;
|
|
124
127
|
readonly tenantCacheKey: TenantCacheKey|undefined;
|
|
@@ -196,6 +199,9 @@ function resolveProviderBundle(source: AdminContextSource): ResolvedProviderBund
|
|
|
196
199
|
credentialProvider: source.credentialProvider!==undefined
|
|
197
200
|
? source.credentialProvider
|
|
198
201
|
:bundled?.credentialProvider,
|
|
202
|
+
storageProvider: source.storageProvider!==undefined
|
|
203
|
+
? source.storageProvider
|
|
204
|
+
:bundled?.storageProvider,
|
|
199
205
|
}));
|
|
200
206
|
}
|
|
201
207
|
|
|
@@ -218,6 +224,7 @@ export function createAdminContext(source: AdminContextSource): AdminContextValu
|
|
|
218
224
|
get identityGovernanceProvider() { return resolveProviderBundle(source).identityGovernanceProvider??null; },
|
|
219
225
|
get sessionProvider() { return resolveProviderBundle(source).sessionProvider??null; },
|
|
220
226
|
get credentialProvider() { return resolveProviderBundle(source).credentialProvider??null; },
|
|
227
|
+
get storageProvider() { return resolveProviderBundle(source).storageProvider??null; },
|
|
221
228
|
get tenant() { return source.tenant??inheritedTenant; },
|
|
222
229
|
get tenantAdapter() { return resolveProviderBundle(source).tenantAdapter; },
|
|
223
230
|
});
|
|
@@ -270,6 +277,7 @@ export function captureAdminContext(): AdminContextAccessor {
|
|
|
270
277
|
chatProvider: getLegacyChatProvider(),
|
|
271
278
|
agentProvider: getLegacyAgentProvider(),
|
|
272
279
|
taskProvider: taskProviderState,
|
|
280
|
+
storageProvider: storageProviderState,
|
|
273
281
|
routerProvider,
|
|
274
282
|
}));
|
|
275
283
|
},
|
|
@@ -292,6 +300,7 @@ export function captureAdminContext(): AdminContextAccessor {
|
|
|
292
300
|
get identityGovernanceProvider() { return scopedContext?.identityGovernanceProvider??null; },
|
|
293
301
|
get sessionProvider() { return scopedContext?.sessionProvider??null; },
|
|
294
302
|
get credentialProvider() { return scopedContext?.credentialProvider??null; },
|
|
303
|
+
get storageProvider() { return scopedContext? scopedContext.storageProvider:storageProviderState; },
|
|
295
304
|
get tenant() { return scopedContext?.tenant; },
|
|
296
305
|
get tenantAdapter() { return scopedContext?.tenantAdapter; },
|
|
297
306
|
get tenantCacheKey() {
|
|
@@ -518,6 +527,24 @@ export function getTaskProvider(options?: { optional?: boolean }): TaskProvider|
|
|
|
518
527
|
return activeTaskProvider;
|
|
519
528
|
}
|
|
520
529
|
|
|
530
|
+
// ─── Storage Provider ───────────────────────────────────────────
|
|
531
|
+
|
|
532
|
+
let storageProviderState=$state<StorageProvider|undefined>(undefined);
|
|
533
|
+
|
|
534
|
+
export function setStorageProvider(provider: StorageProvider|undefined): void {
|
|
535
|
+
storageProviderState=provider;
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
export function getStorageProvider(): StorageProvider;
|
|
539
|
+
export function getStorageProvider(options: { optional: true }): StorageProvider|undefined;
|
|
540
|
+
export function getStorageProvider(options?: { optional?: boolean }): StorageProvider|undefined {
|
|
541
|
+
const activeStorageProvider=captureAdminContext().storageProvider;
|
|
542
|
+
if(!activeStorageProvider&&!options?.optional) {
|
|
543
|
+
throw new Error('StorageProvider not found. Did you call setStorageProvider in App.svelte?');
|
|
544
|
+
}
|
|
545
|
+
return activeStorageProvider??undefined;
|
|
546
|
+
}
|
|
547
|
+
|
|
521
548
|
// ─── Reset — for testing / HMR ─────────────────────────────────
|
|
522
549
|
|
|
523
550
|
export function resetContext(): void {
|
|
@@ -527,6 +554,7 @@ export function resetContext(): void {
|
|
|
527
554
|
routerProvider=undefined;
|
|
528
555
|
liveProviderState=undefined;
|
|
529
556
|
taskProviderState=undefined;
|
|
557
|
+
storageProviderState=undefined;
|
|
530
558
|
resetNotificationProvider();
|
|
531
559
|
resetAuditLogProvider();
|
|
532
560
|
resetAccessControlProvider();
|
package/src/index.ts
CHANGED
|
@@ -9,6 +9,7 @@ export {
|
|
|
9
9
|
setRouterProvider, getRouterProvider,
|
|
10
10
|
setLiveProvider, getLiveProvider,
|
|
11
11
|
setTaskProvider, getTaskProvider,
|
|
12
|
+
setStorageProvider, getStorageProvider,
|
|
12
13
|
createAdminContext, provideAdminContext, getAdminContext, captureAdminContext,
|
|
13
14
|
provideTenantContext, getTenantContext, getProviderBundle,
|
|
14
15
|
resetContext,
|
|
@@ -480,3 +481,13 @@ export type {
|
|
|
480
481
|
RetryOptions,
|
|
481
482
|
SafeDataProvider,
|
|
482
483
|
} from './resilience';
|
|
484
|
+
|
|
485
|
+
export { useStorage } from './storage-hooks.svelte';
|
|
486
|
+
export type {
|
|
487
|
+
StorageProvider,
|
|
488
|
+
StorageUploadOptions,
|
|
489
|
+
StorageUploadResult,
|
|
490
|
+
StoragePresignedUrlOptions,
|
|
491
|
+
StorageFileItem,
|
|
492
|
+
StorageListOptions,
|
|
493
|
+
} from './storage-contract';
|
package/src/provider-bundle.ts
CHANGED
|
@@ -40,6 +40,7 @@ import type {
|
|
|
40
40
|
UpdateParams,
|
|
41
41
|
UpdateResult,
|
|
42
42
|
} from './types';
|
|
43
|
+
import type { StorageProvider } from './storage-contract';
|
|
43
44
|
|
|
44
45
|
export type DataProviderInput=DataProvider|Record<string,DataProvider>;
|
|
45
46
|
|
|
@@ -63,6 +64,7 @@ export interface ProviderBundle {
|
|
|
63
64
|
readonly identityGovernanceProvider?: IdentityGovernanceProvider|null;
|
|
64
65
|
readonly sessionProvider?: SessionProvider|null;
|
|
65
66
|
readonly credentialProvider?: CredentialProvider|null;
|
|
67
|
+
readonly storageProvider?: StorageProvider|null;
|
|
66
68
|
}
|
|
67
69
|
|
|
68
70
|
/** Preserves the input object's exact type while applying compile-time ProviderBundle validation. */
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
export interface StorageUploadOptions {
|
|
2
|
+
path?: string;
|
|
3
|
+
filename?: string;
|
|
4
|
+
contentType?: string;
|
|
5
|
+
metadata?: Record<string, string>;
|
|
6
|
+
onProgress?: (progress: { loaded: number; total: number; percentage: number }) => void;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export interface StorageUploadResult {
|
|
10
|
+
url: string;
|
|
11
|
+
path: string;
|
|
12
|
+
size?: number;
|
|
13
|
+
contentType?: string;
|
|
14
|
+
metadata?: Record<string, string>;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export interface StoragePresignedUrlOptions {
|
|
18
|
+
expiresInSeconds?: number;
|
|
19
|
+
operation?: 'get' | 'put';
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface StorageFileItem {
|
|
23
|
+
name: string;
|
|
24
|
+
path: string;
|
|
25
|
+
size?: number;
|
|
26
|
+
lastModified?: string | Date;
|
|
27
|
+
url?: string;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export interface StorageListOptions {
|
|
31
|
+
prefix?: string;
|
|
32
|
+
limit?: number;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export interface StorageProvider {
|
|
36
|
+
upload(file: File | Blob | ArrayBuffer | Uint8Array, options?: StorageUploadOptions): Promise<StorageUploadResult>;
|
|
37
|
+
delete(path: string): Promise<void>;
|
|
38
|
+
getPresignedUrl?(path: string, options?: StoragePresignedUrlOptions): Promise<string>;
|
|
39
|
+
list?(options?: StorageListOptions): Promise<StorageFileItem[]>;
|
|
40
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import { captureAdminContext } from './context.svelte';
|
|
2
|
+
import type {
|
|
3
|
+
StorageUploadOptions,
|
|
4
|
+
StorageUploadResult,
|
|
5
|
+
StorageFileItem,
|
|
6
|
+
StorageListOptions,
|
|
7
|
+
} from './storage-contract';
|
|
8
|
+
|
|
9
|
+
export function useStorage() {
|
|
10
|
+
const context = captureAdminContext();
|
|
11
|
+
const provider = context.storageProvider;
|
|
12
|
+
|
|
13
|
+
let isUploading = $state(false);
|
|
14
|
+
let uploadProgress = $state(0);
|
|
15
|
+
let error = $state<Error | null>(null);
|
|
16
|
+
|
|
17
|
+
async function upload(
|
|
18
|
+
file: File | Blob | ArrayBuffer | Uint8Array,
|
|
19
|
+
options?: StorageUploadOptions,
|
|
20
|
+
): Promise<StorageUploadResult> {
|
|
21
|
+
if (!provider) {
|
|
22
|
+
throw new Error('StorageProvider not configured. Set storageProvider in context or call setStorageProvider().');
|
|
23
|
+
}
|
|
24
|
+
isUploading = true;
|
|
25
|
+
uploadProgress = 0;
|
|
26
|
+
error = null;
|
|
27
|
+
try {
|
|
28
|
+
const result = await provider.upload(file, {
|
|
29
|
+
...options,
|
|
30
|
+
onProgress: (p) => {
|
|
31
|
+
uploadProgress = p.percentage;
|
|
32
|
+
options?.onProgress?.(p);
|
|
33
|
+
},
|
|
34
|
+
});
|
|
35
|
+
return result;
|
|
36
|
+
} catch (err) {
|
|
37
|
+
error = err instanceof Error ? err : new Error(String(err));
|
|
38
|
+
throw err;
|
|
39
|
+
} finally {
|
|
40
|
+
isUploading = false;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
async function deleteFile(path: string): Promise<void> {
|
|
45
|
+
if (!provider) {
|
|
46
|
+
throw new Error('StorageProvider not configured.');
|
|
47
|
+
}
|
|
48
|
+
return provider.delete(path);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
async function getDownloadUrl(path: string, options?: { expiresInSeconds?: number }): Promise<string> {
|
|
52
|
+
if (!provider) {
|
|
53
|
+
throw new Error('StorageProvider not configured.');
|
|
54
|
+
}
|
|
55
|
+
if (provider.getPresignedUrl) {
|
|
56
|
+
return provider.getPresignedUrl(path, { operation: 'get', ...options });
|
|
57
|
+
}
|
|
58
|
+
return path;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
async function listFiles(options?: StorageListOptions): Promise<StorageFileItem[]> {
|
|
62
|
+
if (!provider?.list) {
|
|
63
|
+
return [];
|
|
64
|
+
}
|
|
65
|
+
return provider.list(options);
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
return {
|
|
69
|
+
get provider() {
|
|
70
|
+
return provider;
|
|
71
|
+
},
|
|
72
|
+
get isUploading() {
|
|
73
|
+
return isUploading;
|
|
74
|
+
},
|
|
75
|
+
get uploadProgress() {
|
|
76
|
+
return uploadProgress;
|
|
77
|
+
},
|
|
78
|
+
get error() {
|
|
79
|
+
return error;
|
|
80
|
+
},
|
|
81
|
+
upload,
|
|
82
|
+
deleteFile,
|
|
83
|
+
getDownloadUrl,
|
|
84
|
+
listFiles,
|
|
85
|
+
};
|
|
86
|
+
}
|