@serve.zone/interfaces 5.10.0 → 6.0.1

package/changelog.md

@@ -3,6 +3,21 @@
 ## Pending
 
 
+## 2026-05-26 - 6.0.1
+
+- add App Store service upgrade contracts (appstore)
+  - Adds App Store upgrade preview, operation tracking, start/apply, and progress push request contracts
+  - Adds service-level App Store upgrade policy, published ports, and service IDs to related service types
+
+## 2026-05-25 - 6.0.0
+
+### Breaking Changes
+
+- rename app catalog contracts to appstore contracts
+  - Replaces the `appcatalog` namespace with `appstore`
+  - Renames app catalog DTOs and TypedRequest methods to AppStore naming
+  - Adds source manifest, digest tracking, and resolved provenance fields under the new appstore contract
+
 ## 2026-05-24 - 5.10.0
 
 ### Features

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '5.10.0',
+    version: '6.0.1',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/{appcatalog → appstore}/index.js

@@ -1,2 +1,2 @@
 export * from './types.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBjYXRhbG9nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsWUFBWSxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBzdG9yZS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLFlBQVksQ0FBQyJ9

package/dist_ts/appstore/types.d.ts

@@ -0,0 +1,169 @@
+export type TAppStorePlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
+export type TAppStoreSourceType = 'inline' | 'repoManifest' | 'dockerImage';
+export type TAppStoreTrackingMode = 'tag' | 'digest';
+export type TAppStoreUpgradeStrategy = 'semver' | 'branch' | 'dockerDigest';
+export interface IAppStoreInlineSource {
+    type: 'inline';
+}
+export interface IAppStoreRepoManifestSource {
+    type: 'repoManifest';
+    /** Raw URL to a servezone.appstore.json file. Can point to a branch such as main. */
+    url: string;
+    /** Optional human-readable ref, for example main, stable, or v1.2.3. */
+    ref?: string;
+}
+export interface IAppStoreDockerImageSource {
+    type: 'dockerImage';
+    /** Docker image reference. Mutable tags such as :latest are allowed when policy permits them. */
+    image: string;
+    /** Digest tracking turns mutable tag changes into explicit appstore upgrades. */
+    tracking?: TAppStoreTrackingMode;
+}
+export type TAppStoreSource = IAppStoreInlineSource | IAppStoreRepoManifestSource | IAppStoreDockerImageSource;
+export interface IAppStoreResolvedSource {
+    type: TAppStoreSourceType;
+    url?: string;
+    ref?: string;
+    image?: string;
+    manifestHash?: string;
+    imageDigest?: string;
+    resolvedAt: string;
+}
+export interface IAppStoreEnvVar {
+    key: string;
+    value?: string;
+    description: string;
+    required?: boolean;
+}
+export interface IAppStoreVolume {
+    /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
+    name?: string;
+    /** Alias for name when a volume is shared intentionally across services. */
+    source?: string;
+    /** Container path where the volume is mounted. */
+    mountPath: string;
+    /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
+    driver?: string;
+    readOnly?: boolean;
+    /** Whether backup orchestration should snapshot this volume. Defaults to true. */
+    backup?: boolean;
+    /** Driver-specific options forwarded to the container runtime. */
+    options?: Record<string, string>;
+}
+export type TAppStoreVolumeSpec = string | IAppStoreVolume;
+export interface IAppStorePublishedPort {
+    targetPort: number;
+    targetPortEnd?: number;
+    publishedPort?: number;
+    publishedPortEnd?: number;
+    protocol?: 'tcp' | 'udp';
+    hostIp?: string;
+}
+export interface IAppStoreApp {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconName?: string;
+    iconUrl?: string;
+    latestVersion: string;
+    versions?: string[];
+    tags?: string[];
+    channel?: string;
+    upgradeStrategy?: TAppStoreUpgradeStrategy;
+    source?: TAppStoreSource;
+    /** Minimal runtime config for source-only appstore entries, typically dockerImage sources. */
+    runtime?: IAppStoreVersionConfig;
+    resolvedSource?: IAppStoreResolvedSource;
+}
+export interface IAppStoreIndex {
+    schemaVersion: number;
+    updatedAt: string;
+    resolvedAt?: string;
+    apps: IAppStoreApp[];
+}
+export interface IAppStoreAppMeta {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconName?: string;
+    latestVersion: string;
+    versions: string[];
+    maintainer?: string;
+    links?: Record<string, string>;
+    tags?: string[];
+    source?: TAppStoreSource;
+    resolvedSource?: IAppStoreResolvedSource;
+}
+export interface IAppStoreVersionConfig {
+    image: string;
+    port: number;
+    envVars?: IAppStoreEnvVar[];
+    volumes?: TAppStoreVolumeSpec[];
+    publishedPorts?: IAppStorePublishedPort[];
+    platformRequirements?: Partial<Record<TAppStorePlatformRequirement, boolean>>;
+    minOneboxVersion?: string;
+    minCloudlyVersion?: string;
+    appStoreVersion?: string;
+    upgradeStrategy?: TAppStoreUpgradeStrategy;
+    source?: TAppStoreSource;
+    resolvedSource?: IAppStoreResolvedSource;
+    resolvedImageDigest?: string;
+    changelog?: string;
+    breaking?: boolean;
+    requiresManualReview?: boolean;
+    migrationRequired?: boolean;
+    backupBeforeUpgrade?: boolean;
+    requiresFeatures?: string[];
+    healthCheck?: {
+        path?: string;
+        port?: number;
+        expectedStatus?: number;
+    };
+}
+export interface IServezoneAppStoreAppInfo {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    iconName?: string;
+    iconUrl?: string;
+    tags?: string[];
+    maintainer?: string;
+    links?: Record<string, string>;
+}
+export interface IServezoneAppStoreVersion extends IAppStoreVersionConfig {
+    version: string;
+}
+export interface IServezoneAppStoreManifest {
+    schemaVersion: number;
+    app: IServezoneAppStoreAppInfo;
+    latestVersion?: string;
+    channel?: string;
+    channels?: Record<string, string>;
+    source?: TAppStoreSource;
+    runtime?: IAppStoreVersionConfig;
+    versions?: IServezoneAppStoreVersion[];
+    policy?: {
+        allowMutableImage?: boolean;
+        defaultChannel?: string;
+    };
+}
+export interface IAppStoreInstallRequest {
+    appId: string;
+    version?: string;
+    serviceName: string;
+    domain?: string;
+    port?: number;
+    publishedPorts?: IAppStorePublishedPort[];
+    envVars?: Record<string, string>;
+}
+export interface IUpgradeableAppStoreService {
+    serviceId?: string;
+    serviceName: string;
+    appTemplateId: string;
+    currentVersion: string;
+    latestVersion: string;
+    hasMigration: boolean;
+}

