npm install @reaatech/prompt-version-control-shared
# or
pnpm add @reaatech/prompt-version-control-shared

import {
  CreatePromptSchema,
  calculateChecksum,
  renderTemplate,
  generateApiKey,
  type Prompt,
} from "@reaatech/prompt-version-control-shared";
 
// Validate at the boundary
const raw = JSON.parse(inputJson);
const input = CreatePromptSchema.parse(raw);
 
// Hash prompt content
const checksum = calculateChecksum("You are a helpful assistant. Help with: {{topic}}");
 
// Render a template with variables
const result = renderTemplate(
  "Hello, {{name}}! Your order #{{orderId}} is ready.",
  { name: "Alice", orderId: "12345" }
);
console.log(result.rendered);            // "Hello, Alice! Your order #12345 is ready."
console.log(result.variablesUsed);       // ["name", "orderId"]
console.log(result.missingVariables);    // [] (all provided)
 
// Generate an API key
const apiKey = generateApiKey("my-pepper");
// Returns: { key: "pvc_abc123...", prefix: "pvc_", hash: "<hmac>" }

import { VersionSchema, type Version } from "@reaatech/prompt-version-control-shared";
 
function handleResponse(raw: unknown): Version {
  // Parse at the boundary — throws ZodError on invalid data
  return VersionSchema.parse(raw);
}

import { renderTemplate } from "@reaatech/prompt-version-control-shared";
 
const result = renderTemplate(
  "You are a {{role}}. Respond to: {{query}}",
  { role: "support agent" }
);
 
// result.rendered === "You are a support agent. Respond to: "
// result.variablesUsed === ["role"]
// result.missingVariables === ["query"]  ← not provided, highlighted for debugging

import { generateApiKey, hashApiKey } from "@reaatech/prompt-version-control-shared";
 
const pepper = process.env.API_KEY_PEPPER;
 
// Generate a new key
const { key, prefix, hash } = generateApiKey(pepper);
// Store `hash` in the database, return `key` to the user once
 
// Verify an incoming key
const incomingHash = hashApiKey(incomingKey, pepper);
const storedKey = await db.apiKey.findUnique({ where: { hash: incomingHash } });

import { calculateChecksum } from "@reaatech/prompt-version-control-shared";
 
const content = "You are a helpful assistant. Help with: {{topic}}";
const checksum = calculateChecksum(content);
 
// Only create a new version if content actually changed
const existing = await db.version.findFirst({ where: { promptId, checksum } });
if (existing) {
  console.log(`Content unchanged — existing version: ${existing.number}`);
  return existing;
}