@kitalive/sfdx-plugin 1.0.0 → 1.0.1

package/lib/commands/kit/data/csv/convert.js

@@ -0,0 +1,154 @@
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import dayjs from 'dayjs';
+import * as csv from 'fast-csv';
+import fs from 'fs-extra';
+import * as utils from '../../../../utils.js';
+export function normalizeDateString(str, format) {
+    if (!str)
+        return str;
+    const d = dayjs(str);
+    return format ? d.format(format) : d.toISOString();
+}
+const converters = new Map([
+    ['date', (value) => normalizeDateString(value, 'YYYY-MM-DD')],
+    ['datetime', normalizeDateString],
+]);
+export async function convertCsv(cmd, options) {
+    const { input, mapping, converter, ...csvOptions } = options;
+    const mappingJson = mapping
+        ? (await fs.readJson(mapping))
+        : undefined;
+    const script = converter
+        ? await utils.loadScript(converter)
+        : {};
+    if (script.start)
+        await script.start(cmd);
+    let rows = await cmd.parseCsv(input ?? process.stdin, {
+        ...csvOptions,
+        mapping: mappingJson,
+        convert: script.convert,
+    });
+    if (script.finish) {
+        const result = await script.finish(rows, cmd);
+        if (result)
+            rows = result;
+    }
+    return rows;
+}
+// eslint-disable-next-line sf-plugin/command-example,sf-plugin/command-summary
+export class CsvCommand extends SfCommand {
+    org;
+    conn;
+    options;
+    async parseCsv(input, options) {
+        const convert = options?.convert;
+        return utils.parseCsv(typeof input === 'string' ? fs.createReadStream(input) : input, {
+            ...options,
+            convert: (row) => {
+                const result = convert ? convert(row) : row;
+                if (!result)
+                    return;
+                if (options?.fieldTypes) {
+                    for (const key of Object.keys(result)) {
+                        const converter = converters.get(options.fieldTypes[key]);
+                        if (converter)
+                            result[key] = converter(result[key]);
+                    }
+                }
+                if (options?.setnull) {
+                    for (const key of Object.keys(result)) {
+                        if (key.includes('.'))
+                            continue; // skip reference
+                        if (result[key] == null || result[key] === '')
+                            result[key] = '#N/A';
+                    }
+                }
+                return result;
+            },
+        });
+    }
+    async saveCsv(file, rows) {
+        return this.writeCsv(fs.createWriteStream(file), rows, true);
+    }
+    async writeCsv(output, rows, writeBOM = false) {
+        return new Promise((resolve, reject) => {
+            csv
+                .writeToStream(output, rows, { headers: true, writeBOM })
+                .on('error', reject)
+                .on('finish', resolve);
+        });
+    }
+}
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'data.csv.convert');
+export default class CsvConvert extends CsvCommand {
+    static summary = messages.getMessage('summary');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        input: Flags.string({
+            char: 'i',
+            summary: messages.getMessage('flags.input.summary'),
+        }),
+        output: Flags.string({
+            char: 'f',
+            summary: messages.getMessage('flags.output.summary'),
+        }),
+        encoding: Flags.string({
+            char: 'e',
+            default: 'utf8',
+            summary: messages.getMessage('flags.encoding.summary'),
+        }),
+        delimiter: Flags.string({
+            char: 'd',
+            default: ',',
+            summary: messages.getMessage('flags.delimiter.summary'),
+        }),
+        quote: Flags.string({
+            char: 'q',
+            default: '"',
+            summary: messages.getMessage('flags.quote.summary'),
+        }),
+        'skip-lines': Flags.integer({
+            default: 0,
+            summary: messages.getMessage('flags.skip-lines.summary'),
+            aliases: ['skiplines'],
+            deprecateAliases: true,
+        }),
+        trim: Flags.boolean({ summary: messages.getMessage('flags.trim.summary') }),
+        mapping: Flags.string({
+            char: 'm',
+            summary: messages.getMessage('flags.mapping.summary'),
+        }),
+        converter: Flags.string({
+            char: 'c',
+            summary: messages.getMessage('flags.converter.summary'),
+        }),
+        'target-org': Flags.optionalOrg(),
+        'api-version': Flags.orgApiVersion(),
+    };
+    async run() {
+        const { flags } = await this.parse(CsvConvert);
+        this.org = flags['target-org'];
+        this.conn = this.org?.getConnection(flags['api-version']);
+        this.options = {
+            input: flags.input,
+            encoding: flags.encoding,
+            delimiter: flags.delimiter,
+            quote: flags.quote,
+            skiplines: flags['skip-lines'],
+            trim: flags.trim,
+            mapping: flags.mapping,
+            converter: flags.converter,
+        };
+        const rows = await convertCsv(this, this.options);
+        if (flags.output) {
+            await this.saveCsv(flags.output, rows);
+        }
+        else if (!this.jsonEnabled()) {
+            await this.writeCsv(process.stdout, rows);
+        }
+        return rows;
+    }
+}
+//# sourceMappingURL=convert.js.map

