Notification system

.changeset/tough-eels-bow.md

@@ -0,0 +1,7 @@
+---
+'@shopify/cli-kit': minor
+'@shopify/app': minor
+'@shopify/cli': minor
+---
+
+Notification system

notifications.json

@@ -0,0 +1 @@
+{"notifications":[]}

packages/app/src/cli/models/app/loader.ts

@@ -49,6 +49,7 @@ import {getArrayRejectingUndefined} from '@shopify/cli-kit/common/array'
 import {checkIfIgnoredInGitRepository} from '@shopify/cli-kit/node/git'
 import {renderInfo} from '@shopify/cli-kit/node/ui'
 import {currentProcessIsGlobal} from '@shopify/cli-kit/node/is-global'
+import {showNotificationsIfNeeded} from '@shopify/cli-kit/node/notifications-system'
 import {globalCLIVersion, localCLIVersion} from '@shopify/cli-kit/node/version'
 
 const defaultExtensionDirectory = 'extensions/*'
@@ -327,6 +328,10 @@ class AppLoader<TConfig extends AppConfiguration, TModuleSpec extends ExtensionS
       remoteFlags: this.remoteFlags,
     })
 
+    // Show CLI notifications that are targetted for when your app has specific extension types
+    const extensionTypes = appClass.realExtensions.map((module) => module.type)
+    await showNotificationsIfNeeded(extensionTypes)
+
     if (!this.errors.isEmpty()) appClass.errors = this.errors
 
     await logMetadataForLoadedApp(appClass, {

packages/cli-kit/package.json

@@ -89,7 +89,9 @@
               "static": [
                 "@oclif/core",
                 "./context/utilities.js",
-                "../../private/node/demo-recorder.js"
+                "../../private/node/demo-recorder.js",
+                "../../private/node/conf-store.js",
+                "url"
               ]
             }
           ]

packages/cli-kit/src/private/node/conf-store.test.ts

@@ -155,14 +155,15 @@ describe('cacheRetrieve', () => {
     await inTemporaryDirectory(async (cwd) => {
       // Given
       const config = new LocalStorage<any>({cwd})
-      const cacheValue = {'identity-introspection-url-IDENTITYURL': {value: 'URL1', timestamp: Date.now()}}
-      config.set('cache', cacheValue)
+      const cacheValue = {value: 'URL1', timestamp: Date.now()}
+      const cacheEntry = {'identity-introspection-url-IDENTITYURL': cacheValue}
+      config.set('cache', cacheEntry)
 
       // When
       const got = cacheRetrieve('identity-introspection-url-IDENTITYURL', config)
 
       // Then
-      expect(got).toEqual('URL1')
+      expect(got).toEqual(cacheValue)
     })
   })
 

packages/cli-kit/src/private/node/conf-store.ts

@@ -9,15 +9,19 @@
 
 export type IntrospectionUrlKey = `identity-introspection-url-${string}`
 export type PackageVersionKey = `npm-package-${string}`
+export type NotificationsKey = `notifications-${string}`
+export type NotificationKey = `notification-${string}`
 type MostRecentOccurrenceKey = `most-recent-occurrence-${string}`
 type RateLimitKey = `rate-limited-occurrences-${string}`
 
-type ExportedKey = IntrospectionUrlKey | PackageVersionKey
+type ExportedKey = IntrospectionUrlKey | PackageVersionKey | NotificationsKey | NotificationKey
 
 interface Cache {
   [introspectionUrlKey: IntrospectionUrlKey]: CacheValue<string>
   [packageVersionKey: PackageVersionKey]: CacheValue<string>
-  [mostRecentOccurrenceKey: MostRecentOccurrenceKey]: CacheValue<boolean>
+  [notifications: NotificationsKey]: CacheValue<string>
+  [notification: NotificationKey]: CacheValue<string>
+  [MostRecentOccurrenceKey: MostRecentOccurrenceKey]: CacheValue<boolean>
   [rateLimitKey: RateLimitKey]: CacheValue<number[]>
 }
 
@@ -85,28 +89,31 @@
   timeout?: number,
   config = cliKitStore(),
 ): Promise<CacheValueForKey<typeof key>> {
-  const cache: Cache = config.get('cache') || {}
-  const cached = cache[key]
+  const cached = cacheRetrieve(key, config)
 
   if (cached?.value !== undefined && (timeout === undefined || Date.now() - cached.timestamp < timeout)) {
     return cached.value
   }
 
   const value = await fn()
+  cacheStore(key, value, config)
+  return value
+}
+
+export function cacheStore(key: ExportedKey, value: string, config = cliKitStore()): void {
+  const cache: Cache = config.get('cache') || {}
   cache[key] = {value, timestamp: Date.now()}
   config.set('cache', cache)
-  return value
 }
 
 /**
  * Fetch from cache if already populated, otherwise return undefined.
  * @param key - The key to use for the cache.
- * @returns The value from the cache or the result of the function.
+ * @returns The chache element.
  */
