@bridgething/catalog 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { AppEntry, AppVersion, Catalog, Download, InstallCount, RecommendedSource, Repo, SourceCatalog, } from './types.ts';
+export { CatalogValidationError, validate, validateInvariants, validateSchema } from './validate.ts';
+export { releasedAtInstant, sortNewestFirst } from './versions.ts';
+export { aggregate, compareVersions, isListedWebapp, listedWebapps, newestCompatible, pinsFrom, recommendedSources, satisfies, updates, versionCompatible, type CatalogAppListing, type CatalogAppUpdate, type InstalledWebapp, } from './resolve.ts';
+export { blendStoreListings, type StoreListings } from './blend.ts';
+export { DIRECTORY_ORIGIN, OFFICIAL_CATALOG_URL, SOURCE_DIRECTORY_URL, SourceUrlError, fetchCatalog, fetchMergedApps, fetchSources, normalizeSourceUrl, parseSourceUrl, reportInstall, type CatalogSnapshot, type InstallReport, type MergedApps, type MergedCatalog, type SourceFailure, } from './sources.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,IAAI,EACJ,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { CatalogValidationError, validate, validateInvariants, validateSchema } from "./validate.js";
+export { releasedAtInstant, sortNewestFirst } from "./versions.js";
+export { aggregate, compareVersions, isListedWebapp, listedWebapps, newestCompatible, pinsFrom, recommendedSources, satisfies, updates, versionCompatible, } from "./resolve.js";
+export { blendStoreListings } from "./blend.js";
+export { DIRECTORY_ORIGIN, OFFICIAL_CATALOG_URL, SOURCE_DIRECTORY_URL, SourceUrlError, fetchCatalog, fetchMergedApps, fetchSources, normalizeSourceUrl, parseSourceUrl, reportInstall, } from "./sources.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,SAAS,EACT,OAAO,EACP,iBAAiB,GAIlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AAEpE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,aAAa,GAMd,MAAM,cAAc,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,55 @@
+import type { AppEntry, AppVersion, Catalog, InstallCount, RecommendedSource, SourceCatalog } from './types.ts';
+export type InstalledWebapp = {
+    id: string;
+    version: string;
+    source: 'builtin' | 'installed';
+    role: 'standard' | 'launcher';
+    provenance?: string | null;
+};
+export type CatalogAppListing = {
+    app: AppEntry;
+    sourceUrl: string;
+    newestCompatible: AppVersion | null;
+    installedVersion: string | null;
+    updateAvailable: boolean;
+    alsoAvailableFrom: string[];
+    installs: number;
+};
+export type CatalogAppUpdate = {
+    appId: string;
+    name: string;
+    installedVersion: string;
+    target: AppVersion;
+    sourceUrl: string;
+};
+export declare function satisfies(deviceVersion: string, minimum: string): boolean;
+export declare function isUpgrade(candidate: string, installed: string): boolean;
+export declare function compareVersions(a: string, b: string): number;
+export declare function pinsFrom(installed: InstalledWebapp[]): Map<string, string>;
+export declare function versionCompatible(version: AppVersion, deviceLibVersion: string | null): boolean;
+export declare function newestCompatible(app: AppEntry, deviceLibVersion: string | null): AppVersion | null;
+export declare function isListedWebapp(webapp: {
+    role: string;
+    source: string;
+}): boolean;
+export declare function listedWebapps<T extends {
+    role: string;
+    source: string;
+}>(list: T[]): T[];
+export declare function aggregate(args: {
+    orderedCatalogs: SourceCatalog[];
+    installed: InstalledWebapp[];
+    deviceLibVersion: string | null;
+    installs?: InstallCount[];
+}): CatalogAppListing[];
+export declare function updates(args: {
+    catalogs: Map<string, Catalog>;
+    installed: InstalledWebapp[];
+    deviceLibVersion: string | null;
+}): CatalogAppUpdate[];
+export declare function recommendedSources(args: {
+    directory: Catalog | null;
+    orderedCatalogs: SourceCatalog[];
+    subscribed: string[];
+}): RecommendedSource[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,QAAQ,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS5D;AAaD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAE/F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAElG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEhF;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAExF;AAaD,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B,GAAG,iBAAiB,EAAE,CAuCtB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GAAG,gBAAgB,EAAE,CAwBrB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,GAAG,iBAAiB,EAAE,CAiBtB"}

package/dist/resolve.js

@@ -0,0 +1,142 @@
+import { sortNewestFirst } from "./versions.js";
+export function satisfies(deviceVersion, minimum) {
+    return compareVersions(deviceVersion, minimum) >= 0;
+}
+export function isUpgrade(candidate, installed) {
+    return compareVersions(candidate, installed) > 0;
+}
+export function compareVersions(a, b) {
+    const pa = versionComponents(a);
+    const pb = versionComponents(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (x !== y)
+            return x < y ? -1 : 1;
+    }
+    return 0;
+}
+function versionComponents(raw) {
+    let v = raw.trim();
+    if (v.startsWith('v') || v.startsWith('V'))
+        v = v.slice(1);
+    const cut = v.search(/[-+]/);
+    if (cut !== -1)
+        v = v.slice(0, cut);
+    return v.split('.').map(part => {
+        const n = Number.parseInt(part, 10);
+        return Number.isNaN(n) ? 0 : n;
+    });
+}
+export function pinsFrom(installed) {
+    const out = new Map();
+    for (const info of installed) {
+        if (info.provenance)
+            out.set(info.id.toLowerCase(), info.provenance);
+    }
+    return out;
+}
+export function versionCompatible(version, deviceLibVersion) {
+    return deviceLibVersion === null || satisfies(deviceLibVersion, version.min_libbridgething_version);
+}
+export function newestCompatible(app, deviceLibVersion) {
+    return sortNewestFirst(app.versions).find(v => versionCompatible(v, deviceLibVersion)) ?? null;
+}
+export function isListedWebapp(webapp) {
+    return webapp.role !== 'launcher' || webapp.source === 'installed';
+}
+export function listedWebapps(list) {
+    return list.filter(isListedWebapp);
+}
+function installsById(counts) {
+    const out = new Map();
+    for (const entry of counts) {
+        const tally = Number(entry.count);
+        if (!Number.isFinite(tally) || tally <= 0)
+            continue;
+        const id = entry.app_id.toLowerCase();
+        out.set(id, (out.get(id) ?? 0) + tally);
+    }
+    return out;
+}
+export function aggregate(args) {
+    const { orderedCatalogs, installed, deviceLibVersion } = args;
+    const installedById = new Map(installed.map(i => [i.id.toLowerCase(), i]));
+    const tallies = installsById(args.installs ?? []);
+    const pins = pinsFrom(installed);
+    const offerings = new Map();
+    for (const { url, catalog } of orderedCatalogs) {
+        for (const app of catalog.apps) {
+            const list = offerings.get(app.id.toLowerCase());
+            if (list)
+                list.push({ url, app });
+            else
+                offerings.set(app.id.toLowerCase(), [{ url, app }]);
+        }
+    }
+    const listings = [];
+    for (const [id, offers] of offerings) {
+        if (offers.length === 0)
+            continue;
+        const pinned = pins.get(id);
+        const primary = offers.find(o => o.url === pinned) ?? offers[0];
+        const alsoAvailableFrom = offers.filter(o => o.url !== primary.url).map(o => o.url);
+        const newest = newestCompatible(primary.app, deviceLibVersion);
+        const installedVersion = installedById.get(id)?.version ?? null;
+        listings.push({
+            app: primary.app,
+            sourceUrl: primary.url,
+            newestCompatible: newest,
+            installedVersion,
+            updateAvailable: installedVersion !== null && newest !== null && isUpgrade(newest.version, installedVersion),
+            alsoAvailableFrom,
+            installs: tallies.get(id) ?? 0,
+        });
+    }
+    return listings.sort((a, b) => b.installs - a.installs || a.app.name.localeCompare(b.app.name) || a.app.id.localeCompare(b.app.id));
+}
+export function updates(args) {
+    const { catalogs, installed, deviceLibVersion } = args;
+    const pins = pinsFrom(installed);
+    const out = [];
+    for (const info of installed) {
+        if (info.source !== 'installed' || info.role !== 'standard')
+            continue;
+        const id = info.id.toLowerCase();
+        const sourceUrl = pins.get(id);
+        if (!sourceUrl)
+            continue;
+        const app = catalogs.get(sourceUrl)?.apps.find(a => a.id.toLowerCase() === id);
+        if (!app)
+            continue;
+        const newest = newestCompatible(app, deviceLibVersion);
+        if (!newest || !isUpgrade(newest.version, info.version))
+            continue;
+        out.push({
+            appId: id,
+            name: app.name,
+            installedVersion: info.version,
+            target: newest,
+            sourceUrl,
+        });
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name) || a.appId.localeCompare(b.appId));
+}
+export function recommendedSources(args) {
+    const subscribed = new Set(args.subscribed);
+    const byUrl = new Map();
+    for (const candidate of args.directory?.recommended_sources ?? []) {
+        if (subscribed.has(candidate.url) || byUrl.has(candidate.url))
+            continue;
+        byUrl.set(candidate.url, candidate);
+    }
+    for (const { catalog } of args.orderedCatalogs) {
+        for (const candidate of catalog.recommended_sources) {
+            if (subscribed.has(candidate.url) || byUrl.has(candidate.url))
+                continue;
+            byUrl.set(candidate.url, { ...candidate, attested: false });
+        }
+    }
+    return [...byUrl.values()].sort((a, b) => Number(b.attested) - Number(a.attested) || a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"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"}

package/dist/sources.d.ts

@@ -0,0 +1,45 @@
+import type { Catalog, InstallCount, SourceCatalog } from './types.ts';
+export declare const OFFICIAL_CATALOG_URL = "https://apps.bridgething.com/catalog.json";
+export declare const SOURCE_DIRECTORY_URL = "https://bridgething.com/api/sources.json";
+export declare const DIRECTORY_ORIGIN = "https://bridgething.com";
+export type SourceFailure = {
+    url: string;
+    reason: string;
+};
+export type CatalogSnapshot = {
+    catalogs: SourceCatalog[];
+    directory: Catalog | null;
+    failures: SourceFailure[];
+};
+export declare class SourceUrlError extends Error {
+}
+export declare function parseSourceUrl(raw: string): URL;
+export declare function normalizeSourceUrl(raw: string): string;
+export declare function fetchCatalog(url: string): Promise<Catalog>;
+export type MergedCatalog = {
+    url: string;
+    official: boolean;
+    attested: boolean;
+    catalog: Catalog;
+};
+export type MergedApps = {
+    updated_at: string;
+    catalogs: MergedCatalog[];
+    failures: SourceFailure[];
+    skipped: string[];
+    installs: InstallCount[];
+};
+export declare function fetchMergedApps(init?: {
+    origin?: string;
+    signal?: AbortSignal;
+}): Promise<MergedApps>;
+export type InstallReport = {
+    appId: string;
+    sourceUrl: string;
+    version?: string | null;
+};
+export declare function reportInstall(install: InstallReport, init?: {
+    origin?: string;
+}): void;
+export declare function fetchSources(urls: string[]): Promise<CatalogSnapshot>;
+//# sourceMappingURL=sources.d.ts.map

package/dist/sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.d.ts","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvE,eAAO,MAAM,oBAAoB,8CAA8C,CAAC;AAEhF,eAAO,MAAM,oBAAoB,6CAA6C,CAAC;AAE/E,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAI5C,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAoB/C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIhE;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAY3G;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBtF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB3E"}

package/dist/sources.js

@@ -0,0 +1,95 @@
+import { validate } from "./validate.js";
+export const OFFICIAL_CATALOG_URL = 'https://apps.bridgething.com/catalog.json';
+export const SOURCE_DIRECTORY_URL = 'https://bridgething.com/api/sources.json';
+export const DIRECTORY_ORIGIN = 'https://bridgething.com';
+export class SourceUrlError extends Error {
+}
+const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:\/\//i;
+export function parseSourceUrl(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        throw new SourceUrlError('a source url cannot be empty');
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        throw new SourceUrlError(`"${trimmed}" is not a url`);
+    }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:') {
+        throw new SourceUrlError(`a source url must be http or https, not ${url.protocol.replace(':', '')}`);
+    }
+    if (url.username || url.password) {
+        throw new SourceUrlError('a source url must not carry credentials');
+    }
+    url.hash = '';
+    return url;
+}
+export function normalizeSourceUrl(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        throw new SourceUrlError('a source url cannot be empty');
+    const url = parseSourceUrl(HAS_SCHEME.test(trimmed) ? trimmed : `https://${trimmed}`);
+    if (url.pathname.endsWith('/'))
+        url.pathname += 'catalog.json';
+    return url.toString();
+}
+export async function fetchCatalog(url) {
+    const response = await fetch(url, { headers: { accept: 'application/json' } });
+    if (!response.ok)
+        throw new Error(`${url} returned ${response.status}`);
+    return validate(await response.json());
+}
+export async function fetchMergedApps(init) {
+    const origin = init?.origin ?? DIRECTORY_ORIGIN;
+    const response = await fetch(`${origin}/api/apps.json`, {
+        headers: { accept: 'application/json' },
+        signal: init?.signal,
+    });
+    if (!response.ok)
+        throw new Error(`the app directory returned ${response.status}`);
+    const body = (await response.json());
+    if (!body || !Array.isArray(body.catalogs)) {
+        throw new Error('the app directory returned an unexpected shape');
+    }
+    return { ...body, installs: Array.isArray(body.installs) ? body.installs : [] };
+}
+export function reportInstall(install, init) {
+    const origin = init?.origin ?? DIRECTORY_ORIGIN;
+    const body = JSON.stringify({
+        app_id: install.appId,
+        source_url: install.sourceUrl,
+        version: install.version ?? null,
+    });
+    void Promise.resolve()
+        .then(() => fetch(`${origin}/api/installs`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        keepalive: true,
+        body,
+    }))
+        .catch(() => undefined);
+}
+export async function fetchSources(urls) {
+    const results = await Promise.all([...urls, SOURCE_DIRECTORY_URL].map(async (url) => {
+        try {
+            return { url, catalog: await fetchCatalog(url) };
+        }
+        catch (reason) {
+            return { url, reason: reason instanceof Error ? reason.message : String(reason) };
+        }
+    }));
+    const catalogs = [];
+    const failures = [];
+    let directory = null;
+    for (const result of results) {
+        if ('reason' in result)
+            failures.push(result);
+        else if (result.url === SOURCE_DIRECTORY_URL)
+            directory = result.catalog;
+        else
+            catalogs.push(result);
+    }
+    return { catalogs, directory, failures };
+}
+//# sourceMappingURL=sources.js.map

