Files
kandev/apps/web/lib/api/domains/marketplace-api.ts
T
João Salavisa bc2f310e73 feat(plugins): add plugin marketplace with curated registry and updates (#1798)
* feat(plugins): add plugin marketplace with curated registry and updates

Discover and install plugins from inside kandev instead of only by URL/upload.

- Backend marketplace subpackage: SQLite-backed sources, catalog fetch/merge
  (dedup, install_state, degraded-source handling), and the /api/plugins/
  marketplace[/sources] API. Install reuses the existing install-by-URL pipeline.
- Frontend: Settings > Plugins gains a Browse tab (search/category/star sort),
  source management, one-click install, and an Update button on the Installed
  tab when the catalog has a newer version. Plugins may ship an icon (manifest
  `icon` -> catalog icon_url) with a letter-tile fallback.
- Registry infra: plugin-registry/ (curated plugins.yaml + schema.json) and two
  GitHub Actions (zero-dependency Node build-index.mjs -> index.json on Pages,
  daily star refresh). Ships empty at launch; the empty catalog is valid.
- Spec: docs/specs/plugins/marketplace.md. No download telemetry; stars only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(plugins): address marketplace PR review feedback

- CodeQL: stub fetch routers keyed off a path segment, not a hostname substring.
- Nullable stars end to end: a failed star lookup stays unknown (not 0) and
  sorts last, instead of decoding null -> 0 and corrupting ranking.
- Fetch marketplace sources concurrently and dedupe identical in-flight
  downloads (singleflight), so a slow source can't serialize the Browse tab.
- Register /marketplace routes before the /:id wildcard (gin tree ordering).
- Duplicate source URL returns 409 ErrDuplicateSource, not a raw SQL error.
- Browse: filter category client-side so the category dropdown never collapses.
- marketplaceInstall swallows after toasting (no unhandled promise rejection).
- Source badge keys off source_id, not a name substring.
- build-index: read block-sequence manifest categories, not just inline.
- Registry index workflow validates on pull_request; Pages deploy gated to
  push/schedule/dispatch. Spec: align package_sha256 (advisory in v1) + sort enum.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(plugins): guard catalog repo_url against javascript: href injection

repo_url comes from an untrusted index.json, so a malicious/compromised source
could set a javascript: URL that runs in the operator's session when the Repo
link is clicked (rel/target don't block it). Only render the anchor for http(s)
schemes. Adds regression tests for the scheme guard and null-star rendering.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(plugins): require https for remote sources; test oversized download

- Reject remote plain-http marketplace sources (MITM catalog-poisoning risk);
  loopback http stays allowed for local dev/e2e fixtures.
- Add the missing oversized-response assertion to TestDownloadRejectsNon200AndOversized
  so the maxIndexBytes memory bound has coverage.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(plugins): detach source download from singleflight leader's context

Two concurrent Browse opens after a cache Refresh share one singleflight
download; if the leader's request context is canceled (it navigates away), the
waiters must not inherit that cancellation. Use context.WithoutCancel so values
are preserved but the leader can't cancel everyone; the client's 20s timeout
still bounds the download.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Kandev Agent <agent@kandev.dev>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-19 17:10:53 +01:00

97 lines
3.4 KiB
TypeScript

import { fetchJson, type ApiRequestOptions } from "../client";
import type { MarketplaceCatalog, MarketplaceSource } from "@/lib/types/plugins";
const BASE = "/api/plugins/marketplace";
// CatalogQuery is the filter/sort applied server-side to the merged catalog.
export type CatalogQuery = {
q?: string;
category?: string;
sort?: "stars" | "name" | "recent";
};
function toQueryString(query?: CatalogQuery): string {
if (!query) return "";
const params = new URLSearchParams();
if (query.q) params.set("q", query.q);
if (query.category) params.set("category", query.category);
if (query.sort) params.set("sort", query.sort);
const s = params.toString();
return s ? `?${s}` : "";
}
// getMarketplaceCatalog fetches the merged catalog across every enabled
// source (GET /api/plugins/marketplace), filtered/sorted by the query. Each
// entry is annotated with its install_state; degraded sources are reported in
// `sources` with healthy=false and omit their entries.
export async function getMarketplaceCatalog(
query?: CatalogQuery,
options?: ApiRequestOptions,
): Promise<MarketplaceCatalog> {
const res = await fetchJson<MarketplaceCatalog>(`${BASE}${toQueryString(query)}`, {
...options,
cache: "no-store",
});
return { plugins: res.plugins ?? [], sources: res.sources ?? [] };
}
// listMarketplaceSources returns every configured source, built-in first
// (GET /api/plugins/marketplace/sources).
export async function listMarketplaceSources(
options?: ApiRequestOptions,
): Promise<MarketplaceSource[]> {
const res = await fetchJson<{ sources?: MarketplaceSource[] }>(`${BASE}/sources`, options);
return res.sources ?? [];
}
// addMarketplaceSource registers a new operator source
// (POST /api/plugins/marketplace/sources). Throws ApiError on an invalid or
// duplicate URL (400).
export async function addMarketplaceSource(
name: string,
url: string,
options?: ApiRequestOptions,
): Promise<MarketplaceSource> {
return fetchJson<MarketplaceSource>(`${BASE}/sources`, {
...options,
init: { ...(options?.init ?? {}), method: "POST", body: JSON.stringify({ name, url }) },
});
}
// updateMarketplaceSource renames and/or enables/disables a source
// (PATCH /api/plugins/marketplace/sources/:id).
export async function updateMarketplaceSource(
id: string,
patch: { name?: string; enabled?: boolean },
options?: ApiRequestOptions,
): Promise<MarketplaceSource> {
return fetchJson<MarketplaceSource>(`${BASE}/sources/${encodeURIComponent(id)}`, {
...options,
init: { ...(options?.init ?? {}), method: "PATCH", body: JSON.stringify(patch) },
});
}
// deleteMarketplaceSource removes a non-builtin source
// (DELETE /api/plugins/marketplace/sources/:id). Throws ApiError 409 for the
// built-in official source.
export async function deleteMarketplaceSource(
id: string,
options?: ApiRequestOptions,
): Promise<{ deleted: boolean }> {
return fetchJson<{ deleted: boolean }>(`${BASE}/sources/${encodeURIComponent(id)}`, {
...options,
init: { ...(options?.init ?? {}), method: "DELETE" },
});
}
// refreshMarketplace drops the backend's cached source documents so the next
// catalog fetch re-hits every source (POST /api/plugins/marketplace/refresh).
export async function refreshMarketplace(
options?: ApiRequestOptions,
): Promise<{ refreshed: boolean }> {
return fetchJson<{ refreshed: boolean }>(`${BASE}/refresh`, {
...options,
init: { ...(options?.init ?? {}), method: "POST" },
});
}