package/lib/commands/kit/data/csv/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../../../src/commands/kit/data/csv/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAC;AA2B9C,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,MAAe;IAC9D,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAClC,CAAC,CAAC;AAqBH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAsB,EACtB,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAa;QAC3C,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC;QACnC,CAAC,CAAE,EAAsB,CAAC;IAE5B,IAAI,MAAM,CAAC,KAAK;QAAE,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE;QACpD,GAAG,UAAU;QACb,OAAO,EAAE,WAAW;QACpB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,MAAM;YAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,OAAgB,UACpB,SAAQ,SAAY;IAGb,GAAG,CAAO;IACV,IAAI,CAAc;IAClB,OAAO,CAAqB;IAE5B,KAAK,CAAC,QAAQ,CACnB,KAAqC,EACrC,OAAyB;QAEzB,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QACjC,OAAO,KAAK,CAAC,QAAQ,CACnB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAC9D;YACE,GAAG,OAAO;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC5C,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;oBACxB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;wBACtC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;wBAC1D,IAAI,SAAS;4BAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAW,CAAC,CAAC;oBAChE,CAAC;gBACH,CAAC;gBACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;oBACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;wBACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;4BAAE,SAAS,CAAC,iBAAiB;wBAClD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE;4BAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;oBACzB,CAAC;gBACH,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CACF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAe;QAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,MAA6B,EAC7B,IAAe,EACf,WAAoB,KAAK;QAEzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,GAAG;iBACA,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;iBACxD,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;iBACnB,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CACpC,uBAAuB,EACvB,kBAAkB,CACnB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAEzD,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;SACpD,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC;SACrD,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;SACvD,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC;SACxD,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,qBAAqB,CAAC;SACpD,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC;YAC1B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,0BAA0B,CAAC;YACxD,OAAO,EAAE,CAAC,WAAW,CAAC;YACtB,gBAAgB,EAAE,IAAI;SACvB,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;SACtD,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC;SACxD,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;QACjC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;KACrC,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,aAAa,CAAW,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC"}

package/lib/commands/kit/graphql/editor.js

@@ -0,0 +1,37 @@
+import { Messages } from '@salesforce/core';
+import { ServerCommand } from '../../../server.js';
+import { getScriptDir } from '../../../utils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'graphql.editor');
+// avoid GraphQL introspection parsing errors
+function fixInstospectionSchema(graphqlResponse) {
+    const res = graphqlResponse;
+    // eslint-disable-next-line no-underscore-dangle
+    const deprecated = res.data?.__schema?.directives?.find(({ name }) => name === 'deprecated');
+    if (deprecated) {
+        deprecated.args = [];
+    }
+    return res;
+}
+export default class GraphqlEditor extends ServerCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = ServerCommand.flags;
+    async run() {
+        const { flags } = await this.parse(GraphqlEditor);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        const endpoint = `/services/data/v${conn.version}/graphql`;
+        this.serve(flags, (app) => {
+            app.get('/', (req, res) => {
+                res.sendFile('index.html', {
+                    root: getScriptDir(import.meta.url) + '/../../../../public/graphql',
+                });
+            });
+            app.post('/api/graphql', async (req, res) => {
+                res.json(fixInstospectionSchema(await conn.requestPost(endpoint, req.body)));
+            });
+        });
+    }
+}
+//# sourceMappingURL=editor.js.map

package/lib/commands/kit/graphql/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../../../../src/commands/kit/graphql/editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CACpC,uBAAuB,EACvB,gBAAgB,CACjB,CAAC;AAEF,6CAA6C;AAC7C,SAAS,sBAAsB,CAAC,eAAuB;IACrD,MAAM,GAAG,GAAG,eASX,CAAC;IACF,gDAAgD;IAChD,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CACrD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,YAAY,CACpC,CAAC;IACF,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,GAAG,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,aAAa;IAC/C,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IAE5C,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAErE,MAAM,QAAQ,GAAG,mBAAmB,IAAI,CAAC,OAAO,UAAU,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACxB,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE;oBACzB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,6BAA6B;iBACpE,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC1C,GAAG,CAAC,IAAI,CACN,sBAAsB,CACpB,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAc,CAAC,CACrD,CACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC"}

