Kiirkäivitus

Postitus skeemide kohta

Loo tüübiturvalisi Zodi skeeme

See funktsioon võimaldab saada oma komponentide kirjelduse tüübiturvalise Zodi skeemi kujul, pakkudes:

TypeScripti-keskne skeemivalideerimine
Statiline tüübituletus

Lisateave: https://zod.dev

Seadistamine

Et Zodi skeemi alla laadida, tee järgmist:

Laadi vajalikud sõltuvused
Loo skript, kasutades cms-rendereri tööriistu

Projekti struktuur

apps/
  web/
    app/
      page.tsx
    scripts/
      generated-schema.ts   # skriptifail

Skript: `generated-schema.ts`

import { fetchAllCustomSchemaFields, saveZodSchemaCode } from 'cms-renderer/lib/custom-schemas';
import { cmsConfig } from '../lib/cms-config';

async function main() {
  const { cmsUrl, websiteId, apiKey } = cmsConfig;

  if (!cmsUrl) {
    throw new Error(
      '[generate-schemas] NEXT_PUBLIC_CMS_API_URL ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  if (!websiteId) {
    throw new Error(
      '[generate-schemas] CMS_WEBSITE_ID ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  if (!apiKey) {
    throw new Error(
      '[generate-schemas] PROFOUND_API_KEY ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  const schemas = await fetchAllCustomSchemaFields({ cmsUrl, websiteId, apiKey });

  if (schemas.length === 0) {
    throw new Error(
      '[generate-schemas] API ei tagastanud ühtegi komponenti. Kontrolli, et PROFOUND_API_KEY on kehtiv ja osutab õigele veebisaidile.'
    );
  }

  console.log(
    `[generate-schemas] Leiti ${schemas.length} komponenti: ${schemas.map((s) => s.name).join(', ')}`
  );

  await saveZodSchemaCode(schemas, './generated/cms-schemas.ts');

  console.log('[generate-schemas] Valmis.');
}

main().catch((err) => {
  console.error('[generate-schemas] Ebaõnnestus:', err);
  process.exit(1);
});

CMS-i konfiguratsiooni näide

export const cmsConfig = {
  cmsUrl: process.env.NEXT_PUBLIC_CMS_API_URL,
  apiKey: process.env.CMS_API_KEY,
  websiteId: '...',
};

`package.json`i seadistus

Märkus: Kui sul ei ole faili tsconfig.json, eemalda lipp --tsconfig.

{
  "name": "veeb",
  "version": "0.1.0",
  "type": "module",
  "private": true,
  "scripts": {
    "generate-schemas": "tsx --tsconfig tsconfig.json scripts/generate-schemas.ts",
    "...": "..."
  },
  "dependencies": {
    "cms-renderer": "0.3.1",
    "zod": "^4.3.6",
    "...": "..."
  },
  "devDependencies": {
    "tsx": "^4.21.0",
    "object-hash": "^3.0.0",
    "...": "..."
  }
}

Skripti käivitamine

bun run generate-schemas

Näidisväljund:

tsx --tsconfig tsconfig.json scripts/generate-schemas.ts
[generate-schemas] Leiti 3 komponenti: post, categories, header
[generate-schemas] Valmis.

Uuendatud projekti struktuur

apps/
  web/
    app/
      page.tsx
    scripts/
      generated-schema.ts
    generated/
      cms-schemas.ts   # genereeritud Zodi skeem

Kasutamine failis `page.tsx`

import type { PetFoodPost, SiteConfig } from '@/generated/cms-schemas';
import { petFoodPostSchema } from '@/generated/cms-schemas';

// Kasuta tüübiturvaliseks parsimiseks
petFoodPostSchema.parse(obj);

Märkused

Uuri genereeritud faili, et mõista oma komponendi struktuuri
Käivita skript uuesti iga kord, kui komponendi struktuur muutub:

bun run generate-schemas

Saad selle integreerida oma arendus- või ehitusvoogu
Uuenda komponente administreerimispaneeli kaudu ja genereeri need siis lokaalselt uuesti

NextSplit Screen JSON Component Builder with LLM›

Kiirkäivitus

Postitus skeemide kohta

Loo tüübiturvalisi Zodi skeeme

See funktsioon võimaldab saada oma komponentide kirjelduse tüübiturvalise Zodi skeemi kujul, pakkudes:

TypeScripti-keskne skeemivalideerimine
Statiline tüübituletus

Lisateave: https://zod.dev

Seadistamine

Et Zodi skeemi alla laadida, tee järgmist:

Laadi vajalikud sõltuvused
Loo skript, kasutades cms-rendereri tööriistu

Projekti struktuur

apps/
  web/
    app/
      page.tsx
    scripts/
      generated-schema.ts   # skriptifail

Skript: `generated-schema.ts`

import { fetchAllCustomSchemaFields, saveZodSchemaCode } from 'cms-renderer/lib/custom-schemas';
import { cmsConfig } from '../lib/cms-config';

async function main() {
  const { cmsUrl, websiteId, apiKey } = cmsConfig;

  if (!cmsUrl) {
    throw new Error(
      '[generate-schemas] NEXT_PUBLIC_CMS_API_URL ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  if (!websiteId) {
    throw new Error(
      '[generate-schemas] CMS_WEBSITE_ID ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  if (!apiKey) {
    throw new Error(
      '[generate-schemas] PROFOUND_API_KEY ei ole määratud. Sea see oma keskkonnas või .env-failis.'
    );
  }

  const schemas = await fetchAllCustomSchemaFields({ cmsUrl, websiteId, apiKey });

  if (schemas.length === 0) {
    throw new Error(
      '[generate-schemas] API ei tagastanud ühtegi komponenti. Kontrolli, et PROFOUND_API_KEY on kehtiv ja osutab õigele veebisaidile.'
    );
  }

  console.log(
    `[generate-schemas] Leiti ${schemas.length} komponenti: ${schemas.map((s) => s.name).join(', ')}`
  );

  await saveZodSchemaCode(schemas, './generated/cms-schemas.ts');

  console.log('[generate-schemas] Valmis.');
}

main().catch((err) => {
  console.error('[generate-schemas] Ebaõnnestus:', err);
  process.exit(1);
});

CMS-i konfiguratsiooni näide

export const cmsConfig = {
  cmsUrl: process.env.NEXT_PUBLIC_CMS_API_URL,
  apiKey: process.env.CMS_API_KEY,
  websiteId: '...',
};

`package.json`i seadistus

Märkus: Kui sul ei ole faili tsconfig.json, eemalda lipp --tsconfig.

{
  "name": "veeb",
  "version": "0.1.0",
  "type": "module",
  "private": true,
  "scripts": {
    "generate-schemas": "tsx --tsconfig tsconfig.json scripts/generate-schemas.ts",
    "...": "..."
  },
  "dependencies": {
    "cms-renderer": "0.3.1",
    "zod": "^4.3.6",
    "...": "..."
  },
  "devDependencies": {
    "tsx": "^4.21.0",
    "object-hash": "^3.0.0",
    "...": "..."
  }
}

Skripti käivitamine

bun run generate-schemas

Näidisväljund:

tsx --tsconfig tsconfig.json scripts/generate-schemas.ts
[generate-schemas] Leiti 3 komponenti: post, categories, header
[generate-schemas] Valmis.

Uuendatud projekti struktuur

apps/
  web/
    app/
      page.tsx
    scripts/
      generated-schema.ts
    generated/
      cms-schemas.ts   # genereeritud Zodi skeem

Kasutamine failis `page.tsx`

import type { PetFoodPost, SiteConfig } from '@/generated/cms-schemas';
import { petFoodPostSchema } from '@/generated/cms-schemas';

// Kasuta tüübiturvaliseks parsimiseks
petFoodPostSchema.parse(obj);

Märkused

Uuri genereeritud faili, et mõista oma komponendi struktuuri
Käivita skript uuesti iga kord, kui komponendi struktuur muutub:

bun run generate-schemas

Saad selle integreerida oma arendus- või ehitusvoogu
Uuenda komponente administreerimispaneeli kaudu ja genereeri need siis lokaalselt uuesti

NextSplit Screen JSON Component Builder with LLM›

Kiirkäivitus

Loo tüübiturvalisi Zodi skeeme

Seadistamine

Projekti struktuur

Skript: generated-schema.ts

CMS-i konfiguratsiooni näide

package.jsoni seadistus

Skripti käivitamine

Uuendatud projekti struktuur

Kasutamine failis page.tsx

Märkused

Kiirkäivitus

Loo tüübiturvalisi Zodi skeeme

Seadistamine

Projekti struktuur

Skript: generated-schema.ts

CMS-i konfiguratsiooni näide

package.jsoni seadistus

Skripti käivitamine

Uuendatud projekti struktuur

Kasutamine failis page.tsx

Märkused

Skript: `generated-schema.ts`

`package.json`i seadistus

Kasutamine failis `page.tsx`

Skript: `generated-schema.ts`

`package.json`i seadistus

Kasutamine failis `page.tsx`