@dsh-plugin/dsh-loader 1.0.0 → 1.1.0-dev.32278873528

package/dist/setup.js

@@ -0,0 +1,119 @@
+// One-shot profile injection script (design.md §3.6 / §6 / M6).
+//
+// `dshloader setup <profile>`:
+//   - adds `@dsh-plugin/dsh-loader` to the profile package.json dependencies
+//     (if missing);
+//   - appends the dshloader `insert` entry to cordis.patch.yml (if missing);
+//   - does NOT reorder the insert list — cordis is reactive DI, so position
+//     does not affect whether service aliases / module redirects take effect
+//     (design.md §1.2 / §6.2).
+//
+// `dshloader dump-config <profile>`: best-effort validation that runs
+// `dsh --profile <name> --dump-config` when the dsh CLI is available.
+//
+// `dshloader info [profile]`: prints dshloader version, detected dsh version,
+// selected adapter, and registered aliases (AC-OB-03, P2 — minimal).
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { LOADER_VERSION, LOG_PREFIX } from './version.js';
+import { detectDshVersion, AdapterRegistry } from './registry.js';
+import { registerHostAdapters } from './adapters/index.js';
+const LOADER_PKG = '@dsh-plugin/dsh-loader';
+const PATCH_ENTRY = `- id: dsh-loader\n      name: '${LOADER_PKG}'`;
+export function dshHome() {
+    const env = process.env.DSH_HOME?.trim();
+    return env ? resolve(env) : join(process.env.HOME ?? '~', '.dsh');
+}
+export function profileDir(profileName) {
+    return join(dshHome(), 'profiles', profileName);
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(path, data) {
+    writeFileSync(path, JSON.stringify(data, undefined, 2) + '\n');
+}
+/** Ensure dshloader is listed in the profile package.json dependencies. */
+export function injectDependency(pkgPath) {
+    const manifest = readJson(pkgPath) ?? { name: '', dependencies: {} };
+    manifest.dependencies = manifest.dependencies ?? {};
+    if (manifest.dependencies[LOADER_PKG] === undefined) {
+        manifest.dependencies[LOADER_PKG] = '^' + LOADER_VERSION;
+        writeJson(pkgPath, manifest);
+        return { added: true, manifest };
+    }
+    return { added: false, manifest };
+}
+/** Ensure the dshloader insert entry exists in cordis.patch.yml (no reorder). */
+export function injectPatch(patchPath) {
+    let text = '';
+    try {
+        text = readFileSync(patchPath, 'utf8');
+    }
+    catch {
+        text = '';
+    }
+    if (text.includes('id: dsh-loader')) {
+        return { added: false, text };
+    }
+    const insertion = `- insert:\n    ${PATCH_ENTRY}\n`;
+    const next = text.length === 0 ? insertion : text.endsWith('\n') ? text + insertion : text + '\n' + insertion;
+    writeFileSync(patchPath, next);
+    return { added: true, text: next };
+}
+/**
+ * Run `dshloader setup <profile>`.
+ * @param profileName
+ * @returns
+ */
+export function setupProfile(profileName) {
+    const dir = profileDir(profileName);
+    if (!existsSync(dir)) {
+        throw new Error(`${LOG_PREFIX} profile directory not found: ${dir}`);
+    }
+    const pkgPath = join(dir, 'package.json');
+    const patchPath = join(dir, 'cordis.patch.yml');
+    const dep = injectDependency(pkgPath);
+    const patch = injectPatch(patchPath);
+    console.log(`${LOG_PREFIX} setup ${profileName}: dependency ${dep.added ? 'added' : 'already present'}, patch ${patch.added ? 'appended' : 'already present'}`);
+    console.log(`${LOG_PREFIX} note: insert position is irrelevant — cordis reactive DI resolves aliases regardless of order (design.md §6.2)`);
+    return { profileDir: dir, dependencyAdded: dep.added, patchAdded: patch.added };
+}
+/** Best-effort dump-config validation. Returns { ok, output } (never throws). */
+export function dumpConfig(profileName) {
+    const dir = profileDir(profileName);
+    if (!existsSync(dir)) {
+        return { ok: false, output: `${LOG_PREFIX} profile directory not found: ${dir}` };
+    }
+    const result = spawnSync('dsh', ['--profile', profileName, '--dump-config'], {
+        encoding: 'utf8',
+        timeout: 60_000,
+    });
+    const output = (result.stdout ?? '') + (result.stderr ?? '');
+    return { ok: result.status === 0, output };
+}
+/** Print dshloader status for a profile (AC-OB-03, minimal). */
+export function info(profileName) {
+    console.log(`${LOG_PREFIX} version ${LOADER_VERSION}`);
+    const dir = profileName ? profileDir(profileName) : undefined;
+    const dshVersion = detectDshVersion(dir ? { profileDir: dir } : {});
+    console.log(`${LOG_PREFIX} detected dsh version: ${dshVersion ?? '<unknown>'}`);
+    if (dshVersion) {
+        try {
+            const reg = registerHostAdapters(new AdapterRegistry());
+            const { factory, mode } = reg.select(dshVersion);
+            console.log(`${LOG_PREFIX} selected adapter: ${factory.name} (supports ${factory.supports}, mode ${mode})`);
+        }
+        catch (error) {
+            console.log(`${LOG_PREFIX} adapter selection: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return { loaderVersion: LOADER_VERSION, dshVersion };
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Shared TypeScript types for dshloader (host + client).
+ *
+ * These describe only the shapes dshloader itself relies on from the cordis
+ * runtime, the real dsh settings/web services, and the browser client
+ * environment. The real dsh services are intentionally typed loosely (`any`)
+ * because dshloader's whole job is to absorb dsh's internal shape changes
+ * behind a stable API — pinning them here would defeat the compatibility
+ * shim's purpose.
+ */
+/** Minimal cordis context surface dshloader uses. */
+export interface CordisContext {
+    get(name: string): any;
+    reflect: {
+        provide(name: string, value: any): void;
+    };
+    effect(fn: () => void | (() => void) | Promise<void | (() => void)>, label?: string): void;
+}
+/** dshloader host adapter factory. */
+export interface AdapterFactory {
+    supports: string;
+    name: string;
+    create(ctx: CordisContext, config?: HostAdapterConfig): HostAdapter;
+}
+/** An instantiated host adapter. */
+export interface HostAdapter {
+    supports: string;
+    name: string;
+    apply?: () => Promise<void> | void;
+    dispose?: () => void;
+    /** Adapter-provided overrides for the stable API capabilities. */
+    settings?: any;
+    web?: any;
+    services?: any;
+}
+/** Config passed to an adapter's create(). */
+export interface HostAdapterConfig {
+    exposeAllNamespaces?: boolean;
+    hostPackageAliases?: Record<string, string>;
+}
+/** Result of AdapterRegistry.select(). */
+export interface AdapterSelection {
+    factory: AdapterFactory;
+    mode: 'exact' | 'range' | 'fallback';
+}
+/** dshloader host API exposed as `ctx.dshLoader`. */
+export interface HostAPI {
+    version: string;
+    dshVersion?: string;
+    adapterVersion?: string;
+    settings: SettingsAPI;
+    web: WebAPI;
+    services: ServicesAPI;
+    registerPackageAlias(oldName: string, newName: string): void;
+}
+/** Settings stable API. */
+export interface SettingsAPI {
+    exposeAllNamespaces: boolean;
+    register(ns: string, schema: any, options?: any): any;
+    describe(options?: {
+        redactSecrets?: boolean;
+    }): any[];
+    update(ns: string, section?: any, expectedRevision?: number): Promise<SettingsResult>;
+    replace(ns: string, section?: any, expectedRevision?: number): Promise<SettingsResult>;
+    mutate(ns: string, ops?: any, expectedRevision?: number): Promise<SettingsResult>;
+}
+/** Settings write result shape. */
+export interface SettingsResult {
+    ok: boolean;
+    value?: NamespaceView;
+    code?: string;
+    message?: string;
+    details?: Record<string, any>;
+}
+/** Official NamespaceView wire shape. */
+export interface NamespaceView {
+    ns: string;
+    schema: any;
+    value: any;
+    base?: any;
+    user?: any;
+    applies?: any;
+    secrets: {
+        path: string[];
+        set?: any;
+    }[];
+    revision?: any;
+}
+/** Web stable API. */
+export interface WebAPI {
+    register(prefix: string, handler: any): () => void;
+    get(path: string, handler: any): () => void;
+    post(path: string, handler: any): () => void;
+    use(middleware: any): () => void;
+    registerUpgrade(route: {
+        path: string;
+        handler: (req: any, socket: any, head: Buffer) => void;
+    }): () => void;
+}
+/** Services stable API. */
+export interface ServicesAPI {
+    get(name: string): any;
+    alias(from: string, to: string): void;
+}
+/** Selectable adapter entry exposed for CLI/tests. */
+export interface AdapterSelectionResult {
+    registry: import('./registry.js').AdapterRegistry;
+    factory: AdapterFactory;
+    mode: AdapterSelection['mode'];
+    dshVersion: string;
+}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * Shared TypeScript types for dshloader (host + client).
+ *
+ * These describe only the shapes dshloader itself relies on from the cordis
+ * runtime, the real dsh settings/web services, and the browser client
+ * environment. The real dsh services are intentionally typed loosely (`any`)
+ * because dshloader's whole job is to absorb dsh's internal shape changes
+ * behind a stable API — pinning them here would defeat the compatibility
+ * shim's purpose.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const LOADER_VERSION = "1.0.0";
+export declare const LOG_PREFIX = "[dshloader]";

package/{src → dist}/version.js

@@ -1,5 +1,5 @@
-// dshloader version — keep in sync with package.json.
-export const LOADER_VERSION = '1.0.0';
-
-// Prefix used in every console log / error so users can grep dshloader output.
-export const LOG_PREFIX = '[dshloader]';
+// dshloader version — keep in sync with package.json.
+export const LOADER_VERSION = '1.0.0';
+// Prefix used in every console log / error so users can grep dshloader output.
+export const LOG_PREFIX = '[dshloader]';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC"}

package/lib/client.js

@@ -0,0 +1,283 @@
+window.__ModuleLoader__.load({
+	id: "@dsh-plugin/dsh-loader",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/version.ts
+		const LOADER_VERSION = "1.0.0";
+		const LOG_PREFIX = "[dshloader]";
+		//#endregion
+		//#region src/adapters/dsh-1-x.ts
+		const supports = ">=0.1.0-rc.1 <2.0.0";
+		const name$1 = "dsh-1-x";
+		const BRIDGE_PREFIX = "/api/dshloader";
+		const clientAdapters = [{
+			supports,
+			name: name$1,
+			moduleAliases: {
+				"@deepseek-ai/dsh-client-runtime/src/client/sessions/context-provenance.ts": "@deepseek-ai/dsh-client-runtime/client",
+				"dsh/runtime/context-provenance": "@deepseek-ai/dsh-client-runtime/client"
+			},
+			packageAliases: {
+				"@dsh-plugin/dsh-loader/ui-primitives": "@deepseek-ai/dsh-client-ui-primitives",
+				"@dsh-plugin/dsh-loader/ui-slots": "@deepseek-ai/dsh-client-ui-slots",
+				"@dsh-plugin/dsh-loader/web-react": "@deepseek-ai/dsh-client-web-react",
+				"@dsh-plugin/dsh-loader/schema-form": "@deepseek-ai/dsh-client-schema-form",
+				"@dsh-plugin/dsh-loader/ui-settings": "@deepseek-ai/dsh-client-ui-settings/client",
+				"@dsh-plugin/dsh-loader/runtime": "@deepseek-ai/dsh-client-runtime/client"
+			}
+		}];
+		//#endregion
+		//#region src/client.ts
+		var ModuleNotFoundError = class extends Error {
+			specifier;
+			constructor(specifier) {
+				super(`${LOG_PREFIX} module not found: ${specifier}`);
+				this.name = "ModuleNotFoundError";
+				this.specifier = specifier;
+			}
+		};
+		/**
+		* Pick the client adapter for the given dsh version. v1 ships a single
+		* client adapter (dsh 1.x); when more are added, swap this for a semver-based
+		* selection mirroring the host AdapterRegistry.
+		*/
+		function pickClientAdapter(dshVersion) {
+			return clientAdapters[0];
+		}
+		/**
+		* Build the `window.__dshLoader__` API object.
+		*/
+		function createClientAPI(opts = {}) {
+			const aliases = new Map(Object.entries(opts.moduleAliases ?? {}));
+			const requireImpl = opts.requireImpl ?? ((spec) => {
+				throw new ModuleNotFoundError(spec);
+			});
+			const clientCtx = opts.clientCtx;
+			const packageAliases = opts.packageAliases instanceof Map ? opts.packageAliases : new Map(Object.entries(opts.packageAliases ?? {}));
+			return {
+				version: LOADER_VERSION,
+				dshVersion: opts.dshVersion,
+				adapterVersion: opts.adapterVersion,
+				require(specifier) {
+					if (typeof specifier !== "string") throw new ModuleNotFoundError(String(specifier));
+					const target = aliases.get(specifier);
+					if (target === void 0) throw new ModuleNotFoundError(specifier);
+					return requireImpl(target);
+				},
+				registerModuleAlias(alias, target) {
+					aliases.set(alias, target);
+				},
+				/**
+				* Register a package-name alias for the client module loader's
+				* require(). When a plugin's bundle calls require('@old/pkg-name'),
+				* the loader's wrapped require remaps it to '@new/pkg-name' before
+				* hitting the module table. This lets dsh rename client packages
+				* across versions without forcing plugin bundles to rebuild.
+				*/
+				registerPackageAlias(oldName, newName) {
+					packageAliases.set(oldName, newName);
+				},
+				/**
+				* Read a client-side cordis service by name.
+				* Proxies to `clientCtx.get(name)` — the same ctx.get plugins use
+				* inside their client `apply(ctx)`, but exposed through the stable
+				* dshloader surface so plugins don't depend on the cordis context
+				* shape directly.
+				*
+				* Only available when dshloader's client apply() received a ctx
+				* (cordis client boot). Returns undefined when ctx is not wired.
+				*/
+				services: { get(name) {
+					if (clientCtx === void 0 || typeof clientCtx.get !== "function") return void 0;
+					return clientCtx.get(name);
+				} },
+				rpc: opts.fetchBridge ? { settings: {
+					describe: () => opts.fetchBridge.describe(),
+					update: (ns, section) => opts.fetchBridge.write("update", {
+						ns,
+						section
+					}),
+					replace: (ns, section) => opts.fetchBridge.write("replace", {
+						ns,
+						section
+					}),
+					mutate: (ns, ops) => opts.fetchBridge.write("mutate", {
+						ns,
+						ops
+					})
+				} } : void 0
+			};
+		}
+		/**
+		* Install dshloader into a browser-like environment.
+		*/
+		function installClient(opts = {}) {
+			const win = opts.window ?? (typeof window !== "undefined" ? window : void 0);
+			if (win === void 0) return void 0;
+			const dshVersion = opts.dshVersion ?? win.__DSHLOADER_VERSION__;
+			const adapter = pickClientAdapter(dshVersion);
+			const moduleAliases = { ...adapter.moduleAliases ?? {} };
+			const packageAliases = new Map(Object.entries(adapter.packageAliases ?? {}));
+			if (opts.packageAliases) for (const [k, v] of Object.entries(opts.packageAliases)) packageAliases.set(k, v);
+			const exposeAllNamespaces = Boolean(opts.exposeAllNamespaces ?? win.__DSHLOADER_CONFIG__?.exposeAllNamespaces);
+			const bridgePrefix = opts.hostBridgePrefix ?? "/api/dshloader";
+			const fetchBridge = exposeAllNamespaces ? {
+				describe: () => win.fetch(`${bridgePrefix}/settings/describe`, { headers: { accept: "application/json" } }).then((r) => r.json()),
+				write: (mode, payload) => win.fetch(`${bridgePrefix}/settings/${mode}`, {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify(payload)
+				}).then((r) => r.json())
+			} : void 0;
+			const api = createClientAPI({
+				dshVersion,
+				adapterVersion: adapter.supports,
+				moduleAliases,
+				packageAliases,
+				requireImpl: opts.requireImpl ?? ((spec) => win.__dshNativeRequire__?.(spec)),
+				fetchBridge,
+				clientCtx: opts.clientCtx
+			});
+			win.__dshLoader__ = api;
+			const loader = win.__ModuleLoader__;
+			if (loader && typeof loader.load === "function") {
+				const originalLoad = loader.load.bind(loader);
+				loader.load = function dshloaderLoad(handoff) {
+					const wrappedFactory = (require$1) => {
+						const aliasedRequire = (spec) => {
+							return require$1(packageAliases.get(spec) ?? spec);
+						};
+						return handoff.factory(aliasedRequire);
+					};
+					return originalLoad({
+						id: handoff.id,
+						factory: wrappedFactory
+					});
+				};
+			}
+			if (loader && typeof loader.load === "function") for (const [aliasId, target] of Object.entries(moduleAliases)) loader.load({
+				id: aliasId,
+				factory: (require$2) => {
+					const mod = require$2(target);
+					if (aliasId.endsWith("context-provenance.ts") || aliasId.endsWith("context-provenance")) return { contextProvenance: mod.contextProvenance };
+					return mod;
+				}
+			});
+			if (exposeAllNamespaces) {
+				installSettingsFetchInterceptor(win, bridgePrefix);
+				console.warn(`${LOG_PREFIX} exposeAllNamespaces enabled: bypassing official settings whitelist`);
+			}
+			return api;
+		}
+		/**
+		* Fetch interceptor for settings namespace whitelist bypass (fix 5, path 2).
+		* Mirrors dsh-upstream-fixes/lib/client.js (127-223).
+		*
+		* - /api/settings.describe: merge non-whitelisted namespaces from the host
+		*   bridge into the official response (rpcId/official fields preserved).
+		* - /api/settings.{update,mutate,replace}: route writes for namespaces the
+		*   official proxy does NOT expose through the host bridge, and rebuild the
+		*   response envelope as `{ type: 'server-response', rpcId, result }` so the
+		*   official client can correlate the response with the request.
+		*/
+		function installSettingsFetchInterceptor(win, bridgePrefix = BRIDGE_PREFIX) {
+			if (typeof win.fetch !== "function") return () => {};
+			const originalFetch = win.fetch;
+			/** Namespaces the official proxy itself exposed (learned from describe). */
+			const officialExposed = /* @__PURE__ */ new Set();
+			win.fetch = async function dshloaderFetch(input, init) {
+				let pathname = "";
+				try {
+					const urlLike = typeof input === "string" ? input : input.url;
+					pathname = new URL(urlLike, win.location?.origin ?? "http://localhost").pathname;
+				} catch {
+					pathname = String(input).split("?")[0];
+				}
+				const method = (init?.method ?? "GET").toUpperCase();
+				if (pathname === "/api/settings.describe") {
+					const response = await originalFetch.call(this, input, init);
+					try {
+						const body = await response.clone().json();
+						const namespaces = body?.result?.value?.namespaces;
+						if (!Array.isArray(namespaces)) return response;
+						for (const row of namespaces) if (typeof row?.ns === "string") officialExposed.add(row.ns);
+						const extraBody = await (await originalFetch.call(this, `${bridgePrefix}/settings/describe`, { headers: { accept: "application/json" } })).json();
+						if (extraBody?.ok !== true || !Array.isArray(extraBody.namespaces)) return response;
+						const seen = new Set(namespaces.map((row) => row.ns));
+						const merged = [...namespaces, ...extraBody.namespaces.filter((row) => !seen.has(row.ns))];
+						const ResponseCtor = win.Response;
+						return new ResponseCtor(JSON.stringify({
+							...body,
+							result: {
+								...body.result,
+								value: {
+									...body.result.value,
+									namespaces: merged
+								}
+							}
+						}), {
+							status: 200,
+							headers: { "content-type": "application/json" }
+						});
+					} catch {
+						return response;
+					}
+				}
+				if ((pathname === "/api/settings.update" || pathname === "/api/settings.mutate" || pathname === "/api/settings.replace") && method === "POST") {
+					let rpcId = null;
+					let payload = null;
+					try {
+						const parsed = JSON.parse(String(init?.body ?? "{}"));
+						rpcId = parsed.rpcId;
+						payload = parsed.payload;
+					} catch {}
+					const ns = typeof payload?.ns === "string" ? payload.ns : "";
+					if (rpcId !== null && ns !== "" && officialExposed.size > 0 && !officialExposed.has(ns)) try {
+						const mode = pathname.slice(14);
+						const body = await (await originalFetch.call(this, `${bridgePrefix}/settings/${mode}`, {
+							method: "POST",
+							headers: { "content-type": "application/json" },
+							body: JSON.stringify(payload)
+						})).json();
+						if (body?.result) {
+							const ResponseCtor = win.Response;
+							return new ResponseCtor(JSON.stringify({
+								type: "server-response",
+								rpcId,
+								result: body.result
+							}), {
+								status: 200,
+								headers: { "content-type": "application/json" }
+							});
+						}
+					} catch {}
+				}
+				return originalFetch.call(this, input, init);
+			};
+			return () => {
+				win.fetch = originalFetch;
+			};
+		}
+		const name = "@dsh-plugin/dsh-loader";
+		const inject = [];
+		function apply(ctx) {
+			if (typeof window !== "undefined") installClient({
+				window,
+				clientCtx: ctx
+			});
+		}
+		//#endregion
+		exports.ModuleNotFoundError = ModuleNotFoundError;
+		exports.apply = apply;
+		exports.createClientAPI = createClientAPI;
+		exports.inject = inject;
+		exports.installClient = installClient;
+		exports.installSettingsFetchInterceptor = installSettingsFetchInterceptor;
+		exports.name = name;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map