@salesforce/plugin-custom-metadata 1.0.8 → 1.0.12

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### [1.0.12](https://github.com/salesforcecli/plugin-custom-metadata/compare/v1.0.11...v1.0.12) (2021-04-06)
+
+
+### Bug Fixes
+
+* leif .yml merge [skip-validate-pr] ([9177fdc](https://github.com/salesforcecli/plugin-custom-metadata/commit/9177fdc23b42f6cd1c96ee1d34cf74093994c407))
+
+### [1.0.11](https://github.com/salesforcecli/plugin-custom-metadata/compare/v1.0.10...v1.0.11) (2020-12-10)
+
+### [1.0.10](https://github.com/salesforcecli/plugin-custom-metadata/compare/v1.0.8...v1.0.10) (2020-08-27)
+
+
+### Features
+
+* use npm-release-management-orb ([7154761](https://github.com/salesforcecli/plugin-custom-metadata/commit/7154761d3f0cfedc223f3a38cb7c8970f616bf22))
+
 # 1.0.0 (2020-06-02)
 
 

package/README.md

@@ -7,13 +7,66 @@ Tools for working with custom metadata types and their records.
 [![CircleCI](https://circleci.com/gh/salesforcecli/plugin-custom-metadata/tree/master.svg?style=shield)](https://circleci.com/gh/salesforcecli/plugin-custom-metadata/tree/master)
 [![License](https://img.shields.io/npm/l/@salesforce/plugin-custom-metadata.svg)](https://github.com/salesforcecli/plugin-custom-metadata/blob/master/LICENSE.txt)
 
-# Installation
-This is a [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli) plugin and bundled with the CLI via [salesforcedx](https://www.npmjs.com/package/salesforcedx) as of `48.18.0`.
+This plugin is bundled with the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli). For more information on the CLI, read the [getting started guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm).
 
-To install it manually or install a specific plugin version, run the following.
-<!-- install -->
-```sh-session
-$ sfdx plugins:install custom-metadata@1.0.0
+We always recommend using the latest version of these commands bundled with the CLI, however, you can install a specific version or tag if needed.
+
+## Install
+
+```bash
+sfdx plugins:install custom-metadata@x.y.z
+```
+
+## Issues
+
+Please report any issues at https://github.com/forcedotcom/cli/issues
+
+## Contributing
+
+1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)
+2. Create a new issue before starting your project so that we can keep track of
+   what you are trying to add/fix. That way, we can also offer suggestions or
+   let you know if there is already an effort in progress.
+3. Fork this repository.
+4. [Build the plugin locally](#build)
+5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.
+6. Edit the code in your fork.
+7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.
+8. Sign CLA (see [CLA](#cla) below).
+9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.
+
+### CLA
+
+External contributors will be required to sign a Contributor's License
+Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
+
+### Build
+
+To build the plugin locally, make sure to have yarn installed and run the following commands:
+
+```bash
+# Clone the repository
+git clone git@github.com:salesforcecli/plugin-custom-metadata
+
+# Install the dependencies and compile
+yarn install
+yarn build
+```
+
+To use your plugin, run using the local `./bin/run` or `./bin/run.cmd` file.
+
+```bash
+# Run using local run file.
+./bin/run force:cmdt
+```
+
+There should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.
+
+```bash
+# Link your plugin to the sfdx cli
+sfdx plugins:link .
+# To verify
+sfdx plugins
 ```
 
 # Commands
@@ -61,7 +114,7 @@ EXAMPLES
   Protected
 ```
 
-_See code: [src/commands/force/cmdt/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.8/src/commands/force/cmdt/create.ts)_
+_See code: [src/commands/force/cmdt/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.12/src/commands/force/cmdt/create.ts)_
 
 ## `sfdx force:cmdt:field:create -n <string> -f Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>] [-l <string>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -108,7 +161,7 @@ EXAMPLES
        $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Number --decimalplaces 2
 ```
 
-_See code: [src/commands/force/cmdt/field/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.8/src/commands/force/cmdt/field/create.ts)_
+_See code: [src/commands/force/cmdt/field/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.12/src/commands/force/cmdt/field/create.ts)_
 
 ## `sfdx force:cmdt:generate -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -181,7 +234,7 @@ EXAMPLES
   'path/to/my/cmdt/record/directory'
 ```
 
-_See code: [src/commands/force/cmdt/generate.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.8/src/commands/force/cmdt/generate.ts)_
+_See code: [src/commands/force/cmdt/generate.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.12/src/commands/force/cmdt/generate.ts)_
 
 ## `sfdx force:cmdt:record:create [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -228,7 +281,7 @@ EXAMPLES
   My_Custom_Field_1=Foo My_Custom_Field_2=Bar
 ```
 
-_See code: [src/commands/force/cmdt/record/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.8/src/commands/force/cmdt/record/create.ts)_
+_See code: [src/commands/force/cmdt/record/create.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.12/src/commands/force/cmdt/record/create.ts)_
 
 ## `sfdx force:cmdt:record:insert -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
 
@@ -273,7 +326,7 @@ EXAMPLES
   "path/to/my/cmdt/directory" --namecolumn "PrimaryKey"
 ```
 
-_See code: [src/commands/force/cmdt/record/insert.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.8/src/commands/force/cmdt/record/insert.ts)_
+_See code: [src/commands/force/cmdt/record/insert.ts](https://github.com/salesforcecli/plugin-custom-metadata/blob/v1.0.12/src/commands/force/cmdt/record/insert.ts)_
 <!-- commandsstop -->
 
 <!-- debugging-your-plugin -->

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"1.0.8","commands":{"force:cmdt:create":{"id":"force:cmdt:create","description":"creates a new custom metadata type in the current project","usage":"<%= command.id %> -n <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a custom metadata type with developer name 'MyCustomType'; this name will also be used as the label:","    $ sfdx force:cmdt:create --typename MyCustomType","Create a protected custom metadata type with a specific label:","    $ sfdx force:cmdt:create --typename MyCustomType --label \"Custom Type\" --plurallabel \"Custom Types\" --visibility Protected"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"typename":{"name":"typename","type":"option","char":"n","description":"unique object name for the custom metadata type","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the custom metadata type"},"plurallabel":{"name":"plurallabel","type":"option","char":"p","description":"plural version of the label value; if blank, uses label"},"visibility":{"name":"visibility","type":"option","char":"v","description":"visibility of the custom metadata type","helpValue":"(PackageProtected|Protected|Public)","options":["PackageProtected","Protected","Public"],"default":"Public"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store the newly-created custom metadata type files"}},"args":[{"name":"file"}]},"force:cmdt:generate":{"id":"force:cmdt:generate","description":"generates a custom metadata type and all its records for the provided sObject","usage":"<%= command.id %> -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Generate a custom metadata type from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c","Generate a custom metadata type from an sObject in the specified target org; ignore unsupported field types instead of converting them to text:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c  --ignoreunsupported --targetusername 'alias or user email of the org containing the source type'","Generate a protected custom metadata type from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomObject__c  --visibility Protected","Generate a protected custom metadata type with a specific label from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --label \"My CMDT\" --plurallabel \"My CMDTs\" --sobjectname SourceCustomSetting__c  --visibility Protected","Generate a custom metadata type from an sObject in the default target org; put the resulting type metadata file in the specified directory:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --typeoutputdir 'path/to/my/cmdt/directory'","Generate a custom metadata type from an sObject in the default target org; put the resulting record metadata file(s) in the specified directory:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --recordsoutputdir 'path/to/my/cmdt/record/directory'"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org"},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command"},"devname":{"name":"devname","type":"option","char":"n","description":"name of the custom metadata type","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the custom metadata type"},"plurallabel":{"name":"plurallabel","type":"option","char":"p","description":"plural version of the label value; if blank, uses label"},"visibility":{"name":"visibility","type":"option","char":"v","description":"visibility of the custom metadata type","helpValue":"(PackageProtected|Protected|Public)","options":["PackageProtected","Protected","Public"],"default":"Public"},"sobjectname":{"name":"sobjectname","type":"option","char":"s","description":"API name of the sObject source for custom metadata generation","required":true},"ignoreunsupported":{"name":"ignoreunsupported","type":"boolean","char":"i","description":"ignore unsupported field types","allowNo":false},"typeoutputdir":{"name":"typeoutputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata type files","default":"force-app/main/default/objects/"},"recordsoutputdir":{"name":"recordsoutputdir","type":"option","char":"r","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata/"}},"args":[{"name":"file"}]},"force:cmdt:field:create":{"id":"force:cmdt:field:create","description":"generate a custom metadata field based on the field type provided","usage":"<%= command.id %> -n <string> -f Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>] [-l <string>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a metadata file for a custom checkbox field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Checkbox","Create a metadata file for a custom picklist field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Picklist --picklistvalues \"A,B,C\"","Create a metadata file for a custom number field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Number --decimalplaces 2"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"fieldname":{"name":"fieldname","type":"option","char":"n","description":"unique name for the field","required":true},"fieldtype":{"name":"fieldtype","type":"option","char":"f","description":"type of field","required":true,"helpValue":"(Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url)","options":["Checkbox","Date","DateTime","Email","Number","Percent","Phone","Picklist","Text","TextArea","LongTextArea","Url"]},"picklistvalues":{"name":"picklistvalues","type":"option","char":"p","description":"comma-separated list of picklist values; required for Picklist fields"},"decimalplaces":{"name":"decimalplaces","type":"option","char":"s","description":"number of decimal places to use for Number or Percent fields","default":0},"label":{"name":"label","type":"option","char":"l","description":"label for the field"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created field definition files"}},"args":[{"name":"file"}]},"force:cmdt:record:create":{"id":"force:cmdt:record:create","description":"create a new record for a given custom metadata type in the current project","usage":"<%= command.id %> [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a record metadata file for custom metadata type 'MyCMT' with values specified for two custom fields:","    $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord My_Custom_Field_1=Foo My_Custom_Field_2=Bar","Create a protected record metadata file for custom metadata type 'MyCMT' with a specific label and values specified for two custom fields:","    $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord --label \"My Record\" --protected true My_Custom_Field_1=Foo My_Custom_Field_2=Bar"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"typename":{"name":"typename","type":"option","char":"t","description":"API name of the custom metadata type to create a record for","required":true},"recordname":{"name":"recordname","type":"option","char":"n","description":"name for the new record","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the new record"},"protected":{"name":"protected","type":"option","char":"p","description":"protect the record when it is in a managed package","options":["true","false"],"default":"false"},"inputdir":{"name":"inputdir","type":"option","char":"i","description":"directory to pull the custom metadata type definition from","default":"force-app/main/default/objects"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata"}},"args":[]},"force:cmdt:record:insert":{"id":"force:cmdt:record:insert","description":"create new custom metadata type records from a CSV file","usage":"<%= command.id %> -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create record metadata files for type 'My_CMDT_Name' (from your local project) based on values in a CSV file, using 'Name' as the column that specifies the record name:","    $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name","Create record metadata files for type 'My_CMDT_Name' (from the specified directory) based on values in a CSV file, using 'PrimaryKey' as the column that specifies the record name:","    $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name --inputdir \"path/to/my/cmdt/directory\" --namecolumn \"PrimaryKey\""],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"filepath":{"name":"filepath","type":"option","char":"f","description":"path to the CSV file","required":true},"typename":{"name":"typename","type":"option","char":"t","description":"API name of the custom metadata type","required":true},"inputdir":{"name":"inputdir","type":"option","char":"i","description":"directory to pull the custom metadata type definition from","default":"force-app/main/default/objects"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata"},"namecolumn":{"name":"namecolumn","type":"option","char":"n","description":"column that is used to determine the name of the record","default":"Name"}},"args":[]}}}
+{"version":"1.0.12","commands":{"force:cmdt:create":{"id":"force:cmdt:create","description":"creates a new custom metadata type in the current project","usage":"<%= command.id %> -n <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a custom metadata type with developer name 'MyCustomType'; this name will also be used as the label:","    $ sfdx force:cmdt:create --typename MyCustomType","Create a protected custom metadata type with a specific label:","    $ sfdx force:cmdt:create --typename MyCustomType --label \"Custom Type\" --plurallabel \"Custom Types\" --visibility Protected"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"typename":{"name":"typename","type":"option","char":"n","description":"unique object name for the custom metadata type","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the custom metadata type"},"plurallabel":{"name":"plurallabel","type":"option","char":"p","description":"plural version of the label value; if blank, uses label"},"visibility":{"name":"visibility","type":"option","char":"v","description":"visibility of the custom metadata type","helpValue":"(PackageProtected|Protected|Public)","options":["PackageProtected","Protected","Public"],"default":"Public"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store the newly-created custom metadata type files"}},"args":[{"name":"file"}]},"force:cmdt:generate":{"id":"force:cmdt:generate","description":"generates a custom metadata type and all its records for the provided sObject","usage":"<%= command.id %> -n <string> -s <string> [-l <string>] [-p <string>] [-v PackageProtected|Protected|Public] [-i] [-d <directory>] [-r <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Generate a custom metadata type from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c","Generate a custom metadata type from an sObject in the specified target org; ignore unsupported field types instead of converting them to text:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname MySourceObject__c  --ignoreunsupported --targetusername 'alias or user email of the org containing the source type'","Generate a protected custom metadata type from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomObject__c  --visibility Protected","Generate a protected custom metadata type with a specific label from an sObject in the default target org:","    $ sfdx force:cmdt:generate --devname MyCMDT --label \"My CMDT\" --plurallabel \"My CMDTs\" --sobjectname SourceCustomSetting__c  --visibility Protected","Generate a custom metadata type from an sObject in the default target org; put the resulting type metadata file in the specified directory:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --typeoutputdir 'path/to/my/cmdt/directory'","Generate a custom metadata type from an sObject in the default target org; put the resulting record metadata file(s) in the specified directory:","    $ sfdx force:cmdt:generate --devname MyCMDT --sobjectname SourceCustomSetting__c --recordsoutputdir 'path/to/my/cmdt/record/directory'"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"targetusername":{"name":"targetusername","type":"option","char":"u","description":"username or alias for the target org; overrides default target org"},"apiversion":{"name":"apiversion","type":"option","description":"override the api version used for api requests made by this command"},"devname":{"name":"devname","type":"option","char":"n","description":"name of the custom metadata type","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the custom metadata type"},"plurallabel":{"name":"plurallabel","type":"option","char":"p","description":"plural version of the label value; if blank, uses label"},"visibility":{"name":"visibility","type":"option","char":"v","description":"visibility of the custom metadata type","helpValue":"(PackageProtected|Protected|Public)","options":["PackageProtected","Protected","Public"],"default":"Public"},"sobjectname":{"name":"sobjectname","type":"option","char":"s","description":"API name of the sObject source for custom metadata generation","required":true},"ignoreunsupported":{"name":"ignoreunsupported","type":"boolean","char":"i","description":"ignore unsupported field types","allowNo":false},"typeoutputdir":{"name":"typeoutputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata type files","default":"force-app/main/default/objects/"},"recordsoutputdir":{"name":"recordsoutputdir","type":"option","char":"r","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata/"}},"args":[{"name":"file"}]},"force:cmdt:field:create":{"id":"force:cmdt:field:create","description":"generate a custom metadata field based on the field type provided","usage":"<%= command.id %> -n <string> -f Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url [-p <array>] [-s <number>] [-l <string>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a metadata file for a custom checkbox field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Checkbox","Create a metadata file for a custom picklist field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Picklist --picklistvalues \"A,B,C\"","Create a metadata file for a custom number field:","    $ sfdx force:cmdt:field:create --fieldname MyField --fieldtype Number --decimalplaces 2"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"fieldname":{"name":"fieldname","type":"option","char":"n","description":"unique name for the field","required":true},"fieldtype":{"name":"fieldtype","type":"option","char":"f","description":"type of field","required":true,"helpValue":"(Checkbox|Date|DateTime|Email|Number|Percent|Phone|Picklist|Text|TextArea|LongTextArea|Url)","options":["Checkbox","Date","DateTime","Email","Number","Percent","Phone","Picklist","Text","TextArea","LongTextArea","Url"]},"picklistvalues":{"name":"picklistvalues","type":"option","char":"p","description":"comma-separated list of picklist values; required for Picklist fields"},"decimalplaces":{"name":"decimalplaces","type":"option","char":"s","description":"number of decimal places to use for Number or Percent fields","default":0},"label":{"name":"label","type":"option","char":"l","description":"label for the field"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created field definition files"}},"args":[{"name":"file"}]},"force:cmdt:record:create":{"id":"force:cmdt:record:create","description":"create a new record for a given custom metadata type in the current project","usage":"<%= command.id %> [name=value...] -t <string> -n <string> [-l <string>] [-p <string>] [-i <directory>] [-d <directory>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create a record metadata file for custom metadata type 'MyCMT' with values specified for two custom fields:","    $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord My_Custom_Field_1=Foo My_Custom_Field_2=Bar","Create a protected record metadata file for custom metadata type 'MyCMT' with a specific label and values specified for two custom fields:","    $ sfdx force:cmdt:record:create --typename MyCMT__mdt --recordname MyRecord --label \"My Record\" --protected true My_Custom_Field_1=Foo My_Custom_Field_2=Bar"],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"typename":{"name":"typename","type":"option","char":"t","description":"API name of the custom metadata type to create a record for","required":true},"recordname":{"name":"recordname","type":"option","char":"n","description":"name for the new record","required":true},"label":{"name":"label","type":"option","char":"l","description":"label for the new record"},"protected":{"name":"protected","type":"option","char":"p","description":"protect the record when it is in a managed package","options":["true","false"],"default":"false"},"inputdir":{"name":"inputdir","type":"option","char":"i","description":"directory to pull the custom metadata type definition from","default":"force-app/main/default/objects"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata"}},"args":[]},"force:cmdt:record:insert":{"id":"force:cmdt:record:insert","description":"create new custom metadata type records from a CSV file","usage":"<%= command.id %> -f <string> -t <string> [-i <directory>] [-d <directory>] [-n <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]","pluginName":"@salesforce/plugin-custom-metadata","pluginType":"core","aliases":[],"examples":["Create record metadata files for type 'My_CMDT_Name' (from your local project) based on values in a CSV file, using 'Name' as the column that specifies the record name:","    $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name","Create record metadata files for type 'My_CMDT_Name' (from the specified directory) based on values in a CSV file, using 'PrimaryKey' as the column that specifies the record name:","    $ sfdx force:cmdt:record:insert --filepath path/to/my.csv --typename My_CMDT_Name --inputdir \"path/to/my/cmdt/directory\" --namecolumn \"PrimaryKey\""],"flags":{"json":{"name":"json","type":"boolean","description":"format output as json","allowNo":false},"loglevel":{"name":"loglevel","type":"option","description":"logging level for this command invocation","required":false,"helpValue":"(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)","options":["trace","debug","info","warn","error","fatal","TRACE","DEBUG","INFO","WARN","ERROR","FATAL"],"default":"warn"},"filepath":{"name":"filepath","type":"option","char":"f","description":"path to the CSV file","required":true},"typename":{"name":"typename","type":"option","char":"t","description":"API name of the custom metadata type","required":true},"inputdir":{"name":"inputdir","type":"option","char":"i","description":"directory to pull the custom metadata type definition from","default":"force-app/main/default/objects"},"outputdir":{"name":"outputdir","type":"option","char":"d","description":"directory to store newly-created custom metadata record files","default":"force-app/main/default/customMetadata"},"namecolumn":{"name":"namecolumn","type":"option","char":"n","description":"column that is used to determine the name of the record","default":"Name"}},"args":[]}}}

package/package.json

@@ -1,128 +1,143 @@
 {
-  "name": "@salesforce/plugin-custom-metadata",
-  "description": "Tools for working with custom metadata types and their records.",
-  "version": "1.0.8",
-  "contributors": [
-    {
-      "name": "Carolyn Grabill",
-      "url": "https://www.salesforce.com/"
-    },
-    {
-      "name": "Bryan Friend",
-      "url": "https://www.codescience.com/"
+    "name": "@salesforce/plugin-custom-metadata",
+    "description": "Tools for working with custom metadata types and their records.",
+    "version": "1.0.12",
+    "contributors": [
+        {
+            "name": "Carolyn Grabill",
+            "url": "https://www.salesforce.com/"
+        },
+        {
+            "name": "Bryan Friend",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Abhishek Tangudu",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Matt Turnure",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Mohith Shrivastava",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Brian Runyan",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Brian Buffington",
+            "url": "https://www.codescience.com/"
+        },
+        {
+            "name": "Catherine Schell",
+            "url": "https://www.salesforce.com/"
+        },
+        {
+            "name": "Seth Leger",
+            "url": "https://www.salesforce.com/"
+        }
+    ],
+    "bugs": "https://github.com/salesforcecli/plugin-custom-metadata/issues",
+    "dependencies": {
+        "@oclif/command": "^1.6.1",
+        "@oclif/config": "^1.15.1",
+        "@oclif/errors": "^1.2.2",
+        "@salesforce/command": "^3.0.0",
+        "@salesforce/ts-types": "^1.2.2",
+        "tslib": "^2.0.0"
     },
-    {
-      "name": "Abhishek Tangudu",
-      "url": "https://www.codescience.com/"
+    "devDependencies": {
+        "@oclif/dev-cli": "^1.22.2",
+        "@oclif/plugin-command-snapshot": "^1.0.0",
+        "@oclif/plugin-help": "^3.0.1",
+        "@oclif/test": "^1.2.6",
+        "@salesforce/dev-config": "^1.5.0",
+        "@salesforce/dev-scripts": "0.6.1",
+        "@salesforce/plugin-command-reference": "^1.1.0",
+        "@salesforce/ts-sinon": "^1.1.2",
+        "@semantic-release/git": "^9.0.0",
+        "@types/chai": "^4.2.11",
+        "@types/jsforce": "1.9.18",
+        "@types/mocha": "^7.0.2",
+        "@types/node": "^14.0.9",
+        "@types/xml2js": "^0.4.5",
+        "chai": "^4.2.0",
+        "globby": "^11.0.1",
+        "husky": "^4.2.5",
+        "mocha": "^7.2.0",
+        "nyc": "^15.1.0",
+        "semantic-release": "^17.0.8",
+        "shx": "0.2.2",
+        "sinon": "9.0.2",
+        "ts-node": "^8.10.2",
+        "typescript": "^3.9.3",
+        "xml2js": "^0.4.23"
     },
-    {
-      "name": "Matt Turnure",
-      "url": "https://www.codescience.com/"
+    "engines": {
+        "node": ">=8.0.0"
     },
-    {
-      "name": "Mohith Shrivastava",
-      "url": "https://www.codescience.com/"
+    "files": [
+        "/csvtojson",
+        "/lib",
+        "/messages",
+        "/oclif.manifest.json"
+    ],
+    "homepage": "https://github.com/salesforcecli/plugin-custom-metadata",
+    "keywords": [
+        "sfdx-plugin"
+    ],
+    "license": "BSD-3-Clause",
+    "oclif": {
+        "commands": "./lib/commands",
+        "bin": "sfdx",
+        "devPlugins": [
+            "@oclif/plugin-help",
+            "@oclif/plugin-command-snapshot",
+            "@salesforce/plugin-command-reference"
+        ],
+        "topics": {
+            "force": {
+                "external": true,
+                "subtopics": {
+                    "cmdt": {
+                        "description": "create and update custom metadata types and their records",
+                        "subtopics": {
+                            "record": {
+                                "description": "create and update custom metadata type records"
+                            }
+                        }
+                    }
+                }
+            }
+        }
     },
-    {
-      "name": "Brian Runyan",
-      "url": "https://www.codescience.com/"
+    "repository": "github:salesforcecli/plugin-custom-metadata",
+    "scripts": {
+        "clean:lib": "shx rm -rf lib && shx rm -rf coverage && shx rm -rf .nyc_output && shx rm -f oclif.manifest.json",
+        "compile": "tsc -b",
+        "build": "yarn run clean:lib && yarn compile",
+        "postpack": "rm -f oclif.manifest.json",
+        "posttest": "tsc -p test --noEmit && tslint -p test -t stylish && yarn test:deprecation-policy && yarn test:command-reference",
+        "prepack": "rm -rf lib && tsc && oclif-dev manifest && oclif-dev readme",
+        "test": "nyc mocha --forbid-only \"test/**/*.test.ts\"",
+        "version": "oclif-dev readme && git add README.md",
+        "release": "semantic-release -p @semantic-release/git -p @semantic-release/npm -p @semantic-release/github -p @semantic-release/commit-analyzer",
+        "test:deprecation-policy": "./bin/run snapshot:compare",
+        "test:command-reference": "./bin/run commandreference:generate -p @salesforce/plugin-custom-metadata --erroronwarnings"
     },
-    {
-      "name": "Brian Buffington",
-      "url": "https://www.codescience.com/"
+    "husky": {
+        "hooks": {
+            "commit-msg": "yarn sf-husky-commit-msg"
+        }
     },
-    {
-      "name": "Catherine Schell",
-      "url": "https://www.salesforce.com/"
+    "publishConfig": {
+        "access": "public"
     },
-    {
-      "name": "Seth Leger",
-      "url": "https://www.salesforce.com/"
-    }
-  ],
-  "bugs": "https://github.com/salesforcecli/plugin-custom-metadata/issues",
-  "dependencies": {
-    "@oclif/command": "^1.6.1",
-    "@oclif/config": "^1.15.1",
-    "@oclif/errors": "^1.2.2",
-    "@salesforce/command": "^3.0.0",
-    "@salesforce/ts-types": "^1.2.2",
-    "tslib": "^2.0.0"
-  },
-  "devDependencies": {
-    "@oclif/dev-cli": "^1.22.2",
-    "@oclif/plugin-command-snapshot": "^1.0.0",
-    "@oclif/plugin-help": "^3.0.1",
-    "@oclif/test": "^1.2.6",
-    "@salesforce/dev-config": "^1.5.0",
-    "@salesforce/plugin-command-reference": "^1.1.0",
-    "@salesforce/ts-sinon": "^1.1.2",
-    "@semantic-release/git": "^9.0.0",
-    "@types/chai": "^4.2.11",
-    "@types/jsforce": "1.9.18",
-    "@types/mocha": "^7.0.2",
-    "@types/node": "^14.0.9",
-    "@types/xml2js": "^0.4.5",
-    "chai": "^4.2.0",
-    "globby": "^11.0.1",
-    "mocha": "^7.2.0",
-    "nyc": "^15.1.0",
-    "semantic-release": "^17.0.8",
-    "sinon": "9.0.2",
-    "ts-node": "^8.10.2",
-    "typescript": "^3.9.3",
-    "xml2js": "^0.4.23"
-  },
-  "engines": {
-    "node": ">=8.0.0"
-  },
-  "files": [
-    "/csvtojson",
-    "/lib",
-    "/messages",
-    "/oclif.manifest.json"
-  ],
-  "homepage": "https://github.com/salesforcecli/plugin-custom-metadata",
-  "keywords": [
-    "sfdx-plugin"
-  ],
-  "license": "BSD-3-Clause",
-  "oclif": {
-    "commands": "./lib/commands",
-    "bin": "sfdx",
-    "devPlugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-command-snapshot",
-      "@salesforce/plugin-command-reference"
-    ],
-    "topics": {
-      "force": {
-        "external": true,
-        "subtopics": {
-          "cmdt": {
-            "description": "create and update custom metadata types and their records",
-            "subtopics": {
-              "record": {
-                "description": "create and update custom metadata type records"
-              }
-            }
-          }
-        }
-      }
+    "sfdx": {
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/sfdx-cli-03032020.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/signatures/salesforce-plugin-custom-metadata-1.0.12.sig"
     }
-  },
-  "repository": "github:salesforcecli/plugin-custom-metadata",
-  "scripts": {
-    "postpack": "rm -f oclif.manifest.json",
-    "posttest": "tsc -p test --noEmit && tslint -p test -t stylish && yarn test:deprecation-policy && yarn test:command-reference",
-    "prepack": "rm -rf lib && tsc && oclif-dev manifest && oclif-dev readme",
-    "test": "nyc mocha --forbid-only \"test/**/*.test.ts\"",
-    "version": "oclif-dev readme && git add README.md",
-    "release": "semantic-release -p @semantic-release/git -p @semantic-release/npm -p @semantic-release/github -p @semantic-release/commit-analyzer",
-    "test:deprecation-policy": "./bin/run snapshot:compare",
-    "test:command-reference": "./bin/run commandreference:generate -p @salesforce/plugin-custom-metadata --erroronwarnings"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+}