create-nextblock 0.16.1 → 0.16.3

package/templates/nextblock-template/scripts/validate-editor-block-schema.ts

@@ -1,112 +1,112 @@
-/* eslint-disable @nx/enforce-module-boundaries */
-import dotenv from 'dotenv';
-import { createClient } from '@supabase/supabase-js';
-import { toJSONSchema } from 'zod';
-import {
-  editorBlockDocumentSchema,
-  editorGeneratedBlockDocumentSchema,
-  getEditorBlocksJsonSchema,
-} from '../../../libs/utils/src/lib/editor-blocks';
-
-dotenv.config({ path: '.env.local' });
-
-const seededProductDescriptionSample = {
-  type: 'doc',
-  content: [
-    {
-      type: 'heading',
-      attrs: { level: 2 },
-      content: [{ type: 'text', text: 'Studio uniform for shipping days' }],
-    },
-    {
-      type: 'paragraph',
-      content: [
-        {
-          type: 'text',
-          text: 'The NextBlock Studio Tee is cut from premium heavyweight cotton.',
-        },
-      ],
-    },
-    {
-      type: 'bulletList',
-      content: [
-        {
-          type: 'listItem',
-          content: [
-            {
-              type: 'paragraph',
-              content: [{ type: 'text', text: 'Heavyweight cotton feel.' }],
-            },
-          ],
-        },
-      ],
-    },
-  ],
-};
-
-async function readDatabaseSample() {
-  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
-  const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
-
-  if (!supabaseUrl || !serviceRoleKey) {
-    return null;
-  }
-
-  const supabase = createClient(supabaseUrl, serviceRoleKey, {
-    auth: {
-      autoRefreshToken: false,
-      persistSession: false,
-    },
-  });
-
-  const { data, error } = await supabase
-    .from('products')
-    .select('id, slug, description_json')
-    .not('description_json', 'is', null)
-    .limit(1)
-    .maybeSingle();
-
-  if (error) {
-    throw new Error(`Failed to read product description_json sample: ${error.message}`);
-  }
-
-  return data;
-}
-
-async function main() {
-  if (process.argv.includes('--generated-schema-diagnostics')) {
-    const jsonSchema = toJSONSchema(editorGeneratedBlockDocumentSchema, {
-      cycles: 'ref',
-      reused: 'ref',
-      target: 'draft-07',
-    });
-    const schemaText = JSON.stringify(jsonSchema);
-    console.log(`Generated schema propertyNames occurrences=${schemaText.match(/propertyNames/g)?.length || 0}`);
-    console.log(`Generated schema size=${schemaText.length}`);
-    const propertyNamesIndex = schemaText.indexOf('propertyNames');
-    if (propertyNamesIndex >= 0) {
-      console.log(schemaText.slice(Math.max(0, propertyNamesIndex - 240), propertyNamesIndex + 240));
-    }
-    return;
-  }
-
-  const databaseSample = await readDatabaseSample();
-  const sample = databaseSample?.description_json || seededProductDescriptionSample;
-  const parsed = editorBlockDocumentSchema.parse(sample);
-  const jsonSchema = getEditorBlocksJsonSchema();
-
-  console.log('Editor block schema validation succeeded.');
-  console.log(
-    databaseSample
-      ? `Sample source=products.description_json slug=${databaseSample.slug}`
-      : 'Sample source=seeded product description fallback'
-  );
-  console.log(`Root type=${parsed.type}`);
-  console.log(`Top-level blocks=${parsed.content?.length || 0}`);
-  console.log(`JSON Schema keys=${Object.keys(jsonSchema as Record<string, unknown>).join(',')}`);
-}
-
-main().catch((error) => {
-  console.error(error instanceof Error ? error.message : error);
-  process.exitCode = 1;
-});
+/* eslint-disable @nx/enforce-module-boundaries */
+import dotenv from 'dotenv';
+import { createClient } from '@supabase/supabase-js';
+import { toJSONSchema } from 'zod';
+import {
+  editorBlockDocumentSchema,
+  editorGeneratedBlockDocumentSchema,
+  getEditorBlocksJsonSchema,
+} from '../../../libs/utils/src/lib/editor-blocks';
+
+dotenv.config({ path: '.env.local' });
+
+const seededProductDescriptionSample = {
+  type: 'doc',
+  content: [
+    {
+      type: 'heading',
+      attrs: { level: 2 },
+      content: [{ type: 'text', text: 'Studio uniform for shipping days' }],
+    },
+    {
+      type: 'paragraph',
+      content: [
+        {
+          type: 'text',
+          text: 'The NextBlock Studio Tee is cut from premium heavyweight cotton.',
+        },
+      ],
+    },
+    {
+      type: 'bulletList',
+      content: [
+        {
+          type: 'listItem',
+          content: [
+            {
+              type: 'paragraph',
+              content: [{ type: 'text', text: 'Heavyweight cotton feel.' }],
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+
+async function readDatabaseSample() {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const serviceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+
+  if (!supabaseUrl || !serviceRoleKey) {
+    return null;
+  }
+
+  const supabase = createClient(supabaseUrl, serviceRoleKey, {
+    auth: {
+      autoRefreshToken: false,
+      persistSession: false,
+    },
+  });
+
+  const { data, error } = await supabase
+    .from('products')
+    .select('id, slug, description_json')
+    .not('description_json', 'is', null)
+    .limit(1)
+    .maybeSingle();
+
+  if (error) {
+    throw new Error(`Failed to read product description_json sample: ${error.message}`);
+  }
+
+  return data;
+}
+
+async function main() {
+  if (process.argv.includes('--generated-schema-diagnostics')) {
+    const jsonSchema = toJSONSchema(editorGeneratedBlockDocumentSchema, {
+      cycles: 'ref',
+      reused: 'ref',
+      target: 'draft-07',
+    });
+    const schemaText = JSON.stringify(jsonSchema);
+    console.log(`Generated schema propertyNames occurrences=${schemaText.match(/propertyNames/g)?.length || 0}`);
+    console.log(`Generated schema size=${schemaText.length}`);
+    const propertyNamesIndex = schemaText.indexOf('propertyNames');
+    if (propertyNamesIndex >= 0) {
+      console.log(schemaText.slice(Math.max(0, propertyNamesIndex - 240), propertyNamesIndex + 240));
+    }
+    return;
+  }
+
+  const databaseSample = await readDatabaseSample();
+  const sample = databaseSample?.description_json || seededProductDescriptionSample;
+  const parsed = editorBlockDocumentSchema.parse(sample);
+  const jsonSchema = getEditorBlocksJsonSchema();
+
+  console.log('Editor block schema validation succeeded.');
+  console.log(
+    databaseSample
+      ? `Sample source=products.description_json slug=${databaseSample.slug}`
+      : 'Sample source=seeded product description fallback'
+  );
+  console.log(`Root type=${parsed.type}`);
+  console.log(`Top-level blocks=${parsed.content?.length || 0}`);
+  console.log(`JSON Schema keys=${Object.keys(jsonSchema as Record<string, unknown>).join(',')}`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/templates/nextblock-template/tailwind.config.js

@@ -1,25 +1,25 @@
-const { existsSync } = require('fs');
-const { join } = require('path');
-
-/** @type {import('tailwindcss').Config} */
-module.exports = {
-  // eslint-disable-next-line @nx/enforce-module-boundaries
-  presets: [require('../../libs/ui/tailwind.config.js')],
-  content: (() => {
-    const projectGlobs = [
-      join(
-        __dirname,
-        '{src,pages,components,app,lib}/**/*!(*.stories|*.spec).{ts,tsx,js,jsx,md,mdx,html}',
-      ),
-    ];
-    const libsDir = join(__dirname, '../../libs');
-    if (existsSync(libsDir)) {
-      projectGlobs.push(join(libsDir, '**/*.{ts,tsx,js,jsx,md,mdx,html,sql}'));
-    }
-    return projectGlobs;
-  })(),
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-};
+const { existsSync } = require('fs');
+const { join } = require('path');
+
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  // eslint-disable-next-line @nx/enforce-module-boundaries
+  presets: [require('../../libs/ui/tailwind.config.js')],
+  content: (() => {
+    const projectGlobs = [
+      join(
+        __dirname,
+        '{src,pages,components,app,lib}/**/*!(*.stories|*.spec).{ts,tsx,js,jsx,md,mdx,html}',
+      ),
+    ];
+    const libsDir = join(__dirname, '../../libs');
+    if (existsSync(libsDir)) {
+      projectGlobs.push(join(libsDir, '**/*.{ts,tsx,js,jsx,md,mdx,html,sql}'));
+    }
+    return projectGlobs;
+  })(),
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/templates/nextblock-template/tools/build-migrate.mjs

@@ -1,102 +1,102 @@
-// Environment-aware, zero-config build-time schema migration hook.
-//
-// Runs BEFORE `next build` (wired in apps/nextblock/project.json for nx/Vercel and in
-// the app's `prebuild` script for standalone/Docker `npm run build`). It applies any
-// pending, forward-only migrations to the tenant's Postgres so the deployed app and its
-// schema move together — additively, transactionally, and tracked exactly like the
-// Supabase CLI in supabase_migrations.schema_migrations.
-//
-// Gating (no manual config required):
-//   * On Vercel: run only when VERCEL_ENV === 'production'. Preview/development builds
-//     are skipped so feature previews never touch live data structures.
-//   * Off Vercel (npm create / local / Docker): run only when NEXTBLOCK_BUILD_MIGRATE === '1'
-//     (the /setup wizard and the create/docker setup scripts write this into .env).
-//
-// Safety: this NEVER fails the build. A missing flag, a missing connection string, an
-// unreachable database — or even a broken ./lib/migrate-core.mjs — logs a warning and
-// exits 0 so static packaging always proceeds. That is why the engine is loaded with a
-// guarded dynamic import rather than a top-level one: an unresolvable top-level import
-// is a hard ESM error that no try/catch inside main() could contain.
-//
-// The engine itself (discovery + the two backends) lives in ./lib/migrate-core.mjs and is
-// shared with `npm run update` (tools/update.mjs), so the two can no longer drift.
-
-const log = (msg) => console.log(`[build-migrate] ${msg}`);
-
-/** Decide whether the hook should run, with a human-readable reason for the log. */
-function evaluateGate() {
-  const vercelEnv = process.env.VERCEL_ENV;
-  if (vercelEnv) {
-    return vercelEnv === 'production'
-      ? { run: true, reason: 'VERCEL_ENV=production' }
-      : { run: false, reason: `VERCEL_ENV=${vercelEnv} — preview/development build, skipping` };
-  }
-  if (process.env.NEXTBLOCK_BUILD_MIGRATE === '1') {
-    return { run: true, reason: 'NEXTBLOCK_BUILD_MIGRATE=1' };
-  }
-  return { run: false, reason: 'NEXTBLOCK_BUILD_MIGRATE is not set — skipping' };
-}
-
-async function main() {
-  let core;
-  try {
-    core = await import('./lib/migrate-core.mjs');
-  } catch (err) {
-    log(`WARNING: could not load the migration engine: ${err?.message ?? err}.`);
-    log('Continuing the build — apply later with "npm run update".');
-    return;
-  }
-
-  // Load .env BEFORE the gate: off Vercel, NEXTBLOCK_BUILD_MIGRATE is never a real process
-  // env var — it lives in .env.local / .env, written there by the /setup wizard and the
-  // create/docker setup scripts. Evaluating the gate first would read `undefined` and
-  // silently skip every build-time migration on standalone and local installs.
-  await core.loadEnvFiles(process.cwd());
-
-  const gate = evaluateGate();
-  if (!gate.run) {
-    log(`Skipping build-time migrations (${gate.reason}).`);
-    return;
-  }
-  log(`Build-time migrations enabled (${gate.reason}).`);
-
-  const backend = core.describeBackend();
-  if (backend.kind === 'none') {
-    log(`No database connection is configured (${backend.detail}) — skipping.`);
-    log('Apply the schema with the /setup wizard or "npm run update".');
-    return;
-  }
-
-  const { files, sources } = core.collectMigrations(process.cwd());
-  if (files.length === 0) {
-    log('Could not locate any migrations — skipping.');
-    return;
-  }
-  for (const source of sources) {
-    if (source.contributed > 0) {
-      log(`Using ${source.contributed} migration(s) from the ${source.label} copy (${source.dir}).`);
-    }
-  }
-
-  const result = await core.applyMigrations(files);
-  if (result.ok) {
-    log(
-      result.applied > 0
-        ? `Applied ${result.applied} pending migration(s) via ${result.backend}.`
-        : 'Schema already up to date.',
-    );
-  } else {
-    log(`WARNING: could not apply migrations: ${result.error}.`);
-    log('Continuing the build — apply later with "npm run update".');
-  }
-}
-
-// Guarantee a clean exit code regardless of outcome: infrastructure issues must never
-// break web packaging.
-main()
-  .catch((err) => {
-    log(`WARNING: ${err instanceof Error ? err.message : String(err)}.`);
-  })
-  .finally(() => {
-    process.exit(0);
-  });
+// Environment-aware, zero-config build-time schema migration hook.
+//
+// Runs BEFORE `next build` (wired in apps/nextblock/project.json for nx/Vercel and in
+// the app's `prebuild` script for standalone/Docker `npm run build`). It applies any
+// pending, forward-only migrations to the tenant's Postgres so the deployed app and its
+// schema move together — additively, transactionally, and tracked exactly like the
+// Supabase CLI in supabase_migrations.schema_migrations.
+//
+// Gating (no manual config required):
+//   * On Vercel: run only when VERCEL_ENV === 'production'. Preview/development builds
+//     are skipped so feature previews never touch live data structures.
+//   * Off Vercel (npm create / local / Docker): run only when NEXTBLOCK_BUILD_MIGRATE === '1'
+//     (the /setup wizard and the create/docker setup scripts write this into .env).
+//
+// Safety: this NEVER fails the build. A missing flag, a missing connection string, an
+// unreachable database — or even a broken ./lib/migrate-core.mjs — logs a warning and
+// exits 0 so static packaging always proceeds. That is why the engine is loaded with a
+// guarded dynamic import rather than a top-level one: an unresolvable top-level import
+// is a hard ESM error that no try/catch inside main() could contain.
+//
+// The engine itself (discovery + the two backends) lives in ./lib/migrate-core.mjs and is
+// shared with `npm run update` (tools/update.mjs), so the two can no longer drift.
+
+const log = (msg) => console.log(`[build-migrate] ${msg}`);
+
+/** Decide whether the hook should run, with a human-readable reason for the log. */
+function evaluateGate() {
+  const vercelEnv = process.env.VERCEL_ENV;
+  if (vercelEnv) {
+    return vercelEnv === 'production'
+      ? { run: true, reason: 'VERCEL_ENV=production' }
+      : { run: false, reason: `VERCEL_ENV=${vercelEnv} — preview/development build, skipping` };
+  }
+  if (process.env.NEXTBLOCK_BUILD_MIGRATE === '1') {
+    return { run: true, reason: 'NEXTBLOCK_BUILD_MIGRATE=1' };
+  }
+  return { run: false, reason: 'NEXTBLOCK_BUILD_MIGRATE is not set — skipping' };
+}
+
+async function main() {
+  let core;
+  try {
+    core = await import('./lib/migrate-core.mjs');
+  } catch (err) {
+    log(`WARNING: could not load the migration engine: ${err?.message ?? err}.`);
+    log('Continuing the build — apply later with "npm run update".');
+    return;
+  }
+
+  // Load .env BEFORE the gate: off Vercel, NEXTBLOCK_BUILD_MIGRATE is never a real process
+  // env var — it lives in .env.local / .env, written there by the /setup wizard and the
+  // create/docker setup scripts. Evaluating the gate first would read `undefined` and
+  // silently skip every build-time migration on standalone and local installs.
+  await core.loadEnvFiles(process.cwd());
+
+  const gate = evaluateGate();
+  if (!gate.run) {
+    log(`Skipping build-time migrations (${gate.reason}).`);
+    return;
+  }
+  log(`Build-time migrations enabled (${gate.reason}).`);
+
+  const backend = core.describeBackend();
+  if (backend.kind === 'none') {
+    log(`No database connection is configured (${backend.detail}) — skipping.`);
+    log('Apply the schema with the /setup wizard or "npm run update".');
+    return;
+  }
+
+  const { files, sources } = core.collectMigrations(process.cwd());
+  if (files.length === 0) {
+    log('Could not locate any migrations — skipping.');
+    return;
+  }
+  for (const source of sources) {
+    if (source.contributed > 0) {
+      log(`Using ${source.contributed} migration(s) from the ${source.label} copy (${source.dir}).`);
+    }
+  }
+
+  const result = await core.applyMigrations(files);
+  if (result.ok) {
+    log(
+      result.applied > 0
+        ? `Applied ${result.applied} pending migration(s) via ${result.backend}.`
+        : 'Schema already up to date.',
+    );
+  } else {
+    log(`WARNING: could not apply migrations: ${result.error}.`);
+    log('Continuing the build — apply later with "npm run update".');
+  }
+}
+
+// Guarantee a clean exit code regardless of outcome: infrastructure issues must never
+// break web packaging.
+main()
+  .catch((err) => {
+    log(`WARNING: ${err instanceof Error ? err.message : String(err)}.`);
+  })
+  .finally(() => {
+    process.exit(0);
+  });