@viztor/dsh-tinyfish 0.3.0

package/lib/client.js

@@ -0,0 +1,400 @@
+window.__ModuleLoader__.load({
+  id: "dsh-tinyfish",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/settings-page.tsx
+/**
+* `dsh-tinyfish` settings page — the client half of the bundle.
+*
+* The harness renders a plugin's settings form only when a client bundle
+* contributes a slot to the Plugins page. It never reads the plugin's `Config`
+* schema, so a package with no client half has no form however well its schema
+* is declared, and the harness degrades quietly rather than saying so.
+*
+* This is that half. It is bundled separately from `src/index.ts` — the host
+* half — into `lib/client.cjs`, wrapped in the `window.__ModuleLoader__.load`
+* call the web client expects, and the manifest declares both `dsh.bundle` and
+* `dsh.client`. Those two keys are read by different subsystems and never
+* consult each other, so one package can carry both and the user installs once.
+*
+* Nothing here writes as the user types. The form stages drafts and writes them
+* on save, so what is on screen is exactly what a save would store.
+*
+* @module dsh-tinyfish/settings-page
+*/
+/**
+* The settings namespace, spelled rather than imported.
+*
+* A client package must not depend on a Host package, so this string is
+* duplicated on purpose. It must equal the exported `name` of `src/index.ts`:
+* that is what the Plugins page keys the row by.
+*/
+const NS = "web-tinyfish";
+/**
+* Client-side services this page needs.
+*
+* `configForms` supplies the form scope, `slots` is how the page is
+* contributed, `locale` carries the dictionaries, and the two `remote` entries
+* are the credential reference and its invalidation events.
+*/
+const inject = [
+	"slots",
+	"locale",
+	"remote",
+	"remote.credentials",
+	"configForms"
+];
+/** English copy. */
+const en = {
+	title: "TinyFish",
+	description: "TinyFish-backed web search and fetch, at $0.",
+	channel: "Channel",
+	channelHint: "direct calls TinyFish with its own key; monid routes through a Monid key.",
+	apiKey: "API key",
+	apiKeyHint: "Stored outside the settings file. Leave blank to keep the current key.",
+	monidApiKey: "Monid platform key",
+	monidApiKeyHint: "Stored separately from the TinyFish key, so switching channels keeps both. `monid keys add` also works and takes precedence over this.",
+	apiKeySet: "A key is configured.",
+	apiKeyUnset: "No key is configured, so searches fail until one is set.",
+	purpose: "Purpose",
+	purposeHint: "Optional goal statement; TinyFish ranks results against it.",
+	attempts: "Attempts",
+	attemptsHint: "Retries for a transient failure or an empty result, 1 to 5.",
+	search: "Offer search",
+	searchHint: "When off, web_search falls through to another provider.",
+	fetch: "Offer fetch",
+	fetchHint: "When off, web_fetch falls through to another provider.",
+	channelDirect: "Direct",
+	channelMonid: "Monid",
+	bothOff: "Both providers are off, so this plugin is registered but answers nothing. Turn one back on to use it.",
+	overridden: "Overridden",
+	reset: "Reset to default",
+	invalidNumber: "Enter a whole number, or leave blank to use the default.",
+	invalidText: "This value was not accepted; leave blank to use the default.",
+	readOnly: "This deployment stores settings read-only.",
+	unavailable: "This plugin is not loaded, so it cannot be configured right now.",
+	save: "Save",
+	saving: "Saving…",
+	saveFailed: "The deployment did not accept these values; they were left for you to correct."
+};
+/** Simplified Chinese copy, for the profile locale this bundle was written in. */
+const zh = {
+	title: "TinyFish",
+	description: "基于 TinyFish 的网页搜索与抓取，零成本。",
+	channel: "通道",
+	channelHint: "direct 使用 TinyFish 自己的密钥；monid 通过 Monid 密钥转发。",
+	apiKey: "API Key",
+	apiKeyHint: "不写入设置文件。留空表示保持当前密钥。",
+	monidApiKey: "Monid 平台密钥",
+	monidApiKeyHint: "与 TinyFish 密钥分开保存，切换通道时两者都会保留。也可运行 `monid keys add`，其优先级高于此项。",
+	apiKeySet: "已配置密钥。",
+	apiKeyUnset: "未配置密钥，搜索会失败，直到设置为止。",
+	purpose: "目标说明",
+	purposeHint: "可选的目标描述；TinyFish 会据此排序结果。",
+	attempts: "尝试次数",
+	attemptsHint: "瞬时失败或结果为空时的重试次数，1 到 5。",
+	search: "提供搜索",
+	searchHint: "关闭后，web_search 会转由其他提供方处理。",
+	fetch: "提供抓取",
+	fetchHint: "关闭后，web_fetch 会转由其他提供方处理。",
+	channelDirect: "直连",
+	channelMonid: "Monid",
+	bothOff: "搜索与抓取均已关闭，此插件已注册但不再响应任何请求。重新开启其中一个即可恢复使用。",
+	overridden: "已覆盖",
+	reset: "恢复默认",
+	invalidNumber: "请填整数；留空表示使用默认值。",
+	invalidText: "该值未被接受；留空表示使用默认值。",
+	readOnly: "本部署的设置为只读。",
+	unavailable: "该插件当前未加载，暂时无法配置。",
+	save: "保存",
+	saving: "保存中…",
+	saveFailed: "本部署没有接受这些值，已保留供你修改。"
+};
+/** Field names in one place, so the form and its specs cannot drift apart. */
+const FIELD = {
+	channel: "channel",
+	apiKey: "apiKey",
+	apiKeyEnv: "apiKeyEnv",
+	monidApiKey: "monidApiKey",
+	monidKeyEnv: "monidKeyEnv",
+	purpose: "purpose",
+	attempts: "attempts",
+	search: "search",
+	fetch: "fetch"
+};
+/** Credential references the provider falls back to when the section names none. */
+const DEFAULT_API_KEY_REF = "TINYFISH_API_KEY";
+const DEFAULT_MONID_KEY_REF = "MONID_API_KEY";
+/**
+* A boolean field.
+*
+* The primitives ship a text and a number spec but no boolean one, and the Host
+* validates the stored value regardless — this only decides what a draft means.
+* `parse` returning `undefined` is what blocks the save on a typo instead of
+* silently discarding the edit, which is the difference between a visible
+* mistake and a setting that quietly did not apply.
+*
+* @param field - field name inside the namespace section.
+* @returns the field's conversion spec.
+*/
+/** What each accepted boolean draft stages. Anything absent blocks the save. */
+const BOOLEAN_DRAFTS = {
+	"": { kind: "clear" },
+	true: {
+		kind: "set",
+		value: true
+	},
+	false: {
+		kind: "set",
+		value: false
+	}
+};
+function settingsBooleanField(field) {
+	return {
+		field,
+		format: (value) => typeof value === "boolean" || typeof value === "number" ? String(value) : "",
+		parse: (text) => BOOLEAN_DRAFTS[text.trim().toLowerCase()]
+	};
+}
+/** The section fields this card edits, in render order. */
+const SPECS = [
+	(0, _deepseek_ai_dsh_client_ui_primitives.settingsTextField)(FIELD.channel),
+	(0, _deepseek_ai_dsh_client_ui_primitives.settingsTextField)(FIELD.purpose),
+	(0, _deepseek_ai_dsh_client_ui_primitives.settingsNumberField)(FIELD.attempts),
+	settingsBooleanField(FIELD.search),
+	settingsBooleanField(FIELD.fetch)
+];
+/**
+* The credential reference the section currently names.
+*
+* Read from the accepted section rather than from a draft, because the reference
+* is what the *provider* will resolve — a key typed against a reference that is
+* not yet saved would be stored where nothing looks for it.
+*
+* @param snapshot - the form scope's current snapshot.
+* @param which - which channel's reference to read.
+* @returns the reference name, or that channel's default.
+*/
+function refOf(snapshot, which) {
+	const section = snapshot?.value;
+	const field = which === "monid" ? FIELD.monidKeyEnv : FIELD.apiKeyEnv;
+	const named = section?.[field];
+	const fallback = which === "monid" ? DEFAULT_MONID_KEY_REF : DEFAULT_API_KEY_REF;
+	return typeof named === "string" && named.trim() !== "" ? named.trim() : fallback;
+}
+/** The labels the shared form frame renders. */
+const formLabels = (t) => ({
+	unavailable: t("unavailable"),
+	readOnly: t("readOnly"),
+	saveFailed: t("saveFailed"),
+	save: t("save"),
+	saving: t("saving")
+});
+/**
+* Render the Plugins list's one-line summary, or the settings form.
+*
+* @param props - the view asked for, locale copy, the form snapshot, its
+* actions, and the credential's configured state.
+* @returns the summary, or the form.
+*/
+/**
+* Resolve a boolean switch to its effective value.
+*
+* The draft text is authoritative when present; a blank draft means untouched,
+* so it falls back to the schema default (on for both switches). The Switch
+* only ever writes "true" or "false", so any other text cannot occur through
+* the UI — but the fallback keeps the control honest if the section arrives
+* in an unexpected shape.
+*/
+function switchValue(text) {
+	if (text === "false") return false;
+	return true;
+}
+function TinyfishCard(props) {
+	const { t } = props;
+	if (props.view === "summary") return t("description");
+	const state = props.useTinyfishCard((snapshot) => snapshot);
+	const disabled = !state.shell.writable;
+	const field = (name) => ({
+		id: `plugin-config-tinyfish-${name}`,
+		disabled,
+		overriddenLabel: t("overridden"),
+		resetLabel: t("reset"),
+		...state.fields[name],
+		onEdit: (text) => {
+			props.edit(name, text);
+		},
+		onReset: () => {
+			props.resetField(name);
+		}
+	});
+	const channel = (state.fields[FIELD.channel]?.text ?? "") === "monid" ? "monid" : "direct";
+	const key = state.keys[channel];
+	const keyChannel = channel === "monid" ? FIELD.monidApiKey : FIELD.apiKey;
+	const searchOn = switchValue(state.fields[FIELD.search]?.text ?? "");
+	const fetchOn = switchValue(state.fields[FIELD.fetch]?.text ?? "");
+	const resetButton = (name, overridden) => overridden && !disabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		onClick: () => {
+			props.resetField(name);
+		},
+		children: t("reset")
+	}) : null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.SettingsForm, {
+		labels: formLabels(t),
+		state: state.shell,
+		onSave: props.save,
+		onDiscard: props.discard,
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SegmentedControl, {
+					id: `plugin-config-tinyfish-${FIELD.channel}`,
+					label: t("channel"),
+					value: channel,
+					options: [{
+						value: "direct",
+						label: t("channelDirect")
+					}, {
+						value: "monid",
+						label: t("channelMonid")
+					}],
+					onChange: (next) => {
+						props.edit(FIELD.channel, next);
+					},
+					disabled
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("channelHint") }),
+				resetButton(FIELD.channel, state.fields[FIELD.channel]?.overridden ?? false)
+			] }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsSecretField, {
+				id: `plugin-config-tinyfish-${keyChannel}`,
+				label: channel === "monid" ? t("monidApiKey") : t("apiKey"),
+				hint: channel === "monid" ? t("monidApiKeyHint") : t("apiKeyHint"),
+				text: key.text,
+				disabled,
+				configured: key.named,
+				stateLabel: key.named ? t("apiKeySet") : t("apiKeyUnset"),
+				onEdit: (text) => {
+					props.edit(keyChannel, text);
+				}
+			}),
+			searchOn && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsValueField, {
+				...field(FIELD.purpose),
+				label: t("purpose"),
+				hint: t("purposeHint"),
+				invalidLabel: t("invalidText")
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.SettingsValueField, {
+				...field(FIELD.attempts),
+				label: t("attempts"),
+				hint: t("attemptsHint"),
+				invalidLabel: t("invalidNumber"),
+				numeric: true
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+					label: t("search"),
+					checked: searchOn,
+					onChange: (next) => {
+						props.edit(FIELD.search, String(next));
+					},
+					disabled
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("searchHint") }),
+				resetButton(FIELD.search, state.fields[FIELD.search]?.overridden ?? false)
+			] }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+					label: t("fetch"),
+					checked: fetchOn,
+					onChange: (next) => {
+						props.edit(FIELD.fetch, next.toString());
+					},
+					disabled
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("fetchHint") }),
+				resetButton(FIELD.fetch, state.fields[FIELD.fetch]?.overridden ?? false)
+			] }),
+			!searchOn && !fetchOn && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("bothOff") })
+		]
+	});
+}
+/**
+* Mount the TinyFish settings page while the Host serves its namespace.
+*
+* @param ctx - the browser plugin context.
+*/
+function apply(ctx) {
+	ctx.effect(() => {
+		ctx.locale.register(NS, {
+			zh,
+			en
+		});
+	}, "dsh-tinyfish: dictionaries");
+	const scope = ctx.configForms.get(NS);
+	const model = new _deepseek_ai_dsh_client_ui_primitives.SettingsFormModel(scope, SPECS, [{
+		field: FIELD.apiKey,
+		write: async (text) => {
+			try {
+				await ctx.remote.credentials.set(refOf(scope.getSnapshot(), "direct"), text);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	}, {
+		field: FIELD.monidApiKey,
+		write: async (text) => {
+			try {
+				await ctx.remote.credentials.set(refOf(scope.getSnapshot(), "monid"), text);
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	}]);
+	const store = model.bind(() => ({
+		shell: model.shell(),
+		fields: Object.fromEntries(SPECS.map((spec) => [spec.field, model.field(spec.field)])),
+		keys: {
+			direct: {
+				text: model.field(FIELD.apiKey).text,
+				named: refOf(scope.getSnapshot(), "direct") !== DEFAULT_API_KEY_REF
+			},
+			monid: {
+				text: model.field(FIELD.monidApiKey).text,
+				named: refOf(scope.getSnapshot(), "monid") !== DEFAULT_MONID_KEY_REF
+			}
+		}
+	}));
+	ctx.effect(() => () => {
+		model.dispose();
+	}, "dsh-tinyfish: form subscription");
+	ctx.effect(() => {
+		ctx.configForms.whileServed([NS], () => {
+			ctx.slots.inject("plugins.bundle.config", () => {
+				ctx.slots.register({
+					name: "plugins.bundle.config",
+					key: "dsh-tinyfish",
+					locale: NS,
+					inject: () => ({
+						hooks: { tinyfishCard: store },
+						...model.actions()
+					})
+				}, TinyfishCard);
+			});
+		});
+	}, "dsh-tinyfish: page");
+}
+//#endregion
+exports.NS = NS;
+exports.apply = apply;
+exports.inject = inject;
+
+    return module.exports;
+  },
+});