@konitif/workbench-runtime 0.284.5 → 0.284.7

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/dist/index.d.ts CHANGED
@@ -10,3 +10,6 @@ export * from "./workbench/workbenchToolRuntimeActions.js";
10
10
  export * from "./workbench/workspaceHistoryController.js";
11
11
  export * from "./workbench/workspaceSyncController.js";
12
12
  export type { WorkbenchHostEvents, WorkbenchHostEventHandlers, WorkbenchHostStorageChange } from "./workbench/workbenchHostEvents.js";
13
+ export * from "./workbench/experienceTabLink.js";
14
+ export * from "./workbench/workbenchLibraryFolderRepository.js";
15
+ export * from "./workbench/workbenchAudioLibraryClient.js";
package/dist/index.js CHANGED
@@ -9,3 +9,6 @@ export * from "./workbench/workbenchShellActions.js";
9
9
  export * from "./workbench/workbenchToolRuntimeActions.js";
10
10
  export * from "./workbench/workspaceHistoryController.js";
11
11
  export * from "./workbench/workspaceSyncController.js";
12
+ export * from "./workbench/experienceTabLink.js";
13
+ export * from "./workbench/workbenchLibraryFolderRepository.js";
14
+ export * from "./workbench/workbenchAudioLibraryClient.js";
@@ -0,0 +1,14 @@
1
+ export declare function experienceTabHref(base: string, id: string, screen?: string): string;
2
+ export declare function requestedExperienceFromUrl(base: string): string | null;
3
+ export declare function requestedExperienceScreenFromUrl(base: string, experienceId: string): string | null;
4
+ export interface ExperienceScreenNavigationPort {
5
+ readHref(): string;
6
+ pushHref(href: string): void;
7
+ activate(screenId: string): boolean;
8
+ }
9
+ /** Bind screen navigation to an experience after its workspace has been restored. */
10
+ export declare function createExperienceScreenNavigation(experienceId: string, primaryScreenId: string, port: ExperienceScreenNavigationPort): {
11
+ href: (screenId: string) => string;
12
+ select(screenId: string): boolean;
13
+ restore(): boolean;
14
+ };
@@ -0,0 +1,52 @@
1
+ const valid = (id) => /^experience\.[a-zA-Z0-9._-]{1,140}$/.test(id);
2
+ const validScreen = (id) => /^[a-z0-9][a-z0-9-]{0,79}$/.test(id);
3
+ export function experienceTabHref(base, id, screen) {
4
+ if (!valid(id))
5
+ throw Error('Référence d’expérience invalide.');
6
+ if (screen !== undefined && !validScreen(screen))
7
+ throw Error('Référence d’écran invalide.');
8
+ const url = new URL(base);
9
+ if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
10
+ throw Error('Adresse Workbench invalide.');
11
+ url.searchParams.set('experience', id);
12
+ if (screen)
13
+ url.searchParams.set('screen', screen);
14
+ else
15
+ url.searchParams.delete('screen');
16
+ url.hash = '';
17
+ return url.href;
18
+ }
19
+ export function requestedExperienceFromUrl(base) {
20
+ const id = new URL(base).searchParams.get('experience');
21
+ return id && valid(id) ? id : null;
22
+ }
23
+ export function requestedExperienceScreenFromUrl(base, experienceId) {
24
+ const url = new URL(base);
25
+ const screen = url.searchParams.get('screen');
26
+ return url.searchParams.get('experience') === experienceId && screen && validScreen(screen) ? screen : null;
27
+ }
28
+ /** Bind screen navigation to an experience after its workspace has been restored. */
29
+ export function createExperienceScreenNavigation(experienceId, primaryScreenId, port) {
30
+ function href(screenId) {
31
+ return experienceTabHref(port.readHref(), experienceId, screenId);
32
+ }
33
+ return {
34
+ href,
35
+ select(screenId) {
36
+ if (!validScreen(screenId))
37
+ return false;
38
+ const destination = href(screenId);
39
+ if (!port.activate(screenId))
40
+ return false;
41
+ if (destination !== port.readHref())
42
+ port.pushHref(destination);
43
+ return true;
44
+ },
45
+ restore() {
46
+ const requested = requestedExperienceScreenFromUrl(port.readHref(), experienceId);
47
+ if (requested && port.activate(requested))
48
+ return true;
49
+ return port.activate(primaryScreenId);
50
+ }
51
+ };
52
+ }
@@ -0,0 +1,6 @@
1
+ /** HTTP adapter for a host's audio resource library. The host owns access and storage. */
2
+ export declare function createWorkbenchAudioLibraryClient<Resource>(baseUrl: string, request?: typeof fetch): {
3
+ list(trashed?: boolean): Promise<Resource[]>;
4
+ moveToTrash(id: string): Promise<void>;
5
+ restore(id: string): Promise<void>;
6
+ };
@@ -0,0 +1,32 @@
1
+ /** HTTP adapter for a host's audio resource library. The host owns access and storage. */
2
+ export function createWorkbenchAudioLibraryClient(baseUrl, request = fetch) {
3
+ const collection = baseUrl.replace(/\/$/, '') + '/api/audio-library';
4
+ async function responseJson(url, method = 'GET') {
5
+ const response = await request(url, { method });
6
+ const body = await response.json();
7
+ if (!response.ok) {
8
+ const message = body && typeof body === 'object' && 'message' in body
9
+ ? body.message
10
+ : undefined;
11
+ throw new Error(typeof message === 'string' ? message : response.statusText);
12
+ }
13
+ return body;
14
+ }
15
+ function resourceUrl(id) {
16
+ return collection + '/' + encodeURIComponent(id);
17
+ }
18
+ return {
19
+ async list(trashed = false) {
20
+ const result = await responseJson(trashed ? collection + '?trashed=1' : collection);
21
+ if (!Array.isArray(result))
22
+ throw new Error('Invalid audio library response.');
23
+ return result;
24
+ },
25
+ async moveToTrash(id) {
26
+ await responseJson(resourceUrl(id), 'DELETE');
27
+ },
28
+ async restore(id) {
29
+ await responseJson(resourceUrl(id) + '/restore', 'POST');
30
+ }
31
+ };
32
+ }
@@ -0,0 +1,5 @@
1
+ import { organizeExperienceLibraryResources, type LibraryFolders } from '@konitif/workbench/workspace-contracts';
2
+ export declare const readDurableLibraryFolders: () => Promise<LibraryFolders>;
3
+ export declare const changeDurableLibraryFolders: (change: (current: LibraryFolders) => LibraryFolders) => Promise<LibraryFolders>;
4
+ export declare function describeLibraryFolderError(cause: unknown): string;
5
+ export declare function placeExperienceLibraryResources(sources: Parameters<typeof organizeExperienceLibraryResources>[1], explicitExperienceId?: string): Promise<LibraryFolders | undefined>;
@@ -0,0 +1,67 @@
1
+ import { libraryFoldersKey, readLibraryFolders, organizeExperienceLibraryResources, moveLibraryResource } from '@konitif/workbench/workspace-contracts';
2
+ let connection;
3
+ function database() {
4
+ return connection ??= new Promise((resolve, reject) => {
5
+ if (typeof indexedDB === 'undefined') {
6
+ reject(Error('Le navigateur ne permet pas le stockage des dossiers.'));
7
+ return;
8
+ }
9
+ const request = indexedDB.open('konitif.library.organization.v1', 1);
10
+ request.onupgradeneeded = () => request.result.createObjectStore('organization');
11
+ request.onerror = () => { connection = undefined; reject(request.error ?? Error('Stockage des dossiers indisponible.')); };
12
+ request.onsuccess = () => { const db = request.result; db.onversionchange = () => { db.close(); connection = undefined; }; resolve(db); };
13
+ });
14
+ }
15
+ /** Atomic changes read the latest committed state, including changes from other tabs. */
16
+ async function transact(change) {
17
+ const db = await database();
18
+ return new Promise((resolve, reject) => {
19
+ const transaction = db.transaction('organization', 'readwrite'), store = transaction.objectStore('organization'), request = store.get('folders');
20
+ let result;
21
+ let failure;
22
+ request.onsuccess = () => {
23
+ try {
24
+ // Import the old small-storage value once; keep its original as a backup.
25
+ const current = readLibraryFolders(request.result === undefined ? localStorage.getItem(libraryFoldersKey) : JSON.stringify(request.result));
26
+ result = change ? change(current) : current;
27
+ readLibraryFolders(JSON.stringify(result));
28
+ if (change || request.result === undefined)
29
+ store.put(result, 'folders');
30
+ }
31
+ catch (cause) {
32
+ failure = cause;
33
+ transaction.abort();
34
+ }
35
+ };
36
+ transaction.oncomplete = () => resolve(result);
37
+ transaction.onabort = () => reject(failure ?? transaction.error ?? request.error ?? Error('Classement non enregistré.'));
38
+ transaction.onerror = () => { failure ??= transaction.error ?? request.error; };
39
+ });
40
+ }
41
+ export const readDurableLibraryFolders = () => transact();
42
+ export const changeDurableLibraryFolders = (change) => transact(change);
43
+ export function describeLibraryFolderError(cause) {
44
+ if (cause && typeof cause === 'object' && 'name' in cause && cause.name === 'QuotaExceededError')
45
+ return 'Le stockage du navigateur est plein. Le dossier ou le déplacement n’a pas été enregistré ; les ressources existantes sont conservées.';
46
+ return cause instanceof Error ? cause.message : 'Impossible d’enregistrer le classement.';
47
+ }
48
+ export async function placeExperienceLibraryResources(sources, explicitExperienceId) {
49
+ if (!sources.some(source => source.experienceAssets?.length))
50
+ return;
51
+ const value = await transact(current => {
52
+ const organized = organizeExperienceLibraryResources(current, sources);
53
+ if (!explicitExperienceId)
54
+ return organized;
55
+ return sources.reduce((next, source) => {
56
+ const folder = next.folders.find(item => item.experienceId === explicitExperienceId);
57
+ return folder && source.experienceAssets?.some(asset => asset.experienceId === explicitExperienceId) ?
58
+ moveLibraryResource(next, source.resourceKey ?? 'audio:' + source.id, folder.id) : next;
59
+ }, organized);
60
+ });
61
+ if (typeof BroadcastChannel !== 'undefined') {
62
+ const channel = new BroadcastChannel('konitif.library.organization');
63
+ channel.postMessage('changed');
64
+ channel.close();
65
+ }
66
+ return value;
67
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@konitif/workbench-runtime",
3
3
  "license": "PolyForm-Noncommercial-1.0.0",
4
- "version": "0.284.5",
4
+ "version": "0.284.7",
5
5
  "description": "Reactive Svelte host adapter for KONITIF Workbench contracts with explicit runtime ports.",
6
6
  "repository": {
7
7
  "type": "git",
@@ -42,7 +42,7 @@
42
42
  "verify:package": "node scripts/verify-package.mjs"
43
43
  },
44
44
  "dependencies": {
45
- "@konitif/workbench": "0.285.2",
45
+ "@konitif/workbench": "0.285.17",
46
46
  "svelte": "^4.2.18"
47
47
  },
48
48
  "devDependencies": {