@kitsy/cnos 1.9.2 → 1.11.0

package/dist/configure/index.d.cts

@@ -1,6 +1,6 @@
-import { R as ResolvedGraph, D as DumpPlanOptions, d as DumpPlan, e as DumpOptions, f as DumpResult, C as CnosCreateOptions, g as CnosRuntime, h as CnosPlugin } from '../core-zDTUSVx9.cjs';
-export { a as ConfigEntry, i as DerivedFormula, j as DerivedValue, k as ExprNode, I as InspectResult, L as LoaderPlugin, b as LogicalKey, M as ManifestFile, N as NormalizedManifest, P as ParsedDerivation, l as RuntimeProvider, T as ToEnvOptions, c as ToPublicEnvOptions } from '../core-zDTUSVx9.cjs';
-export { t as toEnv, a as toPublicEnv } from '../toPublicEnv-Ds1DRwCX.cjs';
+import { R as ResolvedGraph, D as DumpPlanOptions, d as DumpPlan, e as DumpOptions, f as DumpResult, C as CnosCreateOptions, g as CnosRuntime, h as CnosPlugin } from '../core-BW8SLnRx.cjs';
+export { a as ConfigEntry, i as DerivedFormula, j as DerivedValue, k as ExprNode, I as InspectResult, L as LoaderPlugin, b as LogicalKey, M as ManifestFile, N as NormalizedManifest, P as ParsedDerivation, l as RuntimeProvider, T as ToEnvOptions, c as ToPublicEnvOptions } from '../core-BW8SLnRx.cjs';
+export { t as toEnv, a as toPublicEnv } from '../toPublicEnv-CZzpvhGg.cjs';
 
 declare function planDump(graph: ResolvedGraph, options?: DumpPlanOptions): DumpPlan;
 declare function writeDump(graph: ResolvedGraph, options: DumpOptions): Promise<DumpResult>;

package/dist/configure/index.d.ts

@@ -1,6 +1,6 @@
-import { R as ResolvedGraph, D as DumpPlanOptions, d as DumpPlan, e as DumpOptions, f as DumpResult, C as CnosCreateOptions, g as CnosRuntime, h as CnosPlugin } from '../core-zDTUSVx9.js';
-export { a as ConfigEntry, i as DerivedFormula, j as DerivedValue, k as ExprNode, I as InspectResult, L as LoaderPlugin, b as LogicalKey, M as ManifestFile, N as NormalizedManifest, P as ParsedDerivation, l as RuntimeProvider, T as ToEnvOptions, c as ToPublicEnvOptions } from '../core-zDTUSVx9.js';
-export { t as toEnv, a as toPublicEnv } from '../toPublicEnv-CT265rzS.js';
+import { R as ResolvedGraph, D as DumpPlanOptions, d as DumpPlan, e as DumpOptions, f as DumpResult, C as CnosCreateOptions, g as CnosRuntime, h as CnosPlugin } from '../core-BW8SLnRx.js';
+export { a as ConfigEntry, i as DerivedFormula, j as DerivedValue, k as ExprNode, I as InspectResult, L as LoaderPlugin, b as LogicalKey, M as ManifestFile, N as NormalizedManifest, P as ParsedDerivation, l as RuntimeProvider, T as ToEnvOptions, c as ToPublicEnvOptions } from '../core-BW8SLnRx.js';
+export { t as toEnv, a as toPublicEnv } from '../toPublicEnv-CmydGcxg.js';
 
 declare function planDump(graph: ResolvedGraph, options?: DumpPlanOptions): DumpPlan;
 declare function writeDump(graph: ResolvedGraph, options: DumpOptions): Promise<DumpResult>;

package/dist/configure/index.js

