create-nextblock 0.2.78 → 0.8.0

package/templates/nextblock-template/scripts/verify-cortex-ai-global-tools.ts

@@ -0,0 +1,537 @@
+import assert from 'node:assert/strict';
+
+import {
+  executeReadCurrentCmsItem,
+  executeSearchDocumentation,
+  executeUpdateContentBlock,
+  executeUpdateCurrentCmsFields,
+  executeUpdateFooter,
+  executeUpdateNavigationBar,
+  executeUpdateSectionColumnBlock,
+} from '../lib/ai-global-agent-tools';
+
+type MockRow = Record<string, any>;
+
+type MockDatabase = {
+  blocks: MockRow[];
+  currencies: MockRow[];
+  languages: MockRow[];
+  navigation_items: MockRow[];
+  pages: MockRow[];
+  posts: MockRow[];
+  products: MockRow[];
+  site_settings: MockRow[];
+};
+
+class MockQuery {
+  private filters: Array<{ column: string; value: unknown }> = [];
+  private limitCount: number | null = null;
+  private operation: 'delete' | 'insert' | 'select' | 'update' | 'upsert' = 'select';
+  private payload: MockRow | MockRow[] | null = null;
+
+  constructor(
+    private readonly database: MockDatabase,
+    private readonly table: keyof MockDatabase
+  ) {}
+
+  select() {
+    return this;
+  }
+
+  eq(column: string, value: unknown) {
+    this.filters.push({ column, value });
+    return this;
+  }
+
+  limit(count: number) {
+    this.limitCount = count;
+    return this;
+  }
+
+  delete() {
+    this.operation = 'delete';
+    return this;
+  }
+
+  insert(payload: MockRow | MockRow[]) {
+    this.operation = 'insert';
+    this.payload = payload;
+    return this;
+  }
+
+  update(payload: MockRow) {
+    this.operation = 'update';
+    this.payload = payload;
+    return this;
+  }
+
+  upsert(payload: MockRow | MockRow[]) {
+    this.operation = 'upsert';
+    this.payload = payload;
+    return this;
+  }
+
+  order() {
+    return this;
+  }
+
+  maybeSingle() {
+    return this.execute().then((result) => ({
+      data: result.data?.[0] ?? null,
+      error: result.error,
+    }));
+  }
+
+  single() {
+    return this.execute().then((result) => ({
+      data: Array.isArray(result.data) ? result.data[0] : result.data,
+      error: result.error,
+    }));
+  }
+
+  then<TResult1 = any, TResult2 = never>(
+    onfulfilled?: ((value: any) => TResult1 | PromiseLike<TResult1>) | null,
+    onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null
+  ) {
+    return this.execute().then(onfulfilled, onrejected);
+  }
+
+  private matchesFilters(row: MockRow) {
+    return this.filters.every((filter) => row[filter.column] === filter.value);
+  }
+
+  private async execute() {
+    if (this.operation === 'delete') {
+      this.database[this.table] = this.database[this.table].filter(
+        (row) => !this.matchesFilters(row)
+      );
+      return { data: null, error: null };
+    }
+
+    if (this.operation === 'insert') {
+      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
+      const inserted = rows.filter(Boolean).map((row) => {
+        const nextId =
+          this.database[this.table].reduce(
+            (max, current) => Math.max(max, Number(current.id) || 0),
+            0
+          ) + 1;
+        return { id: nextId, ...row };
+      });
+      this.database[this.table].push(...inserted);
+      return { data: inserted, error: null };
+    }
+
+    if (this.operation === 'update') {
+      const payload = Array.isArray(this.payload) ? this.payload[0] : this.payload;
+      const updated: MockRow[] = [];
+
+      this.database[this.table] = this.database[this.table].map((row) => {
+        if (!this.matchesFilters(row)) {
+          return row;
+        }
+
+        const nextRow = { ...row, ...payload };
+        updated.push(nextRow);
+        return nextRow;
+      });
+
+      return { data: updated, error: null };
+    }
+
+    if (this.operation === 'upsert') {
+      const rows = Array.isArray(this.payload) ? this.payload : [this.payload];
+      rows.filter(Boolean).forEach((row) => {
+        const existingIndex = this.database[this.table].findIndex(
+          (current) => current.key && current.key === row.key
+        );
+
+        if (existingIndex >= 0) {
+          this.database[this.table][existingIndex] = {
+            ...this.database[this.table][existingIndex],
+            ...row,
+          };
+        } else {
+          this.database[this.table].push(row);
+        }
+      });
+      return { data: rows, error: null };
+    }
+
+    let data = this.database[this.table].filter((row) => this.matchesFilters(row));
+
+    if (this.limitCount !== null) {
+      data = data.slice(0, this.limitCount);
+    }
+
+    return { data, error: null };
+  }
+}
+
+function createMockSupabase(database: MockDatabase) {
+  return {
+    from: (table: string) => {
+      if (!(table in database)) {
+        throw new Error(`Unexpected mock table: ${table}`);
+      }
+
+      return new MockQuery(database, table as keyof MockDatabase);
+    },
+  };
+}
+
+async function executeConfirmed(
+  executor: (input: any, context?: any) => Promise<any>,
+  input: any,
+  context: any = {}
+) {
+  const preview = await executor(input, context);
+
+  assert.equal(preview.success, true);
+  assert.equal(preview.requiresConfirmation, true);
+  assert.equal(preview.mutationExecuted, false);
+  assert.match(preview.confirmationPhrase, /^CONFIRM .+ #[a-f0-9]{8}$/);
+
+  return executor(input, {
+    ...context,
+    latestUserMessage: preview.confirmationPhrase,
+  });
+}
+
+async function main() {
+  const database: MockDatabase = {
+    blocks: [
+      {
+        block_type: 'text',
+        content: { html_content: '<p>Old page text</p>' },
+        id: 10,
+        language_id: 1,
+        order: 0,
+        page_id: 1,
+        post_id: null,
+      },
+      {
+        block_type: 'section',
+        content: {
+          background: { type: 'none' },
+          column_blocks: [
+            [
+              {
+                block_type: 'text',
+                content: { html_content: '<p>Old nested text</p>' },
+              },
+            ],
+          ],
+          column_gap: 'md',
+          container_type: 'container',
+          padding: { bottom: 'md', top: 'md' },
+          responsive_columns: { desktop: 1, mobile: 1, tablet: 1 },
+        },
+        id: 11,
+        language_id: 1,
+        order: 1,
+        page_id: 1,
+        post_id: null,
+      },
+    ],
+    currencies: [{ code: 'USD', id: 1, is_active: true, is_default: true }],
+    languages: [
+      { code: 'en', id: 1, is_active: true, name: 'English' },
+      { code: 'fr', id: 2, is_active: true, name: 'French' },
+    ],
+    navigation_items: [
+      { id: 1, label: 'Old', language_id: 1, menu_key: 'HEADER', order: 0, url: '/old' },
+      { id: 3, label: 'Ancien', language_id: 2, menu_key: 'HEADER', order: 0, url: '/ancien' },
+      { id: 2, label: 'Old Footer', language_id: 1, menu_key: 'FOOTER', order: 0, url: '/old' },
+    ],
+    pages: [
+      {
+        id: 1,
+        meta_description: 'CMS setup, editor blocks, and Supabase auth.',
+        slug: 'docs/setup',
+        status: 'published',
+        title: 'Setup Guide',
+      },
+    ],
+    posts: [
+      {
+        excerpt: 'Use Supabase auth with profiles and roles in NextBlock.',
+        id: 1,
+        meta_description: null,
+        slug: 'supabase-auth-guide',
+        status: 'published',
+        subtitle: null,
+        title: 'Supabase Auth Guide',
+      },
+    ],
+    products: [
+      {
+        description_json: null,
+        id: 'prod_1',
+        language_id: 1,
+        meta_description: null,
+        meta_title: null,
+        short_description: 'Old short description',
+        slug: 'studio-tee',
+        status: 'draft',
+        title: 'Studio Tee',
+      },
+    ],
+    site_settings: [{ key: 'footer_copyright', value: { en: 'Old' } }],
+  };
+  const supabase = createMockSupabase(database);
+
+  const headerResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: '/contact' },
+      ],
+      languageCode: 'en',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(headerResult.success, true);
+  assert.equal(headerResult.insertedCount, 1);
+  assert.equal(headerResult.skippedCount, 0);
+  assert.equal(
+    database.navigation_items.filter(
+      (item) => item.menu_key === 'HEADER' && item.language_id === 1
+    ).length,
+    2
+  );
+  assert.equal(
+    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/old'),
+    true
+  );
+  assert.equal(
+    database.navigation_items.some((item) => item.menu_key === 'HEADER' && item.url === '/contact'),
+    true
+  );
+
+  const duplicateHeaderResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: '/contact' },
+      ],
+      languageCode: 'en',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(duplicateHeaderResult.success, true);
+  assert.equal(duplicateHeaderResult.insertedCount, 0);
+  assert.equal(duplicateHeaderResult.skippedCount, 1);
+
+  const frenchHeaderResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Contact', url: 'mailto:info@nextblock.dev' },
+      ],
+      languageCode: 'French',
+      mode: 'append',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(frenchHeaderResult.success, true);
+  assert.equal(frenchHeaderResult.languageCode, 'fr');
+  assert.equal(frenchHeaderResult.insertedCount, 1);
+  assert.equal(
+    database.navigation_items.some(
+      (item) =>
+        item.menu_key === 'HEADER' &&
+        item.language_id === 2 &&
+        item.url === 'mailto:info@nextblock.dev'
+    ),
+    true
+  );
+
+  const frenchRenameResult = await executeConfirmed(
+    executeUpdateNavigationBar,
+    {
+      items: [
+        { label: 'Nous Contacter', url: 'mailto:info@nextblock.dev' },
+      ],
+      languageCode: 'French',
+      match: { label: 'Contact' },
+      mode: 'update',
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(frenchRenameResult.success, true);
+  assert.equal(frenchRenameResult.languageCode, 'fr');
+  assert.equal(frenchRenameResult.updatedCount, 1);
+  assert.equal(
+    database.navigation_items.some(
+      (item) =>
+        item.menu_key === 'HEADER' &&
+        item.language_id === 2 &&
+        item.label === 'Nous Contacter' &&
+        item.url === 'mailto:info@nextblock.dev'
+    ),
+    true
+  );
+  assert.equal(
+    database.navigation_items.some(
+      (item) => item.menu_key === 'HEADER' && item.language_id === 2 && item.url === '/ancien'
+    ),
+    true
+  );
+
+  await assert.rejects(
+    () =>
+      executeUpdateNavigationBar(
+        {
+          items: [
+            { label: 'Only Link', url: '/only' },
+          ],
+          languageCode: 'fr',
+          mode: 'replace',
+        },
+        { revalidatePath: () => undefined, supabase }
+      ),
+    /Refusing destructive HEADER navigation replacement/
+  );
+
+  const footerResult = await executeConfirmed(
+    executeUpdateFooter,
+    {
+      copyright: { en: '(c) {year} NextBlock. All rights reserved.' },
+      languageCode: 'en',
+      links: [{ label: 'Privacy', url: '/privacy' }],
+    },
+    { revalidatePath: () => undefined, supabase }
+  );
+
+  assert.equal(footerResult.success, true);
+  assert.equal(footerResult.footerNavigation?.insertedCount, 1);
+  assert.deepEqual(database.site_settings[0]?.value, {
+    en: '(c) {year} NextBlock. All rights reserved.',
+  });
+
+  const searchResult = await executeSearchDocumentation(
+    { limit: 2, query: 'Supabase auth' },
+    { supabase }
+  );
+
+  assert.equal(searchResult.success, true);
+  assert.equal(searchResult.results[0]?.title, 'Supabase Auth Guide');
+  assert.equal(searchResult.results[1]?.title, 'Setup Guide');
+
+  const readCurrentResult = await executeReadCurrentCmsItem(
+    { includeBlockContent: false, includeBlocks: true },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup', title: 'Setup Guide' },
+      supabase,
+    }
+  );
+
+  assert.equal(readCurrentResult.success, true);
+  assert.equal(readCurrentResult.blocks.length, 2);
+  assert.equal(readCurrentResult.blocks[0]?.blockType, 'text');
+  assert.equal(readCurrentResult.blocks[0]?.content, undefined);
+
+  const updatedBlockResult = await executeConfirmed(
+    executeUpdateContentBlock,
+    {
+      blockId: 10,
+      blockType: 'text',
+      content: { html_content: '<p>Updated page text</p>' },
+    },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(updatedBlockResult.success, true);
+  assert.deepEqual(database.blocks.find((block) => block.id === 10)?.content, {
+    html_content: '<p>Updated page text</p>',
+  });
+
+  await assert.rejects(
+    () =>
+      executeUpdateContentBlock(
+        {
+          blockId: 10,
+          blockType: 'text',
+          content: { html_content: '<p>Wrong page</p>' },
+        },
+        {
+          pageContext: { contentType: 'page', entityId: 2 },
+          supabase,
+        }
+      ),
+    /does not belong to the current page/
+  );
+
+  const nestedBlockResult = await executeConfirmed(
+    executeUpdateSectionColumnBlock,
+    {
+      blockIndex: 0,
+      blockType: 'text',
+      columnIndex: 0,
+      content: { html_content: '<p>Updated nested text</p>' },
+      parentBlockId: 11,
+    },
+    {
+      pageContext: { contentType: 'page', entityId: 1, slug: 'docs/setup' },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(nestedBlockResult.success, true);
+  assert.deepEqual(database.blocks.find((block) => block.id === 11)?.content.column_blocks[0][0].content, {
+    html_content: '<p>Updated nested text</p>',
+  });
+
+  const productDescriptionJson = {
+    content: [
+      {
+        content: [{ text: 'A Studio Tee description.', type: 'text' }],
+        type: 'paragraph',
+      },
+    ],
+    type: 'doc',
+  };
+  const productFieldResult = await executeConfirmed(
+    executeUpdateCurrentCmsFields,
+    {
+      fields: {
+        description_json: productDescriptionJson,
+        short_description: 'Soft cotton tee for Cortex AI builders.',
+        status: 'active',
+      },
+    },
+    {
+      pageContext: {
+        contentType: 'product',
+        entityId: 'prod_1',
+        slug: 'studio-tee',
+        title: 'Studio Tee',
+      },
+      revalidatePath: () => undefined,
+      supabase,
+    }
+  );
+
+  assert.equal(productFieldResult.success, true);
+  assert.equal(database.products[0].status, 'active');
+  assert.deepEqual(database.products[0].description_json, productDescriptionJson);
+
+  console.log('Cortex AI global tool verifier passed.');
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});

package/templates/nextblock-template/scripts/verify-cortex-ai-routing.ts

@@ -0,0 +1,58 @@
+import dotenv from 'dotenv';
+
+import {
+  CORTEX_AI_OPENROUTER_FREE_ROUTER_MODEL,
+  generateCortexAiText,
+} from '../lib/ai-client';
+
+dotenv.config({ path: '.env.local' });
+
+const prompt =
+  'Reply with exactly the text: NextBlock Cortex AI routing verification complete.';
+
+function parseMode() {
+  const modeArg = process.argv.find((arg) => arg.startsWith('--mode='));
+  const mode = modeArg?.split('=')[1] || 'both';
+
+  if (!['both', 'byok', 'free'].includes(mode)) {
+    throw new Error('Use --mode=both, --mode=byok, or --mode=free.');
+  }
+
+  return mode as 'both' | 'byok' | 'free';
+}
+
+async function runCheck(label: string, modelId?: string) {
+  const response = await generateCortexAiText({
+    maxOutputTokens: 32,
+    modelId,
+    prompt,
+    temperature: 0,
+  });
+
+  console.log(`\n${label}`);
+  console.log(`credentialSource=${response.credentialSource}`);
+  console.log(`modelId=${response.modelId}`);
+  console.log(
+    `attempts=${response.attempts
+      .map((attempt) => `${attempt.modelId}:${attempt.status}`)
+      .join(',')}`
+  );
+  console.log(`text=${response.result.text.trim()}`);
+}
+
+async function main() {
+  const mode = parseMode();
+
+  if (mode === 'both' || mode === 'byok') {
+    await runCheck('BYOK or env credential check');
+  }
+
+  if (mode === 'both' || mode === 'free') {
+    await runCheck('Zero-cost free-router fallback check', CORTEX_AI_OPENROUTER_FREE_ROUTER_MODEL);
+  }
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});