gitvan/src/schemas/frontmatter.zod.mjs

Autonomic Git-native development automation platform with AI-powered workflows

/**
 * GitVan v2 Front-matter Schema Validation
 * Zod schemas for validating front-matter structure
 */

import { z } from "zod";

// Helper schemas
const StringOrArray = z.union([z.string(), z.array(z.string())]);

const ForcePolicy = z
  .enum(["error", "overwrite", "append", "skip"])
  .default("error");

const InjectSpec = z.object({
  into: z.string(),
  snippet: z.string().optional(),
  where: z.enum(["before", "after", "at_line", "between"]).default("after"),
  find: z.string().optional(),
  start: z.string().optional(),
  end: z.string().optional(),
  line: z.number().optional(),
  once: z.boolean().default(true),
});

const CopySpec = z.object({
  from: z.string(),
  to: z.string(),
});

const ShellSpec = z.object({
  before: StringOrArray.optional(),
  after: StringOrArray.optional(),
});

const PerFileSpec = z.object({
  to: z.string(),
  data: z.record(z.any()).optional(),
});

// Main front-matter schema
export const FrontmatterSchema = z.object({
  to: StringOrArray.optional(),
  inject: z.union([InjectSpec, z.array(InjectSpec)]).optional(),
  copy: z.array(CopySpec).optional(),
  perFile: z.array(PerFileSpec).optional(),
  sh: ShellSpec.optional(),
  when: z.union([z.string(), z.boolean()]).default(true),
  force: ForcePolicy,
  data: z.record(z.any()).default({}),
});

// Note: Type exports removed for ES module compatibility
// Types can be inferred from the schemas when needed