@databricks/appkit 0.5.4 → 0.6.0

package/dist/registry/manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.d.ts","names":[],"sources":["../../src/registry/manifest-loader.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DA;;;;;AA4FA;;AAAgD,iBA5FhC,iBAAA,CA4FgC,MAAA,EA5FN,iBA4FM,CAAA,EA5Fc,cA4Fd;;;;;;;;;;;;;;;;;;;iBAAhC,uBAAA,SAAgC"}

package/dist/registry/manifest-loader.js

@@ -0,0 +1,97 @@
+import { createLogger } from "../logging/logger.js";
+import { ConfigurationError } from "../errors/configuration.js";
+import { init_errors } from "../errors/index.js";
+import { PERMISSIONS_BY_TYPE, ResourceType } from "./types.js";
+
+//#region src/registry/manifest-loader.ts
+init_errors();
+const logger = createLogger("manifest-loader");
+function normalizeType(s) {
+	const v = Object.values(ResourceType).find((x) => x === s);
+	if (v !== void 0) return v;
+	throw new ConfigurationError(`Invalid resource type: "${s}". Valid: ${Object.values(ResourceType).join(", ")}`);
+}
+function normalizePermission(type, s) {
+	const allowed = PERMISSIONS_BY_TYPE[type];
+	if (allowed.includes(s)) return s;
+	throw new ConfigurationError(`Invalid permission "${s}" for type ${type}. Valid: ${allowed.join(", ")}`);
+}
+function normalizeResource(r) {
+	const type = normalizeType(r.type);
+	const permission = normalizePermission(type, r.permission);
+	return {
+		...r,
+		type,
+		permission,
+		required: false
+	};
+}
+/**
+* Loads and validates the manifest from a plugin constructor.
+* Normalizes string type/permission to strict ResourceType/ResourcePermission.
+*
+* @param plugin - The plugin constructor class
+* @returns The validated, normalized plugin manifest
+* @throws {ConfigurationError} If the manifest is missing, invalid, or has invalid resource type/permission
+*/
+function getPluginManifest(plugin) {
+	const pluginName = plugin.name || "unknown";
+	if (!plugin.manifest) throw new ConfigurationError(`Plugin ${pluginName} is missing a manifest. All plugins must declare a static manifest property.`);
+	const raw = plugin.manifest;
+	if (!raw.name || typeof raw.name !== "string") throw new ConfigurationError(`Plugin ${pluginName} manifest has missing or invalid 'name' field`);
+	if (!raw.displayName || typeof raw.displayName !== "string") throw new ConfigurationError(`Plugin ${raw.name} manifest has missing or invalid 'displayName' field`);
+	if (!raw.description || typeof raw.description !== "string") throw new ConfigurationError(`Plugin ${raw.name} manifest has missing or invalid 'description' field`);
+	if (!raw.resources) throw new ConfigurationError(`Plugin ${raw.name} manifest is missing 'resources' field`);
+	if (!Array.isArray(raw.resources.required)) throw new ConfigurationError(`Plugin ${raw.name} manifest has invalid 'resources.required' field (expected array)`);
+	if (raw.resources.optional !== void 0 && !Array.isArray(raw.resources.optional)) throw new ConfigurationError(`Plugin ${raw.name} manifest has invalid 'resources.optional' field (expected array)`);
+	const required = raw.resources.required.map((r) => {
+		const { required: _, ...rest } = normalizeResource(r);
+		return rest;
+	});
+	const optional = (raw.resources.optional || []).map((r) => {
+		const { required: _, ...rest } = normalizeResource(r);
+		return rest;
+	});
+	logger.debug("Loaded manifest for plugin %s: %d required resources, %d optional resources", raw.name, required.length, optional.length);
+	return {
+		...raw,
+		resources: {
+			required,
+			optional
+		}
+	};
+}
+/**
+* Gets the resource requirements from a plugin's manifest.
+*
+* Combines required and optional resources into a single array with the
+* `required` flag set appropriately.
+*
+* @param plugin - The plugin constructor class
+* @returns Combined array of required and optional resources
+* @throws {ConfigurationError} If the plugin manifest is missing or invalid
+*
+* @example
+* ```typescript
+* const resources = getResourceRequirements(AnalyticsPlugin);
+* for (const resource of resources) {
+*   console.log(`${resource.type}: ${resource.description} (required: ${resource.required})`);
+* }
+* ```
+*/
+function getResourceRequirements(plugin) {
+	const manifest = getPluginManifest(plugin);
+	const required = manifest.resources.required.map((r) => ({
+		...r,
+		required: true
+	}));
+	const optional = (manifest.resources.optional || []).map((r) => ({
+		...r,
+		required: false
+	}));
+	return [...required, ...optional];
+}
+
+//#endregion
+export { getPluginManifest, getResourceRequirements };
+//# sourceMappingURL=manifest-loader.js.map