package/lib/commands/kit/layout/assignments/deploy.js

@@ -0,0 +1,35 @@
+import path from 'node:path';
+import { Messages } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import fs from 'fs-extra';
+import { updateMetadata } from '../../../../metadata.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'layout.assignments.deploy');
+export default class LayoutAssignmentsDeploy extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static examples = messages.getMessages('examples');
+    static requiresProject = true;
+    static flags = {
+        file: Flags.string({
+            char: 'f',
+            required: true,
+            summary: messages.getMessage('flags.file.summary'),
+            default: 'config/layout-assignments.json',
+        }),
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+    };
+    async run() {
+        const { flags } = await this.parse(LayoutAssignmentsDeploy);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        this.spinner.start(messages.getMessage('spinner.start', [flags.file]));
+        const layoutAssignmentsPerProfile = await this.readFile(flags.file);
+        const profiles = Object.entries(layoutAssignmentsPerProfile).map(([fullName, layoutAssignments]) => ({ fullName, layoutAssignments }));
+        return updateMetadata(conn, 'Profile', profiles);
+    }
+    readFile(file) {
+        const inputFile = path.join(this.project.getPath(), file);
+        return fs.readJson(inputFile);
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/lib/commands/kit/layout/assignments/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../../../src/commands/kit/layout/assignments/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,MAAM,UAAU,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CACpC,uBAAuB,EACvB,2BAA2B,CAC5B,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,SAAuB;IACnE,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAEzD,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,eAAe,GAAG,IAAI,CAAC;IAEvC,MAAM,CAAU,KAAK,GAAG;QAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,OAAO,EAAE,gCAAgC;SAC1C,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;QACjC,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE;KACrC,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QAErE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,2BAA2B,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,GAAG,CAC9D,CAAC,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CACrE,CAAC;QACF,OAAO,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3D,OAAO,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAyC,CAAC;IACxE,CAAC"}

package/lib/commands/kit/layout/assignments/retrieve.js

@@ -0,0 +1,124 @@
+import path from 'node:path';
+import { Messages, SfError } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import glob from 'fast-glob';
+import fs from 'fs-extra';
+import { completeDefaultNamespace, readMetadata, } from '../../../../metadata.js';
+function assignmentsPerObject(assignments, filterObjects) {
+    const result = new Map();
+    for (const assignment of assignments) {
+        const object = assignment.layout.split('-')[0];
+        if (filterObjects && !filterObjects.includes(object))
+            continue;
+        const a = result.get(object) ?? [];
+        a.push(assignment);
+        result.set(object, a);
+    }
+    return result;
+}
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'layout.assignments.retrieve');
+export default class LayoutAssignmentsRetrieve extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static examples = messages.getMessages('examples');
+    static requiresProject = true;
+    static flags = {
+        file: Flags.string({
+            char: 'f',
+            required: true,
+            summary: messages.getMessage('flags.file.summary'),
+            default: 'config/layout-assignments.json',
+        }),
+        profile: Flags.string({
+            char: 'p',
+            required: false,
+            multiple: true,
+            summary: messages.getMessage('flags.profile.summary'),
+        }),
+        sobject: Flags.string({
+            char: 's',
+            required: false,
+            multiple: true,
+            summary: messages.getMessage('flags.sobject.summary'),
+        }),
+        merge: Flags.boolean({
+            required: false,
+            summary: messages.getMessage('flags.merge.summary'),
+        }),
+        'target-org': Flags.requiredOrg(),
+        'api-version': Flags.orgApiVersion(),
+    };
+    async run() {
+        const { flags } = await this.parse(LayoutAssignmentsRetrieve);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        const filterObjects = flags.sobject
+            ? flags.sobject
+            : await this.objectNamesFromLayouts();
+        if (filterObjects.length === 0)
+            throw new SfError(messages.getMessage('error.noSObjects'));
+        const data = flags.merge
+            ? await this.readFile(flags.file)
+            : {};
+        const profileNames = flags.profile
+            ? flags.profile
+            : await this.getProfileNames(conn);
+        this.spinner.start(messages.getMessage('spinner.start'));
+        const profiles = (await readMetadata(conn, 'Profile', profileNames));
+        const filterObjectFullNames = await completeDefaultNamespace(conn, filterObjects);
+        for (const profile of profiles) {
+            if (!profile.fullName || !profile.layoutAssignments)
+                continue;
+            let assignmentsMap = assignmentsPerObject(profile.layoutAssignments, filterObjectFullNames);
+            if (data[profile.fullName]) {
+                const oldAssignmentsMap = assignmentsPerObject(data[profile.fullName]);
+                assignmentsMap = new Map([...oldAssignmentsMap, ...assignmentsMap]);
+            }
+            data[profile.fullName] = Array.from(assignmentsMap.values())
+                .flat()
+                .sort((a, b) => a.layout.localeCompare(b.layout));
+        }
+        this.spinner.stop();
+        this.log(messages.getMessage('result', [
+            flags.file,
+            profileNames.join(', '),
+            filterObjects.join(', '),
+        ]));
+        await this.writeFile(flags.file, data);
+        return data;
+    }
+    async objectNamesFromLayouts() {
+        const config = await this.getProjectConfig();
+        const packageDir = config.packageDirectories.find((dir) => dir.default);
+        if (!packageDir)
+            return [];
+        const pattern = path.join(this.project.getPath(), packageDir.path, '**/*.layout-meta.xml');
+        const objectCounts = new Map();
+        for (const filepath of await this.findFiles(pattern)) {
+            const object = path.basename(filepath).split('-')[0];
+            objectCounts.set(object, (objectCounts.get(object) ?? 0) + 1);
+        }
+        return [...objectCounts.keys()]
+            .filter((object) => objectCounts.get(object) >= 2)
+            .sort();
+    }
+    getProjectConfig() {
+        return this.project.resolveProjectConfig();
+    }
+    getProfileNames(conn) {
+        return conn.metadata
+            .list({ type: 'Profile' })
+            .then((profiles) => profiles.map((p) => p.fullName));
+    }
+    findFiles(pattern) {
+        return glob(pattern);
+    }
+    readFile(file) {
+        return fs.readJson(path.join(this.project.getPath(), file));
+    }
+    writeFile(file, data) {
+        return fs.outputJson(path.join(this.project.getPath(), file), data, {
+            spaces: '\t',
+        });
+    }
+}
+//# sourceMappingURL=retrieve.js.map

