@lapis-notes/api 0.1.0 → 0.1.2

package/dist/plugin-distribution/manager.d.ts

@@ -2,7 +2,9 @@ import { EventDispatcher } from "../events";
 import type { DataAdapter } from "../storage/fs";
 import { type PluginBinaryFetch, type PluginInstallerManager } from "./installer";
 import type { PluginBundleVerificationMode } from "./plugin-bundle-worker";
-import type { InstalledPluginRecord, PluginCatalogDetail, PluginCatalogEntry, PluginCatalogIndex, PluginCompatibilityResult, PluginPlatform, PluginProvenance, PluginRegistryChannel, PluginRevocationRecord, PluginRegistrySource, TrustedSigningKey } from "./types";
+import { type ParsedNostrPluginBundle } from "./plugin-bundle";
+import type { VerifiedPluginBundlePayload } from "./plugin-bundle-verifier";
+import type { InstalledPluginRecord, PluginCatalogDetail, PluginCatalogEntry, PluginCatalogIndex, PluginCompatibilityResult, PluginDownloadStatsSummary, PluginPlatform, PluginProvenance, PluginRegistryChannel, PluginRevocationIndex, PluginRevocationRecord, PluginRegistrySource, PluginRegistrySourceKind, PluginRegistrySourceState, TrustedSigningKey } from "./types";
 export type PluginInstallPhase = "resolving" | "fetching-catalog" | "fetching-release" | "verifying-signature" | "downloading-bundle" | "verifying-bundle" | "extracting-files" | "verifying-files" | "staging" | "installing" | "loading" | "enabling" | "complete" | "failed";
 export interface PluginInstallProgressEvent {
     pluginId: string;
@@ -64,9 +66,16 @@ export interface PluginDistributionManager {
     refreshCatalog(options?: {
         force?: boolean;
     }): Promise<PluginCatalogIndex>;
+    getDownloadStats?(options?: {
+        force?: boolean;
+    }): Promise<PluginDownloadStatsSummary | null>;
+    listSources(): readonly PluginRegistrySourceState[];
+    setSourceEnabled(sourceId: string, enabled: boolean): Promise<void>;
     search(query?: PluginSearchQuery): PluginCatalogEntry[];
     getCatalogEntry(pluginId: string): PluginCatalogEntry | undefined;
-    getPluginDetail(pluginId: string): Promise<PluginCatalogDetail | null>;
+    getPluginDetail(pluginId: string, options?: {
+        registryId?: string;
+    }): Promise<PluginCatalogDetail | null>;
     install(pluginId: string, options?: InstallPluginOptions): Promise<InstalledPluginRecord>;
     installBundle(bundle: ArrayBuffer | Uint8Array, options?: InstallPluginBundleOptions): Promise<InstalledPluginRecord>;
     update(pluginId: string, version?: string, options?: UpdatePluginOptions): Promise<InstalledPluginRecord | null>;
@@ -76,6 +85,39 @@ export interface PluginDistributionManager {
     listUpdates(): Promise<PluginUpdateInfo[]>;
     addProgressListener(listener: PluginInstallProgressListener): () => void;
 }
+export interface PluginRegistryAdapterRefreshResult {
+    index: PluginCatalogIndex;
+    revocations?: PluginRevocationIndex;
+    /** Nostr adapters set this only after their configured relay quorum agrees. */
+    installReady: boolean;
+    stale?: boolean;
+    message?: string;
+}
+export interface PluginRegistryAdapter {
+    refresh(source: PluginRegistrySource, options?: {
+        force?: boolean;
+    }): Promise<PluginRegistryAdapterRefreshResult>;
+    getDetail(source: PluginRegistrySource, entry: PluginCatalogEntry): Promise<PluginCatalogDetail>;
+    getDownloadStats?(source: PluginRegistrySource, options?: {
+        force?: boolean;
+    }): Promise<PluginDownloadStatsSummary | null>;
+    /**
+     * Nostr adapters verify the portable proof and payload before returning it.
+     * The manager still applies compatibility, runtime, staging, and lifecycle
+     * checks through the normal installer.
+     */
+    getVerifiedBundle?(source: PluginRegistrySource, entry: PluginCatalogEntry, detail: PluginCatalogDetail, version: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<VerifiedPluginBundlePayload>;
+    /** Verify a self-contained offline Nostr bundle without claiming freshness. */
+    verifyOfflineBundle?(source: PluginRegistrySource, bundle: ParsedNostrPluginBundle, options?: {
+        signal?: AbortSignal;
+    }): Promise<VerifiedPluginBundlePayload>;
+    /** Revalidate a stored Nostr proof against a live install-ready source. */
+    revalidateInstalledProof?(source: PluginRegistrySource, record: InstalledPluginRecord, options?: {
+        signal?: AbortSignal;
+    }): Promise<NonNullable<InstalledPluginRecord["nostrProof"]>>;
+}
 export interface DefaultPluginDistributionManagerOptions {
     adapter: DataAdapter;
     appVersion: string;
@@ -86,6 +128,7 @@ export interface DefaultPluginDistributionManagerOptions {
     fetch?: PluginBinaryFetch;
     pluginManager?: PluginInstallerManager;
     bundleVerification?: PluginBundleVerificationMode;
+    registryAdapters?: Partial<Record<PluginRegistrySourceKind, PluginRegistryAdapter>>;
 }
 export declare const DEFAULT_OFFICIAL_PLUGIN_REGISTRY_SOURCE: PluginRegistrySource;
 export declare const DEFAULT_PLUGIN_REGISTRY_SOURCES: PluginRegistrySource[];
@@ -95,34 +138,57 @@ export declare class DefaultPluginDistributionManager extends EventDispatcher<{
 }> implements PluginDistributionManager {
     private readonly options;
     private catalog;
-    private readonly registryClient;
+    private readonly httpClients;
+    private readonly sourceCatalogs;
     private readonly stateStore;
+    private readonly sourcePreferenceStore;
     private readonly installer;
-    private readonly registries;
+    private registries;
     private readonly trustedKeys;
+    private readonly registryAdapters;
+    private readonly sourceStates;
+    private readonly entrySources;
     private installedIds;
     private revocations;
+    private sourcePreferencesLoaded;
     constructor(options: DefaultPluginDistributionManagerOptions);
     refreshCatalog(_options?: {
         force?: boolean;
     }): Promise<PluginCatalogIndex>;
+    getDownloadStats(options?: {
+        force?: boolean;
+    }): Promise<PluginDownloadStatsSummary | null>;
+    listSources(): readonly PluginRegistrySourceState[];
+    setSourceEnabled(sourceId: string, enabled: boolean): Promise<void>;
     search(query?: PluginSearchQuery): PluginCatalogEntry[];
     getCatalogEntry(pluginId: string): PluginCatalogEntry | undefined;
-    getPluginDetail(pluginId: string): Promise<PluginCatalogDetail | null>;
+    getPluginDetail(pluginId: string, options?: {
+        registryId?: string;
+    }): Promise<PluginCatalogDetail | null>;
     install(pluginId: string, options?: InstallPluginOptions): Promise<InstalledPluginRecord>;
     installBundle(bundle: ArrayBuffer | Uint8Array, options?: InstallPluginBundleOptions): Promise<InstalledPluginRecord>;
+    private verifyOfflineNostrBundle;
     update(pluginId: string, version?: string, options?: UpdatePluginOptions): Promise<InstalledPluginRecord | null>;
     uninstall(pluginId: string, options?: UninstallPluginOptions): Promise<void>;
     listInstalled(): Promise<InstalledPluginRecord[]>;
     getInstalled(pluginId: string): Promise<InstalledPluginRecord | null>;
     listUpdates(): Promise<PluginUpdateInfo[]>;
     addProgressListener(listener: PluginInstallProgressListener): () => void;
+    private httpClient;
+    private entryForSource;
+    private installedSource;
     private requireEntry;
     private sourceForEntry;
+    private sourceKind;
+    private adapterForSource;
     private compatibilityInput;
     private get platform();
     private isWorkspaceTrusted;
+    private ensureSourcePreferencesLoaded;
+    private loadSourcePreferences;
+    private syncSourceStates;
     private applyRevocationsToInstalled;
+    private revalidateInstalledNostrProofs;
     private revocationFor;
     private emitProgress;
 }