feat: Adds a new metadata bundle type for AppFrameworkTemplates

src/registry/metadataRegistry.json

@@ -63,7 +63,8 @@
     "siteDotComSites": "sitedotcom",
     "sites": "customsite",
     "staticresources": "staticresource",
-    "waveTemplates": "wavetemplatebundle"
+    "waveTemplates": "wavetemplatebundle",
+    "appTemplates": "appframeworktemplatebundle"
   },
   "suffixes": {
     "Canvas": "canvasmetadata",
@@ -521,7 +522,11 @@
     "xml": "emailservicesfunction",
     "xorghub": "xorghub",
     "ecaPush": "extlclntapppushsettings",
-    "ecaPushPlcy": "extlclntapppushconfigurablepolicies"
+    "ecaPushPlcy": "extlclntapppushconfigurablepolicies",
+    "ChoiceList": "choicelist",
+    "ConvIntelligenceSignalRule": "convintelligencesignalrule",
+    "PublicKeyCertificate": "publickeycertificate",
+    "PublicKeyCertificateSet": "publickeycertificateset"
   },
   "types": {
     "accesscontrolpolicy": {
@@ -4639,6 +4644,49 @@
       "directoryName": "extlClntAppPushPolicies",
       "inFolder": false,
       "strictDirectoryName": false
+    },
+    "appframeworktemplatebundle": {
+      "directoryName": "appTemplates",
+      "id": "appframeworktemplatebundle",
+      "name": "AppFrameworkTemplateBundle",
+      "inFolder": false,
+      "strategies": {
+        "adapter": "bundle"
+      },
+      "strictDirectoryName": true,
+      "supportsPartialDelete": true
+    },
+    "choicelist": {
+      "id": "choicelist",
+      "name": "ChoiceList",
+      "suffix": "ChoiceList",
+      "directoryName": "ChoiceList",
+      "inFolder": false,
+      "strictDirectoryName": false
+    },
+    "convintelligencesignalrule": {
+      "id": "convintelligencesignalrule",
+      "name": "ConvIntelligenceSignalRule",
+      "suffix": "ConvIntelligenceSignalRule",
+      "directoryName": "ConvIntelligenceSignalRule",
+      "inFolder": false,
+      "strictDirectoryName": false
+    },
+    "publickeycertificate": {
+      "id": "publickeycertificate",
+      "name": "PublicKeyCertificate",
+      "suffix": "PublicKeyCertificate",
+      "directoryName": "PublicKeyCertificate",
+      "inFolder": false,
+      "strictDirectoryName": false
+    },
+    "publickeycertificateset": {
+      "id": "publickeycertificateset",
+      "name": "PublicKeyCertificateSet",
+      "suffix": "PublicKeyCertificateSet",
+      "directoryName": "PublicKeyCertificateSet",
+      "inFolder": false,
+      "strictDirectoryName": false
     }
   }
 }

src/utils/filePathGenerator.ts

