@dbx-tools/appkit 0.9.154 → 0.9.158

package/package.json

@@ -20,7 +20,7 @@
   },
   "devDependencies": {
     "@databricks/appkit": "0.81.0",
-    "@dbx-tools/projen": "^0.9.154",
+    "@dbx-tools/projen": "^0.9.158",
     "@types/json-schema": "^7",
     "@types/node": "^24.6.0",
     "typescript": "^5.9.3",
@@ -31,13 +31,13 @@
   },
   "dependencies": {
     "@databricks/sdk-experimental": "^0.17.0",
-    "@dbx-tools/auth": "^0.9.154",
-    "@dbx-tools/cache": "^0.9.154",
-    "@dbx-tools/core": "^0.9.154",
-    "@dbx-tools/lakebase": "^0.9.154",
-    "@dbx-tools/postgres": "^0.9.154",
-    "@dbx-tools/shared-core": "^0.9.154",
-    "@dbx-tools/shared-fs": "^0.9.154",
+    "@dbx-tools/auth": "^0.9.158",
+    "@dbx-tools/cache": "^0.9.158",
+    "@dbx-tools/core": "^0.9.158",
+    "@dbx-tools/lakebase": "^0.9.158",
+    "@dbx-tools/postgres": "^0.9.158",
+    "@dbx-tools/shared-core": "^0.9.158",
+    "@dbx-tools/shared-fs": "^0.9.158",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/sdk-trace-base": "2.8.0",
     "zod": "4.3.6"
@@ -53,94 +53,10 @@
         "types": "./lib/index.d.ts",
         "default": "./lib/index.js"
       },
-      "./appkit": {
-        "types": "./lib/src/appkit.d.ts",
-        "default": "./lib/src/appkit.js"
-      },
-      "./brand-context": {
-        "types": "./lib/src/brand-context.d.ts",
-        "default": "./lib/src/brand-context.js"
-      },
-      "./bundle": {
-        "types": "./lib/src/bundle.d.ts",
-        "default": "./lib/src/bundle.js"
-      },
-      "./cache-storage": {
-        "types": "./lib/src/cache-storage.d.ts",
-        "default": "./lib/src/cache-storage.js"
-      },
-      "./databricks": {
-        "types": "./lib/src/databricks.d.ts",
-        "default": "./lib/src/databricks.js"
-      },
-      "./files-cache": {
-        "types": "./lib/src/files-cache.d.ts",
-        "default": "./lib/src/files-cache.js"
-      },
-      "./identity": {
-        "types": "./lib/src/identity.d.ts",
-        "default": "./lib/src/identity.js"
-      },
-      "./interceptor": {
-        "types": "./lib/src/interceptor.d.ts",
-        "default": "./lib/src/interceptor.js"
-      },
-      "./lakebase-resolver": {
-        "types": "./lib/src/lakebase-resolver.d.ts",
-        "default": "./lib/src/lakebase-resolver.js"
-      },
-      "./migration": {
-        "types": "./lib/src/migration.d.ts",
-        "default": "./lib/src/migration.js"
-      },
-      "./openapi-tool": {
-        "types": "./lib/src/openapi-tool.d.ts",
-        "default": "./lib/src/openapi-tool.js"
-      },
-      "./pgaddress": {
-        "types": "./lib/src/pgaddress.d.ts",
-        "default": "./lib/src/pgaddress.js"
-      },
-      "./plugin-execution": {
-        "types": "./lib/src/plugin-execution.d.ts",
-        "default": "./lib/src/plugin-execution.js"
-      },
-      "./plugin-registry": {
-        "types": "./lib/src/plugin-registry.d.ts",
-        "default": "./lib/src/plugin-registry.js"
-      },
-      "./provision": {
-        "types": "./lib/src/provision.d.ts",
-        "default": "./lib/src/provision.js"
-      },
-      "./request-tags": {
-        "types": "./lib/src/request-tags.d.ts",
-        "default": "./lib/src/request-tags.js"
-      },
-      "./telemetry": {
-        "types": "./lib/src/telemetry.d.ts",
-        "default": "./lib/src/telemetry.js"
-      },
-      "./tool-operations": {
-        "types": "./lib/src/tool-operations.d.ts",
-        "default": "./lib/src/tool-operations.js"
-      },
-      "./tool-provider": {
-        "types": "./lib/src/tool-provider.d.ts",
-        "default": "./lib/src/tool-provider.js"
-      },
-      "./toolkit-entries": {
-        "types": "./lib/src/toolkit-entries.d.ts",
-        "default": "./lib/src/toolkit-entries.js"
-      },
-      "./*": {
-        "types": "./lib/src/*/index.d.ts",
-        "default": "./lib/src/*/index.js"
-      },
       "./package.json": "./package.json"
     }
   },
