piral-cli 1.5.0-beta.6684 → 1.5.0-beta.6685

package/src/common/piral.ts

@@ -0,0 +1,227 @@
+import { join } from 'path';
+import { runScript } from './scripts';
+import { removeDirectory } from './io';
+import { flattenExternals } from './package';
+import { log, logDone, logInfo, progress } from './log';
+import { createEmulatorSources, createEmulatorWebsite, packageEmulator } from './emulator';
+import { emulatorName, emulatorPackageName, emulatorSourcesName, emulatorWebsiteName, releaseName } from './constants';
+import { callPiralBuild } from '../bundler';
+import { LogLevels, SharedDependency } from '../types';
+
+async function runLifecycle(root: string, scripts: Record<string, string>, type: string) {
+  const script = scripts?.[type];
+
+  if (script) {
+    log('generalDebug_0003', `Running "${type}" ("${script}") ...`);
+    await runScript(script, root);
+    log('generalDebug_0003', `Finished running "${type}".`);
+  } else {
+    log('generalDebug_0003', `No script for "${type}" found ...`);
+  }
+}
+
+export interface BaseBuildPiralOptions {
+  root: string;
+  targetDir: string;
+  logLevel: LogLevels;
+  bundlerName: string;
+  externals: Array<SharedDependency>;
+  ignored: Array<string>;
+  outFile: string;
+  entryFiles: string;
+  optimizeModules: boolean;
+  sourceMaps: boolean;
+  watch: boolean;
+  contentHash: boolean;
+  piralInstances: Array<string>;
+  scripts?: Record<string, string>;
+  hooks?: {
+    beforeBuild?(e: any): Promise<void>;
+    afterBuild?(e: any): Promise<void>;
+    beforeEmulator?(e: any): Promise<void>;
+    afterEmulator?(e: any): Promise<void>;
+    beforePackage?(e: any): Promise<void>;
+    afterPackage?(e: any): Promise<void>;
+  };
+  _: Record<string, any>;
+}
+
+export interface BuildEmulatorOptions extends BaseBuildPiralOptions {
+  emulatorType: string;
+}
+
+export async function triggerBuildEmulator({
+  root,
+  logLevel,
+  externals,
+  emulatorType,
+  bundlerName,
+  optimizeModules,
+  sourceMaps,
+  watch,
+  ignored,
+  contentHash,
+  targetDir,
+  outFile,
+  scripts,
+  entryFiles,
+  piralInstances,
+  hooks,
+  _,
+}: BuildEmulatorOptions) {
+  progress('Starting emulator build ...');
+
+  const emulatorPublicUrl = '/';
+  const appDir = emulatorType !== emulatorWebsiteName ? join(targetDir, 'app') : targetDir;
+
+  // since we create this anyway let's just pretend we want to have it clean!
+  await removeDirectory(targetDir);
+
+  await hooks.beforeBuild?.({ root, publicUrl: emulatorPublicUrl, externals, entryFiles, targetDir, piralInstances });
+
+  logInfo(`Bundle ${emulatorName} ...`);
+
+  const {
+    dir: outDir,
+    name,
+    hash,
+  } = await callPiralBuild(
+    {
+      root,
+      piralInstances,
+      emulator: true,
+      standalone: false,
+      optimizeModules,
+      sourceMaps,
+      watch,
+      contentHash,
+      minify: false,
+      externals: flattenExternals(externals),
+      publicUrl: emulatorPublicUrl,
+      entryFiles,
+      logLevel,
+      ignored,
+      outDir: appDir,
+      outFile,
+      _,
+    },
+    bundlerName,
+  );
+
+  await hooks.afterBuild?.({
+    root,
+    publicUrl: emulatorPublicUrl,
+    externals,
+    entryFiles,
+    targetDir,
+    piralInstances,
+    hash,
+    outDir,
+    outFile: name,
+  });
+
+  await runLifecycle(root, scripts, 'piral:postbuild');
+  await runLifecycle(root, scripts, `piral:postbuild-${emulatorName}`);
+
+  await hooks.beforeEmulator?.({ root, externals, targetDir, outDir });
+
+  let rootDir = root;
+
+  switch (emulatorType) {
+    case emulatorPackageName:
+      rootDir = await createEmulatorSources(root, externals, outDir, outFile, logLevel);
+      await hooks.beforePackage?.({ root, externals, targetDir, outDir, rootDir });
+      await packageEmulator(rootDir);
+      await hooks.afterPackage?.({ root, externals, targetDir, outDir, rootDir });
+      break;
+    case emulatorSourcesName:
+      rootDir = await createEmulatorSources(root, externals, outDir, outFile, logLevel);
+      logDone(`Emulator package sources available in "${rootDir}".`);
+      break;
+    case emulatorWebsiteName:
+      rootDir = await createEmulatorWebsite(root, externals, outDir, outFile, logLevel);
+      logDone(`Emulator website available in "${rootDir}".`);
+      break;
+  }
+
+  await hooks.afterEmulator?.({ root, externals, targetDir, outDir, rootDir });
+}
+
+export interface BuildShellOptions extends BaseBuildPiralOptions {
+  minify: boolean;
+  publicUrl: string;
+}
+
+export async function triggerBuildShell({
+  root,
+  targetDir,
+  bundlerName,
+  minify,
+  optimizeModules,
+  entryFiles,
+  piralInstances,
+  sourceMaps,
+  logLevel,
+  ignored,
+  watch,
+  outFile,
+  publicUrl,
+  contentHash,
+  externals,
+  hooks,
+  scripts,
+  _,
+}: BuildShellOptions) {
+  progress('Starting release build ...');
+
+  // since we create this anyway let's just pretend we want to have it clean!
+  await removeDirectory(targetDir);
+
+  logInfo(`Bundle ${releaseName} ...`);
+
+  await hooks.beforeBuild?.({ root, publicUrl, externals, entryFiles, targetDir, piralInstances });
+
+  const {
+    dir: outDir,
+    name,
+    hash,
+  } = await callPiralBuild(
+    {
+      root,
+      piralInstances,
+      emulator: false,
+      standalone: false,
+      optimizeModules,
+      sourceMaps,
+      watch,
+      contentHash,
+      minify,
+      externals: flattenExternals(externals),
+      publicUrl,
+      outFile,
+      outDir: targetDir,
+      entryFiles,
+      logLevel,
+      ignored,
+      _,
+    },
+    bundlerName,
+  );
+
+  await hooks.afterBuild?.({
+    root,
+    publicUrl,
+    externals,
+    entryFiles,
+    targetDir,
+    piralInstances,
+    outDir,
+    outFile: name,
+    hash,
+  });
+
+  await runLifecycle(root, scripts, 'piral:postbuild');
+  await runLifecycle(root, scripts, `piral:postbuild-${releaseName}`);
+
+  logDone(`Files for publication available in "${outDir}".`);
+}

