@kitsy/cnos-webpack 1.5.0 → 1.6.0

package/README.md

@@ -3,3 +3,14 @@
 Webpack integration for CNOS.
 
 It resolves CNOS public config during webpack startup, injects `process.env.*` define replacements for promoted public values, and embeds `globalThis.__CNOS_BROWSER_DATA__` for `@kitsy/cnos/browser`.
+
+Webpack uses an empty public env prefix by default. Configure `public.frameworks.webpack` in your manifest or pass `prefix` to the plugin if you want names such as `APP_*`.
+
+Recommended plugin order:
+- `new CnosWebpackPlugin(...)`
+- `new HtmlWebpackPlugin(...)`
+- `new MiniCssExtractPlugin(...)`
+- `new CopyPlugin(...)`
+- `new ESLintPlugin(...)`
+
+If your webpack config is CommonJS, load CNOS via dynamic `import()` inside an async `module.exports = async () => ...` factory. If webpack loads your config as ESM, `require(...)` is not available.

package/dist/index.d.cts

@@ -12,7 +12,7 @@ interface SchemaRule {
     default?: unknown;
 }
 
-type WorkspaceSource = 'cli' | 'workspace-file' | 'manifest-default' | 'implicit';
+type WorkspaceSource = 'cli' | 'workspace-file' | 'anchor-file' | 'manifest-default' | 'implicit' | 'directory-inferred';
 type GlobalRootSource = 'cli' | 'workspace-file' | 'manifest' | 'CNOS_HOME';
 interface NormalizedWorkspaceItem {
     extends: string[];
@@ -107,6 +107,12 @@ interface NormalizedManifest {
     schema: Record<LogicalKey, SchemaRule>;
 }
 
+interface SecretReference {
+    provider: string;
+    ref: string;
+    vault?: string;
+}
+
 type LogicalKey = string;
 type NamespaceName = string;
 interface ConfigOrigin {
@@ -187,6 +193,25 @@ interface CnosRuntime {
     toNamespace(namespace: NamespaceName): Record<string, unknown>;
     toEnv(options?: ToEnvOptions): Record<string, string>;
     toPublicEnv(options?: ToPublicEnvOptions): Record<string, string>;
+    toServerProjection(): ServerProjection;
+    refreshSecrets(): Promise<void>;
+    refreshSecret(key: LogicalKey): Promise<void>;
+}
+interface ServerProjection {
+    version: 1;
+    workspace: string;
+    profile: string;
+    resolvedAt: string;
+    configHash: string;
+    values: Record<string, unknown>;
+    secretRefs: Record<string, SecretReference>;
+    publicKeys: string[];
+    meta: {
+        workspace: string;
+        profile: string;
+        cnos_version: string;
+        namespaces?: string[];
+    };
 }
 
 type CnosPluginKind = 'loader' | 'resolver' | 'validator' | 'exporter' | 'inspector';

package/dist/index.d.ts

@@ -12,7 +12,7 @@ interface SchemaRule {
     default?: unknown;
 }
 
-type WorkspaceSource = 'cli' | 'workspace-file' | 'manifest-default' | 'implicit';
+type WorkspaceSource = 'cli' | 'workspace-file' | 'anchor-file' | 'manifest-default' | 'implicit' | 'directory-inferred';
 type GlobalRootSource = 'cli' | 'workspace-file' | 'manifest' | 'CNOS_HOME';
 interface NormalizedWorkspaceItem {
     extends: string[];
@@ -107,6 +107,12 @@ interface NormalizedManifest {
     schema: Record<LogicalKey, SchemaRule>;
 }
 
+interface SecretReference {
+    provider: string;
+    ref: string;
+    vault?: string;
+}
+
 type LogicalKey = string;
 type NamespaceName = string;
 interface ConfigOrigin {
@@ -187,6 +193,25 @@ interface CnosRuntime {
     toNamespace(namespace: NamespaceName): Record<string, unknown>;
     toEnv(options?: ToEnvOptions): Record<string, string>;
     toPublicEnv(options?: ToPublicEnvOptions): Record<string, string>;
+    toServerProjection(): ServerProjection;
+    refreshSecrets(): Promise<void>;
+    refreshSecret(key: LogicalKey): Promise<void>;
+}
+interface ServerProjection {
+    version: 1;
+    workspace: string;
+    profile: string;
+    resolvedAt: string;
+    configHash: string;
+    values: Record<string, unknown>;
+    secretRefs: Record<string, SecretReference>;
+    publicKeys: string[];
+    meta: {
+        workspace: string;
+        profile: string;
+        cnos_version: string;
+        namespaces?: string[];
+    };
 }
 
 type CnosPluginKind = 'loader' | 'resolver' | 'validator' | 'exporter' | 'inspector';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitsy/cnos-webpack",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Webpack integration for CNOS public config injection.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -35,7 +35,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@kitsy/cnos": "1.5.0"
+    "@kitsy/cnos": "1.6.0"
   },
   "peerDependencies": {
     "webpack": ">=5"