@wundr.io/prompt-templates 1.0.3

package/dist/types.d.ts

@@ -0,0 +1,443 @@
+/**
+ * @wundr/prompt-templates - Type definitions for dynamic prompt templating
+ */
+import { z } from 'zod';
+/**
+ * JSON-compatible primitive types
+ */
+export type JsonPrimitive = string | number | boolean | null;
+/**
+ * JSON-compatible value types
+ */
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+/**
+ * JSON-compatible object type
+ */
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+/**
+ * JSON-compatible array type
+ */
+export type JsonArray = ReadonlyArray<JsonValue>;
+/**
+ * Context data passed to templates for rendering
+ */
+export interface TemplateContext {
+    /** Variables available in the template */
+    readonly variables: Record<string, unknown>;
+    /** System-level context (e.g., current date, user info) */
+    readonly system?: SystemContext;
+    /** Memory/history context for conversation-aware templates */
+    readonly memory?: MemoryContext;
+    /** Tools/functions available to the AI */
+    readonly tools?: ToolDefinition[];
+    /** Additional metadata */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * System-level context available to all templates
+ */
+export interface SystemContext {
+    /** Current timestamp */
+    readonly timestamp?: Date;
+    /** User identifier */
+    readonly userId?: string;
+    /** Session identifier */
+    readonly sessionId?: string;
+    /** Environment (development, production, test) */
+    readonly environment?: 'development' | 'production' | 'test';
+    /** Model being used */
+    readonly model?: string;
+    /** Custom system values */
+    readonly [key: string]: unknown;
+}
+/**
+ * Memory context for conversation history
+ */
+export interface MemoryContext {
+    /** Previous messages in the conversation */
+    readonly messages?: ConversationMessage[];
+    /** Key facts/context to remember */
+    readonly facts?: string[];
+    /** Short-term working memory */
+    readonly shortTerm?: Record<string, unknown>;
+    /** Long-term persistent memory */
+    readonly longTerm?: Record<string, unknown>;
+}
+/**
+ * Conversation message structure
+ */
+export interface ConversationMessage {
+    /** Role of the message sender */
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    /** Message content */
+    readonly content: string;
+    /** Optional message name */
+    readonly name?: string;
+    /** Timestamp when message was sent */
+    readonly timestamp?: Date;
+    /** Additional message metadata */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Tool/function definition for AI prompts
+ */
+export interface ToolDefinition {
+    /** Tool name */
+    readonly name: string;
+    /** Tool description */
+    readonly description: string;
+    /** Input parameters schema */
+    readonly parameters?: ToolParameters;
+    /** Whether the tool returns data */
+    readonly returnsData?: boolean;
+    /** Example usage */
+    readonly examples?: string[];
+}
+/**
+ * Tool parameters schema (JSON Schema-like)
+ */
+export interface ToolParameters {
+    /** Parameter type */
+    readonly type: 'object' | 'array' | 'string' | 'number' | 'boolean';
+    /** Object properties */
+    readonly properties?: Record<string, ToolParameterProperty>;
+    /** Required property names */
+    readonly required?: string[];
+    /** Additional properties allowed */
+    readonly additionalProperties?: boolean;
+}
+/**
+ * Individual tool parameter property
+ */
+export interface ToolParameterProperty {
+    /** Property type */
+    readonly type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Property description */
+    readonly description?: string;
+    /** Enum values for constrained types */
+    readonly enum?: readonly (string | number)[];
+    /** Default value */
+    readonly default?: unknown;
+    /** Array item schema */
+    readonly items?: ToolParameterProperty;
+}
+/**
+ * Prompt template configuration
+ */
+export interface PromptTemplateConfig {
+    /** Unique template identifier */
+    readonly id: string;
+    /** Template name for display */
+    readonly name: string;
+    /** Template description */
+    readonly description?: string;
+    /** Template version */
+    readonly version: string;
+    /** The template content (Handlebars format) */
+    readonly template: string;
+    /** Default context values */
+    readonly defaults?: Partial<TemplateContext>;
+    /** Required variables that must be provided */
+    readonly requiredVariables?: string[];
+    /** Template tags for categorization */
+    readonly tags?: string[];
+    /** Template author */
+    readonly author?: string;
+    /** Creation timestamp */
+    readonly createdAt?: Date;
+    /** Last update timestamp */
+    readonly updatedAt?: Date;
+}
+/**
+ * Macro definition for reusable template components
+ */
+export interface MacroDefinition {
+    /** Macro name */
+    readonly name: string;
+    /** Macro description */
+    readonly description?: string;
+    /** Macro template content */
+    readonly template: string;
+    /** Expected parameters */
+    readonly parameters?: MacroParameter[];
+    /** Example usage */
+    readonly example?: string;
+}
+/**
+ * Macro parameter definition
+ */
+export interface MacroParameter {
+    /** Parameter name */
+    readonly name: string;
+    /** Parameter description */
+    readonly description?: string;
+    /** Parameter type */
+    readonly type?: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Whether the parameter is required */
+    readonly required?: boolean;
+    /** Default value */
+    readonly default?: unknown;
+}
+/**
+ * Helper function definition
+ */
+export interface HelperDefinition {
+    /** Helper name */
+    readonly name: string;
+    /** Helper description */
+    readonly description?: string;
+    /** The helper function implementation */
+    readonly fn: HelperFunction;
+}
+/**
+ * Helper function signature (Handlebars-compatible)
+ */
+export type HelperFunction = (...args: unknown[]) => string | SafeString | undefined;
+/**
+ * Handlebars SafeString type for HTML-safe output
+ */
+export interface SafeString {
+    readonly toHTML: () => string;
+    readonly toString: () => string;
+}
+/**
+ * Template render options
+ */
+export interface RenderOptions {
+    /** Strict mode - throw on undefined variables */
+    readonly strict?: boolean;
+    /** Custom delimiters for template parsing */
+    readonly delimiters?: [string, string];
+    /** Enable HTML escaping (default: false for prompts) */
+    readonly escapeHtml?: boolean;
+    /** Maximum template depth for nested templates */
+    readonly maxDepth?: number;
+    /** Timeout for template rendering (ms) */
+    readonly timeout?: number;
+}
+/**
+ * Template render result
+ */
+export interface RenderResult {
+    /** Whether rendering was successful */
+    readonly success: boolean;
+    /** Rendered output (if successful) */
+    readonly output?: string;
+    /** Error information (if failed) */
+    readonly error?: TemplateError;
+    /** Rendering metadata */
+    readonly metadata?: RenderMetadata;
+}
+/**
+ * Template error information
+ */
+export interface TemplateError {
+    /** Error code */
+    readonly code: string;
+    /** Error message */
+    readonly message: string;
+    /** Line number where error occurred */
+    readonly line?: number;
+    /** Column number where error occurred */
+    readonly column?: number;
+    /** Template ID that caused the error */
+    readonly templateId?: string;
+    /** Original error stack */
+    readonly stack?: string;
+}
+/**
+ * Metadata about the render operation
+ */
+export interface RenderMetadata {
+    /** Time taken to render (ms) */
+    readonly renderTime: number;
+    /** Template ID used */
+    readonly templateId?: string;
+    /** Variables that were used */
+    readonly usedVariables?: string[];
+    /** Macros that were invoked */
+    readonly usedMacros?: string[];
+    /** Helpers that were invoked */
+    readonly usedHelpers?: string[];
+}
+/**
+ * Template loader options
+ */
+export interface LoaderOptions {
+    /** Base directory for template files */
+    readonly baseDir?: string;
+    /** File extension for template files */
+    readonly extension?: string;
+    /** Enable template caching */
+    readonly cache?: boolean;
+    /** Watch for file changes */
+    readonly watch?: boolean;
+}
+/**
+ * Template engine events
+ */
+export interface EngineEvents {
+    readonly 'template:loaded': {
+        templateId: string;
+    };
+    readonly 'template:rendered': {
+        templateId: string;
+        renderTime: number;
+    };
+    readonly 'template:error': {
+        templateId: string;
+        error: TemplateError;
+    };
+    readonly 'macro:registered': {
+        name: string;
+    };
+    readonly 'helper:registered': {
+        name: string;
+    };
+}
+/**
+ * Template engine event handler
+ */
+export type EngineEventHandler<K extends keyof EngineEvents> = (event: EngineEvents[K]) => void;
+/**
+ * Zod schema for PromptTemplateConfig
+ */
+export declare const PromptTemplateConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    template: z.ZodString;
+    defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    requiredVariables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    author: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodDate>;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    version: string;
+    template: string;
+    description?: string | undefined;
+    defaults?: Record<string, unknown> | undefined;
+    requiredVariables?: string[] | undefined;
+    tags?: string[] | undefined;
+    author?: string | undefined;
+    createdAt?: Date | undefined;
+    updatedAt?: Date | undefined;
+}, {
+    id: string;
+    name: string;
+    version: string;
+    template: string;
+    description?: string | undefined;
+    defaults?: Record<string, unknown> | undefined;
+    requiredVariables?: string[] | undefined;
+    tags?: string[] | undefined;
+    author?: string | undefined;
+    createdAt?: Date | undefined;
+    updatedAt?: Date | undefined;
+}>;
+/**
+ * Zod schema for ToolDefinition
+ */
+export declare const ToolDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    parameters: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["object", "array", "string", "number", "boolean"]>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        required: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        additionalProperties: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        properties?: Record<string, unknown> | undefined;
+        required?: string[] | undefined;
+        additionalProperties?: boolean | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        properties?: Record<string, unknown> | undefined;
+        required?: string[] | undefined;
+        additionalProperties?: boolean | undefined;
+    }>>;
+    returnsData: z.ZodOptional<z.ZodBoolean>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    parameters?: {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        properties?: Record<string, unknown> | undefined;
+        required?: string[] | undefined;
+        additionalProperties?: boolean | undefined;
+    } | undefined;
+    returnsData?: boolean | undefined;
+    examples?: string[] | undefined;
+}, {
+    name: string;
+    description: string;
+    parameters?: {
+        type: "string" | "number" | "boolean" | "object" | "array";
+        properties?: Record<string, unknown> | undefined;
+        required?: string[] | undefined;
+        additionalProperties?: boolean | undefined;
+    } | undefined;
+    returnsData?: boolean | undefined;
+    examples?: string[] | undefined;
+}>;
+/**
+ * Zod schema for MacroDefinition
+ */
+export declare const MacroDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    template: z.ZodString;
+    parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["string", "number", "boolean", "array", "object"]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description?: string | undefined;
+        type?: "string" | "number" | "boolean" | "object" | "array" | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }, {
+        name: string;
+        description?: string | undefined;
+        type?: "string" | "number" | "boolean" | "object" | "array" | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }>, "many">>;
+    example: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    template: string;
+    description?: string | undefined;
+    parameters?: {
+        name: string;
+        description?: string | undefined;
+        type?: "string" | "number" | "boolean" | "object" | "array" | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }[] | undefined;
+    example?: string | undefined;
+}, {
+    name: string;
+    template: string;
+    description?: string | undefined;
+    parameters?: {
+        name: string;
+        description?: string | undefined;
+        type?: "string" | "number" | "boolean" | "object" | "array" | undefined;
+        required?: boolean | undefined;
+        default?: unknown;
+    }[] | undefined;
+    example?: string | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * @wundr/prompt-templates - Type definitions for dynamic prompt templating
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MacroDefinitionSchema = exports.ToolDefinitionSchema = exports.PromptTemplateConfigSchema = void 0;
+const zod_1 = require("zod");
+// Zod schemas for validation
+/**
+ * Zod schema for PromptTemplateConfig
+ */
+exports.PromptTemplateConfigSchema = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    version: zod_1.z.string().regex(/^\d+\.\d+\.\d+$/),
+    template: zod_1.z.string().min(1),
+    defaults: zod_1.z.record(zod_1.z.unknown()).optional(),
+    requiredVariables: zod_1.z.array(zod_1.z.string()).optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    author: zod_1.z.string().optional(),
+    createdAt: zod_1.z.date().optional(),
+    updatedAt: zod_1.z.date().optional(),
+});
+/**
+ * Zod schema for ToolDefinition
+ */
+exports.ToolDefinitionSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().min(1),
+    parameters: zod_1.z
+        .object({
+        type: zod_1.z.enum(['object', 'array', 'string', 'number', 'boolean']),
+        properties: zod_1.z.record(zod_1.z.unknown()).optional(),
+        required: zod_1.z.array(zod_1.z.string()).optional(),
+        additionalProperties: zod_1.z.boolean().optional(),
+    })
+        .optional(),
+    returnsData: zod_1.z.boolean().optional(),
+    examples: zod_1.z.array(zod_1.z.string()).optional(),
+});
+/**
+ * Zod schema for MacroDefinition
+ */
+exports.MacroDefinitionSchema = zod_1.z.object({
+    name: zod_1.z.string().min(1),
+    description: zod_1.z.string().optional(),
+    template: zod_1.z.string().min(1),
+    parameters: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string().min(1),
+        description: zod_1.z.string().optional(),
+        type: zod_1.z
+            .enum(['string', 'number', 'boolean', 'array', 'object'])
+            .optional(),
+        required: zod_1.z.boolean().optional(),
+        default: zod_1.z.unknown().optional(),
+    }))
+        .optional(),
+    example: zod_1.z.string().optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@wundr.io/prompt-templates",
+  "version": "1.0.3",
+  "description": "Jinja2-style dynamic prompt templating using Handlebars for the Wundr platform",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "src"],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "handlebars": "^4.7.8",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.1",
+    "typescript": "^5.2.2",
+    "eslint": "^8.57.1",
+    "prettier": "^3.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "wundr",
+    "prompt",
+    "templates",
+    "handlebars",
+    "jinja2",
+    "ai",
+    "llm"
+  ]
+}