@kitalive/sfdx-plugin 1.0.2 → 1.0.4

package/lib/metadata.js

@@ -0,0 +1,82 @@
+import { chunk } from './utils.js';
+let orgNamespace;
+export async function getOrgNamespace(conn) {
+    if (orgNamespace === undefined) {
+        const { records: [{ NamespacePrefix }], } = await conn.query('SELECT NamespacePrefix FROM Organization');
+        orgNamespace = NamespacePrefix;
+    }
+    return orgNamespace;
+}
+export async function completeDefaultNamespace(conn, objectName) {
+    const ns = await getOrgNamespace(conn);
+    if (!ns)
+        return objectName;
+    const isArray = Array.isArray(objectName);
+    const objectNames = isArray ? objectName : [objectName];
+    const results = objectNames.map((name) => {
+        if (name.endsWith('__c') && name.split('__').length === 2) {
+            return `${ns}__${name}`;
+        }
+        else {
+            return name;
+        }
+    });
+    return isArray ? results : results[0];
+}
+export function chunkMetadata(type, metadata) {
+    // metadata limit: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_createMetadata.htm
+    const size = type === 'CustomMetadata' || type === 'CustomApplication' ? 200 : 10;
+    return chunk(Array.isArray(metadata) ? metadata : [metadata], size);
+}
+export function readMetadata(conn, type, fullNames) {
+    return Promise.all(chunkMetadata(type, fullNames).map((data) => conn.metadata.read(type, data))).then((a) => a.flat());
+}
+export function updateMetadata(conn, type, metadata) {
+    return Promise.all(chunkMetadata(type, metadata).map((data) => conn.metadata.update(type, data))).then((a) => a.flat());
+}
+export function upsertMetadata(conn, type, metadata) {
+    return Promise.all(chunkMetadata(type, metadata).map((data) => conn.metadata.upsert(type, data))).then((a) => a.flat());
+}
+export function deleteMetadata(conn, type, fullNames) {
+    return Promise.all(chunkMetadata(type, fullNames).map((data) => conn.metadata.delete(type, data))).then((a) => a.flat());
+}
+export async function getCustomFields(conn, object) {
+    object = await completeDefaultNamespace(conn, object);
+    const [org] = await conn
+        .sobject('Organization')
+        .select(['IsSandbox', 'TrialExpirationDate']);
+    const condition = {
+        'EntityDefinition.QualifiedApiName': object,
+        ManageableState: 'unmanaged',
+        $not: { DeveloperName: { $like: '_tc%' } },
+    };
+    let fields = [];
+    if (org['IsSandbox'] && org['TrialExpirationDate']) {
+        // scratch org
+        fields = (await conn.tooling
+            .sobject('CustomField')
+            .find(condition, 'DeveloperName, Metadata'));
+    }
+    else {
+        // Avoid error when including metadata field
+        const ids = (await conn.tooling.sobject('CustomField').find(condition, 'Id')).map((r) => r.Id);
+        for (const Id of ids) {
+            fields = fields.concat(
+            // eslint-disable-next-line no-await-in-loop
+            (await conn.tooling
+                .sobject('CustomField')
+                .find({ ...condition, Id }, 'DeveloperName, Metadata')));
+        }
+    }
+    return fields
+        .filter((r) => !r.DeveloperName.endsWith('_del'))
+        .map((r) => ({
+        fullName: r.DeveloperName + '__c',
+        ...r.Metadata,
+    }));
+}
+export async function getCustomFieldMap(conn, object) {
+    const fields = await getCustomFields(conn, object);
+    return new Map(fields.map((f) => [f.fullName, f]));
+}
+//# sourceMappingURL=metadata.js.map

package/lib/metadata.js.map

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

package/lib/server.js

