@kitsy/cnos 0.0.1 → 1.0.0

package/dist/plugin/process-env.d.cts

@@ -1 +1,7 @@
-export * from '@kitsy/cnos-plugin-process-env';
+import { L as LoaderPlugin, f as ConfigEntry } from '../plugin-BVNEHj19.cjs';
+import { E as EnvMappingConfig } from '../envNaming-BrOk5ndZ.cjs';
+
+declare function processEnvEntriesFromObject(env: Record<string, string | undefined>, mapping?: EnvMappingConfig, workspaceId?: string): ConfigEntry[];
+declare function createProcessEnvPlugin(): LoaderPlugin;
+
+export { createProcessEnvPlugin, processEnvEntriesFromObject };

package/dist/plugin/process-env.d.ts

@@ -1 +1,7 @@
-export * from '@kitsy/cnos-plugin-process-env';
+import { L as LoaderPlugin, f as ConfigEntry } from '../plugin-BVNEHj19.js';
+import { E as EnvMappingConfig } from '../envNaming-DCaNdnrF.js';
+
+declare function processEnvEntriesFromObject(env: Record<string, string | undefined>, mapping?: EnvMappingConfig, workspaceId?: string): ConfigEntry[];
+declare function createProcessEnvPlugin(): LoaderPlugin;
+
+export { createProcessEnvPlugin, processEnvEntriesFromObject };

package/dist/plugin/process-env.js

@@ -1,2 +1,9 @@
-// src/plugin/process-env.ts
-export * from "@kitsy/cnos-plugin-process-env";
+import {
+  createProcessEnvPlugin,
+  processEnvEntriesFromObject
+} from "../chunk-BSOPGV7G.js";
+import "../chunk-D7AYK7X5.js";
+export {
+  createProcessEnvPlugin,
+  processEnvEntriesFromObject
+};

package/dist/plugin-BVNEHj19.d.cts

