@serve.zone/appstore 32.27.0 → 33.1.0

package/dist_ts_client/projection.js

@@ -0,0 +1,83 @@
+import * as plugins from './plugins.js';
+const selectLatestInstallableVersion = (appArg, installableArg) => {
+    if (appArg.upgradeStrategy === 'branch') {
+        return installableArg.includes(appArg.latestVersion) ? appArg.latestVersion : null;
+    }
+    const { data } = plugins.servezoneInterfaces;
+    let latest = null;
+    for (const version of installableArg) {
+        const parsed = data.parseReleaseVersion(version);
+        if (parsed === null) {
+            throw new Error(`App Store catalog app '${appArg.info.id}' lists '${version}', which is not a release version`);
+        }
+        if (latest === null || data.compareReleaseVersions(parsed, latest.parsed) > 0)
+            latest = { version, parsed };
+    }
+    return latest === null ? null : latest.version;
+};
+/**
+ * Projects one catalog app for a consumer: every listed version with its install refusal, the
+ * newest install target for this consumer, and the `IAppStoreApp` / `IAppStoreAppMeta` shapes its App Store views
+ * show. Pure: it reads the catalog app and never changes it.
+ */
+export const projectAppStoreCatalogApp = (appArg, optionsArg) => {
+    const supportedFeatureIds = [...optionsArg.supportedFeatureIds];
+    const versions = appArg.versions.map((versionArg) => ({
+        version: versionArg.version,
+        installRefusal: plugins.servezoneInterfaces.appstore.judgeAppStoreCatalogInstallTarget(versionArg, supportedFeatureIds, optionsArg.consumer),
+    }));
+    const installable = versions
+        .filter((versionArg) => versionArg.installRefusal === null)
+        .map((versionArg) => versionArg.version);
+    const latestInstallableVersion = selectLatestInstallableVersion(appArg, installable);
+    const { info } = appArg;
+    const display = latestInstallableVersion === null
+        ? null
+        : {
+            app: {
+                id: info.id,
+                name: info.name,
+                description: info.description,
+                category: info.category,
+                ...(info.iconName === undefined ? {} : { iconName: info.iconName }),
+                ...(info.iconUrl === undefined ? {} : { iconUrl: info.iconUrl }),
+                latestVersion: latestInstallableVersion,
+                versions: [...installable],
+                versionStates: structuredClone(versions),
+                ...(info.tags === undefined ? {} : { tags: [...info.tags] }),
+                ...(appArg.upgradeStrategy === undefined ? {} : { upgradeStrategy: appArg.upgradeStrategy }),
+            },
+            meta: {
+                id: info.id,
+                name: info.name,
+                description: info.description,
+                category: info.category,
+                ...(info.iconName === undefined ? {} : { iconName: info.iconName }),
+                latestVersion: latestInstallableVersion,
+                versions: [...installable],
+                versionStates: structuredClone(versions),
+                ...(info.maintainer === undefined ? {} : { maintainer: info.maintainer }),
+                ...(info.links === undefined ? {} : { links: { ...info.links } }),
+                ...(info.tags === undefined ? {} : { tags: [...info.tags] }),
+            },
+        };
+    return {
+        appId: info.id,
+        catalogLatestVersion: appArg.latestVersion,
+        versions,
+        latestInstallableVersion,
+        display,
+    };
+};
+/** Projects every catalog app, in catalog order (by id). */
+export const projectAppStoreCatalog = (catalogArg, optionsArg) => {
+    const options = { supportedFeatureIds: [...optionsArg.supportedFeatureIds], consumer: optionsArg.consumer };
+    return catalogArg.apps.map((appArg) => projectAppStoreCatalogApp(appArg, options));
+};
+/**
+ * The App Store listing a consumer serves (`getAppStoreTemplates`): one `IAppStoreApp` per app
+ * that has an install target for it, in catalog order. An app without one is left out of the
+ * listing; its projection (`projectAppStoreCatalogApp`) still states why.
+ */
+export const getAppStoreCatalogListing = (catalogArg, optionsArg) => projectAppStoreCatalog(catalogArg, optionsArg).flatMap((projectionArg) => projectionArg.display === null ? [] : [projectionArg.display.app]);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvamVjdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2NsaWVudC9wcm9qZWN0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBa0R4QyxNQUFNLDhCQUE4QixHQUFHLENBQUMsTUFBbUIsRUFBRSxjQUFpQyxFQUFpQixFQUFFO0lBQy9HLElBQUksTUFBTSxDQUFDLGVBQWUsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUN4QyxPQUFPLGNBQWMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7SUFDckYsQ0FBQztJQUNELE1BQU0sRUFBRSxJQUFJLEVBQUUsR0FBRyxPQUFPLENBQUMsbUJBQW1CLENBQUM7SUFDN0MsSUFBSSxNQUFNLEdBQXlGLElBQUksQ0FBQztJQUN4RyxLQUFLLE1BQU0sT0FBTyxJQUFJLGNBQWMsRUFBRSxDQUFDO1FBQ3JDLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUNqRCxJQUFJLE1BQU0sS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNwQixNQUFNLElBQUksS0FBSyxDQUFDLDBCQUEwQixNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsWUFBWSxPQUFPLG1DQUFtQyxDQUFDLENBQUM7UUFDbEgsQ0FBQztRQUNELElBQUksTUFBTSxLQUFLLElBQUksSUFBSSxJQUFJLENBQUMsc0JBQXNCLENBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDO1lBQUUsTUFBTSxHQUFHLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBQzlHLENBQUM7SUFDRCxPQUFPLE1BQU0sS0FBSyxJQUFJLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsTUFBTSxD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

