patram 0.11.0 → 0.12.0

package/lib/cli/parse-arguments-helpers.js

@@ -5,7 +5,7 @@
  * @typedef {import('./arguments.types.ts').CliParseError} CliParseError
  * @typedef {import('./arguments.types.ts').ParsedCliHelpRequest} ParsedCliHelpRequest
  * @typedef {{ kind: string, name?: string, rawName?: string, value?: string | boolean }} CliOptionToken
- * @typedef {{ color?: string, desc?: string, explain?: boolean, help?: boolean, json?: boolean, limit?: string, lint?: boolean, name?: string, 'no-color'?: boolean, offset?: string, plain?: boolean, query?: string, where?: string }} CliOptionValues
+ * @typedef {{ color?: string, cypher?: string, desc?: string, explain?: boolean, help?: boolean, json?: boolean, limit?: string, lint?: boolean, name?: string, 'no-color'?: boolean, offset?: string, plain?: boolean, where?: string }} CliOptionValues
  * @typedef {{ option_tokens: CliOptionToken[], positionals: string[], values: CliOptionValues }} ParsedCommandLine
  */
 
@@ -23,6 +23,7 @@ import { findInvalidQueryPagination } from './query-pagination.js';
 
 export const CLI_OPTIONS = /** @type {const} */ ({
   color: { type: 'string' },
+  cypher: { type: 'string' },
   desc: { type: 'string' },
   explain: { type: 'boolean' },
   help: { type: 'boolean' },
@@ -33,7 +34,6 @@ export const CLI_OPTIONS = /** @type {const} */ ({
   'no-color': { type: 'boolean' },
   offset: { type: 'string' },
   plain: { type: 'boolean' },
-  query: { type: 'string' },
   where: { type: 'string' },
 });
 
@@ -99,39 +99,15 @@ export function validateParsedCommand(command_name, command_line) {
   const command_positionals = command_line.positionals.slice(1);
 
   if (
-    command_name === 'query' &&
-    command_line.values.where !== undefined &&
-    command_positionals.length === 0
+    hasAdHocQueryCommand(command_name, command_line.values, command_positionals)
   ) {
-    return (
-      createMessageParseError(
-        findInvalidQueryPagination(command_line.option_tokens),
-      ) ??
-      findInvalidQueryMode(
-        command_name,
-        command_line.values,
-        command_positionals,
-      )
-    );
+    return validateAdHocQueryCommand(command_line, command_positionals);
   }
 
-  return (
-    findInvalidCommandOption(command_name, command_line.option_tokens) ??
-    createMessageParseError(
-      findInvalidQueryPagination(command_line.option_tokens),
-    ) ??
-    findInvalidQueryInspection(command_name, command_line.values) ??
-    findInvalidQueryMode(
-      command_name,
-      command_line.values,
-      command_positionals,
-    ) ??
-    findInvalidQueriesMutation(
-      command_name,
-      command_line.values,
-      command_positionals,
-    ) ??
-    validateCommandPositionals(command_name, command_positionals)
+  return validateStandardCommand(
+    command_name,
+    command_line,
+    command_positionals,
   );
 }
 
@@ -162,36 +138,134 @@ export function buildCommandArguments(
   command_positionals,
   parsed_values,
 ) {
-  if (command_name === 'query' && parsed_values.where !== undefined) {
-    return ['--where', parsed_values.where];
+  if (command_name === 'query' || command_name === 'refs') {
+    return buildAdHocQueryArguments(
+      command_name,
+      command_positionals,
+      parsed_values,
+    );
   }
 
-  if (command_name === 'refs' && parsed_values.where !== undefined) {
-    return [command_positionals[0], '--where', parsed_values.where];
+  if (command_name === 'queries') {
+    return buildStoredQueryArguments(command_positionals, parsed_values);
   }
 
-  if (command_name === 'queries') {
-    /** @type {string[]} */
-    const command_arguments = [...command_positionals];
+  return command_positionals;
+}
 
-    if (parsed_values.name !== undefined) {
-      command_arguments.push('--name', parsed_values.name);
-    }
+/**
+ * @param {CliCommandName} command_name
+ * @param {CliOptionValues} parsed_values
+ * @param {string[]} command_positionals
+ * @returns {boolean}
+ */
+function hasAdHocQueryCommand(
+  command_name,
+  parsed_values,
+  command_positionals,
+) {
+  return (
+    command_name === 'query' &&
+    parsed_values.cypher !== undefined &&
+    command_positionals.length === 0
+  );
+}
 
-    if (parsed_values.query !== undefined) {
-      command_arguments.push('--query', parsed_values.query);
-    }
+/**
+ * @param {ParsedCommandLine} command_line
+ * @param {string[]} command_positionals
+ * @returns {CliParseError | null}
+ */
+function validateAdHocQueryCommand(command_line, command_positionals) {
+  return (
+    findInvalidCommandOption('query', command_line.option_tokens) ??
+    createMessageParseError(
+      findInvalidQueryPagination(command_line.option_tokens),
+    ) ??
+    findInvalidQueryMode('query', command_line.values, command_positionals)
+  );
+}
 
-    if (parsed_values.desc !== undefined) {
-      command_arguments.push('--desc', parsed_values.desc);
-    }
+/**
+ * @param {CliCommandName} command_name
+ * @param {ParsedCommandLine} command_line
+ * @param {string[]} command_positionals
+ * @returns {CliParseError | null}
+ */
+function validateStandardCommand(
+  command_name,
+  command_line,
+  command_positionals,
+) {
+  return (
+    findInvalidCommandOption(command_name, command_line.option_tokens) ??
+    createMessageParseError(
+      findInvalidQueryPagination(command_line.option_tokens),
+    ) ??
+    findInvalidQueryInspection(command_name, command_line.values) ??
+    findInvalidQueryMode(
+      command_name,
+      command_line.values,
+      command_positionals,
+    ) ??
+    findInvalidQueriesMutation(
+      command_name,
+      command_line.values,
+      command_positionals,
+    ) ??
+    validateCommandPositionals(command_name, command_positionals)
+  );
+}
 
-    return command_arguments;
+/**
+ * @param {'query' | 'refs'} command_name
+ * @param {string[]} command_positionals
+ * @param {CliOptionValues} parsed_values
+ * @returns {string[]}
+ */
+function buildAdHocQueryArguments(
+  command_name,
+  command_positionals,
+  parsed_values,
+) {
+  if (parsed_values.cypher !== undefined) {
+    return command_name === 'query'
+      ? ['--cypher', parsed_values.cypher]
+      : [command_positionals[0], '--cypher', parsed_values.cypher];
   }
 
   return command_positionals;
 }
 
+/**
+ * @param {string[]} command_positionals
+ * @param {CliOptionValues} parsed_values
+ * @returns {string[]}
+ */
+function buildStoredQueryArguments(command_positionals, parsed_values) {
+  /** @type {string[]} */
+  const command_arguments = [...command_positionals];
+
+  appendOptionValue(command_arguments, '--name', parsed_values.name);
+  appendOptionValue(command_arguments, '--cypher', parsed_values.cypher);
+  appendOptionValue(command_arguments, '--desc', parsed_values.desc);
+
+  return command_arguments;
+}
+
+/**
+ * @param {string[]} command_arguments
+ * @param {string} option_name
+ * @param {string | undefined} option_value
+ */
+function appendOptionValue(command_arguments, option_name, option_value) {
+  if (option_value === undefined) {
+    return;
+  }
+
+  command_arguments.push(option_name, option_value);
+}
+
 /**
  * @param {string | undefined} help_target
  * @returns {CliParseError}
@@ -369,14 +443,38 @@ function findInvalidQueryMode(
 ) {
   if (
     command_name === 'query' &&
-    parsed_values.where !== undefined &&
+    parsed_values.cypher !== undefined &&
     command_positionals.length > 0
   ) {
     return createMessageParseError(
-      'Query accepts either "--where" or a stored query name.',
+      'Query accepts either "--cypher" or a stored query name.',
     );
   }
 
+  if (command_name === 'query' && parsed_values.where !== undefined) {
+    return {
+      code: 'option_not_valid_for_command',
+      command_name: 'query',
+      token: '--where',
+    };
+  }
+
+  if (command_name === 'queries' && parsed_values.where !== undefined) {
+    return {
+      code: 'option_not_valid_for_command',
+      command_name: 'queries',
+      token: '--where',
+    };
+  }
+
+  if (command_name === 'refs' && parsed_values.where !== undefined) {
+    return {
+      code: 'option_not_valid_for_command',
+      command_name: 'refs',
+      token: '--where',
+    };
+  }
+
   return null;
 }
 
@@ -471,7 +569,7 @@ function validateCommandPositionals(command_name, command_positionals) {
 
   if (command_name === 'query' && command_positionals.length === 0) {
     return {
-      argument_label: "<name> or --where '<clause>'",
+      argument_label: "<name> or --cypher '<query>'",
       code: 'missing_required_argument',
       command_name: 'query',
     };
@@ -487,6 +585,7 @@ function validateCommandPositionals(command_name, command_positionals) {
 function isKnownCommandOptionName(option_name) {
   return (
     option_name === 'desc' ||
+    option_name === 'cypher' ||
     option_name === 'explain' ||
     option_name === 'limit' ||
     option_name === 'lint' ||
@@ -507,8 +606,12 @@ function findMissingOptionValueError(option_token) {
   }
 
   if (option_token.name === 'where') {
+    return createMessageParseError('Where requires a value.');
+  }
+
+  if (option_token.name === 'cypher') {
     return {
-      argument_label: "<name> or --where '<clause>'",
+      argument_label: "<name> or --cypher '<query>'",
       code: 'missing_required_argument',
       command_name: 'query',
     };
@@ -531,11 +634,13 @@ function getMissingOptionValueMessage(option_name) {
   /** @type {Record<string, string>} */
   const option_messages = {
     color: 'Color requires a value.',
+    cypher: 'Cypher requires a value.',
     desc: 'Desc requires a value.',
     limit: 'Limit requires a value.',
     name: 'Name requires a value.',
     offset: 'Offset requires a value.',
     query: 'Query requires a value.',
+    where: 'Where requires a value.',
   };
 
   if (!option_name || !Object.hasOwn(option_messages, option_name)) {
@@ -564,8 +669,8 @@ function validateQueriesAddMutation(parsed_values, command_positionals) {
     return createMessageParseError('Queries add does not accept "--name".');
   }
 
-  if (parsed_values.query === undefined) {
-    return createMessageParseError('Queries add requires "--query <clause>".');
+  if (parsed_values.cypher === undefined) {
+    return createMessageParseError('Queries add requires "--cypher <query>".');
   }
 
   return null;
@@ -588,8 +693,9 @@ function validateQueriesRemoveMutation(parsed_values, command_positionals) {
 
   if (
     parsed_values.desc !== undefined ||
+    parsed_values.cypher !== undefined ||
     parsed_values.name !== undefined ||
-    parsed_values.query !== undefined
+    parsed_values.where !== undefined
   ) {
     return createMessageParseError(
       'Queries remove does not accept mutation options.',
@@ -616,11 +722,11 @@ function validateQueriesUpdateMutation(parsed_values, command_positionals) {
 
   if (
     parsed_values.desc === undefined &&
-    parsed_values.name === undefined &&
-    parsed_values.query === undefined
+    parsed_values.cypher === undefined &&
+    parsed_values.name === undefined
   ) {
     return createMessageParseError(
-      'Queries update requires at least one of "--name", "--query", or "--desc".',
+      'Queries update requires at least one of "--name", "--cypher", or "--desc".',
     );
   }
 

package/lib/cli/parse-arguments.js

@@ -34,10 +34,10 @@ import { buildQueryPagination } from './query-pagination.js';
  * Normalizes raw argv into one validated Patram command plus shared output and
  * pagination options.
  *
- * Kind: cli
- * Status: active
- * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../../docs/decisions/cli-argument-parser.md
+ * kind: cli
+ * status: active
+ * tracked_in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * decided_by: ../../docs/decisions/cli-argument-parser.md
  * @patram
  * @see {@link ./main.js}
  * @see {@link ../../docs/decisions/cli-argument-parser.md}

package/lib/cli/render-help.js

@@ -101,7 +101,7 @@ export function renderInvalidWhereDiagnostic(diagnostic) {
   const diagnostic_line = formatDiagnostic(diagnostic);
 
   return joinOutputLines([
-    'Invalid where clause:',
+    'Invalid query:',
     `  ${diagnostic_line}`,
     '',
     'Next:',
@@ -157,7 +157,7 @@ function renderCommandHelp(command_name) {
   ) {
     output_lines.push(
       '',
-      'Where clause:',
+      'Query syntax:',
       ...indentLines(command_definition.syntax_lines),
     );
   }

package/lib/config/defaults.js

@@ -25,36 +25,12 @@ export function normalizeRepoConfig(repo_config) {
     queries: { ...repo_config.queries },
   };
 
-  assignOptionalRepoConfigField(
-    normalized_config,
-    'classes',
-    repo_config.classes,
-  );
-  assignOptionalRepoConfigField(
-    normalized_config,
-    'derived_summaries',
-    repo_config.derived_summaries,
-  );
   assignOptionalRepoConfigField(
     normalized_config,
     'fields',
     repo_config.fields,
   );
-  assignOptionalRepoConfigField(
-    normalized_config,
-    'mappings',
-    repo_config.mappings,
-  );
-  assignOptionalRepoConfigField(
-    normalized_config,
-    'path_classes',
-    repo_config.path_classes,
-  );
-  assignOptionalRepoConfigField(
-    normalized_config,
-    'relations',
-    repo_config.relations,
-  );
+  assignOptionalRepoConfigField(normalized_config, 'types', repo_config.types);
 
   return normalized_config;
 }
@@ -74,7 +50,39 @@ function assignOptionalRepoConfigField(
     return;
   }
 
+  if (field_name === 'types') {
+    normalized_config.types = normalizeTypes(
+      /** @type {PatramRepoConfig['types']} */ (field_value),
+    );
+    return;
+  }
+
   normalized_config[field_name] = /** @type {PatramRepoConfig[TKey]} */ (
     field_value
   );
 }
+
+/**
+ * @param {PatramRepoConfig['types']} types
+ * @returns {PatramRepoConfig['types']}
+ */
+function normalizeTypes(types) {
+  if (!types) {
+    return types;
+  }
+
+  /** @type {NonNullable<PatramRepoConfig['types']>} */
+  const normalized_types = {};
+
+  for (const [type_name, type_definition] of Object.entries(types)) {
+    normalized_types[type_name] = {
+      ...type_definition,
+    };
+
+    if (typeof type_definition.in === 'string') {
+      normalized_types[type_name].in = [type_definition.in];
+    }
+  }
+
+  return normalized_types;
+}

package/lib/config/load-patram-config.d.ts

@@ -4,11 +4,11 @@
  * Reads `.patram.json`, applies defaults, and validates repo config and graph
  * schema before command execution.
  *
- * Kind: config
- * Status: active
- * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../../docs/decisions/single-config-file.md
- * Decided by: ../../docs/decisions/optional-config-default-scan.md
+ * kind: config
+ * status: active
+ * tracked_in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * decided_by: ../../docs/decisions/single-config-file.md
+ * decided_by: ../../docs/decisions/optional-config-default-scan.md
  * @patram
  * @see {@link ./schema.js}
  * @see {@link ./validation.js}
@@ -24,24 +24,10 @@
  */
 /**
  * @typedef {object} LoadPatramConfigResult
- * @property {import('./schema.js').PatramRepoConfig | null} config
+ * @property {PatramRepoConfig | null} config
  * @property {string} config_path
  * @property {PatramDiagnostic[]} diagnostics
  */
-/**
- * @typedef {import('./schema.js').StoredQueryConfig} StoredQueryConfig
- * @typedef {import('./schema.js').FieldDisplayConfig} FieldDisplayConfig
- * @typedef {import('./schema.js').FieldQueryConfig} FieldQueryConfig
- * @typedef {import('./schema.js').MetadataFieldConfig} MetadataFieldConfig
- * @typedef {import('./schema.js').ClassFieldRuleConfig} ClassFieldRuleConfig
- * @typedef {import('./schema.js').ClassSchemaConfig} ClassSchemaConfig
- * @typedef {import('./schema.js').PathClassConfig} PathClassConfig
- * @typedef {import('./schema.js').DerivedSummaryScalar} DerivedSummaryScalar
- * @typedef {import('./schema.js').DerivedSummarySelectCaseConfig} DerivedSummarySelectCaseConfig
- * @typedef {import('./schema.js').DerivedSummaryFieldConfig} DerivedSummaryFieldConfig
- * @typedef {import('./schema.js').DerivedSummaryConfig} DerivedSummaryConfig
- * @typedef {import('./schema.js').PatramRepoConfig} PatramRepoConfig
- */
 /**
  * Load and validate the repo Patram config.
  *
@@ -69,19 +55,8 @@ export type PatramDiagnostic = {
     path: string;
 };
 export type LoadPatramConfigResult = {
-    config: import("./schema.js").PatramRepoConfig | null;
+    config: PatramRepoConfig | null;
     config_path: string;
     diagnostics: PatramDiagnostic[];
 };
-export type StoredQueryConfig = import("./schema.js").StoredQueryConfig;
-export type FieldDisplayConfig = import("./schema.js").FieldDisplayConfig;
-export type FieldQueryConfig = import("./schema.js").FieldQueryConfig;
-export type MetadataFieldConfig = import("./schema.js").MetadataFieldConfig;
-export type ClassFieldRuleConfig = import("./schema.js").ClassFieldRuleConfig;
-export type ClassSchemaConfig = import("./schema.js").ClassSchemaConfig;
-export type PathClassConfig = import("./schema.js").PathClassConfig;
-export type DerivedSummaryScalar = import("./schema.js").DerivedSummaryScalar;
-export type DerivedSummarySelectCaseConfig = import("./schema.js").DerivedSummarySelectCaseConfig;
-export type DerivedSummaryFieldConfig = import("./schema.js").DerivedSummaryFieldConfig;
-export type DerivedSummaryConfig = import("./schema.js").DerivedSummaryConfig;
-export type PatramRepoConfig = import("./schema.js").PatramRepoConfig;
+import type { PatramRepoConfig } from './load-patram-config.types.d.ts';

package/lib/config/load-patram-config.js

@@ -1,17 +1,8 @@
 /**
  * @import {
- *   ClassFieldRuleConfig,
- *   ClassSchemaConfig,
- *   DerivedSummaryConfig,
- *   DerivedSummaryFieldConfig,
- *   DerivedSummaryScalar,
- *   DerivedSummarySelectCaseConfig,
- *   FieldDisplayConfig,
- *   FieldQueryConfig,
- *   MetadataFieldConfig,
- *   PathClassConfig,
+ *   PatramRepoConfig,
  *   StoredQueryConfig,
- * } from './schema.js';
+ * } from './load-patram-config.types.ts';
  */
 
 import { readFile } from 'node:fs/promises';
@@ -28,11 +19,11 @@ import { validatePatramConfigValue } from './validate-patram-config-value.js';
  * Reads `.patram.json`, applies defaults, and validates repo config and graph
  * schema before command execution.
  *
- * Kind: config
- * Status: active
- * Tracked in: ../../docs/plans/v0/source-anchor-dogfooding.md
- * Decided by: ../../docs/decisions/single-config-file.md
- * Decided by: ../../docs/decisions/optional-config-default-scan.md
+ * kind: config
+ * status: active
+ * tracked_in: ../../docs/plans/v0/source-anchor-dogfooding.md
+ * decided_by: ../../docs/decisions/single-config-file.md
+ * decided_by: ../../docs/decisions/optional-config-default-scan.md
  * @patram
  * @see {@link ./schema.js}
  * @see {@link ./validation.js}
@@ -50,26 +41,11 @@ import { validatePatramConfigValue } from './validate-patram-config-value.js';
 
 /**
  * @typedef {object} LoadPatramConfigResult
- * @property {import('./schema.js').PatramRepoConfig | null} config
+ * @property {PatramRepoConfig | null} config
  * @property {string} config_path
  * @property {PatramDiagnostic[]} diagnostics
  */
 
-/**
- * @typedef {import('./schema.js').StoredQueryConfig} StoredQueryConfig
- * @typedef {import('./schema.js').FieldDisplayConfig} FieldDisplayConfig
- * @typedef {import('./schema.js').FieldQueryConfig} FieldQueryConfig
- * @typedef {import('./schema.js').MetadataFieldConfig} MetadataFieldConfig
- * @typedef {import('./schema.js').ClassFieldRuleConfig} ClassFieldRuleConfig
- * @typedef {import('./schema.js').ClassSchemaConfig} ClassSchemaConfig
- * @typedef {import('./schema.js').PathClassConfig} PathClassConfig
- * @typedef {import('./schema.js').DerivedSummaryScalar} DerivedSummaryScalar
- * @typedef {import('./schema.js').DerivedSummarySelectCaseConfig} DerivedSummarySelectCaseConfig
- * @typedef {import('./schema.js').DerivedSummaryFieldConfig} DerivedSummaryFieldConfig
- * @typedef {import('./schema.js').DerivedSummaryConfig} DerivedSummaryConfig
- * @typedef {import('./schema.js').PatramRepoConfig} PatramRepoConfig
- */
-
 /**
  * Load and validate the repo Patram config.
  *
@@ -138,7 +114,7 @@ export function parsePatramConfigSource(config_source) {
 }
 
 /**
- * @param {import('./schema.js').PatramRepoConfig | null} config
+ * @param {PatramRepoConfig | null} config
  * @param {PatramDiagnostic[]} diagnostics
  * @returns {LoadPatramConfigResult}
  */

package/lib/config/load-patram-config.types.d.ts

@@ -1,45 +1,8 @@
 export type StoredQueryConfig = import('./schema.js').StoredQueryConfig;
-export type FieldDisplayConfig = import('./schema.js').FieldDisplayConfig;
-export type FieldQueryConfig = import('./schema.js').FieldQueryConfig;
-export type FieldValueTypeName = import('./schema.js').MetadataFieldConfig['type'];
 export type MetadataFieldConfig = import('./schema.js').MetadataFieldConfig;
-export type StringFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'string';
-}>;
-export type IntegerFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'integer';
-}>;
-export type EnumFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'enum';
-}>;
-export type PathFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'path';
-}>;
-export type GlobFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'glob';
-}>;
-export type DateFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'date';
-}>;
-export type DateTimeFieldConfig = Extract<MetadataFieldConfig, {
-    type: 'date_time';
-}>;
-export type ClassFieldRuleConfig = import('./schema.js').ClassFieldRuleConfig;
-export type DirectiveTypeConfig = MetadataFieldConfig;
-export type MetadataDirectiveRuleConfig = ClassFieldRuleConfig;
-export type ClassSchemaConfig = import('./schema.js').ClassSchemaConfig;
-export type MetadataSchemaConfig = ClassSchemaConfig;
-export type PathClassConfig = import('./schema.js').PathClassConfig;
-export type DerivedSummaryScalar = import('./schema.js').DerivedSummaryScalar;
-export type DerivedSummarySelectCaseConfig = import('./schema.js').DerivedSummarySelectCaseConfig;
-export type DerivedSummaryFieldConfig = import('./schema.js').DerivedSummaryFieldConfig;
-export type DerivedSummaryCountFieldConfig = Extract<DerivedSummaryFieldConfig, {
-    count: unknown;
-}>;
-export type DerivedSummarySelectFieldConfig = Extract<DerivedSummaryFieldConfig, {
-    select: unknown;
-}>;
-export type DerivedSummaryConfig = import('./schema.js').DerivedSummaryConfig;
+export type ScalarFieldConfig = import('./schema.js').ScalarFieldConfig;
+export type RefFieldConfig = import('./schema.js').RefFieldConfig;
+export type TypeDefinitionConfig = import('./schema.js').TypeDefinitionConfig;
 export type PatramRepoConfig = import('./schema.js').PatramRepoConfig;
 export type PatramDiagnostic = import('./load-patram-config.js').PatramDiagnostic;
 export type LoadPatramConfigResult = import('./load-patram-config.js').LoadPatramConfigResult;

package/lib/config/manage-stored-queries-helpers.d.ts

@@ -29,20 +29,20 @@ export function persistStoredQueryMutation(config_file_path: string, raw_config:
     success: false;
 }>;
 /**
- * @param {string} where_clause
+ * @param {string} query_text
  * @param {string | undefined} description
  * @returns {StoredQueryConfig}
  */
-export function createStoredQueryDefinition(where_clause: string, description: string | undefined): StoredQueryConfig;
+export function createStoredQueryDefinition(query_text: string, description: string | undefined): StoredQueryConfig;
 /**
  * @param {Record<string, unknown> | null} raw_query_value
  * @param {StoredQueryConfig} existing_query
- * @param {{ description?: string, where?: string }} stored_query_mutation
+ * @param {{ cypher?: string, description?: string }} stored_query_mutation
  * @returns {StoredQueryConfig}
  */
 export function createUpdatedStoredQueryDefinition(raw_query_value: Record<string, unknown> | null, existing_query: StoredQueryConfig, stored_query_mutation: {
+    cypher?: string;
     description?: string;
-    where?: string;
 }): StoredQueryConfig;
 /**
  * @param {Record<string, unknown>} raw_config