@hexclave/shared 1.0.36 → 1.0.37

package/dist/esm/hexclave-config-file.js

@@ -1,144 +0,0 @@
-import * as parser from "@babel/parser";
-import * as t from "@babel/types";
-import { isValidConfig, normalize } from "./config/format.js";
-
-//#region src/hexclave-config-file.ts
-const showOnboardingHexclaveConfigValue = "show-onboarding";
-const DEFAULT_CONFIG_IMPORT_PACKAGE = "@hexclave/js";
-/**
-* Renders a config object into the source text of a `stack.config.ts` file.
-*
-* Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in
-* `config-rendering.ts` so dashboard client code can render config files
-* without pulling in `fs` / `path`.
-*/
-function renderConfigFileContent(config, importPackage) {
-	if (!isValidConfig(config)) throw new Error("Invalid config: expected a plain object.");
-	const droppedKeys = [];
-	const normalizedConfig = normalize(config, {
-		onDotIntoNonObject: "ignore",
-		onDotIntoNull: "empty-object",
-		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`;
-}
-function unwrapStaticConfigExpression(expression) {
-	if (t.isTSAsExpression(expression) || t.isTSSatisfiesExpression(expression) || t.isTSTypeAssertion(expression) || t.isTSNonNullExpression(expression)) return unwrapStaticConfigExpression(expression.expression);
-	return expression;
-}
-function evaluateStaticConfigExpression(expression) {
-	const unwrapped = unwrapStaticConfigExpression(expression);
-	if (t.isStringLiteral(unwrapped)) return unwrapped.value;
-	if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;
-	if (t.isNumericLiteral(unwrapped)) return unwrapped.value;
-	if (t.isNullLiteral(unwrapped)) return null;
-	if (t.isIdentifier(unwrapped) && unwrapped.name === "undefined") return void 0;
-	if (t.isUnaryExpression(unwrapped) && unwrapped.operator === "-" && t.isNumericLiteral(unwrapped.argument)) return -unwrapped.argument.value;
-	if (t.isArrayExpression(unwrapped)) return unwrapped.elements.map((element) => {
-		if (element == null || t.isSpreadElement(element)) throw new Error("Config arrays cannot contain holes or spreads.");
-		return evaluateStaticConfigExpression(element);
-	});
-	if (t.isObjectExpression(unwrapped)) {
-		const result = {};
-		for (const property of unwrapped.properties) {
-			if (t.isSpreadElement(property)) throw new Error("Config objects cannot contain spreads.");
-			if (property.computed) throw new Error("Config object keys cannot be computed.");
-			const key = t.isIdentifier(property.key) ? property.key.name : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key) ? String(property.key.value) : null;
-			if (key == null) throw new Error("Unsupported config object key.");
-			if (t.isObjectMethod(property)) throw new Error("Config objects cannot contain methods.");
-			if (!t.isExpression(property.value)) throw new Error("Unsupported config object value.");
-			result[key] = evaluateStaticConfigExpression(property.value);
-		}
-		return result;
-	}
-	throw new Error(`Unsupported config expression: ${unwrapped.type}`);
-}
-/**
-* Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
-* throwing when the file is not a plain static config (e.g. it wraps the config
-* in a helper call, references imported values, or has a syntax error). Useful
-* for deciding whether a config file can be safely regenerated deterministically
-* or whether it has custom structure that must be preserved.
-*/
-function tryParseHexclaveConfigFileContent(content, filePath) {
-	try {
-		return parseHexclaveConfigFileContent(content, filePath);
-	} catch {
-		return null;
-	}
-}
-/**
-* Returns whether `content` parses as a module that exports a `config` binding.
-* Used as a lightweight structural sanity check after editing config files whose
-* values can't be evaluated by our loader (e.g. they import external text
-* files), where a full semantic comparison isn't possible.
-*/
-function hexclaveConfigFileExportsConfig(content, filePath) {
-	let ast;
-	try {
-		ast = parser.parse(content, {
-			sourceType: "module",
-			sourceFilename: filePath,
-			plugins: ["typescript", "importAttributes"]
-		});
-	} catch {
-		return false;
-	}
-	for (const statement of ast.program.body) {
-		if (!t.isExportNamedDeclaration(statement)) continue;
-		if (statement.exportKind === "type") continue;
-		if (t.isVariableDeclaration(statement.declaration)) {
-			for (const declaration of statement.declaration.declarations) if (t.isIdentifier(declaration.id) && declaration.id.name === "config" && declaration.init != null) return true;
-		}
-		for (const specifier of statement.specifiers) if (t.isExportSpecifier(specifier) && specifier.exportKind !== "type") {
-			if ((t.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value) === "config") return true;
-		}
-	}
-	return false;
-}
-/**
-* Returns the relative import sources (those starting with `./` or `../`)
-* declared in `content`. Used to discover the external files a config update may
-* touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
-* they can be snapshotted and rolled back if an in-place update fails. Returns
-* an empty array if the file can't be parsed.
-*/
-function getRelativeImportSpecifiers(content) {
-	let ast;
-	try {
-		ast = parser.parse(content, {
-			sourceType: "module",
-			plugins: ["typescript", "importAttributes"]
-		});
-	} catch {
-		return [];
-	}
-	const sources = [];
-	for (const statement of ast.program.body) if (t.isImportDeclaration(statement)) {
-		const source = statement.source.value;
-		if (source.startsWith("./") || source.startsWith("../")) sources.push(source);
-	}
-	return sources;
-}
-function parseHexclaveConfigFileContent(content, filePath) {
-	if (content.trim() === "") return {};
-	const ast = parser.parse(content, {
-		sourceType: "module",
-		plugins: ["typescript", "importAttributes"]
-	});
-	for (const statement of ast.program.body) {
-		if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) continue;
-		for (const declaration of statement.declaration.declarations) {
-			if (!t.isIdentifier(declaration.id) || declaration.id.name !== "config") continue;
-			if (declaration.init == null || !t.isExpression(declaration.init)) throw new Error(`Config export in ${filePath} must have an initializer.`);
-			return evaluateStaticConfigExpression(declaration.init);
-		}
-	}
-	throw new Error(`Invalid config in ${filePath}. The file must export a plain \`config\` object or "show-onboarding".`);
-}
-
-//#endregion
-export { getRelativeImportSpecifiers, hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, renderConfigFileContent, showOnboardingHexclaveConfigValue, tryParseHexclaveConfigFileContent };
-//# sourceMappingURL=hexclave-config-file.js.map

package/dist/esm/hexclave-config-file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hexclave-config-file.js","names":[],"sources":["../../src/hexclave-config-file.ts"],"sourcesContent":["import * as parser from \"@babel/parser\";\nimport * as t from \"@babel/types\";\nimport { isValidConfig, normalize } from \"./config/format\";\n\nexport const showOnboardingHexclaveConfigValue = \"show-onboarding\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n *\n * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in\n * `config-rendering.ts` so dashboard client code can render config files\n * without pulling in `fs` / `path`.\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  // Import the `HexclaveConfig` type from the package's lightweight `/config`\n  // entrypoint, which is free of framework runtime code and therefore safe for\n  // tooling (e.g. the local dashboard) to load in a plain Node context. Only the\n  // Hexclave-branded packages expose this subpath; legacy `@stackframe/*`\n  // releases predate it, so fall back to their package root.\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\ntype ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;\n\nfunction unwrapStaticConfigExpression(expression: t.Expression): t.Expression {\n  if (\n    t.isTSAsExpression(expression)\n    || t.isTSSatisfiesExpression(expression)\n    || t.isTSTypeAssertion(expression)\n    || t.isTSNonNullExpression(expression)\n  ) {\n    return unwrapStaticConfigExpression(expression.expression);\n  }\n  return expression;\n}\n\nfunction evaluateStaticConfigExpression(expression: t.Expression): unknown {\n  const unwrapped = unwrapStaticConfigExpression(expression);\n  if (t.isStringLiteral(unwrapped)) return unwrapped.value;\n  if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNumericLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNullLiteral(unwrapped)) return null;\n  if (t.isIdentifier(unwrapped) && unwrapped.name === \"undefined\") return undefined;\n  if (t.isUnaryExpression(unwrapped) && unwrapped.operator === \"-\" && t.isNumericLiteral(unwrapped.argument)) {\n    return -unwrapped.argument.value;\n  }\n  if (t.isArrayExpression(unwrapped)) {\n    return unwrapped.elements.map((element) => {\n      if (element == null || t.isSpreadElement(element)) {\n        throw new Error(\"Config arrays cannot contain holes or spreads.\");\n      }\n      return evaluateStaticConfigExpression(element);\n    });\n  }\n  if (t.isObjectExpression(unwrapped)) {\n    const result: Record<string, unknown> = {};\n    for (const property of unwrapped.properties) {\n      if (t.isSpreadElement(property)) {\n        throw new Error(\"Config objects cannot contain spreads.\");\n      }\n      if (property.computed) {\n        throw new Error(\"Config object keys cannot be computed.\");\n      }\n      const key = t.isIdentifier(property.key)\n        ? property.key.name\n        : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key)\n          ? String(property.key.value)\n          : null;\n      if (key == null) {\n        throw new Error(\"Unsupported config object key.\");\n      }\n      if (t.isObjectMethod(property)) {\n        throw new Error(\"Config objects cannot contain methods.\");\n      }\n      if (!t.isExpression(property.value)) {\n        throw new Error(\"Unsupported config object value.\");\n      }\n      result[key] = evaluateStaticConfigExpression(property.value);\n    }\n    return result;\n  }\n  throw new Error(`Unsupported config expression: ${unwrapped.type}`);\n}\n\n/**\n * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of\n * throwing when the file is not a plain static config (e.g. it wraps the config\n * in a helper call, references imported values, or has a syntax error). Useful\n * for deciding whether a config file can be safely regenerated deterministically\n * or whether it has custom structure that must be preserved.\n */\nexport function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null {\n  try {\n    return parseHexclaveConfigFileContent(content, filePath);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Returns whether `content` parses as a module that exports a `config` binding.\n * Used as a lightweight structural sanity check after editing config files whose\n * values can't be evaluated by our loader (e.g. they import external text\n * files), where a full semantic comparison isn't possible.\n */\nexport function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      sourceFilename: filePath,\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return false;\n  }\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement)) {\n      continue;\n    }\n    // Ignore type-only exports (`export type { config }`): they don't produce a\n    // runtime `config` value, so they must not satisfy the structural check.\n    if (statement.exportKind === \"type\") {\n      continue;\n    }\n    if (t.isVariableDeclaration(statement.declaration)) {\n      for (const declaration of statement.declaration.declarations) {\n        if (t.isIdentifier(declaration.id) && declaration.id.name === \"config\" && declaration.init != null) {\n          return true;\n        }\n      }\n    }\n    for (const specifier of statement.specifiers) {\n      if (t.isExportSpecifier(specifier) && specifier.exportKind !== \"type\") {\n        const exportedName = t.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value;\n        if (exportedName === \"config\") {\n          return true;\n        }\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Returns the relative import sources (those starting with `./` or `../`)\n * declared in `content`. Used to discover the external files a config update may\n * touch — e.g. `import x from \"./welcome-email.tsx\" with { type: \"text\" }` — so\n * they can be snapshotted and rolled back if an in-place update fails. Returns\n * an empty array if the file can't be parsed.\n */\nexport function getRelativeImportSpecifiers(content: string): string[] {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return [];\n  }\n  const sources: string[] = [];\n  for (const statement of ast.program.body) {\n    if (t.isImportDeclaration(statement)) {\n      const source = statement.source.value;\n      if (source.startsWith(\"./\") || source.startsWith(\"../\")) {\n        sources.push(source);\n      }\n    }\n  }\n  return sources;\n}\n\nexport function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig {\n  if (content.trim() === \"\") return {};\n  const ast = parser.parse(content, {\n    sourceType: \"module\",\n    plugins: [\"typescript\", \"importAttributes\"],\n  });\n\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) {\n      continue;\n    }\n    for (const declaration of statement.declaration.declarations) {\n      if (!t.isIdentifier(declaration.id) || declaration.id.name !== \"config\") {\n        continue;\n      }\n      if (declaration.init == null || !t.isExpression(declaration.init)) {\n        throw new Error(`Config export in ${filePath} must have an initializer.`);\n      }\n      return evaluateStaticConfigExpression(declaration.init) as ParsedStackConfig;\n    }\n  }\n\n  throw new Error(`Invalid config in ${filePath}. The file must export a plain \\`config\\` object or \"show-onboarding\".`);\n}\n"],"mappings":"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"}

