@czj-git/dsh-plugin-hub 0.1.0 → 0.2.0

package/dist/web-route.js

@@ -0,0 +1,115 @@
+/** Same-origin Host proxy used by the browser Settings page. */
+import { PluginHubApiError, } from './api.js';
+import { pluginHubCategories, pluginHubLocales, pluginHubSorts, pluginHubSources, pluginHubTypes, PLUGIN_HUB_SEARCH_ROUTE, } from './shared.js';
+function enumValue(name, value, allowed) {
+    if (value === null || value === '')
+        return undefined;
+    if (!allowed.includes(value))
+        throw new Error(`${name} is unsupported`);
+    return value;
+}
+function integerValue(name, value, fallback, maximum) {
+    if (value === null || value === '')
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > maximum) {
+        throw new Error(`${name} must be an integer from 1 to ${maximum}`);
+    }
+    return parsed;
+}
+/**
+ * Validate browser query parameters before forwarding them to the public API.
+ * @param url - Local request URL.
+ * @param defaultLocale - Locale used when the browser omits one.
+ * @returns Validated public API search input.
+ */
+export function parseLocalSearchInput(url, defaultLocale) {
+    const query = url.searchParams.get('q')?.trim().replace(/\s+/g, ' ') ?? '';
+    if (query.length > 100)
+        throw new Error('q must contain at most 100 characters');
+    const locale = enumValue('locale', url.searchParams.get('locale'), pluginHubLocales) ?? defaultLocale;
+    const category = enumValue('category', url.searchParams.get('category'), pluginHubCategories);
+    const type = enumValue('type', url.searchParams.get('type'), pluginHubTypes);
+    const source = enumValue('source', url.searchParams.get('source'), pluginHubSources);
+    const sort = enumValue('sort', url.searchParams.get('sort'), pluginHubSorts) ?? (query ? 'relevance' : 'stars');
+    return {
+        ...(query ? { query } : {}),
+        locale,
+        ...(category ? { category: category } : {}),
+        ...(type ? { type: type } : {}),
+        ...(source ? { source: source } : {}),
+        sort: sort,
+        page: integerValue('page', url.searchParams.get('page'), 1, 1000),
+        perPage: integerValue('per_page', url.searchParams.get('per_page'), 12, 50),
+    };
+}
+function writeJson(res, status, body) {
+    res.writeHead(status, {
+        'Cache-Control': 'no-store',
+        'Content-Type': 'application/json; charset=utf-8',
+    });
+    res.end(JSON.stringify(body));
+}
+/**
+ * Create the read-only local HTTP handler for the Settings client.
+ * @param client - Validating public API client.
+ * @param defaultLocale - Host-configured fallback locale.
+ * @returns Node HTTP handler suitable for the Harness WebServer registry.
+ */
+export function createPluginHubSearchHandler(client, defaultLocale) {
+    return async (req, res) => {
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204, { Allow: 'GET, OPTIONS', 'Cache-Control': 'no-store' });
+            res.end();
+            return;
+        }
+        if (req.method !== 'GET') {
+            writeJson(res, 405, { error: { code: 'METHOD_NOT_ALLOWED', message: 'Only GET is supported.' } });
+            return;
+        }
+        let input;
+        try {
+            input = parseLocalSearchInput(new URL(req.url ?? PLUGIN_HUB_SEARCH_ROUTE, 'http://localhost'), defaultLocale);
+        }
+        catch (error) {
+            writeJson(res, 400, {
+                error: {
+                    code: 'INVALID_QUERY',
+                    message: error instanceof Error ? error.message : 'Invalid request parameters.',
+                },
+            });
+            return;
+        }
+        const request = new AbortController();
+        const abort = () => { request.abort(); };
+        req.once('aborted', abort);
+        try {
+            const result = await client.search(input, request.signal);
+            if (!res.destroyed)
+                writeJson(res, 200, result);
+        }
+        catch (error) {
+            if (res.destroyed)
+                return;
+            if (error instanceof PluginHubApiError) {
+                const remoteStatus = error.status;
+                const status = remoteStatus !== null && remoteStatus >= 400 && remoteStatus <= 599 ? remoteStatus : 502;
+                writeJson(res, status, {
+                    error: {
+                        code: error.code,
+                        message: error.message,
+                        ...(Object.keys(error.fields).length > 0 ? { fields: error.fields } : {}),
+                    },
+                });
+                return;
+            }
+            writeJson(res, 502, {
+                error: { code: 'PLUGIN_HUB_UNAVAILABLE', message: 'DSH Plugin Hub is temporarily unavailable.' },
+            });
+        }
+        finally {
+            req.off('aborted', abort);
+        }
+    };
+}
+//# sourceMappingURL=web-route.js.map

package/dist/web-route.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@czj-git/dsh-plugin-hub",
-  "version": "0.1.0",
-  "description": "DeepSeek Harness tools for searching and ranking verified plugins from DSH Plugin Hub",
+  "version": "0.2.0",
+  "description": "DeepSeek Harness Plugin Hub tools and native Settings marketplace",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,18 +14,32 @@
       "types": "./dist/api.d.ts",
       "default": "./dist/api.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "default": "./dist/schemas.js"
+    },
+    "./shared": {
+      "types": "./dist/shared.d.ts",
+      "default": "./dist/shared.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "dist/**/*.js",
+    "dist/**/*.js.map",
     "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node ./scripts/build-client.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "tsx --test tests/*.test.ts",
     "check": "npm run typecheck && npm test && npm run build",
@@ -34,6 +48,14 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ]
     }
   },
   "engines": {
@@ -43,7 +65,8 @@
     "deepseek-harness",
     "dsh-plugin",
     "plugin-search",
-    "plugin-marketplace"
+    "plugin-marketplace",
+    "settings-page"
   ],
   "license": "MIT",
   "repository": {
@@ -63,12 +86,34 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.7 <0.2.0"
+    "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7 <0.2.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.7 <0.2.0",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-locale": { "optional": true },
+    "@deepseek-ai/dsh-client-runtime": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-settings": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-slots": { "optional": true },
+    "@deepseek-ai/dsh-host-webserver": { "optional": true },
+    "react": { "optional": true }
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.7",
     "@deepseek-ai/dsh-tools": "0.1.0-rc.7",
     "@types/node": "^22.18.0",
+    "@types/react": "^18.3.24",
+    "esbuild": "^0.25.9",
+    "react": "^18.3.1",
     "tsx": "^4.20.6",
     "typescript": "^5.9.2"
   }