@webboxes/plugin-hub 0.0.0-stage → 0.2.0

package/dist/github-cli.js

@@ -0,0 +1,140 @@
+// The share ports over the user's own `gh` and `git` (spec 044 guards: credentials stay with the user's tools; nothing waits on a prompt).
+// In the shipped app these come from the user's machine: a missing tool or a missing login is reported with what to do, never worked around.
+import { spawnSync } from 'node:child_process';
+export class ToolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ToolError';
+    }
+}
+const HINT = {
+    gh: 'install GitHub CLI (https://cli.github.com) and sign in with: gh auth login',
+    git: 'install git (https://git-scm.com)',
+};
+/** What to do when the tool is there but its login is not: only the sign-in step. */
+const SIGN_IN = {
+    gh: 'sign in with: gh auth login',
+    git: 'sign in to the git host (for GitHub: gh auth login, then gh auth setup-git)',
+};
+function run(command, args, cwd) {
+    const result = spawnSync(command, [...args], { cwd, encoding: 'utf8', env: { ...process.env, GIT_TERMINAL_PROMPT: '0', GH_PROMPT_DISABLED: '1' }, maxBuffer: 64 * 1024 * 1024 });
+    if (result.error !== undefined)
+        throw new ToolError(`${command} is not available here: ${HINT[command] ?? result.error.message}`);
+    return { status: result.status ?? 1, stdout: result.stdout ?? '', stderr: result.stderr ?? '' };
+}
+function must(command, args, cwd) {
+    const result = run(command, args, cwd);
+    if (result.status !== 0) {
+        const last = result.stderr.trim().split('\n').at(-1) ?? `exit ${String(result.status)}`;
+        throw new ToolError(`${command} ${args.slice(0, 2).join(' ')} failed: ${last}${/auth|login|credential|HTTP 401/iu.test(result.stderr) ? ` (${SIGN_IN[command] ?? ''})` : ''}`);
+    }
+    return result.stdout;
+}
+export function githubCli() {
+    return {
+        login: () => must('gh', ['api', 'user', '--jq', '.login']).trim(),
+        repository(owner, repo) {
+            const result = run('gh', ['repo', 'view', `${owner}/${repo}`, '--json', 'visibility,url']);
+            if (result.status !== 0) {
+                if (/could not resolve to a repository|not found/iu.test(result.stderr))
+                    return undefined;
+                throw new ToolError(`gh repo view ${owner}/${repo} failed: ${result.stderr.trim().split('\n').at(-1) ?? ''}`);
+            }
+            const body = JSON.parse(result.stdout);
+            return { visibility: body.visibility?.toLowerCase() === 'public' ? 'public' : 'private', url: body.url ?? `https://github.com/${owner}/${repo}` };
+        },
+        createRepository(owner, repo, visibility, description) {
+            must('gh', ['repo', 'create', `${owner}/${repo}`, `--${visibility}`, '--description', description]);
+        },
+        setVisibility(owner, repo, visibility) {
+            must('gh', ['repo', 'edit', `${owner}/${repo}`, '--visibility', visibility, '--accept-visibility-change-consequences']);
+        },
+        addTopics(owner, repo, topics) {
+            must('gh', ['repo', 'edit', `${owner}/${repo}`, ...topics.flatMap(topic => ['--add-topic', topic])]);
+        },
+        releaseExists: (owner, repo, tag) => run('gh', ['release', 'view', tag, '-R', `${owner}/${repo}`, '--json', 'tagName']).status === 0,
+        createRelease(owner, repo, tag, title, notes, assetPath) {
+            return must('gh', ['release', 'create', tag, assetPath, '-R', `${owner}/${repo}`, '--title', title, '--notes', notes, '--verify-tag']).trim();
+        },
+        cloneUrl: (owner, repo) => `https://github.com/${owner}/${repo}.git`,
+    };
+}
+export function gitCli() {
+    return {
+        clone(url, dir) { must('git', ['clone', '--quiet', url, dir]); },
+        commitAll(dir, message) {
+            must('git', ['add', '--all', '.'], dir);
+            if (run('git', ['diff', '--cached', '--quiet'], dir).status === 0)
+                return false;
+            must('git', ['commit', '--quiet', '-m', message], dir);
+            return true;
+        },
+        tag(dir, tag, message) { must('git', ['tag', '-a', tag, '-m', message], dir); },
+        push(dir, tag, fallbackBranch) {
+            const branch = run('git', ['symbolic-ref', '--short', 'HEAD'], dir).stdout.trim() || fallbackBranch;
+            must('git', ['push', '--quiet', 'origin', `HEAD:refs/heads/${branch}`], dir);
+            must('git', ['push', '--quiet', 'origin', `refs/tags/${tag}`], dir);
+        },
+    };
+}
+/**
+ * GitHub releases through the user's own `gh` login: what a pull of a private repository needs (an anonymous request cannot see it). Assets
+ * are fetched by their API address with `Accept: application/octet-stream`, which works for private and public repositories alike.
+ */
+export function githubReleasesViaGh() {
+    return {
+        async release(owner, repo, tag) {
+            const path = tag === undefined ? 'releases/latest' : `releases/tags/${encodeURIComponent(tag)}`;
+            const result = run('gh', ['api', `repos/${owner}/${repo}/${path}`]);
+            if (result.status !== 0) {
+                if (/HTTP 404|Not Found/iu.test(result.stderr))
+                    return undefined;
+                throw new ToolError(`gh api repos/${owner}/${repo}/${path} failed: ${result.stderr.trim().split('\n').at(-1) ?? ''}`);
+            }
+            const body = JSON.parse(result.stdout);
+            if (typeof body.tag_name !== 'string' || !Array.isArray(body.assets))
+                throw new ToolError(`gh returned an unexpected release for ${owner}/${repo}`);
+            return { tag: body.tag_name, assets: body.assets.flatMap(asset => (typeof asset.name === 'string' && typeof asset.url === 'string' ? [{ name: asset.name, url: asset.url, ...(typeof asset.digest === 'string' ? { digest: asset.digest } : {}) }] : [])) };
+        },
+        async download(url) {
+            const result = spawnSync('gh', ['api', '-H', 'Accept: application/octet-stream', url], { env: { ...process.env, GH_PROMPT_DISABLED: '1' }, maxBuffer: 64 * 1024 * 1024 });
+            if (result.error !== undefined)
+                throw new ToolError(`gh is not available here: ${HINT['gh'] ?? ''}`);
+            if (result.status !== 0)
+                throw new ToolError(`gh could not download ${url}: ${String(result.stderr).trim().split('\n').at(-1) ?? ''}`);
+            return new Uint8Array(result.stdout);
+        },
+    };
+}
+/**
+ * Releases from the first port that sees the repository: anonymous HTTPS for a public one, then the user's `gh` for a private one. Downloads
+ * go to the port that answered for the release, since only it can fetch its asset addresses.
+ */
+export function firstReleasePort(...ports) {
+    const answered = new Map();
+    return {
+        async release(owner, repo, tag) {
+            let lastError;
+            for (const port of ports) {
+                try {
+                    const found = await port.release(owner, repo, tag);
+                    if (found !== undefined) {
+                        for (const asset of found.assets)
+                            answered.set(asset.url, port);
+                        return found;
+                    }
+                }
+                catch (cause) {
+                    lastError = cause;
+                }
+            }
+            if (lastError !== undefined)
+                throw lastError;
+            return undefined;
+        },
+        async download(url) {
+            return (answered.get(url) ?? ports[0]).download(url);
+        },
+    };
+}
+//# sourceMappingURL=github-cli.js.map