package/dist/hexclave-config-file.d.ts

@@ -1,38 +0,0 @@
-//#region src/hexclave-config-file.d.ts
-declare const showOnboardingHexclaveConfigValue = "show-onboarding";
-/**
- * Renders a config object into the source text of a `stack.config.ts` file.
- *
- * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in
- * `config-rendering.ts` so dashboard client code can render config files
- * without pulling in `fs` / `path`.
- */
-declare function renderConfigFileContent(config: unknown, importPackage?: string): string;
-type ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;
-/**
- * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
- * throwing when the file is not a plain static config (e.g. it wraps the config
- * in a helper call, references imported values, or has a syntax error). Useful
- * for deciding whether a config file can be safely regenerated deterministically
- * or whether it has custom structure that must be preserved.
- */
-declare function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null;
-/**
- * Returns whether `content` parses as a module that exports a `config` binding.
- * Used as a lightweight structural sanity check after editing config files whose
- * values can't be evaluated by our loader (e.g. they import external text
- * files), where a full semantic comparison isn't possible.
- */
-declare function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean;
-/**
- * Returns the relative import sources (those starting with `./` or `../`)
- * declared in `content`. Used to discover the external files a config update may
- * touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
- * they can be snapshotted and rolled back if an in-place update fails. Returns
- * an empty array if the file can't be parsed.
- */
-declare function getRelativeImportSpecifiers(content: string): string[];
-declare function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig;
-//#endregion
-export { getRelativeImportSpecifiers, hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, renderConfigFileContent, showOnboardingHexclaveConfigValue, tryParseHexclaveConfigFileContent };
-//# sourceMappingURL=hexclave-config-file.d.ts.map