@@ -0,0 +1,309 @@
+type ProfileResolveFrom = 'cli.profile' | 'env.CNOS_PROFILE' | 'default';
+type ProfileSource = 'cli' | 'workspace-file' | 'env' | 'manifest-default';
+interface ProfileActivation {
+    values: string[];
+    secrets: string[];
+    envFiles: string[];
+}
+
+interface SchemaRule {
+    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required?: boolean;
+    enum?: unknown[];
+    pattern?: string;
+    default?: unknown;
+}
+
+type WorkspaceSource = 'cli' | 'workspace-file' | 'manifest-default' | 'implicit';
+type GlobalRootSource = 'cli' | 'workspace-file' | 'manifest' | 'CNOS_HOME';
+interface WorkspaceFile {
+    workspace?: string;
+    profile?: string;
+    globalRoot?: string;
+}
+interface WorkspaceItemConfig {
+    extends?: string | string[];
+    globalId?: string;
+}
+interface NormalizedWorkspaceItem {
+    extends: string[];
+    globalId?: string;
+}
+interface WorkspaceRoot {
+    scope: 'global' | 'local';
+    workspaceId: string;
+    path: string;
+}
+interface WorkspaceContext {
+    workspaceId: string;
+    workspaceSource: WorkspaceSource;
+    globalRoot?: string;
+    globalRootSource?: GlobalRootSource;
+    workspaceChain: string[];
+    workspaceRoots: WorkspaceRoot[];
+}
+
+type ResolutionArrayPolicy = 'replace' | 'append' | 'unique-append';
+interface ManifestFile {
+    version?: number;
+    project?: {
+        name?: string;
+    };
+    workspaces?: {
+        default?: string;
+        global?: {
+            enabled?: boolean;
+            root?: string;
+            allowWrite?: boolean;
+        };
+        items?: Record<string, WorkspaceItemConfig>;
+    };
+    profiles?: {
+        default?: string;
+        resolveFrom?: ProfileResolveFrom[];
+    };
+    plugins?: {
+        loaders?: string[];
+        resolver?: string;
+        validators?: string[];
+        exporters?: string[];
+        inspectors?: string[];
+    };
+    sources?: Record<string, Record<string, unknown>>;
+    resolution?: {
+        precedence?: string[];
+        arrayPolicy?: ResolutionArrayPolicy;
+    };
+    envMapping?: {
+        convention?: 'SCREAMING_SNAKE';
+        explicit?: Record<string, LogicalKey>;
+    };
+    public?: {
+        promote?: LogicalKey[];
+        frameworks?: Record<string, string>;
+    };
+    writePolicy?: {
+        define?: {
+            defaultProfile?: string;
+            targets?: Partial<Record<'value' | 'secret', string>>;
+        };
+    };
+    schema?: Record<LogicalKey, SchemaRule>;
+}
+interface NormalizedManifest {
+    version: 1;
+    project: {
+        name: string;
+    };
+    workspaces: {
+        default?: string;
+        global: {
+            enabled: boolean;
+            root?: string;
+            allowWrite: boolean;
+        };
+        items: Record<string, NormalizedWorkspaceItem>;
+    };
+    profiles: {
+        default: string;
+        resolveFrom: ProfileResolveFrom[];
+    };
+    plugins: {
+        loaders: string[];
+        resolver: string;
+        validators: string[];
+        exporters: string[];
+        inspectors: string[];
+    };
+    sources: Record<string, Record<string, unknown>>;
+    resolution: {
+        precedence: string[];
+        arrayPolicy: ResolutionArrayPolicy;
+    };
+    envMapping: {
+        convention?: 'SCREAMING_SNAKE';
+        explicit: Record<string, LogicalKey>;
+    };
+    public: {
+        promote: LogicalKey[];
+        frameworks: Record<string, string>;
+    };
+    writePolicy: {
+        define: {
+            defaultProfile: string;
+            targets: Record<'value' | 'secret', string>;
+        };
+    };
+    schema: Record<LogicalKey, SchemaRule>;
+}
+
+type LogicalKey = string;
+type NamespaceName = 'value' | 'secret' | 'meta';
+interface ConfigOrigin {
+    file?: string;
+    line?: number;
+    envVar?: string;
+    cliArg?: string;
+}
+interface ConfigEntry {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    sourceId: string;
+    pluginId: string;
+    workspaceId: string;
+    profile?: string;
+    origin?: ConfigOrigin;
+    metadata?: Record<string, unknown>;
+}
+interface ResolvedEntry {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    winner: ConfigEntry;
+    overridden: ConfigEntry[];
+}
+interface ResolvedGraph {
+    entries: Map<LogicalKey, ResolvedEntry>;
+    profile: string;
+    resolvedAt: string;
+    profileSource: ProfileSource;
+    workspace: WorkspaceContext;
+}
+interface InspectResult {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    profile: string;
+    profileSource: ProfileSource;
+    workspace: {
+        id: string;
+        source: WorkspaceContext['workspaceSource'];
+        chain: string[];
+    };
+    winner: {
+        sourceId: string;
+        pluginId: string;
+        workspaceId: string;
+        origin?: ConfigOrigin;
+    };
+    overridden: Array<{
+        sourceId: string;
+        pluginId: string;
+        workspaceId: string;
+        value: unknown;
+        origin?: ConfigOrigin;
+    }>;
+}
+interface CnosCreateOptions {
+    root?: string;
+    profile?: string;
+    workspace?: string;
+    globalRoot?: string;
+    cnosVersion?: string;
+    plugins?: CnosPlugin[];
+    cliArgs?: string[];
+    processEnv?: Record<string, string | undefined>;
+}
+interface ToEnvOptions {
+    includeSecrets?: boolean;
+}
+interface ToPublicEnvOptions {
+    framework?: string;
+    prefix?: string;
+}
+interface DumpPlanOptions {
+    flatten?: boolean;
+}
+interface DumpFile {
+    path: string;
+    namespace: Exclude<NamespaceName, 'meta'>;
+    content: string;
+}
+interface DumpPlan {
+    workspaceId: string;
+    profile: string;
+    flatten: boolean;
+    files: DumpFile[];
+}
+interface DumpOptions extends DumpPlanOptions {
+    to: string;
+}
+interface DumpResult extends DumpPlan {
+    root: string;
+}
+interface CnosRuntime {
+    manifest: NormalizedManifest;
+    plugins: CnosPlugin[];
+    readonly graph: ResolvedGraph;
+    read<T = unknown>(key: LogicalKey): T | undefined;
+    require<T = unknown>(key: LogicalKey): T;
+    readOr<T>(key: LogicalKey, fallback: T): T;
+    value<T = unknown>(path: string): T | undefined;
+    secret<T = unknown>(path: string): T | undefined;
+    meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): InspectResult;
+    toObject(): Record<string, unknown>;
+    toNamespace(namespace: NamespaceName): Record<string, unknown>;
+    toEnv(options?: ToEnvOptions): Record<string, string>;
+    toPublicEnv(options?: ToPublicEnvOptions): Record<string, string>;
+}
+
+type CnosPluginKind = 'loader' | 'resolver' | 'validator' | 'exporter' | 'inspector';
+interface CnosPlugin {
+    id: string;
+    kind: CnosPluginKind;
+}
+interface LoaderContext {
+    manifestConfig: Record<string, unknown>;
+    profile: string;
+    profileChain: string[];
+    profileActivation: ProfileActivation;
+    manifestRoot: string;
+    workspace: WorkspaceContext;
+    cliArgs?: string[];
+    processEnv?: Record<string, string | undefined>;
+}
+interface ValidationContext {
+    manifest: NormalizedManifest;
+    schema?: Record<LogicalKey, SchemaRule>;
+}
+interface ExportContext {
+    manifest: NormalizedManifest;
+    promotions: string[];
+    frameworkPrefixes?: string[];
+    workspace: WorkspaceContext;
+}
+interface LoaderPlugin extends CnosPlugin {
+    kind: 'loader';
+    load(context: LoaderContext): Promise<ConfigEntry[]>;
+}
+interface ValidationIssue {
+    code: string;
+    message: string;
+    key?: LogicalKey;
+}
+interface ValidationResult {
+    pluginId: string;
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+interface ValidationSummary {
+    valid: boolean;
+    issues: ValidationIssue[];
+    results: ValidationResult[];
+}
+interface ValidatorPlugin extends CnosPlugin {
+    kind: 'validator';
+    validate(graph: ResolvedGraph, context: ValidationContext): Promise<ValidationResult>;
+}
+interface ExportResult {
+    pluginId: string;
+    value: Record<string, string>;
+}
+interface ExporterPlugin extends CnosPlugin {
+    kind: 'exporter';
+    export(graph: ResolvedGraph, context: ExportContext): Promise<ExportResult>;
+}
+
+export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ResolvedGraph as R, ToEnvOptions as T, ValidationSummary as V, WorkspaceFile as W, DumpPlan as a, DumpOptions as b, DumpResult as c, CnosRuntime as d, CnosPlugin as e, ConfigEntry as f, LogicalKey as g, ToPublicEnvOptions as h, ValidationIssue as i, ValidatorPlugin as j, WorkspaceRoot as k, NamespaceName as l };

