Import src/client/open-folder.ts
This commit is contained in:
parent
3f9cdf095b
commit
a5849d4f67
|
|
@ -0,0 +1,79 @@
|
|||
/**
|
||||
* Transport for the official open-in-app host routes served by
|
||||
* `@deepseek-ai/dsh-host-open-in-app`. The project row offers "open this
|
||||
* project's folder" by asking that host half for the applications it verified
|
||||
* as installed, then POSTing the launcher it already resolved — this plugin
|
||||
* never probes or spawns a launcher itself, and a host without the capability
|
||||
* (no resolved application, e.g. an SSH launch) simply yields no menu entry.
|
||||
*/
|
||||
|
||||
/** GET route serving the probed application ids (host-owned constant). */
|
||||
export const OPEN_IN_APP_APPS_ROUTE = '/open-in-app/apps'
|
||||
|
||||
/** POST route launching one resolved application on one absolute directory. */
|
||||
export const OPEN_IN_APP_OPEN_ROUTE = '/open-in-app/open'
|
||||
|
||||
/**
|
||||
* Catalog ids that open a directory in the platform file manager, most
|
||||
* specific first (the official catalog names one per platform: `explorer` on
|
||||
* Windows, `finder` on macOS, `filemanager` on Linux).
|
||||
*/
|
||||
const FOLDER_APP_IDS = ['explorer', 'finder', 'filemanager'] as const
|
||||
|
||||
/**
|
||||
* The installed file-manager id for this host, or undefined when the host
|
||||
* resolved none (the row then offers no "open in folder" entry).
|
||||
* @param apps - installed catalog ids from the apps route.
|
||||
* @returns the preferred available id.
|
||||
*/
|
||||
export function folderAppId(apps: readonly string[]): string | undefined {
|
||||
for (const id of FOLDER_APP_IDS) {
|
||||
if (apps.includes(id)) return id
|
||||
}
|
||||
return undefined
|
||||
}
|
||||
|
||||
/**
|
||||
* Resolve the browser's Host base with the connection carrier's null-origin
|
||||
* fallback (same rule the official button uses): a sandboxed document reports
|
||||
* the literal origin "null", which cannot address the host.
|
||||
* @returns the absolute base URL of the current Host.
|
||||
*/
|
||||
function hostBase(): string {
|
||||
const origin = globalThis.location?.origin
|
||||
return origin !== undefined && origin !== 'null' ? origin : 'http://dsh.internal'
|
||||
}
|
||||
|
||||
/**
|
||||
* Read the host's installed-application ids. A host without the capability
|
||||
* (or one that refuses) reads as an empty list rather than an error, so the
|
||||
* caller can treat "no apps" and "no route" identically.
|
||||
* @param signal - aborts the read when the browser half unmounts.
|
||||
* @returns installed catalog ids, in host menu order.
|
||||
*/
|
||||
export async function fetchOpenInApps(signal?: AbortSignal): Promise<readonly string[]> {
|
||||
const response = await fetch(new URL(OPEN_IN_APP_APPS_ROUTE, hostBase()), {
|
||||
headers: { accept: 'application/json' },
|
||||
cache: 'no-store',
|
||||
...(signal === undefined ? {} : { signal }),
|
||||
})
|
||||
if (!response.ok) throw new Error(`open-in-app apps request failed: ${response.status}`)
|
||||
const payload: unknown = await response.json()
|
||||
const apps = (payload as { apps?: unknown }).apps
|
||||
return Array.isArray(apps) ? apps.filter((id): id is string => typeof id === 'string') : []
|
||||
}
|
||||
|
||||
/**
|
||||
* Launch one installed application on one absolute directory.
|
||||
* @param appId - catalog id from the apps route.
|
||||
* @param path - the project's absolute directory.
|
||||
* @returns after the host acknowledged the launch; rejects on any refusal.
|
||||
*/
|
||||
export async function openPathInApp(appId: string, path: string): Promise<void> {
|
||||
const response = await fetch(new URL(OPEN_IN_APP_OPEN_ROUTE, hostBase()), {
|
||||
method: 'POST',
|
||||
headers: { 'Content-Type': 'application/json' },
|
||||
body: JSON.stringify({ app: appId, path }),
|
||||
})
|
||||
if (!response.ok) throw new Error(`open-in-app launch failed: ${response.status}`)
|
||||
}
|
||||
Loading…
Reference in New Issue