package/dist/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export type Catalog = {
+    $schema?: string;
+    schema: 'catalog.v1';
+    updated_at: string;
+    repo: Repo;
+    apps: AppEntry[];
+    recommended_sources: RecommendedSource[];
+};
+export type Repo = {
+    name: string;
+    description: string;
+    homepage: string | null;
+    icon: string | null;
+};
+export type AppEntry = {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    icon: string | null;
+    homepage: string | null;
+    source: string | null;
+    versions: AppVersion[];
+};
+export type AppVersion = {
+    version: string;
+    released_at: string;
+    download: Download;
+    permissions: string[];
+    role?: 'standard' | 'launcher';
+    provides_overlay?: boolean;
+    min_libbridgething_version: string;
+    changelog: string | null;
+};
+export type Download = {
+    url: string;
+    size: number;
+    sha256: string;
+};
+export type RecommendedSource = {
+    name: string;
+    url: string;
+    description: string | null;
+    attested: boolean;
+};
+export type SourceCatalog = {
+    url: string;
+    catalog: Catalog;
+};
+export type InstallCount = {
+    app_id: string;
+    source_url: string;
+    count: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B,EAAE,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validate.d.ts

@@ -0,0 +1,9 @@
+import type { Catalog } from './types.ts';
+export declare class CatalogValidationError extends Error {
+    readonly errors: string[];
+    constructor(message: string, errors: string[]);
+}
+export declare function validateSchema(catalog: unknown): asserts catalog is Catalog;
+export declare function validateInvariants(catalog: Catalog): void;
+export declare function validate(catalog: unknown): Catalog;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,MAAM,EAAE,MAAM,EAAE;gBADhC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAAE;CAKnC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAK3E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuCzD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAIlD"}

package/dist/validate.js

@@ -0,0 +1,57 @@
+import validateSchemaFn from './generated/schema.v1.validator.mjs';
+const UUIDV7 = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export class CatalogValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(`${message}\n  - ${errors.join('\n  - ')}`);
+        this.errors = errors;
+        this.name = 'CatalogValidationError';
+    }
+}
+export function validateSchema(catalog) {
+    if (!validateSchemaFn(catalog)) {
+        const errs = (validateSchemaFn.errors ?? []).map(e => `${e.instancePath || '<root>'}: ${e.message ?? 'invalid'}`);
+        throw new CatalogValidationError('catalog failed schema validation', errs);
+    }
+}
+export function validateInvariants(catalog) {
+    const errors = [];
+    const seenIds = new Map();
+    for (const app of catalog.apps) {
+        const prior = seenIds.get(app.id);
+        if (prior) {
+            errors.push(`app id "${app.id}" used by both "${prior}" and "${app.name}"`);
+        }
+        else {
+            seenIds.set(app.id, app.name);
+        }
+        if (!UUIDV7.test(app.id)) {
+            errors.push(`app "${app.name}" id "${app.id}" is not a valid uuidv7`);
+        }
+        const seenVersions = new Set();
+        for (const v of app.versions) {
+            if (seenVersions.has(v.version)) {
+                errors.push(`app "${app.name}" lists version "${v.version}" more than once`);
+            }
+            else {
+                seenVersions.add(v.version);
+            }
+        }
+        for (let i = 1; i < app.versions.length; i++) {
+            const prev = app.versions[i - 1];
+            const cur = app.versions[i];
+            if (prev.released_at < cur.released_at) {
+                errors.push(`app "${app.name}" versions are not newest-first: "${prev.version}" (${prev.released_at}) precedes "${cur.version}" (${cur.released_at})`);
+            }
+        }
+    }
+    if (errors.length) {
+        throw new CatalogValidationError('catalog failed cross-reference invariants', errors);
+    }
+}
+export function validate(catalog) {
+    validateSchema(catalog);
+    validateInvariants(catalog);
+    return catalog;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,qCAAqC,CAAC;AAGnE,MAAM,MAAM,GAAG,wEAAwE,CAAC;AAExF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG7B;IAFlB,YACE,OAAe,EACC,MAAgB;QAEhC,KAAK,CAAC,GAAG,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAFlC,WAAM,GAAN,MAAM,CAAU;QAGhC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;QAClH,MAAM,IAAI,sBAAsB,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,mBAAmB,KAAK,UAAU,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,oBAAoB,CAAC,CAAC,OAAO,kBAAkB,CAAC,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CACT,QAAQ,GAAG,CAAC,IAAI,qCAAqC,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,WAAW,eAAe,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,WAAW,GAAG,CAC1I,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,IAAI,sBAAsB,CAAC,2CAA2C,EAAE,MAAM,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/versions.d.ts

@@ -0,0 +1,5 @@
+export declare function releasedAtInstant(raw: string): number | null;
+export declare function sortNewestFirst<T extends {
+    released_at: string;
+}>(items: T[]): T[];
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAUlF"}

package/dist/versions.js

@@ -0,0 +1,19 @@
+export function releasedAtInstant(raw) {
+    const parsed = Date.parse(raw);
+    return Number.isNaN(parsed) ? null : parsed;
+}
+export function sortNewestFirst(items) {
+    return items
+        .map((item, index) => ({ item, index, at: releasedAtInstant(item.released_at) }))
+        .sort((a, b) => {
+        if (a.at === null && b.at === null)
+            return a.index - b.index;
+        if (a.at === null)
+            return 1;
+        if (b.at === null)
+            return -1;
+        return a.at === b.at ? a.index - b.index : b.at - a.at;
+    })
+        .map(entry => entry.item);
+}
+//# sourceMappingURL=versions.js.map

package/dist/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAoC,KAAU;IAC3E,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;SAChF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAC7D,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC,CAAC;SACD,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@bridgething/catalog",
+  "type": "module",
+  "private": false,
+  "version": "0.1.0",
+  "description": "catalog.v1 schema, validator, and resolution rules for the bridgething webapp appstore",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema.v1.json": "./schema.v1.json"
+  },
+  "files": ["dist", "schema.v1.json"],
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json && mkdir -p dist/generated && cp src/generated/schema.v1.validator.mjs src/generated/schema.v1.validator.d.mts dist/generated/",
+    "validator": "bun run scripts/compile-validator.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.29.2"
+  }
+}