package/dist/registry/manifest-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.js","names":[],"sources":["../../src/registry/manifest-loader.ts"],"sourcesContent":["import type { PluginConstructor } from \"shared\";\nimport { ConfigurationError } from \"../errors\";\nimport { createLogger } from \"../logging/logger\";\nimport type {\n  PluginManifest,\n  ResourcePermission,\n  ResourceRequirement,\n} from \"./types\";\nimport { PERMISSIONS_BY_TYPE, ResourceType } from \"./types\";\n\nconst logger = createLogger(\"manifest-loader\");\n\n/** Loose resource from shared/manifest (string type and permission). */\ninterface LooseResource {\n  type: string;\n  alias: string;\n  resourceKey: string;\n  description: string;\n  permission: string;\n  fields: Record<string, { env: string; description?: string }>;\n}\n\nfunction normalizeType(s: string): ResourceType {\n  const v = Object.values(ResourceType).find((x) => x === s);\n  if (v !== undefined) return v;\n  throw new ConfigurationError(\n    `Invalid resource type: \"${s}\". Valid: ${Object.values(ResourceType).join(\", \")}`,\n  );\n}\n\nfunction normalizePermission(\n  type: ResourceType,\n  s: string,\n): ResourcePermission {\n  const allowed = PERMISSIONS_BY_TYPE[type];\n  if (allowed.includes(s as ResourcePermission)) return s as ResourcePermission;\n  throw new ConfigurationError(\n    `Invalid permission \"${s}\" for type ${type}. Valid: ${allowed.join(\", \")}`,\n  );\n}\n\nfunction normalizeResource(r: LooseResource): ResourceRequirement {\n  const type = normalizeType(r.type);\n  const permission = normalizePermission(type, r.permission);\n  return {\n    ...r,\n    type,\n    permission,\n    required: false,\n  };\n}\n\n/**\n * Loads and validates the manifest from a plugin constructor.\n * Normalizes string type/permission to strict ResourceType/ResourcePermission.\n *\n * @param plugin - The plugin constructor class\n * @returns The validated, normalized plugin manifest\n * @throws {ConfigurationError} If the manifest is missing, invalid, or has invalid resource type/permission\n */\nexport function getPluginManifest(plugin: PluginConstructor): PluginManifest {\n  const pluginName = plugin.name || \"unknown\";\n\n  if (!plugin.manifest) {\n    throw new ConfigurationError(\n      `Plugin ${pluginName} is missing a manifest. All plugins must declare a static manifest property.`,\n    );\n  }\n\n  const raw = plugin.manifest;\n\n  if (!raw.name || typeof raw.name !== \"string\") {\n    throw new ConfigurationError(\n      `Plugin ${pluginName} manifest has missing or invalid 'name' field`,\n    );\n  }\n\n  if (!raw.displayName || typeof raw.displayName !== \"string\") {\n    throw new ConfigurationError(\n      `Plugin ${raw.name} manifest has missing or invalid 'displayName' field`,\n    );\n  }\n\n  if (!raw.description || typeof raw.description !== \"string\") {\n    throw new ConfigurationError(\n      `Plugin ${raw.name} manifest has missing or invalid 'description' field`,\n    );\n  }\n\n  if (!raw.resources) {\n    throw new ConfigurationError(\n      `Plugin ${raw.name} manifest is missing 'resources' field`,\n    );\n  }\n\n  if (!Array.isArray(raw.resources.required)) {\n    throw new ConfigurationError(\n      `Plugin ${raw.name} manifest has invalid 'resources.required' field (expected array)`,\n    );\n  }\n\n  if (\n    raw.resources.optional !== undefined &&\n    !Array.isArray(raw.resources.optional)\n  ) {\n    throw new ConfigurationError(\n      `Plugin ${raw.name} manifest has invalid 'resources.optional' field (expected array)`,\n    );\n  }\n\n  const required = raw.resources.required.map((r) => {\n    const norm = normalizeResource(r as LooseResource);\n    const { required: _, ...rest } = norm;\n    return rest;\n  });\n  const optional = (raw.resources.optional || []).map((r) => {\n    const norm = normalizeResource(r as LooseResource);\n    const { required: _, ...rest } = norm;\n    return rest;\n  });\n\n  logger.debug(\n    \"Loaded manifest for plugin %s: %d required resources, %d optional resources\",\n    raw.name,\n    required.length,\n    optional.length,\n  );\n\n  return {\n    ...raw,\n    resources: { required, optional },\n  };\n}\n\n/**\n * Gets the resource requirements from a plugin's manifest.\n *\n * Combines required and optional resources into a single array with the\n * `required` flag set appropriately.\n *\n * @param plugin - The plugin constructor class\n * @returns Combined array of required and optional resources\n * @throws {ConfigurationError} If the plugin manifest is missing or invalid\n *\n * @example\n * ```typescript\n * const resources = getResourceRequirements(AnalyticsPlugin);\n * for (const resource of resources) {\n *   console.log(`${resource.type}: ${resource.description} (required: ${resource.required})`);\n * }\n * ```\n */\nexport function getResourceRequirements(plugin: PluginConstructor) {\n  const manifest = getPluginManifest(plugin);\n\n  const required = manifest.resources.required.map((r) => ({\n    ...r,\n    required: true,\n  }));\n  const optional = (manifest.resources.optional || []).map((r) => ({\n    ...r,\n    required: false,\n  }));\n\n  return [...required, ...optional];\n}\n\n/**\n * Validates a manifest object structure.\n *\n * @param manifest - The manifest object to validate\n * @returns true if the manifest is valid, false otherwise\n *\n * @internal\n */\nexport function isValidManifest(manifest: unknown): manifest is PluginManifest {\n  if (!manifest || typeof manifest !== \"object\") {\n    return false;\n  }\n\n  const m = manifest as Record<string, unknown>;\n\n  // Check required fields\n  if (typeof m.name !== \"string\") return false;\n  if (typeof m.displayName !== \"string\") return false;\n  if (typeof m.description !== \"string\") return false;\n\n  // Check resources structure\n  if (!m.resources || typeof m.resources !== \"object\") return false;\n\n  const resources = m.resources as Record<string, unknown>;\n  if (!Array.isArray(resources.required)) return false;\n\n  // Optional field can be missing or must be an array\n  if (resources.optional !== undefined && !Array.isArray(resources.optional)) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;;aAC+C;AAS/C,MAAM,SAAS,aAAa,kBAAkB;AAY9C,SAAS,cAAc,GAAyB;CAC9C,MAAM,IAAI,OAAO,OAAO,aAAa,CAAC,MAAM,MAAM,MAAM,EAAE;AAC1D,KAAI,MAAM,OAAW,QAAO;AAC5B,OAAM,IAAI,mBACR,2BAA2B,EAAE,YAAY,OAAO,OAAO,aAAa,CAAC,KAAK,KAAK,GAChF;;AAGH,SAAS,oBACP,MACA,GACoB;CACpB,MAAM,UAAU,oBAAoB;AACpC,KAAI,QAAQ,SAAS,EAAwB,CAAE,QAAO;AACtD,OAAM,IAAI,mBACR,uBAAuB,EAAE,aAAa,KAAK,WAAW,QAAQ,KAAK,KAAK,GACzE;;AAGH,SAAS,kBAAkB,GAAuC;CAChE,MAAM,OAAO,cAAc,EAAE,KAAK;CAClC,MAAM,aAAa,oBAAoB,MAAM,EAAE,WAAW;AAC1D,QAAO;EACL,GAAG;EACH;EACA;EACA,UAAU;EACX;;;;;;;;;;AAWH,SAAgB,kBAAkB,QAA2C;CAC3E,MAAM,aAAa,OAAO,QAAQ;AAElC,KAAI,CAAC,OAAO,SACV,OAAM,IAAI,mBACR,UAAU,WAAW,8EACtB;CAGH,MAAM,MAAM,OAAO;AAEnB,KAAI,CAAC,IAAI,QAAQ,OAAO,IAAI,SAAS,SACnC,OAAM,IAAI,mBACR,UAAU,WAAW,+CACtB;AAGH,KAAI,CAAC,IAAI,eAAe,OAAO,IAAI,gBAAgB,SACjD,OAAM,IAAI,mBACR,UAAU,IAAI,KAAK,sDACpB;AAGH,KAAI,CAAC,IAAI,eAAe,OAAO,IAAI,gBAAgB,SACjD,OAAM,IAAI,mBACR,UAAU,IAAI,KAAK,sDACpB;AAGH,KAAI,CAAC,IAAI,UACP,OAAM,IAAI,mBACR,UAAU,IAAI,KAAK,wCACpB;AAGH,KAAI,CAAC,MAAM,QAAQ,IAAI,UAAU,SAAS,CACxC,OAAM,IAAI,mBACR,UAAU,IAAI,KAAK,mEACpB;AAGH,KACE,IAAI,UAAU,aAAa,UAC3B,CAAC,MAAM,QAAQ,IAAI,UAAU,SAAS,CAEtC,OAAM,IAAI,mBACR,UAAU,IAAI,KAAK,mEACpB;CAGH,MAAM,WAAW,IAAI,UAAU,SAAS,KAAK,MAAM;EAEjD,MAAM,EAAE,UAAU,GAAG,GAAG,SADX,kBAAkB,EAAmB;AAElD,SAAO;GACP;CACF,MAAM,YAAY,IAAI,UAAU,YAAY,EAAE,EAAE,KAAK,MAAM;EAEzD,MAAM,EAAE,UAAU,GAAG,GAAG,SADX,kBAAkB,EAAmB;AAElD,SAAO;GACP;AAEF,QAAO,MACL,+EACA,IAAI,MACJ,SAAS,QACT,SAAS,OACV;AAED,QAAO;EACL,GAAG;EACH,WAAW;GAAE;GAAU;GAAU;EAClC;;;;;;;;;;;;;;;;;;;;AAqBH,SAAgB,wBAAwB,QAA2B;CACjE,MAAM,WAAW,kBAAkB,OAAO;CAE1C,MAAM,WAAW,SAAS,UAAU,SAAS,KAAK,OAAO;EACvD,GAAG;EACH,UAAU;EACX,EAAE;CACH,MAAM,YAAY,SAAS,UAAU,YAAY,EAAE,EAAE,KAAK,OAAO;EAC/D,GAAG;EACH,UAAU;EACX,EAAE;AAEH,QAAO,CAAC,GAAG,UAAU,GAAG,SAAS"}

