@eya46/dsh-plugin-info 0.0.2

package/lib/types/semver.d.ts

@@ -0,0 +1,18 @@
+/** Loose semver pieces used only to decide whether latest is newer. */
+export interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string[];
+}
+/** Strip a leading `v` and build metadata. */
+export declare function normalizeVersion(input: string): string;
+/** Parse `1.2.3`, `1.2.3-rc.1`, or `v1.2.3`. Returns undefined when not numeric. */
+export declare function parseVersion(input: string): ParsedVersion | undefined;
+/** Compare two parsed versions. Negative when `left` is older. */
+export declare function compareParsed(left: ParsedVersion, right: ParsedVersion): number;
+/** Compare two version strings. Unparseable values compare as equal (0). */
+export declare function compareVersions(left: string, right: string): number;
+/** True when `latest` is a newer published version than `installed`. */
+export declare function hasNewerVersion(installed: string | undefined, latest: string | undefined): boolean;
+//# sourceMappingURL=semver.d.ts.map

package/lib/types/service.d.ts

@@ -0,0 +1,36 @@
+import type { PluginConfig, PluginSummary, PluginVersionRow, VersionNotes } from './types.ts';
+/** Fetch a JSON payload with a timeout. */
+export type JsonFetcher = (url: string, timeoutMs: number, headers?: Record<string, string>) => Promise<unknown>;
+/** Query surface used by the HTTP API and tests. */
+export declare class PluginInfoService {
+    private readonly config;
+    private readonly fetchJson;
+    private readonly now;
+    private readonly packuments;
+    private readonly notes;
+    constructor(config: PluginConfig, fetchJson: JsonFetcher, now?: () => number);
+    /** List user-added plugins for one profile directory. */
+    listPlugins(profileDir: string): Promise<{
+        profile: string;
+        plugins: PluginSummary[];
+    }>;
+    /** Recent published versions for one user-added plugin. */
+    listVersions(profileDir: string, name: string, limit: number): Promise<{
+        name: string;
+        installedVersion?: string;
+        latestVersion?: string;
+        versions: PluginVersionRow[];
+    }>;
+    /** Update notes for one published version. */
+    versionNotes(profileDir: string, name: string, version: string): Promise<VersionNotes>;
+    private describePlugin;
+    private loadPackument;
+    private loadNotes;
+    private fetchGithubRelease;
+    private fetchGithubCompare;
+}
+/** Resolve the current profile directory from the Loader base URL. */
+export declare function profileDirFromBaseUrl(baseUrl: string | undefined): string;
+/** Default JSON fetch used by the live plugin. */
+export declare function fetchJson(url: string, timeoutMs: number, headers?: Record<string, string>): Promise<unknown>;
+//# sourceMappingURL=service.d.ts.map

package/lib/types/types.d.ts

@@ -0,0 +1,111 @@
+/** Where a profile dependency spec came from. */
+export type PluginSource = 'registry' | 'file' | 'link' | 'git' | 'other';
+/** One user-added profile plugin as the UI lists it. */
+export interface PluginSummary {
+    /** npm package name. */
+    name: string;
+    /** Installed package description, when present. */
+    description?: string;
+    /** Raw dependency spec from the profile manifest. */
+    spec: string;
+    /** Classified install source. */
+    source: PluginSource;
+    /** Version currently resolved in the profile. */
+    installedVersion?: string;
+    /** `dist-tags.latest` from the registry, when known. */
+    latestVersion?: string;
+    /** True when the registry latest is newer than the installed version. */
+    hasUpdate: boolean;
+    /** Package homepage. */
+    homepage?: string;
+    /** Normalized repository browse URL. */
+    repository?: string;
+    /** Why registry / install metadata is incomplete. */
+    error?: string;
+}
+/** One published version row. */
+export interface PluginVersionRow {
+    version: string;
+    publishedAt?: string;
+    latest: boolean;
+    installed: boolean;
+}
+/** How version notes were recovered. */
+export type VersionNotesSource = 'github-release' | 'github-compare' | 'none';
+/** One commit summarized from a GitHub compare. */
+export interface VersionCommit {
+    sha: string;
+    message: string;
+    url?: string;
+}
+/** Update notes for one published version. */
+export interface VersionNotes {
+    name: string;
+    version: string;
+    source: VersionNotesSource;
+    publishedAt?: string;
+    title?: string;
+    body?: string;
+    url?: string;
+    commits?: VersionCommit[];
+}
+/** Parsed profile manifest slice this plugin reads. */
+export interface ProfileManifest {
+    name?: string;
+    dependencies?: Record<string, string>;
+    dsh?: {
+        profile?: {
+            bundles?: string[];
+        };
+    };
+}
+/** Installed package.json fields used by the listing. */
+export interface InstalledPackage {
+    name: string;
+    version?: string;
+    description?: string;
+    homepage?: string;
+    repository?: string | {
+        url?: string;
+        directory?: string;
+    };
+}
+/** npm packument subset. */
+export interface Packument {
+    name?: string;
+    description?: string;
+    homepage?: string;
+    repository?: string | {
+        url?: string;
+        directory?: string;
+    };
+    'dist-tags'?: Record<string, string>;
+    versions?: Record<string, {
+        version?: string;
+        description?: string;
+        homepage?: string;
+        repository?: string | {
+            url?: string;
+            directory?: string;
+        };
+    }>;
+    time?: Record<string, string>;
+}
+/** Plugin configuration. */
+export interface PluginConfig {
+    /** npm registry origin. */
+    registryUrl: string;
+    /** Default number of recent versions to return. */
+    defaultVersionLimit: number;
+    /** HTTP timeout for registry / GitHub requests. */
+    timeoutMs: number;
+    /** How long packument and notes stay cached. */
+    cacheTtlMs: number;
+    /**
+     * Optional allow-list: when non-empty, only plugins whose npm name starts
+     * with one of these prefixes (case-insensitive, e.g. `@eya46/`) appear in
+     * the settings page and the version/notes APIs. Set to `[]` to show all.
+     */
+    allowScopes: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@eya46/dsh-plugin-info",
+  "description": "List profile-added DSH plugins, mark available updates, and show recent version notes",
+  "version": "0.0.2",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json",
+    "./client": {
+      "types": "./lib/types/client.d.ts",
+      "default": "./lib/client.js"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh-plugin",
+    "plugins",
+    "versions"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eya46/dsh-plugins.git"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7",
+    "@types/node": "^22.20.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsdown --config tsdown.config.ts && tsc -p tsconfig.client.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
+    "test": "vitest run --config vitest.config.ts"
+  }
+}