@databricks/sdk-core 0.0.0-dev → 0.1.0-dev.1

package/dist/profiles/profile.js

@@ -0,0 +1,307 @@
+/**
+ * Profile interface and property mapping for Databricks configuration.
+ *
+ * @module
+ */
+import { Secret } from './secret';
+/**
+ * Reserved INI section name for SDK settings. It is never treated as a
+ * profile.
+ */
+export const SETTINGS_SECTION = '__settings__';
+/**
+ * Parses common boolean string representations (true/false, 1/0, t/f and
+ * their case variants).
+ */
+function parseBool(value) {
+    switch (value) {
+        case '1':
+        case 't':
+        case 'T':
+        case 'TRUE':
+        case 'true':
+        case 'True':
+            return true;
+        case '0':
+        case 'f':
+        case 'F':
+        case 'FALSE':
+        case 'false':
+        case 'False':
+            return false;
+        default:
+            throw new Error(`invalid boolean value: "${value}"`);
+    }
+}
+/**
+ * Declarative property mapping table for all known profile fields.
+ */
+// eslint-disable-next-line @typescript-eslint/no-deprecated -- The table includes azureLoginAppId for backward compatibility.
+export const PROPERTY_DEFS = [
+    {
+        field: 'host',
+        envVar: 'DATABRICKS_HOST',
+        iniKey: 'host',
+        set: (p, v) => {
+            p.host = v;
+        },
+        get: (p) => p.host,
+    },
+    {
+        field: 'workspaceId',
+        envVar: 'DATABRICKS_WORKSPACE_ID',
+        iniKey: 'workspace_id',
+        set: (p, v) => {
+            p.workspaceId = v;
+        },
+        get: (p) => p.workspaceId,
+    },
+    {
+        field: 'accountId',
+        envVar: 'DATABRICKS_ACCOUNT_ID',
+        iniKey: 'account_id',
+        set: (p, v) => {
+            p.accountId = v;
+        },
+        get: (p) => p.accountId,
+    },
+    {
+        field: 'token',
+        envVar: 'DATABRICKS_TOKEN',
+        iniKey: 'token',
+        set: (p, v) => {
+            p.token = new Secret(v);
+        },
+        get: (p) => p.token?.value,
+    },
+    {
+        field: 'username',
+        envVar: 'DATABRICKS_USERNAME',
+        iniKey: 'username',
+        set: (p, v) => {
+            p.username = v;
+        },
+        get: (p) => p.username,
+    },
+    {
+        field: 'password',
+        envVar: 'DATABRICKS_PASSWORD',
+        iniKey: 'password',
+        set: (p, v) => {
+            p.password = new Secret(v);
+        },
+        get: (p) => p.password?.value,
+    },
+    {
+        field: 'authType',
+        envVar: 'DATABRICKS_AUTH_TYPE',
+        iniKey: 'auth_type',
+        set: (p, v) => {
+            p.authType = v;
+        },
+        get: (p) => p.authType,
+    },
+    {
+        field: 'clientId',
+        envVar: 'DATABRICKS_CLIENT_ID',
+        iniKey: 'client_id',
+        set: (p, v) => {
+            p.clientId = v;
+        },
+        get: (p) => p.clientId,
+    },
+    {
+        field: 'clientSecret',
+        envVar: 'DATABRICKS_CLIENT_SECRET',
+        iniKey: 'client_secret',
+        set: (p, v) => {
+            p.clientSecret = new Secret(v);
+        },
+        get: (p) => p.clientSecret?.value,
+    },
+    {
+        field: 'databricksCliPath',
+        envVar: 'DATABRICKS_CLI_PATH',
+        iniKey: 'databricks_cli_path',
+        set: (p, v) => {
+            p.databricksCliPath = v;
+        },
+        get: (p) => p.databricksCliPath,
+    },
+    {
+        field: 'metadataServiceUrl',
+        envVar: 'DATABRICKS_METADATA_SERVICE_URL',
+        iniKey: 'metadata_service_url',
+        set: (p, v) => {
+            p.metadataServiceUrl = new Secret(v);
+        },
+        get: (p) => p.metadataServiceUrl?.value,
+    },
+    {
+        field: 'actionsIdTokenRequestUrl',
+        envVar: 'ACTIONS_ID_TOKEN_REQUEST_URL',
+        iniKey: 'actions_id_token_request_url',
+        set: (p, v) => {
+            p.actionsIdTokenRequestUrl = v;
+        },
+        get: (p) => p.actionsIdTokenRequestUrl,
+    },
+    {
+        field: 'actionsIdTokenRequestToken',
+        envVar: 'ACTIONS_ID_TOKEN_REQUEST_TOKEN',
+        iniKey: 'actions_id_token_request_token',
+        set: (p, v) => {
+            p.actionsIdTokenRequestToken = new Secret(v);
+        },
+        get: (p) => p.actionsIdTokenRequestToken?.value,
+    },
+    {
+        field: 'oidcTokenEnv',
+        envVar: 'DATABRICKS_OIDC_TOKEN_ENV',
+        iniKey: 'oidc_token_env',
+        set: (p, v) => {
+            p.oidcTokenEnv = v;
+        },
+        get: (p) => p.oidcTokenEnv,
+    },
+    // Intentional mismatch between envVar and iniKey for backward compatibility.
+    {
+        field: 'oidcTokenFilePath',
+        envVar: 'DATABRICKS_OIDC_TOKEN_FILEPATH',
+        iniKey: 'databricks_id_token_filepath',
+        set: (p, v) => {
+            p.oidcTokenFilePath = v;
+        },
+        get: (p) => p.oidcTokenFilePath,
+    },
+    // Intentional mismatch between envVar and iniKey for backward compatibility.
+    {
+        field: 'tokenAudience',
+        envVar: 'DATABRICKS_TOKEN_AUDIENCE',
+        iniKey: 'audience',
+        set: (p, v) => {
+            p.tokenAudience = v;
+        },
+        get: (p) => p.tokenAudience,
+    },
+    {
+        field: 'discoveryUrl',
+        envVar: 'DATABRICKS_DISCOVERY_URL',
+        iniKey: 'discovery_url',
+        set: (p, v) => {
+            p.discoveryUrl = v;
+        },
+        get: (p) => p.discoveryUrl,
+    },
+    {
+        field: 'azureClientId',
+        envVar: 'ARM_CLIENT_ID',
+        iniKey: 'azure_client_id',
+        set: (p, v) => {
+            p.azureClientId = v;
+        },
+        get: (p) => p.azureClientId,
+    },
+    {
+        field: 'azureClientSecret',
+        envVar: 'ARM_CLIENT_SECRET',
+        iniKey: 'azure_client_secret',
+        set: (p, v) => {
+            p.azureClientSecret = new Secret(v);
+        },
+        get: (p) => p.azureClientSecret?.value,
+    },
+    {
+        field: 'azureTenantId',
+        envVar: 'ARM_TENANT_ID',
+        iniKey: 'azure_tenant_id',
+        set: (p, v) => {
+            p.azureTenantId = v;
+        },
+        get: (p) => p.azureTenantId,
+    },
+    // Intentional mismatch between envVar and iniKey for backward compatibility.
+    {
+        field: 'azureResourceId',
+        envVar: 'DATABRICKS_AZURE_RESOURCE_ID',
+        iniKey: 'azure_workspace_resource_id',
+        set: (p, v) => {
+            p.azureResourceId = v;
+        },
+        get: (p) => p.azureResourceId,
+    },
+    {
+        field: 'azureEnvironment',
+        envVar: 'ARM_ENVIRONMENT',
+        iniKey: 'azure_environment',
+        set: (p, v) => {
+            p.azureEnvironment = v;
+        },
+        get: (p) => p.azureEnvironment,
+    },
+    {
+        field: 'azureLoginAppId',
+        envVar: 'DATABRICKS_AZURE_LOGIN_APP_ID',
+        iniKey: 'azure_login_app_id',
+        set: (p, v) => {
+            p.azureLoginAppId = v; // eslint-disable-line @typescript-eslint/no-deprecated
+        },
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        get: (p) => p.azureLoginAppId,
+    },
+    {
+        field: 'azureUseMsi',
+        envVar: 'ARM_USE_MSI',
+        iniKey: 'azure_use_msi',
+        set: (p, v) => {
+            p.azureUseMsi = parseBool(v);
+        },
+        get: (p) => p.azureUseMsi === undefined ? undefined : String(p.azureUseMsi),
+    },
+    {
+        field: 'googleCredentials',
+        envVar: 'GOOGLE_CREDENTIALS',
+        iniKey: 'google_credentials',
+        set: (p, v) => {
+            p.googleCredentials = new Secret(v);
+        },
+        get: (p) => p.googleCredentials?.value,
+    },
+    {
+        field: 'googleServiceAccount',
+        envVar: 'DATABRICKS_GOOGLE_SERVICE_ACCOUNT',
+        iniKey: 'google_service_account',
+        set: (p, v) => {
+            p.googleServiceAccount = v;
+        },
+        get: (p) => p.googleServiceAccount,
+    },
+    {
+        field: 'clusterId',
+        envVar: 'DATABRICKS_CLUSTER_ID',
+        iniKey: 'cluster_id',
+        set: (p, v) => {
+            p.clusterId = v;
+        },
+        get: (p) => p.clusterId,
+    },
+    {
+        field: 'warehouseId',
+        envVar: 'DATABRICKS_WAREHOUSE_ID',
+        iniKey: 'warehouse_id',
+        set: (p, v) => {
+            p.warehouseId = v;
+        },
+        get: (p) => p.warehouseId,
+    },
+    {
+        field: 'serverlessComputeId',
+        envVar: 'DATABRICKS_SERVERLESS_COMPUTE_ID',
+        iniKey: 'serverless_compute_id',
+        set: (p, v) => {
+            p.serverlessComputeId = v;
+        },
+        get: (p) => p.serverlessComputeId,
+    },
+];
+//# sourceMappingURL=profile.js.map