package/dist/registry/resource-registry.d.ts

@@ -0,0 +1,133 @@
+import { PluginConstructor, PluginData } from "../shared/src/plugin.js";
+import { ResourceEntry, ResourceRequirement, ValidationResult } from "./types.js";
+
+//#region src/registry/resource-registry.d.ts
+
+/**
+ * Central registry for tracking plugin resource requirements.
+ * Deduplication uses type + resourceKey (machine-stable); alias is for display only.
+ */
+declare class ResourceRegistry {
+  private resources;
+  /**
+   * Registers a resource requirement for a plugin.
+   * If a resource with the same type+resourceKey already exists, merges them:
+   * - Combines plugin names (comma-separated)
+   * - Uses the most permissive permission (per-type hierarchy)
+   * - Marks as required if any plugin requires it
+   * - Combines descriptions if they differ
+   * - Merges fields; warns when same field name uses different env vars
+   *
+   * @param plugin - Name of the plugin registering the resource
+   * @param resource - Resource requirement specification
+   */
+  register(plugin: string, resource: ResourceRequirement): void;
+  /**
+   * Collects and registers resource requirements from an array of plugins.
+   * For each plugin, loads its manifest (required) and runtime resource requirements.
+   *
+   * @param rawPlugins - Array of plugin data entries from createApp configuration
+   * @throws {ConfigurationError} If any plugin is missing a manifest or manifest is invalid
+   */
+  collectResources(rawPlugins: PluginData<PluginConstructor, unknown, string>[]): void;
+  /**
+   * Merges a new resource requirement with an existing entry.
+   * Applies intelligent merging logic for conflicting properties.
+   */
+  private mergeResources;
+  /**
+   * Retrieves all registered resources.
+   * Returns a copy of the array to prevent external mutations.
+   *
+   * @returns Array of all registered resource entries
+   */
+  getAll(): ResourceEntry[];
+  /**
+   * Gets a specific resource by type and resourceKey (dedup key).
+   *
+   * @param type - Resource type
+   * @param resourceKey - Stable machine key (not alias; alias is for display only)
+   * @returns The resource entry if found, undefined otherwise
+   */
+  get(type: string, resourceKey: string): ResourceEntry | undefined;
+  /**
+   * Clears all registered resources.
+   * Useful for testing or when rebuilding the registry.
+   */
+  clear(): void;
+  /**
+   * Returns the number of registered resources.
+   */
+  size(): number;
+  /**
+   * Gets all resources required by a specific plugin.
+   *
+   * @param pluginName - Name of the plugin
+   * @returns Array of resources where the plugin is listed as a requester
+   */
+  getByPlugin(pluginName: string): ResourceEntry[];
+  /**
+   * Gets all required resources (where required=true).
+   *
+   * @returns Array of required resource entries
+   */
+  getRequired(): ResourceEntry[];
+  /**
+   * Gets all optional resources (where required=false).
+   *
+   * @returns Array of optional resource entries
+   */
+  getOptional(): ResourceEntry[];
+  /**
+   * Validates all registered resources against the environment.
+   *
+   * Checks each resource's field environment variables to determine if it's resolved.
+   * Updates the `resolved` and `values` fields on each resource entry.
+   *
+   * Only required resources affect the `valid` status - optional resources
+   * are checked but don't cause validation failure.
+   *
+   * @returns ValidationResult with validity status, missing resources, and all resources
+   *
+   * @example
+   * ```typescript
+   * const registry = ResourceRegistry.getInstance();
+   * const result = registry.validate();
+   *
+   * if (!result.valid) {
+   *   console.error("Missing resources:", result.missing.map(r => Object.values(r.fields).map(f => f.env)));
+   * }
+   * ```
+   */
+  validate(): ValidationResult;
+  /**
+   * Validates all registered resources and enforces the result.
+   *
+   * - In production: throws a {@link ConfigurationError} if any required resources are missing.
+   * - In development (`NODE_ENV=development`): logs a warning but continues, unless
+   *   `APPKIT_STRICT_VALIDATION=true` is set, in which case throws like production.
+   * - When all resources are valid: logs a debug message with the count.
+   *
+   * @returns ValidationResult with validity status, missing resources, and all resources
+   * @throws {ConfigurationError} In production when required resources are missing, or in dev when APPKIT_STRICT_VALIDATION=true
+   */
+  enforceValidation(): ValidationResult;
+  /**
+   * Formats missing resources into a human-readable error message.
+   *
+   * @param missing - Array of missing resource entries
+   * @returns Formatted error message string
+   */
+  static formatMissingResources(missing: ResourceEntry[]): string;
+  /**
+   * Formats a highly visible warning banner for dev-mode missing resources.
+   * Uses box drawing to ensure the message is impossible to miss in scrolling logs.
+   *
+   * @param missing - Array of missing resource entries
+   * @returns Formatted banner string
+   */
+  static formatDevWarningBanner(missing: ResourceEntry[]): string;
+}
+//#endregion
+export { ResourceRegistry };
+//# sourceMappingURL=resource-registry.d.ts.map

