@dbx-tools/appkit 0.3.44 → 0.4.1

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+export * as appkit from "./src/appkit.js";
+export * as config from "./src/config.js";
+export * as createApp from "./src/create-app.js";
+export * as databricks from "./src/databricks.js";
+export * as lakebaseResolver from "./src/lakebase-resolver.js";
+export * as pgaddress from "./src/pgaddress.js";
+export * as plugin from "./src/plugin.js";
+export * as provision from "./src/provision.js";
+export { tryGetExecutionContext, ensureInitialized } from "./src/appkit.js";
+export type { ExecutionContextLike, WorkspaceClientLike } from "./src/appkit.js";
+export { flattenAppYamlEnv, flattenAppEnv, bundle, appYaml, getBundlePath, resolveConfigValue, withCliSources } from "./src/config.js";
+export type { BundleValidateJson, ConfigFile, ConfigSource, ConfigMapValue, ResolveConfigValueOptions } from "./src/config.js";
+export { autoConfigure } from "./src/create-app.js";
+export type { AutoConfigureMode, CreateAppConfig } from "./src/create-app.js";
+export { MAX_TCP_PORT, isAppEnv, toContext } from "./src/databricks.js";
+export type { ContextLike } from "./src/databricks.js";
+export { parsePort, parseSslMode, nextPollDelay, pollDelay, readLakebaseInputs, resolveLakebaseConnection, applyLakebaseToEnv } from "./src/lakebase-resolver.js";
+export type { LakebaseResolverInputs, LakebaseConnection } from "./src/lakebase-resolver.js";
+export { SSL_MODES, parseAddress, parseResourcePath } from "./src/pgaddress.js";
+export type { SslMode, LakebaseConnectionInputs, ParsedAddress } from "./src/pgaddress.js";
+export { data, instance, require } from "./src/plugin.js";
+export type { PluginContextLike } from "./src/plugin.js";
+export { cacheGrantStatements, provisionCacheSchema } from "./src/provision.js";

package/lib/index.js

