powerlines 0.30.8 → 0.30.10

package/dist/lib/chunk-5KOLVUSY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/helpers/environment.ts","../../src/lib/contexts/api-context.ts"],"names":["DEFAULT_ENVIRONMENT","createEnvironment","name","userConfig","defu","environments","title","titleCase","ssr","mainFields","build","platform","extensions","consumer","preview","port","open","strictPort","host","allowedHosts","cors","headers","undefined","createDefaultEnvironment","PowerlinesAPIContext","PowerlinesContext","from","workspaceRoot","config","context","loadWorkspaceConfig","root","withUserConfig","powerlinesPath","resolvePackage","Error","$$internal","value","environment","Object","values","log","createLog","plugins","workspaceConfig","init","Promise","all","toArray","keys","length","map","env","in","PowerlinesEnvironmentContext","fromConfig","isSetObject","inlineConfig","withInlineConfig","plugin","addPlugin","options","isHighPriority","push","getEnvironment","LogLevelLabel","DEBUG","chalk","bold","cyanBright","WARN","getEnvironmentSafe"],"mappings":"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","file":"chunk-5KOLVUSY.cjs","sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport defu from \"defu\";\nimport { APIContext, Context } from \"../../types/context\";\nimport { EnvironmentResolvedConfig } from \"../../types/resolved\";\n\nexport const DEFAULT_ENVIRONMENT = \"default\" as const;\n\nexport function createEnvironment<TContext extends Context = Context>(\n  name: string,\n  userConfig: TContext[\"config\"][\"userConfig\"]\n): EnvironmentResolvedConfig {\n  return defu(\n    userConfig.environments?.[name] ?? {},\n    {\n      name,\n      title: userConfig.title || titleCase(userConfig.name),\n      ssr: false,\n      mainFields:\n        userConfig.build?.platform === \"browser\"\n          ? [\"browser\", \"module\", \"jsnext:main\", \"jsnext\"]\n          : [\"module\", \"jsnext:main\", \"jsnext\"],\n      extensions: [\".mjs\", \".js\", \".mts\", \".ts\", \".jsx\", \".tsx\", \".json\"],\n      consumer: userConfig.build?.platform === \"browser\" ? \"client\" : \"server\",\n      preview:\n        userConfig.build?.platform === \"browser\"\n          ? {\n              port: 5173,\n              open: true,\n              strictPort: false,\n              // https: false,\n              host: \"localhost\",\n              allowedHosts: [\".\"],\n              cors: true,\n              headers: {}\n            }\n          : undefined\n    },\n    userConfig\n  ) as EnvironmentResolvedConfig;\n}\n\nexport function createDefaultEnvironment<\n  TContext extends APIContext = APIContext\n>(userConfig: TContext[\"config\"][\"userConfig\"]): EnvironmentResolvedConfig {\n  return createEnvironment(DEFAULT_ENVIRONMENT, userConfig);\n}\n","/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { resolvePackage } from \"@stryke/fs/resolve\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport chalk from \"chalk\";\nimport {\n  createDefaultEnvironment,\n  createEnvironment\n} from \"../../internal/helpers/environment\";\nimport {\n  InitialUserConfig,\n  InlineConfig,\n  LogFn,\n  UserConfig,\n  WorkspaceConfig\n} from \"../../types/config\";\nimport {\n  APIContext,\n  EnvironmentContext,\n  InitContextOptions,\n  PluginContext\n} from \"../../types/context\";\nimport {\n  UNSAFE_ContextInternal,\n  UNSAFE_EnvironmentContext\n} from \"../../types/internal\";\nimport { Plugin } from \"../../types/plugin\";\nimport {\n  EnvironmentResolvedConfig,\n  ResolvedConfig\n} from \"../../types/resolved\";\nimport { loadWorkspaceConfig } from \"../config-file\";\nimport { PowerlinesContext } from \"./context\";\nimport { PowerlinesEnvironmentContext } from \"./environment-context\";\n\nexport class PowerlinesAPIContext<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n>\n  extends PowerlinesContext<TResolvedConfig>\n  implements APIContext<TResolvedConfig>\n{\n  #environments: Record<string, UNSAFE_EnvironmentContext<TResolvedConfig>> =\n    {};\n\n  #plugins: Plugin<PluginContext<TResolvedConfig>>[] = [];\n\n  #log!: LogFn;\n\n  /**\n   * Create a new Storm context from the workspace root and user config.\n   *\n   * @param workspaceRoot - The root directory of the workspace.\n   * @param config - The user configuration options.\n   * @returns A promise that resolves to the new context.\n   */\n  public static override async from<\n    TResolvedConfig extends ResolvedConfig = ResolvedConfig\n  >(\n    workspaceRoot: string,\n    config: InitialUserConfig<TResolvedConfig[\"userConfig\"]>\n  ): Promise<APIContext<TResolvedConfig>> {\n    const context = new PowerlinesAPIContext<TResolvedConfig>(\n      await loadWorkspaceConfig(workspaceRoot, config.root)\n    );\n    await context.withUserConfig(config);\n\n    const powerlinesPath = await resolvePackage(\"powerlines\");\n    if (!powerlinesPath) {\n      throw new Error(\"Could not resolve `powerlines` package location.\");\n    }\n\n    context.powerlinesPath = powerlinesPath;\n\n    return context;\n  }\n\n  /**\n   * Internal context fields and methods\n   *\n   * @danger\n   * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.\n   *\n   * @internal\n   */\n  public override get $$internal(): UNSAFE_ContextInternal<TResolvedConfig> {\n    return super.$$internal;\n  }\n\n  /**\n   * Internal context fields and methods\n   *\n   * @danger\n   * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.\n   *\n   * @internal\n   */\n  public override set $$internal(\n    value: UNSAFE_ContextInternal<TResolvedConfig>\n  ) {\n    super.$$internal = value;\n    for (const environment of Object.values(this.environments)) {\n      environment.$$internal = super.$$internal;\n    }\n  }\n\n  /**\n   * A record of all environments by name\n   */\n  public get environments(): Record<\n    string,\n    UNSAFE_EnvironmentContext<TResolvedConfig>\n  > {\n    return this.#environments;\n  }\n\n  public override get log(): LogFn {\n    if (!this.#log) {\n      this.#log = this.createLog(\"engine\");\n    }\n\n    return this.#log;\n  }\n\n  public get plugins(): Array<Plugin<PluginContext<TResolvedConfig>>> {\n    return this.#plugins;\n  }\n\n  protected constructor(workspaceConfig: WorkspaceConfig) {\n    super(workspaceConfig);\n  }\n\n  /**\n   * Initialize the context with the provided configuration options\n   *\n   * @param config - The partial user configuration to use for initialization.\n   */\n  protected override async init(\n    config: Partial<TResolvedConfig[\"userConfig\"]> = {}\n  ) {\n    await super.init(config);\n\n    await Promise.all(\n      toArray(\n        this.config.userConfig.environments &&\n          Object.keys(this.config.userConfig.environments).length > 0\n          ? Object.keys(this.config.userConfig.environments).map(name =>\n              createEnvironment(name, this.config.userConfig)\n            )\n          : createDefaultEnvironment(this.config.userConfig)\n      ).map(async env => {\n        this.#environments[env.name] = await this.in(env);\n      })\n    );\n  }\n\n  /**\n   * A function to copy the context and update the fields for a specific environment\n   *\n   * @param environment - The environment configuration to use.\n   * @returns A new context instance with the updated environment.\n   */\n  public async in(\n    environment: EnvironmentResolvedConfig\n  ): Promise<UNSAFE_EnvironmentContext<TResolvedConfig>> {\n    let context: UNSAFE_EnvironmentContext<TResolvedConfig>;\n    if (this.environments[environment.name]) {\n      context = this.environments[environment.name] as any;\n    } else {\n      context = (await PowerlinesEnvironmentContext.fromConfig(\n        this.workspaceConfig,\n        this.config\n      )) as any;\n    }\n\n    if (isSetObject(this.config.inlineConfig)) {\n      await context.withInlineConfig(this.config.inlineConfig);\n    }\n\n    context.environment = environment;\n    context.plugins = [];\n\n    for (const plugin of this.plugins) {\n      await context.addPlugin(plugin);\n    }\n\n    return context;\n  }\n\n  /**\n   * Update the context using a new user configuration options\n   *\n   * @param userConfig - The new user configuration options.\n   */\n  public override async withUserConfig(\n    userConfig: InitialUserConfig<TResolvedConfig[\"userConfig\"]>,\n    options: InitContextOptions = {\n      isHighPriority: true\n    }\n  ) {\n    await super.withUserConfig(userConfig, options);\n\n    await Promise.all(\n      Object.keys(this.#environments).map(async name => {\n        await this.#environments[name]!.withUserConfig(\n          userConfig as UserConfig,\n          options\n        );\n      })\n    );\n  }\n\n  /**\n   * Update the context using a new inline configuration options\n   *\n   * @param inlineConfig - The new inline configuration options.\n   */\n  public override async withInlineConfig(\n    inlineConfig: TResolvedConfig[\"inlineConfig\"],\n    options: InitContextOptions = {\n      isHighPriority: true\n    }\n  ) {\n    await super.withInlineConfig(inlineConfig, options);\n\n    await Promise.all(\n      Object.keys(this.#environments).map(async name => {\n        await this.#environments[name]!.withInlineConfig(\n          inlineConfig as InlineConfig,\n          options\n        );\n      })\n    );\n  }\n\n  /**\n   * Add a plugin to the API context and all environments\n   *\n   * @param plugin - The plugin to add.\n   */\n  public async addPlugin(plugin: Plugin<PluginContext<TResolvedConfig>>) {\n    this.plugins.push(plugin);\n\n    await Promise.all(\n      Object.keys(this.environments).map(async name => {\n        await this.environments[name]!.addPlugin(plugin);\n      })\n    );\n  }\n\n  /**\n   * Get an environment by name, or the default environment if no name is provided\n   *\n   * @param name - The name of the environment to retrieve.\n   * @returns The requested environment context.\n   */\n  public async getEnvironment(name?: string) {\n    let environment: EnvironmentContext<TResolvedConfig> | undefined;\n    if (name) {\n      environment = this.environments[name];\n    }\n\n    if (Object.keys(this.environments).length === 1) {\n      environment = this.environments[Object.keys(this.environments)[0]!];\n\n      this.log(\n        LogLevelLabel.DEBUG,\n        `Applying the only configured environment: ${chalk.bold.cyanBright(\n          environment?.environment.name\n        )}`\n      );\n    }\n\n    if (!environment) {\n      if (name) {\n        throw new Error(`Environment \"${name}\" not found.`);\n      }\n\n      environment = await this.in(\n        createDefaultEnvironment(this.config.userConfig)\n      );\n\n      this.log(\n        LogLevelLabel.WARN,\n        `No environment specified, and no default environment found. Using a temporary default environment: ${chalk.bold.cyanBright(\n          environment?.environment.name\n        )}`\n      );\n    }\n\n    return environment;\n  }\n\n  public async getEnvironmentSafe(\n    name?: string\n  ): Promise<EnvironmentContext<TResolvedConfig> | undefined> {\n    try {\n      return await this.getEnvironment(name);\n    } catch {\n      return undefined;\n    }\n  }\n}\n"]}