package/dist_ts/{appcatalog → appstore}/types.js

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBjYXRhbG9nL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9hcHBzdG9yZS90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts/data/service.d.ts

@@ -1,5 +1,6 @@
 import type { IServiceRessources } from './docker.js';
 import type { IRegistryTarget } from './registry.js';
+import type { IAppStorePublishedPort } from '../appstore/index.js';
 export interface IServiceVolume {
     /** Stable Docker volume name. If omitted, Coreflow derives one from service id and mount path. */
     name?: string;
@@ -26,6 +27,7 @@ export interface IService {
         deployOnPush?: boolean;
         appTemplateId?: string;
         appTemplateVersion?: string;
+        appStoreUpgradePolicy?: 'manual' | 'notify' | 'auto';
         environment: {
             [key: string]: string;
         };
@@ -71,6 +73,7 @@ export interface IService {
             };
         };
         volumes?: IServiceVolume[];
+        publishedPorts?: IAppStorePublishedPort[];
         resources?: IServiceRessources;
         domains: {
             /**

package/dist_ts/index.d.ts

@@ -1,6 +1,6 @@
 import * as data from './data/index.js';
-import * as appcatalog from './appcatalog/index.js';
+import * as appstore from './appstore/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
-export { appcatalog, data, platform, platformservice, requests };
+export { appstore, data, platform, platformservice, requests };

package/dist_ts/index.js

@@ -1,7 +1,7 @@
 import * as data from './data/index.js';
-import * as appcatalog from './appcatalog/index.js';
+import * as appstore from './appstore/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
-export { appcatalog, data, platform, platformservice, requests };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssSUFBSSxNQUFNLGlCQUFpQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxVQUFVLE1BQU0sdUJBQXVCLENBQUM7QUFDcEQsT0FBTyxLQUFLLFFBQVEsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRCxPQUFPLEtBQUssZUFBZSxNQUFNLDRCQUE0QixDQUFDO0FBQzlELE9BQU8sS0FBSyxRQUFRLE1BQU0scUJBQXFCLENBQUM7QUFFaEQsT0FBTyxFQUNMLFVBQVUsRUFDVixJQUFJLEVBQ0osUUFBUSxFQUNSLGVBQWUsRUFDZixRQUFRLEVBQ1QsQ0FBQSJ9
+export { appstore, data, platform, platformservice, requests };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssSUFBSSxNQUFNLGlCQUFpQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxRQUFRLE1BQU0scUJBQXFCLENBQUM7QUFDaEQsT0FBTyxLQUFLLFFBQVEsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRCxPQUFPLEtBQUssZUFBZSxNQUFNLDRCQUE0QixDQUFDO0FBQzlELE9BQU8sS0FBSyxRQUFRLE1BQU0scUJBQXFCLENBQUM7QUFFaEQsT0FBTyxFQUNMLFFBQVEsRUFDUixJQUFJLEVBQ0osUUFBUSxFQUNSLGVBQWUsRUFDZixRQUFRLEVBQ1QsQ0FBQSJ9

package/dist_ts/requests/appstore.d.ts

@@ -0,0 +1,133 @@
+import * as plugins from '../plugins.js';
+import type { IIdentity } from '../data/user.js';
+import type { IService } from '../data/service.js';
+import type { IAppStoreApp, IAppStoreAppMeta, IAppStoreInstallRequest, IAppStoreVersionConfig, IUpgradeableAppStoreService } from '../appstore/index.js';
+export type TAppStoreUpgradeStatus = 'running' | 'success' | 'failed';
+export type TAppStoreUpgradeStep = 'queued' | 'validating' | 'migration' | 'applying' | 'updating-service' | 'pushing-config' | 'complete' | 'failed';
+export interface IAppStoreUpgradeChange {
+    field: string;
+    currentValue: string;
+    targetValue: string;
+}
+export interface IAppStoreUpgradePreview {
+    serviceId: string;
+    serviceName: string;
+    appTemplateId: string;
+    fromVersion: string;
+    targetVersion: string;
+    resolvedTargetVersion: string;
+    hasMigration: boolean;
+    requiresManualReview: boolean;
+    changes: IAppStoreUpgradeChange[];
+    warnings: string[];
+    blockers: string[];
+    config: IAppStoreVersionConfig;
+    appMeta: IAppStoreAppMeta;
+}
+export interface IAppStoreUpgradeOperation {
+    id: string;
+    serviceId: string;
+    serviceName: string;
+    appTemplateId: string;
+    fromVersion: string;
+    targetVersion: string;
+    status: TAppStoreUpgradeStatus;
+    step: TAppStoreUpgradeStep;
+    progressLines: string[];
+    warnings: string[];
+    error?: string;
+    startedAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    service?: IService;
+}
+export interface IReq_Any_GetAppStoreTemplates extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppStoreTemplates> {
+    method: 'getAppStoreTemplates';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        apps: IAppStoreApp[];
+    };
+}
+export interface IReq_Any_GetAppStoreConfig extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppStoreConfig> {
+    method: 'getAppStoreConfig';
+    request: {
+        identity: IIdentity;
+        appId: string;
+        version: string;
+    };
+    response: {
+        config: IAppStoreVersionConfig;
+        appMeta: IAppStoreAppMeta;
+    };
+}
+export interface IReq_Any_InstallAppStoreApp extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_InstallAppStoreApp> {
+    method: 'installAppStoreApp';
+    request: {
+        identity: IIdentity;
+        install: IAppStoreInstallRequest;
+    };
+    response: {
+        service: IService;
+    };
+}
+export interface IReq_Any_GetUpgradeableAppStoreServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetUpgradeableAppStoreServices> {
+    method: 'getUpgradeableAppStoreServices';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        services: IUpgradeableAppStoreService[];
+    };
+}
+export interface IReq_Any_GetAppStoreUpgradePreview extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppStoreUpgradePreview> {
+    method: 'getAppStoreUpgradePreview';
+    request: {
+        identity: IIdentity;
+        serviceId: string;
+        targetVersion?: string;
+    };
+    response: {
+        preview: IAppStoreUpgradePreview;
+    };
+}
+export interface IReq_Any_UpgradeAppStoreService extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_UpgradeAppStoreService> {
+    method: 'upgradeAppStoreService';
+    request: {
+        identity: IIdentity;
+        serviceId: string;
+        targetVersion: string;
+    };
+    response: {
+        service: IService;
+        warnings: string[];
+    };
+}
+export interface IReq_Any_StartAppStoreServiceUpgrade extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_StartAppStoreServiceUpgrade> {
+    method: 'startAppStoreServiceUpgrade';
+    request: {
+        identity: IIdentity;
+        serviceId: string;
+        targetVersion: string;
+    };
+    response: {
+        operation: IAppStoreUpgradeOperation;
+    };
+}
+export interface IReq_Any_GetAppStoreUpgradeOperations extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppStoreUpgradeOperations> {
+    method: 'getAppStoreUpgradeOperations';
+    request: {
+        identity: IIdentity;
+    };
+    response: {
+        operations: IAppStoreUpgradeOperation[];
+    };
+}
+export interface IReq_Any_PushAppStoreUpgradeProgress extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_PushAppStoreUpgradeProgress> {
+    method: 'pushAppStoreUpgradeProgress';
+    request: {
+        operation: IAppStoreUpgradeOperation;
+    };
+    response: Record<string, never>;
+}

package/dist_ts/requests/appstore.js

@@ -0,0 +1,2 @@
+import * as plugins from '../plugins.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwc3RvcmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9hcHBzdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQyJ9

package/dist_ts/requests/index.d.ts

@@ -1,5 +1,5 @@
 import * as adminRequests from './admin.js';
-import * as appCatalogRequests from './appcatalog.js';
+import * as appStoreRequests from './appstore.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -26,5 +26,5 @@ import * as settingsRequests from './settings.js';
 import * as statusRequests from './status.js';
 import * as taskRequests from './task.js';
 import * as versionRequests from './version.js';
-export { adminRequests as admin, appCatalogRequests as appcatalog, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
+export { adminRequests as admin, appStoreRequests as appstore, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
 export * from './inform.js';

package/dist_ts/requests/index.js

@@ -1,6 +1,6 @@
 import * as plugins from '../plugins.js';
 import * as adminRequests from './admin.js';
-import * as appCatalogRequests from './appcatalog.js';
+import * as appStoreRequests from './appstore.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -27,6 +27,6 @@ import * as settingsRequests from './settings.js';
 import * as statusRequests from './status.js';
 import * as taskRequests from './task.js';
 import * as versionRequests from './version.js';
-export { adminRequests as admin, appCatalogRequests as appcatalog, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
+export { adminRequests as admin, appStoreRequests as appstore, baremetalRequests as baremetal, baseOsRequests as baseos, backupRequests as backup, certificateRequests as certificate, clusterRequests as cluster, configRequests as config, deploymentRequests as deployment, dnsRequests as dns, domainRequests as domain, externalRegistryRequests as externalRegistry, identityRequests as identity, imageRequests as image, informRequests as inform, logRequests as log, networkRequests as network, nodeRequests as node, platformRequests as platform, routingRequests as routing, secretBundleRequests as secretbundle, secretGroupRequests as secretgroup, serverRequests as server, serviceRequests as service, settingsRequests as settings, statusRequests as status, taskRequests as task, versionRequests as version, };
 export * from './inform.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6QyxPQUFPLEtBQUssYUFBYSxNQUFNLFlBQVksQ0FBQztBQUM1QyxPQUFPLEtBQUssa0JBQWtCLE1BQU0saUJBQWlCLENBQUM7QUFDdEQsT0FBTyxLQUFLLGlCQUFpQixNQUFNLGdCQUFnQixDQUFDO0FBQ3BELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxtQkFBbUIsTUFBTSxrQkFBa0IsQ0FBQztBQUN4RCxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssa0JBQWtCLE1BQU0saUJBQWlCLENBQUM7QUFDdEQsT0FBTyxLQUFLLFdBQVcsTUFBTSxVQUFVLENBQUM7QUFDeEMsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLHdCQUF3QixNQUFNLHVCQUF1QixDQUFDO0FBQ2xFLE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSxlQUFlLENBQUM7QUFDbEQsT0FBTyxLQUFLLGFBQWEsTUFBTSxZQUFZLENBQUM7QUFDNUMsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLFdBQVcsTUFBTSxVQUFVLENBQUM7QUFDeEMsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFDaEQsT0FBTyxLQUFLLFlBQVksTUFBTSxXQUFXLENBQUM7QUFDMUMsT0FBTyxLQUFLLGdCQUFnQixNQUFNLGVBQWUsQ0FBQztBQUNsRCxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssb0JBQW9CLE1BQU0sbUJBQW1CLENBQUM7QUFDMUQsT0FBTyxLQUFLLG1CQUFtQixNQUFNLGtCQUFrQixDQUFDO0FBQ3hELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBQ2hELE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSxlQUFlLENBQUM7QUFDbEQsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLFlBQVksTUFBTSxXQUFXLENBQUM7QUFDMUMsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFFaEQsT0FBTyxFQUNMLGFBQWEsSUFBSSxLQUFLLEVBQ3RCLGtCQUFrQixJQUFJLFVBQVUsRUFDaEMsaUJBQWlCLElBQUksU0FBUyxFQUM5QixjQUFjLElBQUksTUFBTSxFQUN4QixjQUFjLElBQUksTUFBTSxFQUN4QixtQkFBbUIsSUFBSSxXQUFXLEVBQ2xDLGVBQWUsSUFBSSxPQUFPLEVBQzFCLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLGtCQUFrQixJQUFJLFVBQVUsRUFDaEMsV0FBVyxJQUFJLEdBQUcsRUFDbEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsd0JBQXdCLElBQUksZ0JBQWdCLEVBQzVDLGdCQUFnQixJQUFJLFFBQVEsRUFDNUIsYUFBYSxJQUFJLEtBQUssRUFDdEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsV0FBVyxJQUFJLEdBQUcsRUFDbEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsWUFBWSxJQUFJLElBQUksRUFDcEIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixlQUFlLElBQUksT0FBTyxFQUMxQixvQkFBb0IsSUFBSSxZQUFZLEVBQ3BDLG1CQUFtQixJQUFJLFdBQVcsRUFDbEMsY0FBYyxJQUFJLE1BQU0sRUFDeEIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsZ0JBQWdCLElBQUksUUFBUSxFQUM1QixjQUFjLElBQUksTUFBTSxFQUN4QixZQUFZLElBQUksSUFBSSxFQUNwQixlQUFlLElBQUksT0FBTyxHQUMzQixDQUFDO0FBRUYsY0FBYyxhQUFhLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9yZXF1ZXN0cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUV6QyxPQUFPLEtBQUssYUFBYSxNQUFNLFlBQVksQ0FBQztBQUM1QyxPQUFPLEtBQUssZ0JBQWdCLE1BQU0sZUFBZSxDQUFDO0FBQ2xELE9BQU8sS0FBSyxpQkFBaUIsTUFBTSxnQkFBZ0IsQ0FBQztBQUNwRCxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssbUJBQW1CLE1BQU0sa0JBQWtCLENBQUM7QUFDeEQsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFDaEQsT0FBTyxLQUFLLGNBQWMsTUFBTSxhQUFhLENBQUM7QUFDOUMsT0FBTyxLQUFLLGtCQUFrQixNQUFNLGlCQUFpQixDQUFDO0FBQ3RELE9BQU8sS0FBSyxXQUFXLE1BQU0sVUFBVSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyx3QkFBd0IsTUFBTSx1QkFBdUIsQ0FBQztBQUNsRSxPQUFPLEtBQUssZ0JBQWdCLE1BQU0sZUFBZSxDQUFDO0FBQ2xELE9BQU8sS0FBSyxhQUFhLE1BQU0sWUFBWSxDQUFDO0FBQzVDLE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxXQUFXLE1BQU0sVUFBVSxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBQ2hELE9BQU8sS0FBSyxZQUFZLE1BQU0sV0FBVyxDQUFDO0FBQzFDLE9BQU8sS0FBSyxnQkFBZ0IsTUFBTSxlQUFlLENBQUM7QUFDbEQsT0FBTyxLQUFLLGVBQWUsTUFBTSxjQUFjLENBQUM7QUFDaEQsT0FBTyxLQUFLLG9CQUFvQixNQUFNLG1CQUFtQixDQUFDO0FBQzFELE9BQU8sS0FBSyxtQkFBbUIsTUFBTSxrQkFBa0IsQ0FBQztBQUN4RCxPQUFPLEtBQUssY0FBYyxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEtBQUssZUFBZSxNQUFNLGNBQWMsQ0FBQztBQUNoRCxPQUFPLEtBQUssZ0JBQWdCLE1BQU0sZUFBZSxDQUFDO0FBQ2xELE9BQU8sS0FBSyxjQUFjLE1BQU0sYUFBYSxDQUFDO0FBQzlDLE9BQU8sS0FBSyxZQUFZLE1BQU0sV0FBVyxDQUFDO0FBQzFDLE9BQU8sS0FBSyxlQUFlLE1BQU0sY0FBYyxDQUFDO0FBRWhELE9BQU8sRUFDTCxhQUFhLElBQUksS0FBSyxFQUN0QixnQkFBZ0IsSUFBSSxRQUFRLEVBQzVCLGlCQUFpQixJQUFJLFNBQVMsRUFDOUIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsbUJBQW1CLElBQUksV0FBVyxFQUNsQyxlQUFlLElBQUksT0FBTyxFQUMxQixjQUFjLElBQUksTUFBTSxFQUN4QixrQkFBa0IsSUFBSSxVQUFVLEVBQ2hDLFdBQVcsSUFBSSxHQUFHLEVBQ2xCLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLHdCQUF3QixJQUFJLGdCQUFnQixFQUM1QyxnQkFBZ0IsSUFBSSxRQUFRLEVBQzVCLGFBQWEsSUFBSSxLQUFLLEVBQ3RCLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLFdBQVcsSUFBSSxHQUFHLEVBQ2xCLGVBQWUsSUFBSSxPQUFPLEVBQzFCLFlBQVksSUFBSSxJQUFJLEVBQ3BCLGdCQUFnQixJQUFJLFFBQVEsRUFDNUIsZUFBZSxJQUFJLE9BQU8sRUFDMUIsb0JBQW9CLElBQUksWUFBWSxFQUNwQyxtQkFBbUIsSUFBSSxXQUFXLEVBQ2xDLGNBQWMsSUFBSSxNQUFNLEVBQ3hCLGVBQWUsSUFBSSxPQUFPLEVBQzFCLGdCQUFnQixJQUFJLFFBQVEsRUFDNUIsY0FBYyxJQUFJLE1BQU0sRUFDeEIsWUFBWSxJQUFJLElBQUksRUFDcEIsZUFBZSxJQUFJLE9BQU8sR0FDM0IsQ0FBQztBQUVGLGNBQWMsYUFBYSxDQUFDIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "5.10.0",
+  "version": "6.0.1",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '5.10.0',
+  version: '6.0.1',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/appstore/types.ts

@@ -0,0 +1,190 @@
+export type TAppStorePlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
+export type TAppStoreSourceType = 'inline' | 'repoManifest' | 'dockerImage';
+export type TAppStoreTrackingMode = 'tag' | 'digest';
+export type TAppStoreUpgradeStrategy = 'semver' | 'branch' | 'dockerDigest';
+
+export interface IAppStoreInlineSource {
+  type: 'inline';
+}
+
+export interface IAppStoreRepoManifestSource {
+  type: 'repoManifest';
+  /** Raw URL to a servezone.appstore.json file. Can point to a branch such as main. */
+  url: string;
+  /** Optional human-readable ref, for example main, stable, or v1.2.3. */
+  ref?: string;
+}
+
+export interface IAppStoreDockerImageSource {
+  type: 'dockerImage';
+  /** Docker image reference. Mutable tags such as :latest are allowed when policy permits them. */
+  image: string;
+  /** Digest tracking turns mutable tag changes into explicit appstore upgrades. */
+  tracking?: TAppStoreTrackingMode;
+}
+
+export type TAppStoreSource =
+  | IAppStoreInlineSource
+  | IAppStoreRepoManifestSource
+  | IAppStoreDockerImageSource;
+
+export interface IAppStoreResolvedSource {
+  type: TAppStoreSourceType;
+  url?: string;
+  ref?: string;
+  image?: string;
+  manifestHash?: string;
+  imageDigest?: string;
+  resolvedAt: string;
+}
+
+export interface IAppStoreEnvVar {
+  key: string;
+  value?: string;
+  description: string;
+  required?: boolean;
+}
+
+export interface IAppStoreVolume {
+  /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
+  name?: string;
+  /** Alias for name when a volume is shared intentionally across services. */
+  source?: string;
+  /** Container path where the volume is mounted. */
+  mountPath: string;
+  /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
+  driver?: string;
+  readOnly?: boolean;
+  /** Whether backup orchestration should snapshot this volume. Defaults to true. */
+  backup?: boolean;
+  /** Driver-specific options forwarded to the container runtime. */
+  options?: Record<string, string>;
+}
+
+export type TAppStoreVolumeSpec = string | IAppStoreVolume;
+
+export interface IAppStorePublishedPort {
+  targetPort: number;
+  targetPortEnd?: number;
+  publishedPort?: number;
+  publishedPortEnd?: number;
+  protocol?: 'tcp' | 'udp';
+  hostIp?: string;
+}
+
+export interface IAppStoreApp {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  iconName?: string;
+  iconUrl?: string;
+  latestVersion: string;
+  versions?: string[];
+  tags?: string[];
+  channel?: string;
+  upgradeStrategy?: TAppStoreUpgradeStrategy;
+  source?: TAppStoreSource;
+  /** Minimal runtime config for source-only appstore entries, typically dockerImage sources. */
+  runtime?: IAppStoreVersionConfig;
+  resolvedSource?: IAppStoreResolvedSource;
+}
+
+export interface IAppStoreIndex {
+  schemaVersion: number;
+  updatedAt: string;
+  resolvedAt?: string;
+  apps: IAppStoreApp[];
+}
+
+export interface IAppStoreAppMeta {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  iconName?: string;
+  latestVersion: string;
+  versions: string[];
+  maintainer?: string;
+  links?: Record<string, string>;
+  tags?: string[];
+  source?: TAppStoreSource;
+  resolvedSource?: IAppStoreResolvedSource;
+}
+
+export interface IAppStoreVersionConfig {
+  image: string;
+  port: number;
+  envVars?: IAppStoreEnvVar[];
+  volumes?: TAppStoreVolumeSpec[];
+  publishedPorts?: IAppStorePublishedPort[];
+  platformRequirements?: Partial<Record<TAppStorePlatformRequirement, boolean>>;
+  minOneboxVersion?: string;
+  minCloudlyVersion?: string;
+  appStoreVersion?: string;
+  upgradeStrategy?: TAppStoreUpgradeStrategy;
+  source?: TAppStoreSource;
+  resolvedSource?: IAppStoreResolvedSource;
+  resolvedImageDigest?: string;
+  changelog?: string;
+  breaking?: boolean;
+  requiresManualReview?: boolean;
+  migrationRequired?: boolean;
+  backupBeforeUpgrade?: boolean;
+  requiresFeatures?: string[];
+  healthCheck?: {
+    path?: string;
+    port?: number;
+    expectedStatus?: number;
+  };
+}
+
+export interface IServezoneAppStoreAppInfo {
+  id: string;
+  name: string;
+  description: string;
+  category: string;
+  iconName?: string;
+  iconUrl?: string;
+  tags?: string[];
+  maintainer?: string;
+  links?: Record<string, string>;
+}
+
+export interface IServezoneAppStoreVersion extends IAppStoreVersionConfig {
+  version: string;
+}
+
+export interface IServezoneAppStoreManifest {
+  schemaVersion: number;
+  app: IServezoneAppStoreAppInfo;
+  latestVersion?: string;
+  channel?: string;
+  channels?: Record<string, string>;
+  source?: TAppStoreSource;
+  runtime?: IAppStoreVersionConfig;
+  versions?: IServezoneAppStoreVersion[];
+  policy?: {
+    allowMutableImage?: boolean;
+    defaultChannel?: string;
+  };
+}
+
+export interface IAppStoreInstallRequest {
+  appId: string;
+  version?: string;
+  serviceName: string;
+  domain?: string;
+  port?: number;
+  publishedPorts?: IAppStorePublishedPort[];
+  envVars?: Record<string, string>;
+}
+
+export interface IUpgradeableAppStoreService {
+  serviceId?: string;
+  serviceName: string;
+  appTemplateId: string;
+  currentVersion: string;
+  latestVersion: string;
+  hasMigration: boolean;
+}

package/ts/data/service.ts

@@ -1,5 +1,6 @@
 import type { IServiceRessources } from './docker.js';
 import type { IRegistryTarget } from './registry.js';
+import type { IAppStorePublishedPort } from '../appstore/index.js';
 
 export interface IServiceVolume {
   /** Stable Docker volume name. If omitted, Coreflow derives one from service id and mount path. */
@@ -28,6 +29,7 @@ export interface IService {
     deployOnPush?: boolean;
     appTemplateId?: string;
     appTemplateVersion?: string;
+    appStoreUpgradePolicy?: 'manual' | 'notify' | 'auto';
     environment: { [key: string]: string };
     /**
      * the main secret bundle id, exclusive to the service
@@ -74,6 +76,7 @@ export interface IService {
       custom?: { [domain: string]: string };
     };
     volumes?: IServiceVolume[];
+    publishedPorts?: IAppStorePublishedPort[];
     resources?: IServiceRessources;
     domains: {
       /**

package/ts/index.ts

@@ -1,11 +1,11 @@
 import * as data from './data/index.js';
-import * as appcatalog from './appcatalog/index.js';
+import * as appstore from './appstore/index.js';
 import * as platform from './platform/index.js';
 import * as platformservice from './platformservice/index.js';
 import * as requests from './requests/index.js';
 
 export {
-  appcatalog,
+  appstore,
   data,
   platform,
   platformservice,

package/ts/requests/appstore.ts

@@ -0,0 +1,188 @@
+import * as plugins from '../plugins.js';
+import type { IIdentity } from '../data/user.js';
+import type { IService } from '../data/service.js';
+import type {
+  IAppStoreApp,
+  IAppStoreAppMeta,
+  IAppStoreInstallRequest,
+  IAppStoreVersionConfig,
+  IUpgradeableAppStoreService,
+} from '../appstore/index.js';
+
+export type TAppStoreUpgradeStatus = 'running' | 'success' | 'failed';
+
+export type TAppStoreUpgradeStep =
+  | 'queued'
+  | 'validating'
+  | 'migration'
+  | 'applying'
+  | 'updating-service'
+  | 'pushing-config'
+  | 'complete'
+  | 'failed';
+
+export interface IAppStoreUpgradeChange {
+  field: string;
+  currentValue: string;
+  targetValue: string;
+}
+
+export interface IAppStoreUpgradePreview {
+  serviceId: string;
+  serviceName: string;
+  appTemplateId: string;
+  fromVersion: string;
+  targetVersion: string;
+  resolvedTargetVersion: string;
+  hasMigration: boolean;
+  requiresManualReview: boolean;
+  changes: IAppStoreUpgradeChange[];
+  warnings: string[];
+  blockers: string[];
+  config: IAppStoreVersionConfig;
+  appMeta: IAppStoreAppMeta;
+}
+
+export interface IAppStoreUpgradeOperation {
+  id: string;
+  serviceId: string;
+  serviceName: string;
+  appTemplateId: string;
+  fromVersion: string;
+  targetVersion: string;
+  status: TAppStoreUpgradeStatus;
+  step: TAppStoreUpgradeStep;
+  progressLines: string[];
+  warnings: string[];
+  error?: string;
+  startedAt: number;
+  updatedAt: number;
+  completedAt?: number;
+  service?: IService;
+}
+
+export interface IReq_Any_GetAppStoreTemplates extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppStoreTemplates
+> {
+  method: 'getAppStoreTemplates';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    apps: IAppStoreApp[];
+  };
+}
+
+export interface IReq_Any_GetAppStoreConfig extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppStoreConfig
+> {
+  method: 'getAppStoreConfig';
+  request: {
+    identity: IIdentity;
+    appId: string;
+    version: string;
+  };
+  response: {
+    config: IAppStoreVersionConfig;
+    appMeta: IAppStoreAppMeta;
+  };
+}
+
+export interface IReq_Any_InstallAppStoreApp extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_InstallAppStoreApp
+> {
+  method: 'installAppStoreApp';
+  request: {
+    identity: IIdentity;
+    install: IAppStoreInstallRequest;
+  };
+  response: {
+    service: IService;
+  };
+}
+
+export interface IReq_Any_GetUpgradeableAppStoreServices extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetUpgradeableAppStoreServices
+> {
+  method: 'getUpgradeableAppStoreServices';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    services: IUpgradeableAppStoreService[];
+  };
+}
+
+export interface IReq_Any_GetAppStoreUpgradePreview extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppStoreUpgradePreview
+> {
+  method: 'getAppStoreUpgradePreview';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    targetVersion?: string;
+  };
+  response: {
+    preview: IAppStoreUpgradePreview;
+  };
+}
+
+export interface IReq_Any_UpgradeAppStoreService extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_UpgradeAppStoreService
+> {
+  method: 'upgradeAppStoreService';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    targetVersion: string;
+  };
+  response: {
+    service: IService;
+    warnings: string[];
+  };
+}
+
+export interface IReq_Any_StartAppStoreServiceUpgrade extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_StartAppStoreServiceUpgrade
+> {
+  method: 'startAppStoreServiceUpgrade';
+  request: {
+    identity: IIdentity;
+    serviceId: string;
+    targetVersion: string;
+  };
+  response: {
+    operation: IAppStoreUpgradeOperation;
+  };
+}
+
+export interface IReq_Any_GetAppStoreUpgradeOperations extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_GetAppStoreUpgradeOperations
+> {
+  method: 'getAppStoreUpgradeOperations';
+  request: {
+    identity: IIdentity;
+  };
+  response: {
+    operations: IAppStoreUpgradeOperation[];
+  };
+}
+
+export interface IReq_Any_PushAppStoreUpgradeProgress extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_Any_PushAppStoreUpgradeProgress
+> {
+  method: 'pushAppStoreUpgradeProgress';
+  request: {
+    operation: IAppStoreUpgradeOperation;
+  };
+  response: Record<string, never>;
+}

package/ts/requests/index.ts

@@ -1,7 +1,7 @@
 import * as plugins from '../plugins.js';
 
 import * as adminRequests from './admin.js';
-import * as appCatalogRequests from './appcatalog.js';
+import * as appStoreRequests from './appstore.js';
 import * as baremetalRequests from './baremetal.js';
 import * as baseOsRequests from './baseos.js';
 import * as backupRequests from './backup.js';
@@ -31,7 +31,7 @@ import * as versionRequests from './version.js';
 
 export {
   adminRequests as admin,
-  appCatalogRequests as appcatalog,
+  appStoreRequests as appstore,
   baremetalRequests as baremetal,
   baseOsRequests as baseos,
   backupRequests as backup,

package/dist_ts/appcatalog/types.d.ts

@@ -1,83 +0,0 @@
-export type TAppCatalogPlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
-export interface IAppCatalogEnvVar {
-    key: string;
-    value?: string;
-    description: string;
-    required?: boolean;
-}
-export interface IAppCatalogVolume {
-    /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
-    name?: string;
-    /** Alias for name when a volume is shared intentionally across services. */
-    source?: string;
-    /** Container path where the volume is mounted. */
-    mountPath: string;
-    /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
-    driver?: string;
-    readOnly?: boolean;
-    /** Whether backup orchestration should snapshot this volume. Defaults to true. */
-    backup?: boolean;
-    /** Driver-specific options forwarded to the container runtime. */
-    options?: Record<string, string>;
-}
-export type TAppCatalogVolumeSpec = string | IAppCatalogVolume;
-export interface IAppCatalogPublishedPort {
-    targetPort: number;
-    targetPortEnd?: number;
-    publishedPort?: number;
-    publishedPortEnd?: number;
-    protocol?: 'tcp' | 'udp';
-    hostIp?: string;
-}
-export interface ICatalogApp {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    iconName?: string;
-    iconUrl?: string;
-    latestVersion: string;
-    tags?: string[];
-}
-export interface ICatalog {
-    schemaVersion: number;
-    updatedAt: string;
-    apps: ICatalogApp[];
-}
-export interface IAppMeta {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    iconName?: string;
-    latestVersion: string;
-    versions: string[];
-    maintainer?: string;
-    links?: Record<string, string>;
-}
-export interface IAppVersionConfig {
-    image: string;
-    port: number;
-    envVars?: IAppCatalogEnvVar[];
-    volumes?: TAppCatalogVolumeSpec[];
-    publishedPorts?: IAppCatalogPublishedPort[];
-    platformRequirements?: Partial<Record<TAppCatalogPlatformRequirement, boolean>>;
-    minOneboxVersion?: string;
-    minCloudlyVersion?: string;
-}
-export interface IAppInstallRequest {
-    appId: string;
-    version?: string;
-    serviceName: string;
-    domain?: string;
-    port?: number;
-    publishedPorts?: IAppCatalogPublishedPort[];
-    envVars?: Record<string, string>;
-}
-export interface IUpgradeableAppService {
-    serviceName: string;
-    appTemplateId: string;
-    currentVersion: string;
-    latestVersion: string;
-    hasMigration: boolean;
-}

package/dist_ts/requests/appcatalog.d.ts

@@ -1,44 +0,0 @@
-import * as plugins from '../plugins.js';
-import type { IIdentity } from '../data/user.js';
-import type { IService } from '../data/service.js';
-import type { IAppInstallRequest, IAppMeta, IAppVersionConfig, ICatalogApp, IUpgradeableAppService } from '../appcatalog/index.js';
-export interface IReq_Any_GetAppCatalogTemplates extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppCatalogTemplates> {
-    method: 'getAppCatalogTemplates';
-    request: {
-        identity: IIdentity;
-    };
-    response: {
-        apps: ICatalogApp[];
-    };
-}
-export interface IReq_Any_GetAppCatalogConfig extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetAppCatalogConfig> {
-    method: 'getAppCatalogConfig';
-    request: {
-        identity: IIdentity;
-        appId: string;
-        version: string;
-    };
-    response: {
-        config: IAppVersionConfig;
-        appMeta: IAppMeta;
-    };
-}
-export interface IReq_Any_InstallAppCatalogApp extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_InstallAppCatalogApp> {
-    method: 'installAppCatalogApp';
-    request: {
-        identity: IIdentity;
-        install: IAppInstallRequest;
-    };
-    response: {
-        service: IService;
-    };
-}
-export interface IReq_Any_GetUpgradeableAppCatalogServices extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_Any_GetUpgradeableAppCatalogServices> {
-    method: 'getUpgradeableAppCatalogServices';
-    request: {
-        identity: IIdentity;
-    };
-    response: {
-        services: IUpgradeableAppService[];
-    };
-}

package/dist_ts/requests/appcatalog.js

@@ -1,2 +0,0 @@
-import * as plugins from '../plugins.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwY2F0YWxvZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3JlcXVlc3RzL2FwcGNhdGFsb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUMifQ==

package/ts/appcatalog/types.ts

@@ -1,93 +0,0 @@
-export type TAppCatalogPlatformRequirement = 'mongodb' | 's3' | 'clickhouse' | 'redis' | 'mariadb';
-
-export interface IAppCatalogEnvVar {
-  key: string;
-  value?: string;
-  description: string;
-  required?: boolean;
-}
-
-export interface IAppCatalogVolume {
-  /** Stable Docker volume name. If omitted, the runtime derives one from service name and mount path. */
-  name?: string;
-  /** Alias for name when a volume is shared intentionally across services. */
-  source?: string;
-  /** Container path where the volume is mounted. */
-  mountPath: string;
-  /** Docker volume driver. Defaults to the runtime's persistent volume driver. */
-  driver?: string;
-  readOnly?: boolean;
-  /** Whether backup orchestration should snapshot this volume. Defaults to true. */
-  backup?: boolean;
-  /** Driver-specific options forwarded to the container runtime. */
-  options?: Record<string, string>;
-}
-
-export type TAppCatalogVolumeSpec = string | IAppCatalogVolume;
-
-export interface IAppCatalogPublishedPort {
-  targetPort: number;
-  targetPortEnd?: number;
-  publishedPort?: number;
-  publishedPortEnd?: number;
-  protocol?: 'tcp' | 'udp';
-  hostIp?: string;
-}
-
-export interface ICatalogApp {
-  id: string;
-  name: string;
-  description: string;
-  category: string;
-  iconName?: string;
-  iconUrl?: string;
-  latestVersion: string;
-  tags?: string[];
-}
-
-export interface ICatalog {
-  schemaVersion: number;
-  updatedAt: string;
-  apps: ICatalogApp[];
-}
-
-export interface IAppMeta {
-  id: string;
-  name: string;
-  description: string;
-  category: string;
-  iconName?: string;
-  latestVersion: string;
-  versions: string[];
-  maintainer?: string;
-  links?: Record<string, string>;
-}
-
-export interface IAppVersionConfig {
-  image: string;
-  port: number;
-  envVars?: IAppCatalogEnvVar[];
-  volumes?: TAppCatalogVolumeSpec[];
-  publishedPorts?: IAppCatalogPublishedPort[];
-  platformRequirements?: Partial<Record<TAppCatalogPlatformRequirement, boolean>>;
-  minOneboxVersion?: string;
-  minCloudlyVersion?: string;
-}
-
-export interface IAppInstallRequest {
-  appId: string;
-  version?: string;
-  serviceName: string;
-  domain?: string;
-  port?: number;
-  publishedPorts?: IAppCatalogPublishedPort[];
-  envVars?: Record<string, string>;
-}
-
-export interface IUpgradeableAppService {
-  serviceName: string;
-  appTemplateId: string;
-  currentVersion: string;
-  latestVersion: string;
-  hasMigration: boolean;
-}

package/ts/requests/appcatalog.ts

@@ -1,66 +0,0 @@
-import * as plugins from '../plugins.js';
-import type { IIdentity } from '../data/user.js';
-import type { IService } from '../data/service.js';
-import type {
-  IAppInstallRequest,
-  IAppMeta,
-  IAppVersionConfig,
-  ICatalogApp,
-  IUpgradeableAppService,
-} from '../appcatalog/index.js';
-
-export interface IReq_Any_GetAppCatalogTemplates extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_Any_GetAppCatalogTemplates
-> {
-  method: 'getAppCatalogTemplates';
-  request: {
-    identity: IIdentity;
-  };
-  response: {
-    apps: ICatalogApp[];
-  };
-}
-
-export interface IReq_Any_GetAppCatalogConfig extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_Any_GetAppCatalogConfig
-> {
-  method: 'getAppCatalogConfig';
-  request: {
-    identity: IIdentity;
-    appId: string;
-    version: string;
-  };
-  response: {
-    config: IAppVersionConfig;
-    appMeta: IAppMeta;
-  };
-}
-
-export interface IReq_Any_InstallAppCatalogApp extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_Any_InstallAppCatalogApp
-> {
-  method: 'installAppCatalogApp';
-  request: {
-    identity: IIdentity;
-    install: IAppInstallRequest;
-  };
-  response: {
-    service: IService;
-  };
-}
-
-export interface IReq_Any_GetUpgradeableAppCatalogServices extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_Any_GetUpgradeableAppCatalogServices
-> {
-  method: 'getUpgradeableAppCatalogServices';
-  request: {
-    identity: IIdentity;
-  };
-  response: {
-    services: IUpgradeableAppService[];
-  };
-}