@@ -0,0 +1,20 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+export * as appkit from "./src/appkit.js";
+export * as config from "./src/config.js";
+export * as createApp from "./src/create-app.js";
+export * as databricks from "./src/databricks.js";
+export * as lakebaseResolver from "./src/lakebase-resolver.js";
+export * as pgaddress from "./src/pgaddress.js";
+export * as plugin from "./src/plugin.js";
+export * as provision from "./src/provision.js";
+export { tryGetExecutionContext, ensureInitialized } from "./src/appkit.js";
+export { flattenAppYamlEnv, flattenAppEnv, bundle, appYaml, getBundlePath, resolveConfigValue, withCliSources } from "./src/config.js";
+export { autoConfigure } from "./src/create-app.js";
+export { MAX_TCP_PORT, isAppEnv, toContext } from "./src/databricks.js";
+export { parsePort, parseSslMode, nextPollDelay, pollDelay, readLakebaseInputs, resolveLakebaseConnection, applyLakebaseToEnv } from "./src/lakebase-resolver.js";
+export { SSL_MODES, parseAddress, parseResourcePath } from "./src/pgaddress.js";
+export { data, instance, require } from "./src/plugin.js";
+export { cacheGrantStatements, provisionCacheSchema } from "./src/provision.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssTUFBTSxNQUFNLGNBQWMsQ0FBQztBQUN2QyxPQUFPLEtBQUssTUFBTSxNQUFNLGNBQWMsQ0FBQztBQUN2QyxPQUFPLEtBQUssU0FBUyxNQUFNLGtCQUFrQixDQUFDO0FBQzlDLE9BQU8sS0FBSyxVQUFVLE1BQU0sa0JBQWtCLENBQUM7QUFDL0MsT0FBTyxLQUFLLGdCQUFnQixNQUFNLHlCQUF5QixDQUFDO0FBQzVELE9BQU8sS0FBSyxTQUFTLE1BQU0saUJBQWlCLENBQUM7QUFDN0MsT0FBTyxLQUFLLE1BQU0sTUFBTSxjQUFjLENBQUM7QUFDdkMsT0FBTyxLQUFLLFNBQVMsTUFBTSxpQkFBaUIsQ0FBQztBQUM3QyxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFekUsT0FBTyxFQUFFLGlCQUFpQixFQUFFLGFBQWEsRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLGFBQWEsRUFBRSxrQkFBa0IsRUFBRSxjQUFjLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFFcEksT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRWpELE9BQU8sRUFBRSxZQUFZLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXJFLE9BQU8sRUFBRSxTQUFTLEVBQUUsWUFBWSxFQUFFLGFBQWEsRUFBRSxTQUFTLEVBQUUsa0JBQWtCLEVBQUUseUJBQXlCLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUUvSixPQUFPLEVBQUUsU0FBUyxFQUFFLFlBQVksRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRTdFLE9BQU8sRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUV2RCxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEdFTkVSQVRFRCBieSBwcm9qZW4gd2F0Y2ggLSBETyBOT1QgRURJVC5cbi8vIFJlZ2VuZXJhdGVkIGZyb20gdGhlIGV4cG9ydGluZyBtb2R1bGVzIGluIC4vc3JjLlxuLy8gSGFuZCBlZGl0cyBhcmUgb3ZlcndyaXR0ZW4gb24gdGhlIG5leHQgd2F0Y2g7IHRoaXMgZmlsZSBpcyByZWFkLW9ubHkuXG5cbmV4cG9ydCAqIGFzIGFwcGtpdCBmcm9tIFwiLi9zcmMvYXBwa2l0XCI7XG5leHBvcnQgKiBhcyBjb25maWcgZnJvbSBcIi4vc3JjL2NvbmZpZ1wiO1xuZXhwb3J0ICogYXMgY3JlYXRlQXBwIGZyb20gXCIuL3NyYy9jcmVhdGUtYXBwXCI7XG5leHBvcnQgKiBhcyBkYXRhYnJpY2tzIGZyb20gXCIuL3NyYy9kYXRhYnJpY2tzXCI7XG5leHBvcnQgKiBhcyBsYWtlYmFzZVJlc29sdmVyIGZyb20gXCIuL3NyYy9sYWtlYmFzZS1yZXNvbHZlclwiO1xuZXhwb3J0ICogYXMgcGdhZGRyZXNzIGZyb20gXCIuL3NyYy9wZ2FkZHJlc3NcIjtcbmV4cG9ydCAqIGFzIHBsdWdpbiBmcm9tIFwiLi9zcmMvcGx1Z2luXCI7XG5leHBvcnQgKiBhcyBwcm92aXNpb24gZnJvbSBcIi4vc3JjL3Byb3Zpc2lvblwiO1xuZXhwb3J0IHsgdHJ5R2V0RXhlY3V0aW9uQ29udGV4dCwgZW5zdXJlSW5pdGlhbGl6ZWQgfSBmcm9tIFwiLi9zcmMvYXBwa2l0XCI7XG5leHBvcnQgdHlwZSB7IEV4ZWN1dGlvbkNvbnRleHRMaWtlLCBXb3Jrc3BhY2VDbGllbnRMaWtlIH0gZnJvbSBcIi4vc3JjL2FwcGtpdFwiO1xuZXhwb3J0IHsgZmxhdHRlbkFwcFlhbWxFbnYsIGZsYXR0ZW5BcHBFbnYsIGJ1bmRsZSwgYXBwWWFtbCwgZ2V0QnVuZGxlUGF0aCwgcmVzb2x2ZUNvbmZpZ1ZhbHVlLCB3aXRoQ2xpU291cmNlcyB9IGZyb20gXCIuL3NyYy9jb25maWdcIjtcbmV4cG9ydCB0eXBlIHsgQnVuZGxlVmFsaWRhdGVKc29uLCBDb25maWdGaWxlLCBDb25maWdTb3VyY2UsIENvbmZpZ01hcFZhbHVlLCBSZXNvbHZlQ29uZmlnVmFsdWVPcHRpb25zIH0gZnJvbSBcIi4vc3JjL2NvbmZpZ1wiO1xuZXhwb3J0IHsgYXV0b0NvbmZpZ3VyZSB9IGZyb20gXCIuL3NyYy9jcmVhdGUtYXBwXCI7XG5leHBvcnQgdHlwZSB7IEF1dG9Db25maWd1cmVNb2RlLCBDcmVhdGVBcHBDb25maWcgfSBmcm9tIFwiLi9zcmMvY3JlYXRlLWFwcFwiO1xuZXhwb3J0IHsgTUFYX1RDUF9QT1JULCBpc0FwcEVudiwgdG9Db250ZXh0IH0gZnJvbSBcIi4vc3JjL2RhdGFicmlja3NcIjtcbmV4cG9ydCB0eXBlIHsgQ29udGV4dExpa2UgfSBmcm9tIFwiLi9zcmMvZGF0YWJyaWNrc1wiO1xuZXhwb3J0IHsgcGFyc2VQb3J0LCBwYXJzZVNzbE1vZGUsIG5leHRQb2xsRGVsYXksIHBvbGxEZWxheSwgcmVhZExha2ViYXNlSW5wdXRzLCByZXNvbHZlTGFrZWJhc2VDb25uZWN0aW9uLCBhcHBseUxha2ViYXNlVG9FbnYgfSBmcm9tIFwiLi9zcmMvbGFrZWJhc2UtcmVzb2x2ZXJcIjtcbmV4cG9ydCB0eXBlIHsgTGFrZWJhc2VSZXNvbHZlcklucHV0cywgTGFrZWJhc2VDb25uZWN0aW9uIH0gZnJvbSBcIi4vc3JjL2xha2ViYXNlLXJlc29sdmVyXCI7XG5leHBvcnQgeyBTU0xfTU9ERVMsIHBhcnNlQWRkcmVzcywgcGFyc2VSZXNvdXJjZVBhdGggfSBmcm9tIFwiLi9zcmMvcGdhZGRyZXNzXCI7XG5leHBvcnQgdHlwZSB7IFNzbE1vZGUsIExha2ViYXNlQ29ubmVjdGlvbklucHV0cywgUGFyc2VkQWRkcmVzcyB9IGZyb20gXCIuL3NyYy9wZ2FkZHJlc3NcIjtcbmV4cG9ydCB7IGRhdGEsIGluc3RhbmNlLCByZXF1aXJlIH0gZnJvbSBcIi4vc3JjL3BsdWdpblwiO1xuZXhwb3J0IHR5cGUgeyBQbHVnaW5Db250ZXh0TGlrZSB9IGZyb20gXCIuL3NyYy9wbHVnaW5cIjtcbmV4cG9ydCB7IGNhY2hlR3JhbnRTdGF0ZW1lbnRzLCBwcm92aXNpb25DYWNoZVNjaGVtYSB9IGZyb20gXCIuL3NyYy9wcm92aXNpb25cIjtcbiJdfQ==