package/dist/hexclave-config-file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hexclave-config-file.d.ts","names":[],"sources":["../src/hexclave-config-file.ts"],"mappings":";cAIa,iCAAA;AAAb;;;;;AAWA;;AAXA,iBAWgB,uBAAA,CAAwB,MAAA,WAAiB,aAAA;AAAA,KAyBpD,iBAAA,GAAoB,MAAA,2BAAiC,iCAAA;;AAFzD;;;;;AAuED;iBAAgB,iCAAA,CAAkC,OAAA,UAAiB,QAAA,WAAmB,iBAAA;;;;;;;iBActE,+BAAA,CAAgC,OAAA,UAAiB,QAAA;AAAjE;;;;;AA8CA;;AA9CA,iBA8CgB,2BAAA,CAA4B,OAAA;AAAA,iBAsB5B,8BAAA,CAA+B,OAAA,UAAiB,QAAA,WAAmB,iBAAA"}

package/dist/hexclave-config-file.js

@@ -1,153 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('./chunk-BE-pF4vm.js');
-let _babel_parser = require("@babel/parser");
-_babel_parser = require_chunk.__toESM(_babel_parser);
-let _babel_types = require("@babel/types");
-_babel_types = require_chunk.__toESM(_babel_types);
-let __config_format_js = require("./config/format.js");
-
-//#region src/hexclave-config-file.ts
-const showOnboardingHexclaveConfigValue = "show-onboarding";
-const DEFAULT_CONFIG_IMPORT_PACKAGE = "@hexclave/js";
-/**
-* Renders a config object into the source text of a `stack.config.ts` file.
-*
-* Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in
-* `config-rendering.ts` so dashboard client code can render config files
-* without pulling in `fs` / `path`.
-*/
-function renderConfigFileContent(config, importPackage) {
-	if (!(0, __config_format_js.isValidConfig)(config)) throw new Error("Invalid config: expected a plain object.");
-	const droppedKeys = [];
-	const normalizedConfig = (0, __config_format_js.normalize)(config, {
-		onDotIntoNonObject: "ignore",
-		onDotIntoNull: "empty-object",
-		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`;
-}
-function unwrapStaticConfigExpression(expression) {
-	if (_babel_types.isTSAsExpression(expression) || _babel_types.isTSSatisfiesExpression(expression) || _babel_types.isTSTypeAssertion(expression) || _babel_types.isTSNonNullExpression(expression)) return unwrapStaticConfigExpression(expression.expression);
-	return expression;
-}
-function evaluateStaticConfigExpression(expression) {
-	const unwrapped = unwrapStaticConfigExpression(expression);
-	if (_babel_types.isStringLiteral(unwrapped)) return unwrapped.value;
-	if (_babel_types.isBooleanLiteral(unwrapped)) return unwrapped.value;
-	if (_babel_types.isNumericLiteral(unwrapped)) return unwrapped.value;
-	if (_babel_types.isNullLiteral(unwrapped)) return null;
-	if (_babel_types.isIdentifier(unwrapped) && unwrapped.name === "undefined") return void 0;
-	if (_babel_types.isUnaryExpression(unwrapped) && unwrapped.operator === "-" && _babel_types.isNumericLiteral(unwrapped.argument)) return -unwrapped.argument.value;
-	if (_babel_types.isArrayExpression(unwrapped)) return unwrapped.elements.map((element) => {
-		if (element == null || _babel_types.isSpreadElement(element)) throw new Error("Config arrays cannot contain holes or spreads.");
-		return evaluateStaticConfigExpression(element);
-	});
-	if (_babel_types.isObjectExpression(unwrapped)) {
-		const result = {};
-		for (const property of unwrapped.properties) {
-			if (_babel_types.isSpreadElement(property)) throw new Error("Config objects cannot contain spreads.");
-			if (property.computed) throw new Error("Config object keys cannot be computed.");
-			const key = _babel_types.isIdentifier(property.key) ? property.key.name : _babel_types.isStringLiteral(property.key) || _babel_types.isNumericLiteral(property.key) ? String(property.key.value) : null;
-			if (key == null) throw new Error("Unsupported config object key.");
-			if (_babel_types.isObjectMethod(property)) throw new Error("Config objects cannot contain methods.");
-			if (!_babel_types.isExpression(property.value)) throw new Error("Unsupported config object value.");
-			result[key] = evaluateStaticConfigExpression(property.value);
-		}
-		return result;
-	}
-	throw new Error(`Unsupported config expression: ${unwrapped.type}`);
-}
-/**
-* Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
-* throwing when the file is not a plain static config (e.g. it wraps the config
-* in a helper call, references imported values, or has a syntax error). Useful
-* for deciding whether a config file can be safely regenerated deterministically
-* or whether it has custom structure that must be preserved.
-*/
-function tryParseHexclaveConfigFileContent(content, filePath) {
-	try {
-		return parseHexclaveConfigFileContent(content, filePath);
-	} catch {
-		return null;
-	}
-}
-/**
-* Returns whether `content` parses as a module that exports a `config` binding.
-* Used as a lightweight structural sanity check after editing config files whose
-* values can't be evaluated by our loader (e.g. they import external text
-* files), where a full semantic comparison isn't possible.
-*/
-function hexclaveConfigFileExportsConfig(content, filePath) {
-	let ast;
-	try {
-		ast = _babel_parser.parse(content, {
-			sourceType: "module",
-			sourceFilename: filePath,
-			plugins: ["typescript", "importAttributes"]
-		});
-	} catch {
-		return false;
-	}
-	for (const statement of ast.program.body) {
-		if (!_babel_types.isExportNamedDeclaration(statement)) continue;
-		if (statement.exportKind === "type") continue;
-		if (_babel_types.isVariableDeclaration(statement.declaration)) {
-			for (const declaration of statement.declaration.declarations) if (_babel_types.isIdentifier(declaration.id) && declaration.id.name === "config" && declaration.init != null) return true;
-		}
-		for (const specifier of statement.specifiers) if (_babel_types.isExportSpecifier(specifier) && specifier.exportKind !== "type") {
-			if ((_babel_types.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value) === "config") return true;
-		}
-	}
-	return false;
-}
-/**
-* Returns the relative import sources (those starting with `./` or `../`)
-* declared in `content`. Used to discover the external files a config update may
-* touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
-* they can be snapshotted and rolled back if an in-place update fails. Returns
-* an empty array if the file can't be parsed.
-*/
-function getRelativeImportSpecifiers(content) {
-	let ast;
-	try {
-		ast = _babel_parser.parse(content, {
-			sourceType: "module",
-			plugins: ["typescript", "importAttributes"]
-		});
-	} catch {
-		return [];
-	}
-	const sources = [];
-	for (const statement of ast.program.body) if (_babel_types.isImportDeclaration(statement)) {
-		const source = statement.source.value;
-		if (source.startsWith("./") || source.startsWith("../")) sources.push(source);
-	}
-	return sources;
-}
-function parseHexclaveConfigFileContent(content, filePath) {
-	if (content.trim() === "") return {};
-	const ast = _babel_parser.parse(content, {
-		sourceType: "module",
-		plugins: ["typescript", "importAttributes"]
-	});
-	for (const statement of ast.program.body) {
-		if (!_babel_types.isExportNamedDeclaration(statement) || !_babel_types.isVariableDeclaration(statement.declaration)) continue;
-		for (const declaration of statement.declaration.declarations) {
-			if (!_babel_types.isIdentifier(declaration.id) || declaration.id.name !== "config") continue;
-			if (declaration.init == null || !_babel_types.isExpression(declaration.init)) throw new Error(`Config export in ${filePath} must have an initializer.`);
-			return evaluateStaticConfigExpression(declaration.init);
-		}
-	}
-	throw new Error(`Invalid config in ${filePath}. The file must export a plain \`config\` object or "show-onboarding".`);
-}
-
-//#endregion
-exports.getRelativeImportSpecifiers = getRelativeImportSpecifiers;
-exports.hexclaveConfigFileExportsConfig = hexclaveConfigFileExportsConfig;
-exports.parseHexclaveConfigFileContent = parseHexclaveConfigFileContent;
-exports.renderConfigFileContent = renderConfigFileContent;
-exports.showOnboardingHexclaveConfigValue = showOnboardingHexclaveConfigValue;
-exports.tryParseHexclaveConfigFileContent = tryParseHexclaveConfigFileContent;
-//# sourceMappingURL=hexclave-config-file.js.map

package/dist/hexclave-config-file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hexclave-config-file.js","names":["t","parser"],"sources":["../src/hexclave-config-file.ts"],"sourcesContent":["import * as parser from \"@babel/parser\";\nimport * as t from \"@babel/types\";\nimport { isValidConfig, normalize } from \"./config/format\";\n\nexport const showOnboardingHexclaveConfigValue = \"show-onboarding\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n *\n * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in\n * `config-rendering.ts` so dashboard client code can render config files\n * without pulling in `fs` / `path`.\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  // Import the `HexclaveConfig` type from the package's lightweight `/config`\n  // entrypoint, which is free of framework runtime code and therefore safe for\n  // tooling (e.g. the local dashboard) to load in a plain Node context. Only the\n  // Hexclave-branded packages expose this subpath; legacy `@stackframe/*`\n  // releases predate it, so fall back to their package root.\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\ntype ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;\n\nfunction unwrapStaticConfigExpression(expression: t.Expression): t.Expression {\n  if (\n    t.isTSAsExpression(expression)\n    || t.isTSSatisfiesExpression(expression)\n    || t.isTSTypeAssertion(expression)\n    || t.isTSNonNullExpression(expression)\n  ) {\n    return unwrapStaticConfigExpression(expression.expression);\n  }\n  return expression;\n}\n\nfunction evaluateStaticConfigExpression(expression: t.Expression): unknown {\n  const unwrapped = unwrapStaticConfigExpression(expression);\n  if (t.isStringLiteral(unwrapped)) return unwrapped.value;\n  if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNumericLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNullLiteral(unwrapped)) return null;\n  if (t.isIdentifier(unwrapped) && unwrapped.name === \"undefined\") return undefined;\n  if (t.isUnaryExpression(unwrapped) && unwrapped.operator === \"-\" && t.isNumericLiteral(unwrapped.argument)) {\n    return -unwrapped.argument.value;\n  }\n  if (t.isArrayExpression(unwrapped)) {\n    return unwrapped.elements.map((element) => {\n      if (element == null || t.isSpreadElement(element)) {\n        throw new Error(\"Config arrays cannot contain holes or spreads.\");\n      }\n      return evaluateStaticConfigExpression(element);\n    });\n  }\n  if (t.isObjectExpression(unwrapped)) {\n    const result: Record<string, unknown> = {};\n    for (const property of unwrapped.properties) {\n      if (t.isSpreadElement(property)) {\n        throw new Error(\"Config objects cannot contain spreads.\");\n      }\n      if (property.computed) {\n        throw new Error(\"Config object keys cannot be computed.\");\n      }\n      const key = t.isIdentifier(property.key)\n        ? property.key.name\n        : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key)\n          ? String(property.key.value)\n          : null;\n      if (key == null) {\n        throw new Error(\"Unsupported config object key.\");\n      }\n      if (t.isObjectMethod(property)) {\n        throw new Error(\"Config objects cannot contain methods.\");\n      }\n      if (!t.isExpression(property.value)) {\n        throw new Error(\"Unsupported config object value.\");\n      }\n      result[key] = evaluateStaticConfigExpression(property.value);\n    }\n    return result;\n  }\n  throw new Error(`Unsupported config expression: ${unwrapped.type}`);\n}\n\n/**\n * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of\n * throwing when the file is not a plain static config (e.g. it wraps the config\n * in a helper call, references imported values, or has a syntax error). Useful\n * for deciding whether a config file can be safely regenerated deterministically\n * or whether it has custom structure that must be preserved.\n */\nexport function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null {\n  try {\n    return parseHexclaveConfigFileContent(content, filePath);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Returns whether `content` parses as a module that exports a `config` binding.\n * Used as a lightweight structural sanity check after editing config files whose\n * values can't be evaluated by our loader (e.g. they import external text\n * files), where a full semantic comparison isn't possible.\n */\nexport function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      sourceFilename: filePath,\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return false;\n  }\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement)) {\n      continue;\n    }\n    // Ignore type-only exports (`export type { config }`): they don't produce a\n    // runtime `config` value, so they must not satisfy the structural check.\n    if (statement.exportKind === \"type\") {\n      continue;\n    }\n    if (t.isVariableDeclaration(statement.declaration)) {\n      for (const declaration of statement.declaration.declarations) {\n        if (t.isIdentifier(declaration.id) && declaration.id.name === \"config\" && declaration.init != null) {\n          return true;\n        }\n      }\n    }\n    for (const specifier of statement.specifiers) {\n      if (t.isExportSpecifier(specifier) && specifier.exportKind !== \"type\") {\n        const exportedName = t.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value;\n        if (exportedName === \"config\") {\n          return true;\n        }\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Returns the relative import sources (those starting with `./` or `../`)\n * declared in `content`. Used to discover the external files a config update may\n * touch — e.g. `import x from \"./welcome-email.tsx\" with { type: \"text\" }` — so\n * they can be snapshotted and rolled back if an in-place update fails. Returns\n * an empty array if the file can't be parsed.\n */\nexport function getRelativeImportSpecifiers(content: string): string[] {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return [];\n  }\n  const sources: string[] = [];\n  for (const statement of ast.program.body) {\n    if (t.isImportDeclaration(statement)) {\n      const source = statement.source.value;\n      if (source.startsWith(\"./\") || source.startsWith(\"../\")) {\n        sources.push(source);\n      }\n    }\n  }\n  return sources;\n}\n\nexport function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig {\n  if (content.trim() === \"\") return {};\n  const ast = parser.parse(content, {\n    sourceType: \"module\",\n    plugins: [\"typescript\", \"importAttributes\"],\n  });\n\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) {\n      continue;\n    }\n    for (const declaration of statement.declaration.declarations) {\n      if (!t.isIdentifier(declaration.id) || declaration.id.name !== \"config\") {\n        continue;\n      }\n      if (declaration.init == null || !t.isExpression(declaration.init)) {\n        throw new Error(`Config export in ${filePath} must have an initializer.`);\n      }\n      return evaluateStaticConfigExpression(declaration.init) as ParsedStackConfig;\n    }\n  }\n\n  throw new Error(`Invalid config in ${filePath}. The file must export a plain \\`config\\` object or \"show-onboarding\".`);\n}\n"],"mappings":"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"}

