feat: migration helper scripts + docs (wip)

Resolves #211

docs/migrations.md

@@ -0,0 +1,10 @@
+# Migrations
+
+**Head Start uses DatoCMS migrations to develop CMS changes in isolation and ensure they can be reproduced.**
+
+
+Run
+
+```shell
+npm run cms:environment:create
+```

scripts/cms-apply-migration.ts

@@ -0,0 +1,4 @@
+import { execCommand } from './lib/exec-command';
+import { datocmsEnvironment } from '../datocms-environment';
+
+execCommand(`npx datocms migrations:run --destination=${datocmsEnvironment} --fast-fork`);

scripts/cms-create-environment.ts

@@ -0,0 +1,21 @@
+import { buildClient } from '@datocms/cma-client-node';
+import dotenv from 'dotenv-safe';
+import { execCommand } from './lib/exec-command';
+import { datocmsEnvironment } from '../datocms-environment';
+
+dotenv.config({
+  allowEmptyValues: Boolean(process.env.CI),
+});
+
+const getPrimaryEnvironment = async () => {
+  const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
+  const environments = await client.environments.list();
+  return environments.find(env => env.meta.primary)?.id;
+};
+
+async function run() {
+  const sourceEnv = await getPrimaryEnvironment();
+  execCommand(`npx datocms environments:fork ${sourceEnv} ${datocmsEnvironment} --fast`);
+}
+
+run();

scripts/cms-create-migration.ts

@@ -0,0 +1,4 @@
+import { execCommand } from './lib/exec-command';
+import { datocmsEnvironment } from '../datocms-environment';
+
+execCommand(`npx datocms migrations:new --autogenerate=${datocmsEnvironment} ${datocmsEnvironment}`);

scripts/cms-destroy-environment.ts

@@ -0,0 +1,4 @@
+import { execCommand } from './lib/exec-command';
+import { datocmsEnvironment } from '../datocms-environment';
+
+execCommand(`npx datocms environments:destroy ${datocmsEnvironment}`);

scripts/lib/exec-command.ts

@@ -0,0 +1,12 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+
+export const execCommand = async (command: string) => {
+  const execAsync = promisify(exec);
+  try {
+    const { stdout } = await execAsync(command);
+    console.log(stdout);
+  } catch (error) {
+    console.error(error);
+  }
+};