@hexclave/shared 1.0.53 → 1.0.55

package/dist/esm/config/schema.d.ts

@@ -83,7 +83,7 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
   sourceOfTruth: {
     type: "hosted";
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -186,9 +186,6 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -201,6 +198,9 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
     }>;
   };
   domains: {};
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
   dataVault: {
     stores: Record<string, {
       displayName?: string | undefined;
@@ -211,7 +211,7 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
   project: {
     requirePublishableClientKey: undefined;
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -283,7 +283,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
   sourceOfTruth: {
     type: "hosted";
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -386,9 +386,6 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -401,6 +398,9 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     }>;
   };
   domains: {};
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
   dataVault: {
     stores: Record<string, {
       displayName?: string | undefined;
@@ -565,7 +565,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
   project: {
     requirePublishableClientKey: undefined;
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -635,7 +635,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -705,7 +705,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
       project: {
         requirePublishableClientKey: undefined;
       };
-    }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+    }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
       rbac: {
         permissions: undefined;
         defaultPermissions: {
@@ -778,7 +778,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -861,7 +861,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -934,7 +934,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1016,7 +1016,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
   sourceOfTruth: {
     type: "hosted";
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -1119,9 +1119,6 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -1134,6 +1131,9 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     }>;
   };
   domains: {};
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
   dataVault: {
     stores: Record<string, {
       displayName?: string | undefined;
@@ -1298,7 +1298,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
   project: {
     requirePublishableClientKey: undefined;
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -1368,7 +1368,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1438,7 +1438,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
       project: {
         requirePublishableClientKey: undefined;
       };
-    }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+    }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
       rbac: {
         permissions: undefined;
         defaultPermissions: {
@@ -1511,7 +1511,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1594,7 +1594,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1667,7 +1667,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     project: {
       requirePublishableClientKey: undefined;
     };
-  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dataVault"> & {
+  }, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "users" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -2187,9 +2187,6 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
       };
     };
   };
-  users: {
-    allowClientUserDeletion: boolean;
-  };
   apiKeys: {
     enabled: {
       team: boolean;
@@ -2205,6 +2202,9 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
       };
     };
   };
+  users: {
+    allowClientUserDeletion: boolean;
+  };
   dataVault: {
     stores: {
       [x: string]: {

package/dist/esm/config/schema.js

@@ -1,9 +1,9 @@
 import * as yup$1 from "yup";
+import { stringCompare } from "../utils/strings.js";
 import { HexclaveAssertionError } from "../utils/errors.js";
 import { filterUndefined, get, getOrUndefined, has, isObjectLike, mapValues, set, typedAssign, typedEntries, typedFromEntries } from "../utils/objects.js";
 import { ALL_APPS } from "../apps/apps-config.js";
 import { SUPPORTED_CURRENCIES } from "../utils/currency-constants.js";
-import { stringCompare } from "../utils/strings.js";
 import { NormalizationError, assertNormalized, getInvalidConfigReason, normalize } from "./format.js";
 import { DEFAULT_EMAIL_TEMPLATES, DEFAULT_EMAIL_THEMES, DEFAULT_EMAIL_THEME_ID } from "../helpers/emails.js";
 import * as schemaFields from "../schema-fields.js";

package/dist/esm/config-rendering.d.ts

@@ -1,4 +1,12 @@
 //#region src/config-rendering.d.ts
+/**
+ * Packages that export the `HexclaveConfig` type, in priority order.
+ * The first match found in a project's dependencies wins. Hexclave-branded
+ * packages come first (canonical); the legacy `@stackframe/*` names remain
+ * so projects pinned to the last legacy release still render a config file
+ * that compiles against their installed SDK.
+ */
+declare const CONFIG_IMPORT_PACKAGES: readonly ["@hexclave/next", "@hexclave/react", "@hexclave/tanstack-start", "@hexclave/js", "@hexclave/template", "@stackframe/stack", "@stackframe/react", "@stackframe/js", "@stackframe/template"];
 /**
  * Given a list of dependency names (from package.json), returns the SDK
  * package that should be used for the `HexclaveConfig` import, or `undefined`
@@ -10,5 +18,5 @@ declare function detectConfigImportPackage(dependencies: string[]): string | und
  */
 declare function renderConfigFileContent(config: unknown, importPackage?: string): string;
 //#endregion
-export { detectConfigImportPackage, renderConfigFileContent };
+export { CONFIG_IMPORT_PACKAGES, detectConfigImportPackage, renderConfigFileContent };
 //# sourceMappingURL=config-rendering.d.ts.map

package/dist/esm/config-rendering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-rendering.d.ts","names":[],"sources":["../../src/config-rendering.ts"],"mappings":";;AA4BA;;;;iBAAgB,yBAAA,CAA0B,YAAsB;AAYhE;;;AAAA,iBAAgB,uBAAA,CAAwB,MAAA,WAAiB,aAAsB"}
+{"version":3,"file":"config-rendering.d.ts","names":[],"sources":["../../src/config-rendering.ts"],"mappings":";;AAWA;;;;AAUU;AAOV;cAjBa,sBAAA;;;AAiBmD;AAYhE;;iBAZgB,yBAAA,CAA0B,YAAsB;;AAYe;;iBAA/D,uBAAA,CAAwB,MAAA,WAAiB,aAAsB"}

package/dist/esm/config-rendering.js

@@ -39,10 +39,9 @@ function renderConfigFileContent(config, importPackage) {
 		droppedKeys
 	});
 	if (droppedKeys.length > 0) throw new Error(`Config has conflicting keys that would be dropped during normalization: ${droppedKeys.map((k) => JSON.stringify(k)).join(", ")}`);
-	const pkg = importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE;
-	return `${`import type { HexclaveConfig } from "${pkg.startsWith("@hexclave/") ? `${pkg}/config` : pkg}";`}\n\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\n`;
+	return `${`import type { HexclaveConfig } from "${importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE}";`}\n\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\n`;
 }
 //#endregion
-export { detectConfigImportPackage, renderConfigFileContent };
+export { CONFIG_IMPORT_PACKAGES, detectConfigImportPackage, renderConfigFileContent };
 
 //# sourceMappingURL=config-rendering.js.map

package/dist/esm/config-rendering.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-rendering.js","names":[],"sources":["../../src/config-rendering.ts"],"sourcesContent":["import { isValidConfig, normalize } from \"./config/format\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Packages that export the `HexclaveConfig` type, in priority order.\n * The first match found in a project's dependencies wins. Hexclave-branded\n * packages come first (canonical); the legacy `@stackframe/*` names remain\n * so projects pinned to the last legacy release still render a config file\n * that compiles against their installed SDK.\n */\nconst CONFIG_IMPORT_PACKAGES = [\n  \"@hexclave/next\",\n  \"@hexclave/react\",\n  \"@hexclave/tanstack-start\",\n  \"@hexclave/js\",\n  \"@hexclave/template\",\n  \"@stackframe/stack\",\n  \"@stackframe/react\",\n  \"@stackframe/js\",\n  \"@stackframe/template\",\n] as const;\n\n/**\n * Given a list of dependency names (from package.json), returns the SDK\n * package that should be used for the `HexclaveConfig` import, or `undefined`\n * if none of the known packages are installed.\n */\nexport function detectConfigImportPackage(dependencies: string[]): string | undefined {\n  for (const pkg of CONFIG_IMPORT_PACKAGES) {\n    if (dependencies.includes(pkg)) {\n      return pkg;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n */\nexport function renderConfigFileContent(config: unknown, importPackage?: string): string {\n  if (!isValidConfig(config)) {\n    throw new Error(\"Invalid config: expected a plain object.\");\n  }\n\n  const droppedKeys: string[] = [];\n  const normalizedConfig = normalize(config, {\n    onDotIntoNonObject: \"ignore\",\n    onDotIntoNull: \"empty-object\",\n    droppedKeys,\n  });\n  if (droppedKeys.length > 0) {\n    throw new Error(`Config has conflicting keys that would be dropped during normalization: ${droppedKeys.map(k => JSON.stringify(k)).join(\", \")}`);\n  }\n  const pkg = importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE;\n  const importSpecifier = pkg.startsWith(\"@hexclave/\") ? `${pkg}/config` : pkg;\n  const importLine = `import type { HexclaveConfig } from \"${importSpecifier}\";`;\n  return `${importLine}\\n\\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\\n`;\n}\n\n// --- inline vitest tests ---\n\nimport.meta.vitest?.test(\"renderConfigFileContent normalizes config exports\", ({ expect }) => {\n  expect(renderConfigFileContent({\n    \"payments.items.todos.displayName\": \"Todo Slots\",\n    \"payments.items.todos.customerType\": \"user\",\n  })).toContain(`export const config: HexclaveConfig = {\n  \"payments\": {\n    \"items\": {\n      \"todos\": {\n        \"displayName\": \"Todo Slots\",\n        \"customerType\": \"user\"\n      }\n    }\n  }\n};`);\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent rejects conflicting dotted keys\", ({ expect }) => {\n  expect(() => renderConfigFileContent({\n    \"a.b\": 1,\n    \"a.b.c\": 2,\n  })).toThrowError(/conflicting keys.*\"a\\.b\\.c\"/);\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent rejects invalid config exports\", ({ expect }) => {\n  expect(() => renderConfigFileContent(null)).toThrowErrorMatchingInlineSnapshot(\n    `[Error: Invalid config: expected a plain object.]`,\n  );\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent uses custom import package\", ({ expect }) => {\n  const content = renderConfigFileContent({}, \"@hexclave/next\");\n  expect(content).toContain('import type { HexclaveConfig } from \"@hexclave/next/config\";');\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent defaults to @hexclave/js\", ({ expect }) => {\n  const content = renderConfigFileContent({});\n  expect(content).toContain('import type { HexclaveConfig } from \"@hexclave/js/config\";');\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent keeps legacy @stackframe packages on their root entrypoint\", ({ expect }) => {\n  const content = renderConfigFileContent({}, \"@stackframe/next\");\n  expect(content).toContain('import type { HexclaveConfig } from \"@stackframe/next\";');\n});\n\nimport.meta.vitest?.test(\"detectConfigImportPackage picks first matching package by priority\", ({ expect }) => {\n  expect(detectConfigImportPackage([\"@hexclave/next\", \"@hexclave/js\"])).toBe(\"@hexclave/next\");\n  expect(detectConfigImportPackage([\"@hexclave/react\", \"@hexclave/js\"])).toBe(\"@hexclave/react\");\n  expect(detectConfigImportPackage([\"@hexclave/js\"])).toBe(\"@hexclave/js\");\n  expect(detectConfigImportPackage([\"@hexclave/tanstack-start\"])).toBe(\"@hexclave/tanstack-start\");\n  expect(detectConfigImportPackage([\"@stackframe/stack\", \"@hexclave/next\"])).toBe(\"@hexclave/next\");\n  expect(detectConfigImportPackage([\"@stackframe/stack\"])).toBe(\"@stackframe/stack\");\n  expect(detectConfigImportPackage([\"@stackframe/template\"])).toBe(\"@stackframe/template\");\n  expect(detectConfigImportPackage([\"lodash\", \"express\"])).toBeUndefined();\n  expect(detectConfigImportPackage([])).toBeUndefined();\n});\n"],"mappings":";;AAEA,MAAM,gCAAgC;;;;;;;;AAStC,MAAM,yBAAyB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,SAAgB,0BAA0B,cAA4C;CACpF,KAAK,MAAM,OAAO,wBAChB,IAAI,aAAa,SAAS,GAAG,GAC3B,OAAO;AAIb;;;;AAKA,SAAgB,wBAAwB,QAAiB,eAAgC;CACvF,IAAI,CAAC,cAAc,MAAM,GACvB,MAAM,IAAI,MAAM,0CAA0C;CAG5D,MAAM,cAAwB,CAAC;CAC/B,MAAM,mBAAmB,UAAU,QAAQ;EACzC,oBAAoB;EACpB,eAAe;EACf;CACF,CAAC;CACD,IAAI,YAAY,SAAS,GACvB,MAAM,IAAI,MAAM,2EAA2E,YAAY,KAAI,MAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG;CAEjJ,MAAM,MAAM,iBAAiB;CAG7B,OAAO,GAAG,wCAFc,IAAI,WAAW,YAAY,IAAI,GAAG,IAAI,WAAW,IACE,IACtD,4CAA4C,KAAK,UAAU,kBAAkB,MAAM,CAAC,EAAE;AAC7G"}
+{"version":3,"file":"config-rendering.js","names":[],"sources":["../../src/config-rendering.ts"],"sourcesContent":["import { isValidConfig, normalize } from \"./config/format\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Packages that export the `HexclaveConfig` type, in priority order.\n * The first match found in a project's dependencies wins. Hexclave-branded\n * packages come first (canonical); the legacy `@stackframe/*` names remain\n * so projects pinned to the last legacy release still render a config file\n * that compiles against their installed SDK.\n */\nexport const CONFIG_IMPORT_PACKAGES = [\n  \"@hexclave/next\",\n  \"@hexclave/react\",\n  \"@hexclave/tanstack-start\",\n  \"@hexclave/js\",\n  \"@hexclave/template\",\n  \"@stackframe/stack\",\n  \"@stackframe/react\",\n  \"@stackframe/js\",\n  \"@stackframe/template\",\n] as const;\n\n/**\n * Given a list of dependency names (from package.json), returns the SDK\n * package that should be used for the `HexclaveConfig` import, or `undefined`\n * if none of the known packages are installed.\n */\nexport function detectConfigImportPackage(dependencies: string[]): string | undefined {\n  for (const pkg of CONFIG_IMPORT_PACKAGES) {\n    if (dependencies.includes(pkg)) {\n      return pkg;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n */\nexport function renderConfigFileContent(config: unknown, importPackage?: string): string {\n  if (!isValidConfig(config)) {\n    throw new Error(\"Invalid config: expected a plain object.\");\n  }\n\n  const droppedKeys: string[] = [];\n  const normalizedConfig = normalize(config, {\n    onDotIntoNonObject: \"ignore\",\n    onDotIntoNull: \"empty-object\",\n    droppedKeys,\n  });\n  if (droppedKeys.length > 0) {\n    throw new Error(`Config has conflicting keys that would be dropped during normalization: ${droppedKeys.map(k => JSON.stringify(k)).join(\", \")}`);\n  }\n  const pkg = importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE;\n  const importLine = `import type { HexclaveConfig } from \"${pkg}\";`;\n  return `${importLine}\\n\\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\\n`;\n}\n\n// --- inline vitest tests ---\n\nimport.meta.vitest?.test(\"renderConfigFileContent normalizes config exports\", ({ expect }) => {\n  expect(renderConfigFileContent({\n    \"payments.items.todos.displayName\": \"Todo Slots\",\n    \"payments.items.todos.customerType\": \"user\",\n  })).toContain(`export const config: HexclaveConfig = {\n  \"payments\": {\n    \"items\": {\n      \"todos\": {\n        \"displayName\": \"Todo Slots\",\n        \"customerType\": \"user\"\n      }\n    }\n  }\n};`);\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent rejects conflicting dotted keys\", ({ expect }) => {\n  expect(() => renderConfigFileContent({\n    \"a.b\": 1,\n    \"a.b.c\": 2,\n  })).toThrowError(/conflicting keys.*\"a\\.b\\.c\"/);\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent rejects invalid config exports\", ({ expect }) => {\n  expect(() => renderConfigFileContent(null)).toThrowErrorMatchingInlineSnapshot(\n    `[Error: Invalid config: expected a plain object.]`,\n  );\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent uses custom import package\", ({ expect }) => {\n  const content = renderConfigFileContent({}, \"@hexclave/next\");\n  expect(content).toContain('import type { HexclaveConfig } from \"@hexclave/next\";');\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent defaults to @hexclave/js\", ({ expect }) => {\n  const content = renderConfigFileContent({});\n  expect(content).toContain('import type { HexclaveConfig } from \"@hexclave/js\";');\n});\n\nimport.meta.vitest?.test(\"renderConfigFileContent imports from the SDK package root\", ({ expect }) => {\n  const content = renderConfigFileContent({}, \"@stackframe/next\");\n  expect(content).toContain('import type { HexclaveConfig } from \"@stackframe/next\";');\n});\n\nimport.meta.vitest?.test(\"detectConfigImportPackage picks first matching package by priority\", ({ expect }) => {\n  expect(detectConfigImportPackage([\"@hexclave/next\", \"@hexclave/js\"])).toBe(\"@hexclave/next\");\n  expect(detectConfigImportPackage([\"@hexclave/react\", \"@hexclave/js\"])).toBe(\"@hexclave/react\");\n  expect(detectConfigImportPackage([\"@hexclave/js\"])).toBe(\"@hexclave/js\");\n  expect(detectConfigImportPackage([\"@hexclave/tanstack-start\"])).toBe(\"@hexclave/tanstack-start\");\n  expect(detectConfigImportPackage([\"@stackframe/stack\", \"@hexclave/next\"])).toBe(\"@hexclave/next\");\n  expect(detectConfigImportPackage([\"@stackframe/stack\"])).toBe(\"@stackframe/stack\");\n  expect(detectConfigImportPackage([\"@stackframe/template\"])).toBe(\"@stackframe/template\");\n  expect(detectConfigImportPackage([\"lodash\", \"express\"])).toBeUndefined();\n  expect(detectConfigImportPackage([])).toBeUndefined();\n});\n"],"mappings":";;AAEA,MAAM,gCAAgC;;;;;;;;AAStC,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;AAOA,SAAgB,0BAA0B,cAA4C;CACpF,KAAK,MAAM,OAAO,wBAChB,IAAI,aAAa,SAAS,GAAG,GAC3B,OAAO;AAIb;;;;AAKA,SAAgB,wBAAwB,QAAiB,eAAgC;CACvF,IAAI,CAAC,cAAc,MAAM,GACvB,MAAM,IAAI,MAAM,0CAA0C;CAG5D,MAAM,cAAwB,CAAC;CAC/B,MAAM,mBAAmB,UAAU,QAAQ;EACzC,oBAAoB;EACpB,eAAe;EACf;CACF,CAAC;CACD,IAAI,YAAY,SAAS,GACvB,MAAM,IAAI,MAAM,2EAA2E,YAAY,KAAI,MAAK,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG;CAIjJ,OAAO,GAAG,wCAFE,iBAAiB,8BACkC,IAC1C,4CAA4C,KAAK,UAAU,kBAAkB,MAAM,CAAC,EAAE;AAC7G"}

package/dist/esm/interface/admin-interface.js

@@ -1,5 +1,5 @@
-import { Result } from "../utils/results.js";
 import { urlString } from "../utils/urls.js";
+import { Result } from "../utils/results.js";
 import { KnownErrors } from "../known-errors.js";
 import { HexclaveServerInterface } from "./server-interface.js";
 //#region src/interface/admin-interface.ts

package/dist/esm/interface/client-interface.js

@@ -1,9 +1,9 @@
+import { deindent } from "../utils/strings.js";
 import { HexclaveAssertionError, throwErr } from "../utils/errors.js";
+import { urlString } from "../utils/urls.js";
 import { filterUndefined, filterUndefinedOrNull } from "../utils/objects.js";
-import { deindent } from "../utils/strings.js";
 import { publishableClientKeyNotNecessarySentinel } from "../utils/oauth.js";
 import { Result } from "../utils/results.js";
-import { urlString } from "../utils/urls.js";
 import { KnownError, KnownErrors } from "../known-errors.js";
 import { AccessToken, InternalSession } from "../sessions.js";
 import { generateSecureRandomString } from "../utils/crypto.js";