@barekey/cli 0.5.9 → 0.6.0

package/dist/commands/init.js

@@ -14,6 +14,7 @@ async function runInit(options) {
         config: {
             mode: "centralized",
             typegen: "semantic",
+            strictGeneratedKeys: false,
         },
     }, null, 2)}\n`;
     await writeFile(configPath, contents, "utf8");

package/dist/commands/typegen.js

@@ -55,6 +55,7 @@ async function resolveTypegenContext(options) {
         environment: target.stageSlug.trim().length > 0 ? target.stageSlug : "local",
         runtimeMode: runtime?.config.config?.mode ?? "centralized",
         typegenMode: runtime?.config.config?.typegen ?? "semantic",
+        strictGeneratedKeys: runtime?.config.config?.strictGeneratedKeys ?? false,
         localEnvRoot: runtime?.path ?? null,
     };
 }
@@ -87,6 +88,7 @@ async function runTypegen(options) {
         projectSlug: context.project,
         stageSlug: context.environment,
         typegenMode: context.typegenMode,
+        strictGeneratedKeys: context.strictGeneratedKeys,
         runtimeMode: context.runtimeMode,
         localEnvRoot: context.localEnvRoot,
     });
@@ -117,6 +119,7 @@ async function runTypegenWatch(options) {
                 projectSlug: nextContext.project,
                 stageSlug: nextContext.environment,
                 typegenMode: nextContext.typegenMode,
+                strictGeneratedKeys: nextContext.strictGeneratedKeys,
                 runtimeMode: nextContext.runtimeMode,
                 localEnvRoot: nextContext.localEnvRoot,
             });

package/dist/contracts/index.d.ts

@@ -13,6 +13,7 @@ export declare const RuntimeConfigSchema: Schema.Struct<{
     typegen: Schema.optional<Schema.NullOr<Schema.Literal<["semantic", "minimal"]>>>;
     config: Schema.optional<Schema.Struct<{
         typegen: Schema.optional<Schema.Literal<["semantic", "minimal"]>>;
+        strictGeneratedKeys: Schema.optional<typeof Schema.Boolean>;
         mode: Schema.optional<Schema.Literal<["centralized", "standalone"]>>;
     }>>;
 }>;

package/dist/contracts/index.js

@@ -15,6 +15,7 @@ export const RuntimeConfigSchema = Schema.Struct({
     typegen: Schema.optional(Schema.NullOr(TypegenModeSchema)),
     config: Schema.optional(Schema.Struct({
         typegen: Schema.optional(TypegenModeSchema),
+        strictGeneratedKeys: Schema.optional(Schema.Boolean),
         mode: Schema.optional(RuntimeModeSchema),
     })),
 });

package/dist/runtime-config.d.ts

@@ -4,6 +4,7 @@ export type BarekeyRuntimeConfig = {
     environment?: string;
     config?: {
         typegen?: "semantic" | "minimal";
+        strictGeneratedKeys?: boolean;
         mode?: "centralized" | "standalone";
     };
 };

package/dist/runtime-config.js

@@ -39,6 +39,7 @@ export async function loadRuntimeConfig() {
     const config = decoded.right.config;
     const mode = config?.mode ?? "centralized";
     const typegen = mode === "standalone" ? "minimal" : (config?.typegen ?? decoded.right.typegen ?? "semantic");
+    const strictGeneratedKeys = config?.strictGeneratedKeys ?? false;
     return {
         path: configPath,
         config: {
@@ -48,6 +49,7 @@ export async function loadRuntimeConfig() {
             config: {
                 mode,
                 typegen,
+                strictGeneratedKeys,
             },
         },
     };

package/dist/typegen/core.d.ts

@@ -1,6 +1,7 @@
 import { type TypegenManifest } from "../contracts/index.js";
 export type CliTypegenMode = "semantic" | "minimal";
 export type CliRuntimeMode = "centralized" | "standalone";
+export type CliStrictGeneratedKeys = boolean;
 export type CliTypegenResult = {
     written: boolean;
     path: string;
@@ -14,6 +15,7 @@ type TypegenIdentity = {
     projectSlug: string;
     stageSlug: string;
     typegenMode: CliTypegenMode;
+    strictGeneratedKeys: CliStrictGeneratedKeys;
     runtimeMode: CliRuntimeMode;
     localEnvRoot: string | null;
 };
@@ -27,7 +29,7 @@ type TypegenIdentity = {
  * @lastModified 2026-03-19
  * @author GPT-5.4
  */
-export declare function renderGeneratedTypesForManifest(manifest: TypegenManifest, mode: CliTypegenMode): {
+export declare function renderGeneratedTypesForManifest(manifest: TypegenManifest, mode: CliTypegenMode, strictGeneratedKeys?: boolean): {
     serverContents: string;
     publicContents: string;
 };

package/dist/typegen/core.js

@@ -12,6 +12,7 @@ const TypegenMetadataSchema = Schema.Struct({
     projectSlug: Schema.NullOr(Schema.String),
     stageSlug: Schema.NullOr(Schema.String),
     typegenMode: Schema.NullOr(Schema.Literal("semantic", "minimal")),
+    strictGeneratedKeys: Schema.Boolean,
     runtimeMode: Schema.NullOr(Schema.Literal("centralized", "standalone")),
     localEnvRoot: Schema.NullOr(Schema.String),
 });
@@ -50,7 +51,7 @@ function buildGeneratedTypesContents(manifest, input) {
     const importLine = input.mode === "semantic"
         ? `import type { EaseInOut, Env, Linear, Step } from "${input.typeModulePath}";\n\n`
         : "";
-    return `/* eslint-disable */\n/* This file is generated by barekey typegen. */\n/* barekey-manifest-version: ${manifest.manifestVersion} */\n\n${importLine}declare module "${input.declaredModulePath}" {\n  interface ${input.interfaceName} {\n${mapLines.length > 0 ? mapLines : ""}\n  }\n}\n\nexport {};\n`;
+    return `/* eslint-disable */\n/* This file is generated by barekey typegen. */\n/* barekey-manifest-version: ${manifest.manifestVersion} */\n\n${importLine}declare module "${input.declaredModulePath}" {\n  interface ${input.interfaceName} {\n${mapLines.length > 0 ? mapLines : ""}\n  }\n\n  interface ${input.configInterfaceName} {\n    allowUnknownKeys: ${input.strictGeneratedKeys ? "false" : "true"};\n  }\n}\n\nexport {};\n`;
 }
 function readManifestVersion(contents) {
     return contents?.match(MANIFEST_VERSION_PATTERN)?.[1]?.trim() ?? null;
@@ -132,6 +133,7 @@ function buildTypegenMetadataContents(lastGeneratedAt, identity) {
         projectSlug: identity.projectSlug,
         stageSlug: identity.stageSlug,
         typegenMode: identity.typegenMode,
+        strictGeneratedKeys: identity.strictGeneratedKeys,
         runtimeMode: identity.runtimeMode,
         localEnvRoot: identity.localEnvRoot,
     }, null, 2)}\n`;