-  "version": "0.9.154",
+  "version": "0.9.158",
   "types": "./lib/index.d.ts",
   "dbxToolsConfig": {
     "tags": [
@@ -153,94 +69,10 @@
       "types": "./lib/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./appkit": {
-      "types": "./lib/src/appkit.d.ts",
-      "default": "./lib/src/appkit.js"
-    },
-    "./brand-context": {
-      "types": "./lib/src/brand-context.d.ts",
-      "default": "./lib/src/brand-context.js"
-    },
-    "./bundle": {
-      "types": "./lib/src/bundle.d.ts",
-      "default": "./lib/src/bundle.js"
-    },
-    "./cache-storage": {
-      "types": "./lib/src/cache-storage.d.ts",
-      "default": "./lib/src/cache-storage.js"
-    },
-    "./databricks": {
-      "types": "./lib/src/databricks.d.ts",
-      "default": "./lib/src/databricks.js"
-    },
-    "./files-cache": {
-      "types": "./lib/src/files-cache.d.ts",
-      "default": "./lib/src/files-cache.js"
-    },
-    "./identity": {
-      "types": "./lib/src/identity.d.ts",
-      "default": "./lib/src/identity.js"
-    },
-    "./interceptor": {
-      "types": "./lib/src/interceptor.d.ts",
-      "default": "./lib/src/interceptor.js"
-    },
-    "./lakebase-resolver": {
-      "types": "./lib/src/lakebase-resolver.d.ts",
-      "default": "./lib/src/lakebase-resolver.js"
-    },
-    "./migration": {
-      "types": "./lib/src/migration.d.ts",
-      "default": "./lib/src/migration.js"
-    },
-    "./openapi-tool": {
-      "types": "./lib/src/openapi-tool.d.ts",
-      "default": "./lib/src/openapi-tool.js"
-    },
-    "./pgaddress": {
-      "types": "./lib/src/pgaddress.d.ts",
-      "default": "./lib/src/pgaddress.js"
-    },
-    "./plugin-execution": {
-      "types": "./lib/src/plugin-execution.d.ts",
-      "default": "./lib/src/plugin-execution.js"
-    },
-    "./plugin-registry": {
-      "types": "./lib/src/plugin-registry.d.ts",
-      "default": "./lib/src/plugin-registry.js"
-    },
-    "./provision": {
-      "types": "./lib/src/provision.d.ts",
-      "default": "./lib/src/provision.js"
-    },
-    "./request-tags": {
-      "types": "./lib/src/request-tags.d.ts",
-      "default": "./lib/src/request-tags.js"
-    },
-    "./telemetry": {
-      "types": "./lib/src/telemetry.d.ts",
-      "default": "./lib/src/telemetry.js"
-    },
-    "./tool-operations": {
-      "types": "./lib/src/tool-operations.d.ts",
-      "default": "./lib/src/tool-operations.js"
-    },
-    "./tool-provider": {
-      "types": "./lib/src/tool-provider.d.ts",
-      "default": "./lib/src/tool-provider.js"
-    },
-    "./toolkit-entries": {
-      "types": "./lib/src/toolkit-entries.d.ts",
-      "default": "./lib/src/toolkit-entries.js"
-    },
-    "./*": {
-      "types": "./lib/src/*/index.d.ts",
-      "default": "./lib/src/*/index.js"
-    },
     "./package.json": "./package.json"
   },
   "files": [
-    "index.ts",
+    "index*.ts",
     "src",
     "lib"
   ],

package/src/appkit.ts

@@ -35,8 +35,8 @@ import {
 // AppKit's root barrel re-exports `PluginData` but not `PluginMap`; the package
 // publishes this subpath for exactly that type.
 import type { PluginMap } from "@databricks/appkit/dist/shared/src/plugin";
-import { profile as authProfile } from "@dbx-tools/auth";
-import { asyncUtils, log } from "@dbx-tools/shared-core";
+import { resolveProfile } from "@dbx-tools/auth";
+import { log, tieAbortSignal } from "@dbx-tools/shared-core";
 
 import { resolveAutoConfigurePolicy } from "./_auto-configure.ts";
 import { loadBrandContext } from "./brand-context.ts";
@@ -167,8 +167,8 @@ export async function autoConfigure<T extends AppKitPlugins>(
   }
 
   const controller = new AbortController();
-  asyncUtils.tieAbortSignal(controller, signal);
-  asyncUtils.tieAbortSignal(controller, AbortSignal.timeout(AUTO_CONFIGURE_TIMEOUT_MS));
+  tieAbortSignal(controller, signal);
+  tieAbortSignal(controller, AbortSignal.timeout(AUTO_CONFIGURE_TIMEOUT_MS));
 
   logger.debug("autoConfigure: resolve lakebase", {
     provision: policy.provision,
@@ -229,7 +229,7 @@ async function autoConfigureLakebase(
 
 function applyDefaultProfile(): string | undefined {
   const configured = process.env.DATABRICKS_CONFIG_PROFILE?.trim();
-  const resolved = authProfile.resolveProfile(configured ? { profile: configured } : {});
+  const resolved = resolveProfile(configured ? { profile: configured } : {});
   if (!resolved) {
     delete process.env.DATABRICKS_CONFIG_PROFILE;
     return undefined;

package/src/brand-context.ts

@@ -1,7 +1,7 @@
 import { brandFiles } from "@dbx-tools/core";
-import { brandUtils, type BrandContext } from "@dbx-tools/shared-core";
+import { type BrandContext, defaultBrandContext } from "@dbx-tools/shared-core";
 
-let activeBrandContext: BrandContext = brandUtils.defaultBrandContext;
+let activeBrandContext: BrandContext = defaultBrandContext;
 
 /** Load and activate the brand context found from the supplied directory. */
 export async function loadBrandContext(cwd: string = process.cwd()): Promise<BrandContext> {

package/src/cache-storage.ts

@@ -24,9 +24,9 @@ import {
   flushCache,
   projectCache,
   type CacheOptions,
-} from "@dbx-tools/cache/cache";
+} from "@dbx-tools/cache";
 import { postgresConnectionOptions } from "@dbx-tools/postgres";
-import { errorUtils, hash, log } from "@dbx-tools/shared-core";
+import { log, toError, id } from "@dbx-tools/shared-core";
 import { handleOwnershipMigrationError } from "./migration.ts";
 
 const logger = log.logger("cache-storage");
@@ -217,7 +217,7 @@ export function loadPersistentStorage(): PersistentStorageConstructor | undefine
     return loaded;
   } catch (err) {
     logger.debug("soft persistent cache skipped (PersistentStorage unavailable)", {
-      error: errorUtils.toError(err),
+      error: toError(err),
     });
     persistentStorageCtor = undefined;
     return undefined;
@@ -288,7 +288,7 @@ export function softenInitialize(
 
 /** Verify the migrated cache table can serve the reads and writes AppKit needs. */
 export async function probeStorage(storage: PersistentStorageBase): Promise<void> {
-  const key = `dbx-tools:cache-probe:${hash.id()}`;
+  const key = `dbx-tools:cache-probe:${id()}`;
   try {
     await storage.set(key, { value: key, expiry: Date.now() + 60_000 });
     const result = await storage.get(key);
@@ -330,7 +330,7 @@ async function createPersistentStorage(
     return storage;
   } catch (err) {
     logger.debug("soft persistent cache unavailable", {
-      error: errorUtils.toError(err),
+      error: toError(err),
     });
     if (pool) {
       await pool.end().catch(() => {});

package/src/databricks.ts

@@ -12,7 +12,7 @@
 
 import type { CancellationToken } from "@databricks/sdk-experimental";
 import { Context } from "@databricks/sdk-experimental";
-import { asyncUtils } from "@dbx-tools/shared-core";
+import { tieAbortSignal } from "@dbx-tools/shared-core";
 
 /** Either an SDK `Context` or a WHATWG `AbortSignal`. */
 export type ContextLike = Context | AbortSignal;
@@ -54,7 +54,7 @@ export function toContext(source: AbortController | ContextLike, input?: Context
     return new Context({ cancellationToken: signalToCancellationToken(source) });
   }
   if (input instanceof AbortSignal) {
-    asyncUtils.tieAbortSignal(source, input);
+    tieAbortSignal(source, input);
   } else if (input instanceof Context) {
     const token = input.cancellationToken;
     if (token) tieCancellationToken(source, token);

package/src/files-cache.ts

@@ -5,9 +5,9 @@
  */
 
 import { Plugin, toPlugin, type BasePluginConfig, type PluginManifest } from "@databricks/appkit";
-import { cacheKeys, closeCache, createCache, getOrSet } from "@dbx-tools/cache/cache";
-import { errorUtils, log, object } from "@dbx-tools/shared-core";
-import { posixPath, type CacheValue, type FileSystemCache } from "@dbx-tools/shared-fs";
+import { cacheKeys, closeCache, createCache, getOrSet } from "@dbx-tools/cache";
+import { log, toError, toStableKey } from "@dbx-tools/shared-core";
+import { type CacheValue, type FileSystemCache, normalizeRoot } from "@dbx-tools/shared-fs";
 
 const DEFAULT_TTL_MS = 60_000;
 const DEFAULT_INVALIDATION_BATCH_MS = 25;
@@ -121,9 +121,9 @@ export class FilesCacheManager {
     load: () => T | Promise<T>,
   ): Promise<T> {
     const state = await this.resolveScopeState(input);
-    const paths = identity.paths.map((path) => posixPath.normalizeRoot(path));
+    const paths = identity.paths.map((path) => normalizeRoot(path));
     if (paths.length === 0) throw new TypeError("Filesystem source paths must not be empty");
-    const sourceKey = object.toStableKey({ paths, key: identity.key });
+    const sourceKey = toStableKey({ paths, key: identity.key });
     let source = state.sources.get(sourceKey);
     if (!source) {
       source = Promise.resolve(load());
@@ -139,7 +139,7 @@ export class FilesCacheManager {
 
   private async resolveScopeState(input: FilesCacheScope): Promise<ScopeState> {
     const scope = resolveScope(input, this.config.ttlMs);
-    const scopeKey = object.toStableKey({
+    const scopeKey = toStableKey({
       host: scope.host,
       userKey: scope.userKey,
       workspaceId: scope.workspaceId,
@@ -186,7 +186,7 @@ export class FilesCacheManager {
   }
 
   private group(scope: ResolvedFilesCacheScope): GroupState {
-    const key = object.toStableKey({
+    const key = toStableKey({
       host: scope.host,
       workspaceId: scope.workspaceId,
     });
@@ -247,7 +247,7 @@ export class FilesCacheManager {
       state.group.timer = undefined;
       void this.flushInvalidations(state.group).catch((error) => {
         logger.warn("filesystem cache invalidation batch failed", {
-          error: errorUtils.toError(error),
+          error: toError(error),
         });
       });
     }, this.config.invalidationBatchMs);

package/src/identity.ts

@@ -52,25 +52,16 @@
  */
 
 import { ConfigurationError, Plugin } from "@databricks/appkit";
-import { configUtils } from "@dbx-tools/core";
-import { errorUtils, log, stringUtils, token } from "@dbx-tools/shared-core";
-
-/**
- * Header the Databricks Apps front door forwards the caller's OBO token on.
- * Its presence is what makes `asUser(req)` viable, so it is the signal
- * {@link useServicePrincipal} reads in `"auto"` mode.
- *
- * Re-exported from `@dbx-tools/shared-core`'s `token` module (which reads the
- * same header to decode OAuth scopes) rather than re-spelled, so the name for
- * this wire contract exists once.
- */
-export const ACCESS_TOKEN_HEADER = token.ACCESS_TOKEN_HEADER;
-
-/** Header the Databricks Apps front door forwards the caller's user id on. */
-export const USER_ID_HEADER = token.USER_ID_HEADER;
-
-/** Header the Databricks Apps front door forwards the caller's email on. */
-export const USER_EMAIL_HEADER = token.USER_EMAIL_HEADER;
+import { string, ENV_ONLY } from "@dbx-tools/core";
+import {
+  log,
+  toError,
+  isLevelEnabled,
+  trimToNull,
+  ACCESS_TOKEN_HEADER,
+  USER_ID_HEADER,
+  USER_EMAIL_HEADER,
+} from "@dbx-tools/shared-core";
 
 /** Identity a request's Databricks calls run as. See the module docs. */
 export type IdentityMode = "user" | "service-principal" | "auto";
@@ -103,7 +94,7 @@ export function resolveIdentityMode(
   envKeys: string | readonly string[],
   field = "identity",
 ): IdentityMode {
-  const raw = configUtils.string(configured, envKeys, configUtils.ENV_ONLY);
+  const raw = string(configured, envKeys, ENV_ONLY);
   if (raw === undefined) return DEFAULT_IDENTITY_MODE;
   const mode = raw.toLowerCase() as IdentityMode;
   if (!IDENTITY_MODES.includes(mode)) {
@@ -123,17 +114,17 @@ export function resolveIdentityMode(
  * the first Databricks call.
  */
 export function requestAccessToken(req: HeaderBearing | undefined): string | undefined {
-  return stringUtils.trimToNull(req?.header(ACCESS_TOKEN_HEADER)) ?? undefined;
+  return trimToNull(req?.header(ACCESS_TOKEN_HEADER)) ?? undefined;
 }
 
 /** The forwarded user id on `req`, or `undefined`. */
 export function requestUserId(req: HeaderBearing | undefined): string | undefined {
-  return stringUtils.trimToNull(req?.header(USER_ID_HEADER)) ?? undefined;
+  return trimToNull(req?.header(USER_ID_HEADER)) ?? undefined;
 }
 
 /** The forwarded user email on `req`, or `undefined`. */
 export function requestUserEmail(req: HeaderBearing | undefined): string | undefined {
-  return stringUtils.trimToNull(req?.header(USER_EMAIL_HEADER)) ?? undefined;
+  return trimToNull(req?.header(USER_EMAIL_HEADER)) ?? undefined;
 }
 
 /**
@@ -193,7 +184,7 @@ export function installAsUserDevelopmentPatch(): void {
       );
     };
   } catch (error) {
-    logger.debug("asUser development patch skipped", { error: errorUtils.toError(error) });
+    logger.debug("asUser development patch skipped", { error: toError(error) });
   }
 }
 
@@ -212,7 +203,7 @@ function withAsUserSkipWarnSuppressed<T>(req: HeaderBearing, fn: () => T): T {
   const warn = console.warn;
   console.warn = (...args: unknown[]) => {
     if (
-      !log.isLevelEnabled("debug") &&
+      !isLevelEnabled("debug") &&
       args.some((value) => typeof value === "string" && value.includes(AS_USER_SKIP_WARN))
     ) {
       return;

package/src/interceptor.ts

@@ -20,7 +20,7 @@
  */
 
 import { Plugin, toPlugin, type BasePluginConfig, type PluginManifest } from "@databricks/appkit";
-import { errorUtils, log } from "@dbx-tools/shared-core";
+import { log, toError } from "@dbx-tools/shared-core";
 import type { LakebaseConnection } from "./lakebase-resolver.ts";
 
 const logger = log.logger("interceptor");
@@ -122,7 +122,7 @@ export function createInterceptorContext(env: ResolvedAppEnv): InterceptorRuntim
         // never blocks its siblings.
         logger.warn("lifecycle handler failed", {
           event,
-          error: errorUtils.toError(error),
+          error: toError(error),
         });
       }
     }

package/src/lakebase-resolver.ts

@@ -43,18 +43,7 @@ import {
   type LakebasePool,
   ValidationError,
 } from "@databricks/appkit";
-import { configUtils, projectUtils } from "@dbx-tools/core";
-import {
-  asyncUtils,
-  errorUtils,
-  log,
-  object,
-  options as sharedOptions,
-  stringUtils,
-} from "@dbx-tools/shared-core";
-import { z } from "zod";
-
-import { toContext } from "./databricks.ts";
+import { projectUtils, resolveValue } from "@dbx-tools/core";
 import {
   parseAddress,
   parseResourcePath,
@@ -62,7 +51,20 @@ import {
   SSL_MODES,
   type LakebaseConnectionInputs,
   type SslMode,
-} from "./pgaddress.ts";
+} from "@dbx-tools/lakebase";
+import {
+  log,
+  sleep,
+  toError,
+  isRecord,
+  tcpPortSchema,
+  databricksEnvironmentNames,
+  toSlugWithOptions,
+  MAX_TCP_PORT,
+} from "@dbx-tools/shared-core";
+import { z } from "zod";
+
+import { toContext } from "./databricks.ts";
 
 const logger = log.logger("lakebase-resolver");
 const API_BASE = "/api/2.0/postgres";
@@ -238,7 +240,7 @@ const operationSchema = z.object({
 type Operation = z.infer<typeof operationSchema>;
 
 /** `PGPORT` must land inside the TCP port range. */
-const portSchema = sharedOptions.tcpPortSchema;
+const portSchema = tcpPortSchema;
 
 /**
  * Validate a `PGPORT`-shaped value. Returns `undefined` when unset, and throws
@@ -249,11 +251,7 @@ export function parsePort(value: string | number | undefined): number | undefine
   if (value === undefined || value === "") return undefined;
   const parsed = portSchema.safeParse(value);
   if (!parsed.success) {
-    throw ValidationError.invalidValue(
-      "PGPORT",
-      value,
-      `a TCP port between 1 and ${configUtils.MAX_TCP_PORT}`,
-    );
+    throw ValidationError.invalidValue("PGPORT", value, `a TCP port between 1 and ${MAX_TCP_PORT}`);
   }
   return parsed.data;
 }
@@ -289,7 +287,7 @@ export function nextPollDelay(attempt: number, baseMs: number): number {
  * instead of finishing its backoff first.
  */
 export function pollDelay(attempt: number, baseMs: number, signal?: AbortSignal): Promise<void> {
-  return asyncUtils.sleep(nextPollDelay(attempt, baseMs), signal);
+  return sleep(nextPollDelay(attempt, baseMs), signal);
 }
 
 /**
@@ -309,14 +307,10 @@ export async function readLakebaseInputs(
 ): Promise<LakebaseResolverInputs> {
   const configOptions = { bundleProfile: config?.bundleProfile };
   const rawAddress =
-    config?.endpoint ??
-    configUtils.resolveValue(
-      sharedOptions.databricksEnvironmentNames.lakebaseEndpoint,
-      configOptions,
-    );
+    config?.endpoint ?? resolveValue(databricksEnvironmentNames.lakebaseEndpoint, configOptions);
   const parsed = parseAddress(rawAddress);
-  const portEnv = parsePort(configUtils.resolveValue("PGPORT", configOptions));
-  const sslModeEnv = parseSslMode(configUtils.resolveValue("PGSSLMODE", configOptions));
+  const portEnv = parsePort(resolveValue("PGPORT", configOptions));
+  const sslModeEnv = parseSslMode(resolveValue("PGSSLMODE", configOptions));
   const configuredSslMode = parseSslMode(config?.sslMode);
   const parsedSslMode = parseSslMode(parsed.sslMode);
   return {
@@ -326,9 +320,8 @@ export async function readLakebaseInputs(
     // bare hostnames set `host` instead and leave `endpoint` undefined
     // until the REST resolver fills it in.
     endpoint: parsed.endpoint,
-    database:
-      config?.database ?? configUtils.resolveValue("PGDATABASE", configOptions) ?? parsed.database,
-    host: config?.host ?? configUtils.resolveValue("PGHOST", configOptions) ?? parsed.host,
+    database: config?.database ?? resolveValue("PGDATABASE", configOptions) ?? parsed.database,
+    host: config?.host ?? resolveValue("PGHOST", configOptions) ?? parsed.host,
     port: config?.port ?? portEnv ?? parsed.port,
     sslMode: configuredSslMode ?? sslModeEnv ?? parsedSslMode,
     autoCreate: config?.autoCreate,
@@ -444,7 +437,7 @@ export async function resolveLakebaseConnection(
  */
 export function applyLakebaseToEnv(resolved: LakebaseConnection): void {
   if (resolved.endpoint) {
-    process.env[sharedOptions.databricksEnvironmentNames.lakebaseEndpoint] ??= resolved.endpoint;
+    process.env[databricksEnvironmentNames.lakebaseEndpoint] ??= resolved.endpoint;
   }
   if (resolved.host) process.env.PGHOST ??= resolved.host;
   if (resolved.database) process.env.PGDATABASE ??= resolved.database;
@@ -721,7 +714,7 @@ async function pickOrCreateProject(
  */
 async function defaultProjectId(): Promise<string> {
   const name = projectUtils.name();
-  const slug = stringUtils.toSlugWithOptions({ maxLength: PROJECT_ID_MAX_LEN }, name);
+  const slug = toSlugWithOptions({ maxLength: PROJECT_ID_MAX_LEN }, name);
   if (!slug || !/^[a-z]/.test(slug)) {
     logger.warn("autopg: project name does not slugify to a Lakebase project id", { name });
     throw ConfigurationError.invalidConnection(
@@ -799,9 +792,9 @@ function isAlreadyExistsError(error: unknown): boolean {
 function operationFailed(opName: string, opError: unknown): ExecutionError {
   logger.error("autopg: operation failed", {
     operation: opName,
-    error: errorUtils.toError(opError),
+    error: toError(opError),
   });
-  const code = object.isRecord(opError) ? (opError.code ?? opError.reason) : undefined;
+  const code = isRecord(opError) ? (opError.code ?? opError.reason) : undefined;
   return new ExecutionError(`Lakebase operation failed: ${opName}`, {
     context: {
       operation: opName,

package/src/migration.ts

@@ -1,6 +1,12 @@
 /** Shared classification and logging policy for soft database migrations. */
 
-import { errorUtils, log, type Logger } from "@dbx-tools/shared-core";
+import {
+  type Logger,
+  errorContext,
+  errorMessage,
+  toError,
+  isLevelEnabled,
+} from "@dbx-tools/shared-core";
 
 const loggedOwnershipErrors = new Set<string>();
 
@@ -15,7 +21,7 @@ export interface OwnershipMigrationErrorOptions {
 
 /** Whether a migration failed because the current role does not own an object. */
 export function isOwnershipMigrationError(cause: unknown): boolean {
-  return errorUtils.errorContext(cause).hasMessage("must be owner");
+  return errorContext(cause).hasMessage("must be owner");
 }
 
 /**
@@ -27,12 +33,12 @@ export function handleOwnershipMigrationError(
   options: OwnershipMigrationErrorOptions,
 ): boolean {
   if (!isOwnershipMigrationError(cause)) return false;
-  const message = errorUtils.errorMessage(cause);
+  const message = errorMessage(cause);
   const key = `${options.scope}\0${message}`;
   if (loggedOwnershipErrors.has(key)) return true;
   loggedOwnershipErrors.add(key);
-  const error = errorUtils.toError(cause);
-  if (log.isLevelEnabled("debug")) options.logger.error(options.event, { error });
+  const error = toError(cause);
+  if (isLevelEnabled("debug")) options.logger.error(options.event, { error });
   else options.logger.warn(options.event, { error, ...options.context });
   return true;
 }