feat(cli): setup live-queries (#1208)

Adds CLI command `yarn cedar setup live-queries` to configure Postgres
LISTEN/NOTIFY-based live query invalidation. Creates database triggers
that send notifications on table changes, and a Node.js listener that
invalidates live query cache keys.

Author: Tobbe

packages/cli/src/commands/setup.ts

@@ -19,6 +19,8 @@ import * as setupI18n from './setup/i18n/i18n.js'
 // @ts-expect-error - Types not available for JS files
 import * as setupJobs from './setup/jobs/jobs.js'
 // @ts-expect-error - Types not available for JS files
+import * as setupLiveQueries from './setup/live-queries/liveQueries.js'
+// @ts-expect-error - Types not available for JS files
 import * as setupMailer from './setup/mailer/mailer.js'
 import * as setupMiddleware from './setup/middleware/middleware.js'
 import * as setupMonitoring from './setup/monitoring/monitoring.js'
@@ -50,6 +52,7 @@ export const builder = (yargs: Argv) =>
     .command(setupGraphql)
     .command(setupI18n)
     .command(setupJobs)
+    .command(setupLiveQueries)
     .command(setupMailer)
     // @ts-expect-error - Yargs TS types aren't very good
     .command(setupMiddleware)

packages/cli/src/commands/setup/live-queries/liveQueries.js

@@ -0,0 +1,33 @@
+import { recordTelemetryAttributes } from '@cedarjs/cli-helpers'
+
+export const command = 'live-queries'
+
+export const description =
+  'Setup live query invalidation with Postgres notifications'
+
+export function builder(yargs) {
+  yargs
+    .option('force', {
+      alias: 'f',
+      default: false,
+      description: 'Overwrite existing configuration',
+      type: 'boolean',
+    })
+    .option('verbose', {
+      alias: 'v',
+      default: false,
+      description: 'Print more logs',
+      type: 'boolean',
+    })
+}
+
+export async function handler(options) {
+  recordTelemetryAttributes({
+    command: 'setup live-queries',
+    force: options.force,
+    verbose: options.verbose,
+  })
+
+  const { handler } = await import('./liveQueriesHandler.js')
+  return handler(options)
+}