@@ -112,17 +112,26 @@ export const filePathsFromMetadataComponent = (
 
   // lwc, aura, waveTemplate, experiencePropertyType
   if (type.strategies?.adapter === 'bundle') {
-    const mappings = new Map<string, string>([
-      ['ExperiencePropertyTypeBundle', join(packageDirWithTypeDir, `${fullName}${sep}schema.json`)],
-      ['WaveTemplateBundle', join(packageDirWithTypeDir, `${fullName}${sep}template-info.json`)],
-      ['LightningComponentBundle', join(packageDirWithTypeDir, `${fullName}${sep}${fullName}.js${META_XML_SUFFIX}`)],
-      ['AuraDefinitionBundle', join(packageDirWithTypeDir, `${fullName}${sep}${fullName}.cmp${META_XML_SUFFIX}`)],
+    const mappings = new Map<string, string[]>([
+      ['ExperiencePropertyTypeBundle', [join(packageDirWithTypeDir, `${fullName}${sep}schema.json`)]],
+      ['WaveTemplateBundle', [join(packageDirWithTypeDir, `${fullName}${sep}template-info.json`)]],
+      ['LightningComponentBundle', [join(packageDirWithTypeDir, `${fullName}${sep}${fullName}.js${META_XML_SUFFIX}`)]],
+      ['AuraDefinitionBundle', [join(packageDirWithTypeDir, `${fullName}${sep}${fullName}.cmp${META_XML_SUFFIX}`)]],
+      [
+        'AppFrameworkTemplateBundle',
+        [
+          join(packageDirWithTypeDir, `${fullName}${sep}template-info.json`),
+          join(packageDirWithTypeDir, `${fullName}${sep}layout.json`),
+        ],
+      ],
     ]);
+
     const matched = mappings.get(type.name);
     if (!matched) {
       throw messages.createError('unsupportedBundleType', [type.name]);
     }
-    return [matched];
+
+    return matched;
   }
 
   throw messages.createError('filePathGeneratorNoTypeSupport', [type.name]);

test/snapshot/sampleProjects/appTemplates/__snapshots__/verify-md-files.expected/appTemplates/test_template/layout.json

@@ -0,0 +1 @@
+{}

test/snapshot/sampleProjects/appTemplates/__snapshots__/verify-md-files.expected/appTemplates/test_template/template-info.json

@@ -0,0 +1,11 @@
+{
+  "templateType": "App",
+  "label": "my test template",
+  "name": "test_template",
+  "namespace": null,
+  "assetVersion": 63.0,
+  "maxAppCount": null,
+  "layoutDefinition": "layout.json",
+  "tags": {},
+  "chainDefinitions": []
+}

test/snapshot/sampleProjects/appTemplates/__snapshots__/verify-md-files.expected/package.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Package xmlns="http://soap.sforce.com/2006/04/metadata">
+    <types>
+        <members>force-app</members>
+        <name>AppFrameworkTemplateBundle</name>
+    </types>
+    <version>62.0</version>
+</Package>

test/snapshot/sampleProjects/appTemplates/__snapshots__/verify-source-files.expected/force-app/main/default/appTemplates/test_template/layout.json

@@ -0,0 +1 @@
+{}

test/snapshot/sampleProjects/appTemplates/__snapshots__/verify-source-files.expected/force-app/main/default/appTemplates/test_template/template-info.json

@@ -0,0 +1,11 @@
+{
+  "templateType": "App",
+  "label": "my test template",
+  "name": "test_template",
+  "namespace": null,
+  "assetVersion": 63.0,
+  "maxAppCount": null,
+  "layoutDefinition": "layout.json",
+  "tags": {},
+  "chainDefinitions": []
+}

test/snapshot/sampleProjects/appTemplates/originalMdapi/appTemplates/test_template/layout.json

@@ -0,0 +1 @@
+{}

test/snapshot/sampleProjects/appTemplates/originalMdapi/appTemplates/test_template/template-info.json

@@ -0,0 +1,11 @@
+{
+  "templateType": "App",
+  "label": "my test template",
+  "name": "test_template",
+  "namespace": null,
+  "assetVersion": 63.0,
+  "maxAppCount": null,
+  "layoutDefinition": "layout.json",
+  "tags": {},
+  "chainDefinitions": []
+}

test/snapshot/sampleProjects/appTemplates/sfdx-project.json

@@ -0,0 +1,11 @@
+{
+  "packageDirectories": [
+    {
+      "default": true,
+      "path": "force-app"
+    }
+  ],
+  "name": "appTemplatesTestProject",
+  "namespace": "",
+  "sourceApiVersion": "62.0"
+}

test/snapshot/sampleProjects/appTemplates/snapshots.test.ts

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import {
+  FORCE_APP,
+  MDAPI_OUT,
+  dirsAreIdentical,
+  fileSnap,
+  mdapiToSource,
+  sourceToMdapi,
+} from '../../helper/conversions';
+
+// we don't want failing tests outputting over each other
+/* eslint-disable no-await-in-loop */
+
+describe('appTemplates', () => {
+  const testDir = path.join('test', 'snapshot', 'sampleProjects', 'appTemplates');
+  let sourceFiles: string[];
+  let mdFiles: string[];
+
+  before(async () => {
+    sourceFiles = await mdapiToSource(testDir);
+    mdFiles = await sourceToMdapi(testDir);
+  });
+
+  it('verify source files', async () => {
+    for (const file of sourceFiles) {
+      await fileSnap(file, testDir);
+    }
+    dirsAreIdentical(
+      path.join(testDir, FORCE_APP),
+      path.join(testDir, '__snapshots__', 'verify-source-files.expected', FORCE_APP)
+    );
+  });
+
+  it('verify md files', async () => {
+    for (const file of mdFiles) {
+      await fileSnap(file, testDir);
+    }
+  });
+
+  after(async () => {
+    await Promise.all([
+      fs.promises.rm(path.join(testDir, FORCE_APP), { recursive: true, force: true }),
+      fs.promises.rm(path.join(testDir, MDAPI_OUT), { recursive: true, force: true }),
+    ]);
+  });
+});

test/utils/filePathGenerator.test.ts

@@ -136,6 +136,19 @@ const testData = {
       },
     ],
   },
+  bundleAppTemplates: {
+    fullName: 'test_template',
+    typeName: 'AppFrameworkTemplateBundle',
+    expectedFilePaths: [
+      getFilePath('appTemplates/test_template/template-info.json'),
+      getFilePath('appTemplates/test_template/layout.json'),
+    ],
+    expectedComponents: [
+      {
+        content: getFilePath('appTemplates/test_template'),
+      },
+    ],
+  },
   nonDecomposedExplicit: {
     fullName: 'CustomLabels',
     typeName: 'CustomLabels',
@@ -304,6 +317,10 @@ describe('generating virtual tree from component name/type', () => {
     it('waveTemplate', () => {
       runTest(testData.bundleWave);
     });
+
+    it('appFrameworkTemplate', () => {
+      runTest(testData.bundleAppTemplates);
+    });
   });
 
   describe('adapter = nondecomposed', () => {