@@ -0,0 +1,43 @@
+import express from 'express';
+import open, { apps } from 'open';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'server');
+export class ServerCommand extends SfCommand {
+    static flags = {
+        browser: Flags.option({
+            summary: messages.getMessage('flags.browser.summary'),
+            char: 'b',
+            options: ['chrome', 'firefox', 'edge'],
+        })(),
+        port: Flags.integer({
+            summary: messages.getMessage('flags.port.summary'),
+            char: 'p',
+            default: 3000,
+        }),
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+    };
+    serve(options, callback) {
+        const app = express();
+        app.use(express.json());
+        callback(app);
+        app.post('/quit', () => process.exit(0));
+        app.listen(options.port, 'localhost', async () => {
+            const name = apps[options.browser];
+            this.log(`Listening on port ${options.port}`);
+            this.log('Use Ctrl-C to stop');
+            await open(`http://localhost:${options.port}`, { app: { name } });
+        });
+    }
+    exit(code = 0) {
+        if (code === 130) {
+            process.exit(0);
+        }
+        else {
+            super.exit(code);
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AAE1E,MAAM,OAAgB,aAAc,SAAQ,SAAe;IAClD,MAAM,CAAU,KAAK,GAAG;QAC7B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;YACrD,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;SACvC,CAAC,EAAE;QACJ,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,IAAI;SACd,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;QACjC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;KACrC,CAAC;IAEK,KAAK,CACV,OAGC,EACD,QAA2C;QAE3C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,QAAQ,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAA4B,CAAC,CAAC;YACxD,IAAI,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAC/B,MAAM,IAAI,CAAC,oBAAoB,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,IAAI,CAAC,IAAI,GAAG,CAAC;QAClB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/utils.js

@@ -0,0 +1,94 @@
+import path from 'node:path';
+import { pipeline } from 'node:stream';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import * as csv from 'fast-csv';
+import iconv from 'iconv-lite';
+export function getScriptDir(url) {
+    return path.dirname(fileURLToPath(url));
+}
+export function chunk(array, size) {
+    const result = [];
+    for (let i = 0, l = array.length; i < l; i += size) {
+        result.push(array.slice(i, i + size));
+    }
+    return result;
+}
+export function* rangeGenerator(from, to) {
+    for (let i = from; i <= to; i++) {
+        yield i;
+    }
+}
+export function range(from, to) {
+    return Array.from(rangeGenerator(from, to));
+}
+export function parseCsv(input, options) {
+    const { encoding, delimiter, quote, skiplines, trim, mapping, convert } = options ?? {};
+    if (!input)
+        throw new Error('csv input is required');
+    return new Promise((resolve, reject) => {
+        try {
+            const mapper = mapping ? columnMapper(mapping) : undefined;
+            let lines = 2;
+            const rows = [];
+            const parser = csv
+                .parse({
+                headers: true,
+                ignoreEmpty: true,
+                delimiter: delimiter === '\\t' ? '\t' : delimiter ?? ',',
+                quote: quote ?? '"',
+                skipLines: skiplines,
+                trim,
+            })
+                .on('data', (row) => {
+                try {
+                    if (mapper)
+                        row = mapper(row);
+                    const r = convert ? convert(row) : row;
+                    if (r)
+                        rows.push(r);
+                    lines++;
+                }
+                catch (e) {
+                    throw new Error(`A error occurred in csv file at line ${lines}: ${e.message}\ndata: ${JSON.stringify(row)}`);
+                }
+            });
+            const callback = (e) => (e ? reject(e) : resolve(rows));
+            if (!encoding || encoding === 'utf8') {
+                pipeline(input, parser, callback);
+            }
+            else {
+                pipeline(input, iconv.decodeStream(encoding), parser, callback);
+            }
+        }
+        catch (e) {
+            reject(e);
+        }
+    });
+}
+export async function loadScript(file) {
+    let script;
+    try {
+        script = (await import(pathToFileURL(file).href));
+    }
+    catch (e) {
+        throw new Error(e.stack);
+    }
+    if (!script.convert)
+        throw new Error('function convert is not exported');
+    return script;
+}
+export function columnMapper(mapping) {
+    const keys = Object.keys(mapping);
+    return (row) => {
+        const result = {};
+        for (const to of keys) {
+            const from = mapping[to];
+            if (!(from in row))
+                throw new Error(`The column '${from}' is not found`);
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            result[to] = row[from];
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

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

package/messages/data.bulk.delete.md

@@ -8,10 +8,18 @@ Bulk delete records by SOQL select query.
 
   <%= config.bin %> <%= command.id %> -q "SELECT Id FROM Opportunity WHERE CloseDate < LAST_N_YEARS:2"
 
+- Delete Opportunity records by SOQL file:
+
+  <%= config.bin %> <%= command.id %> --query-file ./path/to/Opportunity.soql
+
 # flags.query.summary
 
 SOQL query to delete
 
+# flags.query-file.summary
+
+SOQL query file to delete
+
 # flags.hard.summary
 
 Perform a hard delete

package/messages/data.bulk.query.md

@@ -8,18 +8,50 @@ Bulk query records.
 
   <%= config.bin %> <%= command.id %> -q "SELECT Id, Name FROM Account" -f ./path/to/Account.csv
 
+- Query Account records from SOQL file:
+
+  <%= config.bin %> <%= command.id %> --query-file ./path/to/Account.soql -f ./path/to/Account.csv
+
+- Query Account records with object field labels:
+
+  <%= config.bin %> <%= command.id %> -q "SELECT Id, Name FROM Account" --object-field-label
+
+- Query Account records with custom field label mapping:
+
+  <%= config.bin %> <%= command.id %> -q "SELECT Id, Name FROM Account" --field-label-mapping ./path/to/field-label-mapping.json
+
 # flags.query.summary
 
 SOQL query to export
 
+# flags.query-file.summary
+
+SOQL query file to export
+
 # flags.csv-file.summary
 
 [default: standard output] Output csv file
 
+# flags.object-field-label.summary
+
+Output field names with object field labels
+
+# flags.field-label-mapping.summary
+
+JSON file that maps field API names to output field names
+
 # flags.all.summary
 
 include deleted or archived records
 
+# errors.invalidFieldLabelMapping
+
+Invalid field label mapping file: %s
+
+# errors.duplicatedFieldLabel
+
+Duplicated output field names: %s
+
 # flags.wait.summary
 
 The number of minutes to wait for the command to complete before displaying the results

package/oclif.lock

@@ -1915,23 +1915,13 @@
   resolved "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-2.3.0.tgz"
   integrity sha512-LtoMMhxAlorcGhmFYI+LhPgbPZCkgP6ra1YL604EeF6U98pLlQ3iWIGMdWSC+vWmPBWBNgmDBAhnAobLROJmwg==
 
-"@sinonjs/commons@^1.6.0":
+"@sinonjs/commons@^1.6.0", "@sinonjs/commons@^1.7.0", "@sinonjs/commons@^1.8.1":
   version "1.8.6"
   resolved "https://registry.npmjs.org/@sinonjs/commons/-/commons-1.8.6.tgz"
   integrity sha512-Ky+XkAkqPZSm3NLBeUng77EBQl3cmeJhITaGHdYH8kjVB+aun3S4XBRti2zt17mtt0mIUDiNxYeoJm6drVvBJQ==
   dependencies:
     type-detect "4.0.8"
 
-"@sinonjs/commons@^1.7.0":
-  version "2.0.0"
-  dependencies:
-    type-detect "4.0.8"
-
-"@sinonjs/commons@^1.8.1":
-  version "3.0.0"
-  dependencies:
-    type-detect "4.0.8"
-
 "@sinonjs/commons@^2.0.0":
   version "2.0.0"
   resolved "https://registry.npmjs.org/@sinonjs/commons/-/commons-2.0.0.tgz"