mirror of
https://github.com/uqbar-dao/nectar.git
synced 2024-12-22 16:11:38 +03:00
322 lines
8.8 KiB
Plaintext
322 lines
8.8 KiB
Plaintext
/// The App Store manages the discovery, download, and installation of packages (apps)
|
|
/// in the Kinode ecosystem. It consists of three main processes: main, chain, and downloads.
|
|
|
|
/// main:app-store:sys
|
|
interface main {
|
|
use standard.{package-id};
|
|
use chain.{onchain-metadata, chain-error};
|
|
use downloads.{download-error};
|
|
|
|
/// Represents various requests that can be made to the main App Store interface
|
|
variant request {
|
|
local(local-request),
|
|
}
|
|
|
|
/// Represents various responses from the main App Store interface
|
|
variant response {
|
|
local(local-response),
|
|
chain-error(chain-error),
|
|
download-error(download-error),
|
|
handling-error(string),
|
|
}
|
|
|
|
/// Local requests that can be made to the App Store
|
|
variant local-request {
|
|
/// Request to add a new package to app-store. Includes zip and an optional onchain-metadata.
|
|
/// This is used by kit start
|
|
new-package(new-package-request),
|
|
/// Request to install a package
|
|
install(install-package-request),
|
|
/// Request to uninstall a package
|
|
uninstall(package-id),
|
|
/// Request to list all available APIs
|
|
apis,
|
|
/// Request to get a specific API
|
|
get-api(package-id),
|
|
}
|
|
|
|
/// Local responses from the App Store
|
|
variant local-response {
|
|
new-package-response(new-package-response),
|
|
install-response(install-response),
|
|
uninstall-response(uninstall-response),
|
|
apis-response(apis-response),
|
|
get-api-response(get-api-response),
|
|
}
|
|
|
|
/// Request to add a new package
|
|
record new-package-request {
|
|
package-id: package-id,
|
|
mirror: bool,
|
|
}
|
|
|
|
/// Request to install a package
|
|
record install-package-request {
|
|
package-id: package-id,
|
|
metadata: option<onchain-metadata>, // if None, local sideloaded package.
|
|
version-hash: string,
|
|
}
|
|
|
|
/// Response for a new package request
|
|
enum new-package-response {
|
|
success,
|
|
no-blob,
|
|
install-failed,
|
|
already-exists,
|
|
}
|
|
|
|
/// Response for an install request
|
|
enum install-response {
|
|
success,
|
|
failure,
|
|
}
|
|
|
|
/// Response for an uninstall request
|
|
enum uninstall-response {
|
|
success,
|
|
failure,
|
|
}
|
|
|
|
/// Response containing a list of available APIs
|
|
record apis-response {
|
|
apis: list<package-id>,
|
|
}
|
|
|
|
/// Response for a get-api request
|
|
/// The API itself will be in the response blob if successful
|
|
enum get-api-response {
|
|
success,
|
|
failure,
|
|
}
|
|
}
|
|
|
|
/// chain:app-store:sys
|
|
/// This process holds information about on-chain ~uri and ~hash notes,
|
|
/// and fetches the metadata with the http-client:distro:sys when necessary.
|
|
interface chain {
|
|
use standard.{package-id};
|
|
|
|
/// Requests that can be made to the chain component
|
|
variant chain-requests {
|
|
/// Get information about a specific app
|
|
get-app(package-id),
|
|
/// Get information about all apps
|
|
get-apps,
|
|
/// Get information about apps published by the current node
|
|
get-our-apps,
|
|
/// Start auto-updating an app
|
|
start-auto-update(package-id),
|
|
/// Stop auto-updating an app
|
|
stop-auto-update(package-id),
|
|
}
|
|
|
|
/// Responses from the chain component
|
|
variant chain-responses {
|
|
get-app(option<onchain-app>),
|
|
get-apps(list<onchain-app>),
|
|
get-our-apps(list<onchain-app>),
|
|
auto-update-started,
|
|
auto-update-stopped,
|
|
err(chain-error),
|
|
}
|
|
|
|
/// Possible errors from the chain component
|
|
variant chain-error {
|
|
no-package,
|
|
}
|
|
|
|
/// Represents an app as stored on-chain
|
|
record onchain-app {
|
|
package-id: package-id,
|
|
tba: string,
|
|
metadata-uri: string,
|
|
metadata-hash: string,
|
|
metadata: option<onchain-metadata>,
|
|
auto-update: bool,
|
|
}
|
|
|
|
/// Metadata associated with an on-chain app
|
|
record onchain-metadata {
|
|
name: option<string>,
|
|
description: option<string>,
|
|
image: option<string>,
|
|
external-url: option<string>,
|
|
animation-url: option<string>,
|
|
properties: onchain-properties,
|
|
}
|
|
|
|
/// Properties associated with an on-chain app
|
|
record onchain-properties {
|
|
package-name: string,
|
|
publisher: string,
|
|
current-version: string,
|
|
mirrors: list<string>,
|
|
code-hashes: list<tuple<string, string>>,
|
|
license: option<string>,
|
|
screenshots: option<list<string>>,
|
|
wit-version: option<u32>,
|
|
dependencies: option<list<string>>,
|
|
}
|
|
}
|
|
|
|
/// downloads:app-store:sys
|
|
/// This process is responsible for downloading app packages from remote mirrors,
|
|
/// spawning ft_workers, and serves the files to the main:app-store:sys process.
|
|
/// It also manages the local storage of downloaded app zip packages.
|
|
///
|
|
interface downloads {
|
|
use standard.{package-id};
|
|
use chain.{onchain-metadata};
|
|
|
|
/// Requests that can be made to the downloads component
|
|
variant download-requests {
|
|
/// Request a remote download
|
|
remote-download(remote-download-request),
|
|
/// Request a chunk of a file
|
|
chunk(chunk-request),
|
|
/// Update download progress
|
|
progress(progress-update),
|
|
/// Update file size information
|
|
size(size-update),
|
|
/// Request a local download
|
|
local-download(local-download-request),
|
|
/// Request an auto-update
|
|
auto-update(auto-update-request),
|
|
/// Notify that a download is complete
|
|
download-complete(download-complete-request),
|
|
/// Auto-update-download complete
|
|
auto-download-complete(auto-download-complete-request),
|
|
/// Get files for a package
|
|
get-files(option<package-id>),
|
|
/// Remove a file
|
|
remove-file(remove-file-request),
|
|
/// Add a download
|
|
add-download(add-download-request),
|
|
/// Start mirroring a package
|
|
start-mirroring(package-id),
|
|
/// Stop mirroring a package
|
|
stop-mirroring(package-id),
|
|
}
|
|
|
|
/// Responses from the downloads component
|
|
variant download-responses {
|
|
success,
|
|
err(download-error),
|
|
get-files(list<entry>),
|
|
}
|
|
|
|
/// Request for a local download
|
|
record local-download-request {
|
|
package-id: package-id,
|
|
download-from: string,
|
|
desired-version-hash: string,
|
|
}
|
|
|
|
/// Request for an auto-update
|
|
record auto-update-request {
|
|
package-id: package-id,
|
|
metadata: onchain-metadata,
|
|
}
|
|
|
|
/// Request for a remote download
|
|
record remote-download-request {
|
|
package-id: package-id,
|
|
worker-address: string,
|
|
desired-version-hash: string,
|
|
}
|
|
|
|
/// Possible errors during download operations
|
|
variant download-error {
|
|
no-package,
|
|
not-mirroring,
|
|
hash-mismatch(hash-mismatch),
|
|
file-not-found,
|
|
worker-spawn-failed,
|
|
http-client-error,
|
|
blob-not-found,
|
|
vfs-error,
|
|
handling-error(string),
|
|
}
|
|
|
|
/// Notification that a download is complete
|
|
record download-complete-request {
|
|
package-id: package-id,
|
|
version-hash: string,
|
|
err: option<download-error>,
|
|
}
|
|
|
|
/// Request for an auto-download complete
|
|
record auto-download-complete-request {
|
|
download-info: download-complete-request,
|
|
manifest-hash: string,
|
|
}
|
|
|
|
/// Represents a hash mismatch error
|
|
record hash-mismatch {
|
|
desired: string,
|
|
actual: string,
|
|
}
|
|
|
|
/// Request for a specific chunk of a file
|
|
record chunk-request {
|
|
package-id: package-id,
|
|
version-hash: string,
|
|
offset: u64,
|
|
length: u64,
|
|
}
|
|
|
|
/// Represents an entry in the file system (either a file or a directory)
|
|
variant entry {
|
|
file(file-entry),
|
|
dir(dir-entry),
|
|
}
|
|
|
|
/// Represents a file entry
|
|
record file-entry {
|
|
name: string,
|
|
size: u64,
|
|
manifest: string,
|
|
}
|
|
|
|
/// Represents a directory entry
|
|
record dir-entry {
|
|
name: string,
|
|
mirroring: bool,
|
|
}
|
|
|
|
/// Request to remove a file
|
|
record remove-file-request {
|
|
package-id: package-id,
|
|
version-hash: string,
|
|
}
|
|
|
|
/// Request to add a download
|
|
record add-download-request {
|
|
package-id: package-id,
|
|
version-hash: string,
|
|
mirror: bool,
|
|
}
|
|
|
|
/// Update on the progress of a download
|
|
record progress-update {
|
|
package-id: package-id,
|
|
version-hash: string,
|
|
downloaded: u64,
|
|
total: u64,
|
|
}
|
|
|
|
/// Update on the size of a file
|
|
record size-update {
|
|
package-id: package-id,
|
|
size: u64,
|
|
}
|
|
}
|
|
|
|
/// The app-store-sys-v1 world, which includes the main, downloads, and chain interfaces
|
|
world app-store-sys-v1 {
|
|
import main;
|
|
import downloads;
|
|
import chain;
|
|
include process-v0;
|
|
}
|