dsh-plugin-shop 0.4.1 → 0.4.2

package/lib/types/client/locales.d.ts

@@ -48,6 +48,12 @@ export declare const zh: {
     installedVersion: string;
     latestVersion: string;
     update: string;
+    installed: string;
+    uninstall: string;
+    uninstalling: string;
+    uninstallFailed: string;
+    uninstallTransportFailed: string;
+    uninstalledRestartNotice: string;
     enabledSwitch: string;
     toggleFailed: string;
     hotApplyNote: string;
@@ -103,6 +109,12 @@ export declare const en: {
     installedVersion: string;
     latestVersion: string;
     update: string;
+    installed: string;
+    uninstall: string;
+    uninstalling: string;
+    uninstallFailed: string;
+    uninstallTransportFailed: string;
+    uninstalledRestartNotice: string;
     enabledSwitch: string;
     toggleFailed: string;
     hotApplyNote: string;

package/lib/types/client/useInstall.d.ts

@@ -1,4 +1,5 @@
 /** Install driving hook for one entry: start, poll to terminal, reset. */
+import { type Dispatch, type SetStateAction } from 'react';
 import { type InstallView } from './present.ts';
 import type { InstallArgs, ShopInstallResult, ShopInstallStatusResult } from '../host/index.ts';
 export interface UseInstallResult {
@@ -6,6 +7,14 @@ export interface UseInstallResult {
     start: (args: InstallArgs) => Promise<void>;
     reset: () => void;
 }
+/** The poll loop shared by the install and uninstall drivers: while the view
+ * is `running`, poll once per second and fold each status through the
+ * reducer. A poll failure is transient — the host retains the record, so the
+ * next tick finds it. The rejection handler must be present: an unhandled
+ * rejection here would escape the poll loop. */
+export declare function usePollStatus(view: InstallView, setView: Dispatch<SetStateAction<InstallView>>, installStatus: (args: {
+    installId: string;
+}) => Promise<ShopInstallStatusResult>): void;
 /** Drive one install: rejections, the polling loop at INSTALL_POLL_MS, and
  * terminal states. The interval is cleared on unmount and whenever the view
  * leaves `running`, so a done/failed/rejected install never polls again. */

package/lib/types/client/useUninstall.d.ts

@@ -0,0 +1,21 @@
+/** Uninstall driving hook for one entry: start, poll to terminal. Shares the
+ * install view machine and poll loop; the only difference is the start
+ * mapping — an uninstall business failure (not in the catalog / not
+ * installed) lands in the `failed` view with the host's published detail,
+ * never in the install `rejected` codes, which belong to the install gate
+ * (§7.2). */
+import type { ShopInstallStatusResult, ShopUninstallResult } from '../host/index.ts';
+import type { InstallView } from './present.ts';
+export interface UseUninstallResult {
+    view: InstallView;
+    start: (args: {
+        name: string;
+    }) => Promise<void>;
+}
+/** Drive one uninstall: the host's business union, the shared polling loop,
+ * and terminal states. The `rejected` install state never occurs here. */
+export declare function useUninstall(uninstall: (args: {
+    name: string;
+}) => Promise<ShopUninstallResult>, installStatus: (args: {
+    installId: string;
+}) => Promise<ShopInstallStatusResult>): UseUninstallResult;

package/lib/types/host/executor.d.ts

@@ -1,4 +1,7 @@
-/** Install executor: spawn the dsh CLI, stream its output, serialize per profile. */
+/** Plugin-command executor: spawn the dsh CLI, stream its output, serialize
+ * per profile. One implementation drives both `dsh plugin add` (install) and
+ * `dsh plugin remove` (uninstall); the only differences are the verb and the
+ * post-exit manifest confirmation. */
 export type InstallState = 'running' | 'done' | 'failed';
 export interface InstallStatus {
     state: InstallState;
@@ -13,11 +16,6 @@ interface RunningInstall {
 }
 /**
  * Run one `dsh plugin --profile <profile> add <spec>` and track it.
- * Never rolls back; a failure surfaces stderr verbatim plus the recovery hint
- * (§10). The shop never passes build-script flags: `allowBuilds` stays the
- * user's explicit decision in the CLI (§7.2).
- * The child inherits the current environment unless `env` is given — the
- * real-install test pins DSH_HOME to a temporary directory this way.
  * When `expectedName` is given, a zero exit is confirmed against the profile
  * manifest (§7.2 step 6) before the install reports `done`.
  */
@@ -29,4 +27,18 @@ export declare function startInstall(options: {
     expectedName?: string;
     onStatus?: (status: InstallStatus) => void;
 }): RunningInstall;
+/**
+ * Run one `dsh plugin --profile <profile> remove <name>` and track it.
+ * When `expectedName` is given, a zero exit is confirmed against the profile
+ * manifest — the bundle must actually have LEFT `dsh.profile.bundles` — before
+ * the uninstall reports `done`.
+ */
+export declare function startUninstall(options: {
+    profile: string;
+    name: string;
+    dshBin?: string;
+    env?: NodeJS.ProcessEnv;
+    expectedName?: string;
+    onStatus?: (status: InstallStatus) => void;
+}): RunningInstall;
 export {};

package/lib/types/host/index.d.ts

@@ -49,11 +49,25 @@ export interface ShopSetEnabledResult {
     ok: boolean;
     detail?: string;
 }
-/** `shop/outdated` entry (§7.3): one installed plugin behind the catalog. */
-export interface ShopOutdatedEntry {
+/** `shop/uninstallStart` result (§7.3): a name outside the catalog or not
+ * installed is a typed wire value with an author-readable `detail`, not a
+ * thrown RPC error. */
+export type ShopUninstallResult = {
+    ok: true;
+    installId: string;
+} | {
+    ok: false;
+    detail: string;
+};
+/** `shop/installed` entry (§7.3): one installed catalog plugin. `installed`
+ * is the profile manifest's dependency spec verbatim (a range, a tag, or
+ * `workspace:*`); `outdated` is the Host's verdict that the installed version
+ * sits behind the catalog's — the client never does version math. */
+export interface ShopInstalledEntry {
     name: string;
     installed: string;
     latest: string;
+    outdated: boolean;
 }
 /** `shop/catalog` result (§7.3), plus the denied list for the install gate's UI. */
 export interface ShopCatalogResult {
@@ -127,7 +141,24 @@ export declare class ShopGateway extends TypertRemoteService {
     installStatus(args: {
         installId: string;
     }): ShopInstallStatusResult;
-    /** Installed plugins whose installed version is older than the catalog's (§7.3). */
-    outdated(): Promise<ShopOutdatedEntry[]>;
+    /** Installed catalog plugins (§7.3): every entry of the snapshot the profile
+     * manifest declares as a dependency, with the Host's `outdated` verdict
+     * attached. The tab's shelf cards and its installed section both derive
+     * from this one list. */
+    installed(): Promise<ShopInstalledEntry[]>;
+    /** Whether an installed dependency spec sits behind the catalog's version.
+     * A spec identical to the catalog version is current by definition; a
+     * pnpm-written non-semver spec like `workspace:*` is not reportable and
+     * reads as current rather than killing the RPC. */
+    private isBehind;
+    /** Uninstall one installed catalog plugin from the profile (§7.3 follow-up
+     * amendment). Removing revokes privilege rather than granting it, so there
+     * is no acknowledgement gate. The name must be a catalog entry the profile
+     * manifest declares as a dependency — the RPC cannot remove profile
+     * dependencies the shop does not manage (the base bundle, the shop
+     * itself). The same install records/polling serve the client. */
+    uninstall(args: {
+        name: string;
+    }): Promise<ShopUninstallResult>;
 }
 export default ShopGateway;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-shop",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "The DeepSeek Harness plugin shop: browse, install, enable, and update dsh plugins from a git-auditable catalog.",
   "repository": {
     "type": "git",