package/dist/github-cli.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+import type { RegistryPort, ReleasePort } from './pull.js';
+export type Fetch = (url: string, init?: {
+    readonly headers?: Record<string, string>;
+    readonly signal?: AbortSignal;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    json(): Promise<unknown>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+/** GitHub releases of public repositories, through api.github.com. */
+export declare function githubReleasesOverHttps(fetchImpl?: Fetch, api?: string): ReleasePort;
+/** The public npm registry (or another registry URL). */
+export declare function npmRegistryOverHttps(fetchImpl?: Fetch, registry?: string): RegistryPort;
+/** A plain https download, for a tarball-URL source. */
+export declare function httpsDownload(fetchImpl?: Fetch): (url: string) => Promise<Uint8Array>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAe,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvE,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC,CAAA;AAenP,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,KAAiC,EAAE,GAAG,SAA2B,GAAG,WAAW,CAiBjI;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,KAAiC,EAAE,QAAQ,SAA+B,GAAG,YAAY,CAcxI;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,SAAS,GAAE,KAAiC,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAEhH"}

package/dist/http.js

@@ -0,0 +1,59 @@
+const MAX_DOWNLOAD_BYTES = 64 * 1024 * 1024;
+const TIMEOUT_MS = 30_000;
+const USER_AGENT = 'acryl-plugin-hub';
+async function downloadBytes(fetchImpl, url) {
+    if (!url.startsWith('https://'))
+        throw new Error(`refusing a non-https download: ${url}`);
+    const response = await fetchImpl(url, { headers: { 'User-Agent': USER_AGENT, Accept: 'application/octet-stream' }, signal: AbortSignal.timeout(TIMEOUT_MS) });
+    if (!response.ok)
+        throw new Error(`${url} answered ${response.status}`);
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.length > MAX_DOWNLOAD_BYTES)
+        throw new Error(`${url} is larger than ${MAX_DOWNLOAD_BYTES} bytes`);
+    return bytes;
+}
+/** GitHub releases of public repositories, through api.github.com. */
+export function githubReleasesOverHttps(fetchImpl = fetch, api = 'https://api.github.com') {
+    return {
+        async release(owner, repo, tag) {
+            const path = tag === undefined ? 'releases/latest' : `releases/tags/${encodeURIComponent(tag)}`;
+            const response = await fetchImpl(`${api}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/${path}`, { headers: { 'User-Agent': USER_AGENT, Accept: 'application/vnd.github+json' }, signal: AbortSignal.timeout(TIMEOUT_MS) });
+            if (response.status === 404)
+                return undefined;
+            if (!response.ok)
+                throw new Error(`GitHub answered ${response.status} for ${owner}/${repo}`);
+            const body = await response.json();
+            if (typeof body.tag_name !== 'string' || !Array.isArray(body.assets))
+                throw new Error(`GitHub returned an unexpected release for ${owner}/${repo}`);
+            const assets = body.assets.flatMap((asset) => typeof asset.name === 'string' && typeof asset.browser_download_url === 'string'
+                ? [{ name: asset.name, url: asset.browser_download_url, ...(typeof asset.digest === 'string' ? { digest: asset.digest } : {}) }]
+                : []);
+            return { tag: body.tag_name, assets };
+        },
+        download: url => downloadBytes(fetchImpl, url),
+    };
+}
+/** The public npm registry (or another registry URL). */
+export function npmRegistryOverHttps(fetchImpl = fetch, registry = 'https://registry.npmjs.org') {
+    return {
+        async resolve(name, version) {
+            const response = await fetchImpl(`${registry.replace(/\/$/u, '')}/${name.replace('/', '%2F')}`, { headers: { 'User-Agent': USER_AGENT, Accept: 'application/json' }, signal: AbortSignal.timeout(TIMEOUT_MS) });
+            if (response.status === 404)
+                return undefined;
+            if (!response.ok)
+                throw new Error(`the registry answered ${response.status} for ${name}`);
+            const body = await response.json();
+            const chosen = version ?? body['dist-tags']?.['latest'];
+            const dist = chosen === undefined ? undefined : body.versions?.[chosen]?.dist;
+            if (chosen === undefined || typeof dist?.tarball !== 'string')
+                return undefined;
+            return { version: chosen, tarball: dist.tarball, ...(typeof dist.integrity === 'string' ? { integrity: dist.integrity } : {}) };
+        },
+        download: url => downloadBytes(fetchImpl, url),
+    };
+}
+/** A plain https download, for a tarball-URL source. */
+export function httpsDownload(fetchImpl = fetch) {
+    return url => downloadBytes(fetchImpl, url);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/hub.d.ts

@@ -0,0 +1,129 @@
+import { type RegistryPort, type ReleasePort } from './pull.js';
+import { type NpmPublishOptions, type NpmPublishPort, type NpmPublishResult } from './npm-publish.js';
+import { type PublishGitPort, type RepositoryHostPort, type ShareOptions, type ShareResult } from './share.js';
+import type { PluginStore, StoredVersion } from './store.js';
+import { type VersionBump } from './version.js';
+/** The outcome an installer reports, in the shape DSH's `pluginManager` returns (`ChangeResult`), reduced to what the hub reads. */
+export interface InstallOutcome {
+    readonly application: 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
+    readonly error?: {
+        readonly code: string;
+    };
+    readonly packageResult?: {
+        readonly output: string;
+    };
+}
+/** What installs a stored tarball into the running app and lists what is installed: DSH's `pluginManager` in a DSH-based app. */
+export interface InstallerPort {
+    installBundle(tarballPath: string): Promise<InstallOutcome>;
+    listBundles(): Promise<readonly {
+        readonly name: string;
+        readonly version?: string;
+        readonly enabled: boolean;
+        readonly installed: boolean;
+        readonly removable: boolean;
+    }[]>;
+}
+export interface HubPorts {
+    readonly store: PluginStore;
+    readonly releases?: ReleasePort;
+    readonly registry?: RegistryPort;
+    readonly download?: (url: string) => Promise<Uint8Array>;
+    /** Whether the app provides a service on the host side, for the service contract check. */
+    readonly has: (service: string) => boolean;
+    /** The installer, read when needed (it may load after the hub); undefined when the app has none. */
+    readonly installer: () => InstallerPort | undefined;
+    /** The git host and git for sharing (the user's own `gh` and `git`); without them sharing is unavailable and says so. */
+    readonly share?: {
+        readonly host: RepositoryHostPort;
+        readonly git: PublishGitPort;
+    };
+    /** npm for publishing (the user's own `npm`); without it publishing to npm is unavailable and says so. */
+    readonly npm?: NpmPublishPort;
+}
+export type PullStatus = 'installed' | 'restart-required' | 'stored' | 'missing-services' | 'install-failed' | 'overridden' | 'cancelled';
+export interface PullResult {
+    readonly status: PullStatus;
+    readonly name: string;
+    readonly version: string;
+    readonly integrity: string;
+    readonly path: string;
+    /** False when the store already held these exact bytes. */
+    readonly added: boolean;
+    readonly fetchedFrom: string;
+    /** Whether the plugin declares a host service contract the hub could check (a stock DSH plugin usually has none). */
+    readonly contractChecked: boolean;
+    /** The required host services this app lacks; the plugin is kept but not installed. */
+    readonly missing?: readonly string[];
+    /** Why it is only stored, when it is. */
+    readonly reason?: string;
+    readonly outcome?: InstallOutcome;
+}
+export interface SaveResult {
+    readonly name: string;
+    readonly version: string;
+    readonly integrity: string;
+    readonly path: string;
+    readonly files: readonly string[];
+    readonly added: boolean;
+}
+export type UpdateResult = {
+    readonly status: 'updated' | 'restart-required';
+    readonly name: string;
+    readonly from?: string;
+    readonly to: string;
+    readonly source: string;
+    readonly pull: PullResult;
+} | {
+    readonly status: 'up-to-date';
+    readonly name: string;
+    readonly version: string;
+    readonly source: string;
+} | {
+    readonly status: 'not-updatable';
+    readonly name: string;
+    readonly reason: string;
+} | {
+    readonly status: 'failed';
+    readonly name: string;
+    readonly source: string;
+    readonly pull: PullResult;
+};
+export interface InstalledPlugin {
+    readonly name: string;
+    readonly version?: string;
+    readonly enabled: boolean;
+    readonly removable: boolean;
+}
+/**
+ * The host half of a plugin's service contract against an app: the services its `acryl.requires.host` names that the app does not provide.
+ * A plugin without a contract is not refused; `checked` says so, and a missing service would then show as PENDING after install.
+ */
+export declare function missingHostServices(manifest: Readonly<Record<string, unknown>>, has: (service: string) => boolean): {
+    readonly checked: boolean;
+    readonly missing: readonly string[];
+};
+/** A source folder by absolute path, or by its package name or folder name under one of the app's source roots. */
+export declare function findSourceFolder(nameOrFolder: string, sourceRoots: readonly (string | undefined)[]): string | undefined;
+export interface PluginHub {
+    readonly store: PluginStore;
+    saved(): StoredVersion[];
+    save(folder: string): SaveResult;
+    bump(folder: string, bump: VersionBump): {
+        readonly name: string;
+        readonly from: string;
+        readonly to: string;
+    };
+    pull(source: string, options?: {
+        readonly install?: boolean;
+        readonly expectIntegrity?: string;
+    }): Promise<PullResult>;
+    installed(): Promise<InstalledPlugin[] | undefined>;
+    share(folder: string, options?: ShareOptions): Promise<ShareResult>;
+    /** Pull and install the newest release of an installed plugin from where it was pulled before (the store records that). */
+    update(name: string): Promise<UpdateResult>;
+    /** Publish a plugin to an npm registry (the public one unless `registry` names another). */
+    publishNpm(folder: string, options?: NpmPublishOptions): Promise<NpmPublishResult>;
+}
+export declare function createPluginHub(ports: HubPorts): PluginHub;
+//# sourceMappingURL=hub.d.ts.map

package/dist/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../src/hub.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAG3E,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnH,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3H,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE3F,oIAAoI;AACpI,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,kBAAkB,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAA;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrD;AAED,iIAAiI;AACjI,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC3D,WAAW,IAAI,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAA;CAC7K;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACxD,2FAA2F;IAC3F,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,oGAAoG;IACpG,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,GAAG,SAAS,CAAA;IACnD,yHAAyH;IACzH,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;KAAE,CAAA;IACpF,0GAA0G;IAC1G,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAA;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,kBAAkB,GAAG,QAAQ,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,WAAW,CAAA;AAEzI,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,qHAAqH;IACrH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC3K;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3G;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAY5G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAKtL;AAED,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAcvH;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,KAAK,IAAI,aAAa,EAAE,CAAA;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAChC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9G,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACtH,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,GAAG,SAAS,CAAC,CAAA;IACnD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACnE,2HAA2H;IAC3H,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC3C,4FAA4F;IAC5F,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACnF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAgF1D"}

package/dist/hub.js

@@ -0,0 +1,148 @@
+// The plugin hub: the one set of operations every face drives (a chat command, a CLI verb, an agent tool, the Plugins page), so a result is the
+// same whichever face asked (spec 044 lifecycle.md, "One service, four faces"). Host-independent: the app supplies what it has through ports
+// (which services it provides, its installer, its source folders), and an app without an installer still saves and pulls into the store.
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { pullPlugin } from './pull.js';
+import { formatPluginSource, parsePluginSource } from './source.js';
+import { savePlugin } from './save.js';
+import { publishToNpm } from './npm-publish.js';
+import { sharePlugin } from './share.js';
+import { bumpVersion, compareVersions, parseVersion } from './version.js';
+/** The same source without a version, so it names the newest release; undefined for a file, URL or folder, which have no newer release. */
+function followLatest(source) {
+    switch (source.kind) {
+        case 'github': return { kind: 'github', owner: source.owner, repo: source.repo };
+        case 'npm': return { kind: 'npm', name: source.name };
+        case 'name': return { kind: 'name', name: source.name };
+        case 'store':
+        case 'tarball-file':
+        case 'tarball-url':
+        case 'folder': return undefined;
+    }
+}
+/**
+ * The host half of a plugin's service contract against an app: the services its `acryl.requires.host` names that the app does not provide.
+ * A plugin without a contract is not refused; `checked` says so, and a missing service would then show as PENDING after install.
+ */
+export function missingHostServices(manifest, has) {
+    const acryl = manifest['acryl'];
+    const required = acryl?.requires?.host;
+    if (!Array.isArray(required))
+        return { checked: false, missing: [] };
+    return { checked: true, missing: required.filter((service) => typeof service === 'string' && !has(service)) };
+}
+/** A source folder by absolute path, or by its package name or folder name under one of the app's source roots. */
+export function findSourceFolder(nameOrFolder, sourceRoots) {
+    if (isAbsolute(nameOrFolder))
+        return existsSync(join(nameOrFolder, 'package.json')) ? nameOrFolder : undefined;
+    for (const root of sourceRoots) {
+        if (root === undefined || !existsSync(root))
+            continue;
+        for (const entry of readdirSync(root, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const dir = join(root, entry.name);
+            try {
+                const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+                if (pkg.name === nameOrFolder || entry.name === nameOrFolder)
+                    return dir;
+            }
+            catch { /* not a plugin folder */ }
+        }
+    }
+    return undefined;
+}
+export function createPluginHub(ports) {
+    const { store } = ports;
+    const hub = {
+        store,
+        saved: () => store.list(),
+        save(folder) {
+            const { packed, stored, added } = savePlugin(folder, store);
+            return { name: stored.name, version: stored.version, integrity: stored.integrity, path: stored.path, files: packed.files, added };
+        },
+        bump(folder, bump) {
+            const file = join(folder, 'package.json');
+            const text = readFileSync(file, 'utf8');
+            const pkg = JSON.parse(text);
+            if (typeof pkg['version'] !== 'string')
+                throw new Error(`${file} has no "version"`);
+            const next = bumpVersion(pkg['version'], bump);
+            const indent = /^(\s+)"/mu.exec(text)?.[1] ?? '  ';
+            writeFileSync(file, `${JSON.stringify({ ...pkg, version: next }, null, indent)}\n`);
+            return { name: String(pkg['name']), from: pkg['version'], to: next };
+        },
+        async pull(argument, options = {}) {
+            const pulled = await pullPlugin(parsePluginSource(argument), {
+                store,
+                ...(ports.releases === undefined ? {} : { releases: ports.releases }),
+                ...(ports.registry === undefined ? {} : { registry: ports.registry }),
+                ...(ports.download === undefined ? {} : { download: ports.download }),
+            }, options.expectIntegrity === undefined ? {} : { expectIntegrity: options.expectIntegrity });
+            const base = { name: pulled.stored.name, version: pulled.stored.version, integrity: pulled.stored.integrity, path: pulled.stored.path, added: pulled.added, fetchedFrom: pulled.fetchedFrom };
+            const contract = missingHostServices(pulled.manifest, ports.has);
+            if (contract.missing.length > 0)
+                return { ...base, status: 'missing-services', contractChecked: true, missing: contract.missing };
+            if (options.install === false)
+                return { ...base, status: 'stored', contractChecked: contract.checked };
+            const installer = ports.installer();
+            if (installer === undefined)
+                return { ...base, status: 'stored', contractChecked: contract.checked, reason: 'this app has no plugin installer (DSH\'s plugin manager is not loaded)' };
+            const outcome = await installer.installBundle(pulled.stored.path);
+            const status = outcome.error !== undefined || outcome.application === 'failed' ? 'install-failed' : outcome.application === 'applied' ? 'installed' : outcome.application;
+            return { ...base, status, contractChecked: contract.checked, outcome };
+        },
+        async share(folder, options = {}) {
+            if (ports.share === undefined)
+                return { status: 'refused', reason: 'sharing is not available in this app (no git host connection)' };
+            return sharePlugin(folder, options, { host: ports.share.host, git: ports.share.git, store });
+        },
+        async publishNpm(folder, options = {}) {
+            if (ports.npm === undefined)
+                return { status: 'refused', reason: 'publishing to npm is not available in this app' };
+            return publishToNpm(folder, options, { npm: ports.npm, store });
+        },
+        async update(name) {
+            const installedVersion = (await hub.installed())?.find(plugin => plugin.name === name)?.version;
+            const records = store.list().filter(entry => entry.name === name);
+            const record = records.find(entry => entry.version === installedVersion) ?? records[0];
+            if (record === undefined)
+                return { status: 'not-updatable', name, reason: `${name} was not pulled through the plugin hub, so where its newer versions are is not known; pull it once from its source (github:, npm:)` };
+            let latest;
+            try {
+                latest = followLatest(parsePluginSource(record.from));
+            }
+            catch {
+                latest = undefined;
+            }
+            if (latest === undefined)
+                return { status: 'not-updatable', name, reason: `${name} came from ${record.from}, which has no newer releases; pull a newer file or release explicitly` };
+            const source = formatPluginSource(latest);
+            const current = parseVersion(installedVersion ?? record.version);
+            const fetched = await hub.pull(source, { install: false });
+            const newest = parseVersion(fetched.version);
+            if (current !== undefined && newest !== undefined && compareVersions(newest, current) <= 0)
+                return { status: 'up-to-date', name, version: current.text, source };
+            if (fetched.status === 'missing-services')
+                return { status: 'failed', name, source, pull: fetched };
+            const pulled = await hub.pull(`store:${name}@${fetched.version}`);
+            const from = installedVersion ?? record.version;
+            if (pulled.status === 'installed')
+                return { status: 'updated', name, from, to: pulled.version, source, pull: pulled };
+            if (pulled.status === 'restart-required')
+                return { status: 'restart-required', name, from, to: pulled.version, source, pull: pulled };
+            return { status: 'failed', name, source, pull: pulled };
+        },
+        async installed() {
+            const installer = ports.installer();
+            if (installer === undefined)
+                return undefined;
+            return (await installer.listBundles()).filter(bundle => bundle.installed).map(bundle => ({
+                name: bundle.name, ...(bundle.version === undefined ? {} : { version: bundle.version }), enabled: bundle.enabled, removable: bundle.removable,
+            }));
+        },
+    };
+    return hub;
+}
+//# sourceMappingURL=hub.js.map

package/dist/hub.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { InvalidPluginNameError, parsePluginName, pluginNameOf, storeDirectoryOf, type PluginName } from './name.js';
+export { bumpVersion, compareVersions, newestVersion, parseVersion, type Version, type VersionBump } from './version.js';
+export { formatPluginSource, InvalidPluginSourceError, parsePluginSource, type PluginSource } from './source.js';
+export { integrityOf, readTarball, writeTarball, type TarballFile } from './tarball.js';
+export { bundleProblem, manifestOfTarball, packageFiles, packFolder, PackError, type PackedPlugin } from './pack.js';
+export { PluginStore, StoreConflictError, type StoredVersion, type StoreRecord } from './store.js';
+export { currentSourcePath, HOME_PLUGINS_FOLDER, homePluginsDir, moveFolder, PROJECT_PLUGINS_FOLDER, projectPluginsDir, STORE_FOLDER, storeRootOf, type FolderMove, type MoveReporter } from './folders.js';
+export { savePlugin, type SavedPlugin } from './save.js';
+export { pullPlugin, PullError, type PulledPlugin, type PullOptions, type PullPorts, type RegistryPort, type ReleaseInfo, type ReleasePort } from './pull.js';
+export { githubReleasesOverHttps, httpsDownload, npmRegistryOverHttps, type Fetch } from './http.js';
+export { createPluginHub, findSourceFolder, missingHostServices, type HubPorts, type InstalledPlugin, type InstallerPort, type InstallOutcome, type PluginHub, type PullResult, type PullStatus, type SaveResult, type UpdateResult } from './hub.js';
+export { checkContractShape, clientInjectFromSource, hostEntryOf, hostInjectFromSource, providedServices, readServiceContract, slotsInSource, syncServiceContract, type ServiceContract, type Side, type SideLists } from './contract.js';
+export { PLUGIN_LABELS, type PluginKind, sharePlugin, type PublishGitPort, type RepositoryHostPort, type ShareOptions, type ShareResult, type Visibility } from './share.js';
+export { firstReleasePort, gitCli, githubCli, githubReleasesViaGh, ToolError } from './github-cli.js';
+export { NPM_REGISTRY, publishToNpm, type NpmPublishOptions, type NpmPublishPort, type NpmPublishResult } from './npm-publish.js';
+export { firstRegistryPort, npmCli, npmRegistryViaCli } from './npm-cli.js';
+//# 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":"AAGA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AACpH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AACxH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AACvF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACpH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAClG,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3M,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAC7J,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,oBAAoB,EAAE,KAAK,KAAK,EAAE,MAAM,WAAW,CAAA;AACpG,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAA;AACrP,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AACzO,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAC5K,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjI,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+// @webboxes/plugin-hub: saving, sharing and pulling Cordis plugins, host-independent (spec 044 lifecycle.md, "Built to be extracted into
+// ACRYL Blends", layer 1). The Cordis service that offers these to an app, and its faces, live in the app; this package has no Cordis, DSH or
+// surface dependency, so the engine, a catalog's CI and other runtimes can use it.
+export { InvalidPluginNameError, parsePluginName, pluginNameOf, storeDirectoryOf } from './name.js';
+export { bumpVersion, compareVersions, newestVersion, parseVersion } from './version.js';
+export { formatPluginSource, InvalidPluginSourceError, parsePluginSource } from './source.js';
+export { integrityOf, readTarball, writeTarball } from './tarball.js';
+export { bundleProblem, manifestOfTarball, packageFiles, packFolder, PackError } from './pack.js';
+export { PluginStore, StoreConflictError } from './store.js';
+export { currentSourcePath, HOME_PLUGINS_FOLDER, homePluginsDir, moveFolder, PROJECT_PLUGINS_FOLDER, projectPluginsDir, STORE_FOLDER, storeRootOf } from './folders.js';
+export { savePlugin } from './save.js';
+export { pullPlugin, PullError } from './pull.js';
+export { githubReleasesOverHttps, httpsDownload, npmRegistryOverHttps } from './http.js';
+export { createPluginHub, findSourceFolder, missingHostServices } from './hub.js';
+export { checkContractShape, clientInjectFromSource, hostEntryOf, hostInjectFromSource, providedServices, readServiceContract, slotsInSource, syncServiceContract } from './contract.js';
+export { PLUGIN_LABELS, sharePlugin } from './share.js';
+export { firstReleasePort, gitCli, githubCli, githubReleasesViaGh, ToolError } from './github-cli.js';
+export { NPM_REGISTRY, publishToNpm } from './npm-publish.js';
+export { firstRegistryPort, npmCli, npmRegistryViaCli } from './npm-cli.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":"AAAA,yIAAyI;AACzI,8IAA8I;AAC9I,mFAAmF;AACnF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAmB,MAAM,WAAW,CAAA;AACpH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAkC,MAAM,cAAc,CAAA;AACxH,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,iBAAiB,EAAqB,MAAM,aAAa,CAAA;AAChH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAoB,MAAM,cAAc,CAAA;AACvF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAqB,MAAM,WAAW,CAAA;AACpH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAwC,MAAM,YAAY,CAAA;AAClG,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAsC,MAAM,cAAc,CAAA;AAC3M,OAAO,EAAE,UAAU,EAAoB,MAAM,WAAW,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,SAAS,EAA8G,MAAM,WAAW,CAAA;AAC7J,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,oBAAoB,EAAc,MAAM,WAAW,CAAA;AACpG,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAsK,MAAM,UAAU,CAAA;AACrP,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,mBAAmB,EAAmD,MAAM,eAAe,CAAA;AACzO,OAAO,EAAE,aAAa,EAAmB,WAAW,EAAsG,MAAM,YAAY,CAAA;AAC5K,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAsE,MAAM,kBAAkB,CAAA;AACjI,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA"}