@@ -1,19 +1,19 @@
 import {
   createCnos,
   defaultPlugins
-} from "../chunk-CPGRRZLP.js";
-import "../chunk-LURQ4LAK.js";
-import "../chunk-A2WG3ZKW.js";
-import "../chunk-L7JVECPE.js";
-import "../chunk-6QQPHDUI.js";
-import "../chunk-7JZO6XN3.js";
-import "../chunk-2JBA2LXU.js";
+} from "../chunk-NFGPS7VJ.js";
+import "../chunk-5JGNRADB.js";
+import "../chunk-NU25VFA2.js";
+import "../chunk-RNTTPI5S.js";
+import "../chunk-2DMCB3PK.js";
+import "../chunk-KJ57PF47.js";
+import "../chunk-DPC2BV3S.js";
 import {
   planDump,
   toEnv,
   toPublicEnv,
   writeDump
-} from "../chunk-7KVM5PUW.js";
+} from "../chunk-WPB4HB2K.js";
 export {
   createCnos,
   defaultPlugins,

package/dist/{core-zDTUSVx9.d.cts → core-BW8SLnRx.d.cts}

@@ -6,12 +6,19 @@ interface ProfileActivation {
     envFiles: string[];
 }
 
-interface SchemaRule {
-    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+type ConfigSpecValueType = 'string' | 'number' | 'boolean' | 'object' | 'array';
+interface ConfigSpecRule {
+    type?: ConfigSpecValueType;
     required?: boolean;
     enum?: unknown[];
     pattern?: string;
     default?: unknown;
+    summary?: string;
+    description?: string;
+    examples?: unknown[];
+    usedBy?: string[];
+    deprecated?: boolean;
+    deprecationMessage?: string;
 }
 
 type WorkspaceSource = 'cli' | 'workspace-file' | 'anchor-file' | 'manifest-default' | 'implicit' | 'directory-inferred';
@@ -80,6 +87,11 @@ interface VaultAuthDefinition {
     token?: VaultAuthSourceConfig;
     config?: Record<string, unknown>;
 }
+interface VaultFallbackDefinition {
+    provider: VaultProviderName;
+    auth?: VaultAuthDefinition;
+    mapping?: Record<string, string>;
+}
 interface NamespaceDefinition {
     kind: NamespaceKind;
     shareable: boolean;
@@ -91,6 +103,7 @@ interface VaultDefinition {
     provider: VaultProviderName;
     auth?: VaultAuthDefinition;
     mapping?: Record<string, string>;
+    fallback?: VaultFallbackDefinition[];
 }
 interface ManifestFile {
     version?: number;
@@ -143,7 +156,7 @@ interface ManifestFile {
             targets?: Partial<Record<'value' | 'secret', string>>;
         };
     };
-    schema?: Record<LogicalKey, SchemaRule>;
+    schema?: Record<LogicalKey, ConfigSpecRule>;
 }
 interface NormalizedManifest {
     version: 1;
@@ -192,7 +205,7 @@ interface NormalizedManifest {
             targets: Record<'value' | 'secret', string>;
         };
     };
-    schema: Record<LogicalKey, SchemaRule>;
+    schema: Record<LogicalKey, ConfigSpecRule>;
 }
 interface LoadManifestOptions {
     root?: string;
@@ -232,7 +245,7 @@ interface LoaderContext {
 }
 interface ValidationContext {
     manifest: NormalizedManifest;
-    schema?: Record<LogicalKey, SchemaRule>;
+    schema?: Record<LogicalKey, ConfigSpecRule>;
 }
 interface ExportContext {
     manifest: NormalizedManifest;
@@ -273,10 +286,28 @@ interface ExporterPlugin extends CnosPlugin {
 }
 
 interface SecretReference {
-    provider: string;
+    provider?: string;
     ref: string;
     vault?: string;
 }
+/** Auth metadata safe to serialize into server projections. */
+interface ProjectedVaultAuthDefinition {
+    method?: VaultAuthConfig['method'];
+    passphrase?: {
+        from: string[];
+    };
+    token?: {
+        from: string[];
+    };
+    config?: Record<string, unknown>;
+}
+/** Vault metadata required by runtimes to hydrate projected secret refs. */
+interface ProjectedVaultDefinition {
+    provider: string;
+    auth?: ProjectedVaultAuthDefinition;
+    mapping?: Record<string, string>;
+    fallback?: ProjectedVaultDefinition[];
+}
 interface VaultAuthConfig {
     passphrase?: string;
     token?: string;
@@ -295,6 +326,11 @@ interface SecretVaultProvider {
     delete(ref: string): Promise<void>;
     list(): Promise<string[]>;
 }
+/** Factory used by runtimes and provider packages to construct vault clients. */
+interface SecretVaultProviderFactory {
+    readonly provider: string;
+    create(vaultId: string, definition: VaultDefinition, processEnv?: Record<string, string | undefined>): SecretVaultProvider;
+}
 
 type LogicalKey = string;
 type NamespaceName = string;
@@ -406,6 +442,8 @@ interface CnosCreateOptions {
     plugins?: CnosPlugin[];
     cliArgs?: string[];
     processEnv?: Record<string, string | undefined>;
+    /** Additional secret vault provider factories, usually supplied by provider packages. */
+    secretVaultProviders?: SecretVaultProviderFactory[];
 }
 interface ToEnvOptions {
     includeSecrets?: boolean;
@@ -470,6 +508,7 @@ interface ServerProjection {
     secretRefs: Record<string, SecretReference & {
         envVar?: string;
     }>;
+    vaults?: Record<string, ProjectedVaultDefinition>;
     publicKeys: string[];
     runtimeNamespaces: string[];
     meta: {
@@ -480,4 +519,4 @@ interface ServerProjection {
     };
 }
 
-export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ParsedDerivation as P, ResolvedGraph as R, ServerProjection as S, ToEnvOptions as T, ValidatorPlugin as V, WorkspaceRoot as W, ConfigEntry as a, LogicalKey as b, ToPublicEnvOptions as c, DumpPlan as d, DumpOptions as e, DumpResult as f, CnosRuntime as g, CnosPlugin as h, DerivedFormula as i, DerivedValue as j, ExprNode as k, RuntimeProvider as l, NamespaceName as m, LoadManifestOptions as n, LoadedManifest as o, NamespaceDefinition as p, VaultDefinition as q, VaultAuthConfig as r, SecretVaultProvider as s, ResolvedRoot as t, RootResolution as u, SecretReference as v, ValidationSummary as w, ValidationIssue as x, WorkspaceFile as y };
+export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ParsedDerivation as P, ResolvedGraph as R, ServerProjection as S, ToEnvOptions as T, ValidatorPlugin as V, WorkspaceRoot as W, ConfigEntry as a, LogicalKey as b, ToPublicEnvOptions as c, DumpPlan as d, DumpOptions as e, DumpResult as f, CnosRuntime as g, CnosPlugin as h, DerivedFormula as i, DerivedValue as j, ExprNode as k, RuntimeProvider as l, NamespaceName as m, LoadManifestOptions as n, LoadedManifest as o, NamespaceDefinition as p, VaultDefinition as q, VaultAuthConfig as r, SecretVaultProviderFactory as s, SecretVaultProvider as t, ResolvedRoot as u, RootResolution as v, SecretReference as w, ValidationSummary as x, ValidationIssue as y, WorkspaceFile as z };

package/dist/{core-zDTUSVx9.d.ts → core-BW8SLnRx.d.ts}

@@ -6,12 +6,19 @@ interface ProfileActivation {
     envFiles: string[];
 }
 
-interface SchemaRule {
-    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+type ConfigSpecValueType = 'string' | 'number' | 'boolean' | 'object' | 'array';
+interface ConfigSpecRule {
+    type?: ConfigSpecValueType;
     required?: boolean;
     enum?: unknown[];
     pattern?: string;
     default?: unknown;
+    summary?: string;
+    description?: string;
+    examples?: unknown[];
+    usedBy?: string[];
+    deprecated?: boolean;
+    deprecationMessage?: string;
 }
 
 type WorkspaceSource = 'cli' | 'workspace-file' | 'anchor-file' | 'manifest-default' | 'implicit' | 'directory-inferred';
@@ -80,6 +87,11 @@ interface VaultAuthDefinition {
     token?: VaultAuthSourceConfig;
     config?: Record<string, unknown>;
 }
+interface VaultFallbackDefinition {
+    provider: VaultProviderName;
+    auth?: VaultAuthDefinition;
+    mapping?: Record<string, string>;
+}
 interface NamespaceDefinition {
     kind: NamespaceKind;
     shareable: boolean;
@@ -91,6 +103,7 @@ interface VaultDefinition {
     provider: VaultProviderName;
     auth?: VaultAuthDefinition;
     mapping?: Record<string, string>;
+    fallback?: VaultFallbackDefinition[];
 }
 interface ManifestFile {
     version?: number;
@@ -143,7 +156,7 @@ interface ManifestFile {
             targets?: Partial<Record<'value' | 'secret', string>>;
         };
     };
-    schema?: Record<LogicalKey, SchemaRule>;
+    schema?: Record<LogicalKey, ConfigSpecRule>;
 }
 interface NormalizedManifest {
     version: 1;
@@ -192,7 +205,7 @@ interface NormalizedManifest {
             targets: Record<'value' | 'secret', string>;
         };
     };
-    schema: Record<LogicalKey, SchemaRule>;
+    schema: Record<LogicalKey, ConfigSpecRule>;
 }
 interface LoadManifestOptions {
     root?: string;
@@ -232,7 +245,7 @@ interface LoaderContext {
 }
 interface ValidationContext {
     manifest: NormalizedManifest;
-    schema?: Record<LogicalKey, SchemaRule>;
+    schema?: Record<LogicalKey, ConfigSpecRule>;
 }
 interface ExportContext {
     manifest: NormalizedManifest;
@@ -273,10 +286,28 @@ interface ExporterPlugin extends CnosPlugin {
 }
 
 interface SecretReference {
-    provider: string;
+    provider?: string;
     ref: string;
     vault?: string;
 }
+/** Auth metadata safe to serialize into server projections. */
+interface ProjectedVaultAuthDefinition {
+    method?: VaultAuthConfig['method'];
+    passphrase?: {
+        from: string[];
+    };
+    token?: {
+        from: string[];
+    };
+    config?: Record<string, unknown>;
+}
+/** Vault metadata required by runtimes to hydrate projected secret refs. */
+interface ProjectedVaultDefinition {
+    provider: string;
+    auth?: ProjectedVaultAuthDefinition;
+    mapping?: Record<string, string>;
+    fallback?: ProjectedVaultDefinition[];
+}
 interface VaultAuthConfig {
     passphrase?: string;
     token?: string;
@@ -295,6 +326,11 @@ interface SecretVaultProvider {
     delete(ref: string): Promise<void>;
     list(): Promise<string[]>;
 }
+/** Factory used by runtimes and provider packages to construct vault clients. */
+interface SecretVaultProviderFactory {
+    readonly provider: string;
+    create(vaultId: string, definition: VaultDefinition, processEnv?: Record<string, string | undefined>): SecretVaultProvider;
+}
 
 type LogicalKey = string;
 type NamespaceName = string;
@@ -406,6 +442,8 @@ interface CnosCreateOptions {
     plugins?: CnosPlugin[];
     cliArgs?: string[];
     processEnv?: Record<string, string | undefined>;
+    /** Additional secret vault provider factories, usually supplied by provider packages. */
+    secretVaultProviders?: SecretVaultProviderFactory[];
 }
 interface ToEnvOptions {
     includeSecrets?: boolean;
@@ -470,6 +508,7 @@ interface ServerProjection {
     secretRefs: Record<string, SecretReference & {
         envVar?: string;
     }>;
+    vaults?: Record<string, ProjectedVaultDefinition>;
     publicKeys: string[];
     runtimeNamespaces: string[];
     meta: {
@@ -480,4 +519,4 @@ interface ServerProjection {
     };
 }
 
-export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ParsedDerivation as P, ResolvedGraph as R, ServerProjection as S, ToEnvOptions as T, ValidatorPlugin as V, WorkspaceRoot as W, ConfigEntry as a, LogicalKey as b, ToPublicEnvOptions as c, DumpPlan as d, DumpOptions as e, DumpResult as f, CnosRuntime as g, CnosPlugin as h, DerivedFormula as i, DerivedValue as j, ExprNode as k, RuntimeProvider as l, NamespaceName as m, LoadManifestOptions as n, LoadedManifest as o, NamespaceDefinition as p, VaultDefinition as q, VaultAuthConfig as r, SecretVaultProvider as s, ResolvedRoot as t, RootResolution as u, SecretReference as v, ValidationSummary as w, ValidationIssue as x, WorkspaceFile as y };
+export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ParsedDerivation as P, ResolvedGraph as R, ServerProjection as S, ToEnvOptions as T, ValidatorPlugin as V, WorkspaceRoot as W, ConfigEntry as a, LogicalKey as b, ToPublicEnvOptions as c, DumpPlan as d, DumpOptions as e, DumpResult as f, CnosRuntime as g, CnosPlugin as h, DerivedFormula as i, DerivedValue as j, ExprNode as k, RuntimeProvider as l, NamespaceName as m, LoadManifestOptions as n, LoadedManifest as o, NamespaceDefinition as p, VaultDefinition as q, VaultAuthConfig as r, SecretVaultProviderFactory as s, SecretVaultProvider as t, ResolvedRoot as u, RootResolution as v, SecretReference as w, ValidationSummary as x, ValidationIssue as y, WorkspaceFile as z };

package/dist/{envNaming-EFzezmB3.d.cts → envNaming-1rk7BR0e.d.cts}

@@ -1,4 +1,4 @@
-import { N as NormalizedManifest, b as LogicalKey } from './core-zDTUSVx9.cjs';
+import { N as NormalizedManifest, b as LogicalKey } from './core-BW8SLnRx.cjs';
 
 interface EnvMappingConfig {
     convention?: NormalizedManifest['envMapping']['convention'];

package/dist/{envNaming-BkorOKW_.d.ts → envNaming-CjL28IeH.d.ts}

@@ -1,4 +1,4 @@
-import { N as NormalizedManifest, b as LogicalKey } from './core-zDTUSVx9.js';
+import { N as NormalizedManifest, b as LogicalKey } from './core-BW8SLnRx.js';
 
 interface EnvMappingConfig {
     convention?: NormalizedManifest['envMapping']['convention'];