package/lib/src/appkit.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generic AppKit runtime glue: the per-request execution context and the types
+ * derived from it. Not plugin-specific - that lives in `./plugin`.
+ *
+ * `getExecutionContext()` is AppKit's own accessor for the OBO-scoped workspace
+ * client + request metadata; the wrappers here make it safe to call outside a
+ * request scope ({@link tryGetExecutionContext}) and to lazily boot a bare app
+ * ({@link ensureInitialized}), and re-export the derived types so add-on
+ * packages can type a context / client without re-deriving them inline.
+ *
+ * @module
+ */
+import { getExecutionContext } from "@databricks/appkit";
+/**
+ * The AppKit per-request execution context returned by `getExecutionContext()`
+ * - the OBO-scoped workspace client plus the surrounding request metadata.
+ * Derived from AppKit's own return type so it tracks the installed version, and
+ * re-exported here so add-on packages can type a context parameter without each
+ * re-deriving the same `ReturnType<typeof getExecutionContext>` inline.
+ */
+export type ExecutionContextLike = ReturnType<typeof getExecutionContext>;
+/**
+ * The auth-scoped Databricks workspace client carried on an
+ * `ExecutionContextLike` (`getExecutionContext().client`). Typed structurally
+ * off AppKit so consumers don't take a direct `@databricks/sdk-experimental`
+ * dependency - the dep flows in transitively through `@databricks/appkit`.
+ */
+export type WorkspaceClientLike = ExecutionContextLike["client"];
+/**
+ * The current AppKit execution context, or `undefined` when AppKit isn't
+ * initialized (outside a request scope). Swallows AppKit's
+ * {@link InitializationError}; any other error propagates.
+ *
+ * @example
+ * import { appkit } from "@dbx-tools/appkit";
+ * import { WorkspaceClient } from "@databricks/sdk-experimental";
+ *
+ * // OBO-scoped inside a request, service principal from a CLI or script.
+ * const client = appkit.tryGetExecutionContext()?.client ?? new WorkspaceClient({});
+ */
+export declare function tryGetExecutionContext(): ExecutionContextLike | undefined;
+/**
+ * Initialize a bare AppKit app (no plugins) when none is running yet.
+ *
+ * @example
+ * import { appkit } from "@dbx-tools/appkit";
+ *
+ * await appkit.ensureInitialized();
+ * const client = appkit.tryGetExecutionContext()?.client;
+ */
+export declare function ensureInitialized(): Promise<void>;