package/dist/registry/resource-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.d.ts","names":[],"sources":["../../src/registry/resource-registry.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAsbgD,cAjYnC,gBAAA,CAiYmC;EAAa,QAAA,SAAA;;;;;;;;;;;;;qCAlXjB;;;;;;;;+BA4B5B,WAAW;;;;;;;;;;;;YAqIR;;;;;;;;0CAW8B;;;;;;;;;;;;;;;;mCAyBP;;;;;;iBAWlB;;;;;;iBASA;;;;;;;;;;;;;;;;;;;;;;cAyBH;;;;;;;;;;;;uBA8DS;;;;;;;yCA6CkB;;;;;;;;yCAqBA"}

package/dist/registry/resource-registry.js

@@ -0,0 +1,297 @@
+import { createLogger } from "../logging/logger.js";
+import { ConfigurationError } from "../errors/configuration.js";
+import { init_errors } from "../errors/index.js";
+import { PERMISSION_HIERARCHY_BY_TYPE } from "./types.js";
+import { getPluginManifest } from "./manifest-loader.js";
+
+//#region src/registry/resource-registry.ts
+init_errors();
+const logger = createLogger("resource-registry");
+/**
+* Dedup key for registry: type + resourceKey (machine-stable).
+* alias is for UI/display only.
+*/
+function getDedupKey(type, resourceKey) {
+	return `${type}:${resourceKey}`;
+}
+/**
+* Returns the most permissive permission for a given resource type.
+* Uses per-type hierarchy; unknown permissions are treated as least permissive.
+*/
+function getMostPermissivePermission(resourceType, p1, p2) {
+	const hierarchy = PERMISSION_HIERARCHY_BY_TYPE[resourceType];
+	return (hierarchy?.indexOf(p1) ?? -1) > (hierarchy?.indexOf(p2) ?? -1) ? p1 : p2;
+}
+/**
+* Central registry for tracking plugin resource requirements.
+* Deduplication uses type + resourceKey (machine-stable); alias is for display only.
+*/
+var ResourceRegistry = class ResourceRegistry {
+	resources = /* @__PURE__ */ new Map();
+	/**
+	* Registers a resource requirement for a plugin.
+	* If a resource with the same type+resourceKey already exists, merges them:
+	* - Combines plugin names (comma-separated)
+	* - Uses the most permissive permission (per-type hierarchy)
+	* - Marks as required if any plugin requires it
+	* - Combines descriptions if they differ
+	* - Merges fields; warns when same field name uses different env vars
+	*
+	* @param plugin - Name of the plugin registering the resource
+	* @param resource - Resource requirement specification
+	*/
+	register(plugin, resource) {
+		const key = getDedupKey(resource.type, resource.resourceKey);
+		const existing = this.resources.get(key);
+		if (existing) {
+			const merged = this.mergeResources(existing, plugin, resource);
+			this.resources.set(key, merged);
+		} else {
+			const entry = {
+				...resource,
+				plugin,
+				resolved: false,
+				permissionSources: { [plugin]: resource.permission }
+			};
+			this.resources.set(key, entry);
+		}
+	}
+	/**
+	* Collects and registers resource requirements from an array of plugins.
+	* For each plugin, loads its manifest (required) and runtime resource requirements.
+	*
+	* @param rawPlugins - Array of plugin data entries from createApp configuration
+	* @throws {ConfigurationError} If any plugin is missing a manifest or manifest is invalid
+	*/
+	collectResources(rawPlugins) {
+		for (const pluginData of rawPlugins) {
+			if (!pluginData?.plugin) continue;
+			const pluginName = pluginData.name;
+			const manifest = getPluginManifest(pluginData.plugin);
+			for (const resource of manifest.resources.required) this.register(pluginName, {
+				...resource,
+				required: true
+			});
+			for (const resource of manifest.resources.optional || []) this.register(pluginName, {
+				...resource,
+				required: false
+			});
+			if (typeof pluginData.plugin.getResourceRequirements === "function") {
+				const runtimeResources = pluginData.plugin.getResourceRequirements(pluginData.config);
+				for (const resource of runtimeResources) this.register(pluginName, resource);
+			}
+			logger.debug("Collected resources from plugin %s: %d total", pluginName, this.getByPlugin(pluginName).length);
+		}
+	}
+	/**
+	* Merges a new resource requirement with an existing entry.
+	* Applies intelligent merging logic for conflicting properties.
+	*/
+	mergeResources(existing, newPlugin, newResource) {
+		const plugins = existing.plugin.split(", ");
+		if (!plugins.includes(newPlugin)) plugins.push(newPlugin);
+		const permissionSources = {
+			...existing.permissionSources ?? {},
+			[newPlugin]: newResource.permission
+		};
+		const permission = getMostPermissivePermission(existing.type, existing.permission, newResource.permission);
+		if (permission !== existing.permission) logger.warn("Resource %s:%s permission escalated from \"%s\" to \"%s\" due to plugin \"%s\" (previously requested by: %s). Review plugin permissions to ensure least-privilege.", existing.type, existing.resourceKey, existing.permission, permission, newPlugin, existing.plugin);
+		const required = existing.required || newResource.required;
+		let description = existing.description;
+		if (newResource.description && newResource.description !== existing.description) {
+			if (!existing.description.includes(newResource.description)) description = `${existing.description}; ${newResource.description}`;
+		}
+		const fields = { ...existing.fields ?? {} };
+		for (const [fieldName, newField] of Object.entries(newResource.fields ?? {})) {
+			const existingField = fields[fieldName];
+			if (existingField) {
+				if (existingField.env !== newField.env) logger.warn("Resource %s:%s field \"%s\": conflicting env vars \"%s\" (from %s) vs \"%s\" (from %s). Using first.", existing.type, existing.resourceKey, fieldName, existingField.env, existing.plugin, newField.env, newPlugin);
+			} else fields[fieldName] = newField;
+		}
+		return {
+			...existing,
+			plugin: plugins.join(", "),
+			permission,
+			permissionSources,
+			required,
+			description,
+			fields
+		};
+	}
+	/**
+	* Retrieves all registered resources.
+	* Returns a copy of the array to prevent external mutations.
+	*
+	* @returns Array of all registered resource entries
+	*/
+	getAll() {
+		return Array.from(this.resources.values());
+	}
+	/**
+	* Gets a specific resource by type and resourceKey (dedup key).
+	*
+	* @param type - Resource type
+	* @param resourceKey - Stable machine key (not alias; alias is for display only)
+	* @returns The resource entry if found, undefined otherwise
+	*/
+	get(type, resourceKey) {
+		return this.resources.get(getDedupKey(type, resourceKey));
+	}
+	/**
+	* Clears all registered resources.
+	* Useful for testing or when rebuilding the registry.
+	*/
+	clear() {
+		this.resources.clear();
+	}
+	/**
+	* Returns the number of registered resources.
+	*/
+	size() {
+		return this.resources.size;
+	}
+	/**
+	* Gets all resources required by a specific plugin.
+	*
+	* @param pluginName - Name of the plugin
+	* @returns Array of resources where the plugin is listed as a requester
+	*/
+	getByPlugin(pluginName) {
+		return this.getAll().filter((entry) => entry.plugin.split(", ").includes(pluginName));
+	}
+	/**
+	* Gets all required resources (where required=true).
+	*
+	* @returns Array of required resource entries
+	*/
+	getRequired() {
+		return this.getAll().filter((entry) => entry.required);
+	}
+	/**
+	* Gets all optional resources (where required=false).
+	*
+	* @returns Array of optional resource entries
+	*/
+	getOptional() {
+		return this.getAll().filter((entry) => !entry.required);
+	}
+	/**
+	* Validates all registered resources against the environment.
+	*
+	* Checks each resource's field environment variables to determine if it's resolved.
+	* Updates the `resolved` and `values` fields on each resource entry.
+	*
+	* Only required resources affect the `valid` status - optional resources
+	* are checked but don't cause validation failure.
+	*
+	* @returns ValidationResult with validity status, missing resources, and all resources
+	*
+	* @example
+	* ```typescript
+	* const registry = ResourceRegistry.getInstance();
+	* const result = registry.validate();
+	*
+	* if (!result.valid) {
+	*   console.error("Missing resources:", result.missing.map(r => Object.values(r.fields).map(f => f.env)));
+	* }
+	* ```
+	*/
+	validate() {
+		const missing = [];
+		for (const entry of this.resources.values()) {
+			const values = {};
+			let allSet = true;
+			for (const [fieldName, fieldDef] of Object.entries(entry.fields)) {
+				const val = process.env[fieldDef.env];
+				if (val !== void 0 && val !== "") values[fieldName] = val;
+				else allSet = false;
+			}
+			if (allSet) {
+				entry.resolved = true;
+				entry.values = values;
+				logger.debug("Resource %s:%s resolved from fields", entry.type, entry.alias);
+			} else {
+				entry.resolved = false;
+				entry.values = Object.keys(values).length > 0 ? values : void 0;
+				if (entry.required) {
+					missing.push(entry);
+					logger.debug("Required resource %s:%s missing (fields: %s)", entry.type, entry.alias, Object.keys(entry.fields).join(", "));
+				} else logger.debug("Optional resource %s:%s not configured (fields: %s)", entry.type, entry.alias, Object.keys(entry.fields).join(", "));
+			}
+		}
+		return {
+			valid: missing.length === 0,
+			missing,
+			all: this.getAll()
+		};
+	}
+	/**
+	* Validates all registered resources and enforces the result.
+	*
+	* - In production: throws a {@link ConfigurationError} if any required resources are missing.
+	* - In development (`NODE_ENV=development`): logs a warning but continues, unless
+	*   `APPKIT_STRICT_VALIDATION=true` is set, in which case throws like production.
+	* - When all resources are valid: logs a debug message with the count.
+	*
+	* @returns ValidationResult with validity status, missing resources, and all resources
+	* @throws {ConfigurationError} In production when required resources are missing, or in dev when APPKIT_STRICT_VALIDATION=true
+	*/
+	enforceValidation() {
+		const validation = this.validate();
+		const isDevelopment = process.env.NODE_ENV === "development";
+		const strictValidation = process.env.APPKIT_STRICT_VALIDATION === "true" || process.env.APPKIT_STRICT_VALIDATION === "1";
+		if (!validation.valid) {
+			const errorMessage = ResourceRegistry.formatMissingResources(validation.missing);
+			if (!isDevelopment || strictValidation) throw new ConfigurationError(errorMessage, { context: { missingResources: validation.missing.map((r) => ({
+				type: r.type,
+				alias: r.alias,
+				plugin: r.plugin,
+				envVars: Object.values(r.fields).map((f) => f.env)
+			})) } });
+			const banner = ResourceRegistry.formatDevWarningBanner(validation.missing);
+			logger.warn("\n%s", banner);
+		} else if (this.size() > 0) logger.debug("All %d resources validated successfully", this.size());
+		return validation;
+	}
+	/**
+	* Formats missing resources into a human-readable error message.
+	*
+	* @param missing - Array of missing resource entries
+	* @returns Formatted error message string
+	*/
+	static formatMissingResources(missing) {
+		if (missing.length === 0) return "No missing resources";
+		return `Missing required resources:\n${missing.map((entry) => {
+			const envHint = ` (set ${Object.values(entry.fields).map((f) => f.env).join(", ")})`;
+			return `  - ${entry.type}:${entry.alias} [${entry.plugin}]${envHint}`;
+		}).join("\n")}`;
+	}
+	/**
+	* Formats a highly visible warning banner for dev-mode missing resources.
+	* Uses box drawing to ensure the message is impossible to miss in scrolling logs.
+	*
+	* @param missing - Array of missing resource entries
+	* @returns Formatted banner string
+	*/
+	static formatDevWarningBanner(missing) {
+		const contentLines = ["MISSING REQUIRED RESOURCES (dev mode — would fail in production)", ""];
+		for (const entry of missing) {
+			const envVars = Object.values(entry.fields).map((f) => f.env);
+			contentLines.push(`  ${entry.type}:${entry.alias}  (plugin: ${entry.plugin})`);
+			contentLines.push(`    Set: ${envVars.join(", ")}`);
+		}
+		contentLines.push("");
+		contentLines.push("Add these to your .env file or environment to suppress this warning.");
+		const maxLen = Math.max(...contentLines.map((l) => l.length));
+		const border = "=".repeat(maxLen + 4);
+		return [
+			border,
+			...contentLines.map((line) => `| ${line.padEnd(maxLen)} |`),
+			border
+		].join("\n");
+	}
+};
+
+//#endregion
+export { ResourceRegistry };
+//# sourceMappingURL=resource-registry.js.map

