varlock 0.0.15 → 0.1.1

package/dist/{env-DLUhFCnC.d.ts → env-graph-eF0B8G0j.d.ts}

@@ -1,6 +1,17 @@
 import { ParsedEnvSpecDecorator, ParsedEnvSpecFile, ParsedEnvSpecStaticValue, ParsedEnvSpecFunctionCall } from '@env-spec/parser';
 import { FallbackIfUnknown } from '@env-spec/utils/type-utils';
+import { Debugger } from 'debug';
 
+type VarlockErrorLocationDetails = {
+    /** file path or url */
+    id: string;
+    /** 1-based line number */
+    lineNumber: number;
+    /** 1-based column number */
+    colNumber: number;
+    /** full line string */
+    lineStr: string;
+};
 declare class VarlockError extends Error {
     readonly more?: {
         tip?: string | Array<string>;
@@ -8,6 +19,7 @@ declare class VarlockError extends Error {
         isWarning?: boolean;
         /** machine-friendly error code if needed for anything else */
         code?: string;
+        location?: VarlockErrorLocationDetails;
         /** free-form additional metadata */
         extraMetadata?: Record<string, any>;
     } | undefined;
@@ -23,10 +35,12 @@ declare class VarlockError extends Error {
         isWarning?: boolean;
         /** machine-friendly error code if needed for anything else */
         code?: string;
+        location?: VarlockErrorLocationDetails;
         /** free-form additional metadata */
         extraMetadata?: Record<string, any>;
     } | undefined);
     get tip(): string | undefined;
+    get location(): VarlockErrorLocationDetails | undefined;
     get code(): string | undefined;
     get extraMetadata(): Record<string, any> | undefined;
     set isWarning(w: boolean);
@@ -71,6 +85,7 @@ declare class ResolutionError extends VarlockError {
     get retryable(): boolean;
 }
 
+type MaybePromise<T> = T | Promise<T>;
 type EnvGraphDataTypeDef<CoerceReturnType, ValidateInputType = FallbackIfUnknown<CoerceReturnType, string>> = {
     /** this will be the name of the type, used to reference it when using it in a schema */
     name: string;
@@ -87,7 +102,14 @@ type EnvGraphDataTypeDef<CoerceReturnType, ValidateInputType = FallbackIfUnknown
      * - if validation passes, should return true
      * - if validation fails, should return a ValidationError or array of errors - or throw an error
      * */
-    validate: (value: ValidateInputType) => (true | undefined | void | Error | Array<Error>);
+    validate: (value: ValidateInputType) => MaybePromise<(true | undefined | void | Error | Array<Error>)>;
+    /** will make items of this type sensitive, unless overridden specifically on that item */
+    sensitive?: boolean;
+    /** adds docs info for these  */
+    docs?: Array<string | {
+        url: string;
+        description: string;
+    }>;
 };
 /**
  * holds a specific instance of a data type, along with specific settings which affect validation/coercion etc
@@ -101,10 +123,15 @@ declare class EnvGraphDataType {
     factory: any);
     get name(): string;
     get icon(): string | undefined;
+    get isSensitive(): boolean | undefined;
+    get docsEntries(): (string | {
+        url: string;
+        description: string;
+    })[] | undefined;
     /** @internal */
     get _rawDef(): EnvGraphDataTypeDef<any, any>;
     coerce(val: any): any;
-    validate(val: any): true | void | Error | Error[];
+    validate(val: any): MaybePromise<true | void | Error | Error[] | undefined>;
 }
 declare function createEnvGraphDataType<TsType, InstanceSettingsArgs extends Array<any>>(dataTypeDef: EnvGraphDataTypeDef<TsType> | ((...args: InstanceSettingsArgs) => EnvGraphDataTypeDef<TsType>)): {
     (...usageOpts: InstanceSettingsArgs): EnvGraphDataType;
@@ -113,29 +140,112 @@ declare function createEnvGraphDataType<TsType, InstanceSettingsArgs extends Arr
 };
 type EnvGraphDataTypeFactory = ReturnType<typeof createEnvGraphDataType>;
 