package/dist/lib/{chunk-A7JRCJK2.cjs → chunk-75KYTRYW.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var chunkMFC7UJHT_cjs = require('./chunk-MFC7UJHT.cjs');
-var chunkQ7V66FH3_cjs = require('./chunk-Q7V66FH3.cjs');
-var chunk2OMOKN7Y_cjs = require('./chunk-2OMOKN7Y.cjs');
+var chunk5KOLVUSY_cjs = require('./chunk-5KOLVUSY.cjs');
+var chunkCLLQO726_cjs = require('./chunk-CLLQO726.cjs');
 var chunkBJGMF356_cjs = require('./chunk-BJGMF356.cjs');
 var chunkZWLSNYIN_cjs = require('./chunk-ZWLSNYIN.cjs');
 var chunkQHTL2U3L_cjs = require('./chunk-QHTL2U3L.cjs');
@@ -494,7 +494,7 @@ var PowerlinesAPI = class _PowerlinesAPI {
   * @returns A new instance of the Powerlines API
   */
   static async from(workspaceRoot, config) {
-    const api = new _PowerlinesAPI(await chunkQ7V66FH3_cjs.PowerlinesAPIContext.from(workspaceRoot, config));
+    const api = new _PowerlinesAPI(await chunk5KOLVUSY_cjs.PowerlinesAPIContext.from(workspaceRoot, config));
     api.#context.$$internal = {
       api,
       addPlugin: api.#addPlugin.bind(api)
@@ -998,11 +998,11 @@ ${formatTypes(types$1)}
     if (isPromise.isPromiseLike(config)) {
       awaited = await Promise.resolve(config);
     }
-    if (!chunk2OMOKN7Y_cjs.isPluginConfig(awaited)) {
+    if (!chunkCLLQO726_cjs.isPluginConfig(awaited)) {
       throw new Error(`Invalid plugin specified in the configuration - ${JSON.stringify(awaited)}. Please ensure the value is a plugin name, an object with the \`plugin\` and \`props\` properties, or an instance of \`Plugin\`.`);
     }
     let plugin;
-    if (chunk2OMOKN7Y_cjs.isPlugin(awaited)) {
+    if (chunkCLLQO726_cjs.isPlugin(awaited)) {
       plugin = awaited;
     } else if (isFunction.isFunction(awaited)) {
       plugin = await Promise.resolve(awaited());
@@ -1013,10 +1013,10 @@ ${formatTypes(types$1)}
       } else {
         plugin = resolved;
       }
-    } else if (chunk2OMOKN7Y_cjs.isPluginConfigTuple(awaited) || chunk2OMOKN7Y_cjs.isPluginConfigObject(awaited)) {
+    } else if (chunkCLLQO726_cjs.isPluginConfigTuple(awaited) || chunkCLLQO726_cjs.isPluginConfigObject(awaited)) {
       let pluginConfig;
       let pluginOptions;
-      if (chunk2OMOKN7Y_cjs.isPluginConfigTuple(awaited)) {
+      if (chunkCLLQO726_cjs.isPluginConfigTuple(awaited)) {
         pluginConfig = awaited[0];
         pluginOptions = awaited?.length === 2 ? awaited[1] : void 0;
       } else {
@@ -1032,17 +1032,17 @@ ${formatTypes(types$1)}
         }
       } else if (isFunction.isFunction(pluginConfig)) {
         plugin = await Promise.resolve(pluginConfig(pluginOptions));
-      } else if (chunk2OMOKN7Y_cjs.isPlugin(pluginConfig)) {
+      } else if (chunkCLLQO726_cjs.isPlugin(pluginConfig)) {
         plugin = pluginConfig;
       }
     }
     if (!plugin) {
       throw new Error(`The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`);
     }
-    if (!chunk2OMOKN7Y_cjs.isPlugin(plugin)) {
+    if (!chunkCLLQO726_cjs.isPlugin(plugin)) {
       throw new Error(`The plugin option ${JSON.stringify(plugin)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`);
     }
-    if (chunk2OMOKN7Y_cjs.checkDedupe(plugin, this.context.plugins)) {
+    if (chunkCLLQO726_cjs.checkDedupe(plugin, this.context.plugins)) {
       this.context.log(types.LogLevelLabel.TRACE, `Duplicate ${chalk3__default.default.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
       return null;
     }
@@ -1206,5 +1206,5 @@ function createUnpluginFactory(variant, decorate) {
 chunkPK6SKIKE_cjs.__name(createUnpluginFactory, "createUnpluginFactory");
 
 exports.createUnpluginFactory = createUnpluginFactory;
-//# sourceMappingURL=chunk-A7JRCJK2.cjs.map
-//# sourceMappingURL=chunk-A7JRCJK2.cjs.map
+//# sourceMappingURL=chunk-75KYTRYW.cjs.map
+//# sourceMappingURL=chunk-75KYTRYW.cjs.map