@dagger.io/dagger 0.15.4 → 0.16.1

package/dist/src/api/client.gen.d.ts

@@ -567,15 +567,17 @@ export type DirectoryAsModuleOpts = {
     /**
      * An optional subpath of the directory which contains the module's configuration file.
      *
-     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
-     *
      * If not set, the module source code is loaded from the root of the directory.
      */
     sourceRootPath?: string;
+};
+export type DirectoryAsModuleSourceOpts = {
     /**
-     * The engine version to upgrade to.
+     * An optional subpath of the directory which contains the module's configuration file.
+     *
+     * If not set, the module source code is loaded from the root of the directory.
      */
-    engineVersion?: string;
+    sourceRootPath?: string;
 };
 export type DirectoryDockerBuildOpts = {
     /**
@@ -797,12 +799,6 @@ export type FunctionID = string & {
 export type GeneratedCodeID = string & {
     __GeneratedCodeID: never;
 };
-/**
- * The `GitModuleSourceID` scalar type represents an identifier for an object of type GitModuleSource.
- */
-export type GitModuleSourceID = string & {
-    __GitModuleSourceID: never;
-};
 export type GitRefTreeOpts = {
     /**
      * Set to true to discard .git directory.
@@ -921,52 +917,12 @@ export type LabelID = string & {
 export type ListTypeDefID = string & {
     __ListTypeDefID: never;
 };
-/**
- * The `LocalModuleSourceID` scalar type represents an identifier for an object of type LocalModuleSource.
- */
-export type LocalModuleSourceID = string & {
-    __LocalModuleSourceID: never;
-};
-export type ModuleWithSourceOpts = {
-    /**
-     * The engine version to upgrade to.
-     */
-    engineVersion?: string;
-};
-/**
- * The `ModuleDependencyID` scalar type represents an identifier for an object of type ModuleDependency.
- */
-export type ModuleDependencyID = string & {
-    __ModuleDependencyID: never;
-};
 /**
  * The `ModuleID` scalar type represents an identifier for an object of type Module.
  */
 export type ModuleID = string & {
     __ModuleID: never;
 };
-export type ModuleSourceAsModuleOpts = {
-    /**
-     * The engine version to upgrade to.
-     */
-    engineVersion?: string;
-};
-export type ModuleSourceResolveDirectoryFromCallerOpts = {
-    /**
-     * If set, the name of the view to apply to the path.
-     */
-    viewName?: string;
-    /**
-     * Patterns to ignore when loading the directory.
-     */
-    ignore?: string[];
-};
-export type ModuleSourceWithInitOpts = {
-    /**
-     * Merge module dependencies into the current project's
-     */
-    merge?: boolean;
-};
 /**
  * The `ModuleSourceID` scalar type represents an identifier for an object of type ModuleSource.
  */
@@ -977,15 +933,10 @@ export type ModuleSourceID = string & {
  * The kind of module source.
  */
 export declare enum ModuleSourceKind {
+    DirSource = "DIR_SOURCE",
     GitSource = "GIT_SOURCE",
     LocalSource = "LOCAL_SOURCE"
 }
-/**
- * The `ModuleSourceViewID` scalar type represents an identifier for an object of type ModuleSourceView.
- */
-export type ModuleSourceViewID = string & {
-    __ModuleSourceViewID: never;
-};
 /**
  * Transport layer network protocol associated to a port.
  */
@@ -1073,25 +1024,23 @@ export type ClientHttpOpts = {
 export type ClientLoadSecretFromNameOpts = {
     accessor?: string;
 };
-export type ClientModuleDependencyOpts = {
-    /**
-     * If set, the name to use for the dependency. Otherwise, once installed to a parent module, the name of the dependency module will be used by default.
-     */
-    name?: string;
-};
 export type ClientModuleSourceOpts = {
     /**
      * The pinned version of the module source
      */
     refPin?: string;
     /**
-     * If true, enforce that the source is a stable version for source kinds that support versioning.
+     * If true, do not attempt to find dagger.json in a parent directory of the provided path. Only relevant for local module sources.
      */
-    stable?: boolean;
+    disableFindUp?: boolean;
     /**
-     * The relative path to the module root from the host directory
+     * If true, do not error out if the provided ref string is a local path and does not exist yet. Useful when initializing new modules in directories that don't exist yet.
      */
-    relHostPath?: string;
+    allowNotExists?: boolean;
+    /**
+     * If set, error out if the ref string is not of the provided requireKind.
+     */
+    requireKind?: ModuleSourceKind;
 };
 /**
  * Expected return type of an execution
@@ -1966,15 +1915,19 @@ export declare class Directory extends BaseClient {
      */
     id: () => Promise<DirectoryID>;
     /**
-     * Load the directory as a Dagger module
+     * Load the directory as a Dagger module source
      * @param opts.sourceRootPath An optional subpath of the directory which contains the module's configuration file.
      *
-     * This is needed when the module code is in a subdirectory but requires parent directories to be loaded in order to execute. For example, the module source code may need a go.mod, project.toml, package.json, etc. file from a parent directory.
-     *
      * If not set, the module source code is loaded from the root of the directory.
-     * @param opts.engineVersion The engine version to upgrade to.
      */
     asModule: (opts?: DirectoryAsModuleOpts) => Module_;
+    /**
+     * Load the directory as a Dagger module source
+     * @param opts.sourceRootPath An optional subpath of the directory which contains the module's configuration file.
+     *
+     * If not set, the module source code is loaded from the root of the directory.
+     */
+    asModuleSource: (opts?: DirectoryAsModuleSourceOpts) => ModuleSource;
     /**
      * Gets the difference between this directory and an another directory.
      * @param other Identifier of the directory to compare.
@@ -2650,59 +2603,6 @@ export declare class GeneratedCode extends BaseClient {
      */
     with: (arg: (param: GeneratedCode) => GeneratedCode) => GeneratedCode;
 }
-/**
- * Module source originating from a git repo.
- */
-export declare class GitModuleSource extends BaseClient {
-    private readonly _id?;
-    private readonly _cloneRef?;
-    private readonly _commit?;
-    private readonly _htmlRepoURL?;
-    private readonly _htmlURL?;
-    private readonly _root?;
-    private readonly _rootSubpath?;
-    private readonly _version?;
-    /**
-     * Constructor is used for internal usage only, do not create object from it.
-     */
-    constructor(ctx?: Context, _id?: GitModuleSourceID, _cloneRef?: string, _commit?: string, _htmlRepoURL?: string, _htmlURL?: string, _root?: string, _rootSubpath?: string, _version?: string);
-    /**
-     * A unique identifier for this GitModuleSource.
-     */
-    id: () => Promise<GitModuleSourceID>;
-    /**
-     * The ref to clone the root of the git repo from
-     */
-    cloneRef: () => Promise<string>;
-    /**
-     * The resolved commit of the git repo this source points to.
-     */
-    commit: () => Promise<string>;
-    /**
-     * The directory containing everything needed to load load and use the module.
-     */
-    contextDirectory: () => Directory;
-    /**
-     * The URL to access the web view of the repository (e.g., GitHub, GitLab, Bitbucket)
-     */
-    htmlRepoURL: () => Promise<string>;
-    /**
-     * The URL to the source's git repo in a web browser
-     */
-    htmlURL: () => Promise<string>;
-    /**
-     * The clean module name of the root of the module
-     */
-    root: () => Promise<string>;
-    /**
-     * The path to the root of the module source under the context directory. This directory contains its configuration file. It also contains its source code (possibly as a subdirectory).
-     */
-    rootSubpath: () => Promise<string>;
-    /**
-     * The specified version of the git repo this source points to.
-     */
-    version: () => Promise<string>;
-}
 /**
  * A git ref (tag, branch, or commit).
  */
@@ -2955,34 +2855,6 @@ export declare class ListTypeDef extends BaseClient {
      */
     elementTypeDef: () => TypeDef;
 }
-/**
- * Module source that that originates from a path locally relative to an arbitrary directory.
- */
-export declare class LocalModuleSource extends BaseClient {
-    private readonly _id?;
-    private readonly _relHostPath?;
-    private readonly _rootSubpath?;
-    /**
-     * Constructor is used for internal usage only, do not create object from it.
-     */
-    constructor(ctx?: Context, _id?: LocalModuleSourceID, _relHostPath?: string, _rootSubpath?: string);
-    /**
-     * A unique identifier for this LocalModuleSource.
-     */
-    id: () => Promise<LocalModuleSourceID>;
-    /**
-     * The directory containing everything needed to load load and use the module.
-     */
-    contextDirectory: () => Directory;
-    /**
-     * The relative path to the module root from the host directory
-     */
-    relHostPath: () => Promise<string>;
-    /**
-     * The path to the root of the module source under the context directory. This directory contains its configuration file. It also contains its source code (possibly as a subdirectory).
-     */
-    rootSubpath: () => Promise<string>;
-}
 /**
  * A Dagger module.
  */
@@ -2991,22 +2863,19 @@ export declare class Module_ extends BaseClient {
     private readonly _description?;
     private readonly _name?;
     private readonly _serve?;
+    private readonly _sync?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: ModuleID, _description?: string, _name?: string, _serve?: Void);
+    constructor(ctx?: Context, _id?: ModuleID, _description?: string, _name?: string, _serve?: Void, _sync?: ModuleID);
     /**
      * A unique identifier for this Module.
      */
     id: () => Promise<ModuleID>;
     /**
-     * Modules used by this module.
+     * The dependencies of the module.
      */
     dependencies: () => Promise<Module_[]>;
-    /**
-     * The dependencies as configured by the module.
-     */
-    dependencyConfig: () => Promise<ModuleDependency[]>;
     /**
      * The doc string of the module, if any
      */
@@ -3018,15 +2887,7 @@ export declare class Module_ extends BaseClient {
     /**
      * The generated files and directories made on top of the module source's context directory.
      */
-    generatedContextDiff: () => Directory;
-    /**
-     * The module source's context plus any configuration and source files created by codegen.
-     */
     generatedContextDirectory: () => Directory;
-    /**
-     * Retrieves the module with the objects loaded via its SDK.
-     */
-    initialize: () => Module_;
     /**
      * Interfaces served by this module.
      */
@@ -3057,6 +2918,10 @@ export declare class Module_ extends BaseClient {
      * The source for the module.
      */
     source: () => ModuleSource;
+    /**
+     * Forces evaluation of the module, including any loading into the engine and associated validation.
+     */
+    sync: () => Promise<Module_>;
     /**
      * Retrieves the module with the given description
      * @param description The description to set
@@ -3074,12 +2939,6 @@ export declare class Module_ extends BaseClient {
      * This module plus the given Object type and associated functions.
      */
     withObject: (object: TypeDef) => Module_;
-    /**
-     * Retrieves the module with basic configuration loaded if present.
-     * @param source The module source to initialize from.
-     * @param opts.engineVersion The engine version to upgrade to.
-     */
-    withSource: (source: ModuleSource, opts?: ModuleWithSourceOpts) => Module_;
     /**
      * Call the provided function with current Module.
      *
@@ -3087,100 +2946,104 @@ export declare class Module_ extends BaseClient {
      */
     with: (arg: (param: Module_) => Module_) => Module_;
 }
-/**
- * The configuration of dependency of a module.
- */
-export declare class ModuleDependency extends BaseClient {
-    private readonly _id?;
-    private readonly _name?;
-    /**
-     * Constructor is used for internal usage only, do not create object from it.
-     */
-    constructor(ctx?: Context, _id?: ModuleDependencyID, _name?: string);
-    /**
-     * A unique identifier for this ModuleDependency.
-     */
-    id: () => Promise<ModuleDependencyID>;
-    /**
-     * The name of the dependency module.
-     */
-    name: () => Promise<string>;
-    /**
-     * The source for the dependency module.
-     */
-    source: () => ModuleSource;
-}
 /**
  * The source needed to load and run a module, along with any metadata about the source such as versions/urls/etc.
  */
 export declare class ModuleSource extends BaseClient {
     private readonly _id?;
     private readonly _asString?;
+    private readonly _cloneRef?;
+    private readonly _commit?;
     private readonly _configExists?;
     private readonly _digest?;
+    private readonly _engineVersion?;
+    private readonly _htmlRepoURL?;
+    private readonly _htmlURL?;
     private readonly _kind?;
+    private readonly _localContextDirectoryPath?;
     private readonly _moduleName?;
     private readonly _moduleOriginalName?;
     private readonly _pin?;
-    private readonly _resolveContextPathFromCaller?;
+    private readonly _repoRootPath?;
     private readonly _sourceRootSubpath?;
     private readonly _sourceSubpath?;
+    private readonly _sync?;
+    private readonly _version?;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(ctx?: Context, _id?: ModuleSourceID, _asString?: string, _configExists?: boolean, _digest?: string, _kind?: ModuleSourceKind, _moduleName?: string, _moduleOriginalName?: string, _pin?: string, _resolveContextPathFromCaller?: string, _sourceRootSubpath?: string, _sourceSubpath?: string);
+    constructor(ctx?: Context, _id?: ModuleSourceID, _asString?: string, _cloneRef?: string, _commit?: string, _configExists?: boolean, _digest?: string, _engineVersion?: string, _htmlRepoURL?: string, _htmlURL?: string, _kind?: ModuleSourceKind, _localContextDirectoryPath?: string, _moduleName?: string, _moduleOriginalName?: string, _pin?: string, _repoRootPath?: string, _sourceRootSubpath?: string, _sourceSubpath?: string, _sync?: ModuleSourceID, _version?: string);
     /**
      * A unique identifier for this ModuleSource.
      */
     id: () => Promise<ModuleSourceID>;
     /**
-     * If the source is a of kind git, the git source representation of it.
+     * Load the source as a module. If this is a local source, the parent directory must have been provided during module source creation
      */
-    asGitSource: () => GitModuleSource;
+    asModule: () => Module_;
     /**
-     * If the source is of kind local, the local source representation of it.
+     * A human readable ref string representation of this module source.
      */
-    asLocalSource: () => LocalModuleSource;
+    asString: () => Promise<string>;
     /**
-     * Load the source as a module. If this is a local source, the parent directory must have been provided during module source creation
-     * @param opts.engineVersion The engine version to upgrade to.
+     * The ref to clone the root of the git repo from. Only valid for git sources.
      */
-    asModule: (opts?: ModuleSourceAsModuleOpts) => Module_;
+    cloneRef: () => Promise<string>;
     /**
-     * A human readable ref string representation of this module source.
+     * The resolved commit of the git repo this source points to. Only valid for git sources.
      */
-    asString: () => Promise<string>;
+    commit: () => Promise<string>;
     /**
-     * Returns whether the module source has a configuration file.
+     * Whether an existing dagger.json for the module was found.
      */
     configExists: () => Promise<boolean>;
     /**
-     * The directory containing everything needed to load and use the module.
+     * The full directory loaded for the module source, including the source code as a subdirectory.
      */
     contextDirectory: () => Directory;
     /**
-     * The effective module source dependencies from the configuration, and calls to withDependencies and withoutDependencies.
+     * The dependencies of the module source.
      */
-    dependencies: () => Promise<ModuleDependency[]>;
+    dependencies: () => Promise<ModuleSource[]>;
     /**
-     * Return the module source's content digest. The format of the digest is not guaranteed to be stable between releases of Dagger. It is guaranteed to be stable between invocations of the same Dagger engine.
+     * A content-hash of the module source. Module sources with the same digest will output the same generated context and convert into the same module instance.
      */
     digest: () => Promise<string>;
     /**
      * The directory containing the module configuration and source code (source code may be in a subdir).
-     * @param path The path from the source directory to select.
+     * @param path A subpath from the source directory to select.
      */
     directory: (path: string) => Directory;
     /**
-     * The kind of source (e.g. local, git, etc.)
+     * The engine version of the module.
+     */
+    engineVersion: () => Promise<string>;
+    /**
+     * The generated files and directories made on top of the module source's context directory.
+     */
+    generatedContextDirectory: () => Directory;
+    /**
+     * The URL to access the web view of the repository (e.g., GitHub, GitLab, Bitbucket). Only valid for git sources.
+     */
+    htmlRepoURL: () => Promise<string>;
+    /**
+     * The URL to the source's git repo in a web browser. Only valid for git sources.
+     */
+    htmlURL: () => Promise<string>;
+    /**
+     * The kind of module source (currently local, git or dir).
      */
     kind: () => Promise<ModuleSourceKind>;
     /**
-     * If set, the name of the module this source references, including any overrides at runtime by callers.
+     * The full absolute path to the context directory on the caller's host filesystem that this module source is loaded from. Only valid for local module sources.
+     */
+    localContextDirectoryPath: () => Promise<string>;
+    /**
+     * The name of the module, including any setting via the withName API.
      */
     moduleName: () => Promise<string>;
     /**
-     * The original name of the module this source references, as defined in the module configuration.
+     * The original name of the module as read from the module's dagger.json (or set for the first time with the withName API).
      */
     moduleOriginalName: () => Promise<string>;
     /**
@@ -3188,57 +3051,44 @@ export declare class ModuleSource extends BaseClient {
      */
     pin: () => Promise<string>;
     /**
-     * The path to the module source's context directory on the caller's filesystem. Only valid for local sources.
-     */
-    resolveContextPathFromCaller: () => Promise<string>;
-    /**
-     * Resolve the provided module source arg as a dependency relative to this module source.
-     * @param dep The dependency module source to resolve.
+     * The import path corresponding to the root of the git repo this source points to. Only valid for git sources.
      */
-    resolveDependency: (dep: ModuleSource) => ModuleSource;
+    repoRootPath: () => Promise<string>;
     /**
-     * Load a directory from the caller optionally with a given view applied.
-     * @param path The path on the caller's filesystem to load.
-     * @param opts.viewName If set, the name of the view to apply to the path.
-     * @param opts.ignore Patterns to ignore when loading the directory.
+     * The SDK configuration of the module.
      */
-    resolveDirectoryFromCaller: (path: string, opts?: ModuleSourceResolveDirectoryFromCallerOpts) => Directory;
-    /**
-     * Load the source from its path on the caller's filesystem, including only needed+configured files and directories. Only valid for local sources.
-     */
-    resolveFromCaller: () => ModuleSource;
+    sdk: () => SDKConfig;
     /**
-     * The path relative to context of the root of the module source, which contains dagger.json. It also contains the module implementation source code, but that may or may not being a subdir of this root.
+     * The path, relative to the context directory, that contains the module's dagger.json.
      */
     sourceRootSubpath: () => Promise<string>;
     /**
-     * The path relative to context of the module implementation source code.
+     * The path to the directory containing the module's source code, relative to the context directory.
      */
     sourceSubpath: () => Promise<string>;
     /**
-     * Retrieve a named view defined for this module source.
-     * @param name The name of the view to retrieve.
+     * Forces evaluation of the module source, including any loading into the engine and associated validation.
      */
-    view: (name: string) => ModuleSourceView;
+    sync: () => Promise<ModuleSource>;
     /**
-     * The named views defined for this module source, which are sets of directory filters that can be applied to directory arguments provided to functions.
+     * The specified version of the git repo this source points to. Only valid for git sources.
      */
-    views: () => Promise<ModuleSourceView[]>;
-    /**
-     * Update the module source with a new context directory. Only valid for local sources.
-     * @param dir The directory to set as the context directory.
-     */
-    withContextDirectory: (dir: Directory) => ModuleSource;
+    version: () => Promise<string>;
     /**
      * Append the provided dependencies to the module source's dependency list.
      * @param dependencies The dependencies to append.
      */
-    withDependencies: (dependencies: ModuleDependency[]) => ModuleSource;
+    withDependencies: (dependencies: ModuleSource[]) => ModuleSource;
     /**
-     * Sets module init arguments
-     * @param opts.merge Merge module dependencies into the current project's
+     * Upgrade the engine version of the module to the given value.
+     * @param version The engine version to upgrade to.
      */
-    withInit: (opts?: ModuleSourceWithInitOpts) => ModuleSource;
+    withEngineVersion: (version: string) => ModuleSource;
+    /**
+     * Update the module source with additional include patterns for files+directories from its context that are required for building it
+     * @param patterns The new additional include patterns.
+     */
+    withIncludes: (patterns: string[]) => ModuleSource;
     /**
      * Update the module source with a new name.
      * @param name The name to set.
@@ -3251,7 +3101,7 @@ export declare class ModuleSource extends BaseClient {
     withSDK: (source: string) => ModuleSource;
     /**
      * Update the module source with a new source subpath.
-     * @param path The path to set as the source subpath.
+     * @param path The path to set as the source subpath. Must be relative to the module source's source root directory.
      */
     withSourceSubpath: (path: string) => ModuleSource;
     /**
@@ -3259,12 +3109,6 @@ export declare class ModuleSource extends BaseClient {
      * @param dependencies The dependencies to update.
      */
     withUpdateDependencies: (dependencies: string[]) => ModuleSource;
-    /**
-     * Update the module source with a new named view.
-     * @param name The name of the view to set.
-     * @param patterns The patterns to set as the view filters.
-     */
-    withView: (name: string, patterns: string[]) => ModuleSource;
     /**
      * Remove the provided dependencies from the module source's dependency list.
      * @param dependencies The dependencies to remove.
@@ -3277,29 +3121,6 @@ export declare class ModuleSource extends BaseClient {
      */
     with: (arg: (param: ModuleSource) => ModuleSource) => ModuleSource;
 }
-/**
- * A named set of path filters that can be applied to directory arguments provided to functions.
- */
-export declare class ModuleSourceView extends BaseClient {
-    private readonly _id?;
-    private readonly _name?;
-    /**
-     * Constructor is used for internal usage only, do not create object from it.
-     */
-    constructor(ctx?: Context, _id?: ModuleSourceViewID, _name?: string);
-    /**
-     * A unique identifier for this ModuleSourceView.
-     */
-    id: () => Promise<ModuleSourceViewID>;
-    /**
-     * The name of the view
-     */
-    name: () => Promise<string>;
-    /**
-     * The patterns of the view used to filter paths
-     */
-    patterns: () => Promise<string[]>;
-}
 /**
  * A definition of a custom object defined in a Module.
  */
@@ -3550,10 +3371,6 @@ export declare class Client extends BaseClient {
      * Load a GeneratedCode from its ID.
      */
     loadGeneratedCodeFromID: (id: GeneratedCodeID) => GeneratedCode;
-    /**
-     * Load a GitModuleSource from its ID.
-     */
-    loadGitModuleSourceFromID: (id: GitModuleSourceID) => GitModuleSource;
     /**
      * Load a GitRef from its ID.
      */
@@ -3582,14 +3399,6 @@ export declare class Client extends BaseClient {
      * Load a ListTypeDef from its ID.
      */
     loadListTypeDefFromID: (id: ListTypeDefID) => ListTypeDef;
-    /**
-     * Load a LocalModuleSource from its ID.
-     */
-    loadLocalModuleSourceFromID: (id: LocalModuleSourceID) => LocalModuleSource;
-    /**
-     * Load a ModuleDependency from its ID.
-     */
-    loadModuleDependencyFromID: (id: ModuleDependencyID) => ModuleDependency;
     /**
      * Load a Module from its ID.
      */
@@ -3598,10 +3407,6 @@ export declare class Client extends BaseClient {
      * Load a ModuleSource from its ID.
      */
     loadModuleSourceFromID: (id: ModuleSourceID) => ModuleSource;
-    /**
-     * Load a ModuleSourceView from its ID.
-     */
-    loadModuleSourceViewFromID: (id: ModuleSourceViewID) => ModuleSourceView;
     /**
      * Load a ObjectTypeDef from its ID.
      */
@@ -3651,17 +3456,12 @@ export declare class Client extends BaseClient {
      */
     module_: () => Module_;
     /**
-     * Create a new module dependency configuration from a module source and name
-     * @param source The source of the dependency
-     * @param opts.name If set, the name to use for the dependency. Otherwise, once installed to a parent module, the name of the dependency module will be used by default.
-     */
-    moduleDependency: (source: ModuleSource, opts?: ClientModuleDependencyOpts) => ModuleDependency;
-    /**
-     * Create a new module source instance from a source ref string.
+     * Create a new module source instance from a source ref string
      * @param refString The string ref representation of the module source
      * @param opts.refPin The pinned version of the module source
-     * @param opts.stable If true, enforce that the source is a stable version for source kinds that support versioning.
-     * @param opts.relHostPath The relative path to the module root from the host directory
+     * @param opts.disableFindUp If true, do not attempt to find dagger.json in a parent directory of the provided path. Only relevant for local module sources.
+     * @param opts.allowNotExists If true, do not error out if the provided ref string is a local path and does not exist yet. Useful when initializing new modules in directories that don't exist yet.
+     * @param opts.requireKind If set, error out if the ref string is not of the provided requireKind.
      */
     moduleSource: (refString: string, opts?: ClientModuleSourceOpts) => ModuleSource;
     /**