@kwiz/node 1.0.32 → 1.0.36

package/dist/sf/actions.js

@@ -0,0 +1,251 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sfGetUserName = sfGetUserName;
+exports.sfIsConnectionValid = sfIsConnectionValid;
+exports.sfGetFields = sfGetFields;
+exports.sfGetRecords = sfGetRecords;
+exports.sfGetOrgInfo = sfGetOrgInfo;
+exports.sfGetObjects = sfGetObjects;
+exports.sfCreateItem = sfCreateItem;
+exports.sfGetField = sfGetField;
+exports.sfAddField = sfAddField;
+exports.sfUpdateField = sfUpdateField;
+exports.sfSetFieldPermissions = sfSetFieldPermissions;
+exports.sfAttachFile = sfAttachFile;
+const common_1 = require("@kwiz/common");
+const constants_1 = require("./constants");
+const types_1 = require("./types");
+function sfGetUserName(conn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        try {
+            let userId = (_a = conn.userInfo) === null || _a === void 0 ? void 0 : _a.id;
+            if ((0, common_1.isNullOrEmptyString)(userId)) {
+                const identity = yield conn.identity();
+                //console.log(identity);
+                if ((0, common_1.isNotEmptyString)(identity.display_name))
+                    return identity.display_name;
+                userId = identity.user_id;
+            }
+            const ui = yield conn.query("SELECT Name FROM User WHERE Id = '" + userId + "'");
+            return ui.records[0].Name;
+        }
+        catch (e) {
+            console.error(e);
+            return types_1.sf_unknown_user;
+        }
+    });
+}
+function sfIsConnectionValid(conn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const userName = yield sfGetUserName(conn);
+        return userName !== types_1.sf_unknown_user;
+    });
+}
+function sfGetFields(conn, entity) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const ent = yield conn.sobject(entity).describe();
+        return ent.fields;
+    });
+}
+function sfGetRecords(conn_1, entity_1) {
+    return __awaiter(this, arguments, void 0, function* (conn, entity, select = ["Id, Name"], accessAsAppInstanceUrl) {
+        const records = yield conn.query(`SELECT ${select.join(', ')} FROM ${entity}`);
+        return records;
+    });
+}
+function sfGetOrgInfo(conn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const result = yield (conn === null || conn === void 0 ? void 0 : conn.query("SELECT Id, Name FROM Organization LIMIT 1"));
+        return {
+            instanceUrl: conn.instanceUrl,
+            orgId: result.records[0].Id,
+            orgName: result.records[0].Name
+        };
+    });
+}
+function sfGetObjects(conn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const objects = yield conn.describeGlobal();
+        //console.log(objects);
+        return objects.sobjects;
+    });
+}
+function sfCreateItem(conn, entity, values) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const sObject = conn.sobject(entity);
+            const result = yield sObject.create(values, {
+                headers: {
+                    //bypass duplicate check
+                    'Sforce-Duplicate-Rule-Header': 'allowSave=true'
+                }
+            });
+            //console.log(result);
+            return result;
+        }
+        catch (e) {
+            const typedError = e;
+            return {
+                success: false,
+                errors: [{
+                        errorCode: typedError.errorCode || "unknown error",
+                        message: typedError.message || (0, common_1.GetError)(e) || "unexpected error"
+                    }]
+            };
+        }
+    });
+}
+function sfGetField(conn, entity, name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return conn.metadata.read("CustomField", `${entity}.${name}`);
+    });
+}
+function sfAddField(conn, info) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            if (!info.fullName.endsWith(constants_1.sf_custom_field_name_suffix))
+                info.fullName = `${info.fullName}${constants_1.sf_custom_field_name_suffix}`;
+            const result = yield conn.metadata.create("CustomField", info);
+            //set visibiliy on new field
+            //console.log(result);
+            return result;
+        }
+        catch (e) {
+            const typedError = e;
+            return {
+                success: false,
+                fullName: info.fullName,
+                errors: [{
+                        statusCode: typedError.errorCode || "unknown error",
+                        message: typedError.message || (0, common_1.GetError)(e) || "unexpected error",
+                        extendedErrorDetails: [], fields: []
+                    }]
+            };
+        }
+    });
+}
+function sfUpdateField(conn, info) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const field = yield conn.metadata.read("CustomField", info.fullName);
+        if (!field)
+            return {
+                success: false,
+                fullName: info.fullName,
+                errors: [{ statusCode: "FIELD_NOT_FOUND", message: `Could not find field ${info.fullName}`, extendedErrorDetails: [], fields: [] }]
+            };
+        if ((0, common_1.isNullOrUndefined)(info.type))
+            info.type = field.type;
+        if ((0, common_1.isNullOrEmptyString)(info.label))
+            info.label = field.label;
+        else if (field.type !== info.type)
+            return {
+                success: false,
+                fullName: info.fullName,
+                errors: [{ statusCode: "DO_NOT_CHANGE_TYPE", message: "Do not change field type - data loss risk", extendedErrorDetails: [], fields: [] }]
+            };
+        const result = yield conn.metadata.update("CustomField", info);
+        //console.log(result);
+        return result;
+    });
+}
+function sfSetFieldPermissions(conn, fieldName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            //set visibiliy on new field
+            const result = yield (conn === null || conn === void 0 ? void 0 : conn.query("SELECT Id, Name FROM Profile"));
+            const chunks = (0, common_1.chunkArray)([...types_1.sf_builtin_profiles, ...result.records.map(r => r.Name)], types_1.sf_throttle);
+            //no need to check anything - just run the update
+            yield (0, common_1.forEachAsync)(chunks, (names) => __awaiter(this, void 0, void 0, function* () {
+                yield conn.metadata.update("Profile", names.map(name => ({
+                    fullName: name,
+                    fieldPermissions: [{
+                            editable: true,
+                            field: fieldName,
+                            readable: true
+                        }]
+                })));
+            }));
+            //can check - but no need... faster to just update
+            // await forEachAsync(chunks, async names => {
+            //     let chunkProfiles = await conn!.metadata.read("Profile", names);
+            //     chunkProfiles = chunkProfiles.filter(p => {
+            //         if (isNullOrEmptyString(p.fullName)
+            //             || isNullOrEmptyArray(p.fieldPermissions))
+            //             return false;//skip system accounts
+            //         const existing = firstOrNull(p.fieldPermissions, fp => fp.field === fieldName);
+            //         if (existing && existing.editable && existing.readable)
+            //             return false;//skip accounts that already have permissions set
+            //         else {
+            //             //make the change...
+            //             if (existing) {
+            //                 existing.editable = true;
+            //                 existing.readable = true;
+            //             }
+            //             else p.fieldPermissions.push({
+            //                 editable: true,
+            //                 field: fieldName,
+            //                 readable: true
+            //             });
+            //             return true;
+            //         }
+            //     });
+            //     if (isNotEmptyArray(chunkProfiles)) {
+            //         await conn!.metadata.update("Profile", chunkProfiles.map(p => ({
+            //             fullName: p.fullName,
+            //             fieldPermissions: p.fieldPermissions
+            //         })));
+            //         profilesToUpdate.push(...chunkProfiles);
+            //     }
+            // });
+            return { success: true };
+        }
+        catch (e) {
+            const typedError = e;
+            return {
+                success: false,
+                error: {
+                    statusCode: typedError.errorCode || "unknown error",
+                    message: typedError.message || (0, common_1.GetError)(e) || "unexpected error"
+                }
+            };
+        }
+    });
+}
+function sfAttachFile(conn, itemId, file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const base64Marker = 'base64,';
+        const base64 = (file.base64.indexOf(base64Marker) >= 0)
+            ? file.base64.slice(file.base64.indexOf(base64Marker) + base64Marker.length)
+            : file.base64;
+        const res = yield conn.sobject('ContentVersion').create({
+            PathOnClient: file.filename,
+            Title: file.filename,
+            VersionData: base64
+            // Add other fields as needed, e.g., Origin: 'C' for Chatter files
+        });
+        if (res.success) {
+            //wait for it to be committed - get it from DB
+            const docId = yield conn.sobject('ContentVersion').retrieve(res.id); // await conn?.query(`SELECT contentdocumentid FROM ContentVersion where id = '${res.id}'`);
+            //use it to make the link
+            const linkRes = yield conn.sobject('ContentDocumentLink').create({
+                ContentDocumentId: docId.ContentDocumentId,
+                LinkedEntityId: itemId,
+                ShareType: 'V', // 'V' for Viewer, 'C' for Collaborator, 'I' for Inferred
+                Visibility: 'AllUsers'
+            });
+            return linkRes.success;
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=actions.js.map

package/dist/sf/actions.js.map

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

package/dist/sf/connections.d.ts

@@ -0,0 +1,10 @@
+import { Connection } from "@jsforce/jsforce-node";
+import { isf_cfg, isf_user_token } from "./types";
+export declare function sf_conn_app(cfg: isf_cfg, instanceUrl: string): Promise<Connection<import("@jsforce/jsforce-node").Schema>>;
+export declare function sf_conn_user(cfg: isf_cfg, userToken: isf_user_token): Promise<Connection<import("@jsforce/jsforce-node").Schema>>;
+/** your redirect page will get an authorization code. call sf_oauth2_authorize to exchange for an access token.
+ * look for query params: code, error, error_description, state
+ */
+export declare function sf_signin_redirect(cfg: isf_cfg, state: string, sandbox?: boolean): Promise<string>;
+/** complete the user sign in flow, use the code to get an access token */
+export declare function sf_oauth2_authorize(cfg: isf_cfg, authorizationCode: string, sandbox?: boolean): Promise<isf_user_token>;

package/dist/sf/connections.js

@@ -0,0 +1,108 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sf_conn_app = sf_conn_app;
+exports.sf_conn_user = sf_conn_user;
+exports.sf_signin_redirect = sf_signin_redirect;
+exports.sf_oauth2_authorize = sf_oauth2_authorize;
+const jsforce_node_1 = require("@jsforce/jsforce-node");
+const common_1 = require("@kwiz/common");
+const actions_1 = require("./actions");
+const types_1 = require("./types");
+const useInstanceForLogin = true; //this is the preferred method
+function getOauth2Config(cfg, instanceUrl) {
+    const loginUrl = useInstanceForLogin
+        ? instanceUrl
+        : instanceUrl.includes('.sandbox.my.salesforce.com') ? types_1.sf_instances.sandbox : types_1.sf_instances.default;
+    return {
+        clientId: cfg.clientId,
+        clientSecret: cfg.clientSecret,
+        redirectUri: cfg.redirectUri,
+        loginUrl: loginUrl
+    };
+}
+function hasTokenError(t) {
+    return (0, common_1.isNotEmptyString)(t.error);
+}
+function sf_conn_app(cfg, instanceUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const oauth2Config = getOauth2Config(cfg, instanceUrl);
+            //get app only token
+            const buffer = Buffer.from(`${oauth2Config.clientId}:${oauth2Config.clientSecret}`, 'utf8');
+            const base64EncodedString = buffer.toString('base64');
+            const token = yield fetch(`${instanceUrl}/services/oauth2/token`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Basic ${base64EncodedString}`,
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                },
+                body: `grant_type=client_credentials`
+            });
+            //get the token response
+            const token_json = (yield token.json());
+            if (hasTokenError(token_json)) {
+                throw token_json;
+            }
+            //configure the connection
+            const conn = new jsforce_node_1.Connection({
+                instanceUrl: token_json.instance_url,
+                accessToken: token_json.access_token
+            });
+            return conn;
+        }
+        catch (e) {
+            console.error(e);
+            return null;
+        }
+    });
+}
+function sf_conn_user(cfg, userToken) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (cfg && userToken) {
+            const conn = new jsforce_node_1.default.Connection({
+                oauth2: getOauth2Config(cfg, userToken.instanceUrl),
+                instanceUrl: userToken.instanceUrl,
+                accessToken: userToken.accessToken,
+            });
+            return conn;
+        }
+        return null;
+    });
+}
+/** your redirect page will get an authorization code. call sf_oauth2_authorize to exchange for an access token.
+ * look for query params: code, error, error_description, state
+ */
+function sf_signin_redirect(cfg, state, sandbox) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const redirectUrl = new jsforce_node_1.default.OAuth2(getOauth2Config(cfg, sandbox ? types_1.sf_instances.sandbox : types_1.sf_instances.default)).getAuthorizationUrl({
+            //which page the user  came from
+            state: (0, common_1.jsonStringify)(state)
+        });
+        return redirectUrl;
+    });
+}
+/** complete the user sign in flow, use the code to get an access token */
+function sf_oauth2_authorize(cfg, authorizationCode, sandbox) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const conn = new jsforce_node_1.default.Connection({
+            oauth2: getOauth2Config(cfg, sandbox ? types_1.sf_instances.sandbox : types_1.sf_instances.default)
+        });
+        yield conn.authorize(authorizationCode);
+        const userName = yield (0, actions_1.sfGetUserName)(conn);
+        return ({
+            accessToken: conn.accessToken,
+            instanceUrl: conn.instanceUrl,
+            userName
+        });
+    });
+}
+//# sourceMappingURL=connections.js.map

package/dist/sf/connections.js.map

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

package/dist/sf/constants.d.ts

@@ -0,0 +1,17 @@
+export declare const sf_custom_field_name_suffix = "__c";
+export declare const sf_metadata_field_type_info: {
+    Text: string;
+    Checkbox: string;
+    Currency: string;
+    Date: string;
+    DateTime: string;
+    Email: string;
+    Number: string;
+    Phone: string;
+    Picklist: string;
+    MultiselectPicklist: string;
+    TextArea: string;
+    Url: string;
+    Percent: string;
+    Html: string;
+};

package/dist/sf/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sf_metadata_field_type_info = exports.sf_custom_field_name_suffix = void 0;
+exports.sf_custom_field_name_suffix = '__c';
+exports.sf_metadata_field_type_info = {
+    Text: 'Text',
+    Checkbox: 'Checkbox',
+    Currency: 'Currency',
+    Date: 'Date',
+    DateTime: 'DateTime',
+    Email: 'Email',
+    Number: 'Number',
+    Phone: 'Phone',
+    Picklist: 'Picklist',
+    MultiselectPicklist: 'MultiselectPicklist',
+    TextArea: 'TextArea',
+    Url: 'Url',
+    Percent: 'Percent',
+    Html: 'Html'
+};
+//# sourceMappingURL=constants.js.map

package/dist/sf/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/sf/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GAAG,KAAK,CAAC;AAEpC,QAAA,2BAA2B,GAAG;IACvC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACf,CAAC"}

package/dist/sf/exports-index.d.ts

@@ -0,0 +1,4 @@
+export * from './actions';
+export * from './connections';
+export * from './constants';
+export * from './types';

package/dist/sf/exports-index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actions"), exports);
+__exportStar(require("./connections"), exports);
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=exports-index.js.map

package/dist/sf/exports-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports-index.js","sourceRoot":"","sources":["../../src/sf/exports-index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,gDAA8B;AAC9B,8CAA4B;AAC5B,0CAAwB"}

package/dist/sf/types.d.ts

@@ -0,0 +1,146 @@
+import { Connection, Field, Schema } from "@jsforce/jsforce-node";
+import { ValueSet } from "@jsforce/jsforce-node/lib/api/metadata";
+import { DescribeGlobalSObjectResult } from "@jsforce/jsforce-node/lib/api/soap/schema";
+import { sf_metadata_field_type_info } from "./constants";
+export declare const sf_unknown_user = "Unknown User";
+export declare const sf_throttle = 10;
+export declare const sf_instances: {
+    default: string;
+    sandbox: string;
+};
+export declare const sf_builtin_profiles: string[];
+export declare const sf_known_entities: {
+    Lead: {
+        Label: string;
+    };
+    Account: {
+        Label: string;
+    };
+};
+export declare const sf_known_entities_arr: ({
+    Label: string;
+    key: string;
+} | {
+    Label: string;
+    key: string;
+})[];
+export type sf_known_entities_type = keyof typeof sf_known_entities;
+export type sf_field_value_types = string | boolean | number | Date;
+export interface isf_cfg {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+}
+export interface isf_user_token {
+    instanceUrl: string;
+    accessToken: string;
+    userName: string;
+}
+export type sf_conn = Connection<Schema>;
+export interface iSFContext {
+    /** instance url */
+    instanceUrl: string;
+}
+export interface iSFEntityContext extends iSFContext {
+    /** entity name */
+    entity: string;
+}
+export declare function isSFContext(ctx: any): ctx is iSFContext;
+export declare function isSFEntityContext(ctx: any): ctx is iSFEntityContext;
+export interface iSFEntity extends DescribeGlobalSObjectResult {
+}
+export interface iSFOrgInfo {
+    instanceUrl: string;
+    orgId: string;
+    orgName: string;
+}
+export interface iPicklistValue {
+    active: boolean;
+    defaultValue: boolean;
+    label: string;
+    /** https://salesforce.stackexchange.com/questions/201775/picklists-validfor-attribute */
+    validFor: string;
+    value: string;
+}
+export declare const sf_field_ex_type_info: {
+    textarea: string;
+    string: string;
+    picklist: string;
+    multipicklist: string;
+    email: string;
+    phone: string;
+    url: string;
+    int: string;
+    double: string;
+    currency: string;
+    boolean: string;
+    date: string;
+    datetime: string;
+    percent: string;
+};
+export type sf_field_ex_types = keyof typeof sf_field_ex_type_info;
+export type sf_field_ex = (Omit<Field, "picklistValues" | "type"> & {
+    picklistValues?: iPicklistValue[];
+    type: sf_field_ex_types;
+    extraTypeInfo?: "personname" | "imageurl" | "plaintextarea" | "richtextarea";
+});
+export interface iSFDesignerProps {
+    ctx: iSFContext;
+    container: HTMLDivElement;
+    onRendered?: () => void;
+}
+export interface iSFBaseEntity<type = string> {
+    attributes: {
+        type: type;
+        url: string;
+    };
+}
+export type sf_metadata_field_types = keyof typeof sf_metadata_field_type_info;
+export interface sf_metadata_field_base {
+    /**`${entity}.${name}` */
+    fullName: string;
+    label: string;
+    required: boolean;
+    description?: string;
+    inlineHelpText?: string;
+}
+export interface sf_metadata_field_text extends sf_metadata_field_base {
+    type: "Text";
+    /** 128 */
+    length: number;
+}
+export interface sf_metadata_field_textarea extends sf_metadata_field_base {
+    type: "TextArea";
+}
+export interface sf_metadata_field_html extends sf_metadata_field_base {
+    type: "Html";
+    /** 512 */
+    length: number;
+    /** 10 */
+    visibleLines: number;
+}
+export interface sf_metadata_field_numeric extends sf_metadata_field_base {
+    type: "Number" | "Currency" | "Percent";
+    precision: number;
+    scale: number;
+}
+export interface sf_metadata_field_checkbox extends sf_metadata_field_base {
+    type: "Checkbox";
+    defaultValue: boolean;
+}
+export interface sf_metadata_field_list extends sf_metadata_field_base {
+    type: "Picklist";
+    valueSet: Omit<ValueSet, "valueSettings"> & Required<Pick<ValueSet, 'valueSetDefinition'>>;
+}
+export interface sf_metadata_field_multiList extends sf_metadata_field_base {
+    type: "MultiselectPicklist";
+    valueSet: Omit<ValueSet, "valueSettings"> & Required<Pick<ValueSet, 'valueSetDefinition'>>;
+    /** 10 */
+    visibleLines: number;
+}
+type basicFieldTypes = Exclude<sf_metadata_field_types, "Text" | "TextArea" | "Html" | "Number" | "Currency" | "Percent" | "Checkbox" | "Picklist" | "MultiselectPicklist">;
+export interface sf_metadata_field_basic extends sf_metadata_field_base {
+    type: basicFieldTypes;
+}
+export type sf_metadata_field_type = sf_metadata_field_text | sf_metadata_field_textarea | sf_metadata_field_html | sf_metadata_field_checkbox | sf_metadata_field_list | sf_metadata_field_multiList | sf_metadata_field_basic | sf_metadata_field_numeric;
+export {};