@tomradex/community 0.14.0 → 0.15.1

package/dist/index.d.ts

@@ -2,5 +2,5 @@ export { Community, Community as default, CommunityConfig, type BrowseResult, ty
 export { PublishRefused, githubAccess, prepareRelease, type GitHubAccess, type Prepared } from "./publish.js";
 export { expansion, latestInstallable, planUpdate, revoked, type Revocation, type RiskLevel, type Tier, type UpdatePlan, type VersionRow } from "./rules.js";
 export { linkGitHub } from "./oauth.js";
-export { OFFICIAL_CATALOG_URL, OfficialCatalog, isOfficialId, type CatalogState } from "./official.js";
+export { OFFICIAL_CATALOG_URL, OfficialCatalog, bundleOfficialPlugins, isOfficialId, type CatalogState } from "./official.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/official.d.ts

@@ -1,8 +1,11 @@
 import { type Attestation, type Catalog } from "@tomradex/plugin-kit";
-import type { Revocation, VersionRow } from "./rules.js";
+import { type Revocation, type VersionRow } from "./rules.js";
 /** Where Tomrade's own plugins are released: github.com/haoyuant/tomrade-plugins. */
 export declare const OFFICIAL_CATALOG_URL = "https://github.com/haoyuant/tomrade-plugins/releases/download/catalog/catalog.json";
 export declare const isOfficialId: (id: string) => boolean;
+/** A bundle the app carries: the catalog it was built against, in the cache's shape, beside each package named for its digest. */
+export declare const BUNDLE_CATALOG = "catalog.json";
+export declare const bundledPackage: (dir: string, digest: string) => string;
 export interface CatalogState {
     /** When the catalog in use was fetched; null when there is none yet. */
     fetchedAt: number | null;
@@ -14,6 +17,8 @@ export interface OfficialCatalogOptions {
     url: string;
     /** Where the last good catalog is kept, so a machine offline still lists what it saw. */
     cacheFile?: string;
+    /** The catalog the app was built against, in the cache's shape: used offline when no newer copy is kept. */
+    bundleFile?: string;
     /** How long a fetched catalog is used before it is fetched again. */
     freshMs: number;
     /** Whether this build believes an attestation for a digest. */
@@ -39,11 +44,31 @@ export declare class OfficialCatalog {
     read(): Promise<Catalog>;
     private fetch;
     private save;
-    private cached;
+    private copy;
     private trusted;
     /** Plugins with at least one version this build trusts, as store rows. */
     plugins(): Promise<Record<string, unknown>[]>;
+    /** What the app carries, read without the network: the versions of these plugins and the revocations the bundled catalog lists. */
+    carried(ids: string[]): {
+        versions: VersionRow[];
+        revocations: Revocation[];
+    } | null;
     versions(ids: string[]): Promise<VersionRow[]>;
     revocations(): Promise<Revocation[]>;
 }
+/**
+ * What a build carries for a machine that cannot reach the catalog: the catalog as it stands, and the version of
+ * each plugin named that this Tomrade would install, downloaded and checked as an install checks it. Throws when
+ * one cannot be had, so a build never goes out without it.
+ */
+export declare function bundleOfficialPlugins(opts: {
+    url: string;
+    ids: string[];
+    dir: string;
+    verify(raw: unknown, digest: string): Attestation | null;
+}): Promise<{
+    id: string;
+    version: string;
+    digest: string;
+}[]>;
 //# sourceMappingURL=official.d.ts.map

package/dist/service.d.ts

@@ -13,9 +13,13 @@ export declare const CommunityConfig: z.ZodPreprocess<z.ZodObject<{
         cacheFile: z.ZodOptional<z.ZodString>;
         freshMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
+    officialBundle: z.ZodOptional<z.ZodObject<{
+        dir: z.ZodString;
+    }, z.core.$strip>>;
     starters: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         id: z.ZodString;
-        whenModelHost: z.ZodArray<z.ZodString>;
+        whenModelHost: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        replaces: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>]>>>;
     startersFile: z.ZodOptional<z.ZodString>;
     checkEveryMs: z.ZodDefault<z.ZodNumber>;
@@ -180,9 +184,13 @@ export declare class Community extends Service {
             cacheFile: z.ZodOptional<z.ZodString>;
             freshMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
+        officialBundle: z.ZodOptional<z.ZodObject<{
+            dir: z.ZodString;
+        }, z.core.$strip>>;
         starters: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             id: z.ZodString;
-            whenModelHost: z.ZodArray<z.ZodString>;
+            whenModelHost: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            replaces: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>]>>>;
         startersFile: z.ZodOptional<z.ZodString>;
         checkEveryMs: z.ZodDefault<z.ZodNumber>;
@@ -195,6 +203,8 @@ export declare class Community extends Service {
     private publisherCache;
     /** Packages fetched to be read before installing, by digest; installing takes them from here. */
     private downloadDir;
+    /** Bundled packages that did not verify: this run gets those builds from the network. */
+    private bundleRefused;
     /** For tests: GitHub access other than through the connected account. */
     github: GitHubAccess;
     readonly official: OfficialCatalog;
@@ -229,6 +239,8 @@ export declare class Community extends Service {
     plugin(id: string): Promise<PluginDetail>;
     /** Fetched once per digest: reading a version before installing it costs no second download. */
     private download;
+    /** The app's own copy of this exact build, checked as a download is; one that is not that build is passed over for the network. */
+    private fromBundle;
     private pick;
     /** Reads the exact package that would be installed, here, with the same analyzer the publisher ran. */
     inspect(id: string, version?: string): Promise<Inspection>;
@@ -254,7 +266,12 @@ export declare class Community extends Service {
     /** Official plugins not installed whose latest version this Tomrade can install contributes `kind`; none without a plugin store or a readable catalog. */
     providing(kind: string): Promise<Providing[]>;
     /** Each starter goes on once; one that cannot be fetched yet is tried again at the next check. */
-    installStarters(): Promise<void>;
+    /** `carried`: only starters that replace a row, from the app's own copies, with no network. */
+    installStarters(opts?: {
+        carried?: boolean;
+    }): Promise<void>;
+    /** The newest version of a plugin the app carries that it may install, and where it comes from. */
+    private carried;
     private putStarters;
     /** Revocations switch a plugin off; updates the rules allow land by themselves. */
     sweep(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/community",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,14 +27,14 @@
     "dist"
   ],
   "dependencies": {
-    "@tomradex/github": "0.14.0",
-    "@tomradex/hub-cloud": "0.14.0",
-    "@tomradex/ipc": "0.14.0",
-    "@tomradex/plugin-cli": "0.2.16",
-    "@tomradex/plugin-kit": "0.14.0",
-    "@tomradex/plugin-sdk": "0.2.16",
-    "@tomradex/plugins": "0.14.0",
-    "@tomradex/settings": "0.14.0",
+    "@tomradex/github": "0.15.1",
+    "@tomradex/hub-cloud": "0.15.1",
+    "@tomradex/ipc": "0.15.1",
+    "@tomradex/plugin-cli": "0.2.18",
+    "@tomradex/plugin-kit": "0.15.1",
+    "@tomradex/plugin-sdk": "0.2.18",
+    "@tomradex/plugins": "0.15.1",
+    "@tomradex/settings": "0.15.1",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   },