package/lib/commands/kit/layout/assignments/retrieve.js.map

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

package/lib/commands/kit/metadata/dependencies.js

@@ -0,0 +1,182 @@
+import { Messages } from '@salesforce/core';
+import * as csv from 'fast-csv';
+import express from 'express';
+import { ServerCommand } from '../../../server.js';
+import { getScriptDir } from '../../../utils.js';
+const scriptDir = getScriptDir(import.meta.url);
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@kitalive/sfdx-plugin', 'metadata.dependencies');
+function packageXml(data, version) {
+    data.sort((a, b) => a.type.localeCompare(b.type) || a.fullName.localeCompare(b.fullName));
+    const metadataByType = {};
+    for (const meta of data) {
+        (metadataByType[meta.type] ??= []).push(meta);
+    }
+    return ('<?xml version="1.0" encoding="UTF-8"?>\n' +
+        '<Package xmlns="http://soap.sforce.com/2006/04/metadata">\n' +
+        Object.entries(metadataByType)
+            .map(([name, members]) => '  <types>\n' +
+            members
+                .map((meta) => `    <members>${meta.fullName}</members>`)
+                .join('\n') +
+            `\n    <name>${name}</name>\n` +
+            '  </types>')
+            .join('\n') +
+        `\n  <version>${version}</version>\n</Package>`);
+}
+class MetadataQuery {
+    conn;
+    describeCache;
+    typeCache = {};
+    metadataCache = {};
+    usageCache = {};
+    referencesCache = {};
+    recursiveUsageCache = {};
+    recursiveReferencesCache = {};
+    constructor(connection) {
+        this.conn = connection;
+    }
+    async describe() {
+        if (!this.describeCache) {
+            const { metadataObjects } = await this.conn.metadata.describe();
+            this.describeCache = metadataObjects
+                .flatMap((m) => [m.xmlName].concat(m.childXmlNames))
+                .sort();
+            this.describeCache.forEach((name) => (this.typeCache[name] = name));
+        }
+        return this.describeCache;
+    }
+    async list(type) {
+        const idMap = await this.getMetadataMap(type);
+        return Array.from(idMap.values());
+    }
+    async usage(type, id, recursive) {
+        const cache = recursive ? this.recursiveUsageCache : this.usageCache;
+        const result = [
+            ...(await this.dependencies(id, cache, 'RefMetadataComponentId', recursive)),
+        ];
+        if (recursive) {
+            const idMap = await this.getMetadataMap(type);
+            result.unshift(idMap.get(id));
+        }
+        return result;
+    }
+    async references(type, id, recursive) {
+        const cache = recursive
+            ? this.recursiveReferencesCache
+            : this.referencesCache;
+        const result = [
+            ...(await this.dependencies(id, cache, 'MetadataComponentId', recursive)),
+        ];
+        if (recursive) {
+            const idMap = await this.getMetadataMap(type);
+            result.unshift(idMap.get(id));
+        }
+        return result;
+    }
+    async getMetadataMap(type) {
+        if (this.metadataCache[type])
+            return this.metadataCache[type];
+        const idMap = new Map();
+        const list = await this.conn.metadata.list({ type });
+        for (const meta of list.sort((a, b) => (a.fullName ?? '').localeCompare(b.fullName ?? ''))) {
+            idMap.set(meta.id, meta);
+        }
+        this.metadataCache[type] = idMap;
+        return idMap;
+    }
+    async dependencies(ids, cache, sourceIdField, recursive, result) {
+        result ??= new Set();
+        ids = [].concat(ids);
+        const dependentIds = [];
+        const fetchIds = [];
+        const add = (item) => {
+            if (result.has(item))
+                return;
+            result.add(item);
+            dependentIds.push(item.id);
+        };
+        for (const id of ids) {
+            if (cache[id]) {
+                cache[id].forEach(add);
+            }
+            else {
+                fetchIds.push(id);
+                cache[id] = new Set();
+            }
+        }
+        if (fetchIds.length) {
+            const targetFieldPrefix = sourceIdField === 'MetadataComponentId' ? 'Ref' : '';
+            const items = await this.conn.tooling
+                .sobject('MetadataComponentDependency')
+                .select('MetadataComponentId, MetadataComponentType, RefMetadataComponentId, RefMetadataComponentType')
+                .where({ [sourceIdField]: fetchIds });
+            for (const item of items) {
+                const cacheSet = (cache[item[sourceIdField]] ??= new Set());
+                const type = item[targetFieldPrefix + 'MetadataComponentType'];
+                if (!this.typeCache[type])
+                    continue;
+                // eslint-disable-next-line no-await-in-loop
+                const idMap = await this.getMetadataMap(type);
+                const meta = idMap.get(item[targetFieldPrefix + 'MetadataComponentId']);
+                if (!meta)
+                    continue;
+                cacheSet.add(meta);
+                add(meta);
+            }
+        }
+        if (recursive && dependentIds.length) {
+            return this.dependencies(dependentIds, cache, sourceIdField, recursive, result);
+        }
+        return result;
+    }
+}
+export default class MetadataDependencies extends ServerCommand {
+    static summary = messages.getMessage('summary');
+    static examples = messages.getMessages('examples');
+    static flags = ServerCommand.flags;
+    async run() {
+        const { flags } = await this.parse(MetadataDependencies);
+        const conn = flags['target-org'].getConnection(flags['api-version']);
+        const metadata = new MetadataQuery(conn);
+        await metadata.describe();
+        function handleDependencies(data, format, res) {
+            switch (format) {
+                case 'xml':
+                    res.set('Content-Type', 'text/xml');
+                    res.send(packageXml(data, conn.version));
+                    break;
+                case 'csv':
+                    res.set('Content-Type', 'text/csv');
+                    csv.writeToStream(res, data, { headers: ['fullName', 'type'] });
+                    break;
+                default:
+                    res.json(data);
+                    break;
+            }
+        }
+        this.serve(flags, (app) => {
+            app.use('/assets', express.static(scriptDir + '/../../../../public/dist/assets'));
+            app.get('/', (req, res) => {
+                res.sendFile('metadata-dependencies.html', {
+                    root: scriptDir + '/../../../../public/dist',
+                });
+            });
+            app.get('/api/metadata', async (req, res) => {
+                res.json(await metadata.describe());
+            });
+            app.get('/api/metadata/:type', async (req, res) => {
+                res.json(await metadata.list(req.params.type));
+            });
+            app.get('/api/metadata/usage/:type/:id', async (req, res) => {
+                const data = await metadata.usage(req.params.type, req.params.id, req.query.recursive === 'true');
+                handleDependencies(data, req.query.format, res);
+            });
+            app.get('/api/metadata/references/:type/:id', async (req, res) => {
+                const data = await metadata.references(req.params.type, req.params.id, req.query.recursive === 'true');
+                handleDependencies(data, req.query.format, res);
+            });
+        });
+    }
+}
+//# sourceMappingURL=dependencies.js.map

package/lib/commands/kit/metadata/dependencies.js.map

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