-type ResolvedValue = undefined | string | number | boolean | RegExp;
-type ResolverFunctionArgs = Array<Resolver | Record<string, Resolver>>;
-declare abstract class Resolver {
-    readonly fnArgs: ResolverFunctionArgs;
-    static fnName?: string;
-    constructor(fnArgs: ResolverFunctionArgs);
-    abstract label: string;
-    abstract icon: string;
+declare abstract class DecoratorInstance {
+    get name(): string;
+    get isFunctionCall(): boolean;
+    _decValueResolver?: Resolver;
+    get decValueResolver(): Resolver | undefined;
+    abstract readonly isRootDecorator: boolean;
+    abstract readonly dataSource: EnvGraphDataSource;
+    abstract readonly parsedDecorator: ParsedEnvSpecDecorator;
+    abstract graph: EnvGraph;
+    _schemaErrors: Array<SchemaError>;
+    get schemaErrors(): SchemaError[];
+    _executionError?: Error;
+    private decoratorDef?;
+    get incompatibleWith(): string[] | undefined;
+    private processed;
+    private processedData;
+    process(): Promise<void>;
+    execute(): Promise<void>;
+    resolvedValue?: any;
+    isResolved: boolean;
+    resolve(): Promise<any>;
+}
+declare class ItemDecoratorInstance extends DecoratorInstance {
+    readonly configItem: ConfigItem;
+    readonly dataSource: EnvGraphDataSource;
+    readonly parsedDecorator: ParsedEnvSpecDecorator;
+    isRootDecorator: boolean;
+    constructor(configItem: ConfigItem, dataSource: EnvGraphDataSource, parsedDecorator: ParsedEnvSpecDecorator);
+    get graph(): EnvGraph;
+}
+declare class RootDecoratorInstance extends DecoratorInstance {
+    readonly dataSource: EnvGraphDataSource;
+    readonly parsedDecorator: ParsedEnvSpecDecorator;
+    isRootDecorator: boolean;
+    constructor(dataSource: EnvGraphDataSource, parsedDecorator: ParsedEnvSpecDecorator);
+    get graph(): EnvGraph;
+}
+type RootDecoratorDef<Processed = any> = {
+    name: string;
+    description?: string;
+    isFunction?: boolean;
+    deprecated?: boolean | string;
+    incompatibleWith?: Array<string>;
+    process?: (decoratorValue: Resolver) => (Processed | Promise<Processed>);
+    execute?: (executeInput: Processed) => void | Promise<void>;
+    useFnArgsResolver?: boolean;
+};
+type ItemDecoratorDef<T = any> = {
+    name: string;
+    incompatibleWith?: Array<string>;
+    isFunction?: boolean;
+    deprecated?: boolean | string;
+    process?: (decoratorValue: Resolver) => T | Promise<T>;
+    execute?: (executeInput: T) => void | Promise<void>;
+    useFnArgsResolver?: boolean;
+};
+
+type ResolvedValue = undefined | string | number | boolean | RegExp | {
+    [key: string]: ResolvedValue;
+} | Array<ResolvedValue>;
+declare class Resolver {
+    readonly arrArgs?: Array<Resolver> | undefined;
+    readonly objArgs?: Record<string, Resolver> | undefined;
+    readonly dataSource?: EnvGraphDataSource | undefined;
+    static def: ResolverDef;
+    constructor(arrArgs?: Array<Resolver> | undefined, objArgs?: Record<string, Resolver> | undefined, dataSource?: EnvGraphDataSource | undefined);
+    static get fnName(): string;
+    get def(): ResolverDef<any>;
+    get fnName(): string;
+    get label(): string | undefined;
+    get icon(): string | undefined;
+    get isStatic(): boolean;
+    get staticValue(): ResolvedValue;
     inferredType?: string;
     _schemaErrors: Array<SchemaError>;
     private _depsObj;
     get childResolvers(): Array<Resolver>;
     get schemaErrors(): Array<SchemaError>;
+    set schemaErrors(v: Array<SchemaError>);
     get depsObj(): Record<string, boolean>;
     get deps(): string[];
-    protected abstract _process(ctx?: any): Promise<void | (() => void)>;
-    private configItem?;
-    process(configItem: ConfigItem): Promise<void>;
+    private parent?;
+    private meta;
+    process(parent?: ConfigItem | DecoratorInstance): void;
     protected addDep(key: string): void;
-    protected abstract _resolve(): Promise<ResolvedValue>;
+    protected getCurrentEnv(): Promise<string | undefined>;
     resolve(): Promise<ResolvedValue>;
+    get envGraph(): EnvGraph | undefined;
     protected getDepValue(key: string): ResolvedValue;
 }
+type ResolverDef<T = any> = {
+    name: string;
+    description?: string;
+    label?: string;
+    icon?: string;
+    inferredType?: string;
+    argsSchema?: {
+        type: 'array' | 'object' | 'mixed';
+        arrayExactLength?: number;
+        arrayMinLength?: number;
+        arrayMaxLength?: number;
+        objKeyMinLength?: number;
+    };
+    process?: (this: Resolver) => T;
+    resolve: (this: Resolver, state: T) => ResolvedValue | Promise<ResolvedValue>;
+};
 type ResolverChildClass<ChildClass extends Resolver = Resolver> = ({
     new (...args: Array<any>): ChildClass;
 } & typeof Resolver);
@@ -207,7 +317,9 @@ declare abstract class EnvGraphDataSource {
     /** environment flag value getter (follows up the parent chain), and checks the graph-level fallback */
     get envFlagValue(): ResolvedValue;
     /** helper to resolve the envFlag value */
-    resolveCurrentEnv(): Promise<ResolvedValue>;
+    resolveCurrentEnv(): Promise<string | number | boolean | RegExp | {
+        [key: string]: ResolvedValue;
+    } | ResolvedValue[] | undefined>;
     /** finish init process for this data source */
     finishInit(): Promise<void>;
     /**
@@ -225,11 +337,17 @@ declare abstract class EnvGraphDataSource {
     /** an error encountered while loading/parsing the data source */
     _loadingError?: Error;
     get loadingError(): Error | undefined;
+    _schemaErrors: Array<SchemaError>;
+    get schemaErrors(): SchemaError[];
+    get resolutionErrors(): Error[];
     get isValid(): boolean;
     configItemDefs: Record<string, ConfigItemDef>;
     decorators: Array<ParsedEnvSpecDecorator>;
     getRootDecorators(decName: string): ParsedEnvSpecDecorator[];
     getRootDecoratorSimpleValue(decName: string): any;
+    rootDecorators: Array<RootDecoratorInstance>;
+    getRootDec(decName: string): RootDecoratorInstance | undefined;
+    getRootDecFns(decName: string): RootDecoratorInstance[];
 }
 declare abstract class FileBasedDataSource extends EnvGraphDataSource {
     isGitIgnored?: boolean;
@@ -237,6 +355,7 @@ declare abstract class FileBasedDataSource extends EnvGraphDataSource {
     fileName: string;
     rawContents?: string;
     get typeLabel(): string;
+    private relativePath;
     get label(): string;
     static format: string;
     static validFileExtensions: Array<string>;
@@ -252,42 +371,48 @@ declare class DotEnvFileDataSource extends FileBasedDataSource {
     static format: string;
     static validFileExtensions: never[];
     parsedFile?: ParsedEnvSpecFile;
-    private convertParserValueToResolvers;
     _parseContents(): Promise<void>;
 }
 
 type ConfigItemDef = {
     description?: string;
+    parsedDecorators?: Array<ParsedEnvSpecDecorator>;
+    parsedValue: ParsedEnvSpecStaticValue | ParsedEnvSpecFunctionCall | undefined;
     resolver?: Resolver;
-    decorators?: Record<string, ParsedEnvSpecDecorator>;
+    decorators?: Array<ItemDecoratorInstance>;
 };
 type ConfigItemDefAndSource = {
     itemDef: ConfigItemDef;
     source: EnvGraphDataSource;
 };
 declare class ConfigItem {
-    #private;
-    constructor(_envGraph: EnvGraph, _key: string);
-    get envGraph(): EnvGraph;
-    get key(): string;
+    readonly envGraph: EnvGraph;
+    readonly key: string;
+    constructor(envGraph: EnvGraph, key: string);
     /**
      * fetch ordered list of definitions for this item, by following up sorted data sources list
      */
     get defs(): ConfigItemDefAndSource[];
     get description(): string | undefined;
-    get icon(): string | undefined;
+    get icon(): any;
     get docsLinks(): {
         url: string;
         description?: string;
     }[];
     get valueResolver(): Resolver | undefined;
-    getDecorator(decoratorName: string): ParsedEnvSpecDecorator | undefined;
-    getDecoratorValueRaw(decoratorName: string): ParsedEnvSpecStaticValue | ParsedEnvSpecFunctionCall | undefined;
-    getDecoratorValueString(decoratorName: string): string | undefined;
+    allDecorators: Array<ItemDecoratorInstance>;
+    effectiveDecorators: Record<string, ItemDecoratorInstance>;
+    effectiveDecoratorFns: Record<string, Array<ItemDecoratorInstance>>;
+    getDec(decoratorName: string): ItemDecoratorInstance;
+    getDecFns(decoratorName: string): ItemDecoratorInstance[];
+    resolveDecorators(): Promise<void>;
     dataType?: EnvGraphDataType;
-    schemaErrors: Array<SchemaError>;
+    _schemaErrors: Array<SchemaError>;
     get resolverSchemaErrors(): SchemaError[];
+    get decoratorSchemaErrors(): SchemaError[];
+    private isProcessed;
     process(): Promise<void>;
+    get dependencyKeys(): string[];
     /**
      * special early resolution helper
      * currently used to resolve the envFlag before everything else has been loaded
@@ -302,7 +427,9 @@ declare class ConfigItem {
     private processRequired;
     get isRequired(): boolean;
     get isRequiredDynamic(): boolean;
-    get isSensitive(): any;
+    _isSensitive: boolean;
+    get isSensitive(): boolean;
+    private processSensitive;
     get errors(): (SchemaError | ValidationError | CoercionError | ResolutionError)[];
     get validationState(): 'warn' | 'error' | 'valid';
     /** resolved value _before coercion_ */
@@ -322,6 +449,52 @@ declare class ConfigItem {
 type GraphNodeId = string;
 type GraphAdjacencyList = Record<GraphNodeId, Array<GraphNodeId>>;
 
+declare class VarlockPlugin {
+    readonly ERRORS: {
+        ValidationError: typeof ValidationError;
+        CoercionError: typeof CoercionError;
+        SchemaError: typeof SchemaError;
+        ResolutionError: typeof ResolutionError;
+    };
+    private _packageJson?;
+    private _name?;
+    get name(): string;
+    set name(val: string);
+    private _version?;
+    get version(): string;
+    set version(val: string);
+    private _icon?;
+    get icon(): string;
+    set icon(val: string);
+    loadingError?: Error;
+    readonly localPath?: string;
+    /** reference to the `@plugin()` decorator instance(s) that installed the plugin  */
+    installDecoratorInstances: Array<DecoratorInstance>;
+    type: 'single-file' | 'package';
+    constructor(opts: {
+        type: 'single-file' | 'package';
+        localPath: string;
+        loadingError?: Error;
+        packageJson?: {
+            name: string;
+            version?: string;
+            description?: string;
+        };
+    });
+    private debugger;
+    get debug(): (...args: Parameters<Debugger>) => void;
+    readonly dataTypes?: Array<Parameters<typeof createEnvGraphDataType>[0]>;
+    registerDataType(dataTypeDef: Parameters<typeof createEnvGraphDataType>[0]): void;
+    readonly rootDecorators?: Array<RootDecoratorDef<any>>;
+    registerRootDecorator<T>(decoratorDef: RootDecoratorDef<T>): void;
+    readonly itemDecorators?: Array<ItemDecoratorDef<any>>;
+    registerItemDecorator<T>(decoratorDef: ItemDecoratorDef<T>): void;
+    readonly resolverFunctions?: Array<ResolverDef<any>>;
+    registerResolverFunction<T>(resolverDef: ResolverDef<T>): void;
+    get pluginFilePath(): string;
+    executePluginModule(): Promise<void>;
+}
+
 type SerializedEnvGraph = {
     basePath?: string;
     sources: Array<{
@@ -358,41 +531,23 @@ declare class EnvGraph {
     registerResolver(resolverClass: ResolverChildClass): void;
     dataTypesRegistry: Record<string, EnvGraphDataTypeFactory>;
     registerDataType(factory: EnvGraphDataTypeFactory): void;
+    itemDecoratorsRegistry: Record<string, ItemDecoratorDef>;
+    registerItemDecorator(decoratorDef: ItemDecoratorDef): void;
+    rootDecoratorsRegistry: Record<string, RootDecoratorDef>;
+    registerRootDecorator(decoratorDef: RootDecoratorDef): void;
     constructor();
     setRootDataSource(source: EnvGraphDataSource): Promise<void>;
     finishLoad(): Promise<void>;
     get graphAdjacencyList(): GraphAdjacencyList;
-    resolveEnvValues(): Promise<void>;
+    resolveEnvValues(keys?: Array<string>): Promise<void>;
     getResolvedEnvObject(): Record<string, any>;
     getSerializedGraph(): SerializedEnvGraph;
     get isInvalid(): boolean;
     generateTypes(lang: string, outputPath: string): Promise<void>;
-    getRootDecoratorValue(decoratorName: string): any;
-    getRootDecorators(decoratorName: string): [EnvGraphDataSource, ParsedEnvSpecDecorator[]][];
-}
-
-declare function resetRedactionMap(graph: SerializedEnvGraph): void;
-/**
- * Redacts senstive config values from any string/array/object/etc
- *
- * NOTE - must be used only after varlock has loaded config
- * */
-declare function redactSensitiveConfig(o: any): any;
-/**
- * utility to unmask a secret/sensitive value when logging to the console
- * currently this only works on a single secret, not objects or aggregated strings
- * */
-declare function revealSensitiveConfig(secretStr: string): string;
-declare function scanForLeaks(toScan: string | ReadableStream | null, meta?: {
-    method?: string;
-    file?: string;
-}): string | ReadableStream<any> | null;
-declare const varlockSettings: Record<string, any>;
-declare function initVarlockEnv(opts?: {
-    allowFail?: boolean;
-}): void;
-interface TypedEnvSchema {
+    getRootDec(decoratorName: string): RootDecoratorInstance | undefined;
+    getRootDecFns(decoratorName: string): RootDecoratorInstance[];
+    /** plugins installed globally in the graph */
+    plugins: Array<VarlockPlugin>;
 }
-declare const ENV: TypedEnvSchema;
 
-export { ConfigLoadError as C, DotEnvFileDataSource as D, EnvGraph as E, ResolutionError as R, SchemaError as S, type TypedEnvSchema as T, ValidationError as V, CoercionError as a, type SerializedEnvGraph as b, ENV as c, redactSensitiveConfig as d, revealSensitiveConfig as e, initVarlockEnv as i, resetRedactionMap as r, scanForLeaks as s, varlockSettings as v };
+export { ConfigLoadError as C, DotEnvFileDataSource as D, EnvGraph as E, Resolver as R, type SerializedEnvGraph as S, VarlockPlugin as V, SchemaError as a, ValidationError as b, CoercionError as c, ResolutionError as d };

package/dist/index.d.ts

@@ -1,10 +1,13 @@
-import { E as EnvGraph, D as DotEnvFileDataSource, C as ConfigLoadError, S as SchemaError, V as ValidationError, a as CoercionError, R as ResolutionError, i as initVarlockEnv } from './env-DLUhFCnC.js';
-export { c as ENV, b as SerializedEnvGraph } from './env-DLUhFCnC.js';
+import { E as EnvGraph, D as DotEnvFileDataSource, C as ConfigLoadError, a as SchemaError, b as ValidationError, c as CoercionError, d as ResolutionError } from './env-graph-eF0B8G0j.js';
+export { S as SerializedEnvGraph } from './env-graph-eF0B8G0j.js';
+import { initVarlockEnv } from './runtime/env.js';
+export { ENV } from './runtime/env.js';
 export { patchGlobalConsole } from './runtime/patch-console.js';
 export { patchGlobalServerResponse } from './runtime/patch-server-response.js';
 export { patchGlobalResponse } from './runtime/patch-response.js';
 import '@env-spec/parser';
 import '@env-spec/utils/type-utils';
+import 'debug';
 
 declare function loadEnvGraph(opts?: {
     basePath?: string;

package/dist/index.js

@@ -1,10 +1,10 @@
-export { patchGlobalServerResponse } from './chunk-7JMYT62X.js';
-import { loadVarlockEnvGraph, checkForConfigErrors } from './chunk-UPLR6H2O.js';
-import { ResolutionError, CoercionError, ValidationError, SchemaError, ConfigLoadError, loadEnvGraph, DotEnvFileDataSource, EnvGraph } from './chunk-IWQ4BDSW.js';
-export { patchGlobalConsole } from './chunk-C5BEZMSO.js';
-export { patchGlobalResponse } from './chunk-OM3JCP4E.js';
-import { initVarlockEnv } from './chunk-2SPIWTVE.js';
-export { ENV } from './chunk-2SPIWTVE.js';
+export { patchGlobalResponse } from './chunk-7FI2PPMC.js';
+export { patchGlobalServerResponse } from './chunk-WDC67GVB.js';
+import { loadVarlockEnvGraph, checkForConfigErrors } from './chunk-H3R4W3XK.js';
+import { ResolutionError, CoercionError, ValidationError, SchemaError, ConfigLoadError, loadEnvGraph, DotEnvFileDataSource, EnvGraph } from './chunk-7UWLKQXP.js';
+export { patchGlobalConsole } from './chunk-RWBSXJV6.js';
+import { initVarlockEnv } from './chunk-2JGPOSVQ.js';
+export { ENV } from './chunk-2JGPOSVQ.js';
 import './chunk-FGMXIEFA.js';
 import { __name } from './chunk-XN24GZXQ.js';
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAiBA,eAAsB,IAAA,GAAO;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAM,mBAAA,EAAoB;AAC3C,EAAA,MAAM,SAAS,gBAAA,EAAiB;AAChC,EAAA,oBAAA,CAAqB,QAAQ,CAAA;AAG7B,EAAA,OAAA,CAAQ,IAAI,aAAA,GAAgB,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,oBAAoB,CAAA;AACxE,EAAA,cAAA,EAAe;AAEjB;AAVsB,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAaf,SAAS,yBAAyB,IAAA,EAGtC;AACD,EAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,aAAA,SAAsB,EAAC;AACxC,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,IAAI,aAAa,CAAA;AACpD,EAAA,MAAM,eAAe,EAAC;AACtB,EAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,MAAA,EAAQ;AAChC,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,GAAG,CAAA;AACnC,IAAA,MAAM,WAAA,GAAc,CAAC,QAAA,CAAS,WAAA,IAAe,IAAA,EAAM,gBAAA;AACnD,IAAA,IAAI,CAAC,WAAA,EAAa;AAClB,IAAA,YAAA,CAAa,CAAA,EAAG,IAAA,EAAM,SAAA,IAAa,KAAK,IAAI,GAAG,CAAA,CAAE,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,MAAA,CAAO,GAAG,EAAE,KAAK,CAAA;AAAA,EAC/F;AACA,EAAA,OAAO,YAAA;AACT;AAdgB,MAAA,CAAA,wBAAA,EAAA,0BAAA,CAAA;AAiBT,IAAM,QAAA,GAAW;AAAA;AAAA,EAEtB,QAAA;AAAA,EACA,oBAAA;AAAA;AAAA,EAGA,YAAA;AAAA;AAAA,EAGA,eAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,aAAA;AAAA,EACA,eAAA;AAAA;AAAA,EAGA,mBAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF","file":"index.js","sourcesContent":["import { checkForConfigErrors } from './cli/helpers/error-checks';\nimport { loadVarlockEnvGraph } from './lib/load-graph';\nimport { initVarlockEnv } from './runtime/env';\n\n// Import env-graph components for internal API\nimport {\n  EnvGraph,\n  loadEnvGraph,\n  DotEnvFileDataSource,\n  ConfigLoadError,\n  SchemaError,\n  ValidationError,\n  CoercionError,\n  ResolutionError,\n  type SerializedEnvGraph,\n} from '../env-graph';\n\nexport async function load() {\n  // TODO: add some options\n  const envGraph = await loadVarlockEnvGraph();\n  await envGraph.resolveEnvValues();\n  checkForConfigErrors(envGraph);\n\n  // loadFromSerializedGraph(envGraph.getSerializedGraph());\n  process.env.__VARLOCK_ENV = JSON.stringify(envGraph.getSerializedGraph());\n  initVarlockEnv();\n  // TODO: return resolved env and schema / meta info\n}\n\n\nexport function getBuildTimeReplacements(opts?: {\n  objectKey?: string,\n  includeSensitive?: boolean,\n}) {\n  if (!process.env.__VARLOCK_ENV) return {};\n  const envInfo = JSON.parse(process.env.__VARLOCK_ENV) as SerializedEnvGraph;\n  const replacements = {} as Record<string, string>;\n  for (const key in envInfo.config) {\n    const itemInfo = envInfo.config[key];\n    const replaceItem = !itemInfo.isSensitive || opts?.includeSensitive;\n    if (!replaceItem) continue;\n    replacements[`${opts?.objectKey || 'ENV'}.${key}`] = JSON.stringify(envInfo.config[key].value);\n  }\n  return replacements;\n}\n\n// Internal API for direct env graph manipulation\nexport const internal = {\n  // Core classes\n  EnvGraph,\n  DotEnvFileDataSource,\n\n  // Loader function\n  loadEnvGraph,\n\n  // Error classes\n  ConfigLoadError,\n  SchemaError,\n  ValidationError,\n  CoercionError,\n  ResolutionError,\n\n  // Varlock-specific utilities\n  loadVarlockEnvGraph,\n  checkForConfigErrors,\n  initVarlockEnv,\n};\n\nexport { patchGlobalConsole } from './runtime/patch-console';\nexport { patchGlobalServerResponse } from './runtime/patch-server-response';\nexport { patchGlobalResponse } from './runtime/patch-response';\nexport { ENV } from './runtime/env';\nexport type { SerializedEnvGraph };\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAiBA,eAAsB,IAAA,GAAO;AAE3B,EAAA,MAAM,QAAA,GAAW,MAAM,mBAAA,EAAoB;AAC3C,EAAA,MAAM,SAAS,gBAAA,EAAiB;AAChC,EAAA,oBAAA,CAAqB,QAAQ,CAAA;AAG7B,EAAA,OAAA,CAAQ,IAAI,aAAA,GAAgB,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,oBAAoB,CAAA;AACxE,EAAA,cAAA,EAAe;AAEjB;AAVsB,MAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAaf,SAAS,yBAAyB,IAAA,EAGtC;AACD,EAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,aAAA,SAAsB,EAAC;AACxC,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,IAAI,aAAa,CAAA;AACpD,EAAA,MAAM,eAAe,EAAC;AACtB,EAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,MAAA,EAAQ;AAChC,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,MAAA,CAAO,GAAG,CAAA;AACnC,IAAA,MAAM,WAAA,GAAc,CAAC,QAAA,CAAS,WAAA,IAAe,IAAA,EAAM,gBAAA;AACnD,IAAA,IAAI,CAAC,WAAA,EAAa;AAClB,IAAA,YAAA,CAAa,CAAA,EAAG,IAAA,EAAM,SAAA,IAAa,KAAK,IAAI,GAAG,CAAA,CAAE,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,MAAA,CAAO,GAAG,EAAE,KAAK,CAAA;AAAA,EAC/F;AACA,EAAA,OAAO,YAAA;AACT;AAdgB,MAAA,CAAA,wBAAA,EAAA,0BAAA,CAAA;AAiBT,IAAM,QAAA,GAAW;AAAA;AAAA,EAEtB,QAAA;AAAA,EACA,oBAAA;AAAA;AAAA,EAGA,YAAA;AAAA;AAAA,EAGA,eAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,aAAA;AAAA,EACA,eAAA;AAAA;AAAA,EAGA,mBAAA;AAAA,EACA,oBAAA;AAAA,EACA;AACF","file":"index.js","sourcesContent":["import { checkForConfigErrors } from './cli/helpers/error-checks';\nimport { loadVarlockEnvGraph } from './lib/load-graph';\nimport { initVarlockEnv } from './runtime/env';\n\n// Import env-graph components for internal API\nimport {\n  EnvGraph,\n  loadEnvGraph,\n  DotEnvFileDataSource,\n  ConfigLoadError,\n  SchemaError,\n  ValidationError,\n  CoercionError,\n  ResolutionError,\n  type SerializedEnvGraph,\n} from './env-graph';\n\nexport async function load() {\n  // TODO: add some options\n  const envGraph = await loadVarlockEnvGraph();\n  await envGraph.resolveEnvValues();\n  checkForConfigErrors(envGraph);\n\n  // loadFromSerializedGraph(envGraph.getSerializedGraph());\n  process.env.__VARLOCK_ENV = JSON.stringify(envGraph.getSerializedGraph());\n  initVarlockEnv();\n  // TODO: return resolved env and schema / meta info\n}\n\n\nexport function getBuildTimeReplacements(opts?: {\n  objectKey?: string,\n  includeSensitive?: boolean,\n}) {\n  if (!process.env.__VARLOCK_ENV) return {};\n  const envInfo = JSON.parse(process.env.__VARLOCK_ENV) as SerializedEnvGraph;\n  const replacements = {} as Record<string, string>;\n  for (const key in envInfo.config) {\n    const itemInfo = envInfo.config[key];\n    const replaceItem = !itemInfo.isSensitive || opts?.includeSensitive;\n    if (!replaceItem) continue;\n    replacements[`${opts?.objectKey || 'ENV'}.${key}`] = JSON.stringify(envInfo.config[key].value);\n  }\n  return replacements;\n}\n\n// Internal API for direct env graph manipulation\nexport const internal = {\n  // Core classes\n  EnvGraph,\n  DotEnvFileDataSource,\n\n  // Loader function\n  loadEnvGraph,\n\n  // Error classes\n  ConfigLoadError,\n  SchemaError,\n  ValidationError,\n  CoercionError,\n  ResolutionError,\n\n  // Varlock-specific utilities\n  loadVarlockEnvGraph,\n  checkForConfigErrors,\n  initVarlockEnv,\n};\n\nexport { patchGlobalConsole } from './runtime/patch-console';\nexport { patchGlobalServerResponse } from './runtime/patch-server-response';\nexport { patchGlobalResponse } from './runtime/patch-response';\nexport { ENV } from './runtime/env';\nexport type { SerializedEnvGraph };\n"]}

package/dist/init.command-A52ZWKL2.js

@@ -0,0 +1,8 @@
+export { commandFn, commandSpec } from './chunk-D7YI7IQX.js';
+import './chunk-IBAUYNXV.js';
+import './chunk-33ROL4J5.js';
+import './chunk-7UWLKQXP.js';
+import './chunk-FGMXIEFA.js';
+import './chunk-XN24GZXQ.js';
+//# sourceMappingURL=init.command-A52ZWKL2.js.map
+//# sourceMappingURL=init.command-A52ZWKL2.js.map

package/dist/{init.command-YZ23U7SF.js.map → init.command-A52ZWKL2.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"init.command-YZ23U7SF.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"init.command-A52ZWKL2.js"}

package/dist/lib/exec-sync-varlock.js

@@ -1,4 +1,4 @@
-export { execSyncVarlock } from '../chunk-LBV2UW3I.js';
+export { execSyncVarlock } from '../chunk-QT5E2RY6.js';
 import '../chunk-XN24GZXQ.js';
 //# sourceMappingURL=exec-sync-varlock.js.map
 //# sourceMappingURL=exec-sync-varlock.js.map

package/dist/load.command-C75DTSKP.js

@@ -0,0 +1,8 @@
+export { commandFn, commandSpec } from './chunk-R66KFGSX.js';
+import './chunk-33ROL4J5.js';
+import './chunk-H3R4W3XK.js';
+import './chunk-7UWLKQXP.js';
+import './chunk-FGMXIEFA.js';
+import './chunk-XN24GZXQ.js';
+//# sourceMappingURL=load.command-C75DTSKP.js.map
+//# sourceMappingURL=load.command-C75DTSKP.js.map

package/dist/{load.command-NVMWXLOK.js.map → load.command-C75DTSKP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"load.command-NVMWXLOK.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"load.command-C75DTSKP.js"}

package/dist/plugin-lib.d.ts

@@ -0,0 +1,9 @@
+import { V as VarlockPlugin } from './env-graph-eF0B8G0j.js';
+export { R as Resolver } from './env-graph-eF0B8G0j.js';
+import '@env-spec/parser';
+import '@env-spec/utils/type-utils';
+import 'debug';
+
+declare global {
+    const plugin: VarlockPlugin;
+}

package/dist/plugin-lib.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=plugin-lib.js.map
+//# sourceMappingURL=plugin-lib.js.map

package/dist/plugin-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"plugin-lib.js"}

package/dist/run.command-YSQDB4GE.js

@@ -0,0 +1,8 @@
+export { commandFn, commandSpec } from './chunk-VYAOZFZB.js';
+import './chunk-33ROL4J5.js';
+import './chunk-H3R4W3XK.js';
+import './chunk-7UWLKQXP.js';
+import './chunk-FGMXIEFA.js';
+import './chunk-XN24GZXQ.js';
+//# sourceMappingURL=run.command-YSQDB4GE.js.map
+//# sourceMappingURL=run.command-YSQDB4GE.js.map

package/dist/{run.command-CXMAPHO7.js.map → run.command-YSQDB4GE.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"run.command-CXMAPHO7.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"run.command-YSQDB4GE.js"}

package/dist/runtime/env.d.ts

@@ -1,3 +1,30 @@
-export { c as ENV, T as TypedEnvSchema, i as initVarlockEnv, d as redactSensitiveConfig, r as resetRedactionMap, e as revealSensitiveConfig, s as scanForLeaks, v as varlockSettings } from '../env-DLUhFCnC.js';
+import { S as SerializedEnvGraph } from '../env-graph-eF0B8G0j.js';
 import '@env-spec/parser';
 import '@env-spec/utils/type-utils';
+import 'debug';
+
+declare function resetRedactionMap(graph: SerializedEnvGraph): void;
+/**
+ * Redacts senstive config values from any string/array/object/etc
+ *
+ * NOTE - must be used only after varlock has loaded config
+ * */
+declare function redactSensitiveConfig(o: any): any;
+/**
+ * utility to unmask a secret/sensitive value when logging to the console
+ * currently this only works on a single secret, not objects or aggregated strings
+ * */
+declare function revealSensitiveConfig(secretStr: string): string;
+declare function scanForLeaks(toScan: string | ReadableStream | null, meta?: {
+    method?: string;
+    file?: string;
+}): string | ReadableStream<any> | null;
+declare const varlockSettings: Record<string, any>;
+declare function initVarlockEnv(opts?: {
+    allowFail?: boolean;
+}): void;
+interface TypedEnvSchema {
+}
+declare const ENV: TypedEnvSchema;
+
+export { ENV, type TypedEnvSchema, initVarlockEnv, redactSensitiveConfig, resetRedactionMap, revealSensitiveConfig, scanForLeaks, varlockSettings };

package/dist/runtime/env.js

@@ -1,4 +1,4 @@
-export { ENV, initVarlockEnv, redactSensitiveConfig, resetRedactionMap, revealSensitiveConfig, scanForLeaks, varlockSettings } from '../chunk-2SPIWTVE.js';
+export { ENV, initVarlockEnv, redactSensitiveConfig, resetRedactionMap, revealSensitiveConfig, scanForLeaks, varlockSettings } from '../chunk-2JGPOSVQ.js';
 import '../chunk-FGMXIEFA.js';
 import '../chunk-XN24GZXQ.js';
 //# sourceMappingURL=env.js.map

package/dist/runtime/patch-console.js

@@ -1,5 +1,5 @@
-export { patchGlobalConsole, unpatchGlobalConsole } from '../chunk-C5BEZMSO.js';
-import '../chunk-2SPIWTVE.js';
+export { patchGlobalConsole, unpatchGlobalConsole } from '../chunk-RWBSXJV6.js';
+import '../chunk-2JGPOSVQ.js';
 import '../chunk-FGMXIEFA.js';
 import '../chunk-XN24GZXQ.js';
 //# sourceMappingURL=patch-console.js.map

package/dist/runtime/patch-response.js

@@ -1,5 +1,5 @@
-export { patchGlobalResponse } from '../chunk-OM3JCP4E.js';
-import '../chunk-2SPIWTVE.js';
+export { patchGlobalResponse } from '../chunk-7FI2PPMC.js';
+import '../chunk-2JGPOSVQ.js';
 import '../chunk-FGMXIEFA.js';
 import '../chunk-XN24GZXQ.js';
 //# sourceMappingURL=patch-response.js.map

package/dist/runtime/patch-server-response.js

@@ -1,5 +1,5 @@
-export { patchGlobalServerResponse } from '../chunk-7JMYT62X.js';
-import '../chunk-2SPIWTVE.js';
+export { patchGlobalServerResponse } from '../chunk-WDC67GVB.js';
+import '../chunk-2JGPOSVQ.js';
 import '../chunk-FGMXIEFA.js';
 import '../chunk-XN24GZXQ.js';
 //# sourceMappingURL=patch-server-response.js.map

package/dist/telemetry.command-JIHKG3ZH.js

@@ -0,0 +1,8 @@
+export { commandFn, commandSpec } from './chunk-2VZORH2Y.js';
+import './chunk-IBAUYNXV.js';
+import './chunk-33ROL4J5.js';
+import './chunk-7UWLKQXP.js';
+import './chunk-FGMXIEFA.js';
+import './chunk-XN24GZXQ.js';
+//# sourceMappingURL=telemetry.command-JIHKG3ZH.js.map
+//# sourceMappingURL=telemetry.command-JIHKG3ZH.js.map

package/dist/{telemetry.command-3DVW7H2K.js.map → telemetry.command-JIHKG3ZH.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"telemetry.command-3DVW7H2K.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"telemetry.command-JIHKG3ZH.js"}