refactor(apps): follow @datadog/apps-backend runtime entry-point split

The SDK renamed its build-tool contract from a single
@datadog/apps-backend/internal entry (createBackendFrom$/setBackend) to
@datadog/apps-backend/runtime (setBackend) paired with a runtime factory
at @datadog/apps-backend/runtime/jsFunctionWithActions
(buildRuntimeFromJsFunctionWithActions). Update the generated virtual
entry to import and call the new pair.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: Scott-Meyer

packages/plugins/apps/src/backend/shared.test.ts

@@ -9,28 +9,28 @@ import {
 
 describe('SET_BACKEND_CONTEXT_SNIPPET', () => {
     test('registers the backend runtime context', () => {
-        const backendHandle = { opaque: true };
-        const createBackendFrom$ = jest.fn().mockReturnValue(backendHandle);
+        const runtimeHandle = { opaque: true };
+        const buildRuntimeFromJsFunctionWithActions = jest.fn().mockReturnValue(runtimeHandle);
         const setBackend = jest.fn();
         const context = { Source: { initiator: { id: 'user-id' } } };
 
         // eslint-disable-next-line no-new-func
         const run = new Function(
-            'createBackendFrom$',
+            'buildRuntimeFromJsFunctionWithActions',
             'setBackend',
             '$',
             SET_BACKEND_CONTEXT_SNIPPET,
         );
-        run(createBackendFrom$, setBackend, context);
+        run(buildRuntimeFromJsFunctionWithActions, setBackend, context);
 
-        expect(createBackendFrom$).toHaveBeenCalledWith(context);
-        expect(setBackend).toHaveBeenCalledWith(backendHandle);
+        expect(buildRuntimeFromJsFunctionWithActions).toHaveBeenCalledWith(context);
+        expect(setBackend).toHaveBeenCalledWith(runtimeHandle);
     });
 
-    test('does not throw when createBackendFrom$/setBackend are unavailable', () => {
+    test('does not throw when buildRuntimeFromJsFunctionWithActions/setBackend are unavailable', () => {
         // eslint-disable-next-line no-new-func
         const run = new Function(
-            'createBackendFrom$',
+            'buildRuntimeFromJsFunctionWithActions',
             'setBackend',
             '$',
             SET_BACKEND_CONTEXT_SNIPPET,

packages/plugins/apps/src/backend/shared.ts

@@ -20,23 +20,24 @@ export function isActionCatalogInstalled(fromDir: string): boolean {
     return isPackageExportInstalled('@datadog/action-catalog/action-execution', fromDir);
 }
 
-/** Check if the backend-internal @datadog/apps-backend runtime entry point is installed. */
+/** Check if the @datadog/apps-backend "JS Function with Actions" runtime factory is installed. */
 export function isDatadogAppsInstalled(fromDir: string): boolean {
-    return isPackageExportInstalled('@datadog/apps-backend/internal', fromDir);
+    return isPackageExportInstalled('@datadog/apps-backend/runtime/jsFunctionWithActions', fromDir);
 }
 
 /** The import line to pull action-catalog's setExecuteActionImplementation into bundles. */
 export const ACTION_CATALOG_IMPORT =
     "import { setExecuteActionImplementation } from '@datadog/action-catalog/action-execution';";
 
 /** The import line that exposes @datadog/apps-backend backend context initialization. */
-export const DATADOG_APPS_IMPORT =
-    "import { createBackendFrom$, setBackend } from '@datadog/apps-backend/internal';";
+export const DATADOG_APPS_IMPORT = `\
+import { buildRuntimeFromJsFunctionWithActions } from '@datadog/apps-backend/runtime/jsFunctionWithActions';
+import { setBackend } from '@datadog/apps-backend/runtime';`;
 
 /** Script snippet that supplies the backend runtime context to @datadog/apps. */
 export const SET_BACKEND_CONTEXT_SNIPPET = `\
-    if (typeof createBackendFrom$ === 'function' && typeof setBackend === 'function') {
-        setBackend(createBackendFrom$($));
+    if (typeof buildRuntimeFromJsFunctionWithActions === 'function' && typeof setBackend === 'function') {
+        setBackend(buildRuntimeFromJsFunctionWithActions($));
     }`;
 
 /** Script snippet that registers the $.Actions-based executeAction implementation at runtime. */

packages/plugins/apps/src/backend/virtual-entry.test.ts

@@ -97,8 +97,8 @@ describe('Backend Functions - generateVirtualEntryContent', () => {
                 '/src/handler.ts',
                 PROJECT_ROOT,
             );
-            expect(result).not.toContain('@datadog/apps-backend/internal');
-            expect(result).not.toContain('setBackend(createBackendFrom$($))');
+            expect(result).not.toContain('@datadog/apps-backend/runtime');
+            expect(result).not.toContain('setBackend(buildRuntimeFromJsFunctionWithActions($))');
         });
     });
 
@@ -143,13 +143,14 @@ describe('Backend Functions - generateVirtualEntryContent', () => {
             );
 
             expect(result).toContain(
-                "import { createBackendFrom$, setBackend } from '@datadog/apps-backend/internal'",
-            );
-            expect(result.indexOf('setBackend(createBackendFrom$($))')).toBeGreaterThan(
-                result.indexOf('globalThis.$ = $'),
+                "import { buildRuntimeFromJsFunctionWithActions } from '@datadog/apps-backend/runtime/jsFunctionWithActions'",
             );
+            expect(result).toContain("import { setBackend } from '@datadog/apps-backend/runtime'");
+            expect(
+                result.indexOf('setBackend(buildRuntimeFromJsFunctionWithActions($))'),
+            ).toBeGreaterThan(result.indexOf('globalThis.$ = $'));
             expect(result.indexOf('await myHandler(...args)')).toBeGreaterThan(
-                result.indexOf('setBackend(createBackendFrom$($))'),
+                result.indexOf('setBackend(buildRuntimeFromJsFunctionWithActions($))'),
             );
         });
     });

packages/plugins/apps/src/backend/virtual-entry.ts

@@ -21,11 +21,11 @@ export function generateVirtualEntryContent(
     projectRoot: string,
 ): string {
     const lines: string[] = [];
-    const hasDatadogAppsBackendInternal = isDatadogAppsInstalled(projectRoot);
+    const hasDatadogAppsBackendRuntime = isDatadogAppsInstalled(projectRoot);
 
     lines.push(`import { ${functionName} } from ${JSON.stringify(entryPath)};`);
 
-    if (hasDatadogAppsBackendInternal) {
+    if (hasDatadogAppsBackendRuntime) {
         lines.push(DATADOG_APPS_IMPORT);
     }
 
@@ -38,7 +38,7 @@ export function generateVirtualEntryContent(
     lines.push('export async function main($) {');
     lines.push('    globalThis.$ = $;');
     lines.push('');
-    if (hasDatadogAppsBackendInternal) {
+    if (hasDatadogAppsBackendRuntime) {
         lines.push('    // Supply the backend runtime context');
         lines.push(SET_BACKEND_CONTEXT_SNIPPET);
         lines.push('');