@appsemble/cli 0.23.5 → 0.23.7

package/README.md

@@ -1,9 +1,9 @@
-# ![](https://gitlab.com/appsemble/appsemble/-/raw/0.23.5/config/assets/logo.svg) Appsemble CLI
+# ![](https://gitlab.com/appsemble/appsemble/-/raw/0.23.7/config/assets/logo.svg) Appsemble CLI
 
 > Manage apps and blocks from the command line.
 
 [![npm](https://img.shields.io/npm/v/@appsemble/cli)](https://www.npmjs.com/package/@appsemble/cli)
-[![GitLab CI](https://gitlab.com/appsemble/appsemble/badges/0.23.5/pipeline.svg)](https://gitlab.com/appsemble/appsemble/-/releases/0.23.5)
+[![GitLab CI](https://gitlab.com/appsemble/appsemble/badges/0.23.7/pipeline.svg)](https://gitlab.com/appsemble/appsemble/-/releases/0.23.7)
 [![Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://prettier.io)
 
 ## Table of Contents
@@ -304,5 +304,5 @@ appsemble run-cronjobs --interval 30
 
 ## License
 
-[LGPL-3.0-only](https://gitlab.com/appsemble/appsemble/-/blob/0.23.5/LICENSE.md) ©
+[LGPL-3.0-only](https://gitlab.com/appsemble/appsemble/-/blob/0.23.7/LICENSE.md) ©
 [Appsemble](https://appsemble.com)

package/commands/block/build.js

@@ -1,7 +1,8 @@
 import { logger } from '@appsemble/node-utils';
 import fg from 'fast-glob';
 import normalizePath from 'normalize-path';
-import { buildBlock, getBlockConfig } from '../../lib/block.js';
+import { getProjectBuildConfig } from '../../lib/config.js';
+import { buildProject } from '../../lib/project.js';
 export const command = 'build <paths...>';
 export const description = 'Build a block without publishing.';
 export function builder(yargs) {
@@ -15,8 +16,8 @@ export async function handler({ paths }) {
     logger.info(`Building ${directories.length} Blocks`);
     for (const dir of directories) {
         logger.info('');
-        const config = await getBlockConfig(dir);
-        await buildBlock(config);
+        const buildConfig = await getProjectBuildConfig(dir);
+        await buildProject(buildConfig);
     }
 }
 //# sourceMappingURL=build.js.map

package/commands/block/extract-messages.js

@@ -1,7 +1,8 @@
 import { logger } from '@appsemble/node-utils';
 import fg from 'fast-glob';
 import normalizePath from 'normalize-path';
-import { getBlockConfig, processBlockMessages } from '../../lib/block.js';
+import { processBlockMessages } from '../../lib/block.js';
+import { getProjectBuildConfig } from '../../lib/config.js';
 export const command = 'extract-messages <paths...>';
 export const description = 'Extract messages from a block.';
 export function builder(yargs) {
@@ -22,9 +23,9 @@ export async function handler({ languages, paths }) {
     logger.info(`Extracting messages from ${directories.length} Blocks`);
     for (const dir of directories) {
         logger.info('');
-        const config = await getBlockConfig(dir);
-        logger.info(`Processing ${config.name}`);
-        await processBlockMessages(config, langs);
+        const buildConfig = await getProjectBuildConfig(dir);
+        logger.info(`Processing ${buildConfig.name}`);
+        await processBlockMessages(buildConfig, langs);
     }
 }
 //# sourceMappingURL=extract-messages.js.map

package/commands/block/publish.js

@@ -1,7 +1,9 @@
 import { authenticate, logger } from '@appsemble/node-utils';
 import fg from 'fast-glob';
 import normalizePath from 'normalize-path';
-import { buildBlock, getBlockConfig, publishBlock } from '../../lib/block.js';
+import { buildBlock } from '../../lib/block.js';
+import { getProjectBuildConfig } from '../../lib/config.js';
+import { publishProject } from '../../lib/project.js';
 export const command = 'publish <paths...>';
 export const description = 'Publish a block.';
 export function builder(yargs) {
@@ -27,11 +29,11 @@ export async function handler({ build, clientCredentials, ignoreConflict, paths,
     logger.info(`Publishing ${directories.length} Blocks`);
     for (const dir of directories) {
         logger.info('');
-        const config = await getBlockConfig(dir);
+        const buildConfig = await getProjectBuildConfig(dir);
         if (build) {
-            await buildBlock(config);
+            await buildBlock(buildConfig);
         }
-        await publishBlock(config, ignoreConflict);
+        await publishProject(buildConfig, '/api/blocks', ignoreConflict);
     }
 }
 //# sourceMappingURL=publish.js.map

package/commands/serve.js

@@ -10,9 +10,10 @@ import csvToJson from 'csvtojson';
 import FormData from 'form-data';
 import globalCacheDir from 'global-cache-dir';
 import { traverseAppDirectory } from '../lib/app.js';
-import { buildBlock, getBlockConfig, makePayload } from '../lib/block.js';
+import { buildBlock } from '../lib/block.js';
+import { getProjectBuildConfig, getProjectWebpackConfig } from '../lib/config.js';
 import { createApiServer, createStaticServer } from '../lib/createServers.js';
-import { loadWebpackConfig } from '../lib/loadWebpackConfig.js';
+import { makeProjectPayload } from '../lib/project.js';
 import { setArgv } from '../server/argv.js';
 import { setAppName } from '../server/db/methods.js';
 import { Resource } from '../server/models/Resource.js';
@@ -109,17 +110,19 @@ export async function handler(argv) {
     }
     const localBlocksConfigs = await Promise.all(localIdentifiableBlocks.map(async (identifiableBlock) => {
         const [organization, blockName] = parseBlockName(identifiableBlock.type);
-        const blockConfig = await getBlockConfig(join(process.cwd(), 'blocks', blockName));
+        const buildConfig = await getProjectBuildConfig(join(process.cwd(), 'blocks', blockName));
         return {
-            ...blockConfig,
+            ...buildConfig,
             OrganizationId: organization,
         };
     }));
     const localBlocksPromises = localBlocksConfigs.map(async (blockConfig) => {
         await buildBlock(blockConfig);
-        const [, blockManifest] = await makePayload(blockConfig);
-        blockManifest.version = localIdentifiableBlocks.find((identifiableBlock) => identifiableBlock.type === blockManifest.name).version;
-        return blockManifest;
+        const [, blockImplementations] = await makeProjectPayload(blockConfig);
+        return {
+            ...blockImplementations,
+            ...blockConfig,
+        };
     });
     const cacheDir = await globalCacheDir('appsemble');
     const remoteBlocksPromises = remoteIdentifiableBlocks.map(async (identifiableBlock) => {
@@ -156,7 +159,7 @@ export async function handler(argv) {
     const localBlocks = await Promise.all(localBlocksPromises);
     const remoteBlocks = await Promise.all(remoteBlocksPromises);
     const appBlocks = [...localBlocks, ...remoteBlocks];
-    const webpackConfigs = await Promise.all(localBlocksConfigs.map((blockConfig) => loadWebpackConfig(blockConfig, 'development', join(blockConfig.dir, blockConfig.output))));
+    const webpackConfigs = await Promise.all(localBlocksConfigs.map((blockConfig) => getProjectWebpackConfig(blockConfig, 'development', join(blockConfig.dir, blockConfig.output))));
     // Get app messages
     const appMessages = [];
     await opendirSafe(join(appPath, 'i18n'), async (path) => {

package/commands/start.js

@@ -1,5 +1,4 @@
-import { discoverBlocks } from '../lib/block.js';
-import { loadWebpackConfig } from '../lib/loadWebpackConfig.js';
+import { getProjectsBuildConfigs, getProjectWebpackConfig } from '../lib/config.js';
 import { serverImport } from '../lib/serverImport.js';
 export const command = 'start';
 export const description = 'Start the Appsemble development server.';
@@ -126,8 +125,8 @@ export function builder(yargs) {
 export async function handler(argv) {
     const { setArgv, start } = await serverImport('setArgv', 'start');
     setArgv(argv);
-    const blocks = await discoverBlocks(process.cwd());
-    const webpackConfigs = await Promise.all(blocks.map((block) => loadWebpackConfig(block, 'development')));
+    const projectsBuildConfigs = await getProjectsBuildConfigs(process.cwd());
+    const webpackConfigs = await Promise.all(projectsBuildConfigs.map((projectBuildConfig) => getProjectWebpackConfig(projectBuildConfig, 'development')));
     return start({ webpackConfigs });
 }
 //# sourceMappingURL=start.js.map

package/lib/app.js

@@ -8,8 +8,10 @@ import axios from 'axios';
 import FormData from 'form-data';
 import { traverseBlockThemes } from './block.js';
 import { coerceRemote } from './coercers.js';
+import { getProjectBuildConfig } from './config.js';
 import { printAxiosError } from './output.js';
 import { processCss } from './processCss.js';
+import { buildProject, makeProjectPayload } from './project.js';
 import { publishResource } from './resource.js';
 /**
  * Traverses an app directory and appends the files it finds to the given FormData object.
@@ -25,6 +27,11 @@ export async function traverseAppDirectory(path, context, formData) {
     let iconPath;
     let maskableIconPath;
     let yaml;
+    let controllerPath;
+    let controllerBuildConfig;
+    let controllerBuildResult;
+    let controllerCode;
+    let controllerImplementations;
     const gatheredData = {
         screenshotUrls: [],
     };
@@ -89,6 +96,17 @@ export async function traverseAppDirectory(path, context, formData) {
                     formData.append(`${name}Style`, css);
                     gatheredData[`${name}Style`] = css;
                 });
+            case 'controller':
+                controllerPath = join(path, 'controller');
+                controllerBuildConfig = await getProjectBuildConfig(controllerPath);
+                controllerBuildResult = await buildProject(controllerBuildConfig);
+                controllerCode = controllerBuildResult.outputFiles[0].text;
+                formData.append('controllerCode', controllerCode);
+                gatheredData.controllerCode = controllerCode;
+                [, controllerImplementations] = await makeProjectPayload(controllerBuildConfig);
+                formData.append('controllerImplementations', JSON.stringify(controllerImplementations));
+                gatheredData.controllerImplementations = controllerImplementations;
+                break;
             default:
                 logger.warn(`Found unused file ${filepath}`);
         }
@@ -461,7 +479,11 @@ export async function publishApp({ clientCredentials, context, dryRun, modifyCon
         logger.info('Using Google Analytics');
         formData.append('googleAnalyticsID', googleAnalyticsId);
     }
-    await authenticate(remote, resources ? 'apps:write resources:write' : 'apps:write', clientCredentials);
+    let authScope = 'apps:write';
+    if (resources) {
+        authScope += ' resources:write';
+    }
+    await authenticate(remote, authScope, clientCredentials);
     let data;
     try {
         ({ data } = await axios.post('/api/apps', formData, {

package/lib/block.d.ts

@@ -1,5 +1,4 @@
-import { type BlockConfig, type BlockManifest } from '@appsemble/types';
-import FormData from 'form-data';
+import { type ProjectBuildConfig } from '@appsemble/types';
 import { type Stats } from 'webpack';
 /**
  * Builds a block using Webpack.
@@ -7,44 +6,20 @@ import { type Stats } from 'webpack';
  * @param config The config of the block to build.
  * @returns The Webpack stats object.
  */
+/**
+ * Builds a block using Webpack.
+ *
+ * @param buildConfig The config of the block to build.
+ * @returns The Webpack stats object.
+ */
+export declare function buildBlock(buildConfig: ProjectBuildConfig): Promise<Stats>;
 interface DeleteBlockVersionParams {
     organization: string;
     blockName: string;
     blockVersion: string;
     remote: string;
 }
-export declare function buildBlock(config: BlockConfig): Promise<Stats>;
 export declare function deleteBlock({ blockName, blockVersion, organization, remote, }: DeleteBlockVersionParams): Promise<void>;
-/**
- * Get the block configuration from a block directory.
- *
- * @param dir The directory in which to search for the configuration file.
- * @returns The block configuration.
- */
-export declare function getBlockConfig(dir: string): Promise<BlockConfig>;
-/**
- * Discover Appsemble blocks based on workspaces in a monorepo.
- *
- * npm workspaces are supported.
- *
- * @param root The project root in which to find workspaces.
- * @returns Discovered Appsemble blocks.
- */
-export declare function discoverBlocks(root: string): Promise<BlockConfig[]>;
-/**
- * Configure the payload for a new block version upload.
- *
- * @param config The block configuration
- * @returns The payload that should be sent to the version endpoint.
- */
-export declare function makePayload(config: BlockConfig): Promise<[FormData, BlockManifest]>;
-/**
- * Publish a new block version.
- *
- * @param config The block configuration
- * @param ignoreConflict Prevent the command from crashing when a conflict has been detected.
- */
-export declare function publishBlock(config: BlockConfig, ignoreConflict: boolean): Promise<void>;
 /**
  * Uploads an app block theme
  *
@@ -65,5 +40,5 @@ export declare function uploadAppBlockTheme(filePath: string, organization: stri
  * @param force Force update the theme if the app is locked.
  */
 export declare function traverseBlockThemes(path: string, appId: number, remote: string, force: boolean): Promise<void>;
-export declare function processBlockMessages(config: BlockConfig, languages: string[]): Promise<void>;
+export declare function processBlockMessages(buildConfig: ProjectBuildConfig, languages: string[]): Promise<void>;
 export {};

package/lib/block.js

@@ -1,24 +1,31 @@
-import { createReadStream, existsSync } from 'node:fs';
-import { mkdir, readdir, readFile, rm } from 'node:fs/promises';
-import { basename, extname, join, relative, resolve as resolvePath } from 'node:path';
-import { inspect } from 'node:util';
-import { AppsembleError, getWorkspaces, logger, opendirSafe, readData, writeData, } from '@appsemble/node-utils';
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, rm } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { AppsembleError, logger, opendirSafe, readData, writeData } from '@appsemble/node-utils';
 import { compareStrings } from '@appsemble/utils';
 import axios from 'axios';
-import chalk from 'chalk';
-import { cosmiconfig } from 'cosmiconfig';
-import FormData from 'form-data';
 import webpack from 'webpack';
-import { getBlockConfigFromTypeScript } from './getBlockConfigFromTypeScript.js';
-import { loadWebpackConfig } from './loadWebpackConfig.js';
+import { getProjectImplementations, getProjectWebpackConfig } from './config.js';
 import { processCss } from './processCss.js';
-export async function buildBlock(config) {
-    const conf = await loadWebpackConfig(config, 'production', join(config.dir, config.output));
+/**
+ * Builds a block using Webpack.
+ *
+ * @param config The config of the block to build.
+ * @returns The Webpack stats object.
+ */
+/**
+ * Builds a block using Webpack.
+ *
+ * @param buildConfig The config of the block to build.
+ * @returns The Webpack stats object.
+ */
+export async function buildBlock(buildConfig) {
+    const conf = await getProjectWebpackConfig(buildConfig, 'production', join(buildConfig.dir, buildConfig.output));
     if (existsSync(conf.output.path)) {
         logger.warn(`Removing ${conf.output.path}`);
         await rm(conf.output.path, { force: true, recursive: true });
     }
-    logger.info(`Building ${config.name}@${config.version} 🔨`);
+    logger.info(`Building ${buildConfig.name}@${buildConfig.version} 🔨`);
     const compiler = webpack(conf);
     return new Promise((resolve, reject) => {
         compiler.run((err, stats) => {
@@ -41,183 +48,6 @@ export async function deleteBlock({ blockName, blockVersion, organization, remot
     });
     logger.info(`Successfully deleted ${blockName} block version.`);
 }
-/**
- * Get the block configuration from a block directory.
- *
- * @param dir The directory in which to search for the configuration file.
- * @returns The block configuration.
- */
-export async function getBlockConfig(dir) {
-    const explorer = cosmiconfig('appsemble', { stopDir: dir });
-    const found = await explorer.search(dir);
-    if (!found) {
-        throw new AppsembleError(`No Appsemble configuration file found searching ${dir}`);
-    }
-    const { config, filepath } = found;
-    logger.info(`Found configuration file: ${filepath}`);
-    const [pkg] = await readData(join(dir, 'package.json'));
-    if (!pkg.private) {
-        logger.warn(`It is ${chalk.underline.yellow('highly recommended')} to set “${chalk.green('"private"')}: ${chalk.cyan('true')}” in package.json`);
-    }
-    let longDescription;
-    if (existsSync(join(dir, 'README.md'))) {
-        longDescription = await readFile(join(dir, 'README.md'), 'utf8');
-    }
-    const result = {
-        description: pkg.description,
-        longDescription,
-        name: pkg.name,
-        version: pkg.version,
-        webpack: undefined,
-        ...config,
-        dir,
-    };
-    logger.verbose(`Resolved block configuration: ${inspect(result, { colors: true })}`);
-    return result;
-}
-/**
- * Discover Appsemble blocks based on workspaces in a monorepo.
- *
- * npm workspaces are supported.
- *
- * @param root The project root in which to find workspaces.
- * @returns Discovered Appsemble blocks.
- */
-export async function discoverBlocks(root) {
-    const dirs = await getWorkspaces(root);
-    const manifests = await Promise.all(dirs
-        .concat(root)
-        .map((path) => getBlockConfig(path))
-        // Ignore non-block workspaces.
-        .map((p) => p.catch(() => null)));
-    return manifests.filter(Boolean);
-}
-/**
- * Configure the payload for a new block version upload.
- *
- * @param config The block configuration
- * @returns The payload that should be sent to the version endpoint.
- */
-export async function makePayload(config) {
-    const { dir, output } = config;
-    const distPath = resolvePath(dir, output);
-    const form = new FormData();
-    const gatheredData = {};
-    const { description, layout, longDescription, name, version, visibility } = config;
-    const { actions, events, messages, parameters } = getBlockConfigFromTypeScript(config);
-    const files = await readdir(dir);
-    const icon = files.find((entry) => entry.match(/^icon\.(png|svg)$/));
-    function append(field, value) {
-        if (value) {
-            const serialized = typeof value === 'string' ? value : JSON.stringify(value);
-            logger.verbose(`Using ${field}: ${inspect(value, { colors: true, depth: 20 })}`);
-            form.append(field, serialized);
-        }
-        else {
-            logger.silly(`Skipping parameter ${field}`);
-        }
-    }
-    append('actions', actions);
-    gatheredData.actions = actions;
-    append('description', description);
-    gatheredData.description = description;
-    append('longDescription', longDescription);
-    gatheredData.longDescription = longDescription;
-    append('events', events);
-    gatheredData.events = events;
-    append('layout', layout);
-    gatheredData.layout = layout;
-    if (visibility) {
-        append('visibility', visibility);
-        gatheredData.visibility = visibility;
-    }
-    append('name', name);
-    gatheredData.name = name;
-    append('parameters', parameters);
-    gatheredData.parameters = parameters;
-    append('version', version);
-    gatheredData.version = version;
-    if (icon) {
-        const iconPath = join(dir, icon);
-        logger.info(`Using icon: ${iconPath}`);
-        form.append('icon', createReadStream(iconPath));
-        gatheredData.iconUrl = basename(iconPath, extname(iconPath));
-    }
-    if (messages) {
-        if (!files.includes('i18n')) {
-            throw new AppsembleError('This block has messages defined, but the message files could not be found. Try running extract-messages');
-        }
-        const messageKeys = Object.keys(messages).sort(compareStrings);
-        const messagesResult = {};
-        const messagesPath = join(dir, 'i18n');
-        const translations = (await readdir(messagesPath)).map((language) => language.toLowerCase());
-        if (!translations.includes('en.json')) {
-            throw new AppsembleError('Could not find ‘en.json’. Try running extract-messages');
-        }
-        const duplicates = translations.filter((language, index) => translations.indexOf(language) !== index);
-        if (duplicates.length) {
-            throw new AppsembleError(`Found duplicate language codes: ‘${duplicates.join('’, ')}`);
-        }
-        for (const languageFile of translations.filter((t) => t.endsWith('.json'))) {
-            const language = basename(languageFile, '.json');
-            const languagePath = join(messagesPath, languageFile);
-            const [m] = await readData(languagePath);
-            const languageKeys = Object.keys(m).sort(compareStrings);
-            if (languageKeys.length !== messageKeys.length ||
-                languageKeys.some((key) => !messageKeys.includes(key))) {
-                throw new AppsembleError(`‘${languagePath}’ contains mismatching message keys. Try running extract-messages`);
-            }
-            logger.info(`Including ${language} translations from ‘${languagePath}’`);
-            messagesResult[language] = m;
-        }
-        form.append('messages', JSON.stringify(messagesResult));
-        gatheredData.messages = messagesResult;
-    }
-    if (files.includes('examples')) {
-        await opendirSafe(join(dir, 'examples'), async (file, stat) => {
-            if (!stat.isFile() || !file.endsWith('.yaml')) {
-                throw new AppsembleError(`Expected ${file} to be a YAML file`);
-            }
-            logger.info(`Adding example file ${file}`);
-            form.append('examples', await readFile(file, 'utf8'));
-            gatheredData.examples = [...(gatheredData.examples || []), basename(file, extname(file))];
-        }, { allowMissing: true });
-    }
-    await opendirSafe(distPath, (fullpath, stat) => {
-        if (!stat.isFile()) {
-            return;
-        }
-        const relativePath = relative(distPath, fullpath);
-        const realPath = relative(process.cwd(), fullpath);
-        logger.info(`Adding file: “${realPath}” as “${relativePath}”`);
-        form.append('files', createReadStream(fullpath), {
-            filename: encodeURIComponent(relativePath),
-        });
-        gatheredData.files = [...(gatheredData.files || []), relativePath];
-    }, { recursive: true });
-    return [form, gatheredData];
-}
-/**
- * Publish a new block version.
- *
- * @param config The block configuration
- * @param ignoreConflict Prevent the command from crashing when a conflict has been detected.
- */
-export async function publishBlock(config, ignoreConflict) {
-    logger.info(`Publishing ${config.name}@${config.version}…`);
-    const [form] = await makePayload(config);
-    try {
-        await axios.post('/api/blocks', form);
-        logger.info(`Successfully published ${config.name}@${config.version} 🎉`);
-    }
-    catch (err) {
-        if (ignoreConflict && axios.isAxiosError(err) && err.response.status === 409) {
-            logger.warn(`${config.name}@${config.version} was already published.`);
-            return;
-        }
-        throw err;
-    }
-}
 /**
  * Uploads an app block theme
  *
@@ -266,13 +96,13 @@ export async function traverseBlockThemes(path, appId, remote, force) {
         });
     }, { allowMissing: true });
 }
-export async function processBlockMessages(config, languages) {
-    const path = join(config.dir, 'i18n');
+export async function processBlockMessages(buildConfig, languages) {
+    const path = join(buildConfig.dir, 'i18n');
     await mkdir(path, { recursive: true });
     const dir = await readdir(path);
-    const { messages } = getBlockConfigFromTypeScript(config);
+    const { messages } = getProjectImplementations(buildConfig);
     if (!messages) {
-        logger.warn(`Block ${config.name} has no messages.`);
+        logger.warn(`Block ${buildConfig.name} has no messages.`);
         return;
     }
     const keys = Object.keys(messages).sort(compareStrings);
@@ -298,7 +128,7 @@ export async function processBlockMessages(config, languages) {
         await writeData(langPath, existingMessages);
         logger.info(`Wrote to file ‘${langPath}’`);
     }
-    logger.info(`Finished extracting messages for ${config.name}.`);
+    logger.info(`Finished extracting messages for ${buildConfig.name}.`);
     logger.info('');
 }
 //# sourceMappingURL=block.js.map

package/lib/block.test.js

@@ -1,18 +1,15 @@
 import { resolveFixture } from '@appsemble/node-utils';
 import concat from 'concat-stream';
 import { describe, expect, it } from 'vitest';
-import { makePayload } from './block.js';
-describe('makePayload', () => {
+import { makeProjectPayload } from './project.js';
+describe('makeProjectPayload', () => {
     it('should create a form-data payload', async () => {
-        const payload = await makePayload({
+        const payload = await makeProjectPayload({
             webpack: 'webpack.config',
             name: '@org/block',
             output: 'output',
             version: '1.2.3',
-            dir: resolveFixture('makePayload/no-icon'),
-            parameters: { type: 'object' },
-            actions: { onClick: {} },
-            events: { listen: { test: {} } },
+            dir: resolveFixture('makeProjectPayload/no-icon'),
         });
         const [formData] = payload;
         const boundary = formData.getBoundary();
@@ -34,7 +31,7 @@ Content-Disposition: form-data; name="name"\r
 --${boundary}\r
 Content-Disposition: form-data; name="parameters"\r
 \r
-{"type":"object"}\r
+{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"type":{"type":"object"}},"required":["type"],"additionalProperties":false}\r
 --${boundary}\r
 Content-Disposition: form-data; name="version"\r
 \r
@@ -49,15 +46,12 @@ export const string = 'no-icon';
 `);
     });
     it('should include an icon if one is present', async () => {
-        const payload = await makePayload({
+        const payload = await makeProjectPayload({
             webpack: 'webpack.config',
             name: '@org/block',
             output: 'output',
             version: '1.2.3',
-            dir: resolveFixture('makePayload/with-icon'),
-            parameters: {},
-            actions: {},
-            events: {},
+            dir: resolveFixture('makeProjectPayload/with-icon'),
         });
         const [formData] = payload;
         const boundary = formData.getBoundary();
@@ -67,11 +61,11 @@ export const string = 'no-icon';
         expect(String(buffer)).toBe(`--${boundary}\r
 Content-Disposition: form-data; name="actions"\r
 \r
-{}\r
+{"onClick":{}}\r
 --${boundary}\r
 Content-Disposition: form-data; name="events"\r
 \r
-{}\r
+{"listen":{"test":{}}}\r
 --${boundary}\r
 Content-Disposition: form-data; name="name"\r
 \r
@@ -79,7 +73,7 @@ Content-Disposition: form-data; name="name"\r
 --${boundary}\r
 Content-Disposition: form-data; name="parameters"\r
 \r
-{}\r
+{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"type":{"type":"object"}},"required":["type"],"additionalProperties":false}\r
 --${boundary}\r
 Content-Disposition: form-data; name="version"\r
 \r

package/lib/config.d.ts

@@ -0,0 +1,40 @@
+import { type ProjectBuildConfig, type ProjectImplementations } from '@appsemble/types';
+import { type Configuration } from 'webpack';
+/**
+ * Get the build configuration from a project directory.
+ *
+ * @param dir The directory in which to search for the configuration file.
+ * @returns The configuration.
+ */
+export declare function getProjectBuildConfig(dir: string): Promise<ProjectBuildConfig>;
+/**
+ * Discover Appsemble projects based on workspaces in a monorepo.
+ *
+ * Both Lerna and Yarn workspaces are supported.
+ *
+ * @param root The project root in which to find workspaces.
+ * @returns Discovered Appsemble projects.
+ */
+export declare function getProjectsBuildConfigs(root: string): Promise<ProjectBuildConfig[]>;
+/**
+ * Generate project implementations from the project metadata and TypeScript project.
+ *
+ * Uses the .appsemblerc file and the type definitions of the project.
+ *
+ * @param buildConfig The project build configuration
+ * @returns The project implementations from the TypeScript project.
+ */
+export declare function getProjectImplementations(buildConfig: ProjectBuildConfig): ProjectImplementations;
+/**
+ * Load a webpack configuration file.
+ *
+ * A webpack configuration file may export either an webpack configuration object, or a synchronous
+ * or asynchronous function which returns a webpack configuration object. This function supports
+ * all 3 use cases.
+ *
+ * @param buildConfig The project build config.
+ * @param mode The env that would be passed to webpack by invoking `webpack --env $env`.
+ * @param outputPath The path where the build will be output on disk.
+ * @returns The webpack configuration as exposed by the webpack configuration file.
+ */
+export declare function getProjectWebpackConfig(buildConfig: ProjectBuildConfig, mode?: 'development' | 'production', outputPath?: string): Promise<Configuration>;