package/dist/plugin-BVNEHj19.d.ts

@@ -0,0 +1,309 @@
+type ProfileResolveFrom = 'cli.profile' | 'env.CNOS_PROFILE' | 'default';
+type ProfileSource = 'cli' | 'workspace-file' | 'env' | 'manifest-default';
+interface ProfileActivation {
+    values: string[];
+    secrets: string[];
+    envFiles: string[];
+}
+
+interface SchemaRule {
+    type?: 'string' | 'number' | 'boolean' | 'object' | 'array';
+    required?: boolean;
+    enum?: unknown[];
+    pattern?: string;
+    default?: unknown;
+}
+
+type WorkspaceSource = 'cli' | 'workspace-file' | 'manifest-default' | 'implicit';
+type GlobalRootSource = 'cli' | 'workspace-file' | 'manifest' | 'CNOS_HOME';
+interface WorkspaceFile {
+    workspace?: string;
+    profile?: string;
+    globalRoot?: string;
+}
+interface WorkspaceItemConfig {
+    extends?: string | string[];
+    globalId?: string;
+}
+interface NormalizedWorkspaceItem {
+    extends: string[];
+    globalId?: string;
+}
+interface WorkspaceRoot {
+    scope: 'global' | 'local';
+    workspaceId: string;
+    path: string;
+}
+interface WorkspaceContext {
+    workspaceId: string;
+    workspaceSource: WorkspaceSource;
+    globalRoot?: string;
+    globalRootSource?: GlobalRootSource;
+    workspaceChain: string[];
+    workspaceRoots: WorkspaceRoot[];
+}
+
+type ResolutionArrayPolicy = 'replace' | 'append' | 'unique-append';
+interface ManifestFile {
+    version?: number;
+    project?: {
+        name?: string;
+    };
+    workspaces?: {
+        default?: string;
+        global?: {
+            enabled?: boolean;
+            root?: string;
+            allowWrite?: boolean;
+        };
+        items?: Record<string, WorkspaceItemConfig>;
+    };
+    profiles?: {
+        default?: string;
+        resolveFrom?: ProfileResolveFrom[];
+    };
+    plugins?: {
+        loaders?: string[];
+        resolver?: string;
+        validators?: string[];
+        exporters?: string[];
+        inspectors?: string[];
+    };
+    sources?: Record<string, Record<string, unknown>>;
+    resolution?: {
+        precedence?: string[];
+        arrayPolicy?: ResolutionArrayPolicy;
+    };
+    envMapping?: {
+        convention?: 'SCREAMING_SNAKE';
+        explicit?: Record<string, LogicalKey>;
+    };
+    public?: {
+        promote?: LogicalKey[];
+        frameworks?: Record<string, string>;
+    };
+    writePolicy?: {
+        define?: {
+            defaultProfile?: string;
+            targets?: Partial<Record<'value' | 'secret', string>>;
+        };
+    };
+    schema?: Record<LogicalKey, SchemaRule>;
+}
+interface NormalizedManifest {
+    version: 1;
+    project: {
+        name: string;
+    };
+    workspaces: {
+        default?: string;
+        global: {
+            enabled: boolean;
+            root?: string;
+            allowWrite: boolean;
+        };
+        items: Record<string, NormalizedWorkspaceItem>;
+    };
+    profiles: {
+        default: string;
+        resolveFrom: ProfileResolveFrom[];
+    };
+    plugins: {
+        loaders: string[];
+        resolver: string;
+        validators: string[];
+        exporters: string[];
+        inspectors: string[];
+    };
+    sources: Record<string, Record<string, unknown>>;
+    resolution: {
+        precedence: string[];
+        arrayPolicy: ResolutionArrayPolicy;
+    };
+    envMapping: {
+        convention?: 'SCREAMING_SNAKE';
+        explicit: Record<string, LogicalKey>;
+    };
+    public: {
+        promote: LogicalKey[];
+        frameworks: Record<string, string>;
+    };
+    writePolicy: {
+        define: {
+            defaultProfile: string;
+            targets: Record<'value' | 'secret', string>;
+        };
+    };
+    schema: Record<LogicalKey, SchemaRule>;
+}
+
+type LogicalKey = string;
+type NamespaceName = 'value' | 'secret' | 'meta';
+interface ConfigOrigin {
+    file?: string;
+    line?: number;
+    envVar?: string;
+    cliArg?: string;
+}
+interface ConfigEntry {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    sourceId: string;
+    pluginId: string;
+    workspaceId: string;
+    profile?: string;
+    origin?: ConfigOrigin;
+    metadata?: Record<string, unknown>;
+}
+interface ResolvedEntry {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    winner: ConfigEntry;
+    overridden: ConfigEntry[];
+}
+interface ResolvedGraph {
+    entries: Map<LogicalKey, ResolvedEntry>;
+    profile: string;
+    resolvedAt: string;
+    profileSource: ProfileSource;
+    workspace: WorkspaceContext;
+}
+interface InspectResult {
+    key: LogicalKey;
+    value: unknown;
+    namespace: NamespaceName;
+    profile: string;
+    profileSource: ProfileSource;
+    workspace: {
+        id: string;
+        source: WorkspaceContext['workspaceSource'];
+        chain: string[];
+    };
+    winner: {
+        sourceId: string;
+        pluginId: string;
+        workspaceId: string;
+        origin?: ConfigOrigin;
+    };
+    overridden: Array<{
+        sourceId: string;
+        pluginId: string;
+        workspaceId: string;
+        value: unknown;
+        origin?: ConfigOrigin;
+    }>;
+}
+interface CnosCreateOptions {
+    root?: string;
+    profile?: string;
+    workspace?: string;
+    globalRoot?: string;
+    cnosVersion?: string;
+    plugins?: CnosPlugin[];
+    cliArgs?: string[];
+    processEnv?: Record<string, string | undefined>;
+}
+interface ToEnvOptions {
+    includeSecrets?: boolean;
+}
+interface ToPublicEnvOptions {
+    framework?: string;
+    prefix?: string;
+}
+interface DumpPlanOptions {
+    flatten?: boolean;
+}
+interface DumpFile {
+    path: string;
+    namespace: Exclude<NamespaceName, 'meta'>;
+    content: string;
+}
+interface DumpPlan {
+    workspaceId: string;
+    profile: string;
+    flatten: boolean;
+    files: DumpFile[];
+}
+interface DumpOptions extends DumpPlanOptions {
+    to: string;
+}
+interface DumpResult extends DumpPlan {
+    root: string;
+}
+interface CnosRuntime {
+    manifest: NormalizedManifest;
+    plugins: CnosPlugin[];
+    readonly graph: ResolvedGraph;
+    read<T = unknown>(key: LogicalKey): T | undefined;
+    require<T = unknown>(key: LogicalKey): T;
+    readOr<T>(key: LogicalKey, fallback: T): T;
+    value<T = unknown>(path: string): T | undefined;
+    secret<T = unknown>(path: string): T | undefined;
+    meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): InspectResult;
+    toObject(): Record<string, unknown>;
+    toNamespace(namespace: NamespaceName): Record<string, unknown>;
+    toEnv(options?: ToEnvOptions): Record<string, string>;
+    toPublicEnv(options?: ToPublicEnvOptions): Record<string, string>;
+}
+
+type CnosPluginKind = 'loader' | 'resolver' | 'validator' | 'exporter' | 'inspector';
+interface CnosPlugin {
+    id: string;
+    kind: CnosPluginKind;
+}
+interface LoaderContext {
+    manifestConfig: Record<string, unknown>;
+    profile: string;
+    profileChain: string[];
+    profileActivation: ProfileActivation;
+    manifestRoot: string;
+    workspace: WorkspaceContext;
+    cliArgs?: string[];
+    processEnv?: Record<string, string | undefined>;
+}
+interface ValidationContext {
+    manifest: NormalizedManifest;
+    schema?: Record<LogicalKey, SchemaRule>;
+}
+interface ExportContext {
+    manifest: NormalizedManifest;
+    promotions: string[];
+    frameworkPrefixes?: string[];
+    workspace: WorkspaceContext;
+}
+interface LoaderPlugin extends CnosPlugin {
+    kind: 'loader';
+    load(context: LoaderContext): Promise<ConfigEntry[]>;
+}
+interface ValidationIssue {
+    code: string;
+    message: string;
+    key?: LogicalKey;
+}
+interface ValidationResult {
+    pluginId: string;
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+interface ValidationSummary {
+    valid: boolean;
+    issues: ValidationIssue[];
+    results: ValidationResult[];
+}
+interface ValidatorPlugin extends CnosPlugin {
+    kind: 'validator';
+    validate(graph: ResolvedGraph, context: ValidationContext): Promise<ValidationResult>;
+}
+interface ExportResult {
+    pluginId: string;
+    value: Record<string, string>;
+}
+interface ExporterPlugin extends CnosPlugin {
+    kind: 'exporter';
+    export(graph: ResolvedGraph, context: ExportContext): Promise<ExportResult>;
+}
+
+export type { CnosCreateOptions as C, DumpPlanOptions as D, ExporterPlugin as E, InspectResult as I, LoaderPlugin as L, ManifestFile as M, NormalizedManifest as N, ResolvedGraph as R, ToEnvOptions as T, ValidationSummary as V, WorkspaceFile as W, DumpPlan as a, DumpOptions as b, DumpResult as c, CnosRuntime as d, CnosPlugin as e, ConfigEntry as f, LogicalKey as g, ToPublicEnvOptions as h, ValidationIssue as i, ValidatorPlugin as j, WorkspaceRoot as k, NamespaceName as l };

package/dist/toPublicEnv-Dd152fFy.d.cts

@@ -0,0 +1,7 @@
+import { R as ResolvedGraph, N as NormalizedManifest, T as ToEnvOptions, h as ToPublicEnvOptions } from './plugin-BVNEHj19.cjs';
+
+declare function toEnv(graph: ResolvedGraph, manifest: NormalizedManifest, options?: ToEnvOptions): Record<string, string>;
+
+declare function toPublicEnv(graph: ResolvedGraph, manifest: NormalizedManifest, options?: ToPublicEnvOptions): Record<string, string>;
+
+export { toPublicEnv as a, toEnv as t };

package/dist/toPublicEnv-Gwz3xTK0.d.ts

@@ -0,0 +1,7 @@
+import { R as ResolvedGraph, N as NormalizedManifest, T as ToEnvOptions, h as ToPublicEnvOptions } from './plugin-BVNEHj19.js';
+
+declare function toEnv(graph: ResolvedGraph, manifest: NormalizedManifest, options?: ToEnvOptions): Record<string, string>;
+
+declare function toPublicEnv(graph: ResolvedGraph, manifest: NormalizedManifest, options?: ToPublicEnvOptions): Record<string, string>;
+
+export { toPublicEnv as a, toEnv as t };