package/dist_ts_client/storage.d.ts

@@ -1,13 +1,19 @@
-import type { IAppStoreStorageNormalizationOptions, INormalizedAppStoreStorageConfig, TAppStoreVersionConfig } from './types.js';
-export declare function parseStorageCapacityQuantity(quantityArg: unknown, labelArg?: string): bigint;
+import * as plugins from './plugins.js';
+import type { IAppStoreStorageNormalizationOptions, INormalizedAppStoreStorageConfig } from './types.js';
+type TCatalogVersionConfig = plugins.servezoneInterfaces.appstore.TAppStoreCatalogVersionConfig;
+type TVolume = plugins.servezoneInterfaces.appstore.IAppStoreVolume;
 /**
- * Strict structural validation plus deterministic legacy normalization. This
- * does not claim that a runtime can fulfill explicit requests; installers must
- * call normalizeAppStoreStorageConfig with an advertised feature set.
+ * The legacy `volumes` of a version config in their object form (`{ name?, mountPath, readOnly?,
+ * backup? }`), after the config's storage passed the interfaces contract.
  */
-export declare function validateAppStoreStorageConfig(configArg: TAppStoreVersionConfig, labelArg?: string): INormalizedAppStoreStorageConfig;
+export declare function normalizeAppStoreVolumes(configArg: TCatalogVersionConfig, labelArg?: string): TVolume[];
 /**
- * Canonical pre-fulfillment handoff. Explicit storage contracts fail closed
- * unless every derived storage feature is advertised by the target runtime.
+ * The canonical pre-fulfillment storage handoff of a version config.
+ *
+ * The config's storage is judged by the interfaces contract first. Legacy `volumes` become
+ * filesystem requests of the reserved `legacyFilesystem` class, `platformRequirements.s3` becomes
+ * the `legacy-s3` object-storage request, and explicit requests fail closed unless every storage
+ * feature they need is advertised by the target runtime.
  */
-export declare function normalizeAppStoreStorageConfig(configArg: TAppStoreVersionConfig, optionsArg: IAppStoreStorageNormalizationOptions, labelArg?: string): INormalizedAppStoreStorageConfig;
+export declare function normalizeAppStoreStorageConfig(configArg: TCatalogVersionConfig, optionsArg: IAppStoreStorageNormalizationOptions, labelArg?: string): INormalizedAppStoreStorageConfig;
+export {};