@hexclave/shared 1.0.36 → 1.0.37

package/dist/esm/config/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","names":[],"sources":["../../../src/config/format.ts"],"sourcesContent":["// Format spec lives in the eng-handbook (random-thoughts/config-json-format.md).\n// (Previously linked to a public repo that doesn't exist — internal handbook only.)\n\nimport { HexclaveAssertionError, throwErr } from \"../utils/errors\";\nimport { deleteKey, filterUndefined, get, hasAndNotUndefined, set } from \"../utils/objects\";\nimport { OptionalKeys, RequiredKeys } from \"../utils/types\";\n\n\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | Config;\nexport type Config = {\n  [keyOrDotNotation: string]: ConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type NormalizedConfigValue = string | number | boolean | NormalizedConfig | NormalizedConfigValue[];\nexport type NormalizedConfig = {\n  [key: string]: NormalizedConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type _NormalizesTo<N> = N extends readonly any[]\n  ? { [K in keyof N]: _NormalizesTo<N[K]> }\n  : N extends object ? (\n    & Config\n    & { [K in OptionalKeys<N>]?: _NormalizesTo<N[K]> | null }\n    & { [K in RequiredKeys<N>]: undefined extends N[K] ? _NormalizesTo<N[K]> | null : _NormalizesTo<N[K]> }\n    & { [K in `${string}.${string}`]: ConfigValue }\n  ) : N;\nexport type NormalizesTo<N extends NormalizedConfig> = _NormalizesTo<N>;\n\n/**\n * Note that a config can both be valid and not normalizable.\n */\nexport function isValidConfig(c: unknown): c is Config {\n  return getInvalidConfigReason(c) === undefined;\n}\n\nexport function getInvalidConfigReason(c: unknown, options: { configName?: string } = {}): string | undefined {\n  const configName = options.configName ?? 'config';\n  if (c === null || typeof c !== 'object') return `${configName} must be a non-null object`;\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (typeof key !== 'string') return `${configName} must have only string keys (found: ${typeof key})`;\n    if (!key.match(/^[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*(?:\\.[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*)*$/)) return `All keys of ${configName} must consist of only alphanumeric characters, dots, underscores, colons, dollar signs, or hyphens and start with a character other than a hyphen (found: ${key})`;\n\n    const entryName = `${configName}.${key}`;\n    const reason = getInvalidConfigValueReason(value, { valueName: entryName });\n    if (reason) return reason;\n  }\n  return undefined;\n}\n\nfunction getInvalidConfigValueReason(value: unknown, options: { valueName?: string } = {}): string | undefined {\n  const valueName = options.valueName ?? 'value';\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      break;\n    }\n    case 'object': {\n      if (value === null) {\n        break;\n      } else if (Array.isArray(value)) {\n        for (const [index, v] of value.entries()) {\n          const elementValueName = `${valueName}[${index}]`;\n          if (v === null) return `${elementValueName} is null; tuple elements cannot be null`;\n          const reason = getInvalidConfigValueReason(v, { valueName: elementValueName });\n          if (reason) return reason;\n        }\n      } else {\n        const reason = getInvalidConfigReason(value, { configName: valueName });\n        if (reason) return reason;\n      }\n      break;\n    }\n    default: {\n      return `${valueName} has an invalid value type ${typeof value} (value: ${value})`;\n    }\n  }\n  return undefined;\n}\n\nexport function assertValidConfig(c: unknown) {\n  const reason = getInvalidConfigReason(c);\n  if (reason) throw new HexclaveAssertionError(`Invalid config: ${reason}`, { c });\n}\n\nexport function override(c1: Config, ...configs: Config[]) {\n  if (configs.length === 0) return c1;\n  if (configs.length > 1) return override(override(c1, configs[0]), ...configs.slice(1));\n  const c2 = configs[0];\n\n  assertValidConfig(c1);\n  assertValidConfig(c2);\n\n  let result = c1;\n  for (const key of Object.keys(filterUndefined(c2))) {\n    result = Object.fromEntries(\n      Object.entries(result).filter(([k]) => k !== key && !k.startsWith(key + '.'))\n    );\n  }\n\n  return {\n    ...result,\n    ...filterUndefined(c2),\n  };\n}\n\n/**\n * Removes keys from a config override, using the same nested key logic as the `override` function.\n * Resetting key \"a.b\" also resets \"a.b.c\" (and any other descendants).\n * Handles both flat dot-notation keys and nested object keys.\n */\nexport function removeKeysFromConfig(config: Config, keysToRemove: string[]): Config {\n  if (keysToRemove.length === 0) return config;\n\n  const result: Config = {};\n  for (const [key, value] of Object.entries(config)) {\n    if (value === undefined) continue;\n\n    // Check if this flat key matches or is a child of any key to remove (same logic as override)\n    const shouldRemove = keysToRemove.some(k => key === k || key.startsWith(k + '.'));\n    if (shouldRemove) continue;\n\n    // Check if any key to remove is a descendant of this key (meaning it's nested inside this value)\n    const childKeysToRemove = keysToRemove\n      .filter(k => k.startsWith(key + '.'))\n      .map(k => k.slice(key.length + 1));\n\n    if (childKeysToRemove.length > 0 && typeof value === 'object' && value !== null && !Array.isArray(value)) {\n      const cleaned = removeKeysFromConfig(value as Config, childKeysToRemove);\n      if (Object.keys(cleaned).length > 0) {\n        result[key] = cleaned;\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nimport.meta.vitest?.test(\"removeKeysFromConfig(...)\", ({ expect }) => {\n  // Basic flat key removal\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"a\"])).toEqual({ b: 2 });\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.c\": 2, d: 3 }, [\"a.b\"])).toEqual({ \"a.c\": 2, d: 3 });\n\n  // Removing a parent removes children (flat keys)\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.b.c\": 2, \"a.d\": 3 }, [\"a.b\"])).toEqual({ \"a.d\": 3 });\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.c\": 2, \"a.d\": 3 }, [\"a\"])).toEqual({});\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, \"teams.createPersonalTeamOnSignUp\": true }, [\"teams\"])).toEqual({});\n\n  // Nested object key removal\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true, createPersonalTeamOnSignUp: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({ teams: { createPersonalTeamOnSignUp: true } });\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({});\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true, createPersonalTeamOnSignUp: true } }, [\"teams\"])).toEqual({});\n  expect(removeKeysFromConfig({ a: { b: { c: 1, d: 2 } } }, [\"a.b.c\"])).toEqual({ a: { b: { d: 2 } } });\n\n  // Mixed flat and nested\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, teams: { createPersonalTeamOnSignUp: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({ teams: { createPersonalTeamOnSignUp: true } });\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, teams: { createPersonalTeamOnSignUp: true } }, [\"teams\"])).toEqual({});\n\n  // Nested with dot-notation inner keys\n  expect(removeKeysFromConfig({ teams: { \"a.b\": 1 } }, [\"teams.a.b\"])).toEqual({});\n  expect(removeKeysFromConfig({ teams: { \"a.b.c\": 1 } }, [\"teams.a.b\"])).toEqual({});\n\n  // No keys to remove\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [])).toEqual({ a: 1, b: 2 });\n\n  // Key not present (no-op)\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"c\"])).toEqual({ a: 1, b: 2 });\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"a.b\"])).toEqual({ a: 1, b: 2 });\n\n  // Multiple keys to remove\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"c.d\": 2, \"e.f\": 3 }, [\"a.b\", \"e.f\"])).toEqual({ \"c.d\": 2 });\n  expect(removeKeysFromConfig({ a: { b: 1 }, c: { d: 2 } }, [\"a.b\", \"c.d\"])).toEqual({});\n\n  // Removing non-object values with nested key path (no-op for non-objects)\n  expect(removeKeysFromConfig({ a: \"string\" }, [\"a.b\"])).toEqual({ a: \"string\" });\n  expect(removeKeysFromConfig({ a: 123 }, [\"a.b\"])).toEqual({ a: 123 });\n  expect(removeKeysFromConfig({ a: null }, [\"a.b\"])).toEqual({ a: null });\n\n  // Array values are preserved (not recursed into)\n  expect(removeKeysFromConfig({ a: [1, 2, 3] }, [\"a.0\"])).toEqual({ a: [1, 2, 3] });\n});\n\nimport.meta.vitest?.test(\"override(...)\", ({ expect }) => {\n  expect(\n    override(\n      {\n        a: 1,\n        b: 2,\n        \"c.d\": 3,\n        \"c.e.f\": 4,\n        \"c.g\": 5,\n        h: [6, { i: 7 }, 8],\n        k: 123,\n        l: undefined,\n      },\n      {\n        a: 9,\n        \"c.d\": 10,\n        \"c.e\": null,\n        \"h.0\": 11,\n        \"h.1\": {\n          j: 12,\n        },\n        k: undefined,\n      },\n    )\n  ).toEqual({\n    a: 9,\n    b: 2,\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: 123,\n    l: undefined,\n  });\n});\n\ntype NormalizeOptions = {\n  /**\n   * What to do if a dot notation is used on a value that is not an object.\n   *\n   * - \"throw\" (default): Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   */\n  onDotIntoNonObject?: \"throw\" | \"ignore\",\n  /**\n   * What to do if a dot notation is used on a value that is null.\n   *\n   * - \"like-non-object\"  (default): Treat it like a non-object. See `onDotIntoNonObject`.\n   * - \"throw\": Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   * - \"empty-object\": Set the value to an empty object.\n   */\n  onDotIntoNull?: \"like-non-object\" | \"throw\" | \"ignore\" | \"empty-object\",\n  /**\n   * If provided, keys that are silently dropped during normalization (when a dot-notation key\n   * references a parent that doesn't exist or is not an object and the behavior is \"ignore\")\n   * will be pushed to this array.\n   */\n  droppedKeys?: string[],\n}\n\nexport class NormalizationError extends Error {\n  constructor(...args: ConstructorParameters<typeof Error>) {\n    super(...args);\n  }\n}\nNormalizationError.prototype.name = \"NormalizationError\";\n\nexport function isNormalized(c: Config): c is NormalizedConfig {\n  assertValidConfig(c);\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (key.includes('.')) return false;\n    if (value === null) return false;\n  }\n  return true;\n}\n\nexport function assertNormalized(c: Config): asserts c is NormalizedConfig {\n  assertValidConfig(c);\n  if (!isNormalized(c)) throw new HexclaveAssertionError(`Config is not normalized: ${JSON.stringify(c)}`);\n}\n\nexport function normalize(c: Config, options: NormalizeOptions = {}): NormalizedConfig {\n  assertValidConfig(c);\n  const onDotIntoNonObject = options.onDotIntoNonObject ?? \"throw\";\n  const onDotIntoNull = options.onDotIntoNull ?? \"like-non-object\";\n\n  const countDots = (s: string) => s.match(/\\./g)?.length ?? 0;\n  const result: NormalizedConfig = {};\n  const keysByDepth = Object.keys(c).sort((a, b) => countDots(a) - countDots(b));\n\n  outer: for (const key of keysByDepth) {\n    const keySegmentsWithoutLast = key.split('.');\n    const last = keySegmentsWithoutLast.pop() ?? throwErr('split returns empty array?');\n    const value = get(c, key);\n    if (value === undefined) continue;\n\n    let current: NormalizedConfig = result;\n    for (const keySegment of keySegmentsWithoutLast) {\n      if (!hasAndNotUndefined(current, keySegment)) {\n        switch (onDotIntoNull === \"like-non-object\" ? onDotIntoNonObject : onDotIntoNull) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} doesn't exist on the object (or is null).`);\n          }\n          case \"ignore\": {\n            options.droppedKeys?.push(key);\n            continue outer;\n          }\n          case \"empty-object\": {\n            set(current, keySegment, {});\n            break;\n          }\n        }\n      }\n      const value = get(current, keySegment);\n      if (typeof value !== 'object') {\n        switch (onDotIntoNonObject) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} is not an object.`);\n          }\n          case \"ignore\": {\n            options.droppedKeys?.push(key);\n            continue outer;\n          }\n        }\n      }\n      current = value as NormalizedConfig;\n    }\n    setNormalizedValue(current, last, value, options);\n  }\n  return result;\n}\n\nfunction normalizeValue(value: ConfigValue, options: NormalizeOptions): NormalizedConfigValue {\n  if (value === null) throw new NormalizationError(\"Tried to normalize a null value\");\n  if (Array.isArray(value)) return value.map(v => normalizeValue(v, options));\n  if (typeof value === 'object') return normalize(value, options);\n  return value;\n}\n\nfunction setNormalizedValue(result: NormalizedConfig, key: string, value: ConfigValue, options: NormalizeOptions) {\n  if (value === null) {\n    if (hasAndNotUndefined(result, key)) {\n      deleteKey(result, key);\n    }\n  } else {\n    set(result, key, normalizeValue(value, options));\n  }\n}\n\nimport.meta.vitest?.test(\"normalize(...)\", ({ expect }) => {\n  expect(normalize({\n    a: 9,\n    b: 2,\n    c: {},\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: { l: {} },\n    \"k.l.m\": 13,\n    n: undefined,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({\n    a: 9,\n    b: 2,\n    c: {\n      d: 10,\n      g: 5,\n    },\n    h: [11, { j: 12 }, 8],\n    k: { l: { m: 13 } },\n  });\n\n  // dotting into null\n  expect(() => normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(() => normalize({\n    b: null,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({});\n\n  // dotting into non-object\n  expect(() => normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" is not an object`);\n  expect(normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({ b: 1 });\n});\n"],"mappings":"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"}
+{"version":3,"file":"format.js","names":[],"sources":["../../../src/config/format.ts"],"sourcesContent":["// Format spec lives in the eng-handbook (random-thoughts/config-json-format.md).\n// (Previously linked to a public repo that doesn't exist — internal handbook only.)\n\nimport { HexclaveAssertionError, throwErr } from \"../utils/errors\";\nimport { deleteKey, filterUndefined, get, hasAndNotUndefined, set } from \"../utils/objects\";\nimport { OptionalKeys, RequiredKeys } from \"../utils/types\";\n\n\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | Config;\nexport type Config = {\n  [keyOrDotNotation: string]: ConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type NormalizedConfigValue = string | number | boolean | NormalizedConfig | NormalizedConfigValue[];\nexport type NormalizedConfig = {\n  [key: string]: NormalizedConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type _NormalizesTo<N> = N extends readonly any[]\n  ? { [K in keyof N]: _NormalizesTo<N[K]> }\n  : N extends object ? (\n    & Config\n    & { [K in OptionalKeys<N>]?: _NormalizesTo<N[K]> | null }\n    & { [K in RequiredKeys<N>]: undefined extends N[K] ? _NormalizesTo<N[K]> | null : _NormalizesTo<N[K]> }\n    & { [K in `${string}.${string}`]: ConfigValue }\n  ) : N;\nexport type NormalizesTo<N extends NormalizedConfig> = _NormalizesTo<N>;\n\n/**\n * Note that a config can both be valid and not normalizable.\n */\nexport function isValidConfig(c: unknown): c is Config {\n  return getInvalidConfigReason(c) === undefined;\n}\n\nexport function getInvalidConfigReason(c: unknown, options: { configName?: string } = {}): string | undefined {\n  const configName = options.configName ?? 'config';\n  if (c === null || typeof c !== 'object') return `${configName} must be a non-null object`;\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (typeof key !== 'string') return `${configName} must have only string keys (found: ${typeof key})`;\n    if (!key.match(/^[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*(?:\\.[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*)*$/)) return `All keys of ${configName} must consist of only alphanumeric characters, dots, underscores, colons, dollar signs, or hyphens and start with a character other than a hyphen (found: ${key})`;\n\n    const entryName = `${configName}.${key}`;\n    const reason = getInvalidConfigValueReason(value, { valueName: entryName });\n    if (reason) return reason;\n  }\n  return undefined;\n}\n\nfunction getInvalidConfigValueReason(value: unknown, options: { valueName?: string } = {}): string | undefined {\n  const valueName = options.valueName ?? 'value';\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      break;\n    }\n    case 'object': {\n      if (value === null) {\n        break;\n      } else if (Array.isArray(value)) {\n        for (const [index, v] of value.entries()) {\n          const elementValueName = `${valueName}[${index}]`;\n          if (v === null) return `${elementValueName} is null; tuple elements cannot be null`;\n          const reason = getInvalidConfigValueReason(v, { valueName: elementValueName });\n          if (reason) return reason;\n        }\n      } else {\n        const reason = getInvalidConfigReason(value, { configName: valueName });\n        if (reason) return reason;\n      }\n      break;\n    }\n    default: {\n      return `${valueName} has an invalid value type ${typeof value} (value: ${value})`;\n    }\n  }\n  return undefined;\n}\n\nexport function assertValidConfig(c: unknown) {\n  const reason = getInvalidConfigReason(c);\n  if (reason) throw new HexclaveAssertionError(`Invalid config: ${reason}`, { c });\n}\n\nexport function override(c1: Config, ...configs: Config[]) {\n  if (configs.length === 0) return c1;\n  if (configs.length > 1) return override(override(c1, configs[0]), ...configs.slice(1));\n  const c2 = configs[0];\n\n  assertValidConfig(c1);\n  assertValidConfig(c2);\n\n  let result = c1;\n  for (const key of Object.keys(filterUndefined(c2))) {\n    result = Object.fromEntries(\n      Object.entries(result).filter(([k]) => k !== key && !k.startsWith(key + '.'))\n    );\n  }\n\n  return {\n    ...result,\n    ...filterUndefined(c2),\n  };\n}\n\n/**\n * Removes keys from a config override, using the same nested key logic as the `override` function.\n * Resetting key \"a.b\" also resets \"a.b.c\" (and any other descendants).\n * Handles both flat dot-notation keys and nested object keys.\n */\nexport function removeKeysFromConfig(config: Config, keysToRemove: string[]): Config {\n  if (keysToRemove.length === 0) return config;\n\n  const result: Config = {};\n  for (const [key, value] of Object.entries(config)) {\n    if (value === undefined) continue;\n\n    // Check if this flat key matches or is a child of any key to remove (same logic as override)\n    const shouldRemove = keysToRemove.some(k => key === k || key.startsWith(k + '.'));\n    if (shouldRemove) continue;\n\n    // Check if any key to remove is a descendant of this key (meaning it's nested inside this value)\n    const childKeysToRemove = keysToRemove\n      .filter(k => k.startsWith(key + '.'))\n      .map(k => k.slice(key.length + 1));\n\n    if (childKeysToRemove.length > 0 && typeof value === 'object' && value !== null && !Array.isArray(value)) {\n      const cleaned = removeKeysFromConfig(value as Config, childKeysToRemove);\n      if (Object.keys(cleaned).length > 0) {\n        result[key] = cleaned;\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nimport.meta.vitest?.test(\"removeKeysFromConfig(...)\", ({ expect }) => {\n  // Basic flat key removal\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"a\"])).toEqual({ b: 2 });\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.c\": 2, d: 3 }, [\"a.b\"])).toEqual({ \"a.c\": 2, d: 3 });\n\n  // Removing a parent removes children (flat keys)\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.b.c\": 2, \"a.d\": 3 }, [\"a.b\"])).toEqual({ \"a.d\": 3 });\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"a.c\": 2, \"a.d\": 3 }, [\"a\"])).toEqual({});\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, \"teams.createPersonalTeamOnSignUp\": true }, [\"teams\"])).toEqual({});\n\n  // Nested object key removal\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true, createPersonalTeamOnSignUp: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({ teams: { createPersonalTeamOnSignUp: true } });\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({});\n  expect(removeKeysFromConfig({ teams: { allowClientTeamCreation: true, createPersonalTeamOnSignUp: true } }, [\"teams\"])).toEqual({});\n  expect(removeKeysFromConfig({ a: { b: { c: 1, d: 2 } } }, [\"a.b.c\"])).toEqual({ a: { b: { d: 2 } } });\n\n  // Mixed flat and nested\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, teams: { createPersonalTeamOnSignUp: true } }, [\"teams.allowClientTeamCreation\"])).toEqual({ teams: { createPersonalTeamOnSignUp: true } });\n  expect(removeKeysFromConfig({ \"teams.allowClientTeamCreation\": true, teams: { createPersonalTeamOnSignUp: true } }, [\"teams\"])).toEqual({});\n\n  // Nested with dot-notation inner keys\n  expect(removeKeysFromConfig({ teams: { \"a.b\": 1 } }, [\"teams.a.b\"])).toEqual({});\n  expect(removeKeysFromConfig({ teams: { \"a.b.c\": 1 } }, [\"teams.a.b\"])).toEqual({});\n\n  // No keys to remove\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [])).toEqual({ a: 1, b: 2 });\n\n  // Key not present (no-op)\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"c\"])).toEqual({ a: 1, b: 2 });\n  expect(removeKeysFromConfig({ a: 1, b: 2 }, [\"a.b\"])).toEqual({ a: 1, b: 2 });\n\n  // Multiple keys to remove\n  expect(removeKeysFromConfig({ \"a.b\": 1, \"c.d\": 2, \"e.f\": 3 }, [\"a.b\", \"e.f\"])).toEqual({ \"c.d\": 2 });\n  expect(removeKeysFromConfig({ a: { b: 1 }, c: { d: 2 } }, [\"a.b\", \"c.d\"])).toEqual({});\n\n  // Removing non-object values with nested key path (no-op for non-objects)\n  expect(removeKeysFromConfig({ a: \"string\" }, [\"a.b\"])).toEqual({ a: \"string\" });\n  expect(removeKeysFromConfig({ a: 123 }, [\"a.b\"])).toEqual({ a: 123 });\n  expect(removeKeysFromConfig({ a: null }, [\"a.b\"])).toEqual({ a: null });\n\n  // Array values are preserved (not recursed into)\n  expect(removeKeysFromConfig({ a: [1, 2, 3] }, [\"a.0\"])).toEqual({ a: [1, 2, 3] });\n});\n\nimport.meta.vitest?.test(\"override(...)\", ({ expect }) => {\n  expect(\n    override(\n      {\n        a: 1,\n        b: 2,\n        \"c.d\": 3,\n        \"c.e.f\": 4,\n        \"c.g\": 5,\n        h: [6, { i: 7 }, 8],\n        k: 123,\n        l: undefined,\n      },\n      {\n        a: 9,\n        \"c.d\": 10,\n        \"c.e\": null,\n        \"h.0\": 11,\n        \"h.1\": {\n          j: 12,\n        },\n        k: undefined,\n      },\n    )\n  ).toEqual({\n    a: 9,\n    b: 2,\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: 123,\n    l: undefined,\n  });\n});\n\ntype NormalizeOptions = {\n  /**\n   * What to do if a dot notation is used on a value that is not an object.\n   *\n   * - \"throw\" (default): Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   */\n  onDotIntoNonObject?: \"throw\" | \"ignore\",\n  /**\n   * What to do if a dot notation is used on a value that is null.\n   *\n   * - \"like-non-object\"  (default): Treat it like a non-object. See `onDotIntoNonObject`.\n   * - \"throw\": Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   * - \"empty-object\": Set the value to an empty object.\n   */\n  onDotIntoNull?: \"like-non-object\" | \"throw\" | \"ignore\" | \"empty-object\",\n  /**\n   * If provided, keys that are silently dropped during normalization (when a dot-notation key\n   * references a parent that doesn't exist or is not an object and the behavior is \"ignore\")\n   * will be pushed to this array.\n   */\n  droppedKeys?: string[],\n}\n\nexport class NormalizationError extends Error {\n  constructor(...args: ConstructorParameters<typeof Error>) {\n    super(...args);\n  }\n}\nNormalizationError.prototype.name = \"NormalizationError\";\n\nexport function isNormalized(c: Config): c is NormalizedConfig {\n  assertValidConfig(c);\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (key.includes('.')) return false;\n    if (value === null) return false;\n  }\n  return true;\n}\n\nexport function assertNormalized(c: Config): asserts c is NormalizedConfig {\n  assertValidConfig(c);\n  if (!isNormalized(c)) throw new HexclaveAssertionError(`Config is not normalized: ${JSON.stringify(c)}`);\n}\n\nexport function normalize(c: Config, options: NormalizeOptions = {}): NormalizedConfig {\n  assertValidConfig(c);\n  const onDotIntoNonObject = options.onDotIntoNonObject ?? \"throw\";\n  const onDotIntoNull = options.onDotIntoNull ?? \"like-non-object\";\n\n  const countDots = (s: string) => s.match(/\\./g)?.length ?? 0;\n  const result: NormalizedConfig = {};\n  const keysByDepth = Object.keys(c).sort((a, b) => countDots(a) - countDots(b));\n\n  outer: for (const key of keysByDepth) {\n    const keySegmentsWithoutLast = key.split('.');\n    const last = keySegmentsWithoutLast.pop() ?? throwErr('split returns empty array?');\n    const value = get(c, key);\n    if (value === undefined) continue;\n\n    let current: NormalizedConfig = result;\n    for (const keySegment of keySegmentsWithoutLast) {\n      if (!hasAndNotUndefined(current, keySegment)) {\n        switch (onDotIntoNull === \"like-non-object\" ? onDotIntoNonObject : onDotIntoNull) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} doesn't exist on the object (or is null).`);\n          }\n          case \"ignore\": {\n            options.droppedKeys?.push(key);\n            continue outer;\n          }\n          case \"empty-object\": {\n            set(current, keySegment, {});\n            break;\n          }\n        }\n      }\n      const value = get(current, keySegment);\n      if (typeof value !== 'object') {\n        switch (onDotIntoNonObject) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} is not an object.`);\n          }\n          case \"ignore\": {\n            options.droppedKeys?.push(key);\n            continue outer;\n          }\n        }\n      }\n      current = value as NormalizedConfig;\n    }\n    setNormalizedValue(current, last, value, options);\n  }\n  return result;\n}\n\nfunction normalizeValue(value: ConfigValue, options: NormalizeOptions): NormalizedConfigValue {\n  if (value === null) throw new NormalizationError(\"Tried to normalize a null value\");\n  if (Array.isArray(value)) return value.map(v => normalizeValue(v, options));\n  if (typeof value === 'object') return normalize(value, options);\n  return value;\n}\n\nfunction setNormalizedValue(result: NormalizedConfig, key: string, value: ConfigValue, options: NormalizeOptions) {\n  if (value === null) {\n    if (hasAndNotUndefined(result, key)) {\n      deleteKey(result, key);\n    }\n  } else {\n    set(result, key, normalizeValue(value, options));\n  }\n}\n\nimport.meta.vitest?.test(\"normalize(...)\", ({ expect }) => {\n  expect(normalize({\n    a: 9,\n    b: 2,\n    c: {},\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: { l: {} },\n    \"k.l.m\": 13,\n    n: undefined,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({\n    a: 9,\n    b: 2,\n    c: {\n      d: 10,\n      g: 5,\n    },\n    h: [11, { j: 12 }, 8],\n    k: { l: { m: 13 } },\n  });\n\n  // dotting into null\n  expect(() => normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(() => normalize({\n    b: null,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({});\n  expect(normalize({\n    \"auth.allowSignUp\": false,\n    \"apps.installed.payments.enabled\": false,\n  }, {\n    onDotIntoNonObject: \"ignore\",\n    onDotIntoNull: \"empty-object\",\n  })).toEqual({\n    auth: {\n      allowSignUp: false,\n    },\n    apps: {\n      installed: {\n        payments: {\n          enabled: false,\n        },\n      },\n    },\n  });\n\n  // dotting into non-object\n  expect(() => normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" is not an object`);\n  expect(normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({ b: 1 });\n});\n"],"mappings":"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"}

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

@@ -84,7 +84,7 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
   sourceOfTruth: {
     type: "hosted";
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -125,6 +125,13 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
       }>;
     }>;
   } | undefined;
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
+  teams: {
+    createPersonalTeamOnSignUp?: boolean | undefined;
+    allowClientTeamCreation?: boolean | undefined;
+  };
   auth: {
     allowSignUp?: boolean | undefined;
     signUpRulesDefaultAction?: string | undefined;
@@ -159,10 +166,6 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
   onboarding: {
     requireEmailVerification?: boolean | undefined;
   };
-  teams: {
-    createPersonalTeamOnSignUp?: boolean | undefined;
-    allowClientTeamCreation?: boolean | undefined;
-  };
   rbac: {
     permissions: Record<string, {
       description?: string | undefined;
@@ -187,9 +190,6 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -197,7 +197,7 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
     };
   };
   apps: {
-    installed: Record<"authentication" | "fraud-protection" | "analytics" | "onboarding" | "teams" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
+    installed: Record<"teams" | "authentication" | "fraud-protection" | "analytics" | "onboarding" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
       enabled?: boolean | undefined;
     }>;
   };
@@ -218,7 +218,7 @@ declare const branchConfigSchema: yup$1.Schema<Omit<Omit<{
   project: {
     requirePublishableClientKey: undefined;
   };
-}, string>, "auth" | "onboarding" | "teams" | "rbac" | "payments" | "emails" | "users" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -293,7 +293,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" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -334,6 +334,13 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
       }>;
     }>;
   } | undefined;
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
+  teams: {
+    createPersonalTeamOnSignUp?: boolean | undefined;
+    allowClientTeamCreation?: boolean | undefined;
+  };
   auth: {
     allowSignUp?: boolean | undefined;
     signUpRulesDefaultAction?: string | undefined;
@@ -368,10 +375,6 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
   onboarding: {
     requireEmailVerification?: boolean | undefined;
   };
-  teams: {
-    createPersonalTeamOnSignUp?: boolean | undefined;
-    allowClientTeamCreation?: boolean | undefined;
-  };
   rbac: {
     permissions: Record<string, {
       description?: string | undefined;
@@ -396,9 +399,6 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -406,7 +406,7 @@ declare const environmentConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<Omit<{
     };
   };
   apps: {
-    installed: Record<"authentication" | "fraud-protection" | "analytics" | "onboarding" | "teams" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
+    installed: Record<"teams" | "authentication" | "fraud-protection" | "analytics" | "onboarding" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
       enabled?: boolean | undefined;
     }>;
   };
@@ -575,7 +575,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" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -648,7 +648,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -721,7 +721,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" | "dbSync" | "dataVault"> & {
+    }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
       rbac: {
         permissions: undefined;
         defaultPermissions: {
@@ -797,7 +797,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -883,7 +883,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -959,7 +959,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1041,7 +1041,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" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   payments?: {
     blockNewPurchases?: boolean | undefined;
     autoPay?: {
@@ -1082,6 +1082,13 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
       }>;
     }>;
   } | undefined;
+  users: {
+    allowClientUserDeletion?: boolean | undefined;
+  };
+  teams: {
+    createPersonalTeamOnSignUp?: boolean | undefined;
+    allowClientTeamCreation?: boolean | undefined;
+  };
   auth: {
     allowSignUp?: boolean | undefined;
     signUpRulesDefaultAction?: string | undefined;
@@ -1116,10 +1123,6 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
   onboarding: {
     requireEmailVerification?: boolean | undefined;
   };
-  teams: {
-    createPersonalTeamOnSignUp?: boolean | undefined;
-    allowClientTeamCreation?: boolean | undefined;
-  };
   rbac: {
     permissions: Record<string, {
       description?: string | undefined;
@@ -1144,9 +1147,6 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
       tsxSource: string;
     }>;
   };
-  users: {
-    allowClientUserDeletion?: boolean | undefined;
-  };
   apiKeys: {
     enabled: {
       team?: boolean | undefined;
@@ -1154,7 +1154,7 @@ declare const organizationConfigSchema: yup$1.Schema<Omit<NonNullable<Omit<NonNu
     };
   };
   apps: {
-    installed: Record<"authentication" | "fraud-protection" | "analytics" | "onboarding" | "teams" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
+    installed: Record<"teams" | "authentication" | "fraud-protection" | "analytics" | "onboarding" | "rbac" | "api-keys" | "payments" | "emails" | "support" | "email-api" | "data-vault" | "webhooks" | "tv-mode" | "launch-checklist" | "catalyst" | "neon" | "convex" | "vercel" | "tanstack-start" | "clickmaps" | "session-replays", {
       enabled?: boolean | undefined;
     }>;
   };
@@ -1323,7 +1323,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" | "dbSync" | "dataVault"> & {
+}, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
   rbac: {
     permissions: undefined;
     defaultPermissions: {
@@ -1396,7 +1396,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1469,7 +1469,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" | "dbSync" | "dataVault"> & {
+    }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
       rbac: {
         permissions: undefined;
         defaultPermissions: {
@@ -1545,7 +1545,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1631,7 +1631,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -1707,7 +1707,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" | "dbSync" | "dataVault"> & {
+  }, string>, "users" | "teams" | "auth" | "onboarding" | "rbac" | "payments" | "emails" | "apiKeys" | "apps" | "domains" | "dbSync" | "dataVault"> & {
     rbac: {
       permissions: undefined;
       defaultPermissions: {
@@ -2077,14 +2077,14 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
       priority: number;
       condition: string | undefined;
       action: {
-        type: "allow" | "reject" | "restrict" | "log";
         message: string | undefined;
+        type: "allow" | "reject" | "restrict" | "log";
       };
     }>;
-    allowSignUp: boolean;
     password: {
       allowSignIn: boolean;
     };
+    allowSignUp: boolean;
     otp: {
       allowSignIn: boolean;
     };
@@ -2146,8 +2146,8 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
       stackable: boolean | undefined;
       includedItems: {
         [x: string]: {
-          repeat: "never" | [number, "day" | "week" | "month" | "year"];
           quantity: number;
+          repeat: "never" | [number, "day" | "week" | "month" | "year"];
           expires: "never" | "when-purchase-expires" | "when-repeated";
         };
       };
@@ -2183,6 +2183,13 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
   } & {
     readonly type: "hosted";
   };
+  users: {
+    allowClientUserDeletion: boolean;
+  };
+  teams: {
+    createPersonalTeamOnSignUp: boolean;
+    allowClientTeamCreation: boolean;
+  };
   analytics: {
     queryFolders: {
       [x: string]: {
@@ -2201,10 +2208,6 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
   onboarding: {
     requireEmailVerification: boolean;
   };
-  teams: {
-    createPersonalTeamOnSignUp: boolean;
-    allowClientTeamCreation: boolean;
-  };
   rbac: {
     permissions: {
       [x: string]: {
@@ -2227,9 +2230,6 @@ declare function sanitizeOrganizationConfig(config: OrganizationRenderedConfigBe
       };
     };
   };
-  users: {
-    allowClientUserDeletion: boolean;
-  };
   apiKeys: {
     enabled: {
       team: boolean;

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

@@ -0,0 +1,31 @@
+import { showOnboardingHexclaveConfigValue } from "./config-authoring";
+
+//#region src/config-eval.d.ts
+/**
+ * Thrown when a config file evaluates successfully but its exported `config`
+ * isn't a usable shape (missing, or not an object / "show-onboarding" string).
+ * Distinct from the underlying loader errors jiti throws, so callers can tell a
+ * malformed config apart from a file that simply failed to load.
+ */
+declare class ConfigFileEvalError extends Error {
+  constructor(message: string);
+}
+/**
+ * Walks up from `dir` to find the nearest `package.json` and returns the
+ * best SDK package to use for the `HexclaveConfig` type import.
+ */
+declare function detectImportPackageFromDir(dir: string): string | undefined;
+/** A config object, or the `"show-onboarding"` sentinel that stands in for one. */
+type ParsedConfigValue = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;
+/**
+ * Evaluates config file content using jiti and returns the exported `config`
+ * value.
+ *
+ * WARNING: This executes arbitrary code via `jiti.evalModule` — only use on
+ * content that is fully operator-controlled (local filesystem). Never call
+ * this on untrusted input (e.g. content fetched from a remote repository).
+ */
+declare function evalConfigFileContent(content: string, filePath: string): ParsedConfigValue;
+//#endregion
+export { ConfigFileEvalError, ParsedConfigValue, detectImportPackageFromDir, evalConfigFileContent };
+//# sourceMappingURL=config-eval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-eval.d.ts","names":[],"sources":["../../src/config-eval.ts"],"mappings":";;;;;AAcA;;;;cAAa,mBAAA,SAA4B,KAAA;cAC3B,OAAA;AAAA;;;AAUd;;iBAAgB,0BAAA,CAA2B,GAAA;;KA4B/B,iBAAA,GAAoB,MAAA,2BAAiC,iCAAA;AAAjE;;;;;AAcA;;;AAdA,iBAcgB,qBAAA,CAAsB,OAAA,UAAiB,QAAA,WAAmB,iBAAA"}

package/dist/esm/config-eval.js

@@ -0,0 +1,112 @@
+import { showOnboardingHexclaveConfigValue } from "./config-authoring.js";
+import { existsSync, readFileSync } from "fs";
+import { createJiti } from "jiti";
+import path from "path";
+import { detectConfigImportPackage } from "./config-rendering.js";
+
+//#region src/config-eval.ts
+const jiti = createJiti(import.meta.url, { moduleCache: false });
+/**
+* Thrown when a config file evaluates successfully but its exported `config`
+* isn't a usable shape (missing, or not an object / "show-onboarding" string).
+* Distinct from the underlying loader errors jiti throws, so callers can tell a
+* malformed config apart from a file that simply failed to load.
+*/
+var ConfigFileEvalError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ConfigFileEvalError";
+	}
+};
+/**
+* Walks up from `dir` to find the nearest `package.json` and returns the
+* best SDK package to use for the `HexclaveConfig` type import.
+*/
+function detectImportPackageFromDir(dir) {
+	let current = dir;
+	while (true) {
+		const pkgPath = path.join(current, "package.json");
+		if (existsSync(pkgPath)) try {
+			const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+			return detectConfigImportPackage([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
+		} catch {
+			return;
+		}
+		const parent = path.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+}
+function isRecord(value) {
+	return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function invalidConfigShape(filePath) {
+	return new ConfigFileEvalError(`Invalid config in ${filePath}. The file must export a plain \`config\` object or "${showOnboardingHexclaveConfigValue}".`);
+}
+/**
+* Evaluates config file content using jiti and returns the exported `config`
+* value.
+*
+* WARNING: This executes arbitrary code via `jiti.evalModule` — only use on
+* content that is fully operator-controlled (local filesystem). Never call
+* this on untrusted input (e.g. content fetched from a remote repository).
+*/
+function evalConfigFileContent(content, filePath) {
+	if (content.trim() === "") return {};
+	const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+	const mod = jiti.evalModule(content, { filename: resolvedPath });
+	if (!isRecord(mod)) throw invalidConfigShape(filePath);
+	const config = mod.config;
+	if (config === void 0) throw invalidConfigShape(filePath);
+	if (typeof config === "string") {
+		if (config !== showOnboardingHexclaveConfigValue) throw new ConfigFileEvalError(`Invalid config in ${filePath}. String config values must be "${showOnboardingHexclaveConfigValue}", got "${config}".`);
+		return config;
+	}
+	if (isRecord(config)) return config;
+	throw invalidConfigShape(filePath);
+}
+(void 0)?.test("evalConfigFileContent parses static config exports", ({ expect }) => {
+	expect(evalConfigFileContent(`
+    import type { StackConfig } from "@hexclave/js";
+    export const config: StackConfig = {
+      auth: { allowSignUp: true },
+      payments: { testMode: false },
+    };
+  `, "stack.config.ts")).toMatchInlineSnapshot(`
+    {
+      "auth": {
+        "allowSignUp": true,
+      },
+      "payments": {
+        "testMode": false,
+      },
+    }
+  `);
+});
+(void 0)?.test("evalConfigFileContent parses show-onboarding", ({ expect }) => {
+	expect(evalConfigFileContent("export const config = \"show-onboarding\";", "stack.config.ts")).toBe("show-onboarding");
+});
+(void 0)?.test("evalConfigFileContent rejects content without config export", ({ expect }) => {
+	expect(() => evalConfigFileContent("export const other = {};", "stack.config.ts")).toThrow(/must export/);
+});
+(void 0)?.test("evalConfigFileContent rejects arbitrary string config values", ({ expect }) => {
+	expect(() => evalConfigFileContent("export const config = \"arbitrary-string\";", "stack.config.ts")).toThrow(/must be "show-onboarding"/);
+});
+(void 0)?.test("evalConfigFileContent rejects unresolvable config factories", ({ expect }) => {
+	expect(() => evalConfigFileContent("export const config = makeConfig();", "stack.config.ts")).toThrow();
+});
+(void 0)?.test("evalConfigFileContent rejects missing config import targets", ({ expect }) => {
+	expect(() => evalConfigFileContent(`
+    import missingConfigPart from "./missing-config-part";
+    export const config = { auth: missingConfigPart };
+  `, "/tmp/hexclave-missing-import-config.ts")).toThrow();
+});
+(void 0)?.test("evalConfigFileContent surfaces invalid syntax as a loader error, not ConfigFileEvalError", ({ expect }) => {
+	const evalInvalid = () => evalConfigFileContent("export const config = {", "stack.config.ts");
+	expect(evalInvalid).toThrow();
+	expect(evalInvalid).not.toThrow(ConfigFileEvalError);
+});
+
+//#endregion
+export { ConfigFileEvalError, detectImportPackageFromDir, evalConfigFileContent };
+//# sourceMappingURL=config-eval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-eval.js","names":[],"sources":["../../src/config-eval.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"fs\";\nimport { createJiti } from \"jiti\";\nimport path from \"path\";\nimport { showOnboardingHexclaveConfigValue } from \"./config-authoring\";\nimport { detectConfigImportPackage } from \"./config-rendering\";\n\nconst jiti = createJiti(import.meta.url, { moduleCache: false });\n\n/**\n * Thrown when a config file evaluates successfully but its exported `config`\n * isn't a usable shape (missing, or not an object / \"show-onboarding\" string).\n * Distinct from the underlying loader errors jiti throws, so callers can tell a\n * malformed config apart from a file that simply failed to load.\n */\nexport class ConfigFileEvalError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ConfigFileEvalError\";\n  }\n}\n\n/**\n * Walks up from `dir` to find the nearest `package.json` and returns the\n * best SDK package to use for the `HexclaveConfig` type import.\n */\nexport function detectImportPackageFromDir(dir: string): string | undefined {\n  let current = dir;\n  while (true) {\n    const pkgPath = path.join(current, \"package.json\");\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n        const deps = [\n          ...Object.keys(pkg.dependencies ?? {}),\n          ...Object.keys(pkg.devDependencies ?? {}),\n        ];\n        return detectConfigImportPackage(deps);\n      } catch {\n        return undefined;\n      }\n    }\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  return undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** A config object, or the `\"show-onboarding\"` sentinel that stands in for one. */\nexport type ParsedConfigValue = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;\n\nfunction invalidConfigShape(filePath: string): ConfigFileEvalError {\n  return new ConfigFileEvalError(`Invalid config in ${filePath}. The file must export a plain \\`config\\` object or \"${showOnboardingHexclaveConfigValue}\".`);\n}\n\n/**\n * Evaluates config file content using jiti and returns the exported `config`\n * value.\n *\n * WARNING: This executes arbitrary code via `jiti.evalModule` — only use on\n * content that is fully operator-controlled (local filesystem). Never call\n * this on untrusted input (e.g. content fetched from a remote repository).\n */\nexport function evalConfigFileContent(content: string, filePath: string): ParsedConfigValue {\n  if (content.trim() === \"\") return {};\n  const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);\n  const mod: unknown = jiti.evalModule(content, { filename: resolvedPath });\n  if (!isRecord(mod)) {\n    throw invalidConfigShape(filePath);\n  }\n  const config = mod.config;\n  if (config === undefined) {\n    throw invalidConfigShape(filePath);\n  }\n  if (typeof config === \"string\") {\n    if (config !== showOnboardingHexclaveConfigValue) {\n      throw new ConfigFileEvalError(`Invalid config in ${filePath}. String config values must be \"${showOnboardingHexclaveConfigValue}\", got \"${config}\".`);\n    }\n    return config;\n  }\n  if (isRecord(config)) return config;\n  throw invalidConfigShape(filePath);\n}\n\n// --- inline vitest tests ---\n\nimport.meta.vitest?.test(\"evalConfigFileContent parses static config exports\", ({ expect }) => {\n  expect(evalConfigFileContent(`\n    import type { StackConfig } from \"@hexclave/js\";\n    export const config: StackConfig = {\n      auth: { allowSignUp: true },\n      payments: { testMode: false },\n    };\n  `, \"stack.config.ts\")).toMatchInlineSnapshot(`\n    {\n      \"auth\": {\n        \"allowSignUp\": true,\n      },\n      \"payments\": {\n        \"testMode\": false,\n      },\n    }\n  `);\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent parses show-onboarding\", ({ expect }) => {\n  expect(evalConfigFileContent('export const config = \"show-onboarding\";', \"stack.config.ts\")).toBe(\"show-onboarding\");\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent rejects content without config export\", ({ expect }) => {\n  expect(() => evalConfigFileContent(\"export const other = {};\", \"stack.config.ts\")).toThrow(/must export/);\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent rejects arbitrary string config values\", ({ expect }) => {\n  expect(() => evalConfigFileContent('export const config = \"arbitrary-string\";', \"stack.config.ts\")).toThrow(/must be \"show-onboarding\"/);\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent rejects unresolvable config factories\", ({ expect }) => {\n  expect(() => evalConfigFileContent(\"export const config = makeConfig();\", \"stack.config.ts\")).toThrow();\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent rejects missing config import targets\", ({ expect }) => {\n  expect(() => evalConfigFileContent(`\n    import missingConfigPart from \"./missing-config-part\";\n    export const config = { auth: missingConfigPart };\n  `, \"/tmp/hexclave-missing-import-config.ts\")).toThrow();\n});\n\nimport.meta.vitest?.test(\"evalConfigFileContent surfaces invalid syntax as a loader error, not ConfigFileEvalError\", ({ expect }) => {\n  // A malformed file fails inside jiti's parser, so the thrown error is a loader\n  // error — NOT a ConfigFileEvalError. Callers depend on that distinction to route\n  // it to \"Failed to load config file\" rather than \"Invalid config\".\n  const evalInvalid = () => evalConfigFileContent(\"export const config = {\", \"stack.config.ts\");\n  expect(evalInvalid).toThrow();\n  expect(evalInvalid).not.toThrow(ConfigFileEvalError);\n});\n"],"mappings":";;;;;;;AAMA,MAAM,OAAO,WAAW,OAAO,KAAK,KAAK,EAAE,aAAa,OAAO,CAAC;;;;;;;AAQhE,IAAa,sBAAb,cAAyC,MAAM;CAC7C,YAAY,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;;;;;;;AAQhB,SAAgB,2BAA2B,KAAiC;CAC1E,IAAI,UAAU;AACd,QAAO,MAAM;EACX,MAAM,UAAU,KAAK,KAAK,SAAS,eAAe;AAClD,MAAI,WAAW,QAAQ,CACrB,KAAI;GACF,MAAM,MAAM,KAAK,MAAM,aAAa,SAAS,QAAQ,CAAC;AAKtD,UAAO,0BAJM,CACX,GAAG,OAAO,KAAK,IAAI,gBAAgB,EAAE,CAAC,EACtC,GAAG,OAAO,KAAK,IAAI,mBAAmB,EAAE,CAAC,CAC1C,CACqC;UAChC;AACN;;EAGJ,MAAM,SAAS,KAAK,QAAQ,QAAQ;AACpC,MAAI,WAAW,QAAS;AACxB,YAAU;;;AAKd,SAAS,SAAS,OAAkD;AAClE,QAAO,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM;;AAM5E,SAAS,mBAAmB,UAAuC;AACjE,QAAO,IAAI,oBAAoB,qBAAqB,SAAS,uDAAuD,kCAAkC,IAAI;;;;;;;;;;AAW5J,SAAgB,sBAAsB,SAAiB,UAAqC;AAC1F,KAAI,QAAQ,MAAM,KAAK,GAAI,QAAO,EAAE;CACpC,MAAM,eAAe,KAAK,WAAW,SAAS,GAAG,WAAW,KAAK,QAAQ,SAAS;CAClF,MAAM,MAAe,KAAK,WAAW,SAAS,EAAE,UAAU,cAAc,CAAC;AACzE,KAAI,CAAC,SAAS,IAAI,CAChB,OAAM,mBAAmB,SAAS;CAEpC,MAAM,SAAS,IAAI;AACnB,KAAI,WAAW,OACb,OAAM,mBAAmB,SAAS;AAEpC,KAAI,OAAO,WAAW,UAAU;AAC9B,MAAI,WAAW,kCACb,OAAM,IAAI,oBAAoB,qBAAqB,SAAS,kCAAkC,kCAAkC,UAAU,OAAO,IAAI;AAEvJ,SAAO;;AAET,KAAI,SAAS,OAAO,CAAE,QAAO;AAC7B,OAAM,mBAAmB,SAAS;;CAKpC,SAAW,KAAC,uDAAyD,EAAA,aAAa;AAChF,QAAO,sBAAsB;;;;;;KAM1B,kBAAkB,CAAC,CAAC,sBAAsB;;;;;;;;;IAS3C;EACF;CAEF,SAAW,KAAC,iDAAgD,EAAA,aAAgB;AAC1E,QAAO,sBAAsB,8CAA4C,kBAAkB,CAAC,CAAC,KAAK,kBAAkB;EACpH;CAEF,SAAW,KAAC,gEAAmE,EAAA,aAAY;AACzF,cAAa,sBAAsB,4BAA4B,kBAAkB,CAAC,CAAC,QAAQ,cAAc;EACzG;CAEF,SAAW,KAAC,iEAAoE,EAAA,aAAY;AAC1F,cAAa,sBAAsB,+CAA6C,kBAAkB,CAAC,CAAC,QAAQ,4BAA4B;EACxI;CAEF,SAAW,KAAC,gEAAgE,EAAA,aAAe;AACzF,cAAa,sBAAsB,uCAAuC,kBAAkB,CAAC,CAAC,SAAS;EACvG;CAEF,SAAW,KAAC,gEAAkE,EAAA,aAAa;AACzF,cAAa,sBAAsB;;;KAGhC,yCAAyC,CAAC,CAAC,SAAS;EACvD;CAEF,SAAW,KAAC,6FAAmF,EAAA,aAAyB;CAItH,MAAM,oBAAoB,sBAAsB,2BAA2B,kBAAkB;AAC7F,QAAO,YAAY,CAAC,SAAS;AAC7B,QAAO,YAAY,CAAC,IAAI,QAAQ,oBAAoB;EACpD"}

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

@@ -1,5 +1,3 @@
-import { hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, renderConfigFileContent, tryParseHexclaveConfigFileContent } from "./hexclave-config-file";
-
 //#region src/config-rendering.d.ts
 /**
  * Given a list of dependency names (from package.json), returns the SDK
@@ -8,10 +6,9 @@ import { hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, render
  */
 declare function detectConfigImportPackage(dependencies: string[]): string | undefined;
 /**
- * Walks up from `dir` to find the nearest `package.json` and returns the
- * best SDK package to use for the `HexclaveConfig` type import.
+ * Renders a config object into the source text of a `stack.config.ts` file.
  */
-declare function detectImportPackageFromDir(dir: string): string | undefined;
+declare function renderConfigFileContent(config: unknown, importPackage?: string): string;
 //#endregion
-export { detectConfigImportPackage, detectImportPackageFromDir, hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, renderConfigFileContent, tryParseHexclaveConfigFileContent };
+export { detectConfigImportPackage, renderConfigFileContent };
 //# sourceMappingURL=config-rendering.d.ts.map