package/src/hexclave-config-file.ts

@@ -1,215 +0,0 @@
-import * as parser from "@babel/parser";
-import * as t from "@babel/types";
-import { isValidConfig, normalize } from "./config/format";
-
-export const showOnboardingHexclaveConfigValue = "show-onboarding";
-
-const DEFAULT_CONFIG_IMPORT_PACKAGE = "@hexclave/js";
-
-/**
- * Renders a config object into the source text of a `stack.config.ts` file.
- *
- * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in
- * `config-rendering.ts` so dashboard client code can render config files
- * without pulling in `fs` / `path`.
- */
-export function renderConfigFileContent(config: unknown, importPackage?: string): string {
-  if (!isValidConfig(config)) {
-    throw new Error("Invalid config: expected a plain object.");
-  }
-
-  const droppedKeys: string[] = [];
-  const normalizedConfig = normalize(config, {
-    onDotIntoNonObject: "ignore",
-    onDotIntoNull: "empty-object",
-    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;
-  // Import the `HexclaveConfig` type from the package's lightweight `/config`
-  // entrypoint, which is free of framework runtime code and therefore safe for
-  // tooling (e.g. the local dashboard) to load in a plain Node context. Only the
-  // Hexclave-branded packages expose this subpath; legacy `@stackframe/*`
-  // releases predate it, so fall back to their package root.
-  const importSpecifier = pkg.startsWith("@hexclave/") ? `${pkg}/config` : pkg;
-  const importLine = `import type { HexclaveConfig } from "${importSpecifier}";`;
-  return `${importLine}\n\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\n`;
-}
-
-type ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;
-
-function unwrapStaticConfigExpression(expression: t.Expression): t.Expression {
-  if (
-    t.isTSAsExpression(expression)
-    || t.isTSSatisfiesExpression(expression)
-    || t.isTSTypeAssertion(expression)
-    || t.isTSNonNullExpression(expression)
-  ) {
-    return unwrapStaticConfigExpression(expression.expression);
-  }
-  return expression;
-}
-
-function evaluateStaticConfigExpression(expression: t.Expression): unknown {
-  const unwrapped = unwrapStaticConfigExpression(expression);
-  if (t.isStringLiteral(unwrapped)) return unwrapped.value;
-  if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;
-  if (t.isNumericLiteral(unwrapped)) return unwrapped.value;
-  if (t.isNullLiteral(unwrapped)) return null;
-  if (t.isIdentifier(unwrapped) && unwrapped.name === "undefined") return undefined;
-  if (t.isUnaryExpression(unwrapped) && unwrapped.operator === "-" && t.isNumericLiteral(unwrapped.argument)) {
-    return -unwrapped.argument.value;
-  }
-  if (t.isArrayExpression(unwrapped)) {
-    return unwrapped.elements.map((element) => {
-      if (element == null || t.isSpreadElement(element)) {
-        throw new Error("Config arrays cannot contain holes or spreads.");
-      }
-      return evaluateStaticConfigExpression(element);
-    });
-  }
-  if (t.isObjectExpression(unwrapped)) {
-    const result: Record<string, unknown> = {};
-    for (const property of unwrapped.properties) {
-      if (t.isSpreadElement(property)) {
-        throw new Error("Config objects cannot contain spreads.");
-      }
-      if (property.computed) {
-        throw new Error("Config object keys cannot be computed.");
-      }
-      const key = t.isIdentifier(property.key)
-        ? property.key.name
-        : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key)
-          ? String(property.key.value)
-          : null;
-      if (key == null) {
-        throw new Error("Unsupported config object key.");
-      }
-      if (t.isObjectMethod(property)) {
-        throw new Error("Config objects cannot contain methods.");
-      }
-      if (!t.isExpression(property.value)) {
-        throw new Error("Unsupported config object value.");
-      }
-      result[key] = evaluateStaticConfigExpression(property.value);
-    }
-    return result;
-  }
-  throw new Error(`Unsupported config expression: ${unwrapped.type}`);
-}
-
-/**
- * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
- * throwing when the file is not a plain static config (e.g. it wraps the config
- * in a helper call, references imported values, or has a syntax error). Useful
- * for deciding whether a config file can be safely regenerated deterministically
- * or whether it has custom structure that must be preserved.
- */
-export function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null {
-  try {
-    return parseHexclaveConfigFileContent(content, filePath);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Returns whether `content` parses as a module that exports a `config` binding.
- * Used as a lightweight structural sanity check after editing config files whose
- * values can't be evaluated by our loader (e.g. they import external text
- * files), where a full semantic comparison isn't possible.
- */
-export function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean {
-  let ast: parser.ParseResult<t.File>;
-  try {
-    ast = parser.parse(content, {
-      sourceType: "module",
-      sourceFilename: filePath,
-      plugins: ["typescript", "importAttributes"],
-    });
-  } catch {
-    return false;
-  }
-  for (const statement of ast.program.body) {
-    if (!t.isExportNamedDeclaration(statement)) {
-      continue;
-    }
-    // Ignore type-only exports (`export type { config }`): they don't produce a
-    // runtime `config` value, so they must not satisfy the structural check.
-    if (statement.exportKind === "type") {
-      continue;
-    }
-    if (t.isVariableDeclaration(statement.declaration)) {
-      for (const declaration of statement.declaration.declarations) {
-        if (t.isIdentifier(declaration.id) && declaration.id.name === "config" && declaration.init != null) {
-          return true;
-        }
-      }
-    }
-    for (const specifier of statement.specifiers) {
-      if (t.isExportSpecifier(specifier) && specifier.exportKind !== "type") {
-        const exportedName = t.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value;
-        if (exportedName === "config") {
-          return true;
-        }
-      }
-    }
-  }
-  return false;
-}
-
-/**
- * Returns the relative import sources (those starting with `./` or `../`)
- * declared in `content`. Used to discover the external files a config update may
- * touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
- * they can be snapshotted and rolled back if an in-place update fails. Returns
- * an empty array if the file can't be parsed.
- */
-export function getRelativeImportSpecifiers(content: string): string[] {
-  let ast: parser.ParseResult<t.File>;
-  try {
-    ast = parser.parse(content, {
-      sourceType: "module",
-      plugins: ["typescript", "importAttributes"],
-    });
-  } catch {
-    return [];
-  }
-  const sources: string[] = [];
-  for (const statement of ast.program.body) {
-    if (t.isImportDeclaration(statement)) {
-      const source = statement.source.value;
-      if (source.startsWith("./") || source.startsWith("../")) {
-        sources.push(source);
-      }
-    }
-  }
-  return sources;
-}
-
-export function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig {
-  if (content.trim() === "") return {};
-  const ast = parser.parse(content, {
-    sourceType: "module",
-    plugins: ["typescript", "importAttributes"],
-  });
-
-  for (const statement of ast.program.body) {
-    if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) {
-      continue;
-    }
-    for (const declaration of statement.declaration.declarations) {
-      if (!t.isIdentifier(declaration.id) || declaration.id.name !== "config") {
-        continue;
-      }
-      if (declaration.init == null || !t.isExpression(declaration.init)) {
-        throw new Error(`Config export in ${filePath} must have an initializer.`);
-      }
-      return evaluateStaticConfigExpression(declaration.init) as ParsedStackConfig;
-    }
-  }
-
-  throw new Error(`Invalid config in ${filePath}. The file must export a plain \`config\` object or "show-onboarding".`);
-}