package/dist/profiles/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/profiles/profile.ts"],"names":[],"mappings":"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"}

package/dist/profiles/resolve.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Node.js implementation of profile resolution.
+ *
+ * @module
+ */
+import type { Profile, ResolveOptions } from './profile';
+/**
+ * Creates a {@link Profile} from a databrickscfg file and/or environment
+ * variables.
+ *
+ * With no options, the defaults are used: read the default config file and
+ * overlay environment variables.
+ *
+ * When any explicit option is provided, only the requested behaviors are
+ * enabled.
+ */
+export declare function resolve(options?: ResolveOptions): Promise<Profile>;
+/**
+ * Returns the path to the default databrickscfg file. Reads
+ * DATABRICKS_CONFIG_FILE from the environment, falling back to
+ * ~/.databrickscfg.
+ */
+export declare function defaultConfigFile(): string;
+/**
+ * Returns the names of all profiles (INI sections) in the given config
+ * file. The DEFAULT section is included only if it has keys.
+ */
+export declare function listProfiles(path: string): Promise<string[]>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/profiles/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/profiles/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAC,OAAO,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AA8JvD;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBxE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BlE"}

package/dist/profiles/resolve.js

@@ -0,0 +1,206 @@
+/**
+ * Node.js implementation of profile resolution.
+ *
+ * @module
+ */
+import { access, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { ProfileError } from './errors';
+import { parseIni } from './ini';
+import { PROPERTY_DEFS, SETTINGS_SECTION } from './profile';
+/**
+ * Reports whether a section is an empty DEFAULT section that should be
+ * treated as non-existent.
+ *
+ * In the INI format, DEFAULT is typically a special fallback section, not a
+ * regular section. Databricks historically treats DEFAULT as a regular
+ * profile name. An intentionally empty [DEFAULT] section is silently ignored.
+ */
+function isPhantomDefault(name, section) {
+    return name === 'DEFAULT' && section.size === 0;
+}
+/**
+ * Returns ~/.databrickscfg without checking environment variables.
+ */
+function defaultConfigFilePath() {
+    try {
+        return join(homedir(), '.databrickscfg');
+    }
+    catch {
+        return '';
+    }
+}
+/** Returns true if the file at the given path exists. */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Loads a profile from a databrickscfg file. If filePath is undefined,
+ * reads DATABRICKS_CONFIG_FILE from the environment, falling back to
+ * ~/.databrickscfg.
+ */
+async function loadFile(filePath, profileName) {
+    // Determine file path.
+    let explicitFile = filePath !== undefined;
+    let path;
+    if (filePath !== undefined) {
+        path = filePath;
+    }
+    else {
+        const envPath = process.env.DATABRICKS_CONFIG_FILE ?? '';
+        if (envPath !== '') {
+            path = envPath;
+            explicitFile = true;
+        }
+        else {
+            path = defaultConfigFilePath();
+        }
+    }
+    // A missing default file is silently skipped.
+    if (!(await fileExists(path))) {
+        if (explicitFile) {
+            throw new ProfileError('CONFIG_FILE_NOT_FOUND', `config file not found: ${path}`);
+        }
+        return {};
+    }
+    const content = await readFile(path, 'utf8');
+    const data = parseIni(content);
+    // Profile name resolution chain:
+    // 1. Explicit profile name (from option).
+    // 2. DATABRICKS_CONFIG_PROFILE environment variable.
+    // 3. default_profile key in __settings__ section.
+    // 4. DEFAULT section (fallback).
+    let resolved = profileName;
+    if (resolved === undefined) {
+        const envProfile = process.env.DATABRICKS_CONFIG_PROFILE ?? '';
+        if (envProfile !== '') {
+            resolved = envProfile;
+        }
+    }
+    if (resolved === undefined) {
+        const settings = data.get(SETTINGS_SECTION);
+        if (settings !== undefined) {
+            const dp = settings.get('default_profile') ?? '';
+            if (dp !== '') {
+                resolved = dp;
+            }
+        }
+    }
+    if (resolved === SETTINGS_SECTION) {
+        throw new ProfileError('INVALID_PROFILE_NAME', `invalid profile name: "${resolved}" is a reserved section`);
+    }
+    const explicitProfile = resolved !== undefined;
+    resolved ??= 'DEFAULT';
+    const section = data.get(resolved);
+    if (section === undefined || isPhantomDefault(resolved, section)) {
+        if (explicitProfile) {
+            throw new ProfileError('PROFILE_NOT_FOUND', `profile not found: "${resolved}" in ${path}`);
+        }
+        return {};
+    }
+    // Build profile from section values.
+    const profile = { name: resolved };
+    const knownKeys = new Set();
+    for (const def of PROPERTY_DEFS) {
+        knownKeys.add(def.iniKey);
+        const value = section.get(def.iniKey);
+        if (value !== undefined) {
+            def.set(profile, value);
+        }
+    }
+    // Collect extra keys that are not in the property mapping.
+    for (const [key, value] of section) {
+        if (!knownKeys.has(key)) {
+            profile.extra ??= {};
+            profile.extra[key] = value;
+        }
+    }
+    return profile;
+}
+/**
+ * Builds a profile from environment variables. Empty environment variables
+ * are treated as unset. Returns only the fields that were found.
+ */
+function loadEnv() {
+    const profile = {};
+    for (const def of PROPERTY_DEFS) {
+        const value = process.env[def.envVar] ?? '';
+        if (value !== '') {
+            def.set(profile, value);
+        }
+    }
+    return profile;
+}
+/**
+ * Creates a {@link Profile} from a databrickscfg file and/or environment
+ * variables.
+ *
+ * With no options, the defaults are used: read the default config file and
+ * overlay environment variables.
+ *
+ * When any explicit option is provided, only the requested behaviors are
+ * enabled.
+ */
+export async function resolve(options) {
+    if (options?.filePath === '') {
+        throw new ProfileError('EMPTY_PATH', 'empty path');
+    }
+    if (options?.profile === '') {
+        throw new ProfileError('EMPTY_PROFILE', 'empty profile');
+    }
+    const shouldReadFile = options === undefined ||
+        options.filePath !== undefined ||
+        options.profile !== undefined ||
+        (options.withFile ?? false);
+    const shouldReadEnv = options === undefined || (options.withEnv ?? false);
+    const fileProfile = shouldReadFile
+        ? await loadFile(options?.filePath, options?.profile)
+        : {};
+    const envProfile = shouldReadEnv ? loadEnv() : {};
+    return { ...fileProfile, ...envProfile };
+}
+/**
+ * Returns the path to the default databrickscfg file. Reads
+ * DATABRICKS_CONFIG_FILE from the environment, falling back to
+ * ~/.databrickscfg.
+ */
+export function defaultConfigFile() {
+    const envPath = process.env.DATABRICKS_CONFIG_FILE ?? '';
+    if (envPath !== '') {
+        return envPath;
+    }
+    return defaultConfigFilePath();
+}
+/**
+ * Returns the names of all profiles (INI sections) in the given config
+ * file. The DEFAULT section is included only if it has keys.
+ */
+export async function listProfiles(path) {
+    if (path === '') {
+        throw new ProfileError('CONFIG_FILE_NOT_FOUND', 'config file not found: empty path');
+    }
+    if (!(await fileExists(path))) {
+        throw new ProfileError('CONFIG_FILE_NOT_FOUND', `config file not found: ${path}`);
+    }
+    const content = await readFile(path, 'utf8');
+    const data = parseIni(content);
+    const names = [];
+    for (const [name, keys] of data) {
+        if (name === SETTINGS_SECTION) {
+            continue;
+        }
+        if (isPhantomDefault(name, keys)) {
+            continue;
+        }
+        names.push(name);
+    }
+    return names;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/profiles/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/profiles/resolve.ts"],"names":[],"mappings":"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"}

package/dist/profiles/secret.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Obfuscated string type for secrets in configuration profiles.
+ *
+ * @module
+ */
+/**
+ * A string value that is obfuscated in all string representations to prevent
+ * accidental secret leakage in logs, serialization, and debugging output.
+ *
+ * Use {@link Secret.value} for intentional access to the underlying value.
+ */
+export declare class Secret {
+    private readonly rawValue;
+    /**
+     * @param rawValue - The underlying secret string.
+     */
+    constructor(rawValue: string);
+    /** Returns the underlying secret value. */
+    get value(): string;
+    /** Returns the obfuscated placeholder instead of the secret. */
+    toString(): string;
+    /** Returns the obfuscated placeholder when serialized to JSON. */
+    toJSON(): string;
+}
+//# sourceMappingURL=secret.d.ts.map

package/dist/profiles/secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../src/profiles/secret.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,qBAAa,MAAM;IAIL,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC;;OAEG;gBAC0B,QAAQ,EAAE,MAAM;IAE7C,2CAA2C;IAC3C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,gEAAgE;IAChE,QAAQ,IAAI,MAAM;IAIlB,kEAAkE;IAClE,MAAM,IAAI,MAAM;CAQjB"}

package/dist/profiles/secret.js

@@ -0,0 +1,38 @@
+/**
+ * Obfuscated string type for secrets in configuration profiles.
+ *
+ * @module
+ */
+const OBFUSCATED = '********';
+/**
+ * A string value that is obfuscated in all string representations to prevent
+ * accidental secret leakage in logs, serialization, and debugging output.
+ *
+ * Use {@link Secret.value} for intentional access to the underlying value.
+ */
+export class Secret {
+    rawValue;
+    /**
+     * @param rawValue - The underlying secret string.
+     */
+    constructor(rawValue) {
+        this.rawValue = rawValue;
+    }
+    /** Returns the underlying secret value. */
+    get value() {
+        return this.rawValue;
+    }
+    /** Returns the obfuscated placeholder instead of the secret. */
+    toString() {
+        return OBFUSCATED;
+    }
+    /** Returns the obfuscated placeholder when serialized to JSON. */
+    toJSON() {
+        return OBFUSCATED;
+    }
+    /** Returns the obfuscated placeholder for Node.js `util.inspect` output. */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return OBFUSCATED;
+    }
+}
+//# sourceMappingURL=secret.js.map

package/dist/profiles/secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.js","sourceRoot":"","sources":["../../src/profiles/secret.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,OAAO,MAAM;IAIY;IAH7B;;OAEG;IACH,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD,2CAA2C;IAC3C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,gEAAgE;IAChE,QAAQ;QACN,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,kEAAkE;IAClE,MAAM;QACJ,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4EAA4E;IAC5E,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/wkt/fieldmask.d.ts

@@ -0,0 +1,32 @@
+/**
+ * One field entry in a {@link FieldMaskSchema}: its wire-format name and, for message-typed fields, a lazy reference to the nested message's schema. Array, map, enum, and scalar fields omit `children`.
+ */
+export interface FieldMaskSchemaField {
+    readonly wire: string;
+    readonly children?: () => FieldMaskSchema;
+}
+/**
+ * Structural description of one message's FieldMask-reachable fields. Maps each typescript field name to its wire-format name and, for message-typed fields, a lazy `() => FieldMaskSchema` reference that lets recursive and mutually-recursive messages describe themselves.
+ */
+export type FieldMaskSchema = Readonly<Record<string, FieldMaskSchemaField>>;
+/**
+ * A field mask implementing google.protobuf.FieldMask semantics.
+ */
+export declare class FieldMask<T = unknown> {
+    private readonly _tag;
+    private readonly paths;
+    private constructor();
+    /**
+     * Build a FieldMask from typescript field name paths against the target message's schema. Validates every path by walking each segment through the schema and throws Error when any segment fails.
+     *
+     * Reserved for generated per-message factories; user code should call the factory (e.g. `alertFieldMask(...)`), which supplies the schema before delegating here.
+     *
+     * @internal
+     */
+    static build<T>(paths: string[], schema: FieldMaskSchema): FieldMask<T>;
+    /**
+     * Serialize the mask to the wire-format string.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=fieldmask.d.ts.map

package/dist/wkt/fieldmask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldmask.d.ts","sourceRoot":"","sources":["../../src/wkt/fieldmask.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,eAAe,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAwB7E;;GAEG;AACH,qBAAa,SAAS,CAAC,CAAC,GAAG,OAAO;IAEhC,iBAAyB,IAAI,CAAI;IAGjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,OAAO;IAIP;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC;IAavE;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}