package/src/common/release.ts

@@ -0,0 +1,62 @@
+import { basename, dirname, relative, resolve } from 'path';
+import { fail, log } from './log';
+import { publishNpmPackage } from './npm';
+import { FormDataObj, postForm } from './http';
+import { checkExists, matchFiles, readBinary } from './io';
+import { PublishScheme } from '../types';
+
+export async function publishPackageEmulator(
+  baseDir: string,
+  source: string,
+  args: Record<string, string> = {},
+  interactive = false,
+) {
+  const type = 'emulator';
+  const directory = resolve(baseDir, source, type);
+  const exists = await checkExists(directory);
+
+  if (!exists) {
+    fail('publishDirectoryMissing_0110', directory);
+  }
+
+  const files = await matchFiles(directory, '*.tgz');
+  log('generalDebug_0003', `Found ${files.length} in "${directory}": ${files.join(', ')}`);
+
+  if (files.length !== 1) {
+    fail('publishEmulatorFilesUnexpected_0111', directory);
+  }
+
+  const [file] = files;
+  const flags = Object.keys(args).reduce((p, c) => {
+    p.push(`--${c}`, args[c]);
+    return p;
+  }, [] as Array<string>);
+
+  await publishNpmPackage(directory, file, flags, interactive);
+}
+
+export async function publishWebsiteEmulator(
+  version: string,
+  url: string,
+  apiKey: string,
+  mode: PublishScheme,
+  directory: string,
+  files: Array<string>,
+  interactive: boolean,
+  headers?: Record<string, string>,
+  ca?: Buffer,
+) {
+  const data: FormDataObj = {
+    version,
+    type: 'custom',
+  };
+
+  for (const file of files) {
+    const relPath = relative(directory, file);
+    const fileName = basename(file);
+    const content = await readBinary(dirname(file), fileName);
+    data[relPath] = [content, fileName];
+  }
+
+  return await postForm(url, mode, apiKey, data, headers, ca, interactive);
+}