-export function cacheRetrieve(key: ExportedKey, config = cliKitStore()): CacheValueForKey<typeof key> | undefined {
+export function cacheRetrieve(key: ExportedKey, config = cliKitStore()): CacheValue<string> | undefined {
   const cache: Cache = config.get('cache') || {}
-  const cached = cache[key]
-  return cached?.value
+  return cache[key]
 }
 
 export function cacheClear(config = cliKitStore()): void {
@@ -139,7 +146,7 @@
   task: () => Promise<void>,
   config = cliKitStore(),
 ): Promise<boolean> {
   const cache: Cache = config.get('cache') || {}
   const cacheKey: MostRecentOccurrenceKey = `most-recent-occurrence-${key}`
   const cached = cache[cacheKey]
 
@@ -190,7 +197,7 @@
  */
 export async function runWithRateLimit(options: RunWithRateLimitOptions, config = cliKitStore()): Promise<boolean> {
   const {key, limit, timeout, task} = options
   const cache: Cache = config.get('cache') || {}
   const cacheKey: RateLimitKey = `rate-limited-occurrences-${key}`
   const cached = cache[cacheKey]
   const now = Date.now()

packages/cli-kit/src/public/node/base-command.ts

@@ -8,6 +8,8 @@
 import {terminalSupportsPrompting} from './system.js'
 import {hashString} from './crypto.js'
 import {isTruthy} from './context/utilities.js'
+import {showNotificationsIfNeeded} from './notifications-system.js'
+import {setCurrentCommandId} from './global-context.js'
 import {JsonMap} from '../../private/common/json.js'
 import {underscore} from '../common/string.js'
 import {Command, Errors} from '@oclif/core'
@@ -45,11 +47,13 @@
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   protected async init(): Promise<any> {
     this.exitWithTimestampWhenEnvVariablePresent()
+    setCurrentCommandId(this.id || '')
     if (!isDevelopment()) {
       // This function runs just prior to `run`
       await registerCleanBugsnagErrorsFromWithinPlugins(this.config)
     }
     this.showNpmFlagWarning()
+    await showNotificationsIfNeeded()
     return super.init()
   }
 
@@ -148,7 +152,7 @@
     // Replace the original result with this one.
     const result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, [
       // Need to specify argv default because we're merging with argsFromEnvironment.
       ...(argv || this.argv),
       ...argsFromEnvironment<TFlags, TGlobalFlags, TArgs>(environment, options, noDefaultsResult),
     ])
 

packages/cli-kit/src/public/node/cli.ts

@@ -1,7 +1,7 @@
 import {isTruthy} from './context/utilities.js'
 import {printEventsJson} from '../../private/node/demo-recorder.js'
+import {cacheClear} from '../../private/node/conf-store.js'
 import {Flags} from '@oclif/core'
-// eslint-disable-next-line @shopify/cli/specific-imports-in-bootstrap-code
 import {fileURLToPath} from 'url'
 
 /**
@@ -202,3 +202,10 @@ export const globalFlags = {
     env: 'SHOPIFY_FLAG_VERBOSE',
   }),
 }
+
+/**
+ * Clear the CLI cache, used to store some API responses and handle notifications status
+ */
+export function clearCache(): void {
+  cacheClear()
+}

packages/cli-kit/src/public/node/global-context.ts

@@ -0,0 +1,35 @@
+export interface GlobalContext {
+  currentCommandId: string
+}
+
+let _globalContext: GlobalContext | undefined
+
+/**
+ * Get the global context.
+ *
+ * @returns Global context.
+ */
+function getGlobalContext(): GlobalContext {
+  if (!_globalContext) {
+    _globalContext = {currentCommandId: ''}
+  }
+  return _globalContext
+}
+
+/**
+ * Get the current command ID.
+ *
+ * @returns Current command ID.
+ */
+export function getCurrentCommandId(): string {
+  return getGlobalContext().currentCommandId
+}
+
+/**
+ * Set the current command ID.
+ *
+ * @param commandId - Command ID.
+ */
+export function setCurrentCommandId(commandId: string): void {
+  getGlobalContext().currentCommandId = commandId
+}

packages/cli-kit/src/public/node/node-package-manager.ts

@@ -288,7 +288,7 @@ export async function checkForNewVersion(
  */
 export function checkForCachedNewVersion(dependency: string, currentVersion: string): string | undefined {
   const cacheKey: PackageVersionKey = `npm-package-${dependency}`
-  const lastVersion = cacheRetrieve(cacheKey)
+  const lastVersion = cacheRetrieve(cacheKey)?.value
 
   if (lastVersion && new SemVer(currentVersion).compare(lastVersion) < 0) {
     return lastVersion