@danielsimonjr/memory-mcp 0.48.0 → 9.8.0

package/dist/utils/schemas.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Validation Schemas and Helpers
+ *
+ * Consolidated module for Zod schemas and validation utilities.
+ * Provides runtime type safety and data validation.
+ *
+ * @module utils/schemas
+ */
+import { z, type ZodSchema, type ZodError } from 'zod';
+/**
+ * Complete Entity schema with all fields.
+ * Used for validating full entity objects including timestamps.
+ */
+export declare const EntitySchema: z.ZodObject<{
+    name: z.ZodString;
+    entityType: z.ZodString;
+    observations: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    parentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Entity creation input schema.
+ * Used for validating user input when creating new entities.
+ * Timestamps are optional and will be auto-generated if not provided.
+ */
+export declare const CreateEntitySchema: z.ZodObject<{
+    name: z.ZodString;
+    entityType: z.ZodString;
+    observations: z.ZodArray<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    parentId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Entity update input schema.
+ * All fields are optional for partial updates.
+ * Name cannot be updated (it's the unique identifier).
+ */
+export declare const UpdateEntitySchema: z.ZodObject<{
+    entityType: z.ZodOptional<z.ZodString>;
+    observations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    parentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Complete Relation schema with all fields.
+ * Used for validating full relation objects including timestamps.
+ */
+export declare const RelationSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    relationType: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Relation creation input schema.
+ * Used for validating user input when creating new relations.
+ * Timestamps are optional and will be auto-generated if not provided.
+ */
+export declare const CreateRelationSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    relationType: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Search query validation.
+ * Validates text search queries with reasonable length constraints.
+ */
+export declare const SearchQuerySchema: z.ZodString;
+/**
+ * Date range validation for search filters.
+ */
+export declare const DateRangeSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Tag alias validation for TagManager.
+ */
+export declare const TagAliasSchema: z.ZodObject<{
+    canonical: z.ZodString;
+    aliases: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Export format validation.
+ */
+export declare const ExportFormatSchema: z.ZodEnum<{
+    json: "json";
+    graphml: "graphml";
+    csv: "csv";
+}>;
+/**
+ * Batch entity creation validation.
+ * Validates array of entities with maximum constraints.
+ * Empty arrays are allowed (no-op).
+ */
+export declare const BatchCreateEntitiesSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    entityType: z.ZodString;
+    observations: z.ZodArray<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    importance: z.ZodOptional<z.ZodNumber>;
+    parentId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Batch relation creation validation.
+ * Validates array of relations with maximum constraints.
+ * Empty arrays are allowed (no-op).
+ */
+export declare const BatchCreateRelationsSchema: z.ZodArray<z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    relationType: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Entity name array validation for batch deletion.
+ */
+export declare const EntityNamesSchema: z.ZodArray<z.ZodString>;
+/**
+ * Relation array validation for batch deletion.
+ */
+export declare const DeleteRelationsSchema: z.ZodArray<z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    relationType: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    lastModified: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Single observation input for add operations.
+ * Empty contents array is allowed (no-op).
+ */
+export declare const AddObservationInputSchema: z.ZodObject<{
+    entityName: z.ZodString;
+    contents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Batch observation addition validation.
+ * Empty array is allowed (no-op).
+ */
+export declare const AddObservationsInputSchema: z.ZodArray<z.ZodObject<{
+    entityName: z.ZodString;
+    contents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Single observation deletion input.
+ * Empty observations array is allowed (no-op).
+ * Non-existent entities are silently skipped by the manager.
+ */
+export declare const DeleteObservationInputSchema: z.ZodObject<{
+    entityName: z.ZodString;
+    observations: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Batch observation deletion validation.
+ * Empty array is allowed (no-op).
+ */
+export declare const DeleteObservationsInputSchema: z.ZodArray<z.ZodObject<{
+    entityName: z.ZodString;
+    observations: z.ZodArray<z.ZodString>;
+}, z.core.$strip>>;
+/**
+ * Archive criteria validation.
+ * All fields are optional - the manager handles the case when no criteria provided.
+ */
+export declare const ArchiveCriteriaSchema: z.ZodObject<{
+    olderThan: z.ZodOptional<z.ZodString>;
+    importanceLessThan: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Saved search creation input validation.
+ */
+export declare const SavedSearchInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    minImportance: z.ZodOptional<z.ZodNumber>;
+    maxImportance: z.ZodOptional<z.ZodNumber>;
+    entityType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Saved search update validation.
+ * All fields are optional for partial updates.
+ */
+export declare const SavedSearchUpdateSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    minImportance: z.ZodOptional<z.ZodNumber>;
+    maxImportance: z.ZodOptional<z.ZodNumber>;
+    entityType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Import format validation.
+ */
+export declare const ImportFormatSchema: z.ZodEnum<{
+    json: "json";
+    graphml: "graphml";
+    csv: "csv";
+}>;
+/**
+ * Export format validation (includes all output formats).
+ */
+export declare const ExtendedExportFormatSchema: z.ZodEnum<{
+    json: "json";
+    graphml: "graphml";
+    csv: "csv";
+    gexf: "gexf";
+    dot: "dot";
+    markdown: "markdown";
+    mermaid: "mermaid";
+}>;
+/**
+ * Merge strategy validation for imports.
+ */
+export declare const MergeStrategySchema: z.ZodEnum<{
+    replace: "replace";
+    skip: "skip";
+    merge: "merge";
+    fail: "fail";
+}>;
+/**
+ * Export filter validation.
+ */
+export declare const ExportFilterSchema: z.ZodObject<{
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Tags array validation (optional, for search filters).
+ */
+export declare const OptionalTagsSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+/**
+ * Optional entity names array validation.
+ */
+export declare const OptionalEntityNamesSchema: z.ZodOptional<z.ZodArray<z.ZodString>>;
+export type EntityInput = z.infer<typeof EntitySchema>;
+export type CreateEntityInput = z.infer<typeof CreateEntitySchema>;
+export type UpdateEntityInput = z.infer<typeof UpdateEntitySchema>;
+export type RelationInput = z.infer<typeof RelationSchema>;
+export type CreateRelationInput = z.infer<typeof CreateRelationSchema>;
+export type SearchQuery = z.infer<typeof SearchQuerySchema>;
+export type DateRange = z.infer<typeof DateRangeSchema>;
+export type TagAlias = z.infer<typeof TagAliasSchema>;
+export type ExportFormat = z.infer<typeof ExportFormatSchema>;
+export type AddObservationInput = z.infer<typeof AddObservationInputSchema>;
+export type DeleteObservationInput = z.infer<typeof DeleteObservationInputSchema>;
+export type ArchiveCriteriaInput = z.infer<typeof ArchiveCriteriaSchema>;
+export type SavedSearchInput = z.infer<typeof SavedSearchInputSchema>;
+export type SavedSearchUpdateInput = z.infer<typeof SavedSearchUpdateSchema>;
+export type ImportFormat = z.infer<typeof ImportFormatSchema>;
+export type ExtendedExportFormat = z.infer<typeof ExtendedExportFormatSchema>;
+export type MergeStrategy = z.infer<typeof MergeStrategySchema>;
+export type ExportFilterInput = z.infer<typeof ExportFilterSchema>;
+/**
+ * Validation result with status and error messages.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Formats Zod errors into human-readable strings.
+ *
+ * @param error - Zod error object
+ * @returns Array of formatted error messages
+ */
+export declare function formatZodErrors(error: ZodError): string[];
+/**
+ * Validates data against a Zod schema and returns the typed result.
+ * Throws ValidationError with formatted error messages on failure.
+ *
+ * @param data - The data to validate
+ * @param schema - The Zod schema to validate against
+ * @param errorMessage - Custom error message prefix (default: 'Validation failed')
+ * @returns The validated and typed data
+ * @throws ValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * const entities = validateWithSchema(
+ *   input,
+ *   BatchCreateEntitiesSchema,
+ *   'Invalid entity data'
+ * );
+ * ```
+ */
+export declare function validateWithSchema<T>(data: unknown, schema: ZodSchema<T>, errorMessage?: string): T;
+/**
+ * Validates data and returns a result object instead of throwing.
+ * Useful when you want to handle validation errors gracefully.
+ *
+ * @param data - The data to validate
+ * @param schema - The Zod schema to validate against
+ * @returns Result object with success status and either data or errors
+ *
+ * @example
+ * ```typescript
+ * const result = validateSafe(input, EntitySchema);
+ * if (result.success) {
+ *   console.log(result.data);
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export declare function validateSafe<T>(data: unknown, schema: ZodSchema<T>): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: string[];
+};
+/**
+ * Validates an array of items against a schema.
+ * Returns detailed information about which items failed validation.
+ *
+ * @param items - Array of items to validate
+ * @param schema - Zod schema for individual items
+ * @param errorMessage - Custom error message prefix
+ * @returns Array of validated items
+ * @throws ValidationError if any item fails validation
+ */
+export declare function validateArrayWithSchema<T>(items: unknown[], schema: ZodSchema<T>, errorMessage?: string): T[];
+/**
+ * Validate an entity object.
+ *
+ * Checks required fields and data types.
+ *
+ * @param entity - Entity to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export declare function validateEntity(entity: unknown): ValidationResult;
+/**
+ * Validate a relation object.
+ *
+ * Checks required fields and data types.
+ *
+ * @param relation - Relation to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export declare function validateRelation(relation: unknown): ValidationResult;
+/**
+ * Validate importance level (must be 0-10).
+ *
+ * @param importance - Importance value to validate
+ * @returns True if valid
+ */
+export declare function validateImportance(importance: number): boolean;
+/**
+ * Validate an array of tags.
+ *
+ * @param tags - Tags array to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export declare function validateTags(tags: unknown): ValidationResult;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/utils/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AA4EvD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;kBASd,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;iBAS7B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAM7B,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;kBAMhB,CAAC;AAEZ;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAGrB,CAAC;AAEV;;GAEG;AACH,eAAO,MAAM,eAAe;;;iBAM3B,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;EAAqC,CAAC;AAIrE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;kBACiC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;;;;;kBACiC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,iBAAiB,yBAEyC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;kBAEsC,CAAC;AAIzE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;kBAC6C,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;iBAGvC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;kBAC+C,CAAC;AAI1F;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;iBAQjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;iBAOlC,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;EAAqC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;EAA2E,CAAC;AAEnH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;EAA+C,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAIH;;GAEG;AACH,eAAO,MAAM,kBAAkB,wCAAgC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,yBAAyB,wCAAuC,CAAC;AAI9E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAInE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAKzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,YAAY,GAAE,MAA4B,GACzC,CAAC,CAOH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAMnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,YAAY,GAAE,MAAkC,GAC/C,CAAC,EAAE,CAmBL;AAWD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAsChE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB,CAoBpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAY5D"}