package/lib/src/appkit.js

@@ -0,0 +1,57 @@
+/**
+ * Generic AppKit runtime glue: the per-request execution context and the types
+ * derived from it. Not plugin-specific - that lives in `./plugin`.
+ *
+ * `getExecutionContext()` is AppKit's own accessor for the OBO-scoped workspace
+ * client + request metadata; the wrappers here make it safe to call outside a
+ * request scope ({@link tryGetExecutionContext}) and to lazily boot a bare app
+ * ({@link ensureInitialized}), and re-export the derived types so add-on
+ * packages can type a context / client without re-deriving them inline.
+ *
+ * @module
+ */
+import { createApp, getExecutionContext, InitializationError } from "@databricks/appkit";
+import { log } from "@dbx-tools/shared-core";
+const logger = log.logger("appkit");
+/**
+ * The current AppKit execution context, or `undefined` when AppKit isn't
+ * initialized (outside a request scope). Swallows AppKit's
+ * {@link InitializationError}; any other error propagates.
+ *
+ * @example
+ * import { appkit } from "@dbx-tools/appkit";
+ * import { WorkspaceClient } from "@databricks/sdk-experimental";
+ *
+ * // OBO-scoped inside a request, service principal from a CLI or script.
+ * const client = appkit.tryGetExecutionContext()?.client ?? new WorkspaceClient({});
+ */
+export function tryGetExecutionContext() {
+    try {
+        const ctx = getExecutionContext();
+        if (ctx?.client) {
+            return ctx;
+        }
+    }
+    catch (error) {
+        if (!(error instanceof InitializationError)) {
+            throw error;
+        }
+    }
+    return undefined;
+}
+/**
+ * Initialize a bare AppKit app (no plugins) when none is running yet.
+ *
+ * @example
+ * import { appkit } from "@dbx-tools/appkit";
+ *
+ * await appkit.ensureInitialized();
+ * const client = appkit.tryGetExecutionContext()?.client;
+ */
+export async function ensureInitialized() {
+    if (!tryGetExecutionContext()) {
+        logger.debug("initializing a bare AppKit app");
+        await createApp({ plugins: [] });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXBwa2l0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2FwcGtpdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7R0FXRztBQUVILE9BQU8sRUFBRSxTQUFTLEVBQUUsbUJBQW1CLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUN6RixPQUFPLEVBQUUsR0FBRyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFN0MsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQW1CcEM7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLFVBQVUsc0JBQXNCO0lBQ3BDLElBQUksQ0FBQztRQUNILE1BQU0sR0FBRyxHQUFHLG1CQUFtQixFQUFFLENBQUM7UUFDbEMsSUFBSSxHQUFHLEVBQUUsTUFBTSxFQUFFLENBQUM7WUFDaEIsT0FBTyxHQUFHLENBQUM7UUFDYixDQUFDO0lBQ0gsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixJQUFJLENBQUMsQ0FBQyxLQUFLLFlBQVksbUJBQW1CLENBQUMsRUFBRSxDQUFDO1lBQzVDLE1BQU0sS0FBSyxDQUFDO1FBQ2QsQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLFNBQVMsQ0FBQztBQUNuQixDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGlCQUFpQjtJQUNyQyxJQUFJLENBQUMsc0JBQXNCLEVBQUUsRUFBRSxDQUFDO1FBQzlCLE1BQU0sQ0FBQyxLQUFLLENBQUMsZ0NBQWdDLENBQUMsQ0FBQztRQUMvQyxNQUFNLFNBQVMsQ0FBQyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQ25DLENBQUM7QUFDSCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBHZW5lcmljIEFwcEtpdCBydW50aW1lIGdsdWU6IHRoZSBwZXItcmVxdWVzdCBleGVjdXRpb24gY29udGV4dCBhbmQgdGhlIHR5cGVzXG4gKiBkZXJpdmVkIGZyb20gaXQuIE5vdCBwbHVnaW4tc3BlY2lmaWMgLSB0aGF0IGxpdmVzIGluIGAuL3BsdWdpbmAuXG4gKlxuICogYGdldEV4ZWN1dGlvbkNvbnRleHQoKWAgaXMgQXBwS2l0J3Mgb3duIGFjY2Vzc29yIGZvciB0aGUgT0JPLXNjb3BlZCB3b3Jrc3BhY2VcbiAqIGNsaWVudCArIHJlcXVlc3QgbWV0YWRhdGE7IHRoZSB3cmFwcGVycyBoZXJlIG1ha2UgaXQgc2FmZSB0byBjYWxsIG91dHNpZGUgYVxuICogcmVxdWVzdCBzY29wZSAoe0BsaW5rIHRyeUdldEV4ZWN1dGlvbkNvbnRleHR9KSBhbmQgdG8gbGF6aWx5IGJvb3QgYSBiYXJlIGFwcFxuICogKHtAbGluayBlbnN1cmVJbml0aWFsaXplZH0pLCBhbmQgcmUtZXhwb3J0IHRoZSBkZXJpdmVkIHR5cGVzIHNvIGFkZC1vblxuICogcGFja2FnZXMgY2FuIHR5cGUgYSBjb250ZXh0IC8gY2xpZW50IHdpdGhvdXQgcmUtZGVyaXZpbmcgdGhlbSBpbmxpbmUuXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB7IGNyZWF0ZUFwcCwgZ2V0RXhlY3V0aW9uQ29udGV4dCwgSW5pdGlhbGl6YXRpb25FcnJvciB9IGZyb20gXCJAZGF0YWJyaWNrcy9hcHBraXRcIjtcbmltcG9ydCB7IGxvZyB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1jb3JlXCI7XG5cbmNvbnN0IGxvZ2dlciA9IGxvZy5sb2dnZXIoXCJhcHBraXRcIik7XG5cbi8qKlxuICogVGhlIEFwcEtpdCBwZXItcmVxdWVzdCBleGVjdXRpb24gY29udGV4dCByZXR1cm5lZCBieSBgZ2V0RXhlY3V0aW9uQ29udGV4dCgpYFxuICogLSB0aGUgT0JPLXNjb3BlZCB3b3Jrc3BhY2UgY2xpZW50IHBsdXMgdGhlIHN1cnJvdW5kaW5nIHJlcXVlc3QgbWV0YWRhdGEuXG4gKiBEZXJpdmVkIGZyb20gQXBwS2l0J3Mgb3duIHJldHVybiB0eXBlIHNvIGl0IHRyYWNrcyB0aGUgaW5zdGFsbGVkIHZlcnNpb24sIGFuZFxuICogcmUtZXhwb3J0ZWQgaGVyZSBzbyBhZGQtb24gcGFja2FnZXMgY2FuIHR5cGUgYSBjb250ZXh0IHBhcmFtZXRlciB3aXRob3V0IGVhY2hcbiAqIHJlLWRlcml2aW5nIHRoZSBzYW1lIGBSZXR1cm5UeXBlPHR5cGVvZiBnZXRFeGVjdXRpb25Db250ZXh0PmAgaW5saW5lLlxuICovXG5leHBvcnQgdHlwZSBFeGVjdXRpb25Db250ZXh0TGlrZSA9IFJldHVyblR5cGU8dHlwZW9mIGdldEV4ZWN1dGlvbkNvbnRleHQ+O1xuXG4vKipcbiAqIFRoZSBhdXRoLXNjb3BlZCBEYXRhYnJpY2tzIHdvcmtzcGFjZSBjbGllbnQgY2FycmllZCBvbiBhblxuICogYEV4ZWN1dGlvbkNvbnRleHRMaWtlYCAoYGdldEV4ZWN1dGlvbkNvbnRleHQoKS5jbGllbnRgKS4gVHlwZWQgc3RydWN0dXJhbGx5XG4gKiBvZmYgQXBwS2l0IHNvIGNvbnN1bWVycyBkb24ndCB0YWtlIGEgZGlyZWN0IGBAZGF0YWJyaWNrcy9zZGstZXhwZXJpbWVudGFsYFxuICogZGVwZW5kZW5jeSAtIHRoZSBkZXAgZmxvd3MgaW4gdHJhbnNpdGl2ZWx5IHRocm91Z2ggYEBkYXRhYnJpY2tzL2FwcGtpdGAuXG4gKi9cbmV4cG9ydCB0eXBlIFdvcmtzcGFjZUNsaWVudExpa2UgPSBFeGVjdXRpb25Db250ZXh0TGlrZVtcImNsaWVudFwiXTtcblxuLyoqXG4gKiBUaGUgY3VycmVudCBBcHBLaXQgZXhlY3V0aW9uIGNvbnRleHQsIG9yIGB1bmRlZmluZWRgIHdoZW4gQXBwS2l0IGlzbid0XG4gKiBpbml0aWFsaXplZCAob3V0c2lkZSBhIHJlcXVlc3Qgc2NvcGUpLiBTd2FsbG93cyBBcHBLaXQnc1xuICoge0BsaW5rIEluaXRpYWxpemF0aW9uRXJyb3J9OyBhbnkgb3RoZXIgZXJyb3IgcHJvcGFnYXRlcy5cbiAqXG4gKiBAZXhhbXBsZVxuICogaW1wb3J0IHsgYXBwa2l0IH0gZnJvbSBcIkBkYngtdG9vbHMvYXBwa2l0XCI7XG4gKiBpbXBvcnQgeyBXb3Jrc3BhY2VDbGllbnQgfSBmcm9tIFwiQGRhdGFicmlja3Mvc2RrLWV4cGVyaW1lbnRhbFwiO1xuICpcbiAqIC8vIE9CTy1zY29wZWQgaW5zaWRlIGEgcmVxdWVzdCwgc2VydmljZSBwcmluY2lwYWwgZnJvbSBhIENMSSBvciBzY3JpcHQuXG4gKiBjb25zdCBjbGllbnQgPSBhcHBraXQudHJ5R2V0RXhlY3V0aW9uQ29udGV4dCgpPy5jbGllbnQgPz8gbmV3IFdvcmtzcGFjZUNsaWVudCh7fSk7XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB0cnlHZXRFeGVjdXRpb25Db250ZXh0KCk6IEV4ZWN1dGlvbkNvbnRleHRMaWtlIHwgdW5kZWZpbmVkIHtcbiAgdHJ5IHtcbiAgICBjb25zdCBjdHggPSBnZXRFeGVjdXRpb25Db250ZXh0KCk7XG4gICAgaWYgKGN0eD8uY2xpZW50KSB7XG4gICAgICByZXR1cm4gY3R4O1xuICAgIH1cbiAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICBpZiAoIShlcnJvciBpbnN0YW5jZW9mIEluaXRpYWxpemF0aW9uRXJyb3IpKSB7XG4gICAgICB0aHJvdyBlcnJvcjtcbiAgICB9XG4gIH1cbiAgcmV0dXJuIHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBJbml0aWFsaXplIGEgYmFyZSBBcHBLaXQgYXBwIChubyBwbHVnaW5zKSB3aGVuIG5vbmUgaXMgcnVubmluZyB5ZXQuXG4gKlxuICogQGV4YW1wbGVcbiAqIGltcG9ydCB7IGFwcGtpdCB9IGZyb20gXCJAZGJ4LXRvb2xzL2FwcGtpdFwiO1xuICpcbiAqIGF3YWl0IGFwcGtpdC5lbnN1cmVJbml0aWFsaXplZCgpO1xuICogY29uc3QgY2xpZW50ID0gYXBwa2l0LnRyeUdldEV4ZWN1dGlvbkNvbnRleHQoKT8uY2xpZW50O1xuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZW5zdXJlSW5pdGlhbGl6ZWQoKTogUHJvbWlzZTx2b2lkPiB7XG4gIGlmICghdHJ5R2V0RXhlY3V0aW9uQ29udGV4dCgpKSB7XG4gICAgbG9nZ2VyLmRlYnVnKFwiaW5pdGlhbGl6aW5nIGEgYmFyZSBBcHBLaXQgYXBwXCIpO1xuICAgIGF3YWl0IGNyZWF0ZUFwcCh7IHBsdWdpbnM6IFtdIH0pO1xuICB9XG59XG4iXX0=

package/lib/src/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Layered configuration resolution for local development against a Databricks
+ * App / Asset Bundle.
+ *
+ * Default sources: `explicit`, then `env`, then Databricks App `config.env`
+ * (from {@link bundle}) and hard-coded `app.yaml` env entries (from
+ * {@link appYaml}). Opt in to `cli` when a dev command wants flag overrides.
+ *
+ * Server-only (`node:child_process`, bundle root discovery). Databricks-app
+ * specific, so it lives in node-appkit rather than shared-core.
+ *
+ * @module
+ */
+/** Parsed payload from `databricks bundle validate --output json`. */
+export type BundleValidateJson = Record<string, unknown>;
+/** A config file discovered on disk with its parsed contents. */
+export interface ConfigFile {
+    path: string;
+    data: Record<string, unknown>;
+}
+/** Supported configuration sources, consulted in array order. */
+export type ConfigSource = "explicit" | "cli" | "env" | "bundle";
+/** Single config map entry (string or repeated values, like headers). */
+export type ConfigMapValue = string | string[] | undefined;
+export interface ResolveConfigValueOptions {
+    /** Bundle validate JSON. Defaults to {@link bundle} (skipped inside a Databricks App). */
+    bundleData?: ConfigFile;
+    /** Parsed `app.yaml` contents. Defaults to {@link appYaml} (skipped inside a Databricks App). */
+    appData?: ConfigFile;
+    /**
+     * Sources to consult, first truthy string wins. Defaults to `explicit`, then
+     * `env`, then `bundle`.
+     */
+    sources?: ConfigSource[];
+    /** Programmatic overrides. When set, `explicit` is prepended to `sources` unless already listed. */
+    explicit?: Record<string, ConfigMapValue>;
+    /** CLI flag values (when `cli` is listed in `sources`). */
+    cli?: Record<string, ConfigMapValue>;
+}
+/**
+ * Flatten `env` entries from parsed `app.yaml` content. Literal `value` entries
+ * are returned as-is; `valueFrom` entries resolve against the sibling
+ * `resources` array when possible.
+ */
+export declare function flattenAppYamlEnv(data: unknown): Record<string, string>;
+/**
+ * Flatten `resources.apps.<key>.config.env` into a `name -> value` map.
+ * Auto-picks the app only when the bundle defines exactly one.
+ */
+export declare function flattenAppEnv(data: unknown): Record<string, string>;
+/**
+ * Locate the bundle root and run `databricks bundle validate --output json`.
+ * When `cwd` is omitted or equals `process.cwd()`, the result is memoized for
+ * the process lifetime. Returns `undefined` inside a Databricks App.
+ */
+export declare function bundle(cwd?: string): Promise<ConfigFile | undefined>;
+/**
+ * Locate and parse `app.yaml` / `app.yml` from the bundle or project root. When
+ * `cwd` is omitted or equals `process.cwd()`, the result is memoized for the
+ * process lifetime. Returns `undefined` inside a Databricks App.
+ */
+export declare function appYaml(cwd?: string): Promise<ConfigFile | undefined>;
+/**
+ * Walk a dot-separated path through bundle validate JSON. When the terminal
+ * node is a bundle variable object (`{ value: "..." }`), the `value` field is
+ * returned.
+ */
+export declare function getBundlePath(data: BundleValidateJson, path: string): string | undefined;
+/**
+ * Resolve a configuration string from the configured sources. Returns the first
+ * non-empty value, or `undefined` when nothing matches.
+ *
+ * Precedence follows AppKit's: explicit config, then environment variable, then
+ * whatever the Databricks App / bundle definition supplies.
+ *
+ * @example
+ * import { config } from "@dbx-tools/appkit";
+ *
+ * const warehouseId = await config.resolveConfigValue("DATABRICKS_WAREHOUSE_ID", {
+ *   cli: { DATABRICKS_WAREHOUSE_ID: flags.warehouse },
+ *   sources: config.withCliSources(),
+ * });
+ */
+export declare function resolveConfigValue(name: string, options?: ResolveConfigValueOptions): Promise<string | undefined>;
+/**
+ * Sources with `cli` included, in CLI-first order. Use for dev commands that
+ * accept flag overrides.
+ */
+export declare function withCliSources(sources?: ConfigSource[]): ConfigSource[];