Function resolvePropertyValue

packages/graph/src/Steps.ts:428–479

* Resolve a single property value - handles literal values, parameter references, * property access (variable.property), and variable references.

(
    value: unknown,
    context?: QueryContext,
    path?: TraversalPath<any, any, any>,
  )

   * property access (variable.property), and variable references.
   */
  protected resolvePropertyValue(
    value: unknown,
    context?: QueryContext,
    path?: TraversalPath<any, any, any>,
  ): unknown {
    if (value === null || typeof value !== "object" || !("type" in value)) {
      return value;
    }

    const typedValue = value as { type: string; [key: string]: any };

    if (typedValue.type === "ParameterRef") {
      const params = context?.params ?? getQueryParams();
      return params[typedValue.name as string];
    }

    if (typedValue.type === "PropertyAccess" && path) {
      const sourcePath = path.get(typedValue.variable as string);
      if (!sourcePath) {
        return null; // Variable not found
      }
      const sourceElement = sourcePath.value;
      if (sourceElement instanceof Vertex || sourceElement instanceof Edge) {
        return sourceElement.get(typedValue.property as never);
      }
      // Handle map/object values
      if (
        sourceElement !== null &&
        typeof sourceElement === "object" &&
        typedValue.property in sourceElement
      ) {
        return (sourceElement as Record<string, unknown>)[typedValue.property as string];
      }
      return null;
    }

    if (typedValue.type === "VariableRef" && path) {
      const sourcePath = path.get(typedValue.variable as string);
      if (!sourcePath) {
        return null; // Variable not found
      }
      return sourcePath.value;
    }

    // Handle ListLiteral - recursively resolve values
    if (typedValue.type === "ListLiteral") {
      const values = typedValue.values as unknown[];
      return values.map((v) => this.resolvePropertyValue(v, context, path));
    }

    return value;
  }

  /**
   * Resolve all property values in a properties map, replacing parameter references