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

package/dist/client.js

@@ -0,0 +1,295 @@
+// dshloader client bundle entry (design.md §3.5 / §4.3 / §7.3).
+//
+// Loaded in the `immediately` prefetch tier (package.json `dsh.client`).
+// Responsibilities:
+//   1. Mount `window.__dshLoader__` with `require` / `registerModuleAlias` /
+//      `rpc.settings.*`.
+//   2. Register module-alias factories via `window.__ModuleLoader__.load` so
+//      deep source imports (fix 1) and stable module names resolve to the
+//      public runtime client entry.
+//   3. When `exposeAllNamespaces` is on, install a fetch interceptor that
+//      merges non-whitelisted namespaces into `/api/settings.describe` and
+//      routes non-whitelisted writes through the host bridge, echoing the
+//      request `rpcId` in the `{ type: 'server-response', rpcId, result }`
+//      envelope (fix 5, path 2 — mirrors dsh-upstream-fixes/lib/client.js).
+//
+// The module exports an `installClient` function for testability and runs an
+// IIFE at the bottom for the real browser bundle.
+import { LOADER_VERSION, LOG_PREFIX } from './version.js';
+import { clientAdapters } from './adapters/index.js';
+import { BRIDGE_PREFIX } from './adapters/dsh-1-x.js';
+export class ModuleNotFoundError 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.
+ */
+export function createClientAPI(opts = {}) {
+    const aliases = new Map(Object.entries(opts.moduleAliases ?? {}));
+    const requireImpl = opts.requireImpl ?? ((spec) => {
+        throw new ModuleNotFoundError(spec);
+    });
+    const clientCtx = opts.clientCtx;
+    // Reuse the Map from installClient when provided so registerPackageAlias
+    // mutations are visible to the __ModuleLoader__ wrapper. Otherwise create
+    // a fresh Map from a plain object.
+    const packageAliases = opts.packageAliases instanceof Map
+        ? opts.packageAliases
+        : new Map(Object.entries(opts.packageAliases ?? {}));
+    const api = {
+        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 === undefined) {
+                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 === undefined || typeof clientCtx.get !== 'function')
+                    return undefined;
+                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 }),
+                },
+            }
+            : undefined,
+    };
+    return api;
+}
+/**
+ * Install dshloader into a browser-like environment.
+ */
+export function installClient(opts = {}) {
+    const win = opts.window ?? (typeof window !== 'undefined' ? window : undefined);
+    if (win === undefined)
+        return undefined;
+    const dshVersion = opts.dshVersion ?? win.__DSHLOADER_VERSION__;
+    const adapter = pickClientAdapter(dshVersion);
+    const moduleAliases = { ...(adapter.moduleAliases ?? {}) };
+    // Merge adapter-declared package aliases with any passed via opts (opts
+    // win on conflict, so tests / runtime can override adapter defaults).
+    const packageAliases = new Map(Object.entries(adapter.packageAliases ?? {}));
+    if (opts.packageAliases) {
+        for (const [k, v] of Object.entries(opts.packageAliases))
+            packageAliases.set(k, v);
+    }
+    // fetch bridge (only meaningful when exposeAllNamespaces is on).
+    const exposeAllNamespaces = Boolean(opts.exposeAllNamespaces ?? win.__DSHLOADER_CONFIG__?.exposeAllNamespaces);
+    const bridgePrefix = opts.hostBridgePrefix ?? BRIDGE_PREFIX;
+    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()),
+        }
+        : undefined;
+    const api = createClientAPI({
+        dshVersion,
+        adapterVersion: adapter.supports,
+        moduleAliases,
+        packageAliases,
+        requireImpl: opts.requireImpl ?? ((spec) => win.__dshNativeRequire__?.(spec)),
+        fetchBridge,
+        clientCtx: opts.clientCtx,
+    });
+    win.__dshLoader__ = api;
+    // Wrap __ModuleLoader__.load so every factory's require() function
+    // applies package-name aliases before hitting the module table. This
+    // must happen BEFORE registering module-alias factories below, because
+    // those factories also receive the wrapped require.
+    const loader = win.__ModuleLoader__;
+    if (loader && typeof loader.load === 'function') {
+        const originalLoad = loader.load.bind(loader);
+        loader.load = function dshloaderLoad(handoff) {
+            const wrappedFactory = (require) => {
+                const aliasedRequire = (spec) => {
+                    const mapped = packageAliases.get(spec);
+                    return require(mapped ?? spec);
+                };
+                return handoff.factory(aliasedRequire);
+            };
+            return originalLoad({ id: handoff.id, factory: wrappedFactory });
+        };
+    }
+    // Register module-alias factories with the client module loader (fix 1).
+    if (loader && typeof loader.load === 'function') {
+        for (const [aliasId, target] of Object.entries(moduleAliases)) {
+            loader.load({
+                id: aliasId,
+                factory: (require) => {
+                    const mod = require(target);
+                    // Preserve the deep import's expected named export shape.
+                    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.
+ */
+export 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 = 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();
+        // describe: merge bridge namespaces into the official response.
+        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 extra = await originalFetch.call(this, `${bridgePrefix}/settings/describe`, {
+                    headers: { accept: 'application/json' },
+                });
+                const extraBody = await extra.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;
+            }
+        }
+        // writes: route non-whitelisted namespaces through the bridge, echo rpcId.
+        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 {
+                /* fall through to the original endpoint */
+            }
+            const ns = typeof payload?.ns === 'string' ? payload.ns : '';
+            if (rpcId !== null && ns !== '' && officialExposed.size > 0 && !officialExposed.has(ns)) {
+                try {
+                    const mode = pathname.slice('/api/settings.'.length);
+                    const res = await originalFetch.call(this, `${bridgePrefix}/settings/${mode}`, {
+                        method: 'POST',
+                        headers: { 'content-type': 'application/json' },
+                        body: JSON.stringify(payload),
+                    });
+                    const body = await res.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 {
+                    /* fall back to the original endpoint */
+                }
+            }
+        }
+        return originalFetch.call(this, input, init);
+    };
+    return () => {
+        win.fetch = originalFetch;
+    };
+}
+// ── cordis client-plugin entry ─────────────────────────────────────────
+// dsh's client boot applies every registered bundle as a cordis plugin:
+// the module must expose `apply` (third-party plugins / dsh-client-runtime
+// all do `exports.apply = apply`). Without it the client boot fails with
+// "invalid plugin, expect function or object with an \"apply\" method".
+// `installClient` mounts window.__dshLoader__, registers module aliases,
+// wires the client cordis ctx for `services.get`, and (when opted in)
+// installs the settings fetch interceptor.
+export const name = '@dsh-plugin/dsh-loader';
+export const inject = [];
+export function apply(ctx) {
+    if (typeof window !== 'undefined')
+        installClient({ window: window, clientCtx: ctx });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { LOADER_VERSION } from './version.js';
+import { AdapterRegistry } from './registry.js';
+import { createHostAPI } from './api.js';
+import type { CordisContext, AdapterFactory } from './types.js';
+export declare const name = "@dsh-plugin/dsh-loader";
+export declare const inject: string[];
+interface LoaderConfig {
+    exposeAllNamespaces: boolean;
+    hostPackageAliases?: Record<string, string>;
+}
+/**
+ * Read the profile-level dshloader config (exposeAllNamespaces etc.).
+ * Sources, in priority order:
+ *   1. process.env.DSHLOADER_EXPOSE_ALL_SETTINGS=1
+ *   2. profile package.json `dsh.dshloader.exposeAllNamespaces`
+ *   3. profile package.json `dshLoader.settings.exposeAllNamespaces`
+ */
+export declare function readLoaderConfig(opts?: {
+    profileDir?: string;
+}): LoaderConfig;
+interface AdapterSelectionResult {
+    registry: AdapterRegistry;
+    factory: AdapterFactory;
+    mode: 'exact' | 'range' | 'fallback';
+    dshVersion: string;
+}
+/**
+ * Build the registry + select an adapter for the current dsh version, without
+ * touching the cordis context. Exported for tests and the `info` CLI command.
+ */
+export declare function selectAdapter(opts?: {
+    dshVersion?: string;
+    registry?: AdapterRegistry;
+}): AdapterSelectionResult;
+/**
+ * Apply the selected adapter onto a cordis context and expose the stable API.
+ * @param ctx cordis context
+ * @returns
+ */
+export declare function applyAdapter(ctx: CordisContext, opts?: {
+    dshVersion?: string;
+    config?: LoaderConfig;
+    registry?: AdapterRegistry;
+}): Promise<{
+    api: ReturnType<typeof createHostAPI>;
+    factory: AdapterFactory;
+    mode: string;
+    dshVersion: string;
+}>;
+/** cordis function-plugin entry point. */
+export declare function apply(ctx: CordisContext): Promise<void>;
+export { LOADER_VERSION };

package/dist/index.js

@@ -0,0 +1,89 @@
+// dshloader host bundle entry (design.md §7.3 / §4.4).
+//
+// Exports the cordis function-plugin shape (`name`, `inject`, `apply`) and
+// wires the adapter registry → version detection → stable API onto
+// `ctx.dshLoader`. Service aliases / bridge routes register through
+// ctx.reflect.provide / ctx.effect so cordis auto-recycles them on fiber
+// unload — no manual dispose is required for v1's covered capabilities.
+import { LOADER_VERSION, LOG_PREFIX } from './version.js';
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { AdapterRegistry, detectDshVersion, UnsupportedDshVersionError } from './registry.js';
+import { registerHostAdapters } from './adapters/index.js';
+import { createHostAPI } from './api.js';
+export const name = '@dsh-plugin/dsh-loader';
+// dshloader itself depends on `webServer` so its fiber only activates once
+// the real web server is provided — the alias then points `httpServer` at it.
+export const inject = ['webServer'];
+/**
+ * Read the profile-level dshloader config (exposeAllNamespaces etc.).
+ * Sources, in priority order:
+ *   1. process.env.DSHLOADER_EXPOSE_ALL_SETTINGS=1
+ *   2. profile package.json `dsh.dshloader.exposeAllNamespaces`
+ *   3. profile package.json `dshLoader.settings.exposeAllNamespaces`
+ */
+export function readLoaderConfig(opts = {}) {
+    const envOn = process.env.DSHLOADER_EXPOSE_ALL_SETTINGS === '1' || process.env.DSHLOADER_EXPOSE_ALL_SETTINGS === 'true';
+    let pkgOn = false;
+    try {
+        // Best-effort: read the profile manifest if reachable via cwd.
+        const dir = opts.profileDir ?? join(process.env.DSH_HOME ?? '', 'profiles', 'web');
+        const manifest = JSON.parse(readFileSync(join(resolve(dir), 'package.json'), 'utf8'));
+        pkgOn = Boolean(manifest.dsh?.dshloader?.exposeAllNamespaces ??
+            manifest.dshLoader?.settings?.exposeAllNamespaces);
+    }
+    catch {
+        /* ignore */
+    }
+    return { exposeAllNamespaces: envOn || pkgOn };
+}
+/**
+ * Build the registry + select an adapter for the current dsh version, without
+ * touching the cordis context. Exported for tests and the `info` CLI command.
+ */
+export function selectAdapter(opts = {}) {
+    const reg = opts.registry ?? registerHostAdapters(new AdapterRegistry());
+    const version = opts.dshVersion ?? detectDshVersion();
+    if (version === undefined) {
+        throw new UnsupportedDshVersionError(`${LOG_PREFIX} could not detect dsh version; set DSHLOADER_DSH_VERSION or install @deepseek-ai/dsh`, { kind: 'too-new' });
+    }
+    const { factory, mode } = reg.select(version);
+    return { registry: reg, factory, mode, dshVersion: version };
+}
+/**
+ * Apply the selected adapter onto a cordis context and expose the stable API.
+ * @param ctx cordis context
+ * @returns
+ */
+export async function applyAdapter(ctx, opts = {}) {
+    const config = opts.config ?? readLoaderConfig();
+    const selection = selectAdapter({ dshVersion: opts.dshVersion, registry: opts.registry });
+    const { factory, mode, dshVersion } = selection;
+    const adapter = factory.create(ctx, config);
+    await adapter.apply?.();
+    const api = createHostAPI({
+        ctx,
+        dshVersion,
+        factory,
+        adapter,
+        exposeAllNamespaces: config.exposeAllNamespaces,
+        hostPackageAliases: config.hostPackageAliases,
+    });
+    ctx.reflect.provide('dshLoader', api);
+    console.log(`${LOG_PREFIX} loaded adapter ${factory.name} for dsh ${dshVersion} (mode: ${mode})`);
+    console.log(`${LOG_PREFIX} registered stable API: settings, web, services`);
+    if (config.exposeAllNamespaces) {
+        console.warn(`${LOG_PREFIX} exposeAllNamespaces enabled: bypassing official settings whitelist`);
+    }
+    return { api, factory, mode, dshVersion };
+}
+/** cordis function-plugin entry point. */
+export async function apply(ctx) {
+    if (process.env.DSHLOADER_DISABLE === '1' || process.env.DSHLOADER_DISABLE === 'true') {
+        console.log(`${LOG_PREFIX} disabled by env, skipping`);
+        return;
+    }
+    await applyAdapter(ctx);
+}
+export { LOADER_VERSION };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,35 @@
+import type { AdapterFactory, AdapterSelection } from './types.js';
+interface DshVersionOptions {
+    profileDir?: string;
+    dshPkgPath?: string;
+    env?: typeof process.env;
+}
+export declare class UnsupportedDshVersionError extends Error {
+    kind?: string;
+    version?: string;
+    minSupported?: string | null;
+    constructor(message: string, opts?: {
+        kind?: string;
+        version?: string;
+        minSupported?: string | null;
+    });
+}
+export declare class InvalidVersionError extends Error {
+    version?: string;
+    constructor(message: string, opts?: {
+        version?: string;
+    });
+}
+/**
+ * Resolve the installed dsh version.
+ *
+ * @returns semver version string, or undefined when unreachable
+ */
+export declare function detectDshVersion(opts?: DshVersionOptions): string | undefined;
+export declare class AdapterRegistry {
+    adapters: AdapterFactory[];
+    constructor();
+    register(factory: AdapterFactory): this;
+    select(version: string): AdapterSelection;
+}
+export {};