package/dist/registry/resource-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.js","names":[],"sources":["../../src/registry/resource-registry.ts"],"sourcesContent":["/**\n * Resource Registry\n *\n * Central registry that tracks all resource requirements across all plugins.\n * Provides visibility into Databricks resources needed by the application\n * and handles deduplication when multiple plugins require the same resource\n * (dedup key: type + resourceKey).\n *\n * Use `new ResourceRegistry()` for instance-scoped usage (e.g. createApp).\n * getInstance() / resetInstance() remain for backward compatibility in tests.\n */\n\nimport type { BasePluginConfig, PluginConstructor, PluginData } from \"shared\";\nimport { ConfigurationError } from \"../errors\";\nimport { createLogger } from \"../logging/logger\";\nimport { getPluginManifest } from \"./manifest-loader\";\nimport type {\n  ResourceEntry,\n  ResourcePermission,\n  ResourceRequirement,\n  ValidationResult,\n} from \"./types\";\nimport { PERMISSION_HIERARCHY_BY_TYPE, type ResourceType } from \"./types\";\n\nconst logger = createLogger(\"resource-registry\");\n\n/**\n * Dedup key for registry: type + resourceKey (machine-stable).\n * alias is for UI/display only.\n */\nfunction getDedupKey(type: string, resourceKey: string): string {\n  return `${type}:${resourceKey}`;\n}\n\n/**\n * Returns the most permissive permission for a given resource type.\n * Uses per-type hierarchy; unknown permissions are treated as least permissive.\n */\nfunction getMostPermissivePermission(\n  resourceType: ResourceType,\n  p1: ResourcePermission,\n  p2: ResourcePermission,\n): ResourcePermission {\n  const hierarchy = PERMISSION_HIERARCHY_BY_TYPE[resourceType as ResourceType];\n  const index1 = hierarchy?.indexOf(p1) ?? -1;\n  const index2 = hierarchy?.indexOf(p2) ?? -1;\n  return index1 > index2 ? p1 : p2;\n}\n\n/**\n * Central registry for tracking plugin resource requirements.\n * Deduplication uses type + resourceKey (machine-stable); alias is for display only.\n */\nexport class ResourceRegistry {\n  private resources: Map<string, ResourceEntry> = new Map();\n\n  /**\n   * Registers a resource requirement for a plugin.\n   * If a resource with the same type+resourceKey already exists, merges them:\n   * - Combines plugin names (comma-separated)\n   * - Uses the most permissive permission (per-type hierarchy)\n   * - Marks as required if any plugin requires it\n   * - Combines descriptions if they differ\n   * - Merges fields; warns when same field name uses different env vars\n   *\n   * @param plugin - Name of the plugin registering the resource\n   * @param resource - Resource requirement specification\n   */\n  public register(plugin: string, resource: ResourceRequirement): void {\n    const key = getDedupKey(resource.type, resource.resourceKey);\n    const existing = this.resources.get(key);\n\n    if (existing) {\n      // Merge with existing resource\n      const merged = this.mergeResources(existing, plugin, resource);\n      this.resources.set(key, merged);\n    } else {\n      // Create new resource entry with permission source tracking\n      const entry: ResourceEntry = {\n        ...resource,\n        plugin,\n        resolved: false,\n        permissionSources: { [plugin]: resource.permission },\n      };\n      this.resources.set(key, entry);\n    }\n  }\n\n  /**\n   * Collects and registers resource requirements from an array of plugins.\n   * For each plugin, loads its manifest (required) and runtime resource requirements.\n   *\n   * @param rawPlugins - Array of plugin data entries from createApp configuration\n   * @throws {ConfigurationError} If any plugin is missing a manifest or manifest is invalid\n   */\n  public collectResources(\n    rawPlugins: PluginData<PluginConstructor, unknown, string>[],\n  ): void {\n    for (const pluginData of rawPlugins) {\n      if (!pluginData?.plugin) continue;\n\n      const pluginName = pluginData.name;\n      const manifest = getPluginManifest(pluginData.plugin);\n\n      // Register required resources\n      for (const resource of manifest.resources.required) {\n        this.register(pluginName, { ...resource, required: true });\n      }\n\n      // Register optional resources\n      for (const resource of manifest.resources.optional || []) {\n        this.register(pluginName, { ...resource, required: false });\n      }\n\n      // Check for runtime resource requirements\n      if (typeof pluginData.plugin.getResourceRequirements === \"function\") {\n        const runtimeResources = pluginData.plugin.getResourceRequirements(\n          pluginData.config as BasePluginConfig,\n        );\n        for (const resource of runtimeResources) {\n          this.register(pluginName, resource as ResourceRequirement);\n        }\n      }\n\n      logger.debug(\n        \"Collected resources from plugin %s: %d total\",\n        pluginName,\n        this.getByPlugin(pluginName).length,\n      );\n    }\n  }\n\n  /**\n   * Merges a new resource requirement with an existing entry.\n   * Applies intelligent merging logic for conflicting properties.\n   */\n  private mergeResources(\n    existing: ResourceEntry,\n    newPlugin: string,\n    newResource: ResourceRequirement,\n  ): ResourceEntry {\n    // Combine plugin names if not already included\n    const plugins = existing.plugin.split(\", \");\n    if (!plugins.includes(newPlugin)) {\n      plugins.push(newPlugin);\n    }\n\n    // Track per-plugin permission sources\n    const permissionSources: Record<string, ResourcePermission> = {\n      ...(existing.permissionSources ?? {}),\n      [newPlugin]: newResource.permission,\n    };\n\n    // Use the most permissive permission for this resource type; warn when escalating\n    const permission = getMostPermissivePermission(\n      existing.type as ResourceType,\n      existing.permission,\n      newResource.permission,\n    );\n\n    if (permission !== existing.permission) {\n      logger.warn(\n        'Resource %s:%s permission escalated from \"%s\" to \"%s\" due to plugin \"%s\" ' +\n          \"(previously requested by: %s). Review plugin permissions to ensure least-privilege.\",\n        existing.type,\n        existing.resourceKey,\n        existing.permission,\n        permission,\n        newPlugin,\n        existing.plugin,\n      );\n    }\n\n    // Mark as required if any plugin requires it\n    const required = existing.required || newResource.required;\n\n    // Combine descriptions if they differ\n    let description = existing.description;\n    if (\n      newResource.description &&\n      newResource.description !== existing.description\n    ) {\n      if (!existing.description.includes(newResource.description)) {\n        description = `${existing.description}; ${newResource.description}`;\n      }\n    }\n\n    // Merge fields: union of field names; warn when same field name uses different env\n    const fields = { ...(existing.fields ?? {}) };\n    for (const [fieldName, newField] of Object.entries(\n      newResource.fields ?? {},\n    )) {\n      const existingField = fields[fieldName];\n      if (existingField) {\n        if (existingField.env !== newField.env) {\n          logger.warn(\n            'Resource %s:%s field \"%s\": conflicting env vars \"%s\" (from %s) vs \"%s\" (from %s). Using first.',\n            existing.type,\n            existing.resourceKey,\n            fieldName,\n            existingField.env,\n            existing.plugin,\n            newField.env,\n            newPlugin,\n          );\n        }\n        // keep existing\n      } else {\n        fields[fieldName] = newField;\n      }\n    }\n\n    return {\n      ...existing,\n      plugin: plugins.join(\", \"),\n      permission,\n      permissionSources,\n      required,\n      description,\n      fields,\n    };\n  }\n\n  /**\n   * Retrieves all registered resources.\n   * Returns a copy of the array to prevent external mutations.\n   *\n   * @returns Array of all registered resource entries\n   */\n  public getAll(): ResourceEntry[] {\n    return Array.from(this.resources.values());\n  }\n\n  /**\n   * Gets a specific resource by type and resourceKey (dedup key).\n   *\n   * @param type - Resource type\n   * @param resourceKey - Stable machine key (not alias; alias is for display only)\n   * @returns The resource entry if found, undefined otherwise\n   */\n  public get(type: string, resourceKey: string): ResourceEntry | undefined {\n    return this.resources.get(getDedupKey(type, resourceKey));\n  }\n\n  /**\n   * Clears all registered resources.\n   * Useful for testing or when rebuilding the registry.\n   */\n  public clear(): void {\n    this.resources.clear();\n  }\n\n  /**\n   * Returns the number of registered resources.\n   */\n  public size(): number {\n    return this.resources.size;\n  }\n\n  /**\n   * Gets all resources required by a specific plugin.\n   *\n   * @param pluginName - Name of the plugin\n   * @returns Array of resources where the plugin is listed as a requester\n   */\n  public getByPlugin(pluginName: string): ResourceEntry[] {\n    return this.getAll().filter((entry) =>\n      entry.plugin.split(\", \").includes(pluginName),\n    );\n  }\n\n  /**\n   * Gets all required resources (where required=true).\n   *\n   * @returns Array of required resource entries\n   */\n  public getRequired(): ResourceEntry[] {\n    return this.getAll().filter((entry) => entry.required);\n  }\n\n  /**\n   * Gets all optional resources (where required=false).\n   *\n   * @returns Array of optional resource entries\n   */\n  public getOptional(): ResourceEntry[] {\n    return this.getAll().filter((entry) => !entry.required);\n  }\n\n  /**\n   * Validates all registered resources against the environment.\n   *\n   * Checks each resource's field environment variables to determine if it's resolved.\n   * Updates the `resolved` and `values` fields on each resource entry.\n   *\n   * Only required resources affect the `valid` status - optional resources\n   * are checked but don't cause validation failure.\n   *\n   * @returns ValidationResult with validity status, missing resources, and all resources\n   *\n   * @example\n   * ```typescript\n   * const registry = ResourceRegistry.getInstance();\n   * const result = registry.validate();\n   *\n   * if (!result.valid) {\n   *   console.error(\"Missing resources:\", result.missing.map(r => Object.values(r.fields).map(f => f.env)));\n   * }\n   * ```\n   */\n  public validate(): ValidationResult {\n    const missing: ResourceEntry[] = [];\n\n    for (const entry of this.resources.values()) {\n      const values: Record<string, string> = {};\n      let allSet = true;\n      for (const [fieldName, fieldDef] of Object.entries(entry.fields)) {\n        const val = process.env[fieldDef.env];\n        if (val !== undefined && val !== \"\") {\n          values[fieldName] = val;\n        } else {\n          allSet = false;\n        }\n      }\n      if (allSet) {\n        entry.resolved = true;\n        entry.values = values;\n        logger.debug(\n          \"Resource %s:%s resolved from fields\",\n          entry.type,\n          entry.alias,\n        );\n      } else {\n        entry.resolved = false;\n        entry.values = Object.keys(values).length > 0 ? values : undefined;\n        if (entry.required) {\n          missing.push(entry);\n          logger.debug(\n            \"Required resource %s:%s missing (fields: %s)\",\n            entry.type,\n            entry.alias,\n            Object.keys(entry.fields).join(\", \"),\n          );\n        } else {\n          logger.debug(\n            \"Optional resource %s:%s not configured (fields: %s)\",\n            entry.type,\n            entry.alias,\n            Object.keys(entry.fields).join(\", \"),\n          );\n        }\n      }\n    }\n\n    return {\n      valid: missing.length === 0,\n      missing,\n      all: this.getAll(),\n    };\n  }\n\n  /**\n   * Validates all registered resources and enforces the result.\n   *\n   * - In production: throws a {@link ConfigurationError} if any required resources are missing.\n   * - In development (`NODE_ENV=development`): logs a warning but continues, unless\n   *   `APPKIT_STRICT_VALIDATION=true` is set, in which case throws like production.\n   * - When all resources are valid: logs a debug message with the count.\n   *\n   * @returns ValidationResult with validity status, missing resources, and all resources\n   * @throws {ConfigurationError} In production when required resources are missing, or in dev when APPKIT_STRICT_VALIDATION=true\n   */\n  public enforceValidation(): ValidationResult {\n    const validation = this.validate();\n    const isDevelopment = process.env.NODE_ENV === \"development\";\n    const strictValidation =\n      process.env.APPKIT_STRICT_VALIDATION === \"true\" ||\n      process.env.APPKIT_STRICT_VALIDATION === \"1\";\n\n    if (!validation.valid) {\n      const errorMessage = ResourceRegistry.formatMissingResources(\n        validation.missing,\n      );\n\n      const shouldThrow = !isDevelopment || strictValidation;\n\n      if (shouldThrow) {\n        throw new ConfigurationError(errorMessage, {\n          context: {\n            missingResources: validation.missing.map((r) => ({\n              type: r.type,\n              alias: r.alias,\n              plugin: r.plugin,\n              envVars: Object.values(r.fields).map((f) => f.env),\n            })),\n          },\n        });\n      }\n\n      // Dev mode without strict: use a visually prominent box so the warning can't be missed\n      const banner = ResourceRegistry.formatDevWarningBanner(\n        validation.missing,\n      );\n      logger.warn(\"\\n%s\", banner);\n    } else if (this.size() > 0) {\n      logger.debug(\"All %d resources validated successfully\", this.size());\n    }\n\n    return validation;\n  }\n\n  /**\n   * Formats missing resources into a human-readable error message.\n   *\n   * @param missing - Array of missing resource entries\n   * @returns Formatted error message string\n   */\n  public static formatMissingResources(missing: ResourceEntry[]): string {\n    if (missing.length === 0) {\n      return \"No missing resources\";\n    }\n\n    const lines = missing.map((entry) => {\n      const envVars = Object.values(entry.fields).map((f) => f.env);\n      const envHint = ` (set ${envVars.join(\", \")})`;\n      return `  - ${entry.type}:${entry.alias} [${entry.plugin}]${envHint}`;\n    });\n\n    return `Missing required resources:\\n${lines.join(\"\\n\")}`;\n  }\n\n  /**\n   * Formats a highly visible warning banner for dev-mode missing resources.\n   * Uses box drawing to ensure the message is impossible to miss in scrolling logs.\n   *\n   * @param missing - Array of missing resource entries\n   * @returns Formatted banner string\n   */\n  public static formatDevWarningBanner(missing: ResourceEntry[]): string {\n    const contentLines: string[] = [\n      \"MISSING REQUIRED RESOURCES (dev mode — would fail in production)\",\n      \"\",\n    ];\n\n    for (const entry of missing) {\n      const envVars = Object.values(entry.fields).map((f) => f.env);\n      contentLines.push(\n        `  ${entry.type}:${entry.alias}  (plugin: ${entry.plugin})`,\n      );\n      contentLines.push(`    Set: ${envVars.join(\", \")}`);\n    }\n\n    contentLines.push(\"\");\n    contentLines.push(\n      \"Add these to your .env file or environment to suppress this warning.\",\n    );\n\n    const maxLen = Math.max(...contentLines.map((l) => l.length));\n    const border = \"=\".repeat(maxLen + 4);\n\n    const boxed = contentLines.map((line) => `| ${line.padEnd(maxLen)} |`);\n\n    return [border, ...boxed, border].join(\"\\n\");\n  }\n}\n"],"mappings":"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"}