package/src/helpers.ts

@@ -7,12 +7,12 @@ import type {
   PiletPublishSource,
   PiralBuildType,
   PiletBuildType,
-  PiletPublishScheme,
+  PublishScheme,
   SourceLanguage,
 } from './types';
 
 export const schemaKeys: Array<PiletSchemaVersion> = ['v0', 'v1', 'v2', 'v3', 'mf', 'none'];
-export const publishModeKeys: Array<PiletPublishScheme> = ['none', 'basic', 'bearer', 'digest'];
+export const publishModeKeys: Array<PublishScheme> = ['none', 'basic', 'bearer', 'digest'];
 export const fromKeys: Array<PiletPublishSource> = ['local', 'remote', 'npm'];
 export const piralBuildTypeKeys: Array<PiralBuildType> = [
   'all',

package/src/messages.ts

@@ -2585,6 +2585,28 @@ export function requiredEmulatorAssetDownloadSkipped_0123(url: string): QuickMes
   return [LogLevels.warning, '0123', `Could not download asset file at "${url}".`];
 }
 
+/**
+ * @kind Error
+ *
+ * @summary
+ * The emulator.json and associated files could not be found in the source directory.
+ *
+ * @abstract
+ * Only an emulator website can be published using `piral publish`. Other artifacts such as
+ * standard release artifacts or the package emulator (tgz) need to be published using other
+ * mechanisms such as `npm publish`.
+ * 
+ * If no emulator website exists you can either build one using the `--fresh` flag with
+ * `piral publish` (i.e., `piral publish --fresh`) or preparing the build using `piral build`
+ * with the `--type emulator-website` flag.
+ *
+ * @see
+ * - [Emulator](https://docs.piral.io/concepts/T01-emulator)
+ */
+export function missingEmulatorWebsite_0130(path: string): QuickMessage {
+  return [LogLevels.error, '0130', `Could not find the files for an emulator website at "${path}".`];
+}
+
 /**
  * @kind Warning
  *

package/src/types/public.ts

@@ -1,5 +1,5 @@
 import { Argv, Arguments } from 'yargs';
-import { RuleRunner, PiletRuleContext, PiralRuleContext, LogLevels, SharedDependency, ReleaseProvider } from './common';
+import { RuleRunner, PiletRuleContext, PiralRuleContext, LogLevels, SharedDependency } from './common';
 
 export interface ToolCommandRunner<U = {}> {
   (args: Arguments<U>): void | Promise<void>;
@@ -44,7 +44,6 @@ export interface CliPluginApi {
   withPiletRule(ruleName: string, runner: RuleRunner<PiletRuleContext>): CliPluginApi;
   withPatcher(packageName: string, patch: PackagePatcher): CliPluginApi;
   withBundler(bundlerName: string, bundler: BundlerDefinition): CliPluginApi;
-  withReleaseProvider(providerName: string, provider: ReleaseProvider): CliPluginApi;
 }
 
 export interface CliPlugin {
@@ -242,7 +241,7 @@ export type AuthConfig = HeaderAuthConfig | HttpAuthConfig;
 
 export type SourceLanguage = 'js' | 'ts';
 
-export type PiletPublishScheme = 'none' | 'digest' | 'bearer' | 'basic';
+export type PublishScheme = 'none' | 'digest' | 'bearer' | 'basic';
 
 export type PiletPublishSource = 'local' | 'npm' | 'remote';
 

package/lib/release.d.ts

@@ -1,7 +0,0 @@
-import { ReleaseProvider } from './types';
-export interface QualifiedReleaseProvider {
-    name: string;
-    action: ReleaseProvider;
-}
-export declare function setReleaseProvider(provider: QualifiedReleaseProvider): void;
-export declare function publishArtifacts(providerName: string, directory: string, files: Array<string>, args: Record<string, string>, interactive: boolean): Promise<void>;

package/lib/release.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.publishArtifacts = exports.setReleaseProvider = void 0;
-const path_1 = require("path");
-const common_1 = require("./common");
-const helpers_1 = require("./helpers");
-async function getVersion(directory) {
-    const data = await (0, common_1.findFile)(directory, 'package.json');
-    if (!data) {
-        (0, common_1.fail)('packageJsonNotFound_0020');
-    }
-    const { version } = require(data);
-    return version;
-}
-const providers = {
-    none() {
-        return Promise.resolve();
-    },
-    async xcopy(_, files, args) {
-        const { target } = args;
-        if (!target) {
-            (0, common_1.fail)('publishXcopyMissingTarget_0112');
-        }
-        await Promise.all(files.map(async (file) => (0, common_1.copy)(file, (0, path_1.resolve)(target, (0, path_1.basename)(file)))));
-    },
-    async feed(directory, files, args, interactive) {
-        const { url, apiKey, scheme = 'basic', version = await getVersion(directory) } = args;
-        if (!url) {
-            (0, common_1.fail)('publishFeedMissingUrl_0115');
-        }
-        if (!version) {
-            (0, common_1.fail)('publishFeedMissingVersion_0116');
-        }
-        const data = {
-            version,
-            type: 'custom',
-        };
-        for (const file of files) {
-            const relPath = (0, path_1.relative)(directory, file);
-            const fileName = (0, path_1.basename)(file);
-            const content = await (0, common_1.readBinary)((0, path_1.dirname)(file), fileName);
-            data[relPath] = [content, fileName];
-        }
-        await (0, common_1.postForm)(url, scheme, apiKey, data, {}, undefined, interactive);
-    },
-};
-function findReleaseProvider(providerName) {
-    const provider = providers[providerName];
-    if (typeof provider !== 'function') {
-        (0, common_1.fail)('publishProviderMissing_0113', providerName, helpers_1.availableReleaseProviders);
-    }
-    return provider;
-}
-helpers_1.availableReleaseProviders.push(...Object.keys(providers));
-function setReleaseProvider(provider) {
-    providers[provider.name] = provider.action;
-    if (!helpers_1.availableReleaseProviders.includes(provider.name)) {
-        helpers_1.availableReleaseProviders.push(provider.name);
-    }
-}
-exports.setReleaseProvider = setReleaseProvider;
-function publishArtifacts(providerName, directory, files, args, interactive) {
-    const runRelease = findReleaseProvider(providerName);
-    return runRelease(directory, files, args, interactive);
-}
-exports.publishArtifacts = publishArtifacts;
-//# sourceMappingURL=release.js.map

package/lib/release.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"release.js","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":";;;AAAA,+BAA4D;AAC5D,qCAAmF;AACnF,uCAAsD;AAGtD,KAAK,UAAU,UAAU,CAAC,SAAiB;IACzC,MAAM,IAAI,GAAG,MAAM,IAAA,iBAAQ,EAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEvD,IAAI,CAAC,IAAI,EAAE;QACT,IAAA,aAAI,EAAC,0BAA0B,CAAC,CAAC;KAClC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAOD,MAAM,SAAS,GAAoC;IACjD,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI;QACxB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC,MAAM,EAAE;YACX,IAAA,aAAI,EAAC,gCAAgC,CAAC,CAAC;SACxC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,aAAI,EAAC,IAAI,EAAE,IAAA,cAAO,EAAC,MAAM,EAAE,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW;QAC5C,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;QAEtF,IAAI,CAAC,GAAG,EAAE;YACR,IAAA,aAAI,EAAC,4BAA4B,CAAC,CAAC;SACpC;QAED,IAAI,CAAC,OAAO,EAAE;YACZ,IAAA,aAAI,EAAC,gCAAgC,CAAC,CAAC;SACxC;QAED,MAAM,IAAI,GAAgB;YACxB,OAAO;YACP,IAAI,EAAE,QAAQ;SACf,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACxB,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAU,EAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;SACrC;QAED,MAAM,IAAA,iBAAQ,EAAC,GAAG,EAAE,MAAa,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;CACF,CAAC;AAEF,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IAEzC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;QAClC,IAAA,aAAI,EAAC,6BAA6B,EAAE,YAAY,EAAE,mCAAyB,CAAC,CAAC;KAC9E;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,mCAAyB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAE1D,SAAgB,kBAAkB,CAAC,QAAkC;IACnE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE3C,IAAI,CAAC,mCAAyB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACtD,mCAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;KAC/C;AACH,CAAC;AAND,gDAMC;AAED,SAAgB,gBAAgB,CAC9B,YAAoB,EACpB,SAAiB,EACjB,KAAoB,EACpB,IAA4B,EAC5B,WAAoB;IAEpB,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC;AATD,4CASC"}

package/src/release.ts

@@ -1,91 +0,0 @@
-import { basename, dirname, relative, resolve } from 'path';
-import { copy, fail, findFile, FormDataObj, postForm, readBinary } from './common';
-import { availableReleaseProviders } from './helpers';
-import { ReleaseProvider } from './types';
-
-async function getVersion(directory: string) {
-  const data = await findFile(directory, 'package.json');
-
-  if (!data) {
-    fail('packageJsonNotFound_0020');
-  }
-
-  const { version } = require(data);
-  return version;
-}
-
-export interface QualifiedReleaseProvider {
-  name: string;
-  action: ReleaseProvider;
-}
-
-const providers: Record<string, ReleaseProvider> = {
-  none() {
-    return Promise.resolve();
-  },
-  async xcopy(_, files, args) {
-    const { target } = args;
-
-    if (!target) {
-      fail('publishXcopyMissingTarget_0112');
-    }
-
-    await Promise.all(files.map(async (file) => copy(file, resolve(target, basename(file)))));
-  },
-  async feed(directory, files, args, interactive) {
-    const { url, apiKey, scheme = 'basic', version = await getVersion(directory) } = args;
-
-    if (!url) {
-      fail('publishFeedMissingUrl_0115');
-    }
-
-    if (!version) {
-      fail('publishFeedMissingVersion_0116');
-    }
-
-    const data: FormDataObj = {
-      version,
-      type: 'custom',
-    };
-
-    for (const file of files) {
-      const relPath = relative(directory, file);
-      const fileName = basename(file);
-      const content = await readBinary(dirname(file), fileName);
-      data[relPath] = [content, fileName];
-    }
-
-    await postForm(url, scheme as any, apiKey, data, {}, undefined, interactive);
-  },
-};
-
-function findReleaseProvider(providerName: string) {
-  const provider = providers[providerName];
-
-  if (typeof provider !== 'function') {
-    fail('publishProviderMissing_0113', providerName, availableReleaseProviders);
-  }
-
-  return provider;
-}
-
-availableReleaseProviders.push(...Object.keys(providers));
-
-export function setReleaseProvider(provider: QualifiedReleaseProvider) {
-  providers[provider.name] = provider.action;
-
-  if (!availableReleaseProviders.includes(provider.name)) {
-    availableReleaseProviders.push(provider.name);
-  }
-}
-
-export function publishArtifacts(
-  providerName: string,
-  directory: string,
-  files: Array<string>,
-  args: Record<string, string>,
-  interactive: boolean,
-) {
-  const runRelease = findReleaseProvider(providerName);
-  return runRelease(directory, files, args, interactive);
-}