@@ -146,21 +148,25 @@ function buildTypegenMetadataContents(lastGeneratedAt, identity) {
  * @lastModified 2026-03-19
  * @author GPT-5.4
  */
-export function renderGeneratedTypesForManifest(manifest, mode) {
+export function renderGeneratedTypesForManifest(manifest, mode, strictGeneratedKeys = false) {
     const decodedManifest = Schema.decodeUnknownSync(TypegenManifestSchema)(manifest);
     return {
         serverContents: buildGeneratedTypesContents(decodedManifest, {
             mode,
+            strictGeneratedKeys,
             typeModulePath: "./dist/types.js",
             declaredModulePath: "./dist/types.js",
             interfaceName: "BarekeyGeneratedTypeMap",
+            configInterfaceName: "BarekeyGeneratedTypeConfig",
             include: () => true,
         }),
         publicContents: buildGeneratedTypesContents(decodedManifest, {
             mode,
+            strictGeneratedKeys,
             typeModulePath: "./dist/public-types.js",
             declaredModulePath: "./dist/public-types.js",
             interfaceName: "BarekeyPublicGeneratedTypeMap",
+            configInterfaceName: "BarekeyPublicGeneratedTypeConfig",
             include: (row) => row.visibility === "public",
         }),
     };
@@ -190,7 +196,7 @@ export async function writeInstalledSdkGeneratedTypes(manifest, identity) {
         readTextFile(target.serverGeneratedTypesPath),
         readTextFile(target.publicGeneratedTypesPath),
     ]);
-    const rendered = renderGeneratedTypesForManifest(manifest, identity.typegenMode);
+    const rendered = renderGeneratedTypesForManifest(manifest, identity.typegenMode, identity.strictGeneratedKeys);
     if (existingServerContents === rendered.serverContents &&
         existingPublicContents === rendered.publicContents &&
         readManifestVersion(existingServerContents) === manifest.manifestVersion &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barekey/cli",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "description": "Barekey command line interface",
   "type": "module",
   "bin": {

package/src/commands/init.ts

@@ -21,10 +21,11 @@ async function runInit(options: EnvTargetOptions & { path?: string }) {
       organization: orgSlug,
       project: projectSlug,
       environment: stageSlug,
-      config: {
-        mode: "centralized",
-        typegen: "semantic",
-      },
+        config: {
+          mode: "centralized",
+          typegen: "semantic",
+          strictGeneratedKeys: false,
+        },
     },
     null,
     2,

package/src/commands/typegen.ts

@@ -74,6 +74,7 @@ async function resolveTypegenContext(options: EnvTargetOptions): Promise<{
   environment: string;
   runtimeMode: "centralized" | "standalone";
   typegenMode: "semantic" | "minimal";
+  strictGeneratedKeys: boolean;
   localEnvRoot: string | null;
 }> {
   const runtime = await loadRuntimeConfig();
@@ -89,6 +90,7 @@ async function resolveTypegenContext(options: EnvTargetOptions): Promise<{
     environment: target.stageSlug.trim().length > 0 ? target.stageSlug : "local",
     runtimeMode: runtime?.config.config?.mode ?? "centralized",
     typegenMode: runtime?.config.config?.typegen ?? "semantic",
+    strictGeneratedKeys: runtime?.config.config?.strictGeneratedKeys ?? false,
     localEnvRoot: runtime?.path ?? null,
   };
 }
@@ -126,6 +128,7 @@ async function runTypegen(options: EnvTargetOptions): Promise<void> {
     projectSlug: context.project,
     stageSlug: context.environment,
     typegenMode: context.typegenMode,
+    strictGeneratedKeys: context.strictGeneratedKeys,
     runtimeMode: context.runtimeMode,
     localEnvRoot: context.localEnvRoot,
   });
@@ -167,6 +170,7 @@ async function runTypegenWatch(
         projectSlug: nextContext.project,
         stageSlug: nextContext.environment,
         typegenMode: nextContext.typegenMode,
+        strictGeneratedKeys: nextContext.strictGeneratedKeys,
         runtimeMode: nextContext.runtimeMode,
         localEnvRoot: nextContext.localEnvRoot,
       });

package/src/contracts/index.ts

@@ -26,6 +26,7 @@ export const RuntimeConfigSchema = Schema.Struct({
   config: Schema.optional(
     Schema.Struct({
       typegen: Schema.optional(TypegenModeSchema),
+      strictGeneratedKeys: Schema.optional(Schema.Boolean),
       mode: Schema.optional(RuntimeModeSchema),
     }),
   ),

package/src/runtime-config.ts

@@ -10,6 +10,7 @@ export type BarekeyRuntimeConfig = {
   environment?: string;
   config?: {
     typegen?: "semantic" | "minimal";
+    strictGeneratedKeys?: boolean;
     mode?: "centralized" | "standalone";
   };
 };
@@ -61,6 +62,7 @@ export async function loadRuntimeConfig(): Promise<BarekeyRuntimeConfigResult |
   const mode = config?.mode ?? "centralized";
   const typegen =
     mode === "standalone" ? "minimal" : (config?.typegen ?? decoded.right.typegen ?? "semantic");
+  const strictGeneratedKeys = config?.strictGeneratedKeys ?? false;
 
   return {
     path: configPath,
@@ -71,6 +73,7 @@ export async function loadRuntimeConfig(): Promise<BarekeyRuntimeConfigResult |
       config: {
         mode,
         typegen,
+        strictGeneratedKeys,
       },
     },
   };

package/src/typegen/core.ts

@@ -8,6 +8,7 @@ import { TypegenManifestSchema, type TypegenManifest } from "../contracts/index.
 
 export type CliTypegenMode = "semantic" | "minimal";
 export type CliRuntimeMode = "centralized" | "standalone";
+export type CliStrictGeneratedKeys = boolean;
 
 export type CliTypegenResult = {
   written: boolean;
@@ -23,6 +24,7 @@ type TypegenIdentity = {
   projectSlug: string;
   stageSlug: string;
   typegenMode: CliTypegenMode;
+  strictGeneratedKeys: CliStrictGeneratedKeys;
   runtimeMode: CliRuntimeMode;
   localEnvRoot: string | null;
 };
@@ -37,6 +39,7 @@ const TypegenMetadataSchema = Schema.Struct({
   projectSlug: Schema.NullOr(Schema.String),
   stageSlug: Schema.NullOr(Schema.String),
   typegenMode: Schema.NullOr(Schema.Literal("semantic", "minimal")),
+  strictGeneratedKeys: Schema.Boolean,
   runtimeMode: Schema.NullOr(Schema.Literal("centralized", "standalone")),
   localEnvRoot: Schema.NullOr(Schema.String),
 });
@@ -93,9 +96,11 @@ function buildGeneratedTypesContents(
   manifest: TypegenManifest,
   input: {
     mode: CliTypegenMode;
+    strictGeneratedKeys: CliStrictGeneratedKeys;
     typeModulePath: "./dist/types.js" | "./dist/public-types.js";
     declaredModulePath: "./dist/types.js" | "./dist/public-types.js";
     interfaceName: "BarekeyGeneratedTypeMap" | "BarekeyPublicGeneratedTypeMap";
+    configInterfaceName: "BarekeyGeneratedTypeConfig" | "BarekeyPublicGeneratedTypeConfig";
     include: (row: TypegenManifest["variables"][number]) => boolean;
   },
 ): string {
@@ -111,7 +116,7 @@ function buildGeneratedTypesContents(
       ? `import type { EaseInOut, Env, Linear, Step } from "${input.typeModulePath}";\n\n`
       : "";
 
-  return `/* eslint-disable */\n/* This file is generated by barekey typegen. */\n/* barekey-manifest-version: ${manifest.manifestVersion} */\n\n${importLine}declare module "${input.declaredModulePath}" {\n  interface ${input.interfaceName} {\n${mapLines.length > 0 ? mapLines : ""}\n  }\n}\n\nexport {};\n`;
+  return `/* eslint-disable */\n/* This file is generated by barekey typegen. */\n/* barekey-manifest-version: ${manifest.manifestVersion} */\n\n${importLine}declare module "${input.declaredModulePath}" {\n  interface ${input.interfaceName} {\n${mapLines.length > 0 ? mapLines : ""}\n  }\n\n  interface ${input.configInterfaceName} {\n    allowUnknownKeys: ${input.strictGeneratedKeys ? "false" : "true"};\n  }\n}\n\nexport {};\n`;
 }
 
 function readManifestVersion(contents: string | null): string | null {
@@ -197,6 +202,7 @@ function buildTypegenMetadataContents(lastGeneratedAt: Date, identity: TypegenId
       projectSlug: identity.projectSlug,
       stageSlug: identity.stageSlug,
       typegenMode: identity.typegenMode,
+      strictGeneratedKeys: identity.strictGeneratedKeys,
       runtimeMode: identity.runtimeMode,
       localEnvRoot: identity.localEnvRoot,
     },
@@ -218,6 +224,7 @@ function buildTypegenMetadataContents(lastGeneratedAt: Date, identity: TypegenId
 export function renderGeneratedTypesForManifest(
   manifest: TypegenManifest,
   mode: CliTypegenMode,
+  strictGeneratedKeys = false,
 ): {
   serverContents: string;
   publicContents: string;
@@ -227,16 +234,20 @@ export function renderGeneratedTypesForManifest(
   return {
     serverContents: buildGeneratedTypesContents(decodedManifest, {
       mode,
+      strictGeneratedKeys,
       typeModulePath: "./dist/types.js",
       declaredModulePath: "./dist/types.js",
       interfaceName: "BarekeyGeneratedTypeMap",
+      configInterfaceName: "BarekeyGeneratedTypeConfig",
       include: () => true,
     }),
     publicContents: buildGeneratedTypesContents(decodedManifest, {
       mode,
+      strictGeneratedKeys,
       typeModulePath: "./dist/public-types.js",
       declaredModulePath: "./dist/public-types.js",
       interfaceName: "BarekeyPublicGeneratedTypeMap",
+      configInterfaceName: "BarekeyPublicGeneratedTypeConfig",
       include: (row) => row.visibility === "public",
     }),
   };
@@ -271,7 +282,11 @@ export async function writeInstalledSdkGeneratedTypes(
     readTextFile(target.serverGeneratedTypesPath),
     readTextFile(target.publicGeneratedTypesPath),
   ]);
-  const rendered = renderGeneratedTypesForManifest(manifest, identity.typegenMode);
+  const rendered = renderGeneratedTypesForManifest(
+    manifest,
+    identity.typegenMode,
+    identity.strictGeneratedKeys,
+  );
 
   if (
     existingServerContents === rendered.serverContents &&

package/test/runtime-config.test.ts

@@ -86,6 +86,37 @@ describe("loadRuntimeConfig", () => {
           config: {
             mode: "centralized",
             typegen: "semantic",
+            strictGeneratedKeys: false,
+          },
+        },
+      });
+    });
+  });
+
+  test("reads config.strictGeneratedKeys when present", async () => {
+    const tempDir = await createTempDir();
+    await writeFile(
+      path.join(tempDir, "barekey.json"),
+      JSON.stringify(
+        {
+          organization: "acme",
+          project: "api",
+          environment: "development",
+          config: {
+            strictGeneratedKeys: true,
+          },
+        },
+        null,
+        2,
+      ),
+      "utf8",
+    );
+
+    await withWorkingDirectory(tempDir, async () => {
+      await expect(loadRuntimeConfig()).resolves.toMatchObject({
+        config: {
+          config: {
+            strictGeneratedKeys: true,
           },
         },
       });