@ncukondo/search-hub 0.13.0 → 0.15.0

package/dist/query/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/query/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;iBAS3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;EAAwB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;iBAI3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;GAcrB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwB3B,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAC;AAiBH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAcvB,CAAC;AAEN;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAEzD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAWvE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/query/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;iBAS3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;EAAwB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;iBAK3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkBrB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;EAO7B,CAAC;AAgCH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhC,CAAC;AAiBH;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BvB,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CASzD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAsBvE"}

package/dist/query/validator.js

@@ -19,6 +19,7 @@ const termBlockSchema = z.object({
 );
 const operatorSchema = z.enum(["AND", "OR"]);
 const queryBlockSchema = z.object({
+  id: z.string().min(1),
   field: fieldTypeSchema,
   terms: termBlockSchema,
   operator: operatorSchema
@@ -31,29 +32,14 @@ const filtersSchema = z.object({
   year_from: z.number().int().optional(),
   year_to: z.number().int().optional(),
   language: z.array(z.string()).optional(),
-  publication_types: publicationTypeFilterSchema.optional()
+  publication_types: publicationTypeFilterSchema.optional(),
+  categories: z.array(z.string()).optional(),
+  source_types: z.array(z.string()).optional()
 }).optional().default({}).transform((data) => ({
   yearFrom: data.year_from,
   yearTo: data.year_to,
   languages: data.language,
-  publicationTypes: data.publication_types
-}));
-const overrideBlockSchema = z.object({
-  filters: z.object({
-    year_from: z.number().int().optional(),
-    year_to: z.number().int().optional(),
-    language: z.array(z.string()).optional(),
-    publication_types: publicationTypeFilterSchema.optional()
-  }).optional(),
-  categories: z.array(z.string()).optional(),
-  source_types: z.array(z.string()).optional()
-}).transform((data) => ({
-  filters: data.filters ? {
-    yearFrom: data.filters.year_from,
-    yearTo: data.filters.year_to,
-    languages: data.filters.language,
-    publicationTypes: data.filters.publication_types
-  } : void 0,
+  publicationTypes: data.publication_types,
   categories: data.categories,
   sourceTypes: data.source_types
 }));
@@ -65,28 +51,74 @@ z.enum([
   "wos",
   "embase"
 ]);
-const overridesSchema = z.object({
-  pubmed: overrideBlockSchema.optional(),
-  scopus: overrideBlockSchema.optional(),
-  eric: overrideBlockSchema.optional(),
-  arxiv: overrideBlockSchema.optional(),
-  wos: overrideBlockSchema.optional(),
-  embase: overrideBlockSchema.optional()
+const blockReplacementSchema = z.object({
+  field: fieldTypeSchema,
+  terms: termBlockSchema,
+  operator: operatorSchema
+});
+const addsFiltersSchema = z.object({
+  year_from: z.number().int().optional(),
+  year_to: z.number().int().optional(),
+  language: z.array(z.string()).optional(),
+  publication_types: publicationTypeFilterSchema.optional(),
+  categories: z.array(z.string()).optional(),
+  source_types: z.array(z.string()).optional()
+}).transform((data) => ({
+  yearFrom: data.year_from,
+  yearTo: data.year_to,
+  languages: data.language,
+  publicationTypes: data.publication_types,
+  categories: data.categories,
+  sourceTypes: data.source_types
+}));
+const providerSectionSchema = z.object({
+  replaces: z.record(z.string(), blockReplacementSchema).optional(),
+  adds: z.object({
+    filters: addsFiltersSchema.optional()
+  }).optional()
+});
+const providersSchema = z.object({
+  pubmed: providerSectionSchema.optional(),
+  scopus: providerSectionSchema.optional(),
+  eric: providerSectionSchema.optional(),
+  arxiv: providerSectionSchema.optional(),
+  wos: providerSectionSchema.optional(),
+  embase: providerSectionSchema.optional()
 }).optional().default({});
 const queryFileSchema = z.object({
   name: z.string().min(1),
   description: z.string().optional(),
   query: z.array(queryBlockSchema).min(1),
   filters: filtersSchema,
-  overrides: overridesSchema
-}).transform((data) => ({
+  providers: providersSchema
+}).refine(
+  (data) => {
+    const blockIds = new Set(data.query.map((b) => b.id));
+    for (const [, section] of Object.entries(data.providers ?? {})) {
+      if (section?.replaces) {
+        for (const key of Object.keys(section.replaces)) {
+          if (!blockIds.has(key)) {
+            return false;
+          }
+        }
+      }
+    }
+    return true;
+  },
+  { message: "replaces keys must reference existing block ids" }
+).transform((data) => ({
   name: data.name,
   description: data.description,
   blocks: data.query,
   filters: data.filters,
-  overrides: data.overrides
+  providers: data.providers
 }));
 function validateQueryFile(data) {
+  if (typeof data === "object" && data !== null && "overrides" in data) {
+    throw new Error(
+      'The "overrides" key is no longer supported. Migrate to the new "providers" format. See spec/models/query-dsl.md for details.'
+    );
+  }
   return queryFileSchema.parse(data);
 }
 class ValidationError extends Error {
@@ -97,6 +129,14 @@ class ValidationError extends Error {
   }
 }
 function formatValidationErrors(data) {
+  if (typeof data === "object" && data !== null && "overrides" in data) {
+    return [
+      new ValidationError(
+        "overrides",
+        'The "overrides" key is no longer supported. Migrate to the new "providers" format. See spec/models/query-dsl.md for details.'
+      )
+    ];
+  }
   const result = queryFileSchema.safeParse(data);
   if (result.success) {
     return [];
@@ -112,7 +152,7 @@ export {
   filtersSchema,
   formatValidationErrors,
   operatorSchema,
-  overrideBlockSchema,
+  providerSectionSchema,
   publicationTypeFilterSchema,
   queryBlockSchema,
   queryFileSchema,

package/dist/query/validator.js.map

@@ -1 +1 @@
-{"version":3,"file":"validator.js","sources":["../../src/query/validator.ts"],"sourcesContent":["/**\n * Query Schema Validation using Zod\n *\n * Validates query YAML structure against the query DSL schema.\n * See spec/models/query-dsl.md for the full specification.\n */\n\nimport { z } from 'zod';\nimport type { QueryAST } from './types.js';\n\n/**\n * Schema for field types.\n */\nexport const fieldTypeSchema = z.enum([\n  'title',\n  'abstract',\n  'title_abstract',\n  'author',\n  'keyword',\n  'all',\n]);\n\n/**\n * Schema for term block containing search terms.\n */\nexport const termBlockSchema = z.object({\n  keywords: z.array(z.string()).min(1).optional(),\n  mesh: z.array(z.string()).optional(),\n  emtree: z.array(z.string()).optional(),\n  eric: z.array(z.string()).optional(),\n  exclude: z.array(z.string()).optional(),\n}).refine(\n  (data) => data.keywords?.length || data.mesh?.length || data.emtree?.length || data.eric?.length,\n  { message: 'At least one of keywords, mesh, emtree, or eric is required' }\n);\n\n/**\n * Schema for operator.\n */\nexport const operatorSchema = z.enum(['AND', 'OR']);\n\n/**\n * Schema for query block.\n */\nexport const queryBlockSchema = z.object({\n  field: fieldTypeSchema,\n  terms: termBlockSchema,\n  operator: operatorSchema,\n});\n\n/**\n * Schema for publication type filter.\n */\nexport const publicationTypeFilterSchema = z.object({\n  include: z.array(z.string()).optional(),\n  exclude: z.array(z.string()).optional(),\n});\n\n/**\n * Schema for filters (YAML input format with snake_case).\n * Transforms to camelCase for internal use.\n */\nexport const filtersSchema = z\n  .object({\n    year_from: z.number().int().optional(),\n    year_to: z.number().int().optional(),\n    language: z.array(z.string()).optional(),\n    publication_types: publicationTypeFilterSchema.optional(),\n  })\n  .optional()\n  .default({})\n  .transform((data) => ({\n    yearFrom: data.year_from,\n    yearTo: data.year_to,\n    languages: data.language,\n    publicationTypes: data.publication_types,\n  }));\n\n/**\n * Schema for override block (YAML input format).\n */\nexport const overrideBlockSchema = z\n  .object({\n    filters: z\n      .object({\n        year_from: z.number().int().optional(),\n        year_to: z.number().int().optional(),\n        language: z.array(z.string()).optional(),\n        publication_types: publicationTypeFilterSchema.optional(),\n      })\n      .optional(),\n    categories: z.array(z.string()).optional(),\n    source_types: z.array(z.string()).optional(),\n  })\n  .transform((data) => ({\n    filters: data.filters\n      ? {\n          yearFrom: data.filters.year_from,\n          yearTo: data.filters.year_to,\n          languages: data.filters.language,\n          publicationTypes: data.filters.publication_types,\n        }\n      : undefined,\n    categories: data.categories,\n    sourceTypes: data.source_types,\n  }));\n\n/**\n * Provider names schema.\n */\nexport const providerNameSchema = z.enum([\n  'pubmed',\n  'scopus',\n  'eric',\n  'arxiv',\n  'wos',\n  'embase',\n]);\n\n/**\n * Schema for overrides object (partial record of provider -> override).\n */\nconst overridesSchema = z\n  .object({\n    pubmed: overrideBlockSchema.optional(),\n    scopus: overrideBlockSchema.optional(),\n    eric: overrideBlockSchema.optional(),\n    arxiv: overrideBlockSchema.optional(),\n    wos: overrideBlockSchema.optional(),\n    embase: overrideBlockSchema.optional(),\n  })\n  .optional()\n  .default({});\n\n/**\n * Schema for the complete query file (YAML input format).\n * Transforms to QueryAST for internal use.\n */\nexport const queryFileSchema = z\n  .object({\n    name: z.string().min(1),\n    description: z.string().optional(),\n    query: z.array(queryBlockSchema).min(1),\n    filters: filtersSchema,\n    overrides: overridesSchema,\n  })\n  .transform((data) => ({\n    name: data.name,\n    description: data.description,\n    blocks: data.query,\n    filters: data.filters,\n    overrides: data.overrides,\n  }));\n\n/**\n * Validate a parsed YAML object against the query schema.\n * Returns a validated QueryAST.\n */\nexport function validateQueryFile(data: unknown): QueryAST {\n  return queryFileSchema.parse(data);\n}\n\n/**\n * Validation error with path information.\n */\nexport class ValidationError extends Error {\n  constructor(\n    public readonly path: string,\n    message: string\n  ) {\n    super(message);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Format Zod validation errors into an array of ValidationError objects.\n *\n * @param data - The data to validate\n * @returns Array of ValidationError objects (empty if valid)\n */\nexport function formatValidationErrors(data: unknown): ValidationError[] {\n  const result = queryFileSchema.safeParse(data);\n\n  if (result.success) {\n    return [];\n  }\n\n  return result.error.issues.map((issue) => {\n    const path = issue.path.join('.');\n    return new ValidationError(path, issue.message);\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"validator.js","sources":["../../src/query/validator.ts"],"sourcesContent":["/**\n * Query Schema Validation using Zod\n *\n * Validates query YAML structure against the query DSL schema.\n * See spec/models/query-dsl.md for the full specification.\n */\n\nimport { z } from 'zod';\nimport type { QueryAST } from './types.js';\n\n/**\n * Schema for field types.\n */\nexport const fieldTypeSchema = z.enum([\n  'title',\n  'abstract',\n  'title_abstract',\n  'author',\n  'keyword',\n  'all',\n]);\n\n/**\n * Schema for term block containing search terms.\n */\nexport const termBlockSchema = z.object({\n  keywords: z.array(z.string()).min(1).optional(),\n  mesh: z.array(z.string()).optional(),\n  emtree: z.array(z.string()).optional(),\n  eric: z.array(z.string()).optional(),\n  exclude: z.array(z.string()).optional(),\n}).refine(\n  (data) => data.keywords?.length || data.mesh?.length || data.emtree?.length || data.eric?.length,\n  { message: 'At least one of keywords, mesh, emtree, or eric is required' }\n);\n\n/**\n * Schema for operator.\n */\nexport const operatorSchema = z.enum(['AND', 'OR']);\n\n/**\n * Schema for query block (with required id).\n */\nexport const queryBlockSchema = z.object({\n  id: z.string().min(1),\n  field: fieldTypeSchema,\n  terms: termBlockSchema,\n  operator: operatorSchema,\n});\n\n/**\n * Schema for publication type filter.\n */\nexport const publicationTypeFilterSchema = z.object({\n  include: z.array(z.string()).optional(),\n  exclude: z.array(z.string()).optional(),\n});\n\n/**\n * Schema for filters (YAML input format with snake_case).\n * Transforms to camelCase for internal use.\n */\nexport const filtersSchema = z\n  .object({\n    year_from: z.number().int().optional(),\n    year_to: z.number().int().optional(),\n    language: z.array(z.string()).optional(),\n    publication_types: publicationTypeFilterSchema.optional(),\n    categories: z.array(z.string()).optional(),\n    source_types: z.array(z.string()).optional(),\n  })\n  .optional()\n  .default({})\n  .transform((data) => ({\n    yearFrom: data.year_from,\n    yearTo: data.year_to,\n    languages: data.language,\n    publicationTypes: data.publication_types,\n    categories: data.categories,\n    sourceTypes: data.source_types,\n  }));\n\n/**\n * Provider names schema.\n */\nexport const providerNameSchema = z.enum([\n  'pubmed',\n  'scopus',\n  'eric',\n  'arxiv',\n  'wos',\n  'embase',\n]);\n\n/**\n * Schema for a block replacement (QueryBlock without id).\n */\nconst blockReplacementSchema = z.object({\n  field: fieldTypeSchema,\n  terms: termBlockSchema,\n  operator: operatorSchema,\n});\n\n/**\n * Schema for partial filters in adds section (YAML snake_case → camelCase).\n */\nconst addsFiltersSchema = z\n  .object({\n    year_from: z.number().int().optional(),\n    year_to: z.number().int().optional(),\n    language: z.array(z.string()).optional(),\n    publication_types: publicationTypeFilterSchema.optional(),\n    categories: z.array(z.string()).optional(),\n    source_types: z.array(z.string()).optional(),\n  })\n  .transform((data) => ({\n    yearFrom: data.year_from,\n    yearTo: data.year_to,\n    languages: data.language,\n    publicationTypes: data.publication_types,\n    categories: data.categories,\n    sourceTypes: data.source_types,\n  }));\n\n/**\n * Schema for provider section with replaces and adds.\n */\nexport const providerSectionSchema = z.object({\n  replaces: z.record(z.string(), blockReplacementSchema).optional(),\n  adds: z.object({\n    filters: addsFiltersSchema.optional(),\n  }).optional(),\n});\n\n/**\n * Schema for providers object (partial record of provider -> section).\n */\nconst providersSchema = z\n  .object({\n    pubmed: providerSectionSchema.optional(),\n    scopus: providerSectionSchema.optional(),\n    eric: providerSectionSchema.optional(),\n    arxiv: providerSectionSchema.optional(),\n    wos: providerSectionSchema.optional(),\n    embase: providerSectionSchema.optional(),\n  })\n  .optional()\n  .default({});\n\n/**\n * Schema for the complete query file (YAML input format).\n * Transforms to QueryAST for internal use.\n */\nexport const queryFileSchema = z\n  .object({\n    name: z.string().min(1),\n    description: z.string().optional(),\n    query: z.array(queryBlockSchema).min(1),\n    filters: filtersSchema,\n    providers: providersSchema,\n  })\n  .refine(\n    (data) => {\n      // Cross-validation: replaces keys must reference existing block ids\n      const blockIds = new Set(data.query.map((b) => b.id));\n      for (const [, section] of Object.entries(data.providers ?? {})) {\n        if (section?.replaces) {\n          for (const key of Object.keys(section.replaces)) {\n            if (!blockIds.has(key)) {\n              return false;\n            }\n          }\n        }\n      }\n      return true;\n    },\n    { message: 'replaces keys must reference existing block ids' }\n  )\n  .transform((data) => ({\n    name: data.name,\n    description: data.description,\n    blocks: data.query,\n    filters: data.filters,\n    providers: data.providers,\n  }));\n\n/**\n * Validate a parsed YAML object against the query schema.\n * Returns a validated QueryAST.\n *\n * @throws Error if the input contains the old `overrides` key (migration message provided)\n */\nexport function validateQueryFile(data: unknown): QueryAST {\n  // Check for legacy `overrides` key before Zod parsing (which silently strips unknown keys)\n  if (typeof data === 'object' && data !== null && 'overrides' in data) {\n    throw new Error(\n      'The \"overrides\" key is no longer supported. ' +\n      'Migrate to the new \"providers\" format. See spec/models/query-dsl.md for details.'\n    );\n  }\n  return queryFileSchema.parse(data);\n}\n\n/**\n * Validation error with path information.\n */\nexport class ValidationError extends Error {\n  constructor(\n    public readonly path: string,\n    message: string\n  ) {\n    super(message);\n    this.name = 'ValidationError';\n  }\n}\n\n/**\n * Format Zod validation errors into an array of ValidationError objects.\n *\n * @param data - The data to validate\n * @returns Array of ValidationError objects (empty if valid)\n */\nexport function formatValidationErrors(data: unknown): ValidationError[] {\n  // Check for legacy `overrides` key\n  if (typeof data === 'object' && data !== null && 'overrides' in data) {\n    return [\n      new ValidationError(\n        'overrides',\n        'The \"overrides\" key is no longer supported. ' +\n        'Migrate to the new \"providers\" format. See spec/models/query-dsl.md for details.'\n      ),\n    ];\n  }\n\n  const result = queryFileSchema.safeParse(data);\n\n  if (result.success) {\n    return [];\n  }\n\n  return result.error.issues.map((issue) => {\n    const path = issue.path.join('.');\n    return new ValidationError(path, issue.message);\n  });\n}\n"],"names":[],"mappings":";AAaO,MAAM,kBAAkB,EAAE,KAAK;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAKM,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,UAAU,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,IAAI,CAAC,EAAE,SAAA;AAAA,EACrC,MAAM,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC1B,QAAQ,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC5B,MAAM,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC1B,SAAS,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAC/B,CAAC,EAAE;AAAA,EACD,CAAC,SAAS,KAAK,UAAU,UAAU,KAAK,MAAM,UAAU,KAAK,QAAQ,UAAU,KAAK,MAAM;AAAA,EAC1F,EAAE,SAAS,8DAAA;AACb;AAKO,MAAM,iBAAiB,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC;AAK3C,MAAM,mBAAmB,EAAE,OAAO;AAAA,EACvC,IAAI,EAAE,SAAS,IAAI,CAAC;AAAA,EACpB,OAAO;AAAA,EACP,OAAO;AAAA,EACP,UAAU;AACZ,CAAC;AAKM,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAClD,SAAS,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC7B,SAAS,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAC/B,CAAC;AAMM,MAAM,gBAAgB,EAC1B,OAAO;AAAA,EACN,WAAW,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAC5B,SAAS,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAC1B,UAAU,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC9B,mBAAmB,4BAA4B,SAAA;AAAA,EAC/C,YAAY,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAChC,cAAc,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AACpC,CAAC,EACA,WACA,QAAQ,CAAA,CAAE,EACV,UAAU,CAAC,UAAU;AAAA,EACpB,UAAU,KAAK;AAAA,EACf,QAAQ,KAAK;AAAA,EACb,WAAW,KAAK;AAAA,EAChB,kBAAkB,KAAK;AAAA,EACvB,YAAY,KAAK;AAAA,EACjB,aAAa,KAAK;AACpB,EAAE;AAK8B,EAAE,KAAK;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAKD,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,UAAU;AACZ,CAAC;AAKD,MAAM,oBAAoB,EACvB,OAAO;AAAA,EACN,WAAW,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAC5B,SAAS,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAC1B,UAAU,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAC9B,mBAAmB,4BAA4B,SAAA;AAAA,EAC/C,YAAY,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAAA,EAChC,cAAc,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AACpC,CAAC,EACA,UAAU,CAAC,UAAU;AAAA,EACpB,UAAU,KAAK;AAAA,EACf,QAAQ,KAAK;AAAA,EACb,WAAW,KAAK;AAAA,EAChB,kBAAkB,KAAK;AAAA,EACvB,YAAY,KAAK;AAAA,EACjB,aAAa,KAAK;AACpB,EAAE;AAKG,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,UAAU,EAAE,OAAO,EAAE,UAAU,sBAAsB,EAAE,SAAA;AAAA,EACvD,MAAM,EAAE,OAAO;AAAA,IACb,SAAS,kBAAkB,SAAA;AAAA,EAAS,CACrC,EAAE,SAAA;AACL,CAAC;AAKD,MAAM,kBAAkB,EACrB,OAAO;AAAA,EACN,QAAQ,sBAAsB,SAAA;AAAA,EAC9B,QAAQ,sBAAsB,SAAA;AAAA,EAC9B,MAAM,sBAAsB,SAAA;AAAA,EAC5B,OAAO,sBAAsB,SAAA;AAAA,EAC7B,KAAK,sBAAsB,SAAA;AAAA,EAC3B,QAAQ,sBAAsB,SAAA;AAChC,CAAC,EACA,SAAA,EACA,QAAQ,EAAE;AAMN,MAAM,kBAAkB,EAC5B,OAAO;AAAA,EACN,MAAM,EAAE,SAAS,IAAI,CAAC;AAAA,EACtB,aAAa,EAAE,OAAA,EAAS,SAAA;AAAA,EACxB,OAAO,EAAE,MAAM,gBAAgB,EAAE,IAAI,CAAC;AAAA,EACtC,SAAS;AAAA,EACT,WAAW;AACb,CAAC,EACA;AAAA,EACC,CAAC,SAAS;AAER,UAAM,WAAW,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;AACpD,eAAW,CAAA,EAAG,OAAO,KAAK,OAAO,QAAQ,KAAK,aAAa,CAAA,CAAE,GAAG;AAC9D,UAAI,SAAS,UAAU;AACrB,mBAAW,OAAO,OAAO,KAAK,QAAQ,QAAQ,GAAG;AAC/C,cAAI,CAAC,SAAS,IAAI,GAAG,GAAG;AACtB,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EACA,EAAE,SAAS,kDAAA;AACb,EACC,UAAU,CAAC,UAAU;AAAA,EACpB,MAAM,KAAK;AAAA,EACX,aAAa,KAAK;AAAA,EAClB,QAAQ,KAAK;AAAA,EACb,SAAS,KAAK;AAAA,EACd,WAAW,KAAK;AAClB,EAAE;AAQG,SAAS,kBAAkB,MAAyB;AAEzD,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,eAAe,MAAM;AACpE,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAGJ;AACA,SAAO,gBAAgB,MAAM,IAAI;AACnC;AAKO,MAAM,wBAAwB,MAAM;AAAA,EACzC,YACkB,MAChB,SACA;AACA,UAAM,OAAO;AAHG,SAAA,OAAA;AAIhB,SAAK,OAAO;AAAA,EACd;AACF;AAQO,SAAS,uBAAuB,MAAkC;AAEvE,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,eAAe,MAAM;AACpE,WAAO;AAAA,MACL,IAAI;AAAA,QACF;AAAA,QACA;AAAA,MAAA;AAAA,IAEF;AAAA,EAEJ;AAEA,QAAM,SAAS,gBAAgB,UAAU,IAAI;AAE7C,MAAI,OAAO,SAAS;AAClB,WAAO,CAAA;AAAA,EACT;AAEA,SAAO,OAAO,MAAM,OAAO,IAAI,CAAC,UAAU;AACxC,UAAM,OAAO,MAAM,KAAK,KAAK,GAAG;AAChC,WAAO,IAAI,gBAAgB,MAAM,MAAM,OAAO;AAAA,EAChD,CAAC;AACH;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncukondo/search-hub",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "A CLI tool for systematic literature searching across multiple academic databases",
   "type": "module",
   "engines": {