@serve.zone/appstore 0.2.0

package/apps/wordpress/app.json

@@ -0,0 +1,10 @@
+{
+  "id": "wordpress",
+  "name": "WordPress",
+  "description": "Popular open-source content management system",
+  "category": "CMS",
+  "iconName": "wordpress",
+  "latestVersion": "1.0.0",
+  "versions": ["1.0.0"],
+  "maintainer": "serve.zone"
+}

package/apps/wordpress/versions/1.0.0/config.json

@@ -0,0 +1,13 @@
+{
+  "image": "wordpress:latest",
+  "port": 80,
+  "envVars": [
+    { "key": "WORDPRESS_DB_HOST", "value": "${MARIADB_HOST}:${MARIADB_PORT}", "description": "Database host (auto-injected by platform)" },
+    { "key": "WORDPRESS_DB_USER", "value": "${MARIADB_USER}", "description": "Database user (auto-injected by platform)" },
+    { "key": "WORDPRESS_DB_PASSWORD", "value": "${MARIADB_PASSWORD}", "description": "Database password (auto-injected by platform)" },
+    { "key": "WORDPRESS_DB_NAME", "value": "${MARIADB_DATABASE}", "description": "Database name (auto-injected by platform)" }
+  ],
+  "platformRequirements": {
+    "mariadb": true
+  }
+}

package/appstore.json

@@ -0,0 +1,191 @@
+{
+  "schemaVersion": 1,
+  "updatedAt": "2026-05-18T00:00:00Z",
+  "apps": [
+    {
+      "id": "nginx",
+      "name": "Nginx",
+      "description": "High-performance web server and reverse proxy. Lightweight, fast, and battle-tested.",
+      "category": "Web Server",
+      "iconName": "globe",
+      "latestVersion": "1.0.0",
+      "tags": ["web", "proxy"]
+    },
+    {
+      "id": "wordpress",
+      "name": "WordPress",
+      "description": "The world's most popular content management system. Powers over 40% of the web.",
+      "category": "CMS",
+      "iconName": "file-text",
+      "latestVersion": "1.0.0",
+      "tags": ["cms", "blog"]
+    },
+    {
+      "id": "ghost",
+      "name": "Ghost",
+      "description": "Modern publishing platform for creating professional blogs and newsletters.",
+      "category": "CMS",
+      "iconName": "book-open",
+      "latestVersion": "1.0.0",
+      "tags": ["cms", "blog", "newsletter"]
+    },
+    {
+      "id": "gitea",
+      "name": "Gitea",
+      "description": "Lightweight self-hosted Git service. Easy to install and maintain.",
+      "category": "Dev Tools",
+      "iconName": "git-branch",
+      "latestVersion": "1.0.0",
+      "tags": ["git", "devtools"]
+    },
+    {
+      "id": "gitops",
+      "name": "GitOps",
+      "description": "Operations dashboard for Git hosting, CI/CD secrets, pipeline logs, and documentation sync.",
+      "category": "Dev Tools",
+      "iconName": "git-branch",
+      "latestVersion": "1.0.0",
+      "tags": ["git", "devtools", "ci", "secrets"]
+    },
+    {
+      "id": "nextcloud",
+      "name": "Nextcloud",
+      "description": "Self-hosted file sync and share platform. Your own private cloud.",
+      "category": "Storage",
+      "iconName": "package",
+      "latestVersion": "1.0.0",
+      "tags": ["storage", "cloud"]
+    },
+    {
+      "id": "grafana",
+      "name": "Grafana",
+      "description": "Open-source observability platform for metrics, logs, and traces visualization.",
+      "category": "Monitoring",
+      "iconName": "monitor",
+      "latestVersion": "1.0.0",
+      "tags": ["monitoring", "observability"]
+    },
+    {
+      "id": "uptime-kuma",
+      "name": "Uptime Kuma",
+      "description": "Self-hosted monitoring tool. Beautiful UI for tracking uptime of services.",
+      "category": "Monitoring",
+      "iconName": "monitor",
+      "latestVersion": "1.0.0",
+      "tags": ["monitoring", "uptime"]
+    },
+    {
+      "id": "plausible",
+      "name": "Plausible Analytics",
+      "description": "Privacy-friendly web analytics. No cookies, GDPR compliant by design.",
+      "category": "Analytics",
+      "iconName": "monitor",
+      "latestVersion": "1.0.0",
+      "tags": ["analytics"]
+    },
+    {
+      "id": "vaultwarden",
+      "name": "Vaultwarden",
+      "description": "Lightweight Bitwarden-compatible password manager server.",
+      "category": "Security",
+      "iconName": "shield",
+      "latestVersion": "1.0.0",
+      "tags": ["security", "passwords"]
+    },
+    {
+      "id": "n8n",
+      "name": "N8N",
+      "description": "Workflow automation tool. Connect anything to everything with a visual editor.",
+      "category": "Automation",
+      "iconName": "server",
+      "latestVersion": "1.0.0",
+      "tags": ["automation", "workflow"]
+    },
+    {
+      "id": "mattermost",
+      "name": "Mattermost",
+      "description": "Open-source Slack alternative for team communication and collaboration.",
+      "category": "Communication",
+      "iconName": "mail",
+      "latestVersion": "1.0.0",
+      "tags": ["communication", "chat"]
+    },
+    {
+      "id": "siprouter",
+      "name": "SIP Router",
+      "description": "SIP B2BUA, WebRTC softphone bridge, voicemail, fax, and live telephony operations dashboard.",
+      "category": "Communication",
+      "iconName": "phone",
+      "latestVersion": "1.0.0",
+      "tags": ["sip", "telephony", "webrtc", "voice", "pbx"]
+    },
+    {
+      "id": "portainer",
+      "name": "Portainer",
+      "description": "Docker management UI. Monitor and manage containers from a web interface.",
+      "category": "Dev Tools",
+      "iconName": "package",
+      "latestVersion": "1.0.0",
+      "tags": ["docker", "devtools"]
+    },
+    {
+      "id": "rustdesk-server",
+      "name": "RustDesk Server",
+      "description": "Self-hosted RustDesk ID and relay server for secure remote desktop access.",
+      "category": "Remote Access",
+      "iconName": "monitor",
+      "latestVersion": "1.0.0",
+      "tags": ["remote-desktop", "relay", "self-hosted"]
+    },
+    {
+      "id": "cloudly",
+      "name": "Cloudly",
+      "description": "Multi-node serve.zone control plane for clusters, workload services, domains, and deployments.",
+      "category": "Dev Tools",
+      "iconName": "server",
+      "latestVersion": "1.0.0",
+      "tags": ["serve.zone", "control-plane", "clusters", "deployments"],
+      "source": {
+        "type": "repoManifest",
+        "url": "https://code.foss.global/serve.zone/cloudly/raw/branch/main/servezone.appstore.json",
+        "ref": "main"
+      }
+    },
+    {
+      "id": "redis",
+      "name": "Redis",
+      "description": "In-memory data store used as database, cache, and message broker.",
+      "category": "Database",
+      "iconName": "database",
+      "latestVersion": "1.0.0",
+      "tags": ["database", "cache"]
+    },
+    {
+      "id": "postgres",
+      "name": "PostgreSQL",
+      "description": "Advanced open-source relational database. Reliable and feature-rich.",
+      "category": "Database",
+      "iconName": "database",
+      "latestVersion": "1.0.0",
+      "tags": ["database", "sql"]
+    },
+    {
+      "id": "mariadb",
+      "name": "MariaDB",
+      "description": "Community-developed fork of MySQL. Drop-in replacement with enhanced features.",
+      "category": "Database",
+      "iconName": "database",
+      "latestVersion": "1.0.0",
+      "tags": ["database", "sql", "mysql"]
+    },
+    {
+      "id": "adminer",
+      "name": "Adminer",
+      "description": "Database management tool in a single PHP file. Supports MySQL, PostgreSQL, SQLite.",
+      "category": "Dev Tools",
+      "iconName": "database",
+      "latestVersion": "1.0.0",
+      "tags": ["database", "devtools"]
+    }
+  ]
+}

package/changelog.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## Pending
+
+
+## 2026-05-25 - 0.2.0
+
+### Features
+
+- publish appstore resolver client
+  - Adds the `@serve.zone/appstore` package with a TypeScript resolver client
+  - Renames the top-level index to `appstore.json`
+  - Supports linked `servezone.appstore.json` manifests and Docker digest-tracked app upgrades
+

package/dist_ts_client/classes.appstoreresolver.d.ts

@@ -0,0 +1,39 @@
+import type * as interfaces from '@serve.zone/interfaces';
+import type { IAppStoreResolverOptions, IParsedDockerImageReference, IResolvedAppStoreApp, TAppStoreApp, TAppStoreDockerImageSource, TAppStoreIndex, TAppStoreRepoManifestSource, TAppStoreResolvedSource, TAppStoreVersionConfig, TServezoneAppStoreManifest } from './types.js';
+export declare class AppStoreResolver {
+    readonly baseUrl: string;
+    private readonly fetchRef;
+    private readonly resolveDockerDigests;
+    private readonly now;
+    private appStoreCache;
+    private sourceAppCache;
+    constructor(optionsArg?: IAppStoreResolverOptions);
+    getAppStoreIndex(): Promise<TAppStoreIndex>;
+    getApps(): Promise<TAppStoreApp[]>;
+    getAppMeta(appIdArg: string): Promise<interfaces.appstore.IAppStoreAppMeta>;
+    getAppVersionConfig(appIdArg: string, versionArg: string): Promise<TAppStoreVersionConfig>;
+    resolveAppStore(appStoreArg: unknown): Promise<TAppStoreIndex>;
+    resolveRepoManifestSource(sourceArg: TAppStoreRepoManifestSource, appArg?: TAppStoreApp): Promise<IResolvedAppStoreApp>;
+    resolveDockerImageSource(sourceArg: TAppStoreDockerImageSource): Promise<TAppStoreResolvedSource>;
+    resolveDockerImageDigest(imageArg: string): Promise<string | null>;
+    validateAppStoreVersionConfig(configArg: TAppStoreVersionConfig, labelArg?: string): void;
+    normalizeVolumes(volumesArg?: TAppStoreVersionConfig['volumes']): interfaces.appstore.IAppStoreVolume[];
+    private fetchAppStoreIndex;
+    private resolveAppStoreApp;
+    private resolveServezoneAppStoreManifest;
+    private resolveConfigSource;
+    private applyDockerImageSourceToConfig;
+    private createAppMetaFromAppStoreApp;
+    private getAppStoreApp;
+    private fetchJson;
+    private fetchTextFromUrl;
+    private fetchDockerManifestDigest;
+    private fetchDockerRegistryToken;
+    private validateVolume;
+    private validatePublishedPorts;
+    private assertValidPort;
+}
+export declare function parseAppStoreIndex(inputArg: unknown): TAppStoreIndex;
+export declare function parseServezoneAppStoreManifest(inputArg: unknown): TServezoneAppStoreManifest;
+export declare function parseDockerImageReference(imageArg: string): IParsedDockerImageReference;
+export declare function createAppStoreVersionForDockerSource(sourceArg: TAppStoreDockerImageSource, fallbackVersionArg: string, digestArg?: string): string;