Enable uploading tools schema

Author: vividviolet

packages/app/src/cli/models/extensions/extension-instance.ts

@@ -374,6 +374,9 @@ export class ExtensionInstance<TConfiguration extends BaseConfigType = BaseConfi
 
     await this.build(options)
 
+    // Copy static assets after build completes
+    await this.copyStaticAssets()
+
     const bundleInputPath = joinPath(bundleDirectory, this.getOutputFolderId(outputId))
     await this.keepBuiltSourcemapsLocally(bundleInputPath)
   }
@@ -492,6 +495,16 @@ export class ExtensionInstance<TConfiguration extends BaseConfigType = BaseConfi
     return [...new Set(watchedFiles.map((file) => normalizePath(file)))]
   }
 
+  /**
+   * Copy static assets from the extension directory to the output path
+   * Used by both dev and deploy builds
+   */
+  async copyStaticAssets() {
+    if (this.specification.copyStaticAssets) {
+      return this.specification.copyStaticAssets(this.configuration, this.directory, this.outputPath)
+    }
+  }
+
   /**
    * Rescans imports for this extension and updates the cached import paths
    * Returns true if the imports changed

packages/app/src/cli/models/extensions/schemas.ts

@@ -45,6 +45,7 @@ const NewExtensionPointSchema = zod.object({
   target: zod.string(),
   module: zod.string(),
   should_render: ShouldRenderSchema.optional(),
+  tools: zod.string().optional(),
   metafields: zod.array(MetafieldSchema).optional(),
   default_placement: zod.string().optional(),
   urls: zod

packages/app/src/cli/models/extensions/specification.ts

@@ -38,6 +38,7 @@ type UidStrategy = 'single' | 'dynamic' | 'uuid'
 export enum AssetIdentifier {
   ShouldRender = 'should_render',
   Main = 'main',
+  Tools = 'tools',
 }
 
 export interface Asset {
@@ -53,6 +54,49 @@ type BuildConfig =
  * Extension specification with all the needed properties and methods to load an extension.
  */
 export interface ExtensionSpecification<TConfiguration extends BaseConfigType = BaseConfigType> {
+  copyStaticAssets?: <
+    TConfiguration extends {
+      name?: string | undefined
+      type?: string | undefined
+      handle?: string | undefined
+      uid?: string | undefined
+      description?: string | undefined
+      api_version?: string | undefined
+      extension_points?: unknown
+      capabilities?:
+        | {
+            network_access?: boolean | undefined
+            block_progress?: boolean | undefined
+            api_access?: boolean | undefined
+            collect_buyer_consent?:
+              | {sms_marketing?: boolean | undefined; customer_privacy?: boolean | undefined}
+              | undefined
+            iframe?: {sources?: string[] | undefined} | undefined
+          }
+        | undefined
+      settings?:
+        | {
+            fields?:
+              | {
+                  type: string
+                  name?: string | undefined
+                  description?: string | undefined
+                  key?: string | undefined
+                  required?: boolean | undefined
+                  default_value?: unknown
+                  validations?: unknown[] | undefined
+                  marketingActivityCreateUrl?: string | undefined
+                  marketingActivityDeleteUrl?: string | undefined
+                }[]
+              | undefined
+          }
+        | undefined
+    },
+  >(
+    configuration: TConfiguration,
+    directory: string,
+    outputPath: string,
+  ) => Promise<void>
   identifier: string
   externalIdentifier: string
   externalName: string

packages/app/src/cli/models/extensions/specifications/ui_extension.ts

@@ -5,8 +5,8 @@ import {loadLocalesConfig} from '../../../utilities/extensions/locales-configura
 import {getExtensionPointTargetSurface} from '../../../services/dev/extension/utilities.js'
 import {ExtensionInstance} from '../extension-instance.js'
 import {err, ok, Result} from '@shopify/cli-kit/node/result'
-import {fileExists} from '@shopify/cli-kit/node/fs'
-import {joinPath} from '@shopify/cli-kit/node/path'
+import {copyFile, fileExists} from '@shopify/cli-kit/node/fs'
+import {joinPath, basename, dirname} from '@shopify/cli-kit/node/path'
 import {outputContent, outputToken} from '@shopify/cli-kit/node/output'
 import {zod} from '@shopify/cli-kit/node/schema'
 
@@ -27,6 +27,7 @@ export interface BuildManifest {
     [key in AssetIdentifier]?: {
       filepath: string
       module?: string
+      static?: boolean
     }
   }
 }
@@ -57,6 +58,15 @@ export const UIExtensionSchema = BaseSchema.extend({
                 },
               }
             : null),
+          ...(targeting.tools
+            ? {
+                [AssetIdentifier.Tools]: {
+                  filepath: `${config.handle}-${AssetIdentifier.Tools}-${basename(targeting.tools)}`,
+                  module: targeting.tools,
+                  static: true,
+                },
+              }
+            : null),
         },
       }
 
@@ -125,6 +135,11 @@ const uiExtensionSpec = createExtensionSpecification({
           return
         }
 
+        // Skip static assets - they are copied after esbuild completes in rebuildContext
+        if (asset.static && asset.module) {
+          return
+        }
+
         assets[identifier] = {
           identifier: identifier as AssetIdentifier,
           outputFileName: asset.filepath,
@@ -143,6 +158,29 @@ const uiExtensionSpec = createExtensionSpecification({
       ...(assetsArray.length ? {assets: assetsArray} : {}),
     }
   },
+  copyStaticAssets: async (config, directory, outputPath) => {
+    if (!isRemoteDomExtension(config)) return
+    const extensionPoints = (config.extension_points as NewExtensionPointSchemaType[]) || []
+
+    await Promise.all(
+      extensionPoints.map((extensionPoint) => {
+        if (!('build_manifest' in extensionPoint)) return Promise.resolve()
+
+        return Object.entries(
+          (extensionPoint as NewExtensionPointSchemaType & {build_manifest: BuildManifest}).build_manifest.assets,
+        ).map(([_identifier, asset]) => {
+          if (asset.static && asset.module) {
+            const sourceFile = joinPath(directory, asset.module)
+            const outputFilePath = joinPath(dirname(outputPath), asset.filepath)
+            return copyFile(sourceFile, outputFilePath).catch((error) => {
+              throw new Error(`Failed to copy static asset ${asset.module} to ${outputFilePath}: ${error.message}`)
+            })
+          }
+          return Promise.resolve()
+        })
+      }),
+    )
+  },
   hasExtensionPointTarget: (config, requestedTarget) => {
     return (
       config.extension_points?.find((extensionPoint) => {

packages/app/src/cli/services/dev/app-events/app-watcher-esbuild.ts

@@ -80,6 +80,9 @@ export class ESBuildContextManager {
     if (!context) return
     await Promise.all(context.map((ctxt) => ctxt.rebuild()))
 
+    // Copy static assets after build completes
+    await extension.copyStaticAssets()
+
     // The default output path for a extension is now inside `.shopify/bundle/<ext_id>/dist`,
     // all extensions output need to be under the same directory so that it can all be zipped together.