Asset pipeline flow for hosted static app

[elanalynn]

DEPENDS ON https://github.com/shop/world/pull/382743 TO SHIP FIRST

WHY are these changes introduced?

Related to Hosted app project.

Related to https://github.com/shop/world/pull/382743

Closes https://github.com/shop/issues-admin-extensibility/issues/2186

WHAT is this pull request doing?

This PR introduces the asset pipeline flow for hosted static apps, enabling static asset copying during the build process.

• New hosted_app specification (app_config_hosted_app_home.ts): Adds a configuration extension specification for hosted apps with a static_root field
• New static_app build mode: Extends the build config modes to include static_app, which triggers static asset copying
• Enhanced config extension specifications:
  • Added optional buildConfig and copyStaticAssets parameters to createConfigExtensionSpecification()
  • Config extensions can now define custom build behavior

How it works

When a hosted app defines a static_root in its configuration:

1. The hosted_app specification is loaded with build mode static_app
2. During build, copyStaticAssets() is invoked
3. Contents from the configured static_root directory are copied to the output directory

How to test your changes?

• Configure a hosted app with static_root pointing to a static assets directory
• Run shopify app deploy and verify assets are copied to the output directory - .shopify/deploy-bundle
• Verify deploy works when static_root is not specified
• TODO: Verify appropriate error handling when source directory doesn't exist

Measuring impact

How do we know this change was effective? Please choose one:

• n/a - this doesn't need measurement, e.g. a linting rule or a bug-fix
• Existing analytics will cater for this addition
• PR includes analytics changes to measure impact

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	79.51% (+0.28% 🔼)	14359/18060
🟡	Branches	73.72% (+0.61% 🔼)	7088/9615
🟡	Functions	79.65% (+0.28% 🔼)	3668/4605
🟡	Lines	79.87% (+0.29% 🔼)	13575/16997

Show new covered files 🐣

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / admin-as-app.ts	100%	100%	100%	100%
🟢	... / metafield_definitions.ts	100%	100%	100%	100%
🟢	... / metaobject_definitions.ts	100%	100%	100%	100%
🟢	... / bulk-operation-cancel.ts	100%	100%	100%	100%
🟢	... / bulk-operation-run-mutation.ts	100%	100%	100%	100%
🟢	... / bulk-operation-run-query.ts	100%	100%	100%	100%
🟢	... / get-bulk-operation-by-id.ts	100%	100%	100%	100%
🟢	... / list-bulk-operations.ts	100%	100%	100%	100%
🟢	... / staged-uploads-create.ts	100%	100%	100%	100%
🟢	... / fetch_store_by_domain.ts	100%	100%	100%	100%
🔴	... / import-custom-data-definitions.ts	0%	100%	0%	0%
🔴	... / cancel.ts	0%	100%	0%	0%
🔴	... / execute.ts	0%	0%	0%	0%
🔴	... / status.ts	0%	0%	0%	0%
🔴	... / pull.ts	0%	100%	0%	0%
🟢	... / app_config_hosted_app_home.ts	100%	100%	100%	100%
🟡	... / execute-operation.ts	75%	50%	100%	75%
🔴	... / pull.ts	0%	0%	0%	0%
🟢	... / bulk-operation-status.ts	96.55%	92.11%	100%	100%
🟢	... / cancel-bulk-operation.ts	100%	100%	100%	100%
🟢	... / constants.ts	100%	100%	100%	100%
🟢	... / download-bulk-operation-results.ts	100%	100%	100%	100%
🟢	... / execute-bulk-operation.ts	86.76%	83.67%	100%	88.06%
🟢	... / format-bulk-operation-status.ts	100%	100%	100%	100%
🟢	... / run-mutation.ts	100%	100%	100%	100%
🟢	... / run-query.ts	100%	100%	100%	100%
🟡	... / stage-file.ts	73.53%	62.5%	85.71%	72.73%
🟢	... / watch-bulk-operation.ts	100%	94.74%	100%	100%
🟢	... / utilities.ts	100%	100%	100%	100%
🟢	... / declarative-definitions.ts	98.54%	93.18%	100%	98.51%
🟢	... / common.ts	97.62%	95%	100%	97.06%
🟢	... / execute-command-helpers.ts	100%	100%	100%	100%
🟢	... / file-formatter.ts	100%	100%	100%	100%
🔴	... / promiseWithResolvers.ts	33.33%	50%	50%	33.33%

Show files with reduced coverage 🔻

St.❔	File	Statements	Branches	Functions	Lines
🔴	... / execute.ts	0%	0% (-100% 🔻)	0%	0%
🟢	... / loader.ts	94.06% (+0.2% 🔼)	86.41% (-0.42% 🔻)	97.17% (+0.11% 🔼)	94.85% (+0.18% 🔼)
🟢	... / extension-instance.ts	83.98% (-0.6% 🔻)	76.98% (-1.53% 🔻)	92.06% (+0.13% 🔼)	84.21% (-0.65% 🔻)
🟡	... / specification.ts	69.64% (+0.55% 🔼)	76.74% (+3.57% 🔼)	76.47% (-1.31% 🔻)	69.39% (+0.64% 🔼)
🟢	... / ui_extension.ts	87.9% (-6.93% 🔻)	77.19% (-4.06% 🔻)	85.19% (-14.81% 🔻)	90.07% (-6.39% 🔻)
🟢	... / store-context.ts	100%	82.35% (-0.98% 🔻)	100%	100%
🟢	... / Logs.tsx	90%	90.91% (-5.97% 🔻)	100%	90%
🟢	... / fetch.ts	84.21% (+0.88% 🔼)	82.35% (-0.98% 🔻)	75%	85.29% (+1.42% 🔼)
🟢	... / app-event-watcher-handler.ts	86.36% (-4.11% 🔻)	75%	86.67%	85.71% (-5.19% 🔻)
🔴	... / server.ts	1.23% (-0.02% 🔻)	0%	0%	1.3% (-0.02% 🔻)
🟢	... / bundle.ts	93.22%	63.33% (-3.33% 🔻)	94.12% (+5.88% 🔼)	96.3%
🟢	... / developer-platform-client.ts	84.62% (-1.5% 🔻)	71.43% (+0.84% 🔼)	81.82% (+1.82% 🔼)	93.75% (+0.42% 🔼)
🔴	... / http-reverse-proxy.ts	58.97% (-4.91% 🔻)	37.04% (-2.96% 🔻)	58.33% (-5.3% 🔻)	59.46% (-5.25% 🔻)
🔴	... / app-management-client.ts	53.69% (-0.16% 🔻)	47.47%	50% (-0.45% 🔻)	52.53% (-0.17% 🔻)
🟢	... / api.ts	87.07% (-0.43% 🔻)	76.71% (-0.1% 🔻)	100%	86.49% (-0.43% 🔻)
🟢	... / device-authorization.ts	88.24% (-0.83% 🔻)	76.47% (-2.94% 🔻)	100%	88.24% (-0.83% 🔻)
🟢	... / SingleTask.tsx	84.21% (-15.79% 🔻)	50% (-50% 🔻)	80% (-20% 🔻)	84.21% (-15.79% 🔻)
🔴	... / environment.ts	35% (-5% 🔻)	41.18%	40% (-10% 🔻)	36.84% (-5.26% 🔻)
🔴	... / ui.tsx	50.82% (-0.79% 🔻)	42.86% (-5.53% 🔻)	54.55% (+1.42% 🔼)	50% (-0.82% 🔻)
🟢	... / console.ts	81.82% (+15.15% 🔼)	75% (-25% 🔻)	100% (+33.33% 🔼)	81.82% (+15.15% 🔼)
🟢	... / init.ts	88% (-0.89% 🔻)	71.43% (+4.76% 🔼)	86.67% (+4.85% 🔼)	88% (-0.89% 🔻)
🟢	... / storefront-renderer.ts	90.2% (-0.54% 🔻)	78.95%	81.82% (-1.52% 🔻)	90.2% (-0.54% 🔻)
🟡	... / theme-polling.ts	67.12% (-0.93% 🔻)	68.75%	78.57%	66.67% (-0.98% 🔻)

Test suite run success

3679 tests passing in 1437 suites.

Report generated